NOTE: The "Expresso Complete" bundle comes with a much later version of Tomcat than the one discussed here. Please check the documentation for Expresso complete for details. We've left this documentation here for reference if you're using VisualAge or older version of Tomcat, but parts of it are probably out of date!

Tomcat

This page shows an example configuration of Tomcat with Expresso: This example was taken from an installation of Tomcat running within IBM's VisualAge, which is a very valuable technique for debugging servlets, but the Tomcat configuration should be basically the same no matter what JVM is used.

Of course, you should refer to the release notes and install documents for Tomcat first, to ensure you have Tomcat up and operational before attempting to install or configure Expresso.

Directories

In this example, Tomcat is installed in the directory c:\IBMVJava2\ide\project_resources\Tomcat. In this directory is the "conf" directory from the Tomcat installation, the "webapps" directory, and several others relating to Tomcat.

In this same directory is another directory entitled "expresso_config", which contains a single file: The properties file for Expresso, discussed in the Configuration instructions.

In the webapps/ROOT directory, under the above directory is a directory called WEB-INF. In this directory is the web.xml file, which registers each of the Expresso servlets. It contains the following text:

<?xml version="1.0" encoding="ISO-8859-1"?>
<web-app>
<servlet>
<servlet-name>Status</servlet-name>
<servlet-class>com.jcorporate.expresso.services.servlet.Status</servlet-class>
</servlet>
<servlet>
<servlet-name>DBMaint</servlet-name>
<servlet-class>com.jcorporate.expresso.core.servlet.DBMaint</servlet-class>
</servlet>
<servlet>
<servlet-name>Login</servlet-name>
<servlet-class>com.jcorporate.expresso.core.servlet.</servlet-class>
</servlet>
<servlet>
<servlet-name>Logout</servlet-name>
<servlet-class>com.jcorporate.expresso.core.servlet.</servlet-class>
</servlet>
<servlet>
<servlet-name>ShowLog</servlet-name>
<servlet-class>com.jcorporate.expresso.services.servlet.ShowLog</servlet-class>
</servlet>
<servlet>
<servlet-name>DBCreate</servlet-name>
<servlet-class>com.jcorporate.expresso.services.servlet.DBCreate</servlet-class>
</servlet>
<servlet>
<servlet-name>ControllerServlet</servlet-name>
<servlet-class>com.jcorporate.expresso.core.servlet.ControllerServlet</servlet-class>
</servlet>
<servlet>
<servlet-name>RegisterUser</servlet-name>
<servlet-class>com.jcorporate.expresso.ext.servlet.RegisterUser</servlet-class>
</servlet>
<servlet>
<servlet-name>SendNotice</servlet-name>
<servlet-class>com.jcorporate.expresso.ext.servlet.SendNotice</servlet-class>
</servlet>
<servlet>
<servlet-name>ControllerActionServlet</servlet-name>
<servlet-class>com.jcorporate.expresso.core.servlet.ControllerActionServlet</servlet-class>
</servlet>
<servlet>
<servlet-name>ClearLogs</servlet-name>
<servlet-class>com.jcorporate.expresso.services.servlet.ClearLogs</servlet-class>
</servlet>
<servlet>
<servlet-name>Test</servlet-name>
<servlet-class>com.jcorporate.expresso.core.servlet.Test</servlet-class>
</servlet>
<servlet>
<servlet-name>ChangePassword</servlet-name>
<servlet-class>com.jcorporate.expresso.core.servlet.ChangePassword</servlet-class>
</servlet>
<servlet>
<servlet-name>RunSQL</servlet-name>
<servlet-class>com.jcorporate.expresso.ext.servlet.RunSQL</servlet-class>
</servlet>
<servlet>
<servlet-name>Download</servlet-name>
<servlet-class>com.jcorporate.expresso.ext.servlet.Download</servlet-class>
</servlet>
<servlet>
<servlet-name>InitServletProps</servlet-name>
<servlet-class>com.jcorporate.expresso.core.servlet.Props</servlet-class>
</servlet>
<servlet>
<servlet-name>DefaultInit</servlet-name>
<servlet-class>com.jcorporate.expresso.core.servlet.DefaultInit</servlet-class>
<init-param>
<param-name>configDir</param-name>
<param-value>c:\IBMVJava2\ide\project_resources\Tomcat\expresso_config</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
</web-app>

Installing Expresso in the ROOT application is not necessarily the best practice with Tomcat, and we're working on additional sample installs that use Web Application Archive (.WAR) files, but this configuration should help you get started!

Class Path

Tomcat can be started up by running the org.apache.tomcat.startup.Tomcat class. From within VisualAge (again, from our sample installation), the Classpath is set (via the properties of the Tomcat object) as follows:

.; c:\ibmvjava2\ide\project_resources\Expresso; c:\ibmvjava2\ide\project_resources\Expresso XML; c:\ibmvjava2\ide\project_resources\Java Activation Framework; c:\ibmvjava2\ide\project_resources\JavaMail; c:\ibmvjava2\ide\project_resources\mySQL Driver; c:\ibmvjava2\ide\project_resources\Tomcat Examples; c:\ibmvjava2\ide\project_resources\Xanlan; c:\ibmvjava2\ide\project_resources\Xerces; C:\IBMVJava2\ide\project_resources\Tomcat\lib\mysql.jar; C:\IBMVJava2\ide\project_resources\Tomcat\lib\jasper.jar; C:\IBMVJava2\ide\project_resources\Tomcat\lib\servlet.jar; C:\IBMVJava2\ide\project_resources\Tomcat\work\; C:\IBMVJava2\ide\project_resources\Tomcat\work\localhost_8080\; C:\IBMVJava2\ide\project_resources\Tomcat\work\localhost_8080%2Fexamples\; C:\IBMVJava2\ide\project_resources\Tomcat\; C:\IBMVJava2\ide\project_resources\Tomcat\webapps\admin\WEB-INF\classes\; C:\IBMVJava2\ide\project_resources\Tomcat\webapps\examples\WEB-INF\classes\;

Please report any difficulties or updates to this configuration example to support at support@jcorporate.com