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
Adding NetBackup credentials for VMware
To back up or restore virtual machines, NetBackup requires logon credentials to the VMware ESX servers, the VMware vCenter Servers, or the VMware vCloud servers. In the NetBackup Administration Console, do the following.
To add NetBackup credentials
- Click Media and Device Management > Credentials > Virtual Machine Servers.
- Click Actions > New > New Virtual Machine Server.
- On the New Virtual Machine Server dialog, enter the name of a virtual machine server (ESX server, vCenter server, or vCloud server).
Note:
Enter the server name in the same format in which it is registered in DNS and in the VMware server (whether short or fully-qualified).
See Using the VMware Managed Object Browser to verify the server name.
Note:
Veritas recommends the use of fully qualified names. The entire name must be properly formed without empty or null elements. For example, a fully-qualified name must include the domain name and not end in a period (.).
Note:
The ESX server name is case-sensitive. Enter the ESX server name exactly as it is in the VMware environment. If the case is wrong, the credential validation fails and states "...expecting <correct_name_of_server>."
NetBackup needs access to this server for either of the following reasons:
To browse the server's virtual machines and back them up.
To use the server as a target for restoring virtual machines.
Use the next dialog to identify the type of this server (vCenter, ESX, or ESX for restore only).
- In the Credentials pane of the New Virtual Machine Server dialog, enter the following:
Virtual machine server type
Select the type of VMware server that NetBackup needs to access:
VMware Virtual Center server
Designates a vCenter (or VirtualCenter) server that manages ESX servers. When you create a policy to back up this server's virtual machines, NetBackup can browse this server and list its virtual machines. If the credentials provide full access privileges to the vCenter server, you can restore virtual machines to this server.
Note:
Do not enter logon credentials for the individual ESX servers that this vCenter server manages. NetBackup needs credentials for the vCenter only.
VMware ESX Server
Designates a standalone ESX server that a vCenter server does not manage. NetBackup can browse the ESX server to present a list of its virtual machines for backup. You can also restore virtual machines to this ESX server. To use the server as a target for restores, enter the credentials that provide full access privileges to the ESX server.
VMware Restore ESX Server
Designates an ESX server to which NetBackup can restore virtual machines. You must enter the credentials that provide full access privileges to the server.
Note:
NetBackup accesses this type of server for restores only, not for backups.
The restore ESX server type has the following advantages:
For large environments with hundreds of hosts, NetBackup may not need full access to the vCenter server. With the restore ESX server type, you can give NetBackup full access to a single ESX server that is dedicated to restore.
SAN-based restores that go directly to a restore ESX server are faster than restores that go through the vCenter server.
Allows restoring to an ESX 5.x or later server that a vCenter 5.x or later server manages. NetBackup uses vCenter to create the virtual machine. NetBackup then writes the .vmdk files directly to the ESX server using the Restore ESX Server credentials to that server.
Note:
VMware does not support the restore of virtual machines directly to an ESX 5.x or later server that vCenter manages. To restore the virtual machine, select the vCenter server as the destination. As an alternative, you can set up an independent ESX server to be used for restores. You must add NetBackup restore credentials for that ESX server by means of the VMware Restore ESX Server type.
For further information on the restore ESX server, refer to the following Veritas tech note:
VMware vCloud Director
Designates a vCloud Director server. NetBackup can browse the vCloud environment on this server to present a list of its virtual machines for backup. You can also restore virtual machines to this server.
Note:
For backup and restore to vCloud Director, both vCloud and vCenter credentials are required (VMware Virtual Center server).
Note:
If the vCloud environment uses a load-balancer to manage multiple cells (nodes), add credentials for the load balancer, not for the cells. If vCloud Director has multiple cells but no load balancer, add credentials for only one of the cells, not for all of them. Note also: If the domain name system (DNS) cannot resolve the name of the load balancer or cell, do the following: Include a line in the hosts file on the VMware backup host that specifies the IP address of the load balancer or cell.
User name
Enter the user name for the virtual machine server. Note that spaces in user names are not allowed.
To enter a domain name with a user name, use a double backslash or enclose the name in single or double quotes, as follows:
domain\\username 'domain\username' "domain\username"
Password
Enter the password for the virtual machine server.
For backup host
You can select a particular backup host for which to validate the credentials. Note that the hosts that appear in the pull-down list can be the following: media servers, or NetBackup clients that have been added under Host Properties, VMware Access Hosts.
For a list of supported backup host platforms, see the NetBackup Software Compatibility List available from the following location:
NetBackup Master Compatibility List
See Adding the VMware backup host to NetBackup.
If For backup host is set to <Any> (the default), NetBackup attempts to validate the credentials using each backup host in turn. NetBackup continues checking only until validation succeeds for a particular backup host or the list of backup hosts is exhausted.
During validation: An invalid user name or password is deleted if you have entered it for the first time and you do not select a backup host. If validation fails for any reason, the entry is removed.
If your VMware backup host is running a version of NetBackup that is earlier than 6.5.4, the credentials cannot be validated. An error message is displayed. You must verify that the credentials you entered are correct for the VMware server. If the credentials are correct, you can ignore the error message.
If the default port number has not been changed on the VMware server, no port specification is required. In that case, make sure that the Connect using port number box is not checked.
If the VMware server has been configured to use a different port, click the Connect using port number box and specify that port number.
- Click OK.
- If your site has multiple standalone ESX servers, use the Virtual Machine Server dialog to enter credentials for each ESX server.
If the NetBackup master server is clustered, do the following on the other master server nodes to verify the credentials for each backup host.
Fail over to the next master server node, to make it the active node.
On the active node, click on Media and Device Management > Credentials > Virtual Machine Servers and double-click on the virtual machine server credential.
In the For backup host field, select a particular backup host (do not select Any).
If the backup host does not appear in the list, you must add the correct credentials for the backup host. (Click Actions > New > New Virtual Machine Server.)
Click OK.
NetBackup validates the credentials.
Double-click the same virtual machine server credential and validate the credentials for another backup host (if any).
For other master server nodes, repeat step 7.
More Information