---
title: Installing on an Oracle HTTP Server
description: Manually install a PingAccess agent on a RHEL system with Apache 2.4 when using an Oracle HTTP Server.
component: pingaccess
version: 9.0
page_id: pingaccess:agents_and_integrations:pa-installing-on-an-ohs-http-server
canonical_url: https://docs.pingidentity.com/pingaccess/9.0/agents_and_integrations/pa-installing-on-an-ohs-http-server.html
revdate: December 11, 2025
section_ids:
  before-you-begin: Before you begin
  steps: Steps
  example: Example:
  example-2: Example:
---

# Installing on an Oracle HTTP Server

Manually install a PingAccess agent on a RHEL system with Apache 2.4 when using an Oracle HTTP Server.

## Before you begin

1. Review the [RHEL agent system requirements](pa_agent_for_apache_rhel_system_reqs.html) and make sure you're using a supported combination of agent version and RHEL version.

2. Download 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:

> **Collapse: Details**
>
> * You've installed and configured the Oracle HTTP Server 12c according to Oracle'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`
>
> * `$ORACLE_HOME` and `$OHS_COMPONENT_NAME` are set in the file path.
>
> * You've installed the Oracle HTTP Server at the appropriate location within `$ORACLE_HOME`. If you haven't, modify the file paths specified in this procedure based on where your Oracle HTTP Server installation and configuration files are located.
>
> * You've installed `libcurl` and PCRE or verified that they're installed. To install these packages, use the **yum install libcurl pcre** command.

## Steps

1. Go to the `pingaccess-agent-apache24-<RHEL_version>-<agent_version>/<arch>/` directory.

   |   |                                                                                                                                                                                                  |
   | - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
   |   | These are the only valid values currently:- *\<RHEL\_version>*: `rhel8` or `rhel9`

   - *\<agent\_version>*: `1.5.2` if using RHEL 8 or `3.0.0` if using RHEL 9

   - *\<arch>*: `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 OHS directories.

   ### Example:

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

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

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

5. Copy the `10-paa.conf` file to the OHS component home directory:

   ```
   cp -av etc/httpd/conf.modules.d/10-paa.conf $ORACLE_HOME/user_projects/domains/base_domain/config/fmwconfig/components/OHS/instances/$OHS_COMPONENT_NAME/
   ```

6. Create a `conf.d` directory if it doesn't already exist in the OHS component home directory:

   ```
   mkdir $ORACLE_HOME/user_projects/domains/base_domain/config/fmwconfig/components/OHS/instances/$OHS_COMPONENT_NAME/conf.d
   ```

7. Copy the `<agentname>_agent.properties` file to the `$ORACLE_HOME/user_projects/domains/base_domain/config/fmwconfig/components/OHS/instances/$OHS_COMPONENT_NAME/conf.d` directory.

   This is the configuration file that you downloaded in step 3 of the prerequisites section.

8. In the `10-paa.conf` file:

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

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

   2. Update the `LoadModule` directive to the correct path for `mod_paa.so`:

      ```
      LoadModule paa_module $ORACLE_HOME/ohs/modules/mod_paa.so
      ```

   3. Update the values for `PaaPropertyFiles` and `PaaCertificateDir` to point to your OHS `conf.d` directory.

9. In the OHS configuration file, `$ORACLE_HOME/user_projects/domains/base_domain/config/fmwconfig/components/OHS/instances/$OHS_COMPONENT_NAME/http.conf`, use the following directive to add the PingAccess agent for Apache's module configuration to the Oracle HTTP Server:

   ```
   Include "10-paa.conf"
   ```

10. Restart the OHS service by running `$ORACLE_HOME/user_projects/domains/base_domain/bin/restartComponent.sh <$OHS_COMPONENT_NAME>`.