Use the mode option to specify the backup mode to use when
performing specific backup operations.
Supported Clients
This option is valid
on all supported clients, except Mac OS. The Tivoli® Storage Manager API
does not support this option.
Syntax
- For image backups of client file systems
.-Selective---.
>>-MODE = -+-------------+-------------------------------------><
'-Incremental-'
- For image backup of NAS file systems
.-differential-.
>>-MODE = -+--------------+------------------------------------><
'-full---------'
- For group backups
.-full---------.
>>-MODE = -+--------------+------------------------------------><
'-differential-'
- For backing up VMware virtual machines
.-full----------.
>>-MODE= -+---------------+------------------------------------><
+-incremental---+
+-IFFull--------+
'-IFIncremental-'
- For backing up Microsoft Hyper-V virtual machines
.-full----------.
>>-MODE = -+---------------+-----------------------------------><
+-IFFull--------+
'-IFIncremental-'
Parameters
- Image backup parameters
- selective
- Specifies that you want to perform a full (selective) image backup.
This is the default mode for image backups of client file systems.
- incremental
- Specifies that you want to back up only the data that has changed
since the most recent image backup. If an image backup has not already
been created, then the first backup is a full image backup (mode=selective),
regardless of what mode option you specify.
- Group backup parameters
- full
- Specifies that you want to perform a full backup of group objects.
This is the default for group backups.
- differential
- Specifies that you want to perform a group backup of files that
changed since the last full backup. If there is no copy of a full
image stored on the Tivoli Storage Manager server, a full backup occurs. If a full image exists,
whether it is restorable, or expired and being maintained because
of dependent differential images, specifying MODE=differential sends a differential image backup. If a full image is sent during
a differential backup, it is reflected as a full image using the QUERY
GROUP server command.
A full image can be eligible for expiration
based on versioning or retention (verexists retextra), but still be maintained on the Tivoli Storage Manager server to allow for restoring dependent
differential images. A full image that is eligible for expiration
cannot be selected for restore, so it is not displayed using the QUERY
GROUP server command. The differential image backups that depend on
an "expired" full image can be restored.
- VMware virtual machine parameters
- full
- Specifies that you want to perform an image backup of all objects
on a VMware virtual machine's disks. This is the default mode, and
the only mode that you can use for VMware virtual machine backups,
if you do not have a license for Tivoli Storage
Manager for Virtual Environments: Data Protection for VMware.
- IFFull
- Specifies that you want to perform an incremental-forever-full
backup of a virtual machine. An incremental-forever-full backup backs
up all used blocks on a VMware virtual machine's disks. This mode
requires a Tivoli Storage
Manager for Virtual Environments: Data Protection for VMware license. By default, when the license for Tivoli Storage
Manager for Virtual Environments: Data Protection for VMware is detected, the first backup of a VMware virtual machine is an
incremental-forever-full (mode=iffull) backup, even
if you specify mode=ifincremental (or let the mode option default). Subsequent backups default to mode=ifincremental.
You cannot use this backup mode to
back up a virtual machine if the client is configured to encrypt the
backup data.
For a description of the incremental-forever backup
strategy for VMware virtual machines, see Incremental-forever
backup strategy.
- IFIncremental
- Specifies that you want to perform an incremental-forever-incremental
backup of a virtual machine. An incremental-forever-incremental backup
backs up only the disk blocks that have changed since the last backup.
This mode requires a Tivoli Storage
Manager for Virtual Environments: Data Protection for VMware license. With that license installed, this is the default backup
mode for VMware virtual machine backups.
You cannot use this backup
mode to back up a virtual machine if the client is configured to encrypt
the backup data.
- incremental
- Specifies that you want to back up only new and changed data after
the most recent image backup (full or incremental). If an image backup
has not yet been created, then the first backup is a full image backup,
regardless of the mode option. This mode requires a Tivoli Storage
Manager for Virtual Environments: Data Protection for VMware license.
- Microsoft Hyper-V virtual machine parameters
- full
- Specifies that you want to perform an image backup
of all objects on a Hyper-V virtual machine's disks. This is the default
mode, and only mode that you can use for Hyper-V virtual machine backups
if you do not have a license for Tivoli Storage
Manager for Virtual Environments: Data Protection for Microsoft Hyper-V.
- IFIncremental
- Specifies that you want to perform an incremental-forever-incremental
backup of a Hyper-V virtual machine. An incremental-forever-incremental
backup backs up only the disk blocks that have changed since the last
backup. This mode requires a Tivoli Storage
Manager for Virtual Environments: Data Protection for Microsoft Hyper-V license. With that license installed, this is the default backup
mode for Hyper-V backups.
You cannot use this backup mode to back
up a virtual machine if the client is configured to encrypt the backup
data.
For a description of the incremental-forever backup strategy
for Hyper-V virtual machines, see Incremental-forever
backup strategy.
- IFFull
- Specifies that you want to perform an incremental-forever-full
backup of a Hyper-V virtual machine. An incremental-forever-full backup
backs up all used blocks on a virtual machine's disks. This mode requires
a Tivoli Storage
Manager for Virtual Environments: Data Protection for Microsoft Hyper-V license. By default, when the license for Tivoli Storage
Manager for Virtual Environments: Data Protection for Microsoft Hyper-V is detected, the first backup of a Hyper-V virtual machine is an
incremental-forever-full (mode=iffull) backup, even
if you specify mode=ifincremental (or let the mode option default). Subsequent backups default to mode=ifincremental.
You cannot use this backup mode to
back up a virtual machine if the client is configured to encrypt the
backup data.
Examples
- Task
- Perform a full VM incremental backup
of a VMware virtual machine named vm1.
dsmc backup vm vm1 -mode=incremental
-vmbackuptype=full
- Task
- Perform a backup of a VMware virtual
machine named vm1, using the incremental-forever-incremental
mode to back up only the data that has changed since the last backup.
dsmc backup vm vm1 -mode=ifincremental
-vmbackuptype=full
- Task
- Perform a full VM backup of a Hyper-V VM named msvm1
dsmc backup vm msvm1 -mode=full
-vmbackuptype=hypervfull
- Task
- Perform an incremental-forever-full VM backup of a Hyper-V VM
named msvm1
dsmc backup vm msvm1 -mode=iffull
-vmbackuptype=hypervfull
- Task
- Perform an incremental-forever-incremental backup of a Hyper-V
VM named msvm1
dsmc backup vm msvm1 -mode=ifincremental
-vmbackuptype=hypervfull
- Task
- Perform the NAS image backup of the entire file system.
dsmc backup nas -mode=full -nasnodename=nas1
/vol/vol0 /vol/vol1
- Task
- Perform the NAS image backup of the entire file system.
dsmc backup nas -mode=differential -nasnodename=nas1
{/vol/vol0} {/vol/vol1}
- Task
- Back up the /home/test file space using an image
incremental backup that backs up only new and changed files after
the last full image backup.
dsmc backup image /home/test -mode=incremental -snapshotproviderimage=none
- Task
- Back up the c: drive using an image incremental
backup that backs up only new and changed files after the last full
image backup.
dsmc backup image c: -mode=full
- Task
- Perform a full backup of all the files in filelist /home/dir1/filelist1 to the virtual file space name /virtfs containing
the group leader /home/group1 file.
dscm backup group -filelist=/home/dir1/filelist1
-groupname=group1 -virtualfsname=/virtfs -mode=full
- Task
- Perform a full backup of all the files in filelist c:\dir1\filelist1 to the virtual file space name \virtfs containing
the group leader c:\group1 file.
dsmc backup group -filelist=c:\dir1\filelist1 -groupname=group1
-virtualfsname=\virtfs -mode=incremental -vmbackuptype=fullvm