Print this page
2052 iiadm(1M) incorrectly describes group removal
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1m/iiadm.1m
+++ new/usr/src/man/man1m/iiadm.1m
1 1 '\" te
2 2 .\" Copyright (c) 2007, Sun Microsystems, Inc. All rights reserved.
3 3 .\" 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.
4 4 .\" 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.
5 5 .\" 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]
6 -.TH IIADM 1M "Oct 2, 2007"
6 +.TH IIADM 1M "Mar 6, 2014"
7 7 .SH NAME
8 8 iiadm \- command-line interface to control Sun StorageTek Availability Suite
9 9 Point-in-Time Copy operations
10 10 .SH SYNOPSIS
11 11 .LP
12 12 .nf
13 13 \fBiiadm\fR \fB-e\fR {ind | shd} \fImaster_vol\fR \fIshadow_vol\fR \fIbitmap_vol\fR
14 14 .fi
15 15
16 16 .LP
17 17 .nf
18 18 \fBiiadm\fR \fB-ne\fR ind \fImaster_vol\fR \fIshadow_vol\fR \fIbitmap_vol\fR
19 19 .fi
20 20
21 21 .LP
22 22 .nf
23 23 \fBiiadm\fR [\fB-p\fR] [\fB-n\fR] {\fB-c\fR | \fB-u\fR} {s | m} \fIvolume_set\fR
24 24 .fi
25 25
26 26 .LP
27 27 .nf
28 28 \fBiiadm\fR [\fB-adDilR\fR] \fIvolume_set\fR
29 29 .fi
30 30
31 31 .LP
32 32 .nf
33 33 \fBiiadm\fR [\fB-p\fR] [\fB-n\fR] \fB-w\fR \fIvolume_set\fR
34 34 .fi
35 35
36 36 .LP
37 37 .nf
38 38 \fBiiadm\fR [\fB-hilLv\fR]
39 39 .fi
40 40
41 41 .LP
42 42 .nf
43 43 \fBiiadm\fR \fB-P\fR \fIdelay\fR \fIunits\fR \fIvolume_set\fR
44 44 .fi
45 45
46 46 .LP
47 47 .nf
48 48 \fBiiadm\fR \fB-P\fR \fIvolume_set\fR
49 49 .fi
50 50
51 51 .LP
52 52 .nf
53 53 \fBiiadm\fR \fB-A\fR \fIoverflow_vol\fR \fIvolume_set\fR
54 54 .fi
55 55
56 56 .LP
57 57 .nf
58 58 \fBiiadm\fR [\fB-OQ\fR] \fIoverflow_vol\fR
59 59 .fi
60 60
61 61 .LP
62 62 .nf
63 63 \fBiiadm\fR \fB-E\fR \fIvolume_set\fR
64 64 .fi
65 65
66 66 .LP
67 67 .nf
68 68 \fBiiadm\fR [\fB-IJ\fR] \fIvolume_set\fR \fIbitmap\fR
69 69 .fi
70 70
71 71 .LP
72 72 .nf
73 73 \fBiiadm\fR \fB-g\fR \fIgroup_name\fR [\fB-aAcdDeEilLmPRuw\fR]
74 74 .fi
75 75
76 76 .LP
77 77 .nf
78 78 \fBiiadm\fR [\fB-C\fR] \fIcluster_tag\fR [\fIoptions\fR]
79 79 .fi
80 80
81 81 .SH DESCRIPTION
82 82 .sp
83 83 .LP
84 84 Point-in-Time Copy software is a point-in-time snapshot feature of the Solaris
85 85 operating system.
86 86 .sp
87 87 .LP
88 88 A Point-in-Time Copy snapshot is an instantly-available, time-fixed, replicated
89 89 view of a momentarily quiesced volume. Once a snapshot is taken, Point-in-Time
90 90 Copy software allows immediate read/write access to both the master and shadow
91 91 volume data.
92 92 .sp
93 93 .LP
94 94 Point-in-Time Copy software tracks the differences between the master and
95 95 shadow volumes (caused by writes) from the moment that the snapshot was
96 96 established. This capability allows applications accessing the master volume's
97 97 data to move forward in time independently of applications accessing the shadow
98 98 volume's data, and vice-versa.
99 99 .sp
100 100 .LP
101 101 The Point-in-Time Copy software's tracking of differences between the master
102 102 and shadow volumes facilitates a fast resynchronization or a full copy at a
103 103 later time. The volume resynchronization can occur from either shadow to master
104 104 or master to shadow.
105 105 .sp
106 106 .LP
107 107 Instantly after the point-in-time is (re-)established (either when the CLI
108 108 prompt returns or the next shell script command is read), the master volume can
109 109 be remounted or the applications using them can be resumed. Also, the shadow
110 110 volume can be mounted and immediately accessed.
111 111 .sp
112 112 .LP
113 113 The \fBiiadm\fR command line utility performs only one action per command
114 114 invocation. Because of this, you cannot combine multiple options, except in
115 115 combination with the following overall command modifiers:
116 116 .RS +4
117 117 .TP
118 118 .ie t \(bu
119 119 .el o
120 120 If no action item is entered, \fBiiadm\fR displays the list of Point-in-Time
121 121 Copy sets (non-suspended) currently configured. If more than one action item,
122 122 or an incorrectly specified action item is entered, \fBiiadm\fR displays the
123 123 specific error message to stderr, followed by a brief usage summary.
124 124 .RE
125 125 .RS +4
126 126 .TP
127 127 .ie t \(bu
128 128 .el o
129 129 For the Point-in-Time Copy options ENABLE (\fB-e\fR), COPY (\fB-c\fR) and
130 130 UPDATE (\fB-u\fR), there are two associated shadow volume selection qualifiers,
131 131 \fB{ind|dep}\fR, that are used to specify the type of Point-in-Time Copy volume
132 132 set to create.
133 133 .RE
134 134 .sp
135 135 .LP
136 136 An independent (\fBind\fR) snapshot causes Point-in-Time Copy software to
137 137 perform a full volume copy operation from the master to the shadow. When the
138 138 copy completes, the shadow volume data is identical to the master volume data
139 139 at the moment that it was established. Create an independent shadow if you
140 140 require two physical copies of the data. An independent shadow volume must be
141 141 the same size or greater than the size of the master volume. Sun recommends
142 142 that the master and shadow volumes be the same size for environments where
143 143 resynchronization from shadow to master is a consideration.
144 144 .sp
145 145 .LP
146 146 A dependent (\fBdep\fR) snapshot causes Point-in-Time Copy software not to
147 147 perform a full volume copy. The resulting shadow volume relies on the master
148 148 volume for all unmodified data blocks, which are not copied until requested.
149 149 Create a dependent shadow when you do not require two physical copies of the
150 150 data. A dependent shadow volume can be either the same size or smaller than the
151 151 master volume. A smaller shadow volume is called a \fBCompact Dependent Shadow
152 152 Volume\fR, and is typically used when the amount of change that occurs to a
153 153 Point-in-Time Copy volume set is small compared to the entire size of the
154 154 master volume.
155 155 .sp
156 156 .LP
157 157 The following syntax allows you to create an exportable independent shadow
158 158 volume in a Sun Cluster environment:
159 159 .sp
160 160 .in +2
161 161 .nf
162 162 # iiadm -ne ind master shadow bitmap
163 163 .fi
164 164 .in -2
165 165 .sp
166 166
167 167 .sp
168 168 .LP
169 169 An issue arises when using a Compact Dependent Shadow Volume in that its size
170 170 is established at the time that the Point-in-Time Copy volume set is enabled.
171 171 If the amount of change to the entire volume set over the duration of its usage
172 172 exceeds the space allocated for the shadow volume, the shadow volume is marked
173 173 as out of space. It is possible to read from the shadow volume even after it is
174 174 out of space, until a portion of the data for which there was no room is
175 175 requested. Once that happens, the read fails and the shadow volume is marked
176 176 offline.
177 177 .sp
178 178 .LP
179 179 To address this issue, Point-in-Time Copy supports the ability to associate an
180 180 \fBoverflow\fR volume to an existing Point-in-Time Copy dependent volume set.
181 181 Thus, if the size of the Compact Dependent Shadow Volume is too small, or an
182 182 unscheduled amount of change occurs to the volume set, changed data can be
183 183 redirected to the associated overflow volume. To facilitate efficient usage of
184 184 this overflow volume, it can be associated with multiple Point-in-Time Copy
185 185 volume sets on an as-needed basis.
186 186 .SS "Considerations"
187 187 .sp
188 188 .LP
189 189 Prior to invoking an Point-in-Time Copy \fBenable\fR, \fBcopy\fR or
190 190 \fBupdate\fR operation, Point-in-Time Copy assures that the shadow volume is
191 191 not mounted, to prevent a file system panic from occurring. Also, it is
192 192 suggested that you either unmount or suspend (quiesce) all applications using
193 193 the master volume, for only the instant when the point-in-time snapshot is
194 194 taken. This assures that an atomically consistent point-in-time snapshot is
195 195 taken.
196 196 .sp
197 197 .LP
198 198 It is suggested that, if the master volume was suspended rather than unmounted,
199 199 the new point-in-time shadow volume's integrity be validated using volume
200 200 validation utilities, such as \fBfsck\fR(1M). The reason is that Point-in-Time
201 201 Copy has made a point-in-time copy of a \fBmounted\fR master volume to an
202 202 \fBunmounted\fR shadow volume. During the mounting of the shadow volume, the
203 203 file system detects that it is in the \fBmounted\fR state. Typically this state
204 204 occurs only when a system crashes, so the file system attempts to validate the
205 205 integrity of the volume assuming a system failure occurred, not an
206 206 Point-in-Time Copy.
207 207 .SS "ENVIRONMENT OPTIONS"
208 208 .sp
209 209 .LP
210 210 The \fBii_bitmap\fR variable in the \fB/usr/kernel/drv/ii.conf\fR configuration
211 211 file determines the bitmap volume operational semantics as follows:
212 212 .sp
213 213 .ne 2
214 214 .na
215 215 \fB\fB0\fR\fR
216 216 .ad
217 217 .RS 13n
218 218 Indicates that the bitmap is maintained in memory only or resume operation.
219 219 .RE
220 220
221 221 .sp
222 222 .ne 2
223 223 .na
224 224 \fB\fB1\fR\fR
225 225 .ad
226 226 .RS 13n
227 227 Indicates that the bitmap is maintained in memory and on disk. This is the
228 228 default value.
229 229 .RE
230 230
231 231 .sp
232 232 .LP
233 233 If a system failure occurrs while using \fBii_bitmap=0\fR, the shadow volume
234 234 might be inconsistent and fast resynchronization would not be possible.
235 235 .sp
236 236 .LP
237 237 If Point-in-Time Copy is used in conjunction with the Network Storage component
238 238 Remote Mirror or in a Sun Cluster, set \fBii_bitmap=1\fR.
239 239 .sp
240 240 .LP
241 241 The \fBii_debug\fR variable in the \fB/usr/kernel/drv/ii.conf\fR configuration
242 242 file determines the amount of information logging that is output to the system
243 243 console \fB/dev/console\fR during Point-in-Time Copy processing.
244 244 .sp
245 245 .ne 2
246 246 .na
247 247 \fB\fB0\fR\fR
248 248 .ad
249 249 .RS 13n
250 250 Indicates that no logging is sent to the system console.
251 251 .RE
252 252
253 253 .sp
254 254 .ne 2
255 255 .na
256 256 \fB\fB1\fR\fR
257 257 .ad
258 258 .RS 13n
259 259 Indicates that informational logging is sent to the system console.
260 260 .RE
261 261
262 262 .sp
263 263 .ne 2
264 264 .na
265 265 \fB\fB2\fR\fR
266 266 .ad
267 267 .RS 13n
268 268 Indicates that developmental logging is sent to the system console.
269 269 .RE
270 270
271 271 .SH OPTIONS
272 272 .sp
273 273 .LP
274 274 The \fBiiadm\fR utility supports the following options.
275 275 .sp
276 276 .ne 2
277 277 .na
278 278 \fB\fB-e\fR\fB{ind|dep}\fR \fImaster_vol shadow_vol bitmap_vol\fR\fR
279 279 .ad
280 280 .sp .6
281 281 .RS 4n
282 282 Enable Point-in-Time Copy for the specified master, shadow, and bitmap volumes.
283 283 .sp
284 284 The enable shadow set processing assures that the specified volumes are
285 285 accessible, that the \fIshadow_vol\fR is not mounted, and that the
286 286 \fIbitmap_vol\fR is correctly sized for the type of shadow set being created.
287 287 Additionally, it assures that the volumes are under control of the SV driver (
288 288 if they are not, it puts them there), initializes the bitmap volume, and, if
289 289 the volume set is an independent shadow set, a full copy operation is
290 290 initiated.
291 291 .sp
292 292 On a successful enable, Point-in-Time Copy stores the specified
293 293 \fImaster_vol\fR, \fIshadow_vol\fR and \fIbitmap_vol\fR names, plus the
294 294 enabling type (\fBind\fR or \fBdep\fR), into the Point-in-Time Copy
295 295 configuration store. The configuration store contains all currently configured
296 296 Point-in-Time Copy Volume Sets and their associated configuration attributes.
297 297 (See discussion above on independent and dependent shadow volume semantics.)
298 298 .sp
299 299 \fImaster_vol\fR is the volume from which a point-in-time snapshot is made.
300 300 .sp
301 301 \fIshadow_vol\fR is the volume that contains the point-in-time snapshot.
302 302 .sp
303 303 \fIbitmap_vol\fR is used for tracking differences between the shadow and master
304 304 volumes. When Point-in-Time Copy shadow operations are suspended or resumed,
305 305 the bitmap volume (maintained in kernel memory) can be stored in or retrieved
306 306 from permanent storage. The storage associated with the bitmap volume should be
307 307 as redundant as that of the shadow volume storage.
308 308 .sp
309 309 The \fIshadow_vol\fR name is the name that the Point-in-Time Copy Shadow Set is
310 310 known by for all \fBiiadm\fR options requiring specification of a
311 311 \fIvolume_set\fR name.
312 312 .RE
313 313
314 314 .sp
315 315 .ne 2
316 316 .na
317 317 \fB\fB-d\fR \fIvolume_set\fR\fR
318 318 .ad
319 319 .sp .6
320 320 .RS 4n
321 321 Disable the Point-in-Time Copy volume set associated with the specified
322 322 \fIvolume_set\fR.
323 323 .sp
324 324 If Point-in-Time Copy was running in \fBindependent\fR mode as specified in the
325 325 \fB-e\fR \fBind\fR options, above, the shadow volume data contains the same
326 326 data as it did before it was disabled (assuming no writes have occurred). Users
327 327 can access the master and shadow volumes, as they are now standalone
328 328 point-in-time copies.
329 329 .sp
330 330 During the time that the full copy is active, an \fBindependent\fR volume
331 331 operates as though it is a \fBdependent\fR volume. To assure that the volume is
332 332 no longer in full copy mode, issue the following command to wait for the full
333 333 copy to complete:
334 334 .sp
335 335 .in +2
336 336 .nf
337 337 # iiadm -w \fIvolume_set\fR
338 338 .fi
339 339 .in -2
340 340 .sp
341 341
342 342 .RE
343 343
344 344 .sp
345 345 .ne 2
346 346 .na
347 347 \fB[\fB-p\fR] \fB-u\fR \fBs\fR \fIvolume_set\fR\fR
348 348 .ad
349 349 .sp .6
350 350 .RS 4n
351 351 Update the shadow volume from the master.
352 352 .sp
353 353 Updates a point-in-time copy of the master volume to the shadow volume.
354 354 \fIvolume_set\fR is the Point-in-Time Copy shadow set containing the master and
355 355 shadow volumes. This option provides a fast resynchronization of the shadow
356 356 volume, creating an incremental copy of the master. This update copies all 32KB
357 357 segments flagged as different between the master and shadow volumes. It does
358 358 not copy all master volume data, only changed data. While the data is being
359 359 copied, the shadow is dependent upon the master volume.
360 360 .sp
361 361 Before using this option, momentarily quiesce the workload to the volumes; stop
362 362 the host application from writing to the volumes. This ensures that the
363 363 point-in-time data is consistent. You can visually check the status of this
364 364 copy or update operation with \fBiiadm\fR \fB-i\fR \fIvolume_set\fR, or
365 365 interactively (by means of a shell or script) with \fBiiadm\fR \fB-w\fR
366 366 \fIvolume_set\fR, before using the target volume for any other operations.
367 367 .sp
368 368 This command supports PID (Process IDentifier) locking, by using the option
369 369 \fB-p\fR, \fBiiadm\fR \fB-p\fR \fB-u\fR \fBs\fR. Enabling this option prevents
370 370 other processes from taking a new point-in-time snapshot, thus invalidating
371 371 prior point-in-time data.
372 372 .RE
373 373
374 374 .sp
375 375 .ne 2
376 376 .na
377 377 \fB[\fB-p\fR] [\fB-n\fR] \fB-u\fR \fBm\fR \fIvolume_set\fR\fR
378 378 .ad
379 379 .sp .6
380 380 .RS 4n
381 381 Updates a point-in-time copy of the master volume from the shadow.
382 382 \fIvolume_set\fR is the Point-in-Time Copy volume set containing the master and
383 383 shadow. This option provides a fast resynchronization of the master volume,
384 384 creating an incremental copy of the shadow. This update copies all 32KB
385 385 segments flagged as different between the master and shadow volumes. It does
386 386 not copy all shadow volume data, only changed data. While the data is being
387 387 copied, the master is dependent upon the shadow volume.
388 388 .sp
389 389 Before using this option, momentarily quiesce the workload to the volumes; stop
390 390 the host application from writing to the volumes. This ensures that the
391 391 point-in-time data is consistent. You can visually check the status of this
392 392 copy or update operation with \fBiiadm\fR \fB-i\fR \fIvolume_set\fR, or
393 393 interactively (by means of a shell or script) with \fBiiadm\fR \fB-w\fR
394 394 \fIvolume_set\fR, before using the target volume for any other operations.
395 395 .sp
396 396 This command is query enabled to prevent accidentally overwriting the data on a
397 397 master volume. When this command option is used in scripts, add the \fB-n\fR
398 398 option to prevent the query from occurring.
399 399 .sp
400 400 This command supports PID (Process IDentifier) locking, by using the option
401 401 \fB-p\fR, \fBiiadm\fR \fB-p\fR \fB-u\fR \fBm\fR. Enabling this option prevents
402 402 other processes from taking a new point-in-time snapshot, thus invalidating
403 403 prior point-in-time data.
404 404 .RE
405 405
406 406 .sp
407 407 .ne 2
408 408 .na
409 409 \fB[\fB-p\fR] \fB-c\fR s \fIvolume_set\fR\fR
410 410 .ad
411 411 .sp .6
412 412 .RS 4n
413 413 Copy the master volume to the shadow.
414 414 .sp
415 415 Creates a point-in-time copy of the master volume to the shadow volume.
416 416 \fIvolume_set\fR is the Point-in-Time Copy volume set containing the master and
417 417 shadow. This option writes all data in the point-in-time copy of the master
418 418 volume to the shadow volume. While the data is being copied from master to
419 419 shadow, the shadow is dependent on the master volume.
420 420 .sp
421 421 This option performs a full volume copy. Use \fBiiadm\fR \fB-u\fR \fBs\fR
422 422 unless the integrity of the data on the independent shadow volume is in doubt.
423 423 Otherwise, use this option to synchronize the master and shadow volumes; that
424 424 is, make the data on each volume match.
425 425 .sp
426 426 Before using this option, momentarily quiesce the workload to the volumes; stop
427 427 the host application from writing to the volumes. This ensures that the
428 428 point-in-time data is consistent. You can visually check the status of this
429 429 copy or update operation with \fBiiadm\fR \fB-i\fR \fIvolume_set\fR, or
430 430 interactively (by means of a shell or script) with \fBiiadm\fR \fB-w\fR
431 431 \fIvolume_set\fR, before using the target volume for any other operations.
432 432 .sp
433 433 This command supports PID (Process IDentifier) locking, by using the \fB-p\fR
434 434 option, \fBiiadm\fR \fB-p\fR \fB-c\fR \fBs\fR. Enabling this option prevents
435 435 other processes from taking a new point-in-time snapshot, thus invalidating
436 436 prior point-in-time data.
437 437 .RE
438 438
439 439 .sp
440 440 .ne 2
441 441 .na
442 442 \fB\fB-c\fR \fBm\fR \fIvolume_set\fR\fR
443 443 .ad
444 444 .sp .6
445 445 .RS 4n
446 446 Copy the shadow volume to the master.
447 447 .sp
448 448 Creates a point-in-time copy of the shadow volume to the master volume.
449 449 \fIvolume_set\fR is the Point-in-Time Copy volume set containing the master and
450 450 shadow volumes. This option writes all data in the point-in-time copy of the
451 451 shadow volume to the master volume. While the data is being copied from the
452 452 shadow to the master, the master is dependent upon the shadow volume.
453 453 .sp
454 454 This option performs a full volume copy. Use \fBiiadm\fR \fB-u\fR \fBm\fR
455 455 unless the integrity of the data on the independent master is in doubt.
456 456 Otherwise, use this option to synchronize the master and shadow volumes; that
457 457 is, make the data on each volume match.
458 458 .sp
459 459 Before using this option, momentarily quiesce the workload to the volumes; stop
460 460 the host application from writing to the volumes. This ensures that the
461 461 point-in-time data is consistent. You can visually check the status of this
462 462 copy or update operation with \fBiiadm\fR \fB-i\fR \fIvolume_set\fR, or
463 463 interactively (by means of a shell or script) with \fBiiadm\fR \fB-w\fR
464 464 \fIvolume_set\fR, before using the target volume for any other operations.
465 465 .sp
466 466 This command is query-enabled to prevent accidentally overwriting the data on a
467 467 master volume. When this command option is used in scripts, add the \fB-n\fR
468 468 option to prevent the query from occurring.
469 469 .sp
470 470 This command supports PID (Process IDentifier) locking, by using the \fB-p\fR
471 471 option, \fBiiadm\fR \fB-p\fR \fB-c\fR \fBm\fR. Enabling this option prevents
472 472 other processes from taking a new point-in-time snapshot, thus invalidating
473 473 prior point-in-time data.
474 474 .RE
475 475
476 476 .sp
477 477 .ne 2
478 478 .na
479 479 \fB\fB-a\fR \fIvolume_set\fR\fR
480 480 .ad
481 481 .sp .6
482 482 .RS 4n
483 483 Abort any current copy operation that might be active between the master and
484 484 shadow volumes. \fIvolume_set\fR is the Point-in-Time Copy volume set
485 485 containing the master and shadow volumes. After executing \fBiiadm\fR \fB-a\fR,
486 486 the update or copy to the target (master or shadow) volume is incomplete. The
487 487 target volume is now a dependent copy of the source volume. Reissue the update
488 488 or copy command option to resynchronize the volumes.
489 489 .RE
490 490
491 491 .sp
492 492 .ne 2
493 493 .na
494 494 \fB\fB[\fR\fB-p\fR\fB] [\fR\fB-n\fR\fB] \fR\fB-w\fR \fIvolume_set\fR\fR
495 495 .ad
496 496 .sp .6
497 497 .RS 4n
498 498 Wait until any in-progress copy or update operation completes or is aborted.
499 499 \fIvolume_set\fR is the Point-in-Time Copy volume set containing the master and
500 500 shadow volumes.
501 501 .sp
502 502 This option waits until the current Point-in-Time Copy operation is complete,
503 503 thus preventing a subsequent \fBiiadm\fR command (from a shell or script) from
504 504 executing. Use this command option when you need to be sure the copy or update
505 505 operation has completed.
506 506 .sp
507 507 This command supports PID (Process IDentifier) unlocking. If a prior copy or
508 508 update, using a command \fBiiadm\fR \fB-p\fR \fB{\fR\fB-c\fR\fB|\fR\fB-u\fR\fB}
509 509 {m|s}\fR, was invoked with the \fB-p\fR option, upon completion of the wait
510 510 processing, if the current PID was the PID that locked the point-in-time data,
511 511 this option unlocks the data.
512 512 .RE
513 513
514 514 .sp
515 515 .ne 2
516 516 .na
517 517 \fB\fB-i\fR \fIvolume_set\fR\fR
518 518 .ad
519 519 .sp .6
520 520 .RS 4n
521 521 Display status for the Point-in-Time Copy currently-enabled or -suspended
522 522 volume set. \fIvolume_set\fR is the Point-in-Time Copy volume set containing
523 523 the master and shadow volumes. If no \fIvolume_set\fR is specified, status is
524 524 displayed for all Point-in-Time Copy volume sets that are configured.
525 525 .RE
526 526
527 527 .sp
528 528 .ne 2
529 529 .na
530 530 \fB\fB-l\fR\fR
531 531 .ad
532 532 .sp .6
533 533 .RS 4n
534 534 List all currently configured Point-in-Time Copy volumes.
535 535 .RE
536 536
537 537 .sp
538 538 .ne 2
539 539 .na
540 540 \fB\fB-O\fR \fIoverflow_vol\fR\fR
541 541 .ad
542 542 .sp .6
543 543 .RS 4n
544 544 This option causes Point-in-Time Copy to initialize the specified
545 545 \fIoverflow_vol\fR for subsequent use as an overflow volume in conjunction with
546 546 Compact Dependent Shadow Volumes. To facilitate efficient, shared usage of this
547 547 overflow volume, it can be associated with multiple Point-in-Time Copy volume
548 548 sets on an as-needed basis.
549 549 .sp
550 550 During initialization of the \fIoverflow_vol\fR, the initiator of this option,
551 551 must answer the following question: "Initialize this overflow volume? yes/no" A
552 552 response of either "yes/no" is required before proceeding.
553 553 .sp
554 554 This option supports the \fB-n\fR option, so that the requested action is
555 555 performed without prompting. This option is useful for inclusion in a script.
556 556 The \fB-n\fR option must be specified first. For example, "\fBiiadm\fR
557 557 \fB-nO\fR \fBvol\fR" is valid; "\fBiiadm\fR \fB-On\fR \fBvol\fR" is not.
558 558 .sp
559 559 Make sure you want to initialize the data on the specified \fIoverflow_vol\fR,
560 560 especially when using the \fB-n\fR option.
561 561 .RE
562 562
563 563 .sp
564 564 .ne 2
565 565 .na
566 566 \fB\fB-A\fR \fIoverflow_vol\fR \fIvolume_set\fR\fR
567 567 .ad
568 568 .sp .6
569 569 .RS 4n
570 570 This option enables the specified \fIoverflow_vol\fR, for subsequent use as an
571 571 overflow volume in a situation where the size of the Compact Dependent Shadow
572 572 Volume is too small, or an unscheduled amount of change occurs to the volume
573 573 set. Overflow changed data would be redirected to the associated overflow
574 574 volume. \fIvolume_set\fR is the Point-in-Time Copy volume set containing the
575 575 master and shadow volumes.
576 576 .sp
577 577 If the \fIoverflow_vol\fR has not been initialized, this option initializes the
578 578 \fIoverflow_vol\fR (see \fB-O\fR option), then attaches the \fIoverflow_vol\fR
579 579 to the \fIvolume_set\fR.
580 580 .sp
581 581 If \fIoverflow_vol\fR was previously initialized, this option attaches the
582 582 \fIoverflow_vol\fR to the \fIvolume_set\fR.
583 583 .sp
584 584 This option supports the \fB-n\fR option, so that the requested action is
585 585 performed without prompting. This option is useful for inclusion in a script.
586 586 The \fB-n\fR option must be specified first. For example, "\fBiiadm\fR
587 587 \fB-nA\fR \fBvol\fR" is valid; "\fBiiadm\fR \fB-An\fR \fBvol\fR" is not.
588 588 .sp
589 589 Make sure you want to initialize the data on the specified \fIoverflow_vol\fR,
590 590 especially when using the \fB-n\fR option.
591 591 .RE
592 592
593 593 .sp
594 594 .ne 2
595 595 .na
596 596 \fB\fB-D\fR \fIvolume_set\fR\fR
597 597 .ad
598 598 .sp .6
599 599 .RS 4n
600 600 This option removes the overflow volume currently associated with the specified
601 601 \fIvolume_set\fR. If the overflow volume is currently in use by the
602 602 \fIvolume_set\fR, this operation fails with an "Overflow volume still in use"
603 603 error message. To resolve this situation, perform one of the operations
604 604 described below on the \fIvolume_set\fR. These operations momentarily clear out
605 605 all overflow writes that are associated with this volume set.
606 606 .sp
607 607 .ne 2
608 608 .na
609 609 \fB\fBabort\fR(\fB-a\fR)\fR
610 610 .ad
611 611 .sp .6
612 612 .RS 4n
613 613 Abort copy operation.
614 614 .RE
615 615
616 616 .sp
617 617 .ne 2
618 618 .na
619 619 \fB\fBdisable\fR(\fB-d\fR)\fR
620 620 .ad
621 621 .sp .6
622 622 .RS 4n
623 623 Dissolve the volume set.
624 624 .RE
625 625
626 626 .sp
627 627 .ne 2
628 628 .na
629 629 \fB\fBupdate\fR(\fB-u\fR)\fR
630 630 .ad
631 631 .sp .6
632 632 .RS 4n
633 633 Update the volume set.
634 634 .RE
635 635
636 636 .RE
637 637
638 638 .sp
639 639 .ne 2
640 640 .na
641 641 \fB\fB-L\fR\fR
642 642 .ad
643 643 .sp .6
644 644 .RS 4n
645 645 This option lists all overflow volumes which are associated with one or more
646 646 volume sets.
647 647 .RE
648 648
649 649 .sp
650 650 .ne 2
651 651 .na
652 652 \fB\fB-Q\fR \fIoverflow_vol\fR\fR
653 653 .ad
654 654 .sp .6
655 655 .RS 4n
656 656 This option displays the current status of the \fIoverflow_vol\fR.
657 657 .RE
658 658
659 659 .sp
660 660 .ne 2
661 661 .na
662 662 \fB\fB-E\fR \fIvolume_set\fR\fR
663 663 .ad
664 664 .sp .6
665 665 .RS 4n
666 666 Export the independent shadow volume of the Point-in-Time Copy volume set
667 667 specified by \fIvolume_set\fR. The shadow volume is to be made available to
668 668 another host for read/write access, by means of an enabling technology, such as
669 669 multi-ported devices. This other host is responsible for maintaining a bitmap
670 670 of differences that is used to merge with locally recorded differences to the
671 671 master when the shadow volume is rejoined to its master volume. While a shadow
672 672 volume is exported it must not be subject to an update or copy operation.
673 673 Perform an \fBiiadm\fR \fB-w\fR \fIvolume_set\fR command prior to invoking an
674 674 export command.
675 675 .RE
676 676
677 677 .sp
678 678 .ne 2
679 679 .na
680 680 \fB\fB-I\fR \fIvolume_set\fR \fIbitmap_vol\fR\fR
681 681 .ad
682 682 .sp .6
683 683 .RS 4n
684 684 Import the independent shadow volume of the Point-in-Time Copy volume set
685 685 specified by \fIvolume_set\fR. The shadow volume must have been previously
686 686 exported from a host by means of an enabling technology, such as multi-ported
687 687 devices. The import operation causes this host to start maintaining a bitmap of
688 688 differences as the volume is modified. The \fIbitmap_vol\fR should not be the
689 689 same as that used when the shadow volume was originally formed into a shadow
690 690 group.
691 691 .sp
692 692 After the exported/imported independent shadow volume is no longer needed by
693 693 the other node, you must enter a disable command so that the \fIbitmap_vol\fR
694 694 and its associated \fIshadow_vol\fR are consistent, prior to performing a join
695 695 operation. For example,
696 696 .sp
697 697 .in +2
698 698 .nf
699 699 # iiadm -d \fIvolume_set\fR
700 700 .fi
701 701 .in -2
702 702 .sp
703 703
704 704 .RE
705 705
706 706 .sp
707 707 .ne 2
708 708 .na
709 709 \fB\fB-J\fR \fIvolume_set\fR \fIbitmap_vol\fR\fR
710 710 .ad
711 711 .sp .6
712 712 .RS 4n
713 713 Join the \fIvolume_set\fR, using the \fIbitmap_vol\fR, with the master volume
714 714 set of the Point-in-Time Copy volume set. The bitmap volume supplied is read
715 715 and merged with the original volume to reconstruct the original volume set
716 716 consisting of the master, shadow, and bitmap volumes. The \fIbitmap_vol\fR to
717 717 be merged is the one obtained on the node that had imported the independent
718 718 shadow volume. There must be no write activity to the shadow volume on the
719 719 importing machine from the time the bitmap is copied over until the shadow is
720 720 once again imported.
721 721 .RE
722 722
723 723 .sp
724 724 .ne 2
725 725 .na
726 726 \fB\fB-g\fR \fIgroup_name\fR \fB-m\fR \fIvolume_set [volume_set2 ...]\fR\fR
727 727 .ad
728 728 .sp .6
729 729 .RS 4n
730 730 Add one or more existing Point-in-Time Copy \fIvolume_set(s)\fR into a user
731 731 specified \fIgroup_name\fR. This association of one or more Point-in-Time Copy
732 732 volume sets in a group allows the list of \fBiiadm\fR options shown below to be
733 733 performed on all volume sets within the \fIgroup_name\fR as a whole.
734 734 .sp
735 735 Only the commands \fBCOPY\fR (\fB-c\fR) and \fBUPDATE\fR (\fB-u\fR) are
736 736 performed atomically across all Point-in-Time Copy sets within the group. All
737 737 other grouped, \fBiiadm\fR commands are performed sequentially on each member
738 738 of the group.
739 739 .sp
740 740 The syntax of an \fBiiadm\fR group command is as follows:
741 741 .sp
742 742 .in +2
743 743 .nf
744 744 iiadm -g \fIgroup_name\fR [\fIoptions\fR]
745 745 .fi
746 746 .in -2
747 747 .sp
748 748
749 749 The \fIoptions\fR are as follows:
750 750 .sp
751 751 .ne 2
752 752 .na
753 753 \fB\fB-a\fR\fR
754 754 .ad
755 755 .sp .6
756 756 .RS 4n
757 757 Abort copy operation on all sets within \fIgroup_name\fR.
758 758 .RE
759 759
760 760 .sp
761 761 .ne 2
762 762 .na
763 763 \fB\fB-A\fR\fR
764 764 .ad
765 765 .sp .6
766 766 .RS 4n
767 767 Attach \fIoverflow_vol\fR to all sets within \fIgroup_name\fR.
768 768 .RE
769 769
770 770 .sp
771 771 .ne 2
772 772 .na
773 773 \fB\fB-c\fR \fB{s | m}\fR\fR
774 774 .ad
775 775 .sp .6
776 776 .RS 4n
777 777 Copy shadow/master for all sets within \fIgroup_name\fR.
778 778 .RE
779 779
780 780 .sp
781 781 .ne 2
782 782 .na
783 783 \fB\fB-D\fR\fR
784 784 .ad
785 785 .sp .6
786 786 .RS 4n
787 787 Detach \fIoverflow_vol\fR from all sets within \fIgroup_name\fR.
788 788 .RE
789 789
790 790 .sp
791 791 .ne 2
792 792 .na
793 793 \fB\fB-d\fR\fR
794 794 .ad
795 795 .sp .6
796 796 .RS 4n
797 797 Disable all sets within \fIgroup_name\fR.
798 798 .RE
799 799
800 800 .sp
801 801 .ne 2
802 802 .na
803 803 \fB\fB-E\fR\fR
804 804 .ad
805 805 .sp .6
806 806 .RS 4n
807 807 Export all volume sets within \fIgroup_name\fR.
808 808 .RE
809 809
810 810 .sp
811 811 .ne 2
812 812 .na
813 813 \fB\fB-i\fR\fR
814 814 .ad
815 815 .sp .6
816 816 .RS 4n
817 817 Status of all volume sets within \fIgroup_name\fR.
818 818 .RE
819 819
820 820 .sp
821 821 .ne 2
822 822 .na
823 823 \fB\fB-l\fR\fR
824 824 .ad
825 825 .sp .6
826 826 .RS 4n
827 827 List all volume sets within \fIgroup_name\fR.
828 828 .RE
829 829
830 830 .sp
831 831 .ne 2
832 832 .na
833 833 \fB\fB-L\fR\fR
834 834 .ad
835 835 .sp .6
836 836 .RS 4n
837 837 List all groups.
838 838 .RE
839 839
840 840 .sp
841 841 .ne 2
842 842 .na
843 843 \fB\fB-n\fR\fR
844 844 .ad
845 845 .sp .6
846 846 .RS 4n
847 847 Do not ask if an update of the master volume is what the user really intended.
848 848 .RE
849 849
850 850 .sp
851 851 .ne 2
852 852 .na
853 853 \fB\fB-P\fR\fR
854 854 .ad
855 855 .sp .6
856 856 .RS 4n
857 857 Set parameters on all volume sets within \fIgroup_name\fR.
858 858 .RE
859 859
860 860 .sp
861 861 .ne 2
862 862 .na
863 863 \fB\fB-R\fR\fR
864 864 .ad
865 865 .sp .6
866 866 .RS 4n
867 867 Reset all volume sets within \fIgroup_name\fR.
868 868 .RE
869 869
870 870 .sp
871 871 .ne 2
872 872 .na
873 873 \fB\fB-u\fR \fB{s | m}\fR\fR
874 874 .ad
875 875 .sp .6
876 876 .RS 4n
877 877 Update shadow/master for all sets within \fIgroup_name\fR.
878 878 .RE
879 879
880 880 .sp
881 881 .ne 2
882 882 .na
883 883 \fB\fB-w\fR\fR
884 884 .ad
|
↓ open down ↓ |
868 lines elided |
↑ open up ↑ |
885 885 .sp .6
886 886 .RS 4n
887 887 Wait for all volume sets within \fIgroup_name\fR.
888 888 .RE
889 889
890 890 .RE
891 891
892 892 .sp
893 893 .ne 2
894 894 .na
895 -\fB\fB-g\fR \fB-" "\fR \fB-m\fR \fIvolume_set\fR [\fIvolume_set2 ...\fR]\fR
895 +\fB\fB-g\fR \fB""\fR \fB-m\fR \fIvolume_set\fR [\fIvolume_set2 ...\fR]\fR
896 896 .ad
897 897 .sp .6
898 898 .RS 4n
899 899 Remove one or more existing Point-in-Time Copy \fIvolume_set(s)\fR from their
900 900 currently associated \fIgroup_name\fR. By default, or until moved into a user
901 901 specified \fIgroup_name\fR, all Point-in-Time Copy \fIvolume_set(s)\fR are in
902 902 the blank (\fB" "\fR) group. This association allows all the previously
903 903 documented \fBiiadm\fR group commands to be performed against the blank (\fB"
904 904 "\fR) \fBiiadm\fR \fIgroup_name\fR.
905 905 .RE
906 906
907 907 .sp
908 908 .ne 2
909 909 .na
910 910 \fB\fB-C\fR \fIcluster_tag\fR\fR
911 911 .ad
912 912 .sp .6
913 913 .RS 4n
914 914 This Point-in-Time Copy option is a modifier that limits configuration
915 915 operations to only those volumes belonging to a Sun Cluster Resource Group, or
916 916 Disk Group.
917 917 .sp
918 918 In a Sun Cluster where the volume manager is Sun Cluster-aware, \fBiiadm\fR
919 919 automatically obtains the correct Disk Group information, therefore this option
920 920 is typically not required unless the volumes are part of an encompassing
921 921 Resource Group.
922 922 .sp
923 923 In a Sun Cluster where the volumes are accessible on the local node only, the
924 924 special \fIcluster_tag\fR of \fBlocal\fR is used to indicate volumes that are
925 925 not part of a Sun Cluster Resource Group or Disk Group.
926 926 .sp
927 927 If "\fB-L\fR" is given as a the \fIcluster_tag\fR argument, then \fBiiadm\fR
928 928 lists all cluster tags associated with Point-in-Time Copy.
929 929 .sp
930 930 This option is invalid when used on a Solaris system on which the Sun Cluster
931 931 package has not been installed or configured.
932 932 .RE
933 933
934 934 .sp
935 935 .ne 2
936 936 .na
937 937 \fB\fB-h\fR\fR
938 938 .ad
939 939 .sp .6
940 940 .RS 4n
941 941 Prints the \fBiiadm\fR usage summary.
942 942 .RE
943 943
944 944 .sp
945 945 .ne 2
946 946 .na
947 947 \fB\fB-v\fR\fR
948 948 .ad
949 949 .sp .6
950 950 .RS 4n
951 951 Display the current version of the Point-in-Time Copy software components.
952 952 .RE
953 953
954 954 .sp
955 955 .LP
956 956 Contact Sun Enterprise Services for assistance in using the remaining commands
957 957 in this section.
958 958 .sp
959 959 .ne 2
960 960 .na
961 961 \fB\fB-P\fR \fIdelay\fR \fIunit\fR \fIvolume_set\fR\fR
962 962 .ad
963 963 .sp .6
964 964 .RS 4n
965 965 Alter the Point-in-Time Copy volume set tuning parameters for the specified
966 966 \fIvolume_set\fR to \fIdelay\fR ticks, every \fIunit\fR I/O's. Delay ranges
967 967 from 2 to 10000 inclusive; unit ranges from 100 to 60000 inclusive.
968 968 .RE
969 969
970 970 .sp
971 971 .ne 2
972 972 .na
973 973 \fB\fB-R\fR \fIvolume\fR\fR
974 974 .ad
975 975 .sp .6
976 976 .RS 4n
977 977 After a volume has failed, Point-in-Time Copy places it offline. After
978 978 replacing the volume, place it back online using this option. Associated
979 979 dependent volumes in the Point-in-Time Copy volume set are also placed online.
980 980 After the volume is placed online, this command also starts any necessary
981 981 point-in-time volume updates.
982 982 .RE
983 983
984 984 .SH EXIT STATUS
985 985 .sp
986 986 .ne 2
987 987 .na
988 988 \fB\fB0\fR\fR
989 989 .ad
990 990 .RS 13n
991 991 Command completed successfully.
992 992 .RE
993 993
994 994 .sp
995 995 .ne 2
996 996 .na
997 997 \fB\fB>0\fR\fR
998 998 .ad
999 999 .RS 13n
1000 1000 An error occurred.
1001 1001 .RE
1002 1002
1003 1003 .SH ATTRIBUTES
1004 1004 .sp
1005 1005 .LP
1006 1006 See \fBattributes\fR(5) for descriptions of the following attributes:
1007 1007 .sp
1008 1008
1009 1009 .sp
1010 1010 .TS
1011 1011 box;
1012 1012 c | c
1013 1013 l | l .
1014 1014 ATTRIBUTE TYPE ATTRIBUTE VALUE
1015 1015 _
1016 1016 Interface Stability Evolving
1017 1017 .TE
1018 1018
1019 1019 .SH SEE ALSO
1020 1020 .sp
1021 1021 .LP
1022 1022 \fBdscfg\fR(1M), \fBsvadm\fR(1M), \fBds.log\fR(4), \fBrdc.cf\fR(4),
1023 1023 \fBattributes\fR(5), \fBii\fR(7D), \fBsv\fR(7D)
|
↓ open down ↓ |
118 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX