Stopping the PATROL Agent on UNIX

You can create a script to automatically stop the agent during a normal shutdown procedure. However, you do not want to perform an absolute stop (kill -9) because it forces the agent to quit before it can properly close its open files.

The following section lists three methods to stop the PATROL Agent. They are not necessarily robust or complete solutions for every environment.


Stopping the PATROL Agent for UNIX with a script

This section explains how to use command line script to stop the PATROL Agent on a UNIX host. 

You can use the PATROL Agent process ID to stop the agent. Create a script that resembles the following example:

# run this script as root to avoid permission problems
# get the process ID for the PatrolAgent process
pid=`ps -ef | grep -v grep | grep PatrolAgent | awk '{print $2}'`
# kill the agent
kill $pid
# allow agent to shutdown before OS removes resources
sleep 2 

Note

The short sleep command gives the agent time to close its files and child processes before the operating system starts to remove resources as part of its normal shutdown procedure. Experiment with your sleep interval. It will vary based on hardware, processes running external to PATROL, number of applications, instances, and parameters running, and other environmental factors.

Stopping the PATROL Agent for UNIX with a configuration utility script

This section explains how to use a script to call the PATROL configuration utility, pconfig, which will stop the PATROL Agent on a UNIX host. 

You can use the PATROL utility, pconfig, to stop the agent. Create a shell script that resembles the following example:

# change to the PATROL installation directory
cd /OPT/PATROL/PATROL3
# run the script to setup your environment. This syntax assumes sh or ksh. For csh, use "source ./.patrolrc"
. ./patrolrc.sh
# change to the binary directory
cd $<PATROL_HOME>/bin
# execute pconfig to kill the agent
./pconfig +KILL +verbose -port <portnumber> -host <hostname>
# allow agent to shutdown before OS removes resources
sleep 2

Note

The short sleep command gives the agent time to close up its files and shutdown its child processes before the operating system starts to remove resources as part of its normal shutdown procedure. Experiment with your sleep interval. It will vary based on hardware, processes running external to PATROL, number of applications, instances, and parameters running, and other environmental factors.

Stopping the PATROL Agent for UNIX from the command prompt

You can run the following command to stop the PATROL Agent running on Unix operating system: 

./S50PatrolAgent stop

Note

S50PatrolAgent is the name of the PATROL Agent service.

Was this page helpful? Yes No Submitting... Thank you

Comments