Installing on an IBM HTTP Server using Apache 2.4

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

Before you begin

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

In the PingAccess console, go to Applications → Agents.
Click the pencil icon () to edit a configured agent.

If you haven’t created an agent yet, see Agents.
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-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.

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

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

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
```
Copy mod_paa.so into the Apache modules directory:
```
cp -av ../mod_paa.so $IHS/modules
```
Copy the 10-paa.conf file to the Apache configuration directory:
```
cp -av ../../10-paa.conf $IHS/conf
```
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.
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
```
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.
Restart the Apache service by running the apachectl restart command.

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

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

Copy mod_paa.so into the Apache modules directory:

cp -av usr/lib64/httpd/modules/mod_paa.so $IHS/modules

Copy the 10-paa.conf file to the Apache configuration directory:
```
cp -av etc/httpd/conf.modules.d/10-paa.conf $IHS/conf
```
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.
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
```
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.
Restart the Apache service by running the apachectl restart command.

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

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

Copy mod_paa.so into the Apache modules directory:

cp -av usr/lib64/httpd/modules/mod_paa.so $IHS/modules

Copy the 10-paa.conf file to the Apache configuration directory:
```
cp -av ../10-paa.conf $IHS/conf
```
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.
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
```
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.
Restart the Apache service by running the apachectl restart command.