Snapshots

You can take snapshots manually for volumes or consistency groups. To take a snapshot of a volume or consistency group, use the application snapshots take command.

Usage:

applications snapshots take --application=<app_inst> (--cgid=<num> | --volume=<vol_name>) [--vss] [--count=<snp_num>]

Options:

Options and arguments	Description
`--application=<app_inst>`	Specify the name of the app instance. Replace `<app_inst>` with the application instance.
`--cgid=<num>`	Take a snapshot of specific consistency group. Replace `<num>` with the consistency group id.
`--volume=<vol_name>`	Take a snapshot of a volume; replace `<vol_name>` with the name of the volume.
`--vss`	To take a volume snapshot service (VSS) (shadow copy; that is, a snapshot of a volume that is in use).
`--count=<snp_num>`	To take multiple snapshots. The `<snp_num>` argument indicates the number of snapshots. The `--count` option is used only for testing.

Examples

To take a snapshot of volume RH on application instance math; run:
```
applications snapshot take --application math --volume RH
```
To take a shadow copy (VSS) of volume RH on application instance math; run:
```
applications snapshot take --application math --volume RH --vss
```

List snapshots

To list snapshots, use the applications snapshots list command.

Usage:

applications snapshots list [--application=<app_inst> --volume=<vol_name>] [--vols] [--rep] [--vms]

Options:

Options and arguments	Description
`--application=<app_inst>`	To list snapshots from a specific only from an app instance. Replace `<app_inst>` with app instance name.
`--volume=<vol_name>`	To list only snapshots from the specified volume. Replace `<vol_name>` with the name of the volume.
`--vols`	To display volume snapshots within application instances.
`--rep`	To display information on replications.
`--vms`	To display information on volume snapshot service (VSS) (shadow copy).

Examples

To list all snapshots, run:
```
applications snapshots list
```
To list all snapshots on application instance math; run:
```
applications snapshot list --application math
```
To list all snapshots on volume RH within the context of application instance and with replication information, run:
```
applications snapshots list --volume RH --vols --rep
```
To list all snapshots within the context of the application instance and with shadow copy information (VSS), run:
```
applications snapshots list --vols --vms
```

Restore from a snapshot

To create a new volume from a snapshot, use the `applications snapshots restore command.

Usage:

	applications snapshots restore ( (--application=<app_inst> --volume=<vol>) | --cgid=<num> ) --snapshot=<numbers> --suffix=<name>

Options:

Options and arguments	Description
`--application=<app_inst>`	Specify the application instance for the new volume.
`--volume=<vol>`	Specify the newly created volume; replace `<vol>` with your name of choice.
`--cgid=<num>`	Specify the consistency group id for the newly created volume.
`--snapshot=<numbers>`	Specify the snapshot id number, replace `<number>` with the id number of the snapshot.
`--suffix=<name>`	Specify a suffix for the newly created volume. Replace `<name>` with your name of choice.

Examples

To restore snapshot number 3 of volume RH on application instance math to a new volume with the suffix bkp; run:
```
applications snapshots restore --application math --volume RH --snapshot 3 --suffix bkp
```
To restore snapshot number 7 of consistency group id 601 on application instance math to a new volume with suffix jan2022, run:
```
applications snapshots restore --application `math` --cgid 601 --snapshot 7 --suffix jan2022
```

Search for a specific file from snapshots

StorOne SnapONE interface allows you to search for specific data across all snapshots; you can then mount the one needed and use it to extract the required data. To search for a file across all the snapshots, use the applications snapshot files get command.

Usage:

applications snapshots files get --application=<app_inst> --volume=<vol> [--startSnapId=<num_id>] [--endSnapId=<num_id>] (--path=<dir> | --searchField=<txt>)

Options:

Options and arguments	Description
`--application=<app_inst>`	Specify the app instance of the volume. Replace `<app_inst>` with the name of the app instance.
`--volume=<vol>`	Specify the volume from where you took the snapshots. Replace `<vol>` with the volume name.
`--startSnapId=<num_id>`	To specify the snapshot numerical id. File search is to start from these snapshots.
`--endSnapId=<num_id>`	To specify the snapshot numerical id. The file search ends in this snapshot.
`--path=<dir>`	Return all files under a specific directory path. Replace `<dir>` with a directory path
`--searchField=<txt>`	Search for files that contain the `<txt>` string. Replace `<txt>` with your text of choice.

Examples

To search for a file budgets-2010.xls on path /home/accounts/Documents/ over all the snapshots of volume admin in application instance accounts; run:
```
applications snapshots files get --application accounts --volume admin  --path /home/accounts/Documents/budgets-2010.xls 
```
To search for a file budgets-2010.xls on path /home/accounts/Documents/ over all the snapshots starting from snapshot three and ending at snapshot 50 of volume admin in application instance accounts; run:
```
applications snapshots files get --application accounts --volume admin --startSnapId 3 --endSnapId 50 --path /home/accounts/Documents/budgets-2010.xls 
```
To search for all files that contain the text pay Bob over all the snapshots of volume admin in application instance account; run:
```
applications snapshots files get --application accounts --volume admin --searchField "pay Bob"
```

Delete a snapshot

To delete a snapshot (that already exists), use the applications snapshots delete command.

Usage

applications snapshots delete --application=<app_inst> (--cgid=<cgid_num> | --volume=<vol_name>) --snapshots=<numbers...>

Options

Options and arguments	Description
`--application=<app_inst>`	Specify the app instance where you want to delete snapshots. Replace `<app_inst>` with the name of the app instance.
`--cgid=<cgid_num>`	Delete only snapshots from a specific consistency group; replace `<cgid_num>` with the consistency group id number.
`--volume=<vol_name>>`	Delete only snapshots from a specific volume; replace `<vol_name>` with volume name.
`--snapshots=<numbers...>`	Specify the list the snapshots that you want to delete. Replace `<numbers…>` with snapshot id numbers. You may also delete a range of snapshots. For example, `--snapshots 2 3 14-20` delete snapshots 2,3 14,15,16,17,18,19 and 20.

Examples

To delete snapshots 2,3,10,12 from consistency group id 4 in application instance accounts; run:
```
applications snapshots delete --application accounts --cgid 4 --snapshots 1 3 10 12
```

To delete snapshots 6,7,10 14 from volume RH in application instance Oprob; run:

applications snapshots delete --application Oprob --volume RH --snapshots 6 7 10 14

Last updated on 27 Nov 2022
Published on 23 Nov 2022