PingAccess

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

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