| 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)] |
| |
| |