PingAccess

Manually Installing on RHEL 8

About this task

This procedure assumes that:

  • A non-root user is installing the PingAccess Agent for Apache in a custom Apache instance.

  • You’ve installed the Apache installation at $APACHE. If you haven’t, modify the file paths specified in this procedure based on where your Apache installation and configuration files are located.

To manually install the PingAccess Agent for Apache on a RHEL 8 system when Apache is installed in a non-standard way:

Steps

  1. Install the following required dependencies from the RedHat Official Repositories:

    libcurl.x86_64
pcre.x86_64

  2. Copy the RPMs from the .zip archive into a directory called pkgroot and unpack them using the following commands:

    mkdir pkgroot
cp *.rpm pkgroot/
cd pkgroot
for r in *.rpm; do rpm2cpio $r | cpio -idmv; done

  3. Copy the extracted files to the appropriate places with the following commands:

    cp etc/httpd/conf.modules.d/10-paa.conf $APACHE/conf
cp -av usr/lib64/.so $APACHE/modules
cp usr/lib64/httpd/modules/*.so $APACHE/modules

  4. Add the following directive to the Apache configuration file ($APACHE/conf/httpd.conf) to include the PingAccess Agent for Apache module configuration:

    Include conf/10-paa.conf

  5. Edit the 10-paa.conf file and make the following changes:

    1. Add the following lines before the LoadModule directive:

      LoadFile modules/libpgm-5.2.so.0
LoadFile modules/libsodium.so.18
LoadFile modules/libzmq.so.5

    2. Change all occurrences of conf.d to conf.

  6. Copy your downloaded <hostname>_agent.properties to $APACHE/conf/agent.properties.

  7. Run the command $APACHE/bin/apachectl restart to restart Apache.