---
title: Installing on SLES
description: Install a PingAccess agent on a SUSE Linux Enterprise Server (SLES) system.
component: pingaccess
version: 9.0
page_id: pingaccess:agents_and_integrations:pa_installing_on_sles
canonical_url: https://docs.pingidentity.com/pingaccess/9.0/agents_and_integrations/pa_installing_on_sles.html
revdate: April 18, 2025
section_ids:
  before-you-begin: Before you begin
  steps: Steps
  example: Example:
  example-2: Example:
  example-3: Example:
  choose-from: Choose from:
---

# Installing on SLES

Install a PingAccess agent on a SUSE Linux Enterprise Server (SLES) system.

## Before you begin

This procedure makes the following assumptions:

* The Apache configuration directory is `/etc/apache2/conf.d`

* The Apache modules directory is `/usr/lib64/apache2`

For custom installations:

* Modify the configuration and module paths below as needed.

* Edit the included `paa.conf` file to modify the values for Apache's configuration and module directories.

## Steps

1. Download the `pingaccess-agent-apache<version>.zip` archive from the **Add-ons** tab of the [PingAccess downloads page](https://www.pingidentity.com/en/resources/downloads/pingaccess.html) and extract it.

2. Go to the `pingaccess-agent-apache<version>` directory.

   1. Import the gpg key.

      #### Example:

      ```
      rpm --import https://download.opensuse.org/repositories/network:/messaging:/zeromq:/release-stable/SLE_12_SP4/repodata/repomd.xml.key
      ```

   2. Install the dependencies.

      #### Example:

      ```
      zypper in ./x86_64/lib*.rpm
      ```

3. As root, copy the PingAccess agent for Apache files to the appropriate places.

   #### Example:

   ```
   cp ./x86_64/mod_paa.so /usr/lib64/apache2
   cp paa.conf /etc/apache2/conf.d
   ```

   |   |                                                                                                                                                                                                                                                           |
   | - | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   |   | By default, Apache on SLES will automatically include all `.conf` files contained within `conf.d` using the IncludeOptional directive. If this has been disabled, add the following to Apache's `httpd.conf`.```
   Include /etc/apache2/conf.d/paa.conf
   ``` |

4. In the PingAccess console, go to **Applications > Agents**.

   1. Edit a configured agent.

      |   |                                                                                                                                                            |
      | - | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
      |   | If you haven't created an agent yet, learn more about how to do so in [Adding agents](../pingaccess_user_interface_reference_guide/pa_adding_agents.html). |

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

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

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

6. As root, restart the Apache service using one of the following commands:

   #### Choose from:

   * `rcapache2 restart`

   * `$APACHE_ROOT/bin/apachectl restart`