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 admin console, go to Applications > Agents.
-
Click the Pencil icon to edit a configured agent.
If you haven’t created an agent yet, learn more about how to do so in Adding 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-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.
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.6.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.