How to setup developer testing platform.
Tomcat installation and configuration
Get newest Tomcat application server version 5.5.x from http://jakarta.apache.org
Unpack it to some directory that we will called $CATALINA_HOME
Add application descriptor cyklotron.xml to $CATALINA_HOME/conf/Catalina/localhost/
Use template to create your own descriptor:
Database configuration and initialisation
Install database engine
To use Cyklotron you have to install PostgreSQL database engine.
To ensure proper operation of Cyklotron, You need to install the JDBC driver jar (for Your PostgreSQL version) into $CATALINA_HOME/shared/lib directory. For instance on Fedora Linux installations the JDBC driver jar for PostgreSQL is packaged in postgresql-jdbc rpm and can be found in /usr/share/java/ directory.
Configure database connection
The configuration of database connection for Cyklotron is stored in org.objectledge.database.XaPoolDataSource.xml file in cyklotron-webapp project. The following section of the file will tell You about the user name and database name used by Cyklotron.
The lcms is the database name, cyklotron is the user name and coraltest is the password. Of course You may change these values to suit Your needs. You can do it by placing a modified copy of the aforementioned configuration file in config directory of Your webapplication.
Configure database engine
After configuring the database connection You will have enough information to configure the database engine to work with Cyklotron.
First You have to create a database user named as in the configuration file. Than this user has to be allowed to create databases. Than create the database for instance using the following command (under Unix/Linux):
createdb -U <username> -E UNICODE <dbname>
You must also remember that PostgreSQL JDBC driver requires TCP/IP connection to the database and by default PostgreSQL is not configured to accept them.
More information about PostgreSQL can be found in PostgreSQL Manual.
Init database
When everything concerning the database is configured properly, go into cyklotron-webapp project and execute following command:
maven init
If maven finishes with success, the database should be already prepared!
Running tomcat
Go to $CATALINA_HOME/bin directory and execute ./catalina.sh run
Now you can type in your browser navigation bar: http://localhost:8080/cyklotron/
Thats all - have a fun!
Using live assembly
Every time you change cyklotron sources you have to rebuild entire application, generate WAR and restart application context.
For developers such a tomcat configuration is not the best solution.