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

 

These tasks help you set up an Apache Software Foundation (ASF) Tomcat servlet engine for HTTP Server to run iSeries™ Navigator for Wireless.

 

Prerequisites

Before you begin, have QSECOFR authority and IBM® HTTP Server (5722-DG1) installed.

The following steps create an instance of an HTTP server. Therefore, you cannot use these instructions to set up iSeries Navigator for Wireless on an existing HTTP server.

To set up your Tomcat servlet engine, follow these steps:

  1. Run the following command to add the iSeries Navigator for Wireless servlet to the ASF Jakarta Tomcat servlet engine. It also sets up an IBM HTTP Server named <HTTPInstanceName> that listens for requests on port <port number>.
    CALL QSYSDIR/QYPVSETUP '-tomcat [-httpinstance <HTTPInstanceName>] [-port <port number>][-javaversion <java version>]'

    The parameters in this command are defined as follows:

    -tomcat

    This parameter specifies that ASF Tomcat is the servlet engine used to run iSeries Navigator for Wireless.

    -httpinstance <HTTPInstanceName>

    This parameter specifies the name of the HTTP instance used to run the ASF Tomcat servlet engine. The name cannot include spaces and must be less than 10 characters long. If you do not specify an instance name, the default is MCP.

    -port <port number>

    This parameter specifies the port for the HTTP Server to listen for requests. If the port is not specified, the default is 8110.

    -javaversion <java version>

    This parameter 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 is used.

    ASF Tomcat runs in process. This means that it starts and ends when the HTTP server starts and ends.

  2. Run the following command to start your HTTP server.
    STRTCPSVR SERVER(*HTTP) HTTPSVR(<HTTPInstanceName>)

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

 

Parent topic:

Configuring a Web application server

 

Related concepts


Configuring your wireless environment

 

Related information

Apache Tomcat home page