PingAccess

Configuring PingAccess to run as a Linux systemv service

About this task

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:

Steps

  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.

    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

Next steps

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

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