Install and test the HTTP Server

 

 

+

Search Tips   |   Advanced Search

 

Overview

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

Information for this topic supports the latest PTF levels for HTTP Server for iSeries. IBM recommends 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.

 

class="sectiontitle">Install the HTTP Server

Version numbers - Basic requirements

• View the latest PTF requirements on the Internet

  To determine the current HTTP Server version, use one of these methods:

  • Use the "-V" option on STRTCPSVR. For example, if HTTP Server 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 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 command...

  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.

  Java 1.3 (5722-JV1 option 5) or higher is required by the 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 for iSeries

If you plan to use WebSphere Application Server with the HTTP Server, 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.

If the proper WebSphere Application Server PTFs are not loaded, the mismatch will prevent the HTTP Server from starting.

Optional software

• In order to provide the required support for handling digital server certificates used by SSL for secure Web serving, 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 install Option 41 HA Switchable Resources (5722-SS1), or use a business partner tool to manage clusters. See Clusters for more information.

To install

1. Insert the installation media for HTTP Server into your system.

2. At the OS/400 command line, type

   GO LICPGM

   and press Enter.

3. Select option 11 (Install licensed programs) on the Work with Licensed Programs display to see a list of licensed programs.

4. 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.

 

class="sectiontitle">Authorities

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

 

class="sectiontitle">Web browser requirements

• To use the 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.

Consult your Web browser documentation for more information.

 

class="sectiontitle">Test the installation of HTTP Server

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

1. Verify that you have an active connection from the computer with the browser to the iSeries server.

2. Click the Manage tab.

3. Click the HTTP Servers subtab.

4. Select the APACHEDFT server from the Server list.

5. Click the Start icon next to the Server list.

6. Click the Refresh icon and check if the server status is still shown as "Running".

   If your HTTP Server does not start, troubleshoot.

7. Open another Web browser of your choice and go to...

   http://your.server.name

   ...where your.server.name is the name of your iSeries to view the default Welcome page.

 

Parent topic:

Tasks