PingAccess

Installing on an IBM HTTP Server using Apache 2.2

Manually install a PingAccess agent on a RHEL system with Apache 2.2 when using IBM HTTP Server 8.5.5.

Before you begin

If you haven’t downloaded an agent.properties file:

  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.

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

This procedure assumes that:

  • You’ve installed and configured the IBM HTTP Server according to IBM’s documentation.

  • You’ve downloaded and extracted the version-appropriate .zip archive for your environment. For example:

    • pingaccess-agent-apache22-rhel7*.zip

    • pingaccess-agent-apache22-rhel8*.zip

  • apachectl for the running IBM HTTP Server instance is in the file path.

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

  • You’ve installed libcurl and PCRE or verified that they are installed. To install these packages, use the yum install libcurl pcre command.

About this task

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

  • With RHEL 7

  • With RHEL 8

Installing on a RHEL 7 system with an IBM HTTP Server

About this task

To manually install the PingAccess agent for Apache on RHEL 7 when using the IBM HTTP Server:

Steps

  1. Go to the pingaccess-agent-apache22-rhel7-<version>/<arch>/ directory.

    Currently, the only valid value for <arch> is x86_64 for 64-bit.

    Example:

    cd pingaccess-agent-apache22-rhel7-1.5.0/x86_64/

  2. Extract the package RPMs using the following command:

    mkdir pkgroot
    cp *.rpm pkgroot/
    cd pkgroot
    for r in *.rpm; do rpm2cpio $r | cpio -idmv; done
  3. Run the cp command to copy the libraries to the appropriate Apache directories.

    For RedHat Enterprise Linux 7 (x86_64):

    cp -av usr/lib64/.so $IHS/modules
  4. Copy mod_paa.so into the Apache modules directory:

    cp -av ../mod_paa.so $IHS/modules
  5. Copy the paa.conf file to the Apache configuration directory:

    cp -av ../../paa.conf $IHS/conf
  6. In the paa.conf file:

    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. Update the values for PaaPropertyFiles and PaaCertificateDir to point to your Apache conf directory.

  7. In the Apache configuration file, $IHS/conf/httpd.conf, use the following directive to add the PingAccess agent for Apache’s module configuration:

    Include conf/paa.conf
  8. Copy the <agentname>_agent.properties file to the $IHS/conf/agent.properties directory.

    This is the configuration file that you downloaded in step 3 of Installing on an IBM HTTP Server using Apache 2.2.

  9. Restart the Apache service by running the apachectl restart command.

Installing on a RHEL 8 system with an IBM HTTP Server

About this task

To manually install the PingAccess agent for Apache on RHEL 8 when using the IBM HTTP Server:

Steps

  1. Go to the pingaccess-agent-apache22-rhel8-<version>/<arch>/ directory.

    Currently, the only valid value for <arch> is x86_64 for 64-bit.

    Example:

    cd pingaccess-agent-apache22-rhel8-1.5.0/x86_64/

  2. Extract the package RPMs using the following command:

    mkdir pkgroot
    cp *.rpm pkgroot/
    cd pkgroot
    for r in *.rpm; do rpm2cpio $r | cpio -idmv; done
  3. Run the cp command to copy the libraries to the appropriate Apache directories.

    Example:

    For RedHat Enterprise Linux 8 (x86_64):

    cp -av usr/lib64/.so $IHS/modules
  4. Copy mod_paa.so into the Apache modules directory:

    cp -av usr/lib64/httpd/modules/mod_paa.so $IHS/modules
  5. Copy the paa.conf file to the Apache configuration directory:

    cp -av etc/httpd/conf.d/paa.conf $IHS/conf
  6. In the paa.conf file:

    1. Add the following lines before the LoadModule directive:

      LoadFile modules/libpgm-5.2.so.0
      LoadFile modules/libzmq.so.5
    2. Update the values for PaaPropertyFiles and PaaCertificateDir to point to your Apache conf directory.

  7. In the Apache configuration file, $IHS/conf/httpd.conf, use the following directive to add the PingAccess agent for Apache’s module configuration:

    Include conf/paa.conf
  8. Copy the <agentname>_agent.properties file to the $IHS/conf/agent.properties directory.

    This is the configuration file that you downloaded in step 3 of Installing on an IBM HTTP Server using Apache 2.2.

  9. Restart the Apache service by running the apachectl restart command.