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