usr/src/man/man1m/metaset.1m

   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. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
   4 .\" See the License for the specific language governing permissions and limitations under the License. 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
   5 .\" fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH METASET 1M "Mar 4, 2009"
   7 .SH NAME
   8 metaset \- configure disk sets
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/sbin/metaset\fR \fB-s\fR \fIsetname\fR [\fB-M\fR\fB-a\fR \fB-h\fR \fIhostname\fR]
  13 .fi
  14
  15 .LP
  16 .nf
  17 \fB/usr/sbin/metaset\fR \fB-s\fR \fIsetname\fR \fB-A\fR {enable | disable}
  18 .fi
  19
  20 .LP
  21 .nf
  22 \fB/usr/sbin/metaset\fR \fB-s\fR \fIsetname\fR [\fB-A\fR {enable | disable}] \fB-a\fR \fB-h\fR \fIhostname\fR...
  23 .fi
  24
  25 .LP
  26 .nf
  27 \fB/usr/sbin/metaset\fR \fB-s\fR \fIsetname\fR \fB-a\fR [\fB-l\fR \fIlength\fR] [\fB-L\fR] \fIdrivename...\fR
  28 .fi
  29
  30 .LP
  31 .nf
  32 \fB/usr/sbin/metaset\fR \fB-s\fR \fIsetname\fR \fB-C\fR {take | release | purge}
  33 .fi
  34
  35 .LP
  36 .nf
  37 \fB/usr/sbin/metaset\fR \fB-s\fR \fIsetname\fR \fB-d\fR [\fB-f\fR] \fB-h\fR \fIhostname...\fR
  38 .fi
  39
  40 .LP
  41 .nf
  42 \fB/usr/sbin/metaset\fR \fB-s\fR \fIsetname\fR \fB-d\fR [\fB-f\fR] \fIdrivename...\fR
  43 .fi
  44
  45 .LP
  46 .nf
  47 \fB/usr/sbin/metaset\fR \fB-s\fR \fIsetname\fR \fB-j\fR
  48 .fi
  49
  50 .LP
  51 .nf
  52 \fB/usr/sbin/metaset\fR \fB-s\fR \fIsetname\fR \fB-r\fR
  53 .fi
  54
  55 .LP
  56 .nf
  57 \fB/usr/sbin/metaset\fR \fB-s\fR \fIsetname\fR \fB-w\fR
  58 .fi
  59
  60 .LP
  61 .nf
  62 \fB/usr/sbin/metaset\fR \fB-s\fR \fIsetname\fR \fB-t\fR [\fB-f\fR] [\fB-u\fR \fItagnumber\fR] [y]
  63 .fi
  64
  65 .LP
  66 .nf
  67 \fB/usr/sbin/metaset\fR \fB-s\fR \fIsetname\fR \fB-b\fR
  68 .fi
  69
  70 .LP
  71 .nf
  72 \fB/usr/sbin/metaset\fR \fB-s\fR \fIsetname\fR \fB-P\fR
  73 .fi
  74
  75 .LP
  76 .nf
  77 \fB/usr/sbin/metaset\fR \fB-s\fR \fIsetname\fR \fB-q\fR
  78 .fi
  79
  80 .LP
  81 .nf
  82 \fB/usr/sbin/metaset\fR \fB-s\fR \fIsetname\fR \fB-o\fR [\fB-h\fR \fIhostname\fR]
  83 .fi
  84
  85 .LP
  86 .nf
  87 \fB/usr/sbin/metaset\fR [\fB-s\fR \fIsetname\fR]
  88 .fi
  89
  90 .LP
  91 .nf
  92 \fB/usr/sbin/metaset\fR [\fB-s\fR \fIsetname\fR] \fB-a\fR | \fB-d\fR
  93      [ [m] \fImediator_host_list\fR]
  94 .fi
  95
  96 .SH DESCRIPTION
  97 .sp
  98 .LP
  99 The \fBmetaset\fR command administers sets of disks in named disk sets. Named
 100 disk sets include any disk set that is not in the local set. While disk sets
 101 enable a high-availability configuration, Solaris Volume Manager itself does
 102 not actually provide a high-availability environment.
 103 .sp
 104 .LP
 105 A single-owner disk set configuration manages storage on a SAN or
 106 fabric-attached storage, or provides namespace control and state database
 107 replica management for a specified set of disks.
 108 .sp
 109 .LP
 110 In a shared disk set configuration, multiple hosts are physically connected to
 111 the same set of disks. When one host fails, another host has exclusive access
 112 to the disks. Each host can control a shared disk set, but only one host can
 113 control it at a time.
 114 .sp
 115 .LP
 116 When you add a new disk to any disk set, Solaris Volume Manager checks the disk
 117 format. If necessary, it repartitions the disk to ensure that the disk has an
 118 appropriately configured reserved slice 7 (or slice 6 on an EFI labelled
 119 device) with adequate space for a state database replica. The precise size of
 120 slice 7 (or slice 6 on an EFI labelled device) depends on the disk geometry.
 121 For tradtional disk sets, the slice is no less than 4 Mbytes, and probably
 122 closer to 6 Mbytes, depending on where the cylinder boundaries lie. For
 123 multi-owner disk sets, the slice is a minimum of 256 Mbytes. The minimal size
 124 for slice 7 might change in the future. This change is based on a variety of
 125 factors, including the size of the state database replica and information to be
 126 stored in the state database replica.
 127 .sp
 128 .LP
 129 For use in disk sets, disks must have a dedicated slice (six or seven) that
 130 meets specific criteria:
 131 .RS +4
 132 .TP
 133 .ie t \(bu
 134 .el o
 135 The slice must start at sector 0
 136 .RE
 137 .RS +4
 138 .TP
 139 .ie t \(bu
 140 .el o
 141 The slice must include enough space for disk label
 142 .RE
 143 .RS +4
 144 .TP
 145 .ie t \(bu
 146 .el o
 147 The state database replicas cannot be mounted
 148 .RE
 149 .RS +4
 150 .TP
 151 .ie t \(bu
 152 .el o
 153 The slice does not overlap with any other slices, including slice 2
 154 .RE
 155 .sp
 156 .LP
 157 If the existing partition table does not meet these criteria, or if the -L flag
 158 is specified, Solaris Volume Manager repartitions the disk. A small portion of
 159 each drive is reserved in slice 7 (or slice 6 on an EFI labelled device) for
 160 use by Solaris Volume Manager. The remainder of the space on each drive is
 161 placed into slice 0. Any existing data on the disks is lost by repartitioning.
 162 .sp
 163 .LP
 164 After you add a drive to a disk set, it can be repartitioned as necessary, with
 165 the exception that slice 7 (or slice 6 on an EFI labelled device) is not
 166 altered in any way.
 167 .sp
 168 .LP
 169 After a disk set is created and metadevices are set up within the set, the
 170 metadevice name is in the following form:
 171 .sp
 172 .LP
 173 \fB/dev/md/\fR\fIsetname\fR/{\fBdsk\fR,\fBrdsk\fR}/\fBd\fR\fInumber\fR
 174 .sp
 175 .LP
 176 where \fIsetname\fR is the name of the disk set, and \fInumber\fR is the number
 177 of the metadevice (\fB0\fR-\fB127\fR).
 178 .sp
 179 .LP
 180 If you have disk sets that you upgraded from Solstice DiskSuite software, the
 181 default state database replica size on those sets is 1034 blocks, not the 8192
 182 block size from Solaris Volume Manager. Also, slice 7 on the disks that were
 183 added under Solstice DiskSuite are correspondingly smaller than slice 7 on
 184 disks that were added under Solaris Volume Manager.
 185 .sp
 186 .LP
 187 If disks you add to a disk set have acceptable slice 7s (that start at cylinder
 188 0 and that have sufficient space for the state database replica), they are not
 189 reformatted.
 190 .sp
 191 .LP
 192 Hot spare pools within local disk sets use standard Solaris Volume Manager
 193 naming conventions. Hot spare pools with shared disk sets use the following
 194 convention:
 195 .sp
 196 .LP
 197 \fIsetname\fR/\fIhot_spare_pool\fR
 198 .sp
 199 .LP
 200 where \fIsetname\fR is the name of the disk set, and \fIhot_spare_pool\fR is
 201 the name of the hot spare pool associated with the disk set.
 202 .SS "Multi-node Environment"
 203 .sp
 204 .LP
 205 To create and work with a disk set in a multi\(emnode environment, \fBroot\fR
 206 must be a member of Group 14 on all hosts, or the \fB/.rhosts\fR file must
 207 contain an entry for all other host names. This is not required in a SunCluster
 208 3.x enviroment.
 209 .SS "Tagged data"
 210 .sp
 211 .LP
 212 Tagged data occurs when there are different versions of a disk set's replicas.
 213 This tagged data consists of the set owner's nodename, the hardware serial
 214 number of the owner and the time it was written out to the available replicas.
 215 The system administer can use this information to determine which replica
 216 contains the correct data.
 217 .sp
 218 .LP
 219 When a disk set is configured with an even number of storage enclosures and has
 220 replicas balanced across them evenly, it is possible that up to half of the
 221 replicas can be lost (for example, through a power failure of half of the
 222 storage enclosures). After the enclosure that went down is rebooted, half of
 223 the replicas are not recognized by SVM. When the set is retaken, the
 224 \fBmetaset\fR command returns an error of "stale databases", and all of the
 225 metadevices are in a read-only state.
 226 .sp
 227 .LP
 228 Some of the replicas that are not recognized need to be deleted. The action of
 229 deleting the replicas also causes updates to the replicas that are not being
 230 deleted. In a dual hosted disk set environment, the second node can access the
 231 deleted replicas instead of the existing replicas when it takes the set. This
 232 leads to the possibility of getting the wrong replica record on a disk set
 233 take. An error message is displayed, and user intervention is required.
 234 .sp
 235 .LP
 236 Use the \fB-q\fR to query the disk set and the \fB-t\fR, \fB-u\fR, and
 237 \fB-y\fR, options to select the tag and take the disk set. See \fBOPTIONS\fR.
 238 .SS "Mediator Configuration"
 239 .sp
 240 .LP
 241 SVM provides support for a low-end HA solution consisting of two hosts that
 242 share only two strings of drives. The hosts in this type of configuration,
 243 referred to as \fBmediators\fR or mediator hosts, run a special daemon,
 244 \fBrpc.metamedd\fR(1M). The mediator hosts take on additional responsibilities
 245 to ensure that data is available in the case of host or drive failures.
 246 .sp
 247 .LP
 248 A mediator configuration can survive the failure of a single host or a single
 249 string of drives, without administrative intervention. If both a host and a
 250 string of drives fail (multiple failures), the integrity of the data cannot be
 251 guaranteed. At this point, administrative intervention is required to make the
 252 data accessible. See \fBmediator\fR(7D) for further details.
 253 .sp
 254 .LP
 255 Use the \fB-m\fR option to add or delete a mediator host. See \fBOPTIONS\fR.
 256 .SH OPTIONS
 257 .sp
 258 .LP
 259 The following options are supported:
 260 .sp
 261 .ne 2
 262 .na
 263 \fB\fB-a\fR \fIdrivename\fR\fR
 264 .ad
 265 .sp .6
 266 .RS 4n
 267 Add drives or hosts to the named set. For a drive to be accepted into a set,
 268 the drive must not be in use within another metadevice or disk set, mounted on,
 269 or swapped on. When the drive is accepted into the set, it is repartitioned and
 270 the metadevice state database replica (for the set) can be placed on it.
 271 However, if a slice 7 (or slice 6 on an EFI labelled device), starts at
 272 cylinder 0, and is large enough to hold a state database replica, then the disk
 273 is not repartitioned. Also, a drive is not accepted if it cannot be found on
 274 all hosts specified as part of the set. This means that if a host within the
 275 specified set is unreachable due to network problems, or is administratively
 276 down, the add fails.
 277 .sp
 278 Specify a drive name in the form
 279 \fBc\fR\fInum\fR\fBt\fR\fInum\fR\fBd\fR\fInum\fR. Do not specify a slice number
 280 (\fBs\fR\fInum\fR). For drives in a Sun Cluster, you must specify a complete
 281 pathname for each drive. Such a name has the form:
 282 .sp
 283 .in +2
 284 .nf
 285 /dev/did/[r]dsk/d\fInum\fR
 286 .fi
 287 .in -2
 288 .sp
 289
 290 .RE
 291
 292 .sp
 293 .ne 2
 294 .na
 295 \fB\fB-a\fR | \fB-d\fR | \fB-m\fR \fImediator_host_list\fR\fR
 296 .ad
 297 .sp .6
 298 .RS 4n
 299 Add (\fB-a\fR) or delete (\fB-d\fR) mediator hosts to the specified disk set. A
 300 \fImediator_host_list\fR is the \fBnodename\fR(4) of the mediator host to be
 301 added and (for adding) up to two other aliases for the mediator host. The
 302 nodename and aliases for each mediator host are separated only by commas. Up to
 303 three mediator hosts can be specified for the named disk set. Specify only the
 304 nodename of that host as the argument to \fB-m\fR to delete a mediator host.
 305 .sp
 306 In a single \fBmetaset\fR command you can add or delete up to three mediator
 307 hosts. See \fBEXAMPLES\fR.
 308 .RE
 309
 310 .sp
 311 .ne 2
 312 .na
 313 \fB\fB-A\fR \fB{enable | disable}\fR\fR
 314 .ad
 315 .sp .6
 316 .RS 4n
 317 Specify auto-take status for a disk set. If auto-take is enabled for a set, the
 318 disk set is automatically taken at boot, and file systems on volumes within the
 319 disk set can be mounted through \fB/etc/vfstab\fR entries. Only a single host
 320 can be associated with an auto-take set, so attempts to add a second host to an
 321 auto-take set or attempts to configure a disk set with multiple hosts as
 322 auto-take fails with an error message. Disabling auto-take status for a
 323 specific disk set causes the disk set to revert to normal behavior. That is,
 324 the disk set is potentially shared (non-concurrently) among hosts, and
 325 unavailable for mounting through \fB/etc/vfstab\fR.
 326 .RE
 327
 328 .sp
 329 .ne 2
 330 .na
 331 \fB\fB-b\fR\fR
 332 .ad
 333 .sp .6
 334 .RS 4n
 335 Insure that the replicas are distributed according to the replica layout
 336 algorithm. This can be invoked at any time, and does nothing if the replicas
 337 are correctly distributed. In cases where the user has used the \fBmetadb\fR
 338 command to manually remove or add replicas, this command can be used to insure
 339 that the distribution of replicas matches the replica layout algorithm.
 340 .RE
 341
 342 .sp
 343 .ne 2
 344 .na
 345 \fB\fB-C\fR \fB{take | release | purge}\fR\fR
 346 .ad
 347 .sp .6
 348 .RS 4n
 349 Do not interact with the Cluster Framework when used in a Sun Cluster 3
 350 environment. In effect, this means do not modify the Cluster Configuration
 351 Repository. These options should only be used to fix a broken disk set
 352 configuration.
 353 .sp
 354 .ne 2
 355 .na
 356 \fBtake\fR
 357 .ad
 358 .sp .6
 359 .RS 4n
 360 Take ownership of the disk set but do not inform the Cluster Framework that the
 361 disk set is available. This option is not for use with a multi-owner disk set.
 362 .RE
 363
 364 .sp
 365 .ne 2
 366 .na
 367 \fBrelease\fR
 368 .ad
 369 .sp .6
 370 .RS 4n
 371 Release ownership of the disk set without informing the Cluster Framework. This
 372 option should only be used if the disk set ownership was taken with the
 373 corresponding \fB-C\fR \fBtake\fR option. This option is not for use with a
 374 multi-owner disk set.
 375 .RE
 376
 377 .sp
 378 .ne 2
 379 .na
 380 \fBpurge\fR
 381 .ad
 382 .sp .6
 383 .RS 4n
 384 Remove the disk set without informing the Cluster Framework that the disk set
 385 has been purged. This option should only be used when the disk set is not
 386 accessible and requires rebuilding.
 387 .RE
 388
 389 .RE
 390
 391 .sp
 392 .ne 2
 393 .na
 394 \fB\fB-d\fR \fIdrivename\fR\fR
 395 .ad
 396 .sp .6
 397 .RS 4n
 398 Delete drives or hosts from the named disk set. For a drive to be deleted, it
 399 must not be in use within the set. The last host cannot be deleted unless all
 400 of the drives within the set are deleted. Deleting the last host in a disk set
 401 destroys the disk set.
 402 .sp
 403 Specify a drive name in the form
 404 \fBc\fR\fInum\fR\fBt\fR\fInum\fR\fBd\fR\fInum\fR. Do not specify a slice number
 405 (\fBs\fR\fInum\fR). For drives in a Sun Cluster, you must specify a complete
 406 pathname for each drive. Such a name has the form:
 407 .sp
 408 .in +2
 409 .nf
 410 /dev/did/[r]dsk/d\fInum\fR
 411 .fi
 412 .in -2
 413 .sp
 414
 415 This option fails on a multi-owner disk set if attempting to withdraw the
 416 master node while other nodes are in the set.
 417 .RE
 418
 419 .sp
 420 .ne 2
 421 .na
 422 \fB\fB-f\fR\fR
 423 .ad
 424 .sp .6
 425 .RS 4n
 426 Force one of three actions to occur: takes ownership of a disk set when used
 427 with \fB-t\fR; deletes the last disk drive from the disk set; or deletes the
 428 last host from the disk set. Deleting the last drive or host from a disk set
 429 requires the \fB-d\fR option.
 430 .sp
 431 When used to forcibly take ownership of the disk set, this causes the disk set
 432 to be grabbed whether or not another host owns the set. All of the disks within
 433 the set are taken over (reserved) and fail fast is enabled, causing the other
 434 host to panic if it had disk set ownership. The metadevice state database is
 435 read in by the host performing the take, and the shared metadevices contained
 436 in the set are accessible.
 437 .sp
 438 You can use this option to delete the last drive in the disk set, because this
 439 drive would implicitly contain the last state database replica.
 440 .sp
 441 You can use \fB-f\fR option to delete hosts from a set. When specified with a
 442 partial list of hosts, it can be used for one-host administration. One-host
 443 administration could be useful when a host is known to be non-functional, thus
 444 avoiding timeouts and failed commands. When specified with a complete list of
 445 hosts, the set is completely deleted. It is generally specified with a complete
 446 list of hosts to clean up after one-host administration has been performed.
 447 .RE
 448
 449 .sp
 450 .ne 2
 451 .na
 452 \fB\fB-h\fR \fB\fIhostname...\fR\fR\fR
 453 .ad
 454 .sp .6
 455 .RS 4n
 456 Specify one or more host names to be added to or deleted from a disk set.
 457 Adding the first host creates the set. The last host cannot be deleted unless
 458 all of the drives within the set have been deleted. The host name is not
 459 accepted if all of the drives within the set cannot be found on the specified
 460 host. The host name is the same name found in \fB/etc/nodename\fR.
 461 .RE
 462
 463 .sp
 464 .ne 2
 465 .na
 466 \fB\fB-j\fR\fR
 467 .ad
 468 .sp .6
 469 .RS 4n
 470 Join a host to the owner list for a multi-owner disk set. The concepts of take
 471 and release, used with traditional disk sets, do not apply to multi-owner sets,
 472 because multiple owners are allowed.
 473 .sp
 474 As a host boots and is brought online, it must go through three configuration
 475 levels to be able to use a multi-owner disk set:
 476 .RS +4
 477 .TP
 478 1.
 479 It must be included in the cluster nodelist, which happens automatically in
 480 a cluster or single-node sitatuion.
 481 .RE
 482 .RS +4
 483 .TP
 484 2.
 485 It must be added to the multi-owner disk set with the \fB-a\fR \fB-h\fR
 486 options documented elsewhere in this man page
 487 .RE
 488 .RS +4
 489 .TP
 490 3.
 491 It must join the set. When the host is first added to the set, it is
 492 automatically joined.
 493 .RE
 494 On manual restarts, the administrator must manually issue
 495 .sp
 496 .in +2
 497 .nf
 498 metaset \fB-s\fR \fImultinodesetname\fR \fB-j\fR
 499 .fi
 500 .in -2
 501 .sp
 502
 503 to join the host to the owner list. After the cluster reconfiguration, when the
 504 host reenters the cluster, the node is automatically joined to the set. The
 505 \fBmetaset\fR \fB-j\fR command joins the host to all multi-owner sets that the
 506 host has been added to. In a single node situation, joining the node to the
 507 disk set starts any necessary resynchronizations.
 508 .RE
 509
 510 .sp
 511 .ne 2
 512 .na
 513 \fB\fB-L\fR\fR
 514 .ad
 515 .sp .6
 516 .RS 4n
 517 When adding a disk to a disk set, force the disk to be repartitioned using the
 518 standard Solaris Volume Manager algorithm. See \fBDESCRIPTION\fR.
 519 .RE
 520
 521 .sp
 522 .ne 2
 523 .na
 524 \fB\fB-l\fR \fIlength\fR\fR
 525 .ad
 526 .sp .6
 527 .RS 4n
 528 Set the size (in blocks) for the metadevice state database replica. The length
 529 can only be set when adding a new drive; it cannot be changed on an existing
 530 drive. The default (and maximum) size is 8192 blocks, which should be
 531 appropriate for most configurations. Replica sizes of less than 128 blocks are
 532 not recommended.
 533 .RE
 534
 535 .sp
 536 .ne 2
 537 .na
 538 \fB\fB-M\fR\fR
 539 .ad
 540 .sp .6
 541 .RS 4n
 542 Specify that the disk set to be created or modified is a multi-owner disk set
 543 that supports multiple concurrent owners.
 544 .sp
 545 This option is required when creating a multi-owner disk set. Its use is
 546 optional on all other operations on a multi-owner disk set and has no effect.
 547 Existing disk sets cannot be converted to multi-owner sets.
 548 .RE
 549
 550 .sp
 551 .ne 2
 552 .na
 553 \fB\fB-o\fR\fR
 554 .ad
 555 .sp .6
 556 .RS 4n
 557 Return an exit status of \fB0\fR if the local host or the host specified with
 558 the \fB-h\fR option is the owner of the disk set.
 559 .RE
 560
 561 .sp
 562 .ne 2
 563 .na
 564 \fB\fB-P\fR\fR
 565 .ad
 566 .sp .6
 567 .RS 4n
 568 Purge the named disk set from the node on which the \fBmetaset\fR command is
 569 run. The disk set must not be owned by the node that runs this command. If the
 570 node does own the disk set, the command fails.
 571 .sp
 572 If you need to delete a disk set but cannot take ownership of the set, use the
 573 \fB-P\fR option.
 574 .RE
 575
 576 .sp
 577 .ne 2
 578 .na
 579 \fB\fB-q\fR\fR
 580 .ad
 581 .sp .6
 582 .RS 4n
 583 Displays an enumerated list of tags pertaining to ``tagged data'' that can be
 584 encountered during a take of the ownership of a disk set.
 585 .sp
 586 This option is not for use with a multi-owner disk set.
 587 .RE
 588
 589 .sp
 590 .ne 2
 591 .na
 592 \fB\fB-r\fR\fR
 593 .ad
 594 .sp .6
 595 .RS 4n
 596 Release ownership of a disk set. All of the disks within the set are released.
 597 The metadevices set up within the set are no longer accessible.
 598 .sp
 599 This option is not for use with a multi-owner disk set.
 600 .RE
 601
 602 .sp
 603 .ne 2
 604 .na
 605 \fB\fB-s\fR \fB\fIsetname\fR\fR\fR
 606 .ad
 607 .sp .6
 608 .RS 4n
 609 Specify the name of a disk set on which \fBmetaset\fR works. If no
 610 \fIsetname\fR is specified, all disk sets are returned.
 611 .RE
 612
 613 .sp
 614 .ne 2
 615 .na
 616 \fB\fB-t\fR\fR
 617 .ad
 618 .sp .6
 619 .RS 4n
 620 Take ownership of a disk set safely. If \fBmetaset\fR finds that another host
 621 owns the set, this host is not be allowed to take ownership of the set. If the
 622 set is not owned by any other host, all the disks within the set are owned by
 623 the host on which \fBmetaset\fR was executed. The metadevice state database is
 624 read in, and the shared metadevices contained in the set become accessible. The
 625 \fB-t\fR option takes a disk set that has stale databases. When the databases
 626 are stale, \fBmetaset\fR exits with code 66, and prints a message. At that
 627 point, the only operations permitted are the addition and deletion of replicas.
 628 Once the addition or deletion of the replicas has been completed, the disk set
 629 should be released and retaken to gain full access to the data.
 630 .sp
 631 This option is not for use with a multi-owner disk set.
 632 .RE
 633
 634 .sp
 635 .ne 2
 636 .na
 637 \fB\fB-u\fR \fItagnumber\fR\fR
 638 .ad
 639 .sp .6
 640 .RS 4n
 641 Once a tag has been selected, a subsequent take with \fB-u\fR \fItagnumber\fR
 642 can be executed to select the data associated with the given \fItagnumber\fR.
 643 .RE
 644
 645 .sp
 646 .ne 2
 647 .na
 648 \fBw\fR
 649 .ad
 650 .sp .6
 651 .RS 4n
 652 Withdraws a host from the owner list for a multi-owner disk set. The concepts
 653 of take and release, used with traditional disk sets, do not apply to
 654 multi-owner sets, because multiple owners are allowed.
 655 .sp
 656 Instead of releasing a set, a host can issue
 657 .sp
 658 .in +2
 659 .nf
 660 metaset -s \fImultinodesetname\fR -w
 661 .fi
 662 .in -2
 663 .sp
 664
 665 to withdraw from the owner list. A host automatically withdraws on a reboot,
 666 but can be manually withdrawn if it should not be able to use the set, but
 667 should be able to rejoin at a later time. A host that withdrew due to a reboot
 668 can still appear joined from other hosts in the set until a reconfiguration
 669 cycle occurs.
 670 .sp
 671 \fBmetaset\fR \fB-w\fR withdraws from ownership of all multi-owner sets of
 672 which the host is a member. This option fails if you attempt to withdraw the
 673 master node while other nodes are in the disk set owner list. This option
 674 cancels all resyncs running on the node. A cluster reconfiguration process that
 675 is removing a node from the cluster membership list effectively withdraws the
 676 host from the ownership list.
 677 .RE
 678
 679 .sp
 680 .ne 2
 681 .na
 682 \fB\fB-y\fR\fR
 683 .ad
 684 .sp .6
 685 .RS 4n
 686 Execute a subsequent take. If the take operation encounters ``tagged data,''
 687 the take operation exits with code 2. You can then run the \fBmetaset\fR
 688 command with the \fB-q\fR option to see an enumerated list of tags.
 689 .RE
 690
 691 .SH EXAMPLES
 692 .LP
 693 \fBExample 1 \fRDefining a Disk Set
 694 .sp
 695 .LP
 696 This example defines a disk set.
 697
 698 .sp
 699 .in +2
 700 .nf
 701 # metaset -s relo-red -a -h red blue
 702 .fi
 703 .in -2
 704 .sp
 705
 706 .sp
 707 .LP
 708 The name of the disk set is \fBrelo-red\fR. The names of the first and second
 709 hosts added to the set are \fBred\fR and \fBblue\fR, respectively. (The
 710 hostname is found in \fB/etc/nodename\fR.) Adding the first host creates the
 711 disk set. A disk set can be created with just one host, with the second added
 712 later. The last host cannot be deleted until all of the drives within the set
 713 have been deleted.
 714
 715 .LP
 716 \fBExample 2 \fRAdding Drives to a Disk Set
 717 .sp
 718 .LP
 719 This example adds drives to a disk set.
 720
 721 .sp
 722 .in +2
 723 .nf
 724 # metaset -s relo-red -a c2t0d0 c2t1d0 c2t2d0 c2t3d0 c2t4d0 c2t5d0
 725 .fi
 726 .in -2
 727 .sp
 728
 729 .sp
 730 .LP
 731 The name of the previously created disk set is \fBrelo-red\fR. The names of the
 732 drives are \fBc2t0d0\fR, \fBc2t1d0\fR, \fBc2t2d0\fR, \fBc2t3d0\fR,
 733 \fBc2t4d0\fR, and \fBc2t5d0\fR. There is no slice identifier ("s\fIx\fR") at
 734 the end of the drive names.
 735
 736 .LP
 737 \fBExample 3 \fRAdding Multiple Mediator Hosts
 738 .sp
 739 .LP
 740 The following command adds three mediator hosts to the specified disk set.
 741
 742 .sp
 743 .in +2
 744 .nf
 745 # metaset -s mydiskset -a -m myhost1,alias1 myhost2,alias2 myhost3,alias3
 746 .fi
 747 .in -2
 748 .sp
 749
 750 .LP
 751 \fBExample 4 \fRPurging a Disk Set from the Node
 752 .sp
 753 .LP
 754 The following command purges the disk set \fBrelo-red\fR from the node:
 755
 756 .sp
 757 .in +2
 758 .nf
 759 # metaset -s relo-red -P
 760 .fi
 761 .in -2
 762 .sp
 763
 764 .LP
 765 \fBExample 5 \fRQuerying a Disk Set for Tagged Data
 766 .sp
 767 .LP
 768 The following command queries the disk set \fBrelo-red\fR for a list of the
 769 tagged data:
 770
 771 .sp
 772 .in +2
 773 .nf
 774 # metaset -s relo-red -q
 775 .fi
 776 .in -2
 777 .sp
 778
 779 .sp
 780 .LP
 781 This command produces the following results:
 782 .sp
 783 .in +2
 784 .nf
 785 The following tag(s) were found:
 786  1 - vha-1000c - Fri Sep 20 17:20:08 2002
 787  2 - vha-1000c - Mon Sep 23 11:01:27 2002
 788 .fi
 789 .in -2
 790 .sp
 791
 792 .LP
 793 \fBExample 6 \fRSelecting a tag and taking a Disk set
 794 .sp
 795 .LP
 796 The following command selects a tag and takes the disk set \fBrelo-red\fR:
 797
 798 .sp
 799 .in +2
 800 .nf
 801 # metaset -s relo-red -t -u 2
 802 .fi
 803 .in -2
 804 .sp
 805
 806 .LP
 807 \fBExample 7 \fRDefining a Multi-Owner Disk Set
 808 .sp
 809 .LP
 810 The following command defines a multi-owner disk set:
 811
 812 .sp
 813 .in +2
 814 .nf
 815 # metaset -s blue -M -a -h hahost1 hahost2
 816 .fi
 817 .in -2
 818 .sp
 819
 820 .sp
 821 .LP
 822 The name of the disk set is \fBblue\fR. The names of the first and second hosts
 823 added to the set are \fBhahost1\fR and \fBhahost2\fR, respectively. The
 824 hostname is found in \fB/etc/nodename\fR. Adding the first host creates the
 825 multi-owner disk set. A disk set can be created with just one host, with
 826 additional hosts added later. The last host cannot be deleted until all of the
 827 drives within the set have been deleted.
 828
 829 .SH FILES
 830 .sp
 831 .ne 2
 832 .na
 833 \fB\fB/etc/lvm/md.tab\fR\fR
 834 .ad
 835 .sp .6
 836 .RS 4n
 837 Contains list of metadevice configurations.
 838 .RE
 839
 840 .SH EXIT STATUS
 841 .sp
 842 .LP
 843 The following exit values are returned:
 844 .sp
 845 .ne 2
 846 .na
 847 \fB\fB0\fR\fR
 848 .ad
 849 .sp .6
 850 .RS 4n
 851 Successful completion.
 852 .RE
 853
 854 .sp
 855 .ne 2
 856 .na
 857 \fB\fB>0\fR\fR
 858 .ad
 859 .sp .6
 860 .RS 4n
 861 An error occurred.
 862 .RE
 863
 864 .SH ATTRIBUTES
 865 .sp
 866 .LP
 867 See \fBattributes\fR(5) for descriptions of the following attributes:
 868 .sp
 869
 870 .sp
 871 .TS
 872 box;
 873 c | c
 874 l | l .
 875 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 876 _
 877 Interface Stability     Stable
 878 .TE
 879
 880 .SH SEE ALSO
 881 .sp
 882 .LP
 883 \fBmdmonitord\fR(1M), \fBmetaclear\fR(1M), \fBmetadb\fR(1M),
 884 \fBmetadetach\fR(1M), \fBmetahs\fR(1M), \fBmetainit\fR(1M),
 885 \fBmetaoffline\fR(1M), \fBmetaonline\fR(1M), \fBmetaparam\fR(1M),
 886 \fBmetarecover\fR(1M), \fBmetarename\fR(1M), \fBmetareplace\fR(1M),
 887 \fBmetaroot\fR(1M), \fBmetassist\fR(1M), \fBmetastat\fR(1M),
 888 \fBmetasync\fR(1M), \fBmetattach\fR(1M), \fBmd.tab\fR(4), \fBmd.cf\fR(4),
 889 \fBmddb.cf\fR(4), \fBmd.tab\fR(4), \fBattributes\fR(5), \fBmd\fR(7D)
 890 .sp
 891 .LP
 892 \fI\fR
 893 .SH NOTES
 894 .sp
 895 .LP
 896 Disk set administration, including the addition and deletion of hosts and
 897 drives, requires all hosts in the set to be accessible from the network.