PingAccess

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 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.

    2. In the shared secret, 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