Broker 10.5 | webMethods Broker Documentation | Administering webMethods Broker | webMethods Broker Command-Line Utilities | Broker Utilities | broker_stop
 
broker_stop
The broker_stop utility stops a specified Broker Server.
To use this utility, the Broker Monitor must be running on the machine where the Broker Server resides. This utility waits up to 20 seconds for the Broker Server to stop. When the Broker Server takes more than a second to stop, you get a status update on the command line. For information about stopping a Broker Server, see Stopping Broker Server .
Syntax
broker_stop [-h] [-idhelp] [-y] [server[:port]] [-monitor_port port]
[id_options] [-timeout timeout]
Argument
Description
-h
Displays a usage message.
-idhelp
Displays a usage message for the [id_options] listed below.
-y
Does not prompt for confirmation before stopping the Broker Server.
server[:port]
Specifies the address of the Broker Server you want to stop. If you omit the Broker Server name, the Broker Server on the localhost is assumed. If you omit the port number, the default port 6849 is assumed.
[-monitor_port port]
Specifies the port number you want to use for the Broker Monitor port. You must specify the port number when you have Broker Monitor running on a non-default port (that is, a port other than 6850) or when multiple Broker Monitors are running on the same machine. If you do not specify a port number, the default Broker Monitor port, 6850, is assumed.
[id_options]
Provides identification needed for administrative access to the Broker if the Broker is protected by an Access Control List (ACL).
-entrust uses entrust as the SSL provider. Default is JSSE.
-keystore filename specifies the name of the file containing the user SSL certificate.
-password password specifies the password for the keystore file.
-truststore filename specifies the name of the file containing the trusted root of the user SSL certificate.
-noencrypt specifies to not use encryption for the connection. By default, every connection using a certificate is encrypted.
-basicauthuser username specifies the user name for basic authentication. If you specify -basicauthuser, you must also specify -basicauthpassword.
-basicauthpassword password specifies the password for the basic authentication user. If you specify -basicauthpassword, you must also specify -basicauthuser.
[-timeout timeout]
Specifies the maximum time in seconds the "Stopping..." message is displayed at the command prompt. If the broker_stop utility completes before the timeout time elapses, the "Stopped." message is displayed at the command prompt. If the timeout time elapses before the completion of the broker_stop utility, the broker_stop operation continues in the background and returns the command prompt.