HP StorageWorks SAN Virtualization Services Platform Manager command line interface user guide (AG781-96016, March 2009)

CreateVDGroupSnapshot command
Syntax
CreateVDGroupSnapshot -Group VDGroupName, ~
-snapshot SnapshotName [TEMPLATE], ~
-Pit NameOfPiT [LastInstance | LastAsyncMirror], ~
-host HostName1 RW|OFF, [-host HostName2 RW|OFF, ...] ~
-StoragePool PoolName, -cluster 0|1, -timeout 900
Description
Creates a snapshot on the virtual disk group's PiT.
NOTE:
• The -host argument is considered optional by the VSM API, but is required by the VSM (returns
an error).
• If [TEMPLATE] is used, the name of the object must be less than 16 characters long.
If the LastInstance flag is used, the preceding PiT name is the root name, and the most recently
created snapshot PiT (with a template name) is used.
If the LastAsyncMirror (not the LastSyncMirror) flag is used, the preceding PiT name is the root
name, and the most recently created AsyncMirror PiT on the specific virtual disk is used.
NOTE:
If you need to know the name of the individual snapshots on every virtual disk in the virtual disk group
in advance (for example, for subsequently mounting these snapshots in the script), you must follow
the guidelines below. In such cases, the name of the created individual snapshots is built from the
virtual disk name and the disk group snapshot name. For example, for a virtual disk vol01 and a
virtual disk group view name of BK_snapshot, the name of the created snapshot is
vol01BK_snapshot.
In order to ensure this, follow these guidelines:
• Do not use the TEMPLATE flag for the snapshot name.
• The total length of the virtual disk name plus the snapshot name must not exceed 31 characters.
• The snapshot name must be unique (virtual disk group snapshots that were created with this name
on the group's virtual disks must not exist).
• If you delete a previously created virtual disk group snapshot with the same name, just before in-
voking this command, and if the new individual snapshot names are not as expected, this means
some of the individual snapshots on the virtual disks had not been completely deleted. In such
cases, a small delay (60 seconds) should be added (with the Pause command) before invoking
this CLI command.
Using the VSM command line interface46