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 Commandsmetadevadm(1M)


NAME

 metadevadm - update metadevice information

SYNOPSIS

 /usr/sbin/metadevadm [-h] [-n] [-r] [-u disk_specifier] [-v]

DESCRIPTION

 

The metadevadm command facilitates the administration of device ID entries in Solaris Volume Manager. Use this command when the pathname stored in the metadevice state database no longer correctly addresses the device or when a disk drive has had its device ID changed.

OPTIONS

 

Root privileges are required for all of the following options except -h.

-h
Provides a help display.
-n
Emulates the effect of a command, without making any changes to the system.
-r
Recomputes the pathname and disk specifier (including slice) associated with all devices in the metadevice state database if a device ID is present for the device. Use this option when the disk has been moved or readdressed.
-u disk_specifier
Obtain the device ID associated with the disk_specifier (for example, c1t2d0) of a device and update the metadevice state database. If the device ID has not changed this option does nothing. Use this option when a disk drive has had its device ID changed during a firmware upgrade or due to changing the controller of a storage subsystem.
-v
Verbose mode. Has no effect when used with -u (verbose is the default).

EXAMPLES

 Example 1. Updating Device ID of Disk
 

The following example updates the device c2t3d0:

 
# metadevadm -u c2t3d0
Updating SLVM device relocation information for c2t3d0.
Old device reloc information: id19280192391293123012012010012012091398
New device reloc information: id19380192391293123012012010012012091398

The following example is a variation of the preceding, using the full pathname.

 
# metadevadm -u /dev/dsk/c2t3d0

The following example uses the -n option, which means that the command is emulated, but does not take effect. Note that when the -v option is used with -u, -v has no effect (verbose is the default).

 
# metadevadm -u -v -n c2t3d0
Updating SLVM device relocation information for c2t3d0.
Old device reloc information: id19280192391293123012012010012012091398
New device reloc information: id19380192391293123012012010012012091398

Example 2. Recomputing Pathnames
 

In the following example, all device names are valid.

 
# metadevadm -r
Disk movement detected.
Updating device names in SLVM.

In the following example, once again device names are valid.

 
# metadevadm -r -v
Disk movement detected.
Updating device names in SLVM.
c0t0d0s0 changed to c0t0d1s0 from device relocation information
id12098123lkmklsdjaasdkfjadfjakds

In the following example, metadevadm detects an invalid device name.

 
# metadevadm -r
Invalid device relocation information detected in SLVM.
Please check status of following disk(s):
c3t0d0

RETURN VALUES

 

The metadevadm command has the following return values:

0
Command was successful.
1
metadevadm encountered an error condition.
2
An invalid device ID was detected when using the -r option. This is for use in the rc2.d script. See init.d(4).

ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWmdu

SEE ALSO

 

metaclear(1M), metadb(1M), metadetach(1M), metahs(1M), metainit(1M), metaparam(1M), metarecover(1M), metareplace(1M), metaroot(1M), metaset(1M), metastat(1M), metasync(1M), metattach(1M), md.tab(4), md.cf(4), mddb.cf(4)

Solaris Volume Manager Administration Guide


SunOS 5.9Go To TopLast Changed 10 Jan 2001

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