Configure your WebSphere Application Server, Base Edition, Version 5.0

Requirements

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

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

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 QEJBAS5 subsystem is running. If it is not running, run the following command:

STRSBS QEJBAS5/QEJBAS5

Create your Web application server

Running the following command will set up iSeries Navigator for Wireless to run using WebSphere 5.0 Base 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 5733WS5 [-nodename <node name>] [-wasinstance
<WASInstanceName>] [-httpinstance <HTTPInstanceName>] [-port <port number>]'

The parameters in the command above are defined as follows:

-wasversion 5733WS5

Specifies that Websphere 5.0 Base Edition will be used to run iSeries Navigator for Wireless.

-nodename <system name>

Specifies the short name of the system that iSeries Navigator for Wireless is being set up for. For example, if the system name is yoursystem.yourcompany.com, the <system name> would be your system.

-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/WebAS5/Base/bin/startServer iSeriesNavigatorForWireless -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.