Installation Guide

Download

Download the current release from the Google Code Project Downloads Page. We recommend using the latest version.

Preparations

Timejoe is a Java EE software, based on the Grails Framework (Groovy, Spring, Hibernate, Sitemesh). To deploy Timejoe you need

• Java 5 or higher
• an SQL Server (with Hibernate compatible JDBC driver), for example MySQL or Oracle
• an application / servlet container like Tomcat

Installation

1. Create a database on your database server
2. Deploy the Timejoe war-file to your Servlet Container
3. Shutdown Servlet Container and remove the war-file (should not redeployed after restart)
4. Go to SERVLET_CONTAINER/webapps/TIMEJOE_FOLDER/WEB-INF/classes and set the database data in timejoe-config.properties
5. Configure the URL in timejoe-config.properties and the corresponding application name in application.properties or make the application the ROOT application
6. Start the Servlet Container and open Timejoe in your Browser

URL Configuration

This is quite easy due to timejoe-config.properties and application.properties in SERVLET_CONTAINER/webapps/TIMEJOE_FOLDER/WEB-INF/classes.

Valid combinations are:

Folder-Name: timejoe-1.0
timejoe-config.properties: grails.serverURL=http://localhost:8080/timejoe-1.0
application.properties: app.name=timejoe-1.0

Folder-Name: timejoe
timejoe-config.properties: grails.serverURL=http://localhost:8080/timejoe
application.properties: app.name=timejoe

Folder-Name: ROOT
timejoe-config.properties: grails.serverURL=http://localhost:8080
application.properties: app.name=/

... and so on. Of course you have to replace localhost:8080 with your Domain.

Database Scheme

You can use any SQL database that has a Hibernate compatible JDBC driver. Put the JDBC driver lib in the lib folder of your Servlet Container and configure the Ddatabase in timejoe-config.properties.