Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
System Administration Commandsmetarecover(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 configuration.

OPTIONS

 

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.

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.

EXAMPLES

 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.

 
# metarecover -v d5 -m

Example 4. Validate 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 TYPEATTRIBUTE VALUE
AvailabilitySUNWmdr

SEE ALSO

 

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


SunOS 5.9Go To TopLast Changed 4 Jun 2001

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.