---
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: 8.2
page_id: pingaccess:agents_and_integrations:pa_r8_installation
canonical_url: https://docs.pingidentity.com/pingaccess/9.1/agents_and_integrations/pa_r8_installation.html
llms_txt: https://docs.pingidentity.com/pingaccess/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: July 28, 2023
superseded_by: https://docs.pingidentity.com/pingaccess/9.1/agents_and_integrations/pa_r8_installation.html
section_ids:
  before-you-begin: Before you begin
  installing-rhel8: Installing on RHEL 8 conventionally
  steps: Steps
  manually-installing-rhel8: Manually Installing on RHEL 8
  about-this-task: 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

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 packages:- `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`

- `zeromq-4.3.2-1.el8.x86_64.rpm`You can install these RPMs using `yum install libsodium*rpm openpgm*rpm libunwind*rpm zeromq*rpm`. |

### 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. As root, restart the Apache service using the following command:

   ```
   systemctl restart httpd
   ```