--- title: Installing on an IBM HTTP Server using Apache 2.4 description: Manually install a PingAccess agent on a RHEL system with Apache 2.4 when using an IBM HTTP Server. component: pingaccess version: 9.0 page_id: pingaccess:agents_and_integrations:pa_manually_installing_on_an_ibm_http_server canonical_url: https://docs.pingidentity.com/pingaccess/9.0/agents_and_integrations/pa_manually_installing_on_an_ibm_http_server.html revdate: April 18, 2025 section_ids: before-you-begin: Before you begin about-this-task: About this task 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-2: About this task steps: Steps example: Example: example-2: Example: installing-on-a-rhel-9-system-with-an-ibm-http-server: Installing on a RHEL 9 system with an IBM HTTP Server about-this-task-3: About this task steps-2: Steps example-3: Example: example-4: Example: --- # Installing on an IBM HTTP Server using Apache 2.4 Manually install a PingAccess agent on a RHEL system with Apache 2.4 when using an IBM HTTP Server. ## 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 `_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-apache24-rhel8*.zip` * `pingaccess-agent-apache24-rhel9*.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. ## About this task Click the tab for the installation that you want to use. * With RHEL 8 * With RHEL 9 ## 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-//` directory. | | | | - | --------------------------------------------------------------------- | | | Currently, the only valid value for *\* 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 `_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. ## Installing on a RHEL 9 system with an IBM HTTP Server ### About this task To manually install the PingAccess agent for Apache on RHEL 9 when using the IBM HTTP Server: ### Steps 1. Go to the `pingaccess-agent-apache24-rhel9-//` directory. | | | | - | --------------------------------------------------------------------- | | | Currently, the only valid value for *\* is `x86_64` for 64-bit. | #### Example: `cd pingaccess-agent-apache24-rhel9-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 9 (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 ../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 `_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.