If no action item is entered, iiadm displays the list of Point-in-Time Copy sets (non-suspended) currently configured. If more than one action item, or an incorrectly specified action item is entered, iiadm displays the specific error message to stderr, followed by a brief usage summary.

For the Point-in-Time Copy options ENABLE (-e), COPY (-c) and UPDATE (-u), there are two associated shadow volume selection qualifiers, {ind|dep}, that are used to specify the type of Point-in-Time Copy volume set to create.

Indicates that the bitmap is maintained in memory only or resume operation.

Indicates that the bitmap is maintained in memory and on disk. This is the default value.

Indicates that no logging is sent to the system console.

Indicates that informational logging is sent to the system console.

Indicates that developmental logging is sent to the system console.

Enable Point-in-Time Copy for the specified master, shadow, and bitmap volumes. The enable shadow set processing assures that the specified volumes are accessible, that the shadow_vol is not mounted, and that the bitmap_vol is correctly sized for the type of shadow set being created. Additionally, it assures that the volumes are under control of the SV driver ( if they are not, it puts them there), initializes the bitmap volume, and, if the volume set is an independent shadow set, a full copy operation is initiated. On a successful enable, Point-in-Time Copy stores the specified master_vol, shadow_vol and bitmap_vol names, plus the enabling type (ind or dep), into the Point-in-Time Copy configuration store. The configuration store contains all currently configured Point-in-Time Copy Volume Sets and their associated configuration attributes. (See discussion above on independent and dependent shadow volume semantics.) master_vol is the volume from which a point-in-time snapshot is made. shadow_vol is the volume that contains the point-in-time snapshot. bitmap_vol is used for tracking differences between the shadow and master volumes. When Point-in-Time Copy shadow operations are suspended or resumed, the bitmap volume (maintained in kernel memory) can be stored in or retrieved from permanent storage. The storage associated with the bitmap volume should be as redundant as that of the shadow volume storage. The shadow_vol name is the name that the Point-in-Time Copy Shadow Set is known by for all iiadm options requiring specification of a volume_set name.

Disable the Point-in-Time Copy volume set associated with the specified volume_set. If Point-in-Time Copy was running in independent mode as specified in the -e ind options, above, the shadow volume data contains the same data as it did before it was disabled (assuming no writes have occurred). Users can access the master and shadow volumes, as they are now standalone point-in-time copies. During the time that the full copy is active, an independent volume operates as though it is a dependent volume. To assure that the volume is no longer in full copy mode, issue the following command to wait for the full copy to complete:

# iiadm -w volume_set

Update the shadow volume from the master. Updates a point-in-time copy of the master volume to the shadow volume. volume_set is the Point-in-Time Copy shadow set containing the master and shadow volumes. This option provides a fast resynchronization of the shadow volume, creating an incremental copy of the master. This update copies all 32KB segments flagged as different between the master and shadow volumes. It does not copy all master volume data, only changed data. While the data is being copied, the shadow is dependent upon the master volume. Before using this option, momentarily quiesce the workload to the volumes; stop the host application from writing to the volumes. This ensures that the point-in-time data is consistent. You can visually check the status of this copy or update operation with iiadm -i volume_set, or interactively (by means of a shell or script) with iiadm -w volume_set, before using the target volume for any other operations. This command supports PID (Process IDentifier) locking, by using the option -p, iiadm -p -u s. Enabling this option prevents other processes from taking a new point-in-time snapshot, thus invalidating prior point-in-time data.

Updates a point-in-time copy of the master volume from the shadow. volume_set is the Point-in-Time Copy volume set containing the master and shadow. This option provides a fast resynchronization of the master volume, creating an incremental copy of the shadow. This update copies all 32KB segments flagged as different between the master and shadow volumes. It does not copy all shadow volume data, only changed data. While the data is being copied, the master is dependent upon the shadow volume. Before using this option, momentarily quiesce the workload to the volumes; stop the host application from writing to the volumes. This ensures that the point-in-time data is consistent. You can visually check the status of this copy or update operation with iiadm -i volume_set, or interactively (by means of a shell or script) with iiadm -w volume_set, before using the target volume for any other operations. This command is query enabled to prevent accidentally overwriting the data on a master volume. When this command option is used in scripts, add the -n option to prevent the query from occurring. This command supports PID (Process IDentifier) locking, by using the option -p, iiadm -p -u m. Enabling this option prevents other processes from taking a new point-in-time snapshot, thus invalidating prior point-in-time data.

