Search Tips   |   Advanced Search

Home Operating Systems: z/OS


Install IHS

This topic describes how to install a running version (server instance) of the IHS for WebSphere Application Server on z/OS using the installer program.

Prior to using the installer program:

Using the installer program, perform the following tasks to install a running instance of IBM HTTP Server for z/OS on your machine.

  1. Log in to the UNIX System Services shell with the user ID that will run the installer. (See the Before you begin section for this topic.) Change the to the IBM HTTP Server product code directory:


  2. Run the installer program to install the product files into the installation directory, perform initial customization, and create symbolic links from the installation to the product directory.

    The installer program is: bin/install_ihs. Three parameters can be used to invoke the installer program.

    • Optional: The -admin keyword, which allows you to use the admin console to modify the httpd.conf file.

    • The installation for the server instance. This must not be the same as the product

    • Optional: The non-SSL port for the Web server. The default port is 80. You can also change the port on the Listen directive.

    The following examples invoke the installer program from the admin console. You can invoke the command with or without support for modifying thehttpd.conf file. For both examples, /etc/websrv1 is the installation directory, and 80 is the non-SSL port for the Web server.

    • This example invokes the command with support for modifying the httpd.conf file.

      bin/install_ihs -admin /etc/websrv1 80

    • This example invokes the command without support for modifying the httpd.conf file.

      bin/install_ihs /etc/websrv1 80

    If wer product path contains symbolic links, you should point the symbolic links to the following default product directory: /usr/lpp/IHSA/V7R0/server. If we do not use the default product directory, invoke the installation script using its absolute path, such as

    . If we do not use of the two options, IBM HTTP Server creates physical links, not logical links, when it creates the symbolic links for the installation

  3. Optional: This step is optional unless the admin console is configured to start and stop IBM HTTP Server. You can start the IHS instance from the MVS™ console by creating a JCL cataloged procedure for the instance. For more information, see the topic about using JCL procedures to start IBM HTTP Server on z/OS. Verify the JCL procedure is assigned to the user and group you defined for IBM HTTP Server, as described in the topic about performing required z/OS system configurations.

  4. Optional: You can create multiple instances of IHS by running the IBM HTTP Server installer program more than once. However, specify a different installation each time you run the installer program.

Perform the following steps to confirm that you have successfully installed a running version of the product on your machine:

  1. Log in to the OMVS shell using the server user ID. Verify that the server user ID has a non-zero UID value. Change the to the server instance's installation directory:

    cd /etc/websrv1

  2. Run the following commands to verify the installation of the program: apachectl -v and apachectl configtest

    The following sample output is an example of a successful program installation:

    # bin/apachectl -v
    Server version: IBM_HTTP_Server/ (Unix)
    Server built:   Jan  9 2008 11:20:34
    # bin/apachectl configtest
    Syntax OK
    The actual version string and build date will vary.

  3. Start IHS.

    bin/apachectl start

  4. Load the default Web page from the browser to confirm that IBM HTTP Server is operational: Point a Web browser to the IP name or address of your z/OS system, using either the non-SSL port number you specified when running the installer program, or the default port of 80.

  5. Stop IHS by running the following command:

    bin/apachectl stop


What to do next



Running multiple instances of IHS from a single install


Related concepts

Using JCL procedures to start IHS on z/OS


Related tasks

Performing required z/OS system configurations

Uninstalling IHS

z/OS: Preparing the base z/OS operating system for product installation

Install and configuring the WebSphere Application Server plug-in for IHS on z/OS


Related reference

FastCGI directives

SSL directives

Migrating and installing IHS on z/OS systems

Configuring IHS