IBM Tivoli Storage Manager, Version 7.1

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.
backup 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: To specify whether to perform a full, incremental, incremental-forever-full, or incremental-forever-incremental backup of VMware virtual machines. The incremental mode and the incremental-forever-incremental modes can only be used if you have a license for IBM® Tivoli® Storage Manager for Virtual Environments.; For Microsoft Hyper-V virtual machines, you must specify vmbackuptype=hypervfull and use mode=full.

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

All of these modes, except for full mode, require a IBM Tivoli Storage Manager for Virtual Environments license.


           .-IFIncremental-.   
>>-MODE = -+---------------+-----------------------------------><
           +-full----------+   
           +-incremental---+   
           '-IFFull--------'

For full VM backup of Microsoft Hyper-V virtual machines


           .-full-.   
>>-MODE = -+------+--------------------------------------------><

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.

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.

VMware virtual machine parameters

The incremental forever backup strategy is described in Incremental forever strategy.

full

Specifies that you want to perform an image backup of all objects on a VMware virtual machine's disks.

IFFull

Specifies that you want to perform an incremental-forever-full backup of a VMware virtual machine. An IFFull backup backs up all used blocks on a VMware virtual machine's disks. To use this mode, you must be licensed to use Tivoli Storage Manager for Virtual Environments .

You cannot use this backup mode to back up a VMware 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 made, then the first backup is a full image backup, regardless of the mode option.

IFIncremental

Specifies that you want to perform an incremental-forever-incremental backup of a VMware virtual machine. An IFIncremental backup backs up only the disk blocks that have changed since the last backup. This is the default mode for VMware virtual machine backup operations. To use this mode, you must be licensed to use IBM Tivoli Storage Manager for Virtual Environments.

You cannot use this backup mode to back up a VMware virtual machine if the client is configured to encrypt the backup data.

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 only mode that you can specify for Hyper-V backups.

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 Windows Hyper-V VM named msvm1

dsmc
backup vm msvm1 -mode=full -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.

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.

backup group -filelist=c:\dir1\filelist1 -groupname=group1
-virtualfsname=\virtfs -mode=incremental -vmbackuptype=fullvm

Feedback