The basic default setup assuming Tomcat 6.x or 7.x servlet container and a Mysql 5.x database. The database connection will be used from a JNDI env entry java:comp/env/jdbc/itracker_ds.
- download and install Apache Tomcat 6.x or 7.x, you can do this here: Download Tomcat If you need more instructions about Tomcat take a look at this site: Apache Tomcat
- After installing Tomcat you have to set up an empty MySQL database for your itracker. The database must support UTF-8 charset for itracker to function properly. If you need more instructions about MySQL: www.mysql.com.
- Tomcat context should be configured to have access on the datasource via JNDI see this example for a start.
itracker assumes the mail and activation libs are provided
in the application class-path either by the JVM or application
server. Best practice is to install the required files to the
Tomcat lib folder if necessary:
- download and extract java activation framework available from oracle.com
- copy the jar file activation.jar to the webserver library (eg $TOMCAT_HOME/lib/)
- download and extract javamail available from sun.com
- copy the jar files mail-api.jar and javamail.jar to the webserver library
- restart Tomcat to apply this changes
- If you have all this requirements resolved, download the binary itracker file on Sourceforge. Extract it and deploy the itracker.war file to $TOMCAT_HOME/webapps folder
You can update configurations in tomcat/webapps/itracker folder:
- Database connection configuration you will find in WEB-INF/classes/application.properties , by default a JNDI resource for looking up the datasource will be used at java:comp/env/jndi/itracker_ds, but you can still replace the datasource to be in-app by changing the WEB-INF/classes/datasource.xml.
- The basic application settings are in this file: WEB-INF/configuration.properties , or override specific values using the JNDI env entries at java:comp/env/itracker
- If you have finished the configuration restart the tomcat application to change your settings. You should be able to open the url itracker on localhost port 8080