Configure your WebSphere Application Server, Express Edition, Version 5.0

Create and configure an HTTP server using WebSphere^® Application Server Express Edition for your wireless network.

The following tasks will help you set up iSeries™ Navigator for Wireless to run using WebSphere Application Server (WAS) 5.0 Express Edition:

Requirements

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

IBM^® HTTP Server (5722-DG1)
WebSphere 5.0.1 and above

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.

The following instructions assume you have configured and are running WebSphere already. If you have not yet set up WebSphere, go to WebSphere at http://www.ibm.com/eserver/iseries/products/websphere for complete prerequisite details (including Java™). The WebSphere Administrative Console program installed on a PC (that is, Windows NT^® on the TCP/IP network) should be used in the setup and configuration.

If you are a new WebSphere user, make the Hello World servlet application functional by following the configuration steps on the WebSphere homepage. This setup process helps you to become familiar with WebSphere, and it verifies that the installation and configuration are successful.

Start the WebSphere subsystem

Make sure the QASE5 subsystem is running. If it is not running, run the following command:

STRSBS QASE5/QASE5

Create your Web application server

Running the following command will set up iSeries Navigator for Wireless to run using WebSphere 5.0 Express Edition as the servlet engine. It will create an instance of WebSphere named <WASInstanceName> and an IBM HTTP Server (powered by Apache) named <HTTPInstanceName> that listens for requests on port <port number>. Make sure that subsystem QEJBAS5 is running before trying this command. 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 '-wasversion 5722IWE [-wasinstance <WASInstanceName>]
[-httpinstance <HTTPInstanceName>] [-port <port number>]'

The parameters in the command above are defined as follows:

-wasversion 5722IWE: Specifies that Websphere 5.0 Express Edition will be used to run iSeries Navigator for Wireless.
-wasinstance <WASInstanceName>: Specifies the name of the WebSphere instance that will be created to run iSeries Navigator for Wireless. The instance that is specified cannot exist yet, otherwise there will be an error when the command is run. If you do not specify an instance name, the name of the instance will be MCP.
-httpinstance <HTTPInstanceName>: Specifies the name of the HTTP instance used to run the WebSphere 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 first number of a block of 6 ports. The HTTP Server will listen for requests on <port number>, and the application server listens on <port number> + 1 through <port number> + 5. If you do not specify a port number, the default is 8110 for the HTTP Server and 8111 - 8115 for the application server.

Start the WebSphere application server

To start your application server, you need to run this command from the QSHELL command line:

/QIBM/ProdData/WebASE/ASE5/bin/startServer <WASInstanceName> -instance <WASInstanceName>

The port number for the admin console of this instance of the WebSphere application server will be displayed once the application server has started.

Start your HTTP Server

After you start your application server, you need to start your 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.