pw agent


This command can be used only with the BMC ProactiveNet Integration Service (also called BMC ProactiveNet Agent) on a UNIX-based environment.

Run the following command to view help information associated with BMC ProactiveNet 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 BMC ProactiveNet Agents installed on a system. The command also lists the following:

  • AID (Agent ID) — This is unique to each agent.
  • Owner - Name of the BMC ProactiveNet Agent owner
  • Install Directory — The path of the directory where the BMC ProactiveNet Agent is installed
  • Agent Version — The BMC ProactiveNet 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 BMC ProactiveNet 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.
#

BMC ProactiveNet Agents can be started or stopped by other agents only when BMC ProactiveNet Agents are owned by the same user. For instance, BMC ProactiveNet Agents owned by root user cannot start or stop BMC ProactiveNet Agents owned by other users. Similarly, BMC ProactiveNet Agents owned by other users cannot start or stop BMC ProactiveNet 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 BMC ProactiveNet 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 BMC ProactiveNet Agent (UNIX) processes currently running on the system.

picobject_5.gif

To view the status of all BMC ProactiveNet Agents installed on the system, run the following command:

pw agent status -all

picobject_6.gif

pw agent stop

Run the following command to stop the current agent:

pw agent stop

Run the following command to stop a particular BMC ProactiveNet 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.
#

Note

Failure to complete an orderly reboot might result in two events sharing the same ID.

To reboot BMC ProactiveNet 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 BMC ProactiveNet processes start automatically.

     

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*