metarecover(1M) 					  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 regenerate the configura-
       tion.

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 mutu-
		       ally 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 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 device name (for example, d10) of  the
		       metadevice 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 parti-
       tions. 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 partition. 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 attributes:

       +-----------------------------+-----------------------------+
       |      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

SunOS 5.10							    2 Jun 2004							   metarecover(1M)