Installing Tomcat on a NetWare 5.1 Server

NOTE:  If you have NetWare 6, then Tomcat, Apache and JVM 1.3 were automatically installed during NetWare installation.

To install the Tomcat Web application server software on a NetWare 5.1 server platform:

1. If you are installing to a NetWare 5.1 server and if you have not already done so, install JVM 1.2.2 on the server.

   IMPORTANT:  On a NetWare 5.1 server, JVM 1.2.2 is required to run Novell eGuide on a Tomcat server. You can download JVM 1.2.2 from the Novell Software Downloads Web page.

2. Download the Tomcat zip file for NetWare from the Jakarta Project Web site.

   NOTE:  JAKARTA-TOMCAT-3.2.3.ZIP is the filename as of the publication date.

3. Download the Tomcat/Apache module for NetWare from the Jakarta Project Web site.

   NOTE:  MOD_JK.NLM is the filename as of the publication date.

4. Extract the JAKARTA-TOMCAT-3.2.3.ZIP file (filename as of the publication date) to SYS:JAKARTA-TOMCAT-3.2.3.

5. Edit the MOD_JK.CONF file in the SYS:JAKARTA-TOMCAT-3.2.3\CONF directory so that it looks like the one below:

   LoadModule jk_module modules/mod_jk.nlm

   <IfModule mod_jk.c>

   JkWorkersFile "SYS:/jakarta-tomcat-3.2.3/conf/workers.properties"

   JkLogFile "SYS:/jakarta-tomcat-3.2.3/logs/mod_jk.log"

   JkLogLevel warn

   JkMount /*.jsp ajp12

   JkMount /servlet/* ajp12

   JkMount /examples/* ajp12

   </IfModule>

6. Create an NCF file named TOMCAT323.NCF to start Tomcat from the NetWare server console (for example, SYS:\JAKARTA-TOMCAT-3.2.3\BIN\TOMCAT323.NCF). Type the following in the file:

   # java -Dtomcat.home="sys:/jakarta-tomcat-3.2.3" org.apache.tomcat.startup.Tomcat

   java -nsac -snTomcat -envCWD=\jakarta-tomcat-3.2.3 -classpath sys:\java\lib\rt.jar;\jakarta-tomcat-3.2.3\classes;\jakarta-tomcat-3.2.3\lib\webserver.jar;\jakarta-tomcat-3.2.3\lib\servlet.jar;\jakarta-tomcat-3.2.3\lib\ant.jar;\jakarta-tomcat-3.2.3\lib\jasper.jar;\jakarta-tomcat-3.2.3\lib\jaxp.jar;\jakarta-tomcat-3.2.3\lib\parser.jar;\jakarta-tomcat-3.2.3\lib\parser.jar -Dtomcat.home=\jakarta-tomcat-3.2.3 org.apache.tomcat.startup.Tomcat

7. Edit the AUTOEXEC.NCF file to add the following line to the search path:

   search add sys:\jakarta-tomcat-3.2.3\bin

8. For Apache/Tomcat integration, copy the MOD_JK.NLM file to the Apache modules directory (for example, SYS:APACHE\MODULES).

9. Check the Apache HTTPD.CONF file to make sure it includes the correct Include statement and path to the Tomcat MOD_JK.CONF-AUTO file.

   NOTE:  You added the Include statement when installing the Apache Web server. For details, see Installing Apache on a NetWare 5.1 Server .

10. Start Tomcat by entering the following at the server console:

    tomcat323

11. Start Apache by entering the following at the server console:

    apache