System Administration Commands                    metarecover(1M)

NAME
     metarecover - recover soft partition information

SYNOPSIS
     /sbin/metarecover [-n] [-v] [-s setname] component -p

     /sbin/metarecover [-n] [-v] [-s setname] component -p {-d}

     /sbin/metarecover [-n] [-v] [-s setname] component -p {-m}

DESCRIPTION
     The metarecover command scans a specified component to  look
     for  soft  partition configuration information and to regen-
     erate the configuration.

OPTIONS
     The following options are supported:

     -d              Recover soft partitions  in  the  metadevice
                     state  database  from  the extent headers on
                     the device. Options -d and -m  are  mutually
                     exclusive.



     -m              Regenerate the  extent headers and reapplies
                     them  to the  underlying device based on the
                     soft partitions  listed  in  the  metadevice
                     state  database. Options -d and -m are mutu-
                     ally exclusive.



     -n              Do not actually perform the operation.  Show
                     the   output   or  errors  that  would  have
                     resulted from the  operation,  had  it  been
                     run.



     -p              Regenerate  soft  partitions  based  on  the
                     metadevice  state database or extent headers
                     on the underlying device. If neither -d  nor
                     -m  are  specified, this option compares the
                     soft partition information in the metadevice
                     state database to the extent headers.



     -s setname      Specify the name of  the  diskset  on  which
                     metarecover works. Using the s option causes
                     the command to perform its  function  within
                     the   specified   diskset.  Without  the  -s
                     option, the metarecover command operates  on
                     the  metadevices  and/or  hot spare pools in
                     the local diskset.

                     This option is required  to  recover  former
                     sps  from   a   diskset  component  or  raw-
                     device. setname must  be  identical  to  the
                     former   setname  in  which   the  sps  were
                     created.  The  set  numbers,  however,  seem
                     irrelevant.



     -v              Verbose mode, displaying the  changes  being
                     made.



OPERANDS
     The following operand is supported:

     component       Specifies the c*t*d*s* number of the disk or
                     slice containing the partitions, or the dev-
                     ice name (for example, d10) of the  metadev-
                     ice containing the partitions.

                     component can be  a  slice  name,  component
                     name, /dev/dsk path, or /dev/rdsk path.



EXAMPLES
     Example 1: Updating Metadevice State Database Based on  Disk
     Extent Headers

     A disk containing soft partitions is moved from  one  system
     to  another.  The system administrator would like to use the
     existing soft partitions. metarecover updates the metadevice
     state database based on the extent headers on the disk.

     # metarecover -v c0t3d0s2 -p -d

     Example 2:  Updating  Metadevice  State  Database  Based  on
     Incomplete Soft Partition Creation

     A system crashes in the middle of creating a new soft parti-
     tion.  The  soft  partition is in the creating state and the
     driver does not  let  that  device  be  opened.  metarecover
     rewrites  the  extent headers for the partially created soft
     partition and mark it as Okay.

     # metarecover -v c0t3d0s2 -p -m

     Example 3: Updating Extent Headers Based on Metadevice State
     Database

     Someone accidentally overwrote a portion of a  disk  leaving
     extent  headers  destroyed.  metarecover rewrites the extent
     headers to ensure  a  valid  soft  partition  configuration,
     though user data is not recovered.

     # metarecover -v d5 -m

     Example 4: Validating Soft Partition Configuration

     To validate the existing soft partition  configuration,  use
     metarecover with only the -p flag.

     # metarecover c0t3d0s2 -p

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                | SUNWmdr                     |
    |_____________________________|_____________________________|


SEE ALSO
     mdmonitord(1M), metaclear(1M),  metadb(1M),  metadetach(1M),
     metahs(1M),  metainit(1M),  metaoffline(1M), metaonline(1M),
     metaparam(1M),       metarename(1M),        metareplace(1M),
     metaroot(1M),   metaset(1M),   metassist(1M),  metastat(1M),
     metasync(1M),    metattach(1M),     md.tab(4),     md.cf(4),
     mddb.cf(4), md.tab(4), attributes(5), md(7D)

     Solaris Volume Manager Administration Guide