AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systems

Mode

Use the mode option to specify the backup mode to use when performing specific backup operations.

The mode option has no effect on a when backing up a raw logical device.

You can use the mode option with the following backup commands:

backup image
To specify whether to perform a selective or incremental image backup of client file systems.
AIX operating systemsOracle Solaris operating systemsWindows operating systemsbackup nas
To specify whether to perform a full or differential image backup of NAS file systems.
backup group
To specify whether to perform a full or differential group backup containing a list of files from one or more file space origins.
backup vm
Linux operating systemsWindows operating systemsFor VMware virtual machines, this parameter specifies whether to perform a full, incremental, incremental-forever-full, or incremental-forever-incremental backup of VMware virtual machines.
Windows operating systemsFor Microsoft Hyper-V virtual machines, this parameter specifies whether to perform a full image backup, an incremental-forever full backup, or an incremental-forever-incremental backup of Hyper-V virtual machines.

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
Read syntax diagramSkip visual syntax diagram
           .-Selective---.   
>>-MODE = -+-------------+-------------------------------------><
           '-Incremental-'   

AIX operating systemsOracle Solaris operating systemsWindows operating systems
For image backup of NAS file systems
Read syntax diagramSkip visual syntax diagram
           .-differential-.   
>>-MODE = -+--------------+------------------------------------><
           '-full---------'   

For group backups
Read syntax diagramSkip visual syntax diagram
           .-full---------.   
>>-MODE = -+--------------+------------------------------------><
           '-differential-'   

Linux operating systemsWindows operating systems
For backing up VMware virtual machines
Read syntax diagramSkip visual syntax diagram
          .-full----------.   
>>-MODE= -+---------------+------------------------------------><
          +-incremental---+   
          +-IFFull--------+   
          '-IFIncremental-'   

Windows operating systems
For backing up Microsoft Hyper-V virtual machines
Read syntax diagramSkip visual syntax diagram
           .-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.
AIX operating systemsOracle Solaris operating systemsWindows operating systems
NAS backup parameters
differential
This is the default for NAS objects. Specifies that you want to perform a NAS 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 NASBACKUP 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 NASBACKUP server command. The differential image backups that depend on an "expired" full image can be restored.

full
Specifies that you want to perform a full backup of NAS file systems.
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.

Linux operating systemsWindows operating systems
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 Backup and restore types.

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.
Windows operating systems
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
Linux operating systemsWindows operating systemsPerform a full VM incremental backup of a VMware virtual machine named vm1.
dsmc backup vm vm1 -mode=incremental 
 -vmbackuptype=full
Task
Linux operating systemsWindows operating systemsPerform 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
Windows operating systemsTask
Windows operating systemsPerform a full VM backup of a Hyper-V VM named msvm1
dsmc backup vm msvm1 -mode=full 
 -vmbackuptype=hypervfull
Windows operating systemsTask
Windows operating systemsPerform an incremental-forever-full VM backup of a Hyper-V VM named msvm1
dsmc backup vm msvm1 -mode=iffull 
 -vmbackuptype=hypervfull
Windows operating systemsTask
Windows operating systemsPerform an incremental-forever-incremental backup of a Hyper-V VM named msvm1
dsmc backup vm msvm1 -mode=ifincremental 
 -vmbackuptype=hypervfull
AIX operating systemsOracle Solaris operating systemsTask
AIX operating systemsOracle Solaris operating systemsPerform the NAS image backup of the entire file system.
dsmc backup nas -mode=full -nasnodename=nas1 
 /vol/vol0 /vol/vol1
Windows operating systemsTask
Windows operating systemsPerform the NAS image backup of the entire file system.
dsmc backup nas -mode=differential -nasnodename=nas1 
 {/vol/vol0} {/vol/vol1}
AIX operating systemsLinux operating systemsTask
AIX operating systemsLinux operating systemsBack 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
Windows operating systemsTask
Windows operating systemsBack 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
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsTask
AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsPerform 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
Windows operating systemsTask
Windows operating systemsPerform 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