Copy the master volume to the shadow. Creates a point-in-time copy of the master volume to the shadow volume. volume_set is the Point-in-Time Copy volume set containing the master and shadow. This option writes all data in the point-in-time copy of the master volume to the shadow volume. While the data is being copied from master to shadow, the shadow is dependent on the master volume. This option performs a full volume copy. Use iiadm -u s unless the integrity of the data on the independent shadow volume is in doubt. Otherwise, use this option to synchronize the master and shadow volumes; that is, make the data on each volume match. Before using this option, momentarily quiesce the workload to the volumes; stop the host application from writing to the volumes. This ensures that the point-in-time data is consistent. You can visually check the status of this copy or update operation with iiadm -i volume_set, or interactively (by means of a shell or script) with iiadm -w volume_set, before using the target volume for any other operations. This command supports PID (Process IDentifier) locking, by using the -p option, iiadm -p -c s. Enabling this option prevents other processes from taking a new point-in-time snapshot, thus invalidating prior point-in-time data.

Copy the shadow volume to the master. Creates a point-in-time copy of the shadow volume to the master volume. volume_set is the Point-in-Time Copy volume set containing the master and shadow volumes. This option writes all data in the point-in-time copy of the shadow volume to the master volume. While the data is being copied from the shadow to the master, the master is dependent upon the shadow volume. This option performs a full volume copy. Use iiadm -u m unless the integrity of the data on the independent master is in doubt. Otherwise, use this option to synchronize the master and shadow volumes; that is, make the data on each volume match. Before using this option, momentarily quiesce the workload to the volumes; stop the host application from writing to the volumes. This ensures that the point-in-time data is consistent. You can visually check the status of this copy or update operation with iiadm -i volume_set, or interactively (by means of a shell or script) with iiadm -w volume_set, before using the target volume for any other operations. This command is query-enabled to prevent accidentally overwriting the data on a master volume. When this command option is used in scripts, add the -n option to prevent the query from occurring. This command supports PID (Process IDentifier) locking, by using the -p option, iiadm -p -c m. Enabling this option prevents other processes from taking a new point-in-time snapshot, thus invalidating prior point-in-time data.

Abort any current copy operation that might be active between the master and shadow volumes. volume_set is the Point-in-Time Copy volume set containing the master and shadow volumes. After executing iiadm -a, the update or copy to the target (master or shadow) volume is incomplete. The target volume is now a dependent copy of the source volume. Reissue the update or copy command option to resynchronize the volumes.

Wait until any in-progress copy or update operation completes or is aborted. volume_set is the Point-in-Time Copy volume set containing the master and shadow volumes. This option waits until the current Point-in-Time Copy operation is complete, thus preventing a subsequent iiadm command (from a shell or script) from executing. Use this command option when you need to be sure the copy or update operation has completed. This command supports PID (Process IDentifier) unlocking. If a prior copy or update, using a command iiadm -p {-c|-u} {m|s}, was invoked with the -p option, upon completion of the wait processing, if the current PID was the PID that locked the point-in-time data, this option unlocks the data.

Display status for the Point-in-Time Copy currently-enabled or -suspended volume set. volume_set is the Point-in-Time Copy volume set containing the master and shadow volumes. If no volume_set is specified, status is displayed for all Point-in-Time Copy volume sets that are configured.

List all currently configured Point-in-Time Copy volumes.

This option causes Point-in-Time Copy to initialize the specified overflow_vol for subsequent use as an overflow volume in conjunction with Compact Dependent Shadow Volumes. To facilitate efficient, shared usage of this overflow volume, it can be associated with multiple Point-in-Time Copy volume sets on an as-needed basis. During initialization of the overflow_vol, the initiator of this option, must answer the following question: "Initialize this overflow volume? yes/no" A response of either "yes/no" is required before proceeding. This option supports the -n option, so that the requested action is performed without prompting. This option is useful for inclusion in a script. The -n option must be specified first. For example, "iiadm -nO vol" is valid; "iiadm -On vol" is not. Make sure you want to initialize the data on the specified overflow_vol, especially when using the -n option.

This option enables the specified overflow_vol, for subsequent use as an overflow volume in a situation where the size of the Compact Dependent Shadow Volume is too small, or an unscheduled amount of change occurs to the volume set. Overflow changed data would be redirected to the associated overflow volume. volume_set is the Point-in-Time Copy volume set containing the master and shadow volumes. If the overflow_vol has not been initialized, this option initializes the overflow_vol (see -O option), then attaches the overflow_vol to the volume_set. If overflow_vol was previously initialized, this option attaches the overflow_vol to the volume_set. This option supports the -n option, so that the requested action is performed without prompting. This option is useful for inclusion in a script. The -n option must be specified first. For example, "iiadm -nA vol" is valid; "iiadm -An vol" is not. Make sure you want to initialize the data on the specified overflow_vol, especially when using the -n option.

