PingAccess

Installing on RHEL 10

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

The agent supports both x86_64 and ARM64 architectures. In the installation steps, replace <arch> with either x86_64 or aarch64.

Before you begin

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, refer to Agents.

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

    The name of the configuration file is <agentname>_agent.properties.

  • Installing on RHEL 10

  • Manually Installing on RHEL 10

Installing on RHEL 10 conventionally

Before you begin

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

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 packages:

  • openpgm-5.2.122-36.el10_0.<arch>.rpm

  • libsodium-1.0.22-1.el10_2.<arch>.rpm

  • libunwind-1.8.0-4.el10_0.<arch>.rpm

  • zeromq-4.3.5-18.el10_0.<arch>.rpm

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

Steps

  1. In RHEL, change to the pingaccess-agent-apache24-rhel10-<version>/<arch> directory.

  2. As root, install the PingAccess Agent for Apache using the following command:

    dnf install pingaccess-agent-apache-*.rpm

    You might need to first run the dnf update libsepol checkpolicy selinux-policy command to avoid any errors if your tools are not up to date.

  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 10

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.

Steps

  1. Install the following required dependencies from the Red Hat official repositories:

    libcurl.<arch>
pcre2.<arch>

  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/libunwind.so.8
LoadFile modules/libpgm-5.2.so.0
LoadFile modules/libsodium.so.26
LoadFile modules/libzmq.so.5

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

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

  7. As root, restart the Apache service using the following command:

    systemctl restart httpd