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 SNDRADM 1M "Oct 2, 2007"
7 .SH NAME
8 sndradm \- control Sun StorageTek Availability Suite Remote Mirror operations
9 .SH SYNOPSIS
10 .LP
11 .nf
12 \fBsndradm\fR \fB-I\fR a \fImaster\fR \fIshadow\fR \fIbitmap\fR
13 .fi
14
15 .LP
16 .nf
17 \fBsndradm\fR \fB-I\fR d \fImaster\fR \fIshadow\fR \fIbitmap\fR
18 .fi
19
20 .LP
21 .nf
22 \fBsndradm\fR \fB-h\fR \fIusage message\fR
23 .fi
24
25 .LP
26 .nf
27 \fBsndradm\fR \fB-v\fR \fIversion information\fR
28 .fi
29
30 .LP
31 .nf
32 \fBsndradm\fR [\fIoptions\fR] \fB-e\fR [\fIsndr_set\fR]
33 .fi
34
35 .LP
36 .nf
37 \fBsndradm\fR [\fIoptions\fR] \fB-E\fR [\fIsndr_set\fR]
38 .fi
39
40 .LP
41 .nf
42 \fBsndradm\fR [\fIoptions\fR] \fB-d\fR [\fIsndr_set\fR]
43 .fi
44
45 .LP
46 .nf
47 \fBsndradm\fR [\fIoptions\fR] \fB-D\fR block [\fIsndr_set\fR]
48 .fi
49
50 .LP
51 .nf
52 \fBsndradm\fR [\fIoptions\fR] \fB-D\fR noblock [\fIsndr_set\fR]
53 .fi
54
55 .LP
56 .nf
57 \fBsndradm\fR [\fIoptions\fR] \fB-l\fR [\fIsndr_set\fR]
58 .fi
59
60 .LP
61 .nf
62 \fBsndradm\fR [\fIoptions\fR] \fB-m\fR [\fIsndr_set\fR]
63 .fi
64
65 .LP
66 .nf
67 \fBsndradm\fR [\fIoptions\fR] \fB-m\fR \fB-r\fR [\fIsndr_set\fR]
68 .fi
69
70 .LP
71 .nf
72 \fBsndradm\fR [\fIoptions\fR] \fB-u\fR [\fIsndr_set\fR]
73 .fi
74
75 .LP
76 .nf
77 \fBsndradm\fR [\fIoptions\fR] \fB-u\fR \fB-r\fR [\fIsndr_set\fR]
78 .fi
79
80 .LP
81 .nf
82 \fBsndradm\fR [\fIoptions\fR] \fB-w\fR [\fIsndr_set\fR]
83 .fi
84
85 .LP
86 .nf
87 \fBsndradm\fR [\fIoptions\fR] \fB-H\fR [\fIsndr_set\fR]
88 .fi
89
90 .LP
91 .nf
92 \fBsndradm\fR [\fIoptions\fR] \fB-p\fR [\fIsndr_set\fR]
93 .fi
94
95 .LP
96 .nf
97 \fBsndradm\fR [\fIoptions\fR] \fB-P\fR [\fIsndr_set\fR]
98 .fi
99
100 .LP
101 .nf
102 \fBsndradm\fR [\fIoptions\fR] \fB-q\fR a \fIvolume\fR [\fIsndr_set\fR]
103 .fi
104
105 .LP
106 .nf
107 \fBsndradm\fR [\fIoptions\fR] \fB-q\fR d [\fIsndr_set\fR]
108 .fi
109
110 .LP
111 .nf
112 \fBsndradm\fR [\fIoptions\fR] \fB-q\fR r \fIvolume\fR [\fIsndr_set\fR]
113 .fi
114
115 .LP
116 .nf
117 \fBsndradm\fR [\fIoptions\fR] \fB-i\fR [\fIsndr_set\fR]
118 .fi
119
120 .LP
121 .nf
122 \fBsndradm\fR [\fIoptions\fR] \fB-a\fR \fIvalue\fR [\fIsndr_set\fR]
123 .fi
124
125 .LP
126 .nf
127 \fBsndradm\fR [\fIoptions\fR] \fB-A\fR \fIvalue\fR [\fIsndr_set\fR]
128 .fi
129
130 .LP
131 .nf
132 \fBsndradm\fR [\fIoptions\fR] \fB-F\fR \fIvalue\fR [\fIsndr_set\fR]
133 .fi
134
135 .LP
136 .nf
137 \fBsndradm\fR [\fIoptions\fR] \fB-W\fR \fIvalue\fR [\fIsndr_set\fR]
138 .fi
139
140 .LP
141 .nf
142 \fBsndradm\fR [\fIoptions\fR] \fB-R\fR
143 .fi
144
145 .LP
146 .nf
147 \fBsndradm\fR [\fIoptions\fR] \fB-R\fR b p \fIbitmap\fR [\fIsndr_set\fR]
148 .fi
149
150 .LP
151 .nf
152 \fBsndradm\fR [\fIoptions\fR] \fB-R\fR b s \fIbitmap\fR [\fIsndr_set\fR]
153 .fi
154
155 .LP
156 .nf
157 \fBsndradm\fR [\fIoptions\fR] \fB-R\fR C \fItag\fR [\fIsndr_set\fR]
158 .fi
159
160 .LP
161 .nf
162 \fBsndradm\fR [\fIoptions\fR] \fB-R\fR g \fIio_groupname\fR [\fIsndr_set\fR]
163 .fi
164
165 .LP
166 .nf
167 \fBsndradm\fR [\fIoptions\fR] \fB-R\fR m sync [\fIsndr_set\fR]
168 .fi
169
170 .LP
171 .nf
172 \fBsndradm\fR [\fIoptions\fR] \fB-R\fR m async [\fIsndr_set\fR]
173 .fi
174
175 .LP
176 .nf
177 \fBsndradm\fR [\fIoptions\fR] \fB-R\fR \fB-f\fR \fIvolset-file\fR
178 .fi
179
180 .LP
181 .nf
182 \fBsndradm\fR [\fIoptions\fR] \fB-R\fR r [\fIsndr_set\fR] *
183 .fi
184
185 .SH DESCRIPTION
186 .sp
187 .LP
188 The \fB/usr/sbin/sndradm\fR command is the administrative command line
189 interface for the Sun StorageTek Availability Suite Remote Mirror software.
190 Remote Mirror enables you to replicate disks between different
191 physically-separate Sun servers in real time. Remote Mirror is conceptually
192 similar to the local disk mirroring scheme of RAID 1 but it performs its
193 replication operations over longer distances.
194 .sp
195 .LP
196 If you do not specify a Remote Mirror set (\fIsndr_set\fR) on the command line,
197 \fBsndradm\fR operates on all configured Remote Mirror sets.
198 .sp
199 .LP
200 The \fBsndradm\fR command generates an entry in the Availability Suite log
201 file, \fB/var/adm/ds.log\fR (see \fBds.log\fR(4)), for all operations except
202 print (\fB-p\fR, \fB-P\fR and \fB-i\fR), help (\fB-h\fR), and version
203 (\fB-v\fR).
204 .SH OPTIONS
205 .sp
206 .LP
207 The \fBsndradm\fR utility supports the following options:
208 .sp
209 .ne 2
210 .na
211 \fB\fB-f\fR \fIvolset-file\fR\fR
212 .ad
213 .sp .6
214 .RS 4n
215 Specifies a file containing the \fIsndr_set\fR information for one or more
216 Remote Mirror sets in the same format as the fully specified command line
217 \fIsndr_set\fR documented below.
218 .RE
219
220 .sp
221 .ne 2
222 .na
223 \fB\fB-g\fR \fIio_groupname\fR\fR
224 .ad
225 .sp .6
226 .RS 4n
227 Limits operations to only those Remote Mirror sets belonging to
228 \fIio_groupname\fR.
229 .sp
230 The \fIio_groupname\fR for a given set must be consistent across both the
231 primary and the secondary hosts.
232 .RE
233
234 .sp
235 .ne 2
236 .na
237 \fB\fB-C\fR \fItag\fR\fR
238 .ad
239 .sp .6
240 .RS 4n
241 On a clustered node, limits operations to only those Remote Mirror sets
242 belonging to the cluster resource group or disk group name specified by
243 \fItag\fR. This option is not valid on a system that is not clustered.
244 .RE
245
246 .sp
247 .ne 2
248 .na
249 \fB\fB-n\fR\fR
250 .ad
251 .sp .6
252 .RS 4n
253 Does not prompt the user after starting a Remote Mirror operation using
254 \fBsndradm\fR. For all but the printing, help, and version options, the default
255 behavior is to prompt for a response. For example, after starting a full
256 synchronization from the primary to the secondary volume, Remote Mirror
257 prompts: \fB"Overwrite secondary with primary? (Y/N) [N]"\fR.
258 .RE
259
260 .sp
261 .ne 2
262 .na
263 \fB\fIsndr_set\fR\fR
264 .ad
265 .sp .6
266 .RS 4n
267 Specifies the Remote Mirror set. For a set that has already been enabled, this
268 can be a \fBset_name\fR in the format \fIshost\fR:\fIsdev\fR. You can supply a
269 fully specified Remote Mirror set in the same format as a configuration file:
270 .sp
271 .in +2
272 .nf
273 \fIphost pdev pbitmap shost sdev sbitmap\fR \fBip\fR {\fBsync | async\fR} \e
274 [g \fIio_groupname\fR] [C \fItag\fR]
275 .fi
276 .in -2
277
278 These parameters are described as follows:
279 .sp
280 .ne 2
281 .na
282 \fB\fIphost\fR\fR
283 .ad
284 .sp .6
285 .RS 4n
286 Specifies the server on which the primary volume resides.
287 .RE
288
289 .sp
290 .ne 2
291 .na
292 \fB\fIpdev\fR\fR
293 .ad
294 .sp .6
295 .RS 4n
296 Specifies the primary volume partition to be replicated. Specify full pathnames
297 only (for example, \fB/dev/rdsk/c0t1d0s2\fR).
298 .RE
299
300 .sp
301 .ne 2
302 .na
303 \fB\fIpbitmap\fR\fR
304 .ad
305 .sp .6
306 .RS 4n
307 Specifies the volume partition on which the bitmap (scoreboard log) of the
308 primary partition is stored. Specify full pathnames only (for example,
309 \fB/dev/rdsk/c0t1d0s3\fR).
310 .RE
311
312 .sp
313 .ne 2
314 .na
315 \fB\fIshost\fR\fR
316 .ad
317 .sp .6
318 .RS 4n
319 Specifies the server on which the secondary volume resides.
320 .RE
321
322 .sp
323 .ne 2
324 .na
325 \fB\fIsdev\fR\fR
326 .ad
327 .sp .6
328 .RS 4n
329 Specifies the secondary volume partition. Specify full path names only (for
330 example, \fB/dev/rdsk/c0t1d0s4\fR).
331 .RE
332
333 .sp
334 .ne 2
335 .na
336 \fB\fIsbitmap\fR\fR
337 .ad
338 .sp .6
339 .RS 4n
340 Specifies the volume partition on which the bitmap (scoreboard log) of the
341 secondary partition is stored. Specify full path names only (for example,
342 \fB/dev/rdsk/c0t1d0s5\fR).
343 .RE
344
345 .sp
346 .ne 2
347 .na
348 \fB\fBip\fR\fR
349 .ad
350 .sp .6
351 .RS 4n
352 Specifies the network transfer protocol.
353 .RE
354
355 .sp
356 .ne 2
357 .na
358 \fB\fBsync | async\fR\fR
359 .ad
360 .sp .6
361 .RS 4n
362 Specifies the Remote Mirror operating mode. \fBsync\fR is the Remote Mirror
363 mode where the I/O operation is not confirmed as complete until the remote
364 volume has been updated. \fBasync\fR is the Remote Mirror mode where the
365 primary host I/O operation is confirmed as complete before updating the remote
366 volume.
367 .RE
368
369 .sp
370 .ne 2
371 .na
372 \fB\fIio_groupname\fR\fR
373 .ad
374 .sp .6
375 .RS 4n
376 Specifies the name of the Remote Mirror consistency group to which the Remote
377 Mirror set belongs. In asynchronous mode, write ordering must be preserved
378 across all replicating volumes in a Remote Mirror consistency group. This
379 ensures that the secondary volumes belonging to the group contains a valid
380 point-in-time copy of the corresponding primary volumes.
381 .sp
382 When adding an existing set to a consistency group or when enabling a set to be
383 in a group, the set must be configured with the same group name on both the
384 primary and the secondary hosts.
385 .RE
386
387 .sp
388 .ne 2
389 .na
390 \fB\fItag\fR\fR
391 .ad
392 .sp .6
393 .RS 4n
394 For operation within a cluster, this specifies the disk group name or resource
395 tag of the local data and bitmap volumes in cases where this is not implied by
396 the name of the volume (for example, \fB/dev/rdsk/md/dg/vol\fR and
397 \fB/dev/vx/rdsk/dg/vol\fR both indicate a disk group name of \fBdg\fR). It is
398 the responsibility of the user to ensure that the cluster tag specified to the
399 Remote Mirror matches the appropriate cluster resource group tag, and to keep
400 all the Availability Suite services up to date in the event of cluster resource
401 group reconfigurations. It is illegal to specify the cluster resource tag on a
402 system that is not clustered.
403 .RE
404
405 .RE
406
407 .SH PARAMETERS
408 .sp
409 .LP
410 A valid \fBsndradm\fR command must specify one of the parameters listed below.
411 .sp
412 .ne 2
413 .na
414 \fB\fB-I\fR \fBa\fR \fImaster\fR \fIshadow\fR \fIbitmap\fR\fR
415 .ad
416 .sp .6
417 .RS 4n
418 Add an \fBndr_ii\fR entry with the specified master, shadow, and bitmap to the
419 Availability Suite configuration file. See \fBsndrsyncd\fR(1M). If the
420 corresponding Point-in-Time Copy set does not exist, it is enabled when the
421 next \fBsync\fR command is issued on the related volume(s). When no longer
422 required, this Point-in-Time Copy set can be disabled by \fBiiadm\fR \fB-d\fR.
423 See \fBiiadm\fR(1M)
424 .RE
425
426 .sp
427 .ne 2
428 .na
429 \fB\fB-I\fR \fBd\fR \fImaster\fR \fB\fIshadow\fR\fR \fB\fIbitmap\fR\fR\fR
430 .ad
431 .sp .6
432 .RS 4n
433 Delete the \fBndr_ii\fR entry with the specified master, shadow, and bitmap
434 from the Availability Suite configuration file. Use the \fBdscfg\fR command to
435 list \fBndr_ii\fR configuration entries.
436 .RE
437
438 .sp
439 .ne 2
440 .na
441 \fB\fB-a\fR \fIvalue\fR\fR
442 .ad
443 .sp .6
444 .RS 4n
445 Specifies the value, on or off, of the automatic sync variable for the set.
446 Once \fBautosync\fR has been requested for a set, the functionality is active
447 from the time a sync operation is requested until the set is manually put into
448 logging mode. Once the set is manually put into logging mode, the
449 \fBautosync\fR functionality is not active and remains inactive until the next
450 time a \fBsync\fR request is made. To check whether \fBautosync\fR is active,
451 use \fBsndradm\fR \fB-P\fR. To check whether autosync has been requested for a
452 set, look for the"\fBauto=on;\fR" tag for the set in the output of \fBdscfg\fR
453 \fB-l\fR. See \fBsndrsyncd\fR(1M).
454 .RE
455
456 .sp
457 .ne 2
458 .na
459 \fB\fB-A\fR \fIvalue\fR\fR
460 .ad
461 .sp .6
462 .RS 4n
463 Specifies the maximum number of threads that can be created to process the
464 asynchronous queue when a set is replicating in asynchronous mode. The default
465 is \fB2\fR.
466 .RE
467
468 .sp
469 .ne 2
470 .na
471 \fB\fB-W\fR \fIvalue\fR\fR
472 .ad
473 .sp .6
474 .RS 4n
475 Specifies the maximum number of writes that can be queued to a set replicating
476 in asynchronous mode. The default is \fB4096\fR. For example, set this value to
477 1 to ensure that the secondary volume is never more than one write operation
478 behind the primary volume.
479 .sp
480 Tuning the maximum number of writes is only valid for sets using memory-based
481 async I/O queues. This value is ignored when disk based I/O queues are used.
482 .RE
483
484 .sp
485 .ne 2
486 .na
487 \fB\fB-D\fR \fB{block\fR \fB|\fR \fBnoblock}\fR\fR
488 .ad
489 .sp .6
490 .RS 4n
491 Toggles the \fBblock\fR|\fBnoblock\fR attribute of a disk-based queue. The
492 default setting is \fBblock\fR. If the I/O fill rate is larger than the drain
493 rate for enough time for the queue to fill, incoming I/O is blocked until there
494 is adequate space on the queue for it. This is to preserve write ordering
495 whether it is one volume or across many volumes in the same consistency group.
496 If \fBnoblock\fR is set, and incoming I/O fills the queue, the I/O is not
497 blocked. Instead, the set is put into logging and the disk queue contents are
498 disregarded. An ensuing update sync synchronizes the latest data to the
499 secondary site.
500 .RE
501
502 .sp
503 .ne 2
504 .na
505 \fB\fB-F\fR \fIvalue\fR\fR
506 .ad
507 .sp .6
508 .RS 4n
509 Specifies the maximum number of 512-byte FBAs that can be queued in kernel
510 memory to a set replicating in asynchronous mode. The default is \fB16384\fR.
511 .sp
512 Tuning the maximum number of FBAs is valid only for sets using memory-based
513 async I/O queues. This value isignored when disk-based I/O queues are used.
514 .RE
515
516 .sp
517 .ne 2
518 .na
519 \fB\fB-h\fR\fR
520 .ad
521 .sp .6
522 .RS 4n
523 Prints the \fBsndradm\fR usage summary.
524 .RE
525
526 .sp
527 .ne 2
528 .na
529 \fB\fB-v\fR\fR
530 .ad
531 .sp .6
532 .RS 4n
533 Prints the Remote Mirror version number.
534 .RE
535
536 .sp
537 .ne 2
538 .na
539 \fB\fB-e\fR\fR
540 .ad
541 .sp .6
542 .RS 4n
543 Enables Remote Mirror for the set and enables scoreboard logging. The
544 scoreboard is set to indicate that a full synchronization is required. Details
545 of the set are saved in the current configuration. See \fBdscfg\fR(1M). The
546 local volume and the bitmap volume are enabled for the Storage Volume driver
547 (see \fBsv\fR(7D)).
548 .RE
549
550 .sp
551 .ne 2
552 .na
553 \fB\fB-E\fR\fR
554 .ad
555 .sp .6
556 .RS 4n
557 Enables Remote Mirror for the set and enables scoreboard logging. The
558 scoreboard is cleared to indicate that the primary and secondary volumes are
559 already guaranteed to be fully synchronized. Details of the set are saved in
560 the current configuration. See \fBdscfg\fR(1M). The local volume and the bitmap
561 volume are enabled for the Storage Volume driver (see \fBsv\fR(7D)).
562 .RE
563
564 .sp
565 .ne 2
566 .na
567 \fB\fB-d\fR\fR
568 .ad
569 .sp .6
570 .RS 4n
571 Disables Remote Mirror for the set and halts any current synchronization
572 operations. \fBsndradm\fR \fB-d\fR also discards any active scoreboards that
573 track temporary differences between primary and secondary volumes.
574 .RE
575
576 .sp
577 .ne 2
578 .na
579 \fB\fB-l\fR\fR
580 .ad
581 .sp .6
582 .RS 4n
583 Stops Remote Mirror replication and copy operations between primary and
584 secondary volumes and starts independent Remote Mirror scoreboard logging on
585 these volumes. When all the sets in a consistency group are replicating, it
586 means that the secondary volumes contain a valid point-in-time copy of the
587 corresponding primary volumes. Under this condition, as soon as one Remote
588 Mirror set drops into logging mode, the \fBrdc\fR kernel module drops all the
589 other sets in the group into logging mode automatically. This ensures that the
590 secondary volumes still contains a valid point-in-time copy. To resume the
591 Remote Mirror after using the \fB-l\fR parameter, use the \fB-m\fR parameter to
592 perform a full resynchronization or the \fB-u\fR parameter to perform an update
593 resynchronization (based on the scoreboard).
594 .sp
595 This option does not work on the secondary for any volumes that are currently
596 synchronizing.
597 .RE
598
599 .sp
600 .ne 2
601 .na
602 \fB\fB-w\fR\fR
603 .ad
604 .sp .6
605 .RS 4n
606 Waits for a synchronization copy to complete or abort, or returns immediately
607 if invoked on the secondary system.
608 .RE
609
610 .sp
611 .ne 2
612 .na
613 \fB\fB-H\fR\fR
614 .ad
615 .sp .6
616 .RS 4n
617 Reports on the health of the network link used by the specified volume set. The
618 health of the link is reported as active or inactive. Active means that the
619 network link is actively being used for replicating or resynchronizing data,
620 and is therefore in good health. Inactive means that the network link is not
621 actively being used for replicating or resynchronizing data, which might
622 indicate a problem with the link.
623 .RE
624
625 .sp
626 .ne 2
627 .na
628 \fB\fB-p\fR\fR
629 .ad
630 .sp .6
631 .RS 4n
632 Displays a list of configured Remote Mirror volumes or sets.
633 .RE
634
635 .sp
636 .ne 2
637 .na
638 \fB\fB-P\fR\fR
639 .ad
640 .sp .6
641 .RS 4n
642 Displays a list of configured Remote Mirror volumes or sets with extra details.
643 (See state descriptions, below.)
644 .RE
645
646 .sp
647 .ne 2
648 .na
649 \fB\fB-q\fR \fBa\fR \fIvolume\fR\fR
650 .ad
651 .sp .6
652 .RS 4n
653 Add a disk queue to a set or group. This operation is valid when the set or
654 group is in logging mode.
655 .RE
656
657 .sp
658 .ne 2
659 .na
660 \fB\fB-q\fR \fBd\fR\fR
661 .ad
662 .sp .6
663 .RS 4n
664 Remove a disk queue from a set or group. This operation is valid when the set
665 or group is in logging mode.
666 .RE
667
668 .sp
669 .ne 2
670 .na
671 \fB\fB-q\fR \fBr\fR \fIvolume\fR\fR
672 .ad
673 .sp .6
674 .RS 4n
675 Replace a disk queue for a group or set. The queue is removed from the set or
676 group as in the queue-disable operation and the new disk queue is added as in
677 the queue-add operation. This operation is valid when the set or group is in
678 logging mode.
679 .RE
680
681 .sp
682 .ne 2
683 .na
684 \fB\fB-i\fR\fR
685 .ad
686 .sp .6
687 .RS 4n
688 Displays a list of configured Remote Mirror volumes or sets in the same format
689 as the \fIvolset-file\fR.
690 .RE
691
692 .sp
693 .ne 2
694 .na
695 \fB\fB-R\fR\fR
696 .ad
697 .sp .6
698 .RS 4n
699 Attempt to reset a Remote Mirror set's error condition such as failed bitmaps.
700 .RE
701
702 .sp
703 .ne 2
704 .na
705 \fB\fB-R\fR \fBb\fR \fBp\fR \fIbitmap\fR\fR
706 .ad
707 .sp .6
708 .RS 4n
709 Reconfigure a Remote Mirror set's primary bitmap. This command should be
710 entered on both primary and secondary servers. It is only possible to
711 reconfigure the primary bitmap for one set at a time.
712 .RE
713
714 .sp
715 .ne 2
716 .na
717 \fB\fB-R\fR \fBb\fR \fBs\fR \fIbitmap\fR\fR
718 .ad
719 .sp .6
720 .RS 4n
721 Reconfigure a Remote Mirror set's secondary bitmap. This command should be
722 entered on both primary and secondary servers. It is only possible to
723 reconfigure the secondary bitmap for one set at a time.
724 .RE
725
726 .sp
727 .ne 2
728 .na
729 \fB\fB-R\fR \fBC\fR \fItag\fR\fR
730 .ad
731 .sp .6
732 .RS 4n
733 Reconfigure the cluster tag, or disk group name, of a Remote Mirror set's local
734 volumes, in those cases where this is not indicated by the pathname. This does
735 not affect the remote volumes. This parameter cannot be used on a system that
736 is not clustered.
737 .RE
738
739 .sp
740 .ne 2
741 .na
742 \fB\fB-R\fR \fBm\fR \fB{sync\fR \fB|\fR \fBasync}\fR\fR
743 .ad
744 .sp .6
745 .RS 4n
746 Reconfigure the replication mode of a Remote Mirror set. The sets belonging to
747 a consistency group must be either all synchronous or all asynchronous. It is
748 not possible to mix modes within a group.
749 .RE
750
751 .sp
752 .ne 2
753 .na
754 \fB\fB-R\fR \fBg\fR \fIgroup\fR\fR
755 .ad
756 .sp .6
757 .RS 4n
758 Reconfigure the consistency group of a Remote Mirror set. This command should
759 be entered with the same group name on both primary and secondary servers.
760 .sp
761 To remove a set from a consistency group, specify the null string (" ") when
762 reconfiguring the consistency group.
763 .RE
764
765 .sp
766 .LP
767 The following parameters can be issued only from the primary server:
768 .sp
769 .ne 2
770 .na
771 \fB\fB-m\fR\fR
772 .ad
773 .sp .6
774 .RS 4n
775 Starts a full volume copy from the primary volume to the secondary volume, and
776 concurrently enables Remote Mirror replication of new updates from the primary
777 volume to the secondary volume. Use this parameter when the primary and
778 secondary volumes might be different and no logging information exists to
779 incrementally resynchronize the volumes. See EXIT STATUS.
780 .RE
781
782 .sp
783 .ne 2
784 .na
785 \fB\fB-r\fR\fR
786 .ad
787 .sp .6
788 .RS 4n
789 Reverses the direction of the synchronization so the primary volume is
790 synchronized from the secondary volume. Use this parameter with the \fB-m\fR or
791 \fB-u\fR parameter. \fB-m\fR \fB-r\fR starts a full volume copy from the
792 secondary (source) volume to the primary (target) volume but concurrently
793 enables Remote Mirror replication of new updates from the primary (source)
794 volume to the secondary (target) volume, ensuring the volume sets remain
795 synchronized. Use \fB-m\fR \fB-r\fR when the primary and secondary volume
796 content might differ and the secondary has the desired contents, yet no logging
797 information exists to incrementally resynchronize the volumes (using \fB-u\fR).
798 \fB-u\fR \fB-r\fR resynchronizes the primary (target) volume from the secondary
799 (source) volume, using the Remote Mirror scoreboard logs maintained while
800 replication was suspended. It then resumes Remote Mirror replication of new
801 updates from the primary volume to the secondary volume so that the volume sets
802 remain synchronized. Quiesce the workload to the volume sets during the
803 restore/refresh operation. This action ensures that the primary and secondary
804 volumes match before replication of new updates resumes.
805 .RE
806
807 .sp
808 .ne 2
809 .na
810 \fB\fB-u\fR\fR
811 .ad
812 .sp .6
813 .RS 4n
814 Updates a Remote Mirror volume set. This parameter resynchronizes a Remote
815 Mirror volume set. Only the blocks logged as changed in the Remote Mirror
816 scoreboards are updated. Enables Remote Mirror replication for the primary
817 volume and also uses the Remote Mirror scoreboard logs to start the
818 resynchronization process so that the corresponding secondary volume matches
819 the primary volume.
820 .RE
821
822 .SS "States Returned from \fBsndradm\fR \fB-P\fR"
823 .sp
824 .LP
825 The following are the states that can be returned from \fBsndradm\fR \fB-P\fR.
826 .sp
827 .ne 2
828 .na
829 \fB\fBvolume\fR \fBfailed\fR\fR
830 .ad
831 .sp .6
832 .RS 4n
833 An I/O operation to the local data volume has failed
834 .RE
835
836 .sp
837 .ne 2
838 .na
839 \fB\fBbitmap\fR \fBfailed\fR\fR
840 .ad
841 .sp .6
842 .RS 4n
843 An I/O operation to the local bitmap volume has failed
844 .RE
845
846 .sp
847 .ne 2
848 .na
849 \fB\fBdisk\fR \fBqueue\fR \fBfailed\fR\fR
850 .ad
851 .sp .6
852 .RS 4n
853 An I/O operation to disk queue volume has failed
854 .RE
855
856 .sp
857 .ne 2
858 .na
859 \fB\fBneed\fR \fBsync\fR\fR
860 .ad
861 .sp .6
862 .RS 4n
863 A sync to this volume has been interrupted. It needs to be completed (or
864 restored via Point-in-Time Copy). The direction of the data flow must not be
865 changed until one or the other is done.
866 .RE
867
868 .sp
869 .ne 2
870 .na
871 \fB\fBneed\fR \fBreverse\fR \fBsync\fR\fR
872 .ad
873 .sp .6
874 .RS 4n
875 A reverse sync to this volume has been interrupted. It needs to be completed
876 (or restored via Point-in-Time Copy). The direction of the data flow must not
877 be changed until one or the other is done.
878 .RE
879
880 .sp
881 .ne 2
882 .na
883 \fB\fBlogging\fR\fR
884 .ad
885 .sp .6
886 .RS 4n
887 Incoming writes are logged in the bitmap only. Data is not replicated to the
888 remote site. \fBneed sync\fR, \fBneed reverse sync\fR, and \fBqueuing\fR are
889 all substates of logging such that writes are logged in the bitmap, but not
890 replicated. Queuing mode (described below) logs the writes to the bitmap, and
891 queues the request for later replication by the async flushers.
892 .RE
893
894 .sp
895 .ne 2
896 .na
897 \fB\fBreverse\fR \fBsyncing\fR\fR
898 .ad
899 .sp .6
900 .RS 4n
901 A secondary to primary copy is in progress.
902 .RE
903
904 .sp
905 .ne 2
906 .na
907 \fB\fBsyncing\fR\fR
908 .ad
909 .sp .6
910 .RS 4n
911 A primary to secondary copy is in progress.
912 .RE
913
914 .sp
915 .ne 2
916 .na
917 \fB\fBqueuing\fR\fR
918 .ad
919 .sp .6
920 .RS 4n
921 During normal async replication using disk queues, i/o is placed on the disk
922 queue to be replicated by the async flusher threads. In the event of a
923 temporary link failure, the set transitions to queuing mode. The queue is not
924 discarded, as it would be with memory based queues. Instead, data is logged in
925 the bitmap and placed on the queue. When the link comes up, and \fBsndradm\fR
926 \fB-u\fR is issued, (automated by turning autosync on for the set) the flushers
927 restarts. This preserves write ordering through a temporary link outage. If
928 write ordering is not necessary, and only the latest data is needed, the set
929 can be put into logging manually (\fBsndradm\fR \fB-l\fR) and an update sync
930 issued (\fBsndradm\fR \fB-u\fR). This action discards the data on the queue,
931 and fast resyncs using the bitmap. If the queue fills before the link comes
932 back and the update sync is issued, the queue is discarded and the set put into
933 logging mode to avoid application hangs.
934 .RE
935
936 .SH EXAMPLES
937 .LP
938 \fBExample 1 \fREnabling a Remote Mirror Set
939 .sp
940 .LP
941 The following command enables a Remote Mirror asynchronous set on host
942 \fBexample\fR, where \fBexample\fR is the primary host and \fBexample-remote\fR
943 is the secondary host.
944
945 .sp
946 .in +2
947 .nf
948 example% \fBsndradm -e example /dev/rdsk/c1t0d0s1 /dev/rdsk/c1t1d0s3 \e
949 example-remote /dev/rdsk/c2t3d0s5 /dev/rdsk/c2t4d0s5 ip async\fR
950 .fi
951 .in -2
952 .sp
953
954 .LP
955 \fBExample 2 \fRAdding a Disk Queue to an Asynchronous Set
956 .sp
957 .LP
958 The following command adds a disk queue volume to an asynchronous set.
959
960 .sp
961 .in +2
962 .nf
963 example% \fBsndradm -q a /dev/rdsk/c1t2d0s3 \e
964 example-remote:/dev/rdsk/c2t3d0s5\fR
965 .fi
966 .in -2
967 .sp
968
969 .LP
970 \fBExample 3 \fRRemoving a Disk Queue from an Asynchronous Set
971 .sp
972 .LP
973 The following command removes the disk queue volume from a set with a disk
974 queue volume attatched to it.
975
976 .sp
977 .in +2
978 .nf
979 example% \fBsndradm -q d example-remote:/dev/rdsk/c2t3d0s5\fR
980 .fi
981 .in -2
982 .sp
983
984 .LP
985 \fBExample 4 \fRDisabling a Remote Mirror Set
986 .sp
987 .LP
988 The following command disables a Remote Mirror set enabled on host
989 \fBexample\fR.
990
991 .sp
992 .in +2
993 .nf
994 example% \fBsndradm -d example-remote:/dev/rdsk/c2t3d0s5\fR
995 .fi
996 .in -2
997 .sp
998
999 .SH EXIT STATUS
1000 .sp
1001 .ne 2
1002 .na
1003 \fB\fB0\fR\fR
1004 .ad
1005 .RS 13n
1006 Command completed successfully.
1007 .RE
1008
1009 .sp
1010 .ne 2
1011 .na
1012 \fB\fB>0\fR\fR
1013 .ad
1014 .RS 13n
1015 An error occurred.
1016 .RE
1017
1018 .sp
1019 .LP
1020 When the \fB-m\fR or \fB-u\fR option is executed in a script, the exit status
1021 following one of these options always returns success, regardless of the
1022 current status of the Remote Mirror set.
1023 .SH ATTRIBUTES
1024 .sp
1025 .LP
1026 See \fBattributes\fR(5) for descriptions of the following attributes:
1027 .sp
1028
1029 .sp
1030 .TS
1031 box;
1032 c | c
1033 l | l .
1034 ATTRIBUTE TYPE ATTRIBUTE VALUE
1035 _
1036 Interface Stability Evolving
1037 .TE
1038
1039 .SH SEE ALSO
1040 .sp
1041 .LP
1042 \fBdscfg\fR(1M), \fBsndrd\fR(1M), \fBsndrsyncd\fR(1M), \fBds.log\fR(4),
1043 \fBrdc.cf\fR(4), \fBattributes\fR(5), \fBsv\fR(7D)