To install Scribe.war servlet into Tomcat servlet engine:

1. Copy Scribe.war file into the Tomcat's webapps directory:

C:\Tomcat4.1\webapps\Scribe.war

Note: this location of Tomcat is only an example. Tomcat can be installed anywhere on your system, and you can use any version from 4 and up. However, if Tomcat is hosted on Windows, make sure that that its home directory path does not contain blank spaces.

2. Copy this properties file into Tomcat directory:

C:\Tomcat4.1\webapps\ScribeDefaults

3. Edit ScribeDefaults file as follows:

• Set SERVER property to the IP address of the host where the Scribe Server runs
• Set PORT property to the port the Scribe Server is listening on
• Set SCRIBEWEB_DIR property to the Scribe.war deployment directory (C:\Tomcat4.1\webapps\Scribe)

4. Edit SF_Defaults in ScribeAdministrator installation directory as follows:

• Set TOMCATDIR property to the location of Scribe servlet relative to the web root (http://www.gestalt.com:8080/Scribe/)
  This property is needed for the proper operation of drill-down mechanism over the web; its setting depends on whether Tomcat runs stand-alone, or in tandem with the Web server (see below).
• Set FONTDIR property to the font directory of the OS where Scribe Server runs (C:\windows\fonts)

Tomcat servlet engine and Apache web server

Tomcat can run without a Web server. In this case, however, the HTTP request to run a report must be formatted with the explicit number of port on which Tomcat listens for the incoming requests. For example, if Tomcat runs on the host www.gestalt.com, and is bound to the default port 8080, then the HTTP request that displays the Scribe login page will be http://www.gestalt.com:8080/Scribe.

If a stand-alone Web server (e.g. Apache) is available, then it may be possible to simplify the format of the HTTP request and make it more conventional by dropping the port number from the request; in this case the request will default to port 80, and the request will look like http://www.gestalt.com/Scribe. To make this work, one must use the jakarta-tomcat connector to redirect the HTTP requests received by Apache Web server to Tomcat engine.

Detailed, step-by-step description of the process of connecting Tomcat with Apache is beyond the scope of this document. However, there are many sources on the Web that provide instructions on this subject, here are a few:

http://jakarta.apache.org/tomcat/tomcat-4.1-doc/config/connectors.html

http://jakarta.apache.org/tomcat/tomcat-4.1-doc/jk2/

http://jakarta.apache.org/tomcat/tomcat-3.2-doc/tomcat-apache-howto.html

http://atlassw1.phy.bnl.gov/jakarta-tomcat/mod_jk-howto.html

http://johnturner.com/howto/apache-tomcat-howto.html *

http://galatea.com/flashguides/index

* highly recommended