METASET(1M)

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 -M -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.

-M  Modifies the behavior of the -t option to grant ownership even if the databases are stale. Without this option, ownership of the diskset is denied when the databases are stale. When the databases are stale, metaset will exit code 66, and a message will be printed. When the -M option is used, the only operations permitted are the addition and deletion of replicas. Once the addition or deletion of replicas has been completed the diskset should be released and re-taken to gain full access to the data.

-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