This document describes the Adminstration Service and its command-line interface.
The administration service monitors and controls all local brokers; remote
brokers can also be monitored. The administration service is addressed via the
System Management Hub or the administration service command-line utility
etbsrv. To run the commands from utility
etbsrv, System Management Hub is not required. This feature
was designed to be used in a clustering environment, but can also be used in a
standard environment.
Use command BROKER START to start a specified broker:
etbsrv BROKER START "ETB001"
Use command BROKER PING to display the status of a specified local or remote broker.
Return code 0 means the broker is running; any other value means the broker has stopped. See Component Return Codes in EntireX.
Example:
BROKER PING "ETB001"
Enter the command without specifying a broker to display the status of all brokers.
The information is the same as displayed using System Management Hub.
Use command BROKER PINGRPC <brokerid> <class/server/service> to display the status of a
specified RPC server.
Return code 0 means the RPC server is running; any other value means the RPC server has stopped. See Component Return Codes in EntireX.
Example:
BROKER PINGRPC "ETB001" "SAG/ETBCIS/RPCCIS"
The information is the same as displayed using System Management Hub.
Use command BROKER RESTART to stop and restart a specified broker. Example:
BROKER RESTART "ETB001"
Use command BROKER STOP to stop a local broker. Example:
etbsrv BROKER STOP "ETB001"
Activate security with command etbsrv SECURITY ENABLE; once activated, security can only be deactivated with command
SECURITY DISABLE.
To enable automatic scripts to execute administration service commands without having to enter a password,
set the option TRUSTED-USER=YES when administration service security is activated.
etbsrv SECURITY ENABLE TRUSTED-USER=YES
Disable security with command etbsrv SECURITY DISABLE.
