Skip to main content

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 --all|(--application=<name> --volume=<name>)|(--cgid=<numbers>) [--vss]

Options:

Options and arguments Description
-all Take a snapshot on all volumes within the system.
--application=<app> Specify the name of the application containing the volume that you want to take a snapshot of. Replace <app> with the name of the application.
--volume=<vol> The volume you want to take a snapshot of. Replace <vol> with the name of the volume. If volume is in a consistency group with multiple volumes, a snapshot is taken on all volumes in the consistency group.
--cgid=<nums> The consistency group IDs that you want to take a snapshot of. Replace <nums> with the consistency group IDs.
--vss Take a Volume Shadow Copy Service (VSS) snapshot.

Examples

  1. To take a snapshot of volume RH on application instance math; run:

    applications snapshot take --application math --volume RH
    
  2. 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]

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.

Examples

  1. To list all snapshots, run:

    applications snapshots list
    
  2. To list all snapshots on application instance math; run:

    applications snapshot list --application math
    
  3. 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
    
  4. 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

  1. 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
    
  2. 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
    

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

  1. 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
    
  2. 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