BrokerControl

Overview

The Unified Assurance Broker Control Utility* interfaces with the Unified Assurance Broker Daemon/Service to send control signals for services and jobs on the various Unified Assurance servers. It can also be used to view configuration files and logs on the Unified Assurance servers. For administration, it is recommended that you use the standard web interface to perform actions rather than the command-line utility.

Administration Details

The following list shows the technical details you will need for advanced administration of the application:

• Interactive - ./BrokerControl

• Batch Mode to return debug information - ./BrokerControl --batch debug

• Package - assure1-app

• Synopsis - ./BrokerControl [OPTIONS]

• Options:

  • --Batch, -b COMMAND Batch mode (if supplied multiple times, commands will each be run in the order they were specified)

  • --Mode, -m MODE Change the message transport mode to soap for direct communication (defaults to amqp)

  • --Server, -s SERVER Specify the broker to make initial connection to (localhost by default)

  • --Show-Response Always display raw contents of broker's response

  • --Log Optionally log request and output to $A1BASEDIR/logs/BrokerControl.log (defaults to off)

  • -?, -h, --Help Print usage and exit

• Commands:

  • server <name|ip> Change to another Broker service

  • ping [BROKER] Ping the Broker for a basic response

  • listservices List all services and their states

  • listjobs List all jobs and their states

  • listall List all services and jobs

  • listservice <id> List service details specified by ID

  • listjob <id> List job details specified by ID

  • reloadappconfig <id> Reload application configuration of running service specified by ID

  • startall Start all processes

  • stopall Stop all processes

  • startservice <id> Start service specified by ID

  • stopservice <id> Stop service specified by ID

  • startjob <id> Start job specified by ID

  • disablepackage <package> Stop all apps in a package and prevent them from running in the future.

  • enablepackage <package> Allow apps in package to be run again

  • runjob <name> <args> Run an on-demand job

  • reload Reload all processes from database

  • readconfig Show the Assure1.conf file

  • debug [<path.to.node>] Dump Broker object information

  • exit|quit Exit Broker Control (interactive mode only)