Installing on Debian Etch

Installing the necessary software

apt-get update
apt-get install sun-java5-jdk sun-java5-jre
update-alternatives --config java
update-alternatives --config javac
apt-get install tomcat5.5 tomcat5.5-admin tomcat5.5-webapps

In case you want to run an ordinary Apache as a proxy in front of Tomcat, also install the mod-jk package:

apt-get install libapache2-mod-jk

Configuring Apache Tomcat 5.5

The file /etc/default/tomcat5.5 holds some configuration which we need to change: Change the following parameters:

#We have plenty of RAM, let's give it to Tomcat:
CATALINA_OPTS="-Djava.awt.headless=true -Xms512M -Xmx2048M -server"
TOMCAT5_SECURITY=no

In case you use mod-jk, make the following changes to /etc/libapache2-mod-jk/workers.properties:

workers.tomcat_home=/usr/share/tomcat5.5
workers.java_home=/usr/lib/jvm/java-1.5.0-sun

Deploying the opencms.war file

First, stop tomcat:

/etc/init.d/tomcat5.5 stop

Then, copy the opencms.war into the webapps folder:

cp opencms.war /var/lib/tomcat5.5/webapps/

Then, restart tomcat:

/etc/init.d/tomcat5.5 start