metarecover(1M) System Administration Commands metarecover(1M)NAMEmetarecover - 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 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 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 data‐
base 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 metade‐
vices 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 identi‐
cal 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 con‐
taining 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 Head‐
ers
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 head‐
ers 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 attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │storage/svm │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Committed │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOmdmonitord(1M), metaclear(1M), metadb(1M), metadetach(1M), metahs(1M),
metainit(1M), metaoffline(1M), metaonline(1M), metaparam(1M), metare‐
name(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 26 Mar 2006 metarecover(1M)
