SET MASTEROBSERVERHOSTS

The SET MASTEROBSERVERHOSTS command sets the master observer of a broker configuration to the observer on the target host.

For each broker configuration in a specified group, if it has a backup observer running on the target host, then set the master observer of this broker configuration to the observer on the target host.

Format

SET MASTEROBSERVERHOSTS {FOR <configuration_group_name>} TO host_name;

Command Parameters

configuration_group_name
The name of a broker configuration group, on which you want to move the master observer to the target host.
host_name
The target host to which you want to move the master observer for the broker configurations in the specified group.

Usage Notes

  • If noconfiguration_group_name command parameter is specified, then this command attempts to switch the master observer to the specified host for all broker configurations defined in the observer configuration file.

  • The configuration_group_name cannot be the keyword ALL.

  • The actual switch does not happen until the next time the primary contacts the target standby in each broker configuration, usually within three seconds if fast-start failover is enabled. You should use the SHOW OBSERVERS command to verify that the switch took place.

  • Information about the DGMGRL commands run and execution details are written to the log file, superobserver.log. This file is located in the $DG_ADMIN/admin/ directory. If the DG_ADMIN environment variable is not defined, this file is located in the current working directory.

Command Example

DGMGRL> SET MASTEROBSERVERHOSTS FOR GRP_A TO dgnet0;