Installing on RHEL 7 - PingAccess - 8.1

PingAccess

bundle
pingaccess-81
ft:publication_title
PingAccess
Product_Version_ce
PingAccess 8.1 (Latest)
category
Product
pa-81
pingaccess
ContentType_ce

Install a PingAccess agent on a RHEL 7 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 7 conventionally

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

Note:

Some dependencies might require access to the epel-release repository. To ensure your package manager has access, run the following command:

curl -O https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm && \ rpm -i epel-release-latest-7.noarch.rpm
Note:

The agent RPM has required dependencies that might be available through standard repositories. If these dependencies are not available in your Linux version, you can install them using the included libpgm-5_2-0-5.2.122-32.1.x86_64.rpm, libsodium18-1.0.11-1.1.x86_64.rpm, and libzmq5-4.3.1-23.6.x86_64.rpm packages.

You can install these RPMs using the following command:

yum install libsodium*rpm libpgm*rpm libzmq*rpm

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

  1. In RHEL, change to the pingaccess-agent-apache24-rhel7-<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.service

Manually Installing on RHEL 7

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 7 system 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 archive into a directory called pkgroot and extract 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 $APACHE/bin/apachectl restart command to restart Apache.