Configure your ASF Jakarta Tomcat servlet engine for HTTP Server (powered by Apache)

Create and configure the servlet engine for your wireless network.

The following tasks will help you set up an ASF Tomcat servlet engine for HTTP Server (powered by Apache) to run iSeries™ Navigator for Wireless:

Requirements

Before you begin, you must have QSECOFR authority and the following installed:

IBM^® HTTP Server (5722-DG1)

Note: The following instructions will create a new instance of an HTTP Server; you cannot use the following instructions to set up iSeries Navigator for Wireless on an existing HTTP Server.

Create your Web application server

Running the following command will add the iSeries Navigator for Wireless servlet to the Apache Software Foundation Jakarta Tomcat servlet engine. It will also set up an IBM HTTP server (powered by Apache) named <HTTPInstanceName> that listens for requests on port <port number>. Items in [brackets] are optional, and if you do not specify a value, a default value will be used. Replace items in <italics> with your own information:

CALL QSYSDIR/QYPVSETUP '-tomcat [-httpinstance <HTTPInstanceName>] [-port <port
number>][-javaversion <java version>]'

The parameters in the command above are defined as follows:

-tomcat: Specifies that ASF Tomcat is the servlet engine used to run iSeries Navigator for Wireless.
-httpinstance <HTTPInstanceName>: Specifies the name of the HTTP instance used to run the ASF Tomcat servlet engine. If you do not specify an instance name, the default is MCP. When specifying an instance name, the name cannot include spaces and must be less than 10 characters long.
-port <port number>: Specifies the port for the HTTP Server to listen for requests. If the port is not specified, the default is 8110.
-javaversion <java version>: Specifies the version of Java™ Developer's Kit to use. Valid values for this parameter are 1.3 and 1.2. If you do not specify a java version, the default is 1.3 if it is installed, otherwise 1.2 will be used.

Start your Web application server

ASF Tomcat runs 'in process'; this means that it starts and ends when the HTTP server starts and ends. After you run the above command and setup is complete, you need to start the HTTP Server by running the following command:

STRTCPSVR SERVER(*HTTP) HTTPSVR(<HTTPInstanceName>)

Now that you have finished setting up your web application server, you can continue to configure your wireless environment.

For more information about ASF Jakarta Tomcat, go to http://jakarta.apache.org/tomcat/index.html.