Notes on Servlet Containers

Multiple Allegra instances in one Tomcat

You can deploy more than one Allegra instance in the same servlet container. In this case, it is no longer possible to define TRACKPLUS_HOME via the environment, since they would be identical for all Allegra instances in this container.

To mitigate this problem, create a file Torque.properties.INST in the webapps directory. INST must be replaced by the base name of your WAR file. For example, if you want to run three instances named allegra-1, allegra-2, and allegra-3, you would also create three files Torque.properties.allegra-1, Torque.properties.allegra-2 and Torque.properties.allegra-3. Each of these files must point to the correct database and to the correct directory TRACKPLUS_HOME. The latter is defined by the property

...
TRACKPLUS_HOME=absolute path to directory
...

in each respective Torque.properties.INST file.