METAHS(1M)

NAME

metahs − manage metadevice hot spares and hot spare pools

SYNOPSIS

/usr/opt/SUNWmd/sbin/metahs [−s setname ] −a all component
/usr/opt/SUNWmd/sbin/metahs [−s setname ] −a hot-spare-pool [ component ]
/usr/opt/SUNWmd/sbin/metahs [−s setname ] −d hot_spare_pool [ component ]
/usr/opt/SUNWmd/sbin/metahs [−s setname ] −d all component
/usr/opt/SUNWmd/sbin/metahs [−s setname ] −e component
/usr/opt/SUNWmd/sbin/metahs [−s setname ] −r hot_spare_pool component-old
/usr/opt/SUNWmd/sbin/metahs [−s setname ] −r all component-old component-new
/usr/opt/SUNWmd/sbin/metahs [−s setname ] −i [ hot_spare_pool... ]

AVAILABILITY

This program is available with the Solstice DiskSuite software package (SUNWmd).

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(1M).

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 staus of hot spares is 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. hot_spare_pool is created if it does not already exist.

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

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

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

−s setname
Specifies the name of the diskset on which metahs will work. Using the −s option will cause the command to perform its administrative function within the specified diskset. Without this option, the command will perform its function on your local hot spare pools.

Museum