Installing the Jakarta Tomcat Servlet Gateway

Select the platform where you want to install the Jakarta Tomcat Servlet Gateway:


Installing Tomcat on NetWare 6

On NetWare 6, the Jakarta Tomcat Servlet Gateway is automatically installed in SYS:\TOMCAT\33.

Continue with Configuring Tomcat and iManager to Meet Special Network Needs .

IMPORTANT:  Tomcat is not supported for use with ZfS on NetWare 5.1.


Installing Tomcat 3.3a on Windows

To install the Jakarta Tomcat Servlet Gateway on Windows NT 4 or Windows 2000:

  1. If the Windows NT/2000 machine where you will install Tomcat does not already have Java Runtime Environment 1.3.1:

    1. Download JRE 1.3.1 from Sun*.

    2. Run the downloaded file (for example, J2RE-1_3_1_02-WIN.EXE).

    3. Set the JAVA_HOME environment variable to the location where you installed the JRE (for example, C:\Program Files\JavaSoft\JRE\1.3.1).

      For example, in Windows 2000, right-click My Computer > click Properties > Advanced > Environment Variables. Use DOS naming for any directory names that include a space (for example, PROGRA~1 for Program Files). Click OK.

  2. Download the Tomcat ZIP file from Apache.

  3. Extract the file to a convenient location on the Windows NT/2000 machine (for example, C:\Program Files).

    This places the Tomcat files into the JAKARTA-TOMCAT-3.3A subdirectory.

  4. Set the TOMCAT_HOME environment variable to the location where you installed Tomcat (for example, C:\Program Files\jakarta-tomcat-3.3a).

    For example, in Windows 2000, right-click My Computer > click Properties > Advanced > Environment Variables. Use DOS naming for any directory names that include a space (for example, PROGRA~1 for Program Files).

    IMPORTANT:  To avoid some DOS naming issues with hyphens and periods on various versions of Windows, you might want to rename the JAKARTA-TOMCAT-3.3A subdirectory to TOMCAT.

  5. To test your Tomcat installation:

    1. Start Tomcat by running STARTUP.BAT in the Tomcat BIN subdirectory.

      A DOS window will appear displaying Tomcat status messages.

    2. Display the following URL in your browser:

      http://server:8080

      where server is the IP address or DNS host name of the server where you installed Tomcat.

      You should see the default Tomcat home page on your machine.

    3. Click Servlet Examples > click Execute for each sample servlet to make sure it runs on your server.

      The default Tomcat home page provides additional information about Tomcat. If it does not appear or if the servlets do not run, you can browse to the file at:

      drive:\directory\JAKARTA-TOMCAT-3.3a
                                   \WEBAPPS\ROOT\INDEX.HTML

      This file links to information that can help you resolve any problems you are experiencing with Tomcat.

  6. Stop Tomcat by running SHUTDOWN.BAT in the Tomcat BIN subdirectory.

  7. For your convenience in later steps, create desktop shortcuts for the Tomcat STARTUP.BAT and SHUTDOWN.BAT files.

  8. Continue with Configuring Tomcat and iManager to Meet Special Network Needs .