metadevadm(1M) System Administration Commands metadevadm(1M)NAMEmetadevadm - update metadevice information
SYNOPSIS
/usr/sbin/metadevadm [-h] [-n] [ [-l]-r] [-s setname]
[-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.
This command requires root privileges.
OPTIONS
The following options are supported.
-h Provide a help display.
-l Specify that metadevadm log to syslog(3C). metade‐
vadm logs to the DAEMON facility at the ERR level
by default. See syslog.conf(4) for additional
information on changing logging levels.
Use this option anytime. It is most useful in
startup scripts and less useful interactively.
-n Emulate the effect of a command, without making
any changes to the system.
-r Recompute the pathname and disk specifier (includ‐
ing slice) associated with all devices in the
metadevice state database if the device supports
device IDs. If a device does not support device
IDs or the device is not available, then no action
is taken for that device.
Use this option when the disk has been moved or
readdressed.
This option is run automatically at boot time to
detect device ID changes and update the state
database.
-s setname Specify the name of the disk set on which metade‐
vadm works. This option causes the command to per‐
form its administrative function within the speci‐
fied disk set. Without this option, the command
performs its function on devices in the local disk
set.
-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 noth‐
ing. 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 Execute in verbose mode. This option 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 following exit values are returned:
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 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‐
cover(1M), metarename(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 metadevadm(1M)
