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:
-
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-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 theyum 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
-
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/
-
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
paa.conf
file to the Apache configuration directory:cp -av ../../paa.conf $IHS/conf
-
In the
paa.conf
file:-
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
-
Update the values for
PaaPropertyFiles
andPaaCertificateDir
to point to your Apacheconf
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/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.2.
-
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
-
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/
-
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.Example:
For RedHat Enterprise Linux 8 (x86_64):
cp -av usr/lib64/.so $IHS/modules
-
Copy
mod_paa.so
into the Apache modules directory:cp -av usr/lib64/httpd/modules/mod_paa.so $IHS/modules
-
Copy the
paa.conf
file to the Apache configuration directory:cp -av etc/httpd/conf.d/paa.conf $IHS/conf
-
In the
paa.conf
file:-
Add the following lines before the
LoadModule
directive:LoadFile modules/libpgm-5.2.so.0 LoadFile modules/libzmq.so.5
-
Update the values for
PaaPropertyFiles
andPaaCertificateDir
to point to your Apacheconf
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/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.2.
-
Restart the Apache service by running the
apachectl restart
command.