Tomcat 3.2 ExperShop release notes

This document gives an example of a Tomcat configuration for ExperShop:
It requires a basic knowledge of the Tomcat configuration process - including what Tomcat is, what server.xml and look like, what the organization of a servlet application looks like (and particularly the directory tree involved in a .war file) and where these elements should be.

The main tasks involved in a Tomcat configuration are:

Copy all required jar files in the lib/ directory (including expershop.jar, openeas.jar, xapool.jar, hsqldb.jar and log4j.jar) from the expershop/WEB-INF/lib directory) so Tomcat finds the ExperShop servlets in its CLASSPATH.
Update the conf/web.xml file to declare ExperSHOP servlets.

On some systems, a bug in Tomcat requires 2 additional steps in the config process (this mainly happened to us on Macintosh and Linux RH 6.2 intel):

Update the conf/server.xml file to declare an expershop context path.
Create a webapps/expershop/WEB-INF/web.xml file, and declare ExperSHOP servlets there.

What to add in conf/web.xml

In the <web-app> section of the XML file:


    <servlet>
        <servlet-name>
            com.expershop.lite.ExperSHOP
        </servlet-name>
        <servlet-class>
            com.expershop.lite.ExperSHOP
        </servlet-class>
        <init-param>
          <param-name>SHOPCONFIG</param-name>
          <param-value>/usr/local/ExperSHOP/EShop.cfg</param-value>
        </init-param>
        <load-on-startup>
            -2147483646
	  </load-on-startup>
    </servlet>

What to add in conf/server.xml (on some systems)


<Context path="/expershop"
	docBase="webapps/expershop"
	crossContext="false"
	debug="0"
	reloadable="true"/>

What to put in webapps/expershop/WEB-INF/web.xml (on some systems)


<?xml version="1.0" encoding="ISO-8859-1"?>

<!DOCTYPE web-app
    PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN"
    "http://java.sun.com/j2ee/dtds/web-app_2_2.dtd">

<web-app>
    <servlet>
        <servlet-name>
            com.expershop.lite.ExperSHOP
        </servlet-name>
        <servlet-class>
            com.expershop.lite.ExperSHOP
        </servlet-class>
        <init-param>
          <param-name>SHOPCONFIG</param-name>
          <param-value>/usr/local/ExperSHOP/EShop.cfg</param-value>
        </init-param>
	<load-on-startup>
            -2147483646
	</load-on-startup>
    </servlet>
</web-app>