3.9.5.1 Create a Volume Backup

A volume backup is a backup of an Exascale volume snapshot, which provides a consistent point-in-time copy of the volume.

You can use the ESCLI mkvolumebackup command to create an Exascale volume backup, which may be stored as a file copy in an Exascale vault.

To create a volume backup, use the mkvolumebackup command and specify (at least):

• The identifier for the volume snapshot that you want to back up.

  You can use the lsvolumesnapshot command to find the identifier for the volume snapshot you want to back up.

• The destination of the backup file as a location in an Exascale vault.

  If the destination path ends with a forward slash (/), a file name is automatically created using the following pattern: vol_<volume-ID>_bkp_<backup-ID>.

For example, the following command creates a backup of the specified volume snapshot to @my-vault1/bkup/.

@> mkvolumebackup --attributes volumeSnapshot=vol0002_snap0001_3c0e9866d66345afbb316472f0bce825,destination=@my-vault1/bkup/

You can also specify optional attributes for a volume backup, including a user-defined name that you can use to easily identify the backup and Exascale file storage attributes that you want to associate with the backup file.

For example, the following command creates a backup of the specified volume snapshot to @my-vault1/bkup2/. In this case, the backup file content type is explicitly set to RECO and the backup name is set to my-backup2.

@> mkvolumebackup --attributes volumeSnapshot=vol0002_snap0001_3c0e9866d66345afbb316472f0bce825,destination=@my-vault1/bkup2/,contentType=RECO,name=my-backup2

The mkvolumebackup command completes at the beginning of the backup operation. See also Monitor the Progress of a Volume Backup or Restore.