1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
|
'\" te
.\" Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved
.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
.TH metareplace 1M "26 Mar 2006" "SunOS 5.11" "System Administration Commands"
.SH NAME
metareplace \- enable or replace components of submirrors or RAID5 metadevices
.SH SYNOPSIS
.LP
.nf
\fB/usr/sbin/metareplace\fR \fB-h\fR
.fi
.LP
.nf
\fB/usr/sbin/metareplace\fR [\fB-s\fR \fIsetname\fR] \fB-e\fR \fImirror\fR \fIcomponent\fR
.fi
.LP
.nf
\fB/usr/sbin/metareplace\fR [\fB-s\fR \fIsetname\fR] \fImirror\fR \fIcomponent-old\fR \fIcomponent-new\fR
.fi
.LP
.nf
\fB/usr/sbin/metareplace\fR [\fB-s\fR \fIsetname\fR] \fB-e\fR \fIRAID\fR \fIcomponent\fR
.fi
.LP
.nf
\fB/usr/sbin/metareplace\fR [\fB-s\fR \fIsetname\fR] [\fB-f\fR] \fIRAID\fR \fIcomponent-old\fR \fIcomponent-new\fR
.fi
.SH DESCRIPTION
.sp
.LP
The \fBmetareplace\fR command is used to enable or replace components (slices)
within a submirror or a RAID5 metadevice.
.sp
.LP
When you replace a component, the \fBmetareplace\fR command automatically
starts resyncing the new component with the rest of the metadevice. When the
resync completes, the replaced component becomes readable and writable. If the
failed component has been hot spare replaced, the hot spare is placed in the
available state and made available for other hot spare replacements.
.sp
.LP
Note that the new component must be large enough to replace the old component.
.sp
.LP
A component may be in one of several states. The \fBLast\fR \fBErred\fR and the
\fBMaintenance\fR states require action. Always replace components in the
\fBMaintenance\fR state first, followed by a resync and validation of data.
After components requiring maintenance are fixed, validated, and resynced,
components in the \fBLast\fR \fBErred\fR state should be replaced. To avoid
data loss, it is always best to back up all data before replacing \fBLast\fR
\fBErred\fR devices.
.SH OPTIONS
.sp
.LP
Root privileges are required for all of the following options except \fB-h\fR.
.sp
.ne 2
.mk
.na
\fB\fB-e\fR\fR
.ad
.RS 17n
.rt
Transitions the state of \fIcomponent\fR to the available state and resyncs the
failed component. If the failed component has been hot spare replaced, the hot
spare is placed in the available state and made available for other hot spare
replacements. This command is useful when a component fails due to human error
(for example, accidentally turning off a disk), or because the component was
physically replaced. In this case, the replacement component must be
partitioned to match the disk being replaced before running the
\fBmetareplace\fR command.
.RE
.sp
.ne 2
.mk
.na
\fB\fB-f\fR\fR
.ad
.RS 17n
.rt
Forces the replacement of an errored component of a metadevice in which
multiple components are in error. The component determined by the
\fBmetastat\fR display to be in the ``Maintenance'' state must be replaced
first. This option may cause data to be fabricated since multiple components
are in error.
.RE
.sp
.ne 2
.mk
.na
\fB\fB-h\fR\fR
.ad
.RS 17n
.rt
Display help message.
.RE
.sp
.ne 2
.mk
.na
\fB\fB-s\fR \fB\fIsetname\fR\fR\fR
.ad
.RS 17n
.rt
Specifies the name of the diskset on which \fBmetareplace\fR will work. Using
the \fB-s\fR option will cause the command to perform its administrative
function within the specified diskset. Without this option, the command will
perform its function on local metadevices.
.RE
.sp
.ne 2
.mk
.na
\fB\fImirror\fR\fR
.ad
.RS 17n
.rt
The metadevice name of the mirror.
.RE
.sp
.ne 2
.mk
.na
\fB\fIcomponent\fR\fR
.ad
.RS 17n
.rt
The logical name for the physical slice (partition) on a disk drive, such as
\fB/dev/dsk/c0t0d0s2\fR.
.RE
.sp
.ne 2
.mk
.na
\fB\fIcomponent-old\fR\fR
.ad
.RS 17n
.rt
The physical slice that is being replaced.
.RE
.sp
.ne 2
.mk
.na
\fB\fIcomponent-new\fR\fR
.ad
.RS 17n
.rt
The physical slice that is replacing \fIcomponent-old\fR.
.RE
.sp
.ne 2
.mk
.na
\fB\fIRAID\fR\fR
.ad
.RS 17n
.rt
The metadevice name of the RAID5 device.
.RE
.SH EXAMPLES
.LP
\fBExample 1 \fRRecovering from Error Condition in RAID5 Metadevice
.sp
.LP
This example shows how to recover when a single component in a RAID5 metadevice
is errored.
.sp
.in +2
.nf
# metareplace d10 c3t0d0s2 c5t0d0s2
.fi
.in -2
.sp
.sp
.LP
In this example, a RAID5 metadevice \fBd10\fR has an errored component,
\fBc3t0d0s2\fR, replaced by a new component, \fBc5t0d0s2\fR.
.LP
\fBExample 2 \fRUse of \fB-e\fR After Physical Disk Replacement
.sp
.LP
This example shows the use of the \fB-e\fR option after a physical disk in a
submirror (a submirror of mirror \fBmymirror1\fR, in this case) has been
replaced.
.sp
.in +2
.nf
# metareplace -e mymirror1 c1t4d0s2
.fi
.in -2
.sp
.sp
.LP
Note: The replacement disk must be partitioned to match the disk it is
replacing before running the \fBmetareplace\fR command.
.SH EXIT STATUS
.sp
.LP
The following exit values are returned:
.sp
.ne 2
.mk
.na
\fB\fB0\fR\fR
.ad
.RS 6n
.rt
Successful completion.
.RE
.sp
.ne 2
.mk
.na
\fB\fB>0\fR\fR
.ad
.RS 6n
.rt
An error occurred.
.RE
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i)
lw(2.75i) |lw(2.75i)
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Interface StabilityStable
.TE
.SH SEE ALSO
.sp
.LP
\fBmdmonitord\fR(1M), \fBmetaclear\fR(1M), \fBmetadb\fR(1M),
\fBmetadetach\fR(1M), \fBmetahs\fR(1M), \fBmetainit\fR(1M),
\fBmetaoffline\fR(1M), \fBmetaonline\fR(1M), \fBmetaparam\fR(1M),
\fBmetarecover\fR(1M), \fBmetarename\fR(1M), \fBmetaroot\fR(1M),
\fBmetaset\fR(1M), \fBmetassist\fR(1M), \fBmetastat\fR(1M), \fBmetasync\fR(1M),
\fBmetattach\fR(1M), \fBmd.tab\fR(4), \fBmd.cf\fR(4), \fBmddb.cf\fR(4),
\fBmd.tab\fR(4), \fBattributes\fR(5), \fBmd\fR(7D)
.sp
.LP
\fI\fR
|
