---
title: Installing on RHEL 8
description: Install a PingAccess agent on a RHEL 8 system with Apache 2.4, either conventionally or manually.
component: pingaccess
version: 9.0
page_id: pingaccess:agents_and_integrations:pa_r8_installation
canonical_url: https://docs.pingidentity.com/pingaccess/9.0/agents_and_integrations/pa_r8_installation.html
revdate: July 28, 2023
section_ids:
  before-you-begin: Before you begin
  installing-on-rhel-8-conventionally: Installing on RHEL 8 conventionally
  before-you-begin-2: Before you begin
  about-this-task: About this task
  steps: Steps
  manually-installing-on-rhel-8: Manually Installing on RHEL 8
  about-this-task-2: About this task
  steps-2: Steps
---

# Installing on RHEL 8

Install a PingAccess agent on a RHEL 8 system with Apache 2.4, either conventionally or manually.

## Before you begin

If you haven't downloaded an `agent.properties` file, you must first:

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, refer to [Agents](../pingaccess_user_interface_reference_guide/pa_agents.html).

3. In the **Shared Secrets** section, click the **Download** icon to download the configuration.

   |   |                                                                       |
   | - | --------------------------------------------------------------------- |
   |   | The name of the configuration file is `<agentname>_agent.properties`. |

* Installing on RHEL 8

* Manually Installing on RHEL 8

## Installing on RHEL 8 conventionally

### Before you begin

Download and extract the `pingaccess-agent-apache24-rhel8-<version>.zip` archive.

|   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|   | The Agent RPM has required dependencies that might be available through standard repositories. If these dependencies are not available in your Linux version, you can install them using the included `openpgm-5.2.122-21.el8.x86_64.rpm`, `libsodium-1.0.18-2.el8.x86_64.rpm`, `libunwind-1.3.1-3.el8.x86_64.rpm`, and `zeromq-4.3.2-1.el8.x86_64.rpm` packages.You can install these RPMs using the following command:```
yum install libsodium*rpm openpgm*rpm libunwind*rpm zeromq*rpm
``` |

### About this task

To install a PingAccess agent on a RHEL 8 system with Apache 2.4:

### Steps

1. In RHEL, change to the `pingaccess-agent-apache24-rhel8-<version>/x86_64` directory.

2. As root, install the PingAccess Agent for Apache using the following command:

   ```
   yum install pingaccess-agent-apache-*.rpm
   ```

3. Copy the `<agentname>_agent.properties` file to `/etc/httpd/conf.d/agent.properties`.

4. As root, restart the Apache service using the following command:

   ```
   systemctl restart httpd
   ```

## Manually Installing on RHEL 8

### About this task

This procedure assumes that:

* A non-root user is installing the PingAccess Agent for Apache in a custom Apache instance.

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

To manually install the PingAccess Agent for Apache on a RHEL 8 system when Apache is installed in a non-standard way:

### Steps

1. Install the following required dependencies from the RedHat Official Repositories:

   ```
   libcurl.x86_64
   pcre.x86_64
   ```

2. Copy the RPMs from the `.zip` archive into a directory called `pkgroot` and unpack them using the following commands:

   ```
   mkdir pkgroot
   cp *.rpm pkgroot/
   cd pkgroot
   for r in *.rpm; do rpm2cpio $r | cpio -idmv; done
   ```

3. Copy the extracted files to the appropriate places with the following commands:

   ```
   cp etc/httpd/conf.modules.d/10-paa.conf $APACHE/conf
   cp -av usr/lib64/*.so* $APACHE/modules
   cp usr/lib64/httpd/modules/*.so $APACHE/modules
   ```

4. Add the following directive to the Apache configuration file (`$APACHE/conf/httpd.conf`) to include the PingAccess Agent for Apache module configuration:

   ```
   Include conf/10-paa.conf
   ```

5. Edit the `10-paa.conf` file and make the following changes:

   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. Change all occurrences of `conf.d` to `conf`.

6. Copy your downloaded `<hostname>_agent.properties` to `$APACHE/conf/agent.properties`.

7. Run the command `$APACHE/bin/apachectl restart` to restart Apache.