Installing the diagnostic tools

Download Instructions

Refer to the following IBM HTTP Server MustGather document for download access to the ihsdiag package files:

The ihsdiag tar.gz package has been provided for Unix, Linux, and z/OS systems.

The ihsdiag zip package has been provided for Windows systems.

After downloading the appropriate file, transfer it to the system with IBM HTTP Server.

Note for IHS 7.0 and later users

Most diagnostic modules, but not the rest of the MustGather, are now provided with the product itself. See the modules/debug/ subdirectory and conf/httpd.conf.default for further details.

Installation Instructions

Install the ihsdiag package on the system with IBM HTTP Server. You can also install ihsdiag on a personal workstation in order to view the enclosed documentation, or you can view the documentation from an IBM web site.

Installing on Unix and Linux systems

  1. Copy ihsdiag-1.4.30.tar.gz to the directory where it should be installed. Common locations are the IBM HTTP Server installation directory or /usr/local/ihsdiag.

  2. Extract the files using the following command:

        gzip -dc ihsdiag-1.4.30.tar.gz | tar -xf -

After installing the package, a directory named ihsdiag-1.4.30 will be created.

The documentation for ihsdiag is available on the Internet at http://publib.boulder.ibm.com/httpserv/ihsdiag/. The documentation is also stored in the download packages and can be found in the docs subdirectory within ihsdiag-1.4.30. To view the documentation within the download packages, use a Web browser to open the file index.html within the docs subdirectory.

Installing on z/OS systems

  1. Copy ihsdiag-1.4.30.tar to the directory where it should be installed. A common location is the IBM HTTP Server installation (instance) directory.

  2. Extract the files using the following command:

       tar -xof ihsdiag-1.4.30.tar

  3. Set the APF and program control attributes on the diagnostic modules, if necessary.
    This step is only required if diagnostic modules will be loaded into the web server configuration. The user performing this step must have read access to the BPX.FILEATTR.PROGCTL facility.
    This step is performed using the following command:

        extattr +p ihsdiag-1.4.30/2.0/zOS/*.so

After installing the package, a directory named ihsdiag-1.4.30 will be created.

The documentation for ihsdiag is available on the Internet at http://publib.boulder.ibm.com/httpserv/ihsdiag/. The documentation is also stored in the download packages and can be found in the docs subdirectory within ihsdiag-1.4.30. The documentation files are coded in ASCII and are intended to be read by a web browser, so z/OS customers will need to access the documentation from the Internet location, or install the package on a workstation and use a web browser on that system.

Installing on Windows systems

  1. Copy ihsdiag-1.4.30.zip to the directory where it should be installed. A common location is the IBM HTTP Server installation directory.

  2. Unzip package.

After installing the package, a directory named ihsdiag-1.4.30 will be created.

The documentation for ihsdiag is available on the Internet at http://publib.boulder.ibm.com/httpserv/ihsdiag/. The documentation is also stored in the download packages and can be found in the docs subdirectory within ihsdiag-1.4.30. To view the documentation within the download packages, use a Web browser to open the file index.html within the docs subdirectory.

Invocation instructions

The Java components of ihsdiag-1.4.30 must be run under an IBM Java runtime of Java 7 or later.