If you want to use the default properties file provided with RUBiS, you just have to set your DocumentRoot (in Apache's conf/httpd.conf file) to RUBiS distribution home directory.

Example: DocumentRoot /home/RUBiS

If you don't want to modify your DocumentRoot, RUBiS PHP directory must be accessible through a certain path that you'll have to set in the rubis.properties file.

Ensure that the Servlet_HTML or ejb_rubis_web directories are accessible through your Apache server (same procedure as for PHP). Then configure the Tomcat servlet server.

Configure mod_jk:

• Add the file mod_jk.so and mod_webapp.so to the /etc/httpd/libexec directory.
• At the end of your httpd.conf add:

LoadModule jk_module libexec/mod_jk.so

AddModule mod_jk.c

JkWorkersFile ${CATALINA_HOME}/conf/workers.properties

JkLogFile /etc/httpd/logs/mod_jk.log

JkLogLevel info

JkMount /ejb_rubis_web/servlet/* ajp13

JkMount /servlet/* ajp13

Include ${CATALINA_HOME}/conf/auto/mod_jk.conf

In ${CATALINA_HOME}/conf/server.xml uncomment the line regarding AJP 1.3 connector if needed:

<Connector className="org.apache.ajp.tomcat4.Ajp13Connector" port="8009" minProcessors="5" maxProcessors="75" acceptCount="10" debug="0"/>

After the line:

<Server port="8005" shutdown="SHUTDOWN" debug="0">

Add:

<Listener className="org.apache.ajp.tomcat4.config.ApacheConfig" jkDebug="info" workersConfig="catalina_home/conf/workers.properties" jkLog="/catalina_home/logs/mod_jk.log"/>

Define a context for rubis like this:

<Context path="/ejb_rubis_web/servlet"

docBase="path-to-rubis/RUBiS/ejb_rubis_web"

crossContext="false"

debug="0"

reloadable="false" >

<Logger className="org.apache.catalina.logger.FileLogger"

prefix="localhost_rubis_ejb_log." suffix=".txt"

timestamp="true"/>

<Listener className="org.apache.ajp.tomcat4.config.ApacheConfig"

append="true" />

</Context>

<Context path="/servlet"

docBase="path-to-rubis/RUBiS/Servlet_HTML"

crossContext="false"

debug="0"

reloadable="false" >

<Logger className="org.apache.catalina.logger.FileLogger"

prefix="localhost_rubis_servlet_log." suffix=".txt"

timestamp="true"/>

<Listener className="org.apache.ajp.tomcat4.config.ApacheConfig"

append="true" />

</Context>

In the ${CATALINA_HOME}/conf/worker.properties file, configure:

workers.tomcat_home=path-to-tomcat

workers.java_home=path-to-jdk

worker.ajp13.host=machine running tomcat

In ${CATALINA_HOME}/bin/setclasspath.sh replace

CLASSPATH="$JAVA_HOME"/lib/tools.jar

with

CLASSPATH="$JAVA_HOME"/lib/tools.jar:"$CLASSPATH"

so that the existing classpath will be taken in account

This is done in the tomcat_start.sh script by setting the CATALINA_OPTS environment variable.

According to the problem size you may also have to set the heap and stack sizes to prevent Tomcat from running out of memory.

Example to use Tomcat with JOnAS using RMI on pouet.cs.rice.edu on default port 1099, using a maximum heap size of 512MB for Tomcat and a 16KB stack for each thread:

export CATALINA_OPTS="-Xmm512m -Xss16k -Djava.naming.factory.initial=com.sun.jndi.rmi.registry.RegistryContextFactory -Djava.naming.provider.url=rmi://pouet.cs.rice.edu:1099 -Djava.naming.factory.url.pkgs=org.objectweb.jonas.naming"