Skip to main content

Start consistency group snapshot rollback

The start cgSnapImage rollback command starts a rollback operation to the member base volumes in a snapshot consistency group.

Supported Arrays​

This command applies to an individual DE2000H, DE4000H, DE4000F, DE6000H, or DE6000F storage array.

Roles​

To execute this command on an storage array, you must have the Storage Admin role.

Context​

The content of the base volumes changes immediately to match the point-in-time content of the consistency group snapshot volume. The base volumes immediately becomes available for read/write requests after the rollback operation has successfully completed.

The repository volume that is associated with the consistency group snapshot volume continues to track any new changes between the base volume and the consistency group snapshot volume that occur after the rollback operation is completed.

To stop a rollback operation to the member base volumes use the stop cgSnapImage rollback command.

Syntax​

start cgSnapImage ["<var id="GUID-17501A2D-6106-46C1-95AE-EEF4CA054922__V1111044" className="keyword varname">snapCGID</var>:<var id="GUID-17501A2D-6106-46C1-95AE-EEF4CA054922__V1512809" className="keyword varname">imageID</var>"] rollback 
memberVolumeSet ("<var id="GUID-17501A2D-6106-46C1-95AE-EEF4CA054922__V1447468" className="keyword varname">memberVolumeName1</var>" ... "<var id="GUID-17501A2D-6106-46C1-95AE-EEF4CA054922__V1447469" className="keyword varname">memberVolumeNameN</var>")

Parameter​

ParameterDescription
cgSnapImage

The name of the consistency group snapshot image for which you want to start a rollback operation. The name of a snapshot image is comprised of two parts:

  • The name of the snapshot group

  • An identifier for the snapshot image in the snapshot group.

The identifier for the snapshot image can be one of these:

  • An integer value that is the sequence number of the snapshot in the snapshot group.

  • NEWEST – Use this option when you want to show the latest snapshot image created in the snapshot group.
  • OLDEST – Use this option when you want to show the earliest snapshot image created in the snapshot group.

Enclose the snapshot image name in double quotation marks (" ") inside square brackets ([ ]).

memberVolumeSet

The name of one or more member base volumes in a consistency group that you want to rollback. Enclose each member base volume name in double quotation marks (" ") inside parentheses.

You can enter more than one volume name. Enclose all of the volume names in one set of square brackets ([ ]). Enclose each volume name in double quotation marks (" "). Separate each volume name with a space.

When the memberVolumeSet parameter is not used the rollback process applies to all member volumes of the consistency group.

Notes​

The name of a snapshot image has two parts separated by a colon (:):

  • The identifier of the snapshot group

  • The identifier of the snapshot image

For example, if you want to start a roll back operation for the newest snapshot image in an entire consistency group that has the name CG1, you would use this command:


start cgSnapImage ["CG1:newest"] rollback;

To start a roll back operation for the snapshot image 12345 for base volume members memVol1, memVol2, and memVol3 in a consistency group that has the name CG2, you would use this command:


start cgSnapImage ["CG2:12345"] rollback memberVolumeset=("memVol1 memVol2
 memVol3");