Installing Apache Tomcat Server 5.5.15 on the iSeries

 

Introduction

Standard Disclaimer

Prerequisites

• Apache Tomcat Server version 5.5.15.
• V5R1 or above. 
• IBM Java Virtual Machine version 1.5 (available from IBM via PTF). To check for this prerequisite, run:

  WRKLNK OBJ('/qibm/ProdData/Java400/jdk15')

• TCP/IP port 7080 must be available. To check this port:
  • NETSTAT OPTION(*CNN)
  • Observe the local ports.
  • If 7080 is already in use, see the Apache Tomcat documentation to change Tomcat's configuration.

    Note: If you need to change Tomcat's configuration, all Tomcat files are stored in IFS folder /TOMCAT5515. To access the Tomcat IFS folder:

    1. WRKLNK OBJ('/tomcat5515')
    2. On the folder where you need to change the Tomcat settings, use option 5.
    3. On the file you need to change, use option 2 to edit. 

Making Java Virtual Machine Version 1.5 the Default

1. Edit the Java system properties file:

   EDTF STMF('/qibm/userdata/java400/systemdefault.properties')  

2. Make the following changes:

   java.home=/QIBM/ProdData/Java400/jdk15/
   java.version=1.5

3. Save and exit the properties file.

Installing Apache Tomcat

1. Download and run the RJS Software Apache Tomcat 5.5.15 FTP Installer to upload and restore the library automatically.

   Note: Make sure to use a security officer level user with *ALLOBJ authority.

2. After the RJSTOMC55 library is installed, run the following commands to restore the Apache Tomcat IFS Folder /TOMCAT5515:
   1. ADDLIBLE LIB(RJSTOMC55)
   2. RSTTOMCAT

      These commands may take a few minutes to run.

      Note: If you have trouble restoring objects:

      1. Check the job log to see if it is an ownership issue.
      2. If so, create a user profile named RJSOWNER and re-run the RSTTOMCAT command.
      3. After the objects have been restored, delete the RJSOWNER profile.
      4. Change the parameter for Owned object value to *CHGOWN and specify a profile name.
3. Make sure the Tomcat folder was installed:

   WRKLNK OBJ('/tomcat5515')

4. Start Apache Tomcat Server in the QSYSWRK subsystem:

   STRTOMCAT

   The initial Apache Tomcat Server start-up may take a few minutes because the iSeries needs to compile some of the Tomcat objects and JSP pages. This process happens automatically.

   Note: If you need to shut down Apache Tomcat Server in the QSYSWRK subsystem, use ENDTOMCAT.

5. After Apache Tomcat Server is started, there a job in QSYSWRK named TOMCATSVR. To check that this job is running, use:

   WRKACTJOB SBS(QSYSWRK) JOB(TOMCATSVR)

6. Make sure that Apache Tomcat Server is using the TCP/IP port 7080 by checking the local ports:

   NETSTAT OPTION(*CNN)

7. Use the following URL to access the Apache Tomcat home page, substituting your iSeries IP address for 1.1.1.1:

   http://1.1.1.1:7080

   If the Apache Tomcat home page displays, you have correctly configured Apache Tomcat. 

8. Install all your custom Tomcat Java, JSP, and Servlet applications in the /tomcat5515/webapps IFS folder.

   Once you have copied the applications into the WEBAPPS folder, you can access them with Apache Tomcat Server. 

You are now set up to develop Java and JSP pages on your iSeries and use Apache Tomcat Server.