]> git.mxchange.org Git - addressbook.git/blob - INSTALL.txt
Updated jar(s)
[addressbook.git] / INSTALL.txt
1 Installation instructions:
2 ==========================
3
4 1) Create an empty database and setup proper permissions and user account. You
5    should create a separate database and user for each project you are going to
6    run on it for maximum security.
7
8 2) Setup a JDBC pool. I took the simple driver:
9
10 Pool name: AddressbookPool
11 Resource type: java.sql.Driver
12 Driver: MariaDB
13 Driver class: org.mariadb.jdbc.Driver
14
15 URL: jdbc:mysql://localhost/your_database
16 user: your_login
17 password: your_password
18
19 3) Setup a JDBC resource:
20
21 JNDI name: jdbc/addressbook
22 Pool name: AddressbookPool
23
24 4) In juser-core project you will find a JAR named "commons-codec-1.10.jar" you
25    need to copy this to your $GLASSFISH_DOMAIN/lib/ path to make password
26    encryption working. Please setup sufficient access rights (CHMOD 0644 is
27    enough).
28
29    If you forgot this file to copy and you have copied it now, please restart
30    the Glassfish server so the JAR can be found and loaded.
31
32 5) Setup a JMS connection factory:
33
34 JNDI name: jms/addressbook-queue-factory
35 Resource type: javax.jms.QueueConnectionFactory
36
37 6) Setup JMS message queue:
38
39 JNDI name: jms/addressbook-email-queue
40 Physical destination name: addressbook-send-email
41 Resource type: javax.jms.Queue
42
43 7) Setup Java Mail session:
44
45 JNDI name: addressbookSmtpSession
46 Mail host: <your-smtp-host>
47 Default user: <your-smtp-login-name>
48 Default sender address: noreply@your-domain.example
49
50 Optional, but more secure/sometimes required advanced properties:
51
52 mail.smtp.password : <email password>
53 mail.smtp.port : <email port>
54 mail.smtp.auth : true
55
56 8) Setup JMS message queue
57
58 JNDI name: jms/addressbook-user-activity-log
59 Physical destination name: addressbookUserActivityLog
60 Resource type: javax.jms.Queue