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 data‐
base 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 metade‐
vice 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 iden‐
tical to the former setname in which the sps were cre‐
ated. 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 exam‐
ple, 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 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
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 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)
Solaris Volume Manager Administration Guide
SunOS 5.10 2 Jun 2004 metarecover(1M)
