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 metarecover command line options are as follows:

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

     -m    Regenerates 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 mutually exclusive.

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

     -p    Regenerates 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
           Specifies the name of the diskset on which metarecover
           will  work.  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.

     -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 device name (for
           example, d10) of the metadevice containing the  parti-
           tions.

EXAMPLES

     Example 1: Update 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 will update the  meta-
     device  state  database  based  on the extent headers on the
     disk.

     # metarecover -v c0t3d0s2 -p -d

     Example 2: Update Metadevice State Database Based on  Incom-
     plete 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 will not let that device be opened. metarecover  will
     rewrite  the  extent  headers for the partially created soft
     partition and mark it as Okay.

     # metarecover -v c0t3d0s2 -p -m

     Example 3: Update Extent Headers Based on  Metadevice  State
     Database

     Someone accidentally overwrote a portion of a  disk  leaving
     extent  headers  destroyed.  metarecover  will  rewrite  the
     extent headers to ensure a valid soft  partition  configura-
     tion, though user data will not be recovered.

     # metarecover -v d5 -m

     Example 4: Validate 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

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

     Solaris Volume Manager Administration Guide