[z/OS]

Configuring an instance of IBM HTTP Server on the z/OS system

You can configure an instance of IBM® HTTP Server on the z/OS® operating system. IBM HTTP Server Version 9 for WebSphere® Application Server for z/OS is a base element of z/OS V2R2 and later. You must configure an instance of IBM HTTP Server on the z/OS operating system after installing.

Before you begin

Attention: IBM HTTP Server now installs with the base operating system on z/OS V2R2 and later. No separate installation is required. IBM HTTP Server Version 9 installs in the /usr/lpp/ihsa_zos directory.
Prior to using the installer program:
  • Create a System Authorization Facility (SAF) user ID and group for IBM HTTP Server. For more information, see "Performing required z/OS system configuration".

    The examples that follow in this topic assume a server user ID of WWWSERV and a server group of WWWGROUP.

  • If you are using IBM HTTP Server with WebSphere Application Server, create an installation directory for the configuration files for the server instance. For more information, see the topic about migrating and installing IBM HTTP Server on z/OS systems.
    The examples that follow in this topic assume an installation directory of /etc/websrv1. Set the directory permissions to 770 and the directory ownership to the server user ID and group:
    mkdir  /etc/websrv1 
    chown  WWWSERV:WWWGROUP /etc/websrv1
    chmod 770 /etc/websrv1
  • If you are installing the product for the first time, then enable the administrative console to modify the httpd.conf file by adding the WebSphere Application Server control region user ID to the IBM HTTP Server group using SAF. For example, to add a user ASCR1 to the group WWWGROUP, type the following command:
    CONNECT ASCR1 GROUP (WWWGROUP) OWNER (WWWGROUP)
Attention: IBM HTTP Server on z/OS V2R2 installs with the base operating system and no separate installation is required. For older releases of z/OS, follow the IBM Installation Manager information in this topic.

About this task

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

Procedure

  1. Log in to the z/OS UNIX System Services shell with the user ID that runs the installer. (See the Before you begin section for this topic.) Change the directory to the IBM HTTP Server product code directory:
    cd /usr/lpp/IHSA/V8R5
  2. Set the umask value to 022 by specifying umask 022. To verify that the umask value is set to 022, run the umask command.
  3. Run the installer program to install the product files into the installation directory, perform initial customization, and create symbolic links from the installation directory to the product directory.
    [Updated in August 2014]
    Note: With the -31 parameter, bin/install_sh creates the same directory structure and files as they do without the parameter, but all links point to the .31bit path in the IHS installation path. All references to the executable, such as apachectl, stay the same.
    [Updated in August 2014]
    [Updated in August 2014]Four parameters can be used to invoke the installer program.
    • Optional: The -admin keyword, which allows you to use the administrative console to modify the httpd.conf file.
    • The installation directory for the server instance. This must not be the same as the product directory.
    • Optional: The non-SSL port for the web server. The default port is 80. You can also change the port on the Listen directive.
    • [Updated in August 2014]If you are using IBM HTTP Server with WebSphere Application Server, if directed by a dependent product or component to create a 31-bit instance of IHS, pass the -31 parameter to bin/install_ihs. This results in an instance directory that is configured to point to 31-bit executables. Never directly reference the .31bit sub-directory of an read-only installation or (64-bit) instance directory. [Updated in August 2014]
    [Updated in August 2014]
    You can invoke the command with or without support for modifying thehttpd.conf file from the WebSphere Application Server administration console (-admin). 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
    Note: If your product directory path contains symbolic links, point the symbolic links to the following default product directory: /usr/lpp/IHSA/V8R5. If you do not use the default product directory, you must invoke the installation script using its absolute path, such as /WebSphere/8.5/SMPE/bin/install_ihs. If you 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 directory.
  4. Optional: You can start the IBM HTTP Server 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. Ensure that the JCL procedure is assigned to the user and group you defined for IBM HTTP Server. For more information, see "Performing required z/OS system configuration". This step is required if you are using the administrative console to start and stop IBM HTTP Server.
    Note: [Updated in March 2014]The PARM value on your JCL cataloged procedure is limited to 100 characters. Since the PARM value contains the installation directory (&DIR), the total length could exceed the 100 character limit if the directory path is too long. The path name length needs to be taken into consideration when choosing the installation directory. If the installation directory path name is too long, it is possible to use a shorter named path in the JCL that is symbolically linked to the original installation directory path name.[Updated in March 2014]
  5. Optional: You can create multiple instances of IBM HTTP Server by running the IBM HTTP Server installer program more than once. However, you must specify a different installation directory each time you run the installer program.

Results

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 directory 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/8.5.0.0 (Unix)
    Server built:   Jan  9 2012 11:20:34
    # bin/apachectl configtest
    Syntax OK
    The actual version string and build date varies.
  3. Start IBM HTTP Server.
    bin/apachectl start
  4. 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. You should see the IBM HTTP Server default home page.
  5. Stop IBM HTTP Server by running the following command:
    bin/apachectl stop

What to do next

Task topic    

Terms and conditions for product documentation | Feedback

Last updated: January 28, 2018 08:56 PM GMT-06:00
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=ihs-dist&topic=tihs_installihsz
File name: tihs_installihsz.html