IBM Tivoli Storage Manager, Version 7.1

Vmenabletemplatebackups

The vmenabletemplatebackups option specifies whether the client backs up VMware template virtual machines when it protects virtual machines in a vCenter server. VMware templates virtual machines cannot be backed up when they are in an ESXi host because ESXi does not support templates.

When this option is enabled, you can include VMware template machines in full VM backup operations. You use the existing Backup VM command and the DOMAIN.VMFULL option to specify the virtual machines to include in the backup operation.

Incremental backups are not supported and snapshots are not taken, so you must use MODE=FULL or MODE=IFFULL. Use MODE=IFFULL to force a new backup of VMware template virtual machines, even if they were not changed since the last backup.

When vmenabletemplatebackups is enabled, any backup process that is initiated by using MODE=INCREMENTAL is performed by using MODE=FULL. Likewise, any backup process that is initiated by using MODE=IFINCREMENTAL is processed by using MODE=IFFULL. VMware template VMs are included in a backup only if they were changed since the last backup occurred.

With this option enabled, make sure that the vmvstortransport options include NBDSSL or NBD. Using only the SAN or HOTADD transport modes with this option enabled causes backups of the template machines to fail.

Supported clients

Linux operating systems This option can be used with supported x86_64 Linux clients.

Windows operating systems This option can be used with supported Windows clients.

Options file

Linux operating systems You can set this option on the command line, in the client system options file (dsm.sys), client options file (dsm.opt), or on the server in a client options set.

Windows operating systems You can set this option on the command line, in the client options file (dsm.opt), or on the server in a client options set.

Linux operating systems Windows operating systems You can also set it in the preferences editor on the VM Backup tab (select the Backup virtual machine templates option).

Syntax


                            .-No------.   
>>-VMENABLETEMPlatebackups--+-+-----+-+------------------------><
                              '-Yes-'

Parameters

No: Specifies that template virtual machines are not included in full VM backup operations; this is the default setting.
Yes: Specifies that template VMs are included in full VM backup operations.

Examples

Options file

vmenabletemplatebackups yes

Command line

Back up a VMware template VM

dsmc backup vm vmname -VMENABLETEMPLATEBACKUPS=YES

where vmname is the template machine name.

Command line

Restore a VMware template VM to the same location and name

dsmc restore vm vmname -VMENABLETEMPLATEBACKUPS=YES

where vmname is the template machine name.

Command line

Restore a template virtual machine to a new location

dsmc restore vm vmname -vmname=win7x64 
  -datastore=datastore22 -host=supersht.labx.com 
   -datacenter="Lab Center" -VMENABLETEMPLATEBACKUPS=YES

where vmname is the template machine name. "win7x64" is the new template VM name. The new data center, host, and datastore are also included.

Feedback