# Installing the diagnostic tools

## Download Instructions

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

  - [MustGather: Debugging IBM HTTP Server crashes, hangs, high CPU,
    startup
    failures](http://www-1.ibm.com/support/docview.wss?uid=swg24008409)

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.