snapshot command

Purpose

Creates, deletes, or rolls back a snapshot image file of a single logical unit (LU) or multiple LUs.

Syntax

snapshot [-clustername ClusterName] -create [filename] [-sp StoragePool] {-lu LU_Names | -luudid LUUDIDs}

snapshot [-clustername ClusterName] -remove filename [-sp StoragePool] {-lu LU_Names | -luudid LUUDIDs}

snapshot [-clustername ClusterName] -rollback filename [-sp StoragePool] {-lu LU_Names | -luudid LUUDIDs}

snapshot [-clustername ClusterName] -list [-sp StoragePool] [-lu LuName | -luudid LUUDID]

Description

The snapshot command can create, remove, or roll back a snapshot image file of a single LU or multiple LUs. The create flag generates a snapshot image that can either have a user-supplied name or a system-generated name. The remove flag is used to remove a previously generated snapshot image. The rollback option is used to roll back the snapshot file to a previously generated version of a snapshot image.

Note: You must synchronize the virtual disk of the client before taking a snapshot. If the rolled back LU is a rootvg, the client must be shut down. If the rolled back LU is a datavg, all the volume groups present in the virtual disk must be varied off.

Note: If the LU is fully written, an additional space including space for metadata is required for a thin-provisioned LU.

Flags

Flag name	Description
-clustername	Specifies the cluster name.
-create SnapShotName	Specifies the name of the snapshot file to be created. This argument can be left blank, in which case a system-generated name is used.
-remove SnapShotName	Specifies the name of the snapshot file to be deleted.
-list	Lists the snapshot within the LU.
-lu LUnames	Specifies the LU names that are contained in the snapshot file.
-luudid LUUDID	Specifies the LU-UDID for this LU.
-rollback SnapShotName	Specifies the name of the snapshot file to be rolled back.
-sp StoragePool	Specifies the storage pool name.

Examples

To create a snapshot with a single logical unit and a user specified snapshot name, type the following command:
```
snapshot -create bob -lu vdisk1
```
The system displays the following message:

bob
To create a snapshot image file that contains a single logical unit that has a system generated name, type the following command:
```
snapshot -create -lu vdisk1
```
The system displays an output similar to the following message:

SS_487532_2010-05-08_01:23:23
To create a snapshot that contains multiple logical units that have a system generated name, type the following command:
```
snapshot -create -lu vdisk1 vdisk2
```
The system displays an output similar to the following message:

SS_487555_2010-05-09_01:23:45
To remove an existing snapshot image called vdisk2_ss1, type the following command:
```
snapshot -remove vdisk1_ss1 -lu vdisk1
```
To roll back to an existing snapshot image vdisk2_ss2, type the following command:
```
snapshot -rollback vdisk2_ss2 -lu vdisk2
```

To list all snapshots, type the following command:

snapshot -list

The system displays the following output:

`LuName ––––––––––`	`Size(mb) ––––––––`	`ProvisionType –––––––––––––`	`Lu Udid –––––––––––––`
`vdisk1 Snapshot snap1 snap2`	`1024`	`THIN`	`c49cf79726dc42ed3787c878bf4fd30c`
`vdisk2 Snapshot snap1 snap2`	`1024`	`THIN`	`7f6c2fed80c77bad1f309de16f68abff`
`vdisk3 Snapshot snap1 snap2`	`1024`	`THIN`	`dbc888fd787e41be55480f63244ffc99`
`vdisk4 Snapshot snap2`	`1024`	`THIN`	`387ca4f5eb73be0ac74e436be3c78557`

Related Information

The lu command.

Last updated: Wed, November 18, 2020