Installing on an IBM HTTP Server using Apache 2.4 - PingAccess - 8.0

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

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

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.
    Remember:

    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-apache24-rhel7*.zip
    • pingaccess-agent-apache24-rhel8*.zip
    • pingaccess-agent-apache24-rhel9*.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.

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

Installing on a RHEL 7 system with an IBM HTTP Server

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

  1. Go to the pingaccess-agent-apache24-rhel7-<version>/<arch>/ directory.
    Note:

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

    cd pingaccess-agent-apache24-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 10-paa.conf file to the Apache configuration directory: 
    cp -av ../../10-paa.conf $IHS/conf
  6. In the 10-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/10-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.4.

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

Installing on a RHEL 8 system with an IBM HTTP Server

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

  1. Go to the pingaccess-agent-apache24-rhel8-<version>/<arch>/ directory.
    Note:

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

    cd pingaccess-agent-apache24-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.

    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 10-paa.conf file to the Apache configuration directory: 
    cp -av etc/httpd/conf.modules.d/10-paa.conf $IHS/conf
  6. In the 10-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/10-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.4.

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

Installing on a RHEL 9 system with an IBM HTTP Server

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

  1. Go to the pingaccess-agent-apache24-rhel9-<version>/<arch>/ directory.
    Note:

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

    cd pingaccess-agent-apache24-rhel9-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 9 (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 10-paa.conf file to the Apache configuration directory: 
    cp -av ../10-paa.conf $IHS/conf
  6. In the 10-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/10-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.4.

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