---
title: Installing on an IBM HTTP Server using Apache 2.2
description: Manually install a PingAccess agent on a RHEL system with Apache 2.2 when using IBM HTTP Server 8.5.5.
component: pingaccess
version: 9.0
page_id: pingaccess:agents_and_integrations:pa_ibm_http_apache_22
canonical_url: https://docs.pingidentity.com/pingaccess/9.0/agents_and_integrations/pa_ibm_http_apache_22.html
revdate: April 18, 2025
section_ids:
  before-you-begin: Before you begin
  installing-on-a-rhel-8-system-with-an-ibm-http-server: Installing on a RHEL 8 system with an IBM HTTP Server
  about-this-task: About this task
  steps: Steps
  example: Example:
  example-2: Example:
---

# Installing on an IBM HTTP Server using Apache 2.2

Manually install a PingAccess agent on a RHEL system with Apache 2.2 when using IBM HTTP Server 8.5.5.

## Before you begin

If you haven't downloaded an `agent.properties` file:

1. In the PingAccess admin console, go to **Applications > Agents**.

2. Click the **Pencil** icon to edit a configured agent.

   If you haven't created an agent yet, learn more about how to do so in [Adding agents](../pingaccess_user_interface_reference_guide/pa_adding_agents.html).

3. In the **Shared Secrets** section, click the **Download** icon to download the configuration.

   |   |                                                                      |
   | - | -------------------------------------------------------------------- |
   |   | The configuration file will be named `<agentname>_agent.properties`. |

This procedure assumes that:

* You've installed and configured the IBM HTTP Server according to IBM's documentation.

* You've downloaded and extracted the version-appropriate `.zip` archive for your environment. For example:

  * `pingaccess-agent-apache22-rhel8*.zip`

* `apachectl` for the running IBM HTTP Server instance is in the file path.

* You've installed the Apache installation at `$IHS`. If you haven't, modify the file paths specified in this procedure based on where your Apache installation and configuration files are located.

* You've installed `libcurl` and PCRE or verified that they are installed. To install these packages, use the `yum install libcurl pcre` command.

## Installing on a RHEL 8 system with an IBM HTTP Server

### About this task

To manually install the PingAccess agent for Apache on RHEL 8 when using the IBM HTTP Server:

### Steps

1. Go to the `pingaccess-agent-apache22-rhel8-<version>/<arch>/` directory.

   |   |                                                                       |
   | - | --------------------------------------------------------------------- |
   |   | Currently, the only valid value for *\<arch>* is `x86_64` for 64-bit. |

   #### Example:

   `cd pingaccess-agent-apache22-rhel8-1.6.0/x86_64/`

2. Extract the package RPMs using the following command:

   ```
   mkdir pkgroot
   cp *.rpm pkgroot/
   cd pkgroot
   for r in *.rpm; do rpm2cpio $r | cpio -idmv; done
   ```

3. Run the `cp` command to copy the libraries to the appropriate Apache directories.

   #### Example:

   For RedHat Enterprise Linux 8 (x86\_64):

   ```
   cp -av usr/lib64/*.so* $IHS/modules
   ```

4. Copy `mod_paa.so` into the Apache modules directory:

   ```
   cp -av usr/lib64/httpd/modules/mod_paa.so $IHS/modules
   ```

5. Copy the `paa.conf` file to the Apache configuration directory:

   ```
   cp -av etc/httpd/conf.d/paa.conf $IHS/conf
   ```

6. In the `paa.conf` file:

   1. Add the following lines before the `LoadModule` directive:

      ```
      LoadFile modules/libpgm-5.2.so.0
      LoadFile modules/libzmq.so.5
      ```

   2. Update the values for `PaaPropertyFiles` and `PaaCertificateDir` to point to your Apache `conf` directory.

7. In the Apache configuration file, `$IHS/conf/httpd.conf`, use the following directive to add the PingAccess agent for Apache's module configuration:

   ```
   Include conf/paa.conf
   ```

8. Copy the `<agentname>_agent.properties` file to the `$IHS/conf/agent.properties` directory.

   This is the configuration file that you downloaded in step 3 of [Installing on an IBM HTTP Server using Apache 2.2](pa_ibm_http_apache_22.html).

9. Restart the Apache service by running the `apachectl restart` command.