METAHS(8) — MAINTENANCE COMMANDS

NAME

metahs − manage metadisk hot spares and hot spare pools

SYNOPSIS

/usr/etc/metahs −a all component
/usr/etc/metahs −a hot-spare-pool component
/usr/etc/metahs −d hot_spare_pool [ component ]
/usr/etc/metahs −d all component
/usr/etc/metahs −e component
/usr/etc/metahs −r hot_spare_pool component-old component-new
/usr/etc/metahs −r all component-old component-new
/usr/etc/metahs −i [ hot_spare_pool... ]

AVAILABILITY

This program is available with the Sun Online: DiskSuite software package.

DESCRIPTION

metahs is a management utility for hot spares and hot spare pools. metahs does not replace a component of a metadevice. This function is performed by metareplace(8).

Hot spares can be attached to more than one hot spare pool. For example, the user may have three submirrors and three hot spare components. The three hot spare components can be arranged as three hot spare pools, with each pool having the three hot spare components in a different order of preference. This allows the optimal hot spare to be selected first and improves availability by having more hot spares available.

Hot spares are always in one of three states: available, in-use, or broken. Available hot spares are running and ready to accept data, but are not currently being written to or read from. In-use hot spares are currently being written to and read from. Broken hot spares are out of service and should be sent in for repair. The states are displayed when metahs is invoked with the −i option.

Hot spare pools must be of the form hspnnn, where nnn is a number in the range 000-999.

OPTIONS

−a all component
Adds component to all hot spare pools. all is not case sensitive.

−a hot_spare_pool component
Adds the component to the specified hot_spare_pool.

−d hot_spare_pool [ component ]
Deletes hot_spare_pool, if the hot_spare_pool is both empty and not referenced by a metadevice. If component is specified, it is deleted from the hot_spare_pool. Hot spares in the in-use state can not be deleted.

−d all component
Deletes component from all the hot spare pools. The component can not be deleted if it is in the in-use state. all is not case sensitive.

−e component
Enables component to be available for use as a hot spare. The component can be enabled if it is in the broken state and has been repaired.

−r hot_spare_pool component-old component-new
Replaces component-old with component-new in the specified hot_spare_pool. Components can not be replaced from a hot spare pool if the old hot spare is in the in-use state.

−r all component-old component-new
Replace component-old with component-new in all hot spare pools which have the component attached. Components can not be replaced from any hot spare pool if the old hot spare is in the in-use state. all is not case sensitive.

−i [ hot_spare_pool ... ]
Displays the status of the specified hot_spare_pool or for all hot spare pools if one is not specified.

Museum