6.2.12.18 mkvolumebackup

Create a backup of a volume snapshot.

Purpose

The mkvolumebackup command creates a backup of an Exascale volume snapshot.

Syntax

mkvolumebackup --attributes volumeSnapshot=volume-snapshot-ID,destination=backup-destination[,attribute=value]...

Command Options

The command options for the mkvolumebackup command are:

• --attributes: Specifies attributes settings for the volume backup:

  • volumeSnapshot: Identifies the volume snapshot to back up. This attribute must be specified. You can use the lsvolumesnapshot command to find the identifier for each volume snapshot.

  • destination: Specifies the backup destination 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>.

  • You can also specify optional attributes, 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.

    Use the describe mkvolumebackup command to view details about all the volume attributes you can set with mkvolumebackup.

Examples

Example 6-180 Create a Volume Snapshot Backup

This example shows creating a backup for volume snapshot ID vol0002_snap0001_50e52177583f4be4bad68ac20b65001e with the backup being stored at @my-vault1/bkup/.

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

Example 6-181 Create a Volume Snapshot Backup with Optional Attributes

This example shows creating another backup for volume snapshot ID vol0002_snap0001_50e52177583f4be4bad68ac20b65001e. In this case, the backup destination is @my-vault1/bkup2/. Additionally, 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