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 II 7D "Jun 8, 2007"
   7 .SH NAME
   8 ii \- Instant Image control device
   9 .SH DESCRIPTION
  10 .sp
  11 .LP
  12 The \fBii\fR device is a control interface for Instant Image devices and
  13 controls the Instant Image module through the \fBioctl\fR(2) interface.
  14 .sp
  15 .LP
  16 Instant Image is a point-in-time volume copy facility for the Solaris operating
  17 environment that is administered through the \fBiiadm\fR(1M) command. With
  18 Instant Image, you can create an independent point-in-time copy of a volume or
  19 a master volume-dependent point-in-time view.  You can also independently
  20 access the master and shadow volume for read and write operations. Instant
  21 Image also lets you update the shadow volume from the master volume or restore
  22 the master volume from the shadow. (Restore operations to volumes can be full
  23 or incremental). Instant Image supports fast volume re-synchronization, letting
  24 you create a new point-in-time volume copy by updating the specified volume
  25 with only changed data.
  26 .sp
  27 .LP
  28 To create a shadow volume you need a:
  29 .RS +4
  30 .TP
  31 1.
  32 Master volume to be shadowed.
  33 .RE
  34 .RS +4
  35 .TP
  36 2.
  37 Shadow volume where the copy will reside. This volume must be equal to or
  38 larger than the master volume.
  39 .RE
  40 .RS +4
  41 .TP
  42 3.
  43 Administrative bitmap volume or file for tracking differences between the
  44 shadow and master volumes. The administrative bitmap volume or file must be at
  45 least 24Kbytes in size and requires 8KBytes for each GByte (or part thereof) of
  46 master volume size, plus an additional 8KBytes overhead. For example, to shadow
  47 a 3GByte master volume, the administration volume must be 8KBytes + (3 *
  48 8KBytes) =32KBytes in size.
  49 .RE
  50 .sp
  51 .LP
  52 The Instant Image module uses services provided by the SDBC and SD_GEN modules.
  53 The SV module is required to present a conventional block device interface to
  54 the storage product interface of the Instant Image, SDBC and SD_GEN modules.
  55 .sp
  56 .LP
  57 When a shadow operation is suspended or resumed, the administration volumes may
  58 be stored in permanent SDBC storage or loaded and saved to and from kernel
  59 memory. The ii_bitmap variable in the \fB/kernel/drv/ii.conf\fR configuration
  60 file determines the administration volume storage type. A value of 0 indicates
  61 kernel memory, while a value of 1 indicates permanent SDBC storage.  If the
  62 system is part of a storage products cluster, use the 1 value (permanent
  63 storage), otherwise use kernel memory (0 value).
  64 .SH FILES
  65 .sp
  66 .ne 2
  67 .na
  68 \fB\fBkernel/drv/ii\fR\fR
  69 .ad
  70 .RS 23n
  71 32- bit ELF kernel module (x86).
  72 .RE
  73 
  74 .sp
  75 .ne 2
  76 .na
  77 \fB\fB/kernel/drv/ii.conf\fR\fR
  78 .ad
  79 .RS 23n
  80 Configuration file.
  81 .RE
  82 
  83 .SH ATTRIBUTES
  84 .sp
  85 .LP
  86 See \fBattributes\fR(5) for a description of the following attributes:
  87 .sp
  88 
  89 .sp
  90 .TS
  91 box;
  92 c | c
  93 l | l .
  94 ATTRIBUTE TYPE  ATTRIBUTE VALUE
  95 _
  96 Architecture    x86
  97 _
  98 Interface Stability     Committed
  99 .TE
 100 
 101 .SH SEE ALSO
 102 .sp
 103 .LP
 104 \fBiiadm\fR(1M), \fBioctl\fR(2), \fBattributes\fR(5), \fBsv\fR(7D)