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

# Installing on RHEL 7

Install a PingAccess agent on a RHEL 7 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, see [Agents](../pingaccess_user_interface_reference_guide/pa_agents.html).

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

   |   |                                                                      |
   | - | -------------------------------------------------------------------- |
   |   | The configuration file will be named `<agentname>_agent.properties`. |

## About this task

Click the respective tab for the installation that you want to use.

* Installing on RHEL 7

* Manually Installing on RHEL 7

## Installing on RHEL 7 conventionally

### Before you begin

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

|   |                                                                                                                                                                                                                                                                                      |
| - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|   | Some dependencies might require access to the epel-release repository. To ensure your package manager has access, run the following command:```shell
curl -O https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm && \ rpm -i epel-release-latest-7.noarch.rpm
``` |

|   |                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|   | 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 `libpgm-5_2-0-5.2.122-32.1.x86_64.rpm`, `libsodium18-1.0.11-1.1.x86_64.rpm`, and `libzmq5-4.3.1-23.6.x86_64.rpm` packages.You can install these RPMs using the following command:```
yum install libsodium*rpm libpgm*rpm libzmq*rpm
``` |

### About this task

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

### Steps

1. In RHEL, change to the `pingaccess-agent-apache24-rhel7-<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.service
   ```

## Manually Installing on RHEL 7

### 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 7 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 extract 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 `$APACHE/bin/apachectl restart` command to restart Apache.