A mediator, or mediator host, is a cluster node that stores mediator data. Mediator data provides information on the location of other mediators and contains a commit count that is identical to the commit count stored in the database replicas. This commit count is used to confirm that the mediator data is in sync with the data in the database replicas.
Mediators are required for all Solstice DiskSuite/Solaris Volume Manager disksets that are configured with exactly two disk strings and two cluster nodes. A disk string consists of a disk enclosure, its physical disk drives, cables from the enclosure to the node(s), and the interface adapter cards. The use of mediators enables the Sun Cluster software to ensure that the most current data is presented in the instance of a single-string failure in a dual-string configuration. The following rules apply to dual-string configurations that use mediators.
Disksets must be configured with exactly two mediator hosts. Those two mediator hosts must be the same two cluster nodes that are used for the diskset.
A diskset cannot have more than two mediator hosts.
Mediators cannot be configured for disksets that do not meet the two-string and two-host criteria.
These rules do not require that the entire cluster must have exactly two nodes. Rather, only those disksets that have two disk strings must be connected to exactly two nodes. An N+1 cluster and many other topologies are permitted under these rules.
This section contains the following procedures:
Perform this procedure if your configuration requires mediators.
Become superuser on the node that currently masters the diskset to which you intend to add mediator hosts.
Run the metaset(1M) command to add each node with connectivity to the diskset as a mediator host for that diskset.
# metaset -s setname -a -m mediator-host-list |
Specifies the diskset name
Adds to the diskset
Specifies the name of the node to add as a mediator host for the diskset
See the mediator(7D) man page for details about mediator-specific options to the metaset command.
Check the status of mediator data.
The following example adds the nodes phys-schost-1 and phys-schost-2 as mediator hosts for the diskset dg-schost-1. Both commands are run from the node phys-schost-1.
# metaset -s dg-schost-1 -a -m phys-schost-1 # metaset -s dg-schost-1 -a -m phys-schost-2 |
Add mediator hosts as described in How to Add Mediator Hosts.
Run the medstat command.
# medstat -s setname |
Specifies the diskset name
See the medstat(1M) man page for more information.
Is Bad the value in the Status field?
If yes, go to How to Fix Bad Mediator Data to repair the affected mediator host.
If no, go to How to Add Cluster File Systems to create a cluster file system.
Perform this procedure to repair bad mediator data.
Identify the mediator host(s) with bad mediator data as described in the procedure How to Check the Status of Mediator Data.
Become superuser on the node that owns the affected diskset.
Remove the mediator host(s) with bad mediator data from all affected disksets.
# metaset -s setname -d -m mediator-host-list |
Specifies the diskset name
Deletes from the diskset
Specifies the name of the node to remove as a mediator host for the diskset
Restore the mediator host.
# metaset -s setname -a -m mediator-host-list |
Adds to the diskset
Specifies the name of the node to add as a mediator host for the diskset
See the mediator(7D) man page for details about mediator-specific options to the metaset command.
Create cluster file systems.