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