This option removes the overflow volume currently associated with the specified volume_set. If the overflow volume is currently in use by the volume_set, this operation fails with an "Overflow volume still in use" error message. To resolve this situation, perform one of the operations described below on the volume_set. These operations momentarily clear out all overflow writes that are associated with this volume set.

abort(-a)

disable(-d)

update(-u)

This option lists all overflow volumes which are associated with one or more volume sets.

This option displays the current status of the overflow_vol.

Export the independent shadow volume of the Point-in-Time Copy volume set specified by volume_set. The shadow volume is to be made available to another host for read/write access, by means of an enabling technology, such as multi-ported devices. This other host is responsible for maintaining a bitmap of differences that is used to merge with locally recorded differences to the master when the shadow volume is rejoined to its master volume. While a shadow volume is exported it must not be subject to an update or copy operation. Perform an iiadm -w volume_set command prior to invoking an export command.

Import the independent shadow volume of the Point-in-Time Copy volume set specified by volume_set. The shadow volume must have been previously exported from a host by means of an enabling technology, such as multi-ported devices. The import operation causes this host to start maintaining a bitmap of differences as the volume is modified. The bitmap_vol should not be the same as that used when the shadow volume was originally formed into a shadow group. After the exported/imported independent shadow volume is no longer needed by the other node, you must enter a disable command so that the bitmap_vol and its associated shadow_vol are consistent, prior to performing a join operation. For example,

# iiadm -d volume_set

Join the volume_set, using the bitmap_vol, with the master volume set of the Point-in-Time Copy volume set. The bitmap volume supplied is read and merged with the original volume to reconstruct the original volume set consisting of the master, shadow, and bitmap volumes. The bitmap_vol to be merged is the one obtained on the node that had imported the independent shadow volume. There must be no write activity to the shadow volume on the importing machine from the time the bitmap is copied over until the shadow is once again imported.

Add one or more existing Point-in-Time Copy volume_set(s) into a user specified group_name. This association of one or more Point-in-Time Copy volume sets in a group allows the list of iiadm options shown below to be performed on all volume sets within the group_name as a whole. Only the commands COPY (-c) and UPDATE (-u) are performed atomically across all Point-in-Time Copy sets within the group. All other grouped, iiadm commands are performed sequentially on each member of the group. The syntax of an iiadm group command is as follows:

iiadm -g group_name [options]

-a

-A

-c {s | m}

-D

-d

-E

-i

-l

-L

-n

-P

-R

-u {s | m}

-w

Remove one or more existing Point-in-Time Copy volume_set(s) from their currently associated group_name. By default, or until moved into a user specified group_name, all Point-in-Time Copy volume_set(s) are in the blank (" ") group. This association allows all the previously documented iiadm group commands to be performed against the blank (" ") iiadm group_name.

This Point-in-Time Copy option is a modifier that limits configuration operations to only those volumes belonging to a Sun Cluster Resource Group, or Disk Group. In a Sun Cluster where the volume manager is Sun Cluster-aware, iiadm automatically obtains the correct Disk Group information, therefore this option is typically not required unless the volumes are part of an encompassing Resource Group. In a Sun Cluster where the volumes are accessible on the local node only, the special cluster_tag of local is used to indicate volumes that are not part of a Sun Cluster Resource Group or Disk Group. If "-L" is given as a the cluster_tag argument, then iiadm lists all cluster tags associated with Point-in-Time Copy. This option is invalid when used on a Solaris system on which the Sun Cluster package has not been installed or configured.

Prints the iiadm usage summary.

Display the current version of the Point-in-Time Copy software components.

Alter the Point-in-Time Copy volume set tuning parameters for the specified volume_set to delay ticks, every unit I/O's. Delay ranges from 2 to 10000 inclusive; unit ranges from 100 to 60000 inclusive.

After a volume has failed, Point-in-Time Copy places it offline. After replacing the volume, place it back online using this option. Associated dependent volumes in the Point-in-Time Copy volume set are also placed online. After the volume is placed online, this command also starts any necessary point-in-time volume updates.

Command completed successfully.

An error occurred.