Administration Service Commands

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.

Starting a Broker

Use command BROKER START to start a specified broker: 

etbsrv BROKER START "ETB001"

Pinging a Broker

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.

Pinging an RPC Server

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.

Restarting a Broker

Use command BROKER RESTART to stop and restart a specified broker. Example: 

BROKER RESTART "ETB001"

Stopping a Broker

Use command BROKER STOP to stop a local broker. Example: 

etbsrv BROKER STOP "ETB001"

Enabling EntireX Security

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

Disabling EntireX Security

Disable security with command etbsrv SECURITY DISABLE.