Managing the PingAccess Linux service - PingAccess - 8.1

PingAccess

bundle
pingaccess-81
ft:publication_title
PingAccess
Product_Version_ce
PingAccess 8.1 (Latest)
category
Product
pa-81
pingaccess
ContentType_ce

Configure PingAccess to run as a Linux systemv or systemd service, or remove the PingAccess Linux service.

Configuring PingAccess to run as a Linux systemv or systemd service causes it to start automatically when Linux starts.

Note:

To configure multiple instances of PingAccess as Linux services, see the Linux systemv tab.

Configuring PingAccess to run as a Linux systemv service

Note:

The service script will only start if <JAVA_HOME> and <PA_HOME> are set and if the script can find the PingAccess license file.

To configure multiple instances of PingAccess on a single host as Linux services, make the following modifications to the script for each service:

  • Use a unique script name for each instance.
  • Use a separate directory structure for each instance in the file system.
  • Configure the following settings in the script file for each instance:
Setting Description

<APPNAME>

A unique value for each instance.

<PA_HOME>

The path to the PingAccess instance.

<JAVA_HOME>

The path to the Java installation folder.

<USER>

Optional value for the username used to run the service.

To configure PingAccess to run as a Linux systemv service:

  1. Copy the PingAccess script file from the <PA_HOME>/sbin/linux/pingaccess directory to the /etc/init.d directory.
  2. Optional: Create a new user to run PingAccess.
  3. Create the /var/run/pingaccess directory.
    Note:

    Ensure that the user who will run the service has read and write permissions to the folder.

  4. Edit the /etc/init.d/pingaccess script file and set the values of the following variables at the beginning of the script:
    Variable Description

    export <JAVA_HOME>=

    Specify the Java install folder.

    export <PA_HOME>=

    Specify the PingAccess install folder.

    export USER= (Optional)

    Specify a username to run the service or leave empty for the default.

  5. To register the service, from the /etc/init.d directory, run:
    chkconfig --add pingaccess
  6. To make the service script executable, run:
    chmod +x pingaccess

After registering, you can use the service command to control the PingAccess service. The available commands are:

start
Start the PingAccess service.
stop
Stop the PingAccess service.
restart
Restart the PingAccess service.
status
Show the status of the PingAccess service and the service process identifier (PID).
Note:

The service pingaccess status command displays the current status of the running PingAccess service.

Configuring PingAccess to run as a Linux systemd service

Note:

The service script will only start if <JAVA_HOME> and <PA_HOME> are set and if the script can find the PingAccess license file.

To configure PingAccess to run as a Linux systemd service:

  1. Copy the configuration file from the <PA_HOME>/sbin/linux/pingaccess.service directory to the /etc/systemd/system/pingaccess.service directory.
  2. In the pingaccess.service file, replace the following variables:
    • Replace <${PA_HOME}> with the path to the PingAccess instance.
    • Replace <${PA_USER}> with the username used to run the service.
    • Replace <${PA_JAVA_HOME}> with the path to the Java installation folder.
  3. To allow read-write activity on the service, run:
    chmod 644 /etc/systemd/system/pingaccess.service
  4. To load the systemd service, run:
    systemctl daemon-reload
  5. To enable the service, run:
    systemctl enable pingaccess.service
  6. To start the service, run:
    systemctl start pingaccess.service

Removing the PingAccess Linux service

Note:

You must run the following commands as the root user.

To remove the PingAccess service from a Linux system:

  1. To stop the service, run the /etc/init.d/pingaccess stop command.
  2. Run the chkconfig --delete pingaccess command.
  3. Optional: Delete the /etc/init.d/pingaccess script.