Veritas NetBackup™ 8.0 for VMware Administrator's Guide
- Introduction
- About NetBackup for VMware
- Updates to this guide for NetBackup 8.0
- About the virtual machine backups that include database data
- About the NetBackup appliance as a VMware backup host
- NetBackup for VMware components
- Appliance as backup host: component overview
- Media servers as backup or discovery hosts
- Overview of the VMware backup process
- NetBackup for VMware license requirement
- NetBackup for VMware terminology
- Select Client wizard panel
- Required tasks: overview
- Notes and prerequisites
- NetBackup for VMware prerequisites
- NetBackup for VMware: notes and restrictions
- Notes on VMware Virtual Volumes (VVols)
- NetBackup IPv6 parameter required for backups in VMware IPv6 environments
- NetBackup for VMware: notes on Linux virtual machines
- Notes on the NetBackup appliance as a VMware backup host
- NetBackup for VMware support for SAN multi-pathing
- NetBackup for VMware support for fault tolerant VMs
- NetBackup character restrictions for virtual machine display names and other vSphere objects
- In the policy Query Builder, display names, resource pool names, and vApp names are case-sensitive
- Notes on the hotadd transport mode
- Notes and limitations for tag usage in VMware Intelligent Policy queries
- Notes and limitations for the backup and restore of VMware tag associations
- Configure NetBackup communication with VMware
- Configure NetBackup policies for VMware
- Configuring a VMware policy from the Policy Wizard
- Configuring a VMware policy from the Policies utility
- Limit jobs per policy on the Attributes tab (for VMware)
- VMware backup options
- VMware backup host
- Optimizations options (VMware)
- Primary VM identifier options (VMware)
- Existing snapshot handling options (VMware)
- Transport modes options (VMware)
- Application protection options (VMware)
- VMware - Advanced Attributes dialog
- About the Post vCenter events option (VMware Advanced Attributes)
- About the Exclude disk options for Virtual disk selection
- Virtual disk selection options: an example to avoid
- Restoring data from the backups that excluded the boot disk or data disks
- Browse for VMware Virtual Machines
- Limiting the VMware servers that NetBackup searches when browsing for virtual machines
- Virtual machine host names and display names should be unique if VMs are selected manually in the policy
- Primary VM identifier option and manual selection of virtual machines
- About incremental backups of virtual machines
- Configuring incremental backups
- Storage Foundation Volume Manager volumes in the virtual machine
- About older NetBackup policies and pre-7.x backup hosts
- Configure a VMware Intelligent Policy
- About automatic virtual machine selection for NetBackup for VMware
- Support and use of VMware tag associations
- The basics of a NetBackup query rule
- Important notes on automatic virtual machine selection
- NetBackup requirements for automatic virtual machine selection
- Automatic virtual machine selection: Task overview
- Options for selecting VMware virtual machines
- Configuring automatic virtual machine selection
- Editing an existing query in Basic Mode
- Using the Query Builder in Advanced Mode
- AND vs. OR in queries
- Examples for the NetBackup Query Builder
- The IsSet operator in queries
- About selecting virtual machines by means of multiple policies
- Order of operations in queries (precedence rules)
- Parentheses in compound queries
- Query rules for resource pools
- Query rules for datacenter folders (host folder)
- Query rules for duplicate names
- Query rules for tags
- Query Builder field reference
- Test Query screen for VMware
- Test Query: Failed virtual machines
- Effect of Primary VM identifier parameter on Selection column in Test Query results
- Effect of Primary VM identifier parameter on VM Name column in Test query results
- Refreshing the display of virtual environment changes in the Query Builder
- Reduce the size of backups
- Back up virtual machines
- Use Accelerator to back up virtual machines
- About the NetBackup Accelerator for virtual machines
- Accelerator: full vs. incremental schedules
- How the NetBackup Accelerator works with virtual machines
- Accelerator notes and requirements for virtual machines
- Accelerator forced rescan for virtual machines (schedule attribute)
- Accelerator requires the OptimizedImage attribute
- Accelerator backups and the NetBackup catalog
- Accelerator messages in the backup job details log
- NetBackup logs for Accelerator with virtual machines
- About reporting the amount of Accelerator backup data that was transferred over the network
- Replacing the Accelerator image size with the network-transferred data in NetBackup command output
- Restore virtual machines
- Restore notes and restrictions
- Restore notes and restrictions on Linux
- Restoring the full VMware virtual machine
- Virtual Machine Recovery dialog boxes (restore to original location)
- Virtual Machine Recovery dialogs boxes (restore to alternate location)
- Recovery Destination dialog box (restore to alternate location)
- Recovery Options dialog box (restore to alternate location)
- Select ESX server dialog box (restore to alternate location)
- Select Folder dialog box (restore to alternate location)
- Select Datastore or Datastore Cluster dialog box (restore to alternate location)
- Storage Destination dialog box (restore to alternate location)
- Network Connections and Other Recovery Options dialog box (restore to alternate location)
- Perform Recovery dialog box (restore to alternate location)
- About VMware virtual machine disk restore
- Restoring VMware virtual machine disks
- Determining the backup image ID from which to restore a VMware virtual machine disk
- Creating the VMware virtual machine disk restore file
- Modifying the virtual machine disk restore file
- Validating the virtual machine disk restore file
- Restoring the virtual machine disk or disks
- VMware virtual machine disk restore file
- About restore of individual files
- Restoring individual files
- How NetBackup handles VMware tag associations at restore
- Browse and search virtual machines for restore
- If the recovery host is not at the same NetBackup release level as the backup host
- Restore virtual machines with Instant Recovery
- About Instant Recovery for VMware
- Task overview for Instant Recovery for VMware
- Performance recommendations for Instant Recovery for VMware
- Requirements for Instant Recovery for VMware
- Notes on Instant Recovery for VMware
- Restarting the Client for NFS service on a Windows restore host
- Instant Recovery options on the nbrestorevm command
- Restoring a virtual machine with Instant Recovery for VMware
- Restoring a virtual machine to a different location with Instant Recovery for VMware
- Restoring individual files with Instant Recovery for VMware while the current virtual machine is running
- Job types for Instant Recovery for VMware
- Reactivating a restored virtual machine with Instant Recovery for VMware
- Use NetBackup for vCloud Director
- About NetBackup for vCloud Director
- Notes on creating a NetBackup policy for vCloud
- Notes on restoring virtual machines into vCloud Director
- Restoring virtual machines into vCloud Director
- Reducing the time required for VM discovery in a large vCloud environment
- Virtual machine recovery dialog boxes for vCloud Director
- Recovery Destination dialog box
- Recovery Options dialog box (vCloud Director)
- Recovery vApp Options for vCloud Director dialog box (restore to original location)
- Virtual Machine Options dialog box for vCloud Director
- Perform Recovery dialog box for vCloud Director
- Recovery Options dialog box for vCloud Director (restore to alternate location)
- Recovery vApp Options for vCloud Director dialog box (restore to alternate location)
- Select a vApp dialog box
- Recovery Destination Options for vCloud Director dialog box (restore to alternate location)
- Virtual Machine Options (restore to alternate location)
- Network connections (restore to alternate location)
- Perform Recovery dialog box for vCloud Director (restore to alternate location)
- Best practices and more information
- Troubleshooting
- Notes on troubleshooting NetBackup for VMware
- Beware of unsupported backup host
- How to determine the ESX network that NetBackup used for the backup or restore
- NetBackup logging for VMware
- Configuring VxMS logging
- Format of the VxMS core.log and provider.log file names
- Configuring the VDDK logging level
- Preventing browsing delays caused by DNS problems
- Changing the browsing timeout for virtual machine discovery
- Changing timeout and logging values for vSphere
- Credentials for VMware server are not valid
- Snapshot error encountered (status code 156)
- The origin of the snapshot failure: NetBackup or VMware?
- Conflict between NetBackup and VMware Storage vMotion with vSphere 5.0 or later
- The restore fails when you restore individual files to a virtual machine that has NetBackup client software
- Backup or restore job hangs
- VMware SCSI requirement for application quiesce on Windows 2008 or later
- Mount point missing on a restored Windows virtual machine
- Mount points not available when restoring files from a Linux virtual machine
- Remove the Consolidate Helper snapshot
- Invalid client error when you restore files using NetBackup BAR interface installed on the virtual machine
- VMware virtual machine does not restart after restore
- NetBackup job fails due to update tasks on the VMware server
- The vSphere interface reports that virtual machine consolidation is needed
- The Enable file recovery from VM backup option does not work if a volume disk set contains a mixture of disk types
- Linux VMs and persistent device naming
- For a VMware virtual machine with Windows dynamic disks, a restore from incremental backup fails with a Windows restore host and the hotadd transport mode
- Simultaneous hotadd backups (from the same VMware backup host) fail with status 13
- Troubleshooting VMware tag usage
- Ensuring that guest customizations can be restored in vCloud Director
- Troubleshooting vmdk restore to existing VM
- Appendix A. NetBackup commands to back up and restore virtual machines
- Using NetBackup commands to create a VMware policy
- Using the nbdiscover command to search the virtual environment
- Using the nbrestorevm command to restore virtual machines into vSphere
- Using the nbrestorevm command to restore virtual machines into vCloud Director
- Using the nbrestorevm command to restore virtual machine disks
- The nbrestorevm -R rename file for restoring virtual machines
- Logs for troubleshooting the nbrestorevm command
- Query format and examples for searching virtual machine backups
- Allowing other servers or clients to restore virtual machines
- Appendix B. Configuring services for NFS on Windows
- About installing and configuring Network File System (NFS) for Granular Recovery Technology (GRT)
- About configuring services for NFS on Windows 2012 (NetBackup for VMware)
- About configuring services for NFS on Windows 2008 and 2008 R2 (NetBackup for VMware)
- Disabling the Server for NFS (NetBackup for VMware)
- Disabling the Client for NFS on the media server (NetBackup for VMware)
- About configuring Services for Network File System (NFS) on the Windows 2003 R2 SP2 NetBackup media server and NetBackup clients (NetBackup for VMware)
- Configuring a UNIX media server and Windows backup or restore host for Granular Recovery Technology (NetBackup for VMware)
- Configuring a different network port for NBFSD (NetBackup for VMware)
- Appendix C. The Reuse VM selection query results option
- Appendix D. Backup of VMware raw devices (RDM)
- Appendix E. SYMCquiesce utility for Linux virtual machines
NetBackup for VMware: notes and restrictions
Note the following about NetBackup for VMware:
For information on supported VMware versions and on supported platforms for the backup host, see the NetBackup Enterprise Server and Server OS Software Compatibility List available from the following location:
NetBackup Master Compatibility List
For additional support information on NetBackup for VMware, see Support for NetBackup in virtual environments:
NetBackup for VMware does not support the option on the policy Attributes tab of the Administration Console.
NetBackup supports these features as follows:
For Instant Recovery, use the nbrestorevm command.
For SLP management of snapshots, use Replication Director.
For more information, see the NetBackup Replication Director Solutions Guide.
NetBackup allows up to 31 snapshots per virtual machine. If the virtual machine has more than 31 snapshots, the backup may fail with status 13. Messages similar to the following appear in the NetBackup job details:
10/18/2012 4:56:59 PM - Critical bpbrm(pid=4604)from client Umesh_w2k3_hypervm33: FTL - vSphere_freeze: Unable to remove existing snapshot, too many existing snapshots (91). 10/18/2012 4:56:59 PM - Critical bpbrm(pid=4604) from client Umesh_w2k3_hypervm33: FTL - VMware_freeze: VIXAPI freeze (VMware snapshot) failed with 26: SYM_VMC_REMOVE_SNAPSHOT_FAILED
As a reminder to consolidate or delete snapshots, the NetBackup detailed status provides the following message when the number of snapshots exceeds 15:
Umesh_w2k3_hypervm33: WRN - vSphere_freeze: VM has 16 existing snapshots. Snapshots may start failing if this number exceeds 32
To back up a virtual machine that has more than 31 snapshots, consolidate or delete the existing snapshots. Then rerun the backup.
Note:
Replication Director backups allow more than 31 snapshots per virtual machine.
If the number of snapshot delta files for a VM's vmdk exceeds 32, snapshot creation fails. A message similar to the following appears in the NetBackup detailed status:
Umesh_w2k3_hypervm33: FTL - vSphere_freeze: Unable to proceed with snapshot creation, too many existing delta files(50).
As a reminder to consolidate or delete snapshots, the NetBackup detailed status provides the following message when a vmdk's delta files exceed 16:
Umesh_23k3_hypervm33: WRN - vSphere_freeze: VM has 17 existing delta files for vmdk Umesh_23k3_hypervm33.vmdk. Snapshots may start failing if this number exceeds 31
Delta files can accumulate if the VM's snapshots are not deleted or consolidated. Consolidate or delete the existing snapshots, then rerun the backup.
NetBackup for VMware cannot back up the data on an independent disk, because an independent disk cannot be captured with a snapshot. The backup succeeds but the backup image contains no data for the independent disk.
To back up the data on an independent disk, install a NetBackup client on the virtual machine. You can configure NetBackup to back up the virtual machine and any independent disks as if the client was installed on a physical host. You can restore the virtual machine and then restore the independent disk as a separate job.
NetBackup for VMware does not back up standard iSCSI LUNs that are connected to the virtual machine. If the virtual machine has an iSCSI LUN, the backup succeeds but the drive that represents the LUN is not backed up.
Note: NetBackup for VMware supports datastores over iSCSI.
Several notes and limitations apply to Linux virtual machines.
If a Windows virtual machine includes Veritas Storage Foundation volumes, the option is not supported.
See Storage Foundation Volume Manager volumes in the virtual machine.
During an incremental backup with the option (with or without block-level incremental backup), any files that had been moved or renamed are not backed up. Those files are not available when you browse to restore individual files from that incremental backup.
Note:
When you restore the entire VM from a block-level incremental backup, the file metadata is updated and the moved or renamed files reflect the updated metadata.
VMware virtual machine templates are for cloning virtual machines: They cannot be turned on and used as functioning VMs. As a result, VMware has imposed the following restrictions on backup and restore of virtual machine templates:
A virtual machine template cannot be captured in a snapshot. NetBackup backs up the template to the designated storage unit.
Block level incremental backup (BLIB) cannot be used when backing up a virtual machine template.
Note:
As a result of this restriction, NetBackup Accelerator cannot be used to back up VMware virtual machine templates.
A virtual machine template cannot be backed up over a SAN. You must configure the NetBackup policy to use a local network transfer type, such as nbd. Likewise, the restore of a template must be conducted over a local network.
Note:
You can use the Query Builder in the NetBackup policy to create rules for automatic selection of virtual machine templates.
VMware does not support non-ASCII characters in virtual machine display names or in other objects that are associated with the virtual machine. (Examples are annotations, floppy image name, parallel port or serial port file name, and CD-ROM ISO name.) Note that the same character restrictions also apply when creating vCloud Director objects.
For VMware's list of the special characters that may cause issues, see the following VMware article:
Troubleshooting issues with virtual machines or datastore names containing special characters (2046088)
http://kb.vmware.com/kb/2046088
For a list of objects that VMware does not support with non-ASCII characters, see the following VMware article:
Troubleshooting errors resulting from non-ASCII names (1003866)
http://kb.vmware.com/kb/1003866
In keeping with VMware's position, NetBackup does not support non-ASCII characters in display names or in other vSphere objects. Veritas recommends that you follow VMware's guidelines in naming vSphere objects.
In addition, NetBackup has its own restrictions on characters in display names.
See NetBackup character restrictions for virtual machine display names and other vSphere objects.
Note:
If the virtual machine display name contains non-ASCII characters, the backup may succeed but the restore fails. To restore the virtual machine, configure a restore to an alternate location. On the Recovery Options dialog, change the display name to contain ASCII characters only.
For dual-boot virtual machines, NetBackup does not support the following policy options:
Enable file recovery from VM backup
Exclude deleted blocks
Exclude swap and paging files
Exclude boot disk (Advanced)
Exclude data disks (Advanced)
NetBackup for VMware does not support the display names that end in a period. If the policy's option is VM display name, any VM with a period at the end of the name is not backed up.
To back up a virtual machine while Storage vMotion migrates its files, NetBackup must conduct the backup through the vCenter server.
See Conflict between NetBackup and VMware Storage vMotion with vSphere 5.0 or later.
Several notes and limitations apply to the automatic selection of virtual machines for backup (Virtual Machine Intelligent Policy).
See NetBackup requirements for automatic virtual machine selection.
For hotadd backup or restore: The virtual machine to back up (or restore) and the virtual machine that contains the hotadd backup host must reside in the same VMware data center.
NetBackup for VMware supports Windows NTFS file encryption and compression, for backup and restore. However, NetBackup for VMware does not support NetBackup's compression or encryption options (in the NetBackup policy attributes).
For Windows, UNIX, or Linux guest operating systems: NetBackup for VMware does not support any type of compression or encryption, whether they are set in NetBackup or in the guest OS (such as BitLocker).
Note:
The compressed Windows NTFS files are backed up and restored as compressed files.
Storage optimization cannot be used if a snapshot exists on the virtual machine when VMware Changed Block Tracking is turned on.
If the policy's option is set to VM hostname, note: NetBackup cannot select a VMware virtual machine for backup if it cannot obtain an IP address for the virtual machine.
For Exchange, SharePoint, and SQL applications, NetBackup for VMware supports Granular Recovery Technology (GRT) restores from full backups only.
Exchange, SharePoint, and SQL Server databases are not cataloged and backed up if they exist in mount point volumes.
If a policy is changed from manual selection to Intelligent policy (or vice versa), the next backup of the VM is a regular full backup, even if a backup already exists for that VM.
For example:
In a new VMware policy, the option on the Clients tab is used to select a VM. The first backup from the policy runs.
In the policy, an Intelligent Policy query is used to select the same VM, and the VM is backed up a second time. Because of the switch from manual selection to query-based selection, this second backup is a regular full backup. Note that for a policy that uses (BLIB) or BLIB plus Accelerator, the backup processing is not limited to changed blocks only.
For the second backup, the Detailed status log includes a message similar to the following:
There is no complete backup image match, a regular full backup will be performed.
The same backup behavior occurs if the policy's VM selection is switched from query-based to manual selection: The second backup is a regular full backup.