Base install

Step 1: Create database in database server

Currently only MySQL is supported. Create an empty database on your MySQL server.

Step 2: Create a datasource "jdbc/1901" in your web application server

In Tomcat 6, you'll have to create a context file located in $CATALINA_BASE/conf/[enginename]/[hostname]/1901-web.xml. If you're running Debian, the file should be located in /etc/tomcat6/Catalina/localhost/1901-web.xml. An exemple of a context file is provided here.

Setp 3: Execute database manual changes

The database is automatically managed by Hibernate. Unfortunatly, there is some cases where manual changes are still necessary. These changes are highligthed in the "Important Notes" section of the version you are installing in the release notes.

Step 4: Deploy the war file

As simple as copying the war file in the webapps directory of Tomcat, and restart the server.

You can now access your application, using 1901-WEB as context root. As an example, if your server is local and listen on port 8080, you can access the application using http://localhost:8080/1901-web.

Uppon first access, the application will update the database if required. Therefore, it is important to access the application once before executing your configuration scripts.

Configuration

As there is no administration pages yet, the configuration have to be set directly into the database using SQL scripts. You can browse the database model documentation to get more information on each tables and fields involved, and to build more complex configuration.

There is a initialisation sample script available in sources, that would create a user "motofix" with "toto" as password, and administration privileges: Init script You may browse this file content and read comments.