D.1.24 acsnap start (Command for starting SnapOPC+ copy)

NAME

acsnap start - Start of SnapOPC+ copy.

SYNOPSIS

acsnap start -g COPY-GROUP [-p PAIR | -v VOLUME-NAME] [-r] [-xml]

[When starting the estimation of the amount of snap data volume updates:]

acsnap start -estimate -v VOLUME-NAME [-xml]

DESCRIPTION

This command starts SnapOPC+ copy to a specified copy group or copy pair.

It also can start to estimate the number of updated blocks generated for the copy source volume.

If the -p option is not specified, a copy destination is automatically selected and Snapshot type copy is started.
If all copy destination volumes are generation-managed, the oldest snap generation is cancelled and selected as a copy destination.
If the -p option is specified, Snapshot type copy is started onto a specified copy destination.
If a past snap generation (excluding the oldest snap generation) is specified as a copy destination, this command ends abnormally.
If the -v option is specified, a copy destination for the specified copy source is automatically selected.

OPTIONS

-g COPY-GROUP: This option specifies a copy group name.

-p PAIR: This option specifies a copy pair.

-r

This option performs a copy in the reverse direction to the direction that has been specified.

The latest snap generation is selected as a copy source when a copy pair is not specified.

-v VOLUME-NAME

This option specifies a copy source logical volume. The copy destination is automatically selected.

Also when starting to estimate the amount of snap data volume updates, specify a copy-source logical volume.

The following is an example of a format to specify a logical volume.

(1) ETERNUS Disk storage system name
(2) Logical volume number

In addition, you can specify extent start position and extent size, as well.

(1) ETERNUS Disk storage system name
(2) Logical volume number
(3) Extent start position (per block)
(4) Extent size (number of blocks)

A string starting with "0x" represents a hexadecimal number.

-estimate: This option estimates the amount of snap data volume updates.

-xml: This option displays the result of the command execution in the XML format.

EXIT STATUS

=0: Terminate normally

>0: Terminate abnormally

EXAMPLES

> acsnap start -g group01

DX80/0x1:DX80/0x6
# DATE : 2008/06/24 16:28:00 - << SnapOPCP Started >>

DX80/0x2:DX80/0x7
# DATE : 2008/06/24 16:28:00 - << SnapOPCP Started >>

DX80/0x3:DX80/0x8
# DATE : 2008/06/24 16:28:00 - << SnapOPCP Started >>

  Succeeded : 3
  Failed    : 0

[When starting to estimate the amount of snap data volume updates:]

> acsnap start -estimate -v DX80/0x1
Successful completion

NOTES

When the copy type of a copy group is OPC, QuickOPC, EC or REC, this command ends abnormally.
This command is not available for ETERNUS Disk storage systems registered as remote disk storage systems.
If the destination logical volume of a specified copy group or copy pair is protected by acinhibit set (Command for setting volume protection), this command terminates abnormally.