NAME

metaset − configure metadevice disksets

SYNOPSIS

/usr/opt/SUNWmd/sbin/metaset −s setname −a [ −f ] −h hostname ... 

/usr/opt/SUNWmd/sbin/metaset −s setname −a [ −l length ] drivename ... 

/usr/opt/SUNWmd/sbin/metaset −s setname −d [ −f ] −h hostname ... 

/usr/opt/SUNWmd/sbin/metaset −s setname −d [−f] drivename ... 

/usr/opt/SUNWmd/sbin/metaset −s setname −d [−f]

/usr/opt/SUNWmd/sbin/metaset −s setname −r

/usr/opt/SUNWmd/sbin/metaset −s setname −t

/usr/opt/SUNWmd/sbin/metaset −s setname −o [ −h hostname ]

/usr/opt/SUNWmd/sbin/metaset [−s setname ]

AVAILABILITY

This program is available with the Solstice DiskSuite software package. 

DESCRIPTION

metaset administers sets of disks shared for exclusive access between hosts. Shared metadevices/hotspare pools can be created only from drives which are in the diskset created by metaset.  To create a set, one or more hosts must be added to the set.  To create metadevices within the set, one or more devices must be added to the set. The drivename specified must be in the form cxtxdx with no slice specified. 

Note that Slice 7 is reserved for DiskSuite internal use only.  The remainder of the disk can be used or repartitioned in any manner you like.  Slice 7 should not be moved, removed, or overlapped with any other partition. 

After a diskset is created and metadevices are set up within the set, the metadevice name will be in the following form:

/dev/md/<setname>/{dsk,rdsk}/dX

where <setname> is the name of the set. 

OPTIONS

−s setname
Specifies the name of a set on which metaset will work. 

−a Adds drives or hosts to the named set. For a drive to be accepted into a set, the drive must not be in use within another metadevice, mounted on, or swapped on. When the drive is accepted into the set, it is repartitioned and the metadevice state database replica (for the set) may be placed on it. Also, a drive is not accepted if it cannot be found on all hosts specified as part of the set. 

−d Deletes drives or hosts from the named set. For a drive to be deleted, it must not be in use within the set. The last host cannot be deleted unless all of the drives within the set are deleted. 

−h hostname ...
Specifies one or more hostnames to be added to or deleted from a set. Adding the first host creates the set. The last host cannot be deleted unless all of the drives within the set have been deleted. The hostname is not accepted if all of the drives within the set cannot be found on the specified host. The hostname is the same name found in /etc/nodename. 

−t Takes ownership of a set safely. If metaset finds another host owns the set, this host will not be allowed to take ownership of the set. If the set is not owned by any other host, all the disks within the set will be owned by the host on which metaset was executed. The metadevice state database is read in, and the shared metadevices set up in the set become accessible. 

−f Forcibly takes ownership of a set when used with −t.  This will cause the set to be grabbed whether or not another host owns the set. All of the disks within the set are Taken over (reserved) and FailFast is be enabled. The metadevice state database will be read in, and the shared metadevices set up in the set will be accessible.  The −f option must be specified when the last drive is being deleted, since this drive would implicitly contain the last state database replica.  The −f option is also used for deleting hosts from a set.  When specified with a partial list of hosts, it can be used for one-host administration.  When specified with a complete list of hosts, the set is completely deleted.  It is generally specified with a complete list of hosts to clean up after one-host administration has been performed. 

−r Releases ownership of a set. All of the disks within the set are released. The metadevices set up within the set are no longer accessible. 

−o Returns an exit status of 0 if the local host or the the host specified with the -h option is the owner of the diskset. 

FILES

/etc/opt/SUNWmd/md.tab
Contains list of metadevice configurations.

NOTES

Diskset administration, including the addition and deletion of hosts and drives, requires all hosts in the set to be accessible from the network. 

SEE ALSO

metaclear(1M), metadb(1M), metadetach(1M), metahs(1M), metainit(1M), metaoffline(1M), metaonline(1M), metaparam(1M), metareplace(1M), metaroot(1M), metastat(1M), metasync(1M), metattach(1M), md.cf(4), md.tab(4), mddb.cf(4)

Solstice DiskSuite Administration Guide

SunOS 4.0  —  Last change: 03 February 1995