usr/src/man/man7d/mediator.7d

   1 '\" te
   2 .\" Copyright (c) 2008, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH MEDIATOR 7D "Jun 20, 2008"
   7 .SH NAME
   8 mediator \- support for HA configurations consisting of two strings of drives
   9 .SH DESCRIPTION
  10 .sp
  11 .LP
  12 Beginning with a prior version, Solaris Volume Manager provided support for
  13 high-availability (HA) configurations consisting of two hosts that share at
  14 least three strings of drives and that run software enabling exclusive access
  15 to the data on those drives from one host. (Note:  Volume Manager, by itself,
  16 does not actually provide a high-availability environment. The diskset feature
  17 is an enabler for HA configurations.)
  18 .sp
  19 .LP
  20 Volume Manager provides support for a low-end HA solution consisting of two
  21 hosts that share only two strings of drives. The hosts in this type of
  22 configuration, referred to as \fImediators\fR, run a special daemon,
  23 \fBrpc.metamedd\fR(1M). The mediator hosts take on additional responsibilities
  24 to ensure that data is available in the case of host or drive failures.
  25 .sp
  26 .LP
  27 In a mediator configuration, two hosts are physically connected to two strings
  28 of drives. This configuration can survive the failure of a single host or a
  29 single string of drives, without administrative intervention. If both a host
  30 and a string of drives fail (multiple failures), the integrity of the data
  31 cannot be guaranteed. At this point, administrative intervention is required to
  32 make the data accessible.
  33 .sp
  34 .LP
  35 The following definitions pertain to a mediator configuration:
  36 .sp
  37 .ne 2
  38 .na
  39 \fB\fBdiskset\fR\fR
  40 .ad
  41 .sp .6
  42 .RS 4n
  43 A set of drives containing metadevices and hot spares that can be shared
  44 exclusively (but not concurrently) by two hosts.
  45 .RE
  46
  47 .sp
  48 .ne 2
  49 .na
  50 \fB\fBVolume Manager\fR \fBstate\fR \fBdatabase\fR\fR
  51 .ad
  52 .sp .6
  53 .RS 4n
  54 A replicated database that stores metadevice configuration and state
  55 information.
  56 .RE
  57
  58 .sp
  59 .ne 2
  60 .na
  61 \fB\fBmediator\fR \fBhost\fR\fR
  62 .ad
  63 .sp .6
  64 .RS 4n
  65 A host that runs the \fBrpc.metamedd(1M)\fR daemon and that has been added to a
  66 diskset. The mediator host participates in checking the state database and the
  67 mediator quorum.
  68 .RE
  69
  70 .sp
  71 .ne 2
  72 .na
  73 \fB\fBmediator\fR \fBquorum\fR\fR
  74 .ad
  75 .sp .6
  76 .RS 4n
  77 The condition achieved when the number of accessible mediator hosts is equal to
  78 half+1 the total number of configured mediator hosts. Because it is expected
  79 that there will be two mediator hosts, this number will normally be 2 ([(2/2) +
  80 1] = 2.)
  81 .RE
  82
  83 .sp
  84 .ne 2
  85 .na
  86 \fB\fBreplica\fR\fR
  87 .ad
  88 .sp .6
  89 .RS 4n
  90 A single copy of the Volume Manager metadevice state database.
  91 .RE
  92
  93 .sp
  94 .ne 2
  95 .na
  96 \fB\fBreplica\fR \fBquorum\fR\fR
  97 .ad
  98 .sp .6
  99 .RS 4n
 100 The condition achieved when the number of accessible replicas is equal to
 101 half+1 the total number of configured replicas. For example, if a system is
 102 configured with ten replicas, the quorum is met when six are accessible
 103 ([(10/2) + 1 = 6]).
 104 .RE
 105
 106 .sp
 107 .LP
 108 A mediator host running the \fBrpc.metamedd(1M)\fR daemon keeps track of
 109 replica updates. As long as the following conditions are met, access to data
 110 occurs without any administrative intervention:
 111 .RS +4
 112 .TP
 113 .ie t \(bu
 114 .el o
 115 The replica quorum is not met.
 116 .RE
 117 .RS +4
 118 .TP
 119 .ie t \(bu
 120 .el o
 121 Half of the replicas are still accessible.
 122 .RE
 123 .RS +4
 124 .TP
 125 .ie t \(bu
 126 .el o
 127 The mediator quorum is met.
 128 .RE
 129 .sp
 130 .LP
 131 The following conditions describe the operation of mediator hosts:
 132 .RS +4
 133 .TP
 134 1.
 135 If the  is met, access to the diskset is granted. At this point no mediator
 136 host is involved.
 137 .RE
 138 .RS +4
 139 .TP
 140 2.
 141 If the replica quorum is not met, half of the replicas are accessible, the
 142 mediator quorum is met, and the replica and mediator data match, access to the
 143 diskset is granted. The mediator host contributes the deciding vote.
 144 .RE
 145 .RS +4
 146 .TP
 147 3.
 148 If the replica quorum is not met, half of the replicas are accessible, the
 149 mediator quorum is not met, half of the mediator hosts  is accessible, and the
 150 replica and mediator data match, the system prompts you to grant or deny access
 151 to the diskset.
 152 .RE
 153 .RS +4
 154 .TP
 155 4.
 156 If the replica quorum is not met, half of the replicas are accessible, the
 157 mediator quorum is met, and the replica and mediator data do not match, access
 158 to the diskset is read-only. You can delete replicas, release the diskset, and
 159 retake the diskset to gain read-write access to the data in the diskset.
 160 .RE
 161 .RS +4
 162 .TP
 163 5.
 164 In all other cases, the diskset access is read-only. You can delete
 165 replicas, release the diskset, and retake the diskset to gain read-write access
 166 to the data in the diskset.
 167 .RE
 168 .sp
 169 .LP
 170 The \fBmetaset\fR(1M) command administers disksets and mediator hosts. The
 171 following options to the \fBmetaset\fR command pertain only to administering
 172 mediator hosts.
 173 .sp
 174 .ne 2
 175 .na
 176 \fB\fB-a\fR \fB-m\fR \fB\fImediator_host_list\fR\fR\fR
 177 .ad
 178 .RS 28n
 179 Adds mediator hosts to the named set.  A \fImediator_host_list\fR is the
 180 nodename of the mediator host to be added and up to 2 other aliases for the
 181 mediator host. The nodename and aliases for each mediator host are separated by
 182 commas. Up to 3 mediator hosts can be specified for the named diskset.
 183 .RE
 184
 185 .sp
 186 .ne 2
 187 .na
 188 \fB\fB-d\fR \fB-m\fR \fB\fImediator_host_list\fR\fR\fR
 189 .ad
 190 .RS 28n
 191 Deletes mediator hosts from the named diskset. Mediator hosts are deleted from
 192 the diskset by specifying the nodename of mediator host to delete.
 193 .RE
 194
 195 .sp
 196 .ne 2
 197 .na
 198 \fB\fB-q\fR\fR
 199 .ad
 200 .RS 28n
 201 Displays an enumerated list of tags pertaining to ``tagged data'' that may be
 202 encountered during a take of the ownership of a diskset.
 203 .RE
 204
 205 .sp
 206 .ne 2
 207 .na
 208 \fB\fB-t\fR [\fB-f\fR] \fB-y\fR\fR
 209 .ad
 210 .RS 28n
 211 Takes ownership of a diskset safely, unless \fB-f\fR is used, in which case the
 212 take is unconditional. If \fBmetaset\fR finds that another host owns the set,
 213 this host will not be allowed to take ownership of the set. If the set is not
 214 owned by any other host, all the disks  within the set will be owned by the
 215 host on which \fBmetaset\fR  was executed. The metadevice state database is
 216 read in and the shared metadevices contained in the set become accessible. The
 217 \fB-t\fR option will take a diskset that has stale databases. When the
 218 databases are stale, \fBmetaset\fR will exit with code 66, and a message will
 219 be printed. At that point, the only operations permitted are the addition and
 220 deletion of replicas. Once the addition or deletion of the replicas has been
 221 completed, the diskset should be released and retaken to gain full access to
 222 the data. If mediator hosts have been configured, some additional exit codes
 223 are  possible. If half of the replicas and half of the mediator hosts are
 224 operating properly, the take will exit with code 3. At this point, you can add
 225 or delete replicas, or use the \fB-y\fR option on a subsequent take. If the
 226 take operation encounters ``tagged data,'' the take operation will exit with
 227 code 2. You can then run the \fBmetaset\fR command with the  \fB-q\fR option to
 228 see an enumerated list of tags.
 229 .RE
 230
 231 .sp
 232 .ne 2
 233 .na
 234 \fB\fB-t\fR [\fB-f\fR] \fB-u\fR \fItagnumber\fR\fR
 235 .ad
 236 .RS 28n
 237 Once a tag has been selected, a subsequent take with  \fB-u\fR
 238 \fB\fItagnumber\fR\fR can be executed to select the data associated with the
 239 given \fItagnumber\fR.
 240 .RE
 241
 242 .SH SEE ALSO
 243 .sp
 244 .LP
 245 \fBmetaset\fR(1M), \fBmd\fR(7D), \fBrpc.metamedd\fR(1M), \fBrpc.metad\fR(1M)
 246 .sp
 247 .LP
 248 Sun Cluster documentation, \fISolaris Volume Manager Administration Guide\fR
 249 .SH NOTES
 250 .sp
 251 .LP
 252 Diskset administration, including the addition and deletion of hosts  and
 253 drives, requires all hosts in the set to be accessible from the network.