---
title: Installing on a RHEL 8 system with an IBM HTTP Server
description: To manually install the PingAccess agent for Apache on RHEL 8 when using the IBM HTTP Server:
component: pingaccess
version: 9.0
page_id: pingaccess:agents_and_integrations:pa_ibm_r8
canonical_url: https://docs.pingidentity.com/pingaccess/9.1/agents_and_integrations/pa_ibm_r8.html
llms_txt: https://docs.pingidentity.com/pingaccess/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: April 18, 2025
superseded_by: https://docs.pingidentity.com/pingaccess/9.1/agents_and_integrations/pa_ibm_r8.html
section_ids:
  about-this-task: About this task
  steps: Steps
  example: Example:
  example-2: Example:
---

# 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-apache24-rhel8-<version>/<arch>/` directory.

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

   ### Example:

   `cd pingaccess-agent-apache24-rhel8-3.0.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 `10-paa.conf` file to the Apache configuration directory:

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

6. In the `10-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/10-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.4](pa_manually_installing_on_an_ibm_http_server.html).

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