This procedure makes the following assumptions:

  • The installation is being performed in a custom Apache instance run by a non-root user.
  • The Apache installation is installed at $APACHE. In the steps in this procedure, modify the paths specified based on where your Apache installation and configuration files are located.
  • You have downloaded an agent.properties file. If you have not done so, you can do so using these steps:
    1. In the PingAccess Console, navigate to the Sites & Agents page.
    2. Edit a configured agent. If the agent has not yet been created, see the PingAccess User Interface Reference Guide.
    3. In the shared secret, click the download icon to download the configuration. The configuration file will be named <agentname>_agent.properties.
Use the following procedure to manually install the PingAccess Agent for Apache when Apache is installed in a non-standard way:
  1. Install the following required dependencies from the RedHat Official Repositories:
    libcurl.x86_64
    pcre.x86_64
  2. Copy the RPMs from the zip distribution 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. Execute the command $APACHE/bin/apachectl restart to restart Apache.