metadevadm(1m)

1metadevadm(1M)          System Administration Commands          metadevadm(1M)
2
3
4

NAME

6       metadevadm - update metadevice information
7

SYNOPSIS

9       /usr/sbin/metadevadm [-h] [-n] [ [-l]-r] [-s setname]
10            [-u disk_specifier] [-v]
11
12

DESCRIPTION

14       The  metadevadm  command  facilitates  the  administration of device ID
15       entries in Solaris Volume Manager. Use this command when  the  pathname
16       stored  in  the metadevice state database no longer correctly addresses
17       the device or when a disk drive has had its device ID changed.
18
19
20       This command requires root privileges.
21

OPTIONS

23       The following options are supported.
24
25       -h                   Provide a help display.
26
27
28       -l                   Specify that metadevadm log to syslog(3C). metade‐
29                            vadm  logs to the DAEMON facility at the ERR level
30                            by  default.  See  syslog.conf(4)  for  additional
31                            information on changing logging levels.
32
33                            Use  this  option  anytime.  It  is most useful in
34                            startup scripts and less useful interactively.
35
36
37       -n                   Emulate the effect of a  command,  without  making
38                            any changes to the system.
39
40
41       -r                   Recompute the pathname and disk specifier (includ‐
42                            ing slice) associated  with  all  devices  in  the
43                            metadevice  state  database if the device supports
44                            device IDs. If a device does  not  support  device
45                            IDs or the device is not available, then no action
46                            is taken for that device.
47
48                            Use this option when the disk has  been  moved  or
49                            readdressed.
50
51                            This  option  is run automatically at boot time to
52                            detect device ID  changes  and  update  the  state
53                            database.
54
55
56       -s setname           Specify  the name of the disk set on which metade‐
57                            vadm works. This option causes the command to per‐
58                            form its administrative function within the speci‐
59                            fied disk set. Without this  option,  the  command
60                            performs its function on devices in the local disk
61                            set.
62
63
64       -u disk_specifier    Obtain  the  device   ID   associated   with   the
65                            disk_specifier  (for  example, c1t2d0) of a device
66                            and update the metadevice state database.  If  the
67                            device  ID  has not changed this option does noth‐
68                            ing. Use this option when a disk drive has had its
69                            device ID changed during a firmware upgrade or due
70                            to changing the controller of a storage subsystem.
71
72
73       -v                   Execute in verbose mode. This option has no effect
74                            when used with -u. Verbose is the default.
75
76

EXAMPLES

78       Example 1 Updating Device ID of Disk
79
80
81       The following example updates the device c2t3d0:
82
83
84         # metadevadm -u c2t3d0
85         Updating SLVM device relocation information for c2t3d0.
86         Old device reloc information: id19280192391293123012012010012012091398
87         New device reloc information: id19380192391293123012012010012012091398
88
89
90
91
92       The  following  example is a variation of the preceding, using the full
93       pathname.
94
95
96         # metadevadm -u /dev/dsk/c2t3d0
97
98
99
100
101       The following example uses the -n option, which means that the  command
102       is  emulated, but does not take effect. Note that when the -v option is
103       used with -u, -v has no effect (verbose is the default).
104
105
106         # metadevadm -u -v -n c2t3d0
107         Updating SLVM device relocation information for c2t3d0.
108         Old device reloc information: id19280192391293123012012010012012091398
109         New device reloc information: id19380192391293123012012010012012091398
110
111
112
113       Example 2 Recomputing Pathnames
114
115
116       In the following example, all device names are valid.
117
118
119         # metadevadm -r
120         Disk movement detected.
121         Updating device names in SLVM.
122
123
124
125
126       In the following example, once again device names are valid.
127
128
129         # metadevadm -r -v
130         Disk movement detected.
131         Updating device names in SLVM.
132         c0t0d0s0 changed to c0t0d1s0 from device relocation information
133         id12098123lkmklsdjaasdkfjadfjakds
134
135
136
137
138       In the following example, metadevadm detects an invalid device name.
139
140
141         # metadevadm -r
142         Invalid device relocation information detected in SLVM.
143         Please check status of following disk(s):
144         c3t0d0
145
146
147

RETURN VALUES

149       The following exit values are returned:
150
151       0    Command was successful.
152
153
154       1    metadevadm encountered an error condition.
155
156
157       2    An invalid device ID was detected when using the -r  option.  This
158            is for use in the rc2.d script. See init.d(4).
159
160

ATTRIBUTES

162       See attributes(5) for descriptions of the following attributes:
163
164
165
166
167       ┌─────────────────────────────┬─────────────────────────────┐
168       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
169       ├─────────────────────────────┼─────────────────────────────┤
170       │Availability                 │SUNWmdu                      │
171       ├─────────────────────────────┼─────────────────────────────┤
172       │Interface Stability          │Stable                       │
173       └─────────────────────────────┴─────────────────────────────┘
174