docs/reference-manual/src/main/jbake/content/change-master-broker.adoc

type=page
status=published
title=change-master-broker
next=change-master-password.html
prev=change-admin-password.html
~~~~~~
change-master-broker
====================

[[change-master-broker-1]][[GSRFM00005]][[change-master-broker]]

change-master-broker
--------------------

changes the master broker in a Message Queue cluster providing JMS
services for a \{product---name} cluster.

[[sthref53]]

Synopsis

[source,oac_no_warn]
----
asadmin [asadmin-options] change-master-broker [--help]
clustered-instance-name
----

[[sthref54]]

Description

The `change-master-broker` subcommand changes the master broker in a
Message Queue cluster that is the JMS provider for a \{product---name}
cluster. By default, the master broker is the one associated with the
first instance configured in the \{product---name} cluster.

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

[[sthref55]]

Options

asadmin-options::
  Options for the `asadmin` utility. For information about these
  options, see the link:asadmin.html#asadmin-1m[`asadmin`(1M)] help page.
`--help`::
`-?`::
  Displays the help text for the subcommand.

[[sthref56]]

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 \{product---name} cluster.

[[sthref57]]

Examples

[[GSRFM449]][[sthref58]]

Example 1   Changing the master broker

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

[source,oac_no_warn]
----
asadmin> change-master-broker clustinst3
Command change-master-broker executed successfully.
----

[[sthref59]]

Exit Status

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

[[sthref60]]

See Also

link:asadmin.html#asadmin-1m[`asadmin`(1M)]