Install and test the HTTP Server

This topic provides information about how to install and test the HTTP Server and the IBM^® Web Administration for i5/OS™ interface after installation.

Important: Information for this topic supports the latest PTF levels for HTTP Server for i5/OS . It is recommended that you install the latest PTFs to upgrade to the latest level of the HTTP Server for i5/OS. Some of the topics documented here are not available prior to this update. See http://www.ibm.com/servers/eserver/iseries/software/http/services/service.htm Link outside Information Center

for more information.

Install the HTTP Server

Version numbers - Basic requirements

View the latest PTF requirements on the Internet at: http://www.ibm.com/servers/eserver/iseries/software/http/services/service.htm
Note: To determine your current HTTP Server (powered by Apache) version, use one of these methods:
- Use the "-V" option on STRTCPSVR. For example, if HTTP Server (powered by Apache 2.0.43) is installed, STRTCPSVR SERVER(*HTTP) HTTPSVR(APACHEDFT '-V') displays:
```
Server version: Apache/2.0.52
Server built:   Jun 9 2005 15:57:01
```
- From the IBM Web Administration for i5/OS interface , select Manage an HTTP server. In the server introduction, the Apache version level is included in the header. For example:
```
Manage Apache server "WEBSERVER" - Apache/2.0.52
```
View the HTTP Server compatibility information at: http://www.ibm.com/servers/eserver/iseries/software/http/product/compatibility.html
Have a communication hardware adapter that is supported by the TCP/IP protocol stack.
Add (ADDTCPIFC) and start (STRTCPIFC) at least one TCP/IP interface for the system's TCP/IP communications. You can use the NETSTAT OPTION(*IFC) command to work with the status of TCP/IP interfaces.
Specify the system's TCP/IP host and domain name (CHGTCPDMN command) information.
Add LOCALHOST to the TCP/IP host table.
Install i5/OS™ Version 5 Release 4 (5722-SS1).
Have IBM Developer Kit for Java™ (5722-JV1) *BASE, Option 5, and Option 6 installed.
Note: Java 1.3 (5722-JV1 option 5) or higher is required by the IBM Web Administration for i5/OS interface to manage WebSphere^® Application Server V5.x servers, and Java 1.4 (5722-JV1 option 6) is required to manage WebSphere Application Server V6.x servers. If more than one version of Java is installed, the highest supported level is used.
Set the QSHRMEMCTL (shared memory) system value to 1.

WebSphere Application Server - Express for iSeries™

See WebSphere Application Server - Express for information on how to install.

WebSphere Application Server for iSeries

If you plan to use WebSphere Application Server with the HTTP Server (powered by Apache), you will need to perform actions to install a version of the WebSphere Application Server Apache plug-in that is compatible with your current level of HTTP Server (powered by Apache). If the proper WebSphere Application Server PTFs are not loaded, the mismatch will prevent the HTTP Server from starting.

See the WebSphere Application Server for iSeries product Web page Link outside Information Center for information on the current PTFs, including those to upgrade to the latest WebSphere Application Server Apache plugin.

Optional software

In order to provide the required support for handling digital server certificates used by SSL for secure Web serving, you must install Option 34 i5/OS - Digital Certificate Manager option (5722-SS1).
If you want to use the native OS/400^® interface to create and edit HTML files, install IBM WebSphere Development Studio for iSeries (5722-WDS).
If you want to configure a high availability Web server cluster, then you need to install Option 41 HA Switchable Resources (5722-SS1), or use a business partner tool to manage clusters. See Clusters for more information.

To install

Insert the installation media for HTTP Server into your system.
At the OS/400 command line, type GO LICPGM and press Enter.
Select option 11 (Install licensed programs) on the Work with Licensed Programs display to see a list of licensed programs.
Select and install 5722-DG1 (HTTP Server for iSeries). If you want to use the Triggered Cache Manager, install 5722-DG1 Option 1. See the Software Installation guide for help with licensed program installation.

Authorities

See User profiles and required authorities for HTTP Server for information on user profiles and the required authorities necessary for the HTTP Server.

Web browser requirements

To use the IBM Web Administration for i5/OS interface you need a Web browser that supports the HTTP 1.0 or 1.1 protocol, frames, and Java Script. Suggested Web browsers include Microsoft^® Internet Explorer V5.0 or higher and Firefox V1.0 or higher.

Note: Consult your Web browser documentation for more information.

Test the installation of HTTP Server (powered by Apache)

The HTTP Server is installed with a default server called APACHEDFT. To test your installation, do the following:

Verify that you have an active connection from the computer with the browser to the iSeries server.
Click the Manage tab.
Click the HTTP Servers subtab.
Select the APACHEDFT server from the Server list.
Click the Start icon next to the Server list.
Click the Refresh icon and check if the server status is still shown as "Running".
If your HTTP Server (powered by Apache) does not start, see Troubleshoot.
Open another Web browser of your choice (see Web browser requirements) and go to http://your.server.name where your.server.name is the name of your iSeries to view the default Welcome page.