INSTALL.txt

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