|
System Administration Commands | metarecover(1M) |
| 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 |
|
The metarecover command scans a specified component to look for soft partition configuration information and to regenerate the configuration.
|
|
The metarecover command line options are as follows:
- -d
- Recover soft partitions in the metadevice state database 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.
|
|
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.
|
| 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 metadevice state database based on the extent headers on the disk.
|
# metarecover -v c0t3d0s2 -p -d
|
|
Example 2. Update 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 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 configuration, though user data will not be recovered.
|
Example 4. Validate Soft Partition Configuration
|
To validate the existing soft partition configuration, use metarecover with only the -p flag.
|
# metarecover c0t3d0s2 -p
|
|
|
|
The following exit values are returned:
-
0
- Successful completion.
- >0
- An error occurred.
|
|
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
Availability | SUNWmdr |
|
|
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
|
| |