POWER7 information

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 [SnapShotName] -spname StoragePool {-lu LU_Names | -luudid LUUDIDs}

snapshot -clustername ClusterName -delete SnapShotName -spname StoragePool {-lu LU_Names | -luudid LUUDIDs}

snapshot -clustername ClusterName -rollback SnapShotName -spname StoragePool {-lu LU_Names | -luudid LUUDIDs}

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

Description

The snapshot command can create, delete, 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 with a system-generated name. The delete flag is used to delete 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.
-delete SnapShotName	Specifies the name of the snapshot file to be deleted. This argument is required with the delete flag.
-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. This argument is required with the rollback flag.
-spname 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 -clustername mycluster -spname mypool -create bob -lu lu_A
```
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 -clustername mycluster -spname mypool -create -lu lu_A
```
The system displays the following message:

SS_487532_2010-05-08_01:23:23
To create a snapshot that contains multiple logical units that has a system generated name, type the following command:
```
snapshot -clustername mycluster -spname mypool -create -lu lu_A lu_B
```
The system displays the following output:

SS_487555_2010-05-09_01:23:45
To delete an existing snapshot image called lu_image01, type the following command:
```
snapshot -clustername mycluster -spname mypool -delete lu_image01 -lu lu_A
```
To roll back to an existing snapshot image lu_image02, type the following command:
```
snapshot -clustername mycluster -spname mypool -rollback lu_image02 -lu lu_A
```

To list all snapshots, type the following command:

snapshot -clustername mycluster -list -spname mypool

The system displays the following output:

`LuName ––––––––––`	`Size(mb) ––––––––`	`ProvisionType –––––––––––––`	`Lu Udid –––––––––––––`
`LUA`	`1024`	`THIN`	`c49cf79726dc42ed3787c878bf4fd30c`
`Snapshot`
`snap1`
`snap2`
`LUB`	`1024`	`THIN`	`7f6c2fed80c77bad1f309de16f68abff`
`Snapshot`
`snap1`
`snap2`
`LUC`	`1024`	`THIN`	`dbc888fd787e41be55480f63244ffc99`
`Snapshot`
`snap1`
`LUD`	`1024`	`THIN`	`387ca4f5eb73be0ac74e436be3c78557`
`Snapshot`
`snap2`

Related Information

The lu command.

Send feedback Rate this page

Last updated: Wed, June 03, 2015