PingAccess

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 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.

    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:

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>.