metareplace(1M)

NAME

     metareplace - enable or replace components of submirrors  or
     RAID5 metadevices

SYNOPSIS

     /usr/sbin/metareplace -h

     /usr/sbin/metareplace [-s setname] -e mirror component

     /usr/sbin/metareplace  [-s setname]   mirror   component-old
     component-new

     /usr/sbin/metareplace [-s setname] -e RAID component

     /usr/sbin/metareplace [-s setname] [-f]  RAID  component-old
     component-new

DESCRIPTION

     The metareplace command is used to enable  or  replace  com-
     ponents (slices) within a submirror or a RAID5 metadevice.

     When  you  replace  a  component,  the  metareplace  command
     automatically  starts  resyncing  the new component with the
     rest of the  metadevice.  When  the  resync  completes,  the
     replaced  component  becomes  readable  and writable. 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
     components in the Maintenance state  first,  followed  by  a
     resync  and  validation  of data. After components requiring
     maintenance are fixed, validated, and  resynced,  components
     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

     Root privileges  are  required  for  all  of  the  following
     options except -h.

     -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. This command is use-
           ful  when  a  component  fails due to human error (for
           example, accidentally turning off a disk), or  because
           the  component  was physically replaced. In this case,
           the replacement component must be partitioned to match
           the disk being replaced before running the metareplace
           command.

     -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 mul-
           tiple components are in error.

     -h    Display help message.

     -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 local metadevices.

     mirror
           The metadevice name of the mirror.

     component
           The logical name for the physical slice (partition) on
           a disk drive, such as /dev/dsk/c0t0d0s2.

     component-old
           The physical slice that is being replaced.

     component-new
           The physical slice that is replacing component-old.

     RAID  The metadevice name of the RAID5 device.

EXAMPLES

     Example 1: Recovering from Error Condition in RAID5 Metadev-
     ice

     This example shows how to recover when a single component in
     a RAID5 metadevice is errored.

     # metareplace d10 c3t0d0s2 c5t0d0s2

     In this example, a RAID5 metadevice d10 has an errored  com-
     ponent, c3t0d0s2, replaced by a new component, c5t0d0s2.

     Example 2: Use of -e After Physical Disk Replacement

     This example shows the use of the -e option after a physical
     disk  in  a  submirror  (a  submirror of mirror d11, in this
     case) has been replaced.

     # metareplace -e d11 c1t4d0s2

     Note: The replacement disk must be partitioned to match  the
     disk it is replacing before running the metareplace command.

EXIT STATUS

     The following exit values are returned:

          0     Successful completion.

          >0    An error occurred.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWmdu                     |
    |_____________________________|_____________________________|

SEE ALSO

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

     Solaris Volume Manager Administration Guide