change-master-broker

changes the master broker in a Message Queue cluster providing JMS services for a GlassFish Server cluster.

Synopsis

change-master-broker [--help]
clustered-instance-name

Description

The change-master-broker subcommand changes the master broker in a Message Queue cluster that is the JMS provider for a GlassFish Server cluster. By default, the master broker is the one associated with the first instance configured in the GlassFish Server cluster.

This subcommand is supported in remote mode only. Remote asadmin subcommands require a running domain administration server (DAS).

Options

--help
-?: Displays the help text for the subcommand.

Operands

clustered-instance-name: The name of the server instance whose Message Queue broker is to become the master broker of the Message Queue cluster. This server instance must be an instance in a GlassFish Server cluster.

Examples

Example 1 Changing the master broker

The following subcommand changes the Message Queue master broker to the one for the clustinst3 clustered instance.

asadmin> change-master-broker clustinst3
Command change-master-broker executed successfully.

Exit Status

0: subcommand executed successfully
1: error in executing the subcommand