METAREPLACE(1M)

NAME

metareplace − replace components of submirrors or RAID metadevices

SYNOPSIS

/usr/opt/SUNWmd/sbin/metareplace [−s setname ] −e metamirror component
/usr/opt/SUNWmd/sbin/metareplace [−s setname ] metamirror component-old component-new
/usr/opt/SUNWmd/sbin/metareplace [−s setname ] −h
/usr/opt/SUNWmd/sbin/metareplace [−s setname ] [−f ] metaraid component-old component-new
/usr/opt/SUNWmd/sbin/metareplace [−s setname ] −e metaraid component

AVAILABILITY

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

DESCRIPTION

metareplace is used to replace components within a submirror.

metareplace will automatically start a resync to get the new component in sync with the rest of the metamirror. When the resync completes, the submirror that contains the replaced component becomes readable and writeable. If the failed component has been hot spare replaced, the hot spare is placed in the available state and made available for other hot spare replacements.

Note that the new component must be large enough to replace the old component.

A component may be in one of several states. The Last Erred and the Maintenance states require action. Always replace disks in the Maintenance state first, followed by a resync and validation of data. After disks requiring maintenance are fixed, validated, and resynced, disks in the Last Erred state should be replaced. To avoid data loss, it is always best to back up all data before replacing Last Erred devices.

OPTIONS

−h Display help message.

−e Transitions the state of component to the available state and resyncs the failed component. If the failed component has been hot spare replaced, the hot spare is placed in the available state and made available for other hot spare replacements.

−f Forces the replacement of an errored component of a metadevice in which multiple components are in error. The component determined by the metastat display to be in the “Maintenance” state must be replaced first. This option may cause data to be fabricated since multiple components are in error.

−s setname
Specifies the name of the diskset on which metareplace 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 metadevices.

Museum