Installing on RHEL 9 - PingAccess - 8.0

PingAccess

bundle
pingaccess-80
ft:publication_title
PingAccess
Product_Version_ce
PingAccess 8.0
category
Product
pa-80
pingaccess
ContentType_ce

Install a PingAccess agent on a RHEL 9 system with Apache 2.4, either conventionally or manually.

If you haven't downloaded an agent.properties file, you must first:

  1. In the PingAccess console, go to Applications > Agents.
  2. Click the Pencil icon to edit a configured agent.

    If you haven't created an agent yet, see Agents.

  3. In the Shared Secrets section, click the Download icon to download the configuration.
    Remember:

    The configuration file will be named <agentname>_agent.properties.

Click the respective tab for the installation that you want to use.

Installing on RHEL 9 conventionally

Download and extract the pingaccess-agent-apache24-rhel9-<version>.zip archive.

Note:

The Agent RPM has required dependencies that might be available through standard repositories. If these dependencies aren't available in your Linux version, you can install them using the included openpgm-5.2.122-28.el9.x86_64.rpm, libsodium-1.0.18-8.el9.x86_64.rpm, libunwind-1.6.2-1.el9.x86_64.rpm, and zeromq-4.3.4-2.el9.x86_64.rpm packages.

You can install these RPMs using yum install libsodium*rpm openpgm*rpm libunwind*rpm zeromq*rpm.

To install a PingAccess agent on a RHEL 9 system with Apache 2.4:

  1. In RHEL, change to the pingaccess-agent-apache24-rhel9-<version>/x86_64 directory.
  2. As root, install the PingAccess Agent for Apache using the following command:
    yum install pingaccess-agent-apache-*.rpm
  3. Copy the <agentname>_agent.properties file to /etc/httpd/conf.d/agent.properties.
  4. As root, restart the Apache service using the following command:
    systemctl restart httpd

Manually Installing on RHEL 9

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 9 system when Apache is installed in a non-standard way:

  1. Install the following required dependencies from the Red Hat 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. Edit the 10-paa.conf file and make the following changes:
    1. Add the following lines before the LoadModule directive:
      LoadFile modules/libunwind.so.8
      LoadFile modules/libpgm-5.2.so.0
      LoadFile modules/libsodium.so.23
      LoadFile modules/libzmq.so.5
    2. Change all occurrences of conf.d to conf.
  5. Copy your downloaded <hostname>_agent.properties to $APACHE/conf/agent.properties.
  6. Run the $APACHE/bin/apachectl restart command to restart Apache.