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: JJobsPool
  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/jjobs
  22 Pool name: JJobsPool
  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/jjobs-queue-factory
  35 Resource type: javax.jms.QueueConnectionFactory
  36
  37 6) Setup JMS message queue:
  38
  39 JNDI name: jms/jjobs-email-queue
  40 Physical destination name: jjobsSendEmail
  41 Resource type: javax.jms.Queue
  42
  43 7) Setup Java Mail session:
  44
  45 JNDI name: jjobsSmtpSession
  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/jjobs-user-activity-log
  59 Physical destination name: jjobsUserActivityLog
  60 Resource type: javax.jms.Queue
  61
  62 9) In WAR project, copy local_xx_XX.properties-dist to local_de_DE.properties
  63    and local_en_US.properties. If for example your application uses
  64    product_categories from jproduct-core, you may want to add your custom i18n
  65    strings to the local properties files as this doesn't cause any later merge
  66    conflicts as they are ignored by default.