pw agent

This command can be used only with the Integration Service (also called local agent) on UNIX and Solaris platforms.

Run the following command to view help information associated with local agent:

# ./pw agent
usage:
  pw agent start [-id <agent id>]|stop [-id <agent id>]|status [-all]|list

pw agent list

Run the pw agent list command to view the list of local agents installed on a system. The command also lists the following:

• AID (Agent ID) — This is unique to each agent.
• Owner - Name of the local agent owner
• Install Directory — The path of the directory where the local agent is installed
• Agent Version — The local agent version
• Port — The port number on which the agent runs
• Status — Indicates whether the agent is running or not

pw agent start

Run the following command to start the current agent:

pw agent start

Run the following command to start a particular agent installed on a system:

pw agent start -id <Agent ID>


To obtain the agent ID, run the pw agent list command.

If the agent is already running, this command stops and then starts the local agent (UNIX) process.

# ./pw agent start -id 0
Starting Proactive Agent ...
done.
# ./pw agent start -id 6
Stopping Proactive Agent ... done.
Starting Proactive Agent ...
done.
#

local agents can be started or stopped by other agents only when local agents are owned by the same user. For instance, local agents owned by root user cannot start or stop local agents owned by other users. Similarly, local agents owned by other users cannot start or stop local agents owned by root user.

# ./pw agent start -id 15
Cannot start agent owned by different user.
#

pw agent status

Run the following command to view the status of the local agent on which you are running the command:

pw agent status

The command indicates whether the agent is running. If it is, then the output of the command displays the number of local agent (UNIX) processes currently running on the system.

To view the status of all local agents installed on the system, run the following command:

pw agent status -all

pw agent stop

Run the following command to stop the current agent:

pw agent stop

Run the following command to stop a particular local agent on a system:

pw agent stop -id <Agent ID>


To obtain the agent ID, run the pw agent list command.

# ./pw agent stop -id 6
Stopping Proactive Agent ... done.
#

To reboot local agent (UNIX)

1. Enter the following command:

   pw agent stop -id [Agent ID]

   A message displays that processes are being halted.

2. Continue to shut down the UNIX server by using standard UNIX commands.

3. Reboot the UNIX server. On reboot, all Infrastructure Management processes start automatically.