Manual Pages for UNIX Operating System command usage for man metarecover

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  mutually
                   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  meta-
                   device state database or extent headers on the
                   underlying device. If neither -d  nor  -m  are
                   specified,  this option compares the soft par-
                   tition 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



SunOS 5.11          Last change: 26 Mar 2006                    1






System Administration Commands                    metarecover(1M)



                   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. set-
                   name 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 device
                  name (for example, d10) of the metadevice  con-
                  taining 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 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 does not  let  that  device  be  opened.  metarecover
     rewrites  the  extent headers for the partially created soft
     partition and mark it as Okay.





SunOS 5.11          Last change: 26 Mar 2006                    2






System Administration Commands                    metarecover(1M)



       # 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




     The following example implements the same  command  using  a
     descriptive name.


       # metarecover -v myvolume -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:





SunOS 5.11          Last change: 26 Mar 2006                    3






System Administration Commands                    metarecover(1M)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | storage/svm                 |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|


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)




































SunOS 5.11          Last change: 26 Mar 2006                    4