Veritas NetBackup™ for VMware Administrator's Guide
- Introduction
- Required tasks: overview
- Notes and prerequisites
- Configure NetBackup communication with VMware
- Adding NetBackup credentials for VMware
- Configure NetBackup policies for VMware
- VMware backup options
- Exclude Disks tab
- Configure a VMware Intelligent Policy
- Reduce the size of backups
- Back up virtual machines
- Use Accelerator to back up virtual machines
- Restore virtual machines
- Restoring the full VMware virtual machine
- Virtual Machine Recovery dialog boxes (restore to original location)
- Virtual Machine Recovery dialogs boxes (restore to alternate location)
- Restoring VMware virtual machine disks by using Backup, Archive, and Restore
- Restoring VMware virtual machine disks by using NetBackup commands
- Restoring individual VMware virtual machine files
- Browse and search virtual machines for restore
- Restore virtual machines with Instant Recovery
- Use NetBackup for vCloud Director
- Virtual machine recovery dialog boxes for vCloud Director
- Best practices and more information
- Troubleshooting
- Appendix A. NetBackup commands to back up and restore virtual machines
- Using NetBackup commands to create a VMware policy
- Appendix B. Configuring services for NFS on Windows
- About configuring services for NFS on Windows 2012 or 2016 (NetBackup for VMware)
- About configuring services for NFS on Windows 2008 and 2008 R2 (NetBackup for VMware)
- Appendix C. The Reuse VM selection query results option
- Appendix D. Backup of VMware raw devices (RDM)
Reducing the time required for VM discovery in a large vCloud environment
NetBackup backup policies for vCloud Director use query rules to automatically search and filter the vCloud environment. By default, the query rules search all the vCloud Director (vCD) servers in your environment. If the environment contains many vCloud servers with many vApps, VM discovery may take a long time. You can speed up VM discovery by limiting the search to specific vCloud servers or vApps.
The following is an example of a policy Query Builder rule that searches all vCloud servers and all vApps:
vmware:/?filter=vCDvApp Contains "vapp1"
To limit the search to particular servers or vApps, insert an additional vCloud expression in the Query Builder rule as explained in the following procedure.
To use the Administration Console to reduce the time required for VM discovery in a vCloud environment
- In the NetBackup Administration Console, open the vCloud Director policy.
- On the Clients tab of the policy, make sure Select automatically through VMware Intelligent Policy query and Enable vCloud Director integration are selected.
- In the Query Builder, click Advanced.
- Under Query (Advanced Mode), create one or more rules to search for VMs in specific vCloud Director servers or vApps.
To create two or more rules, you must be in Advanced Mode (not Basic Mode).
Each query rule must begin on its own line.
You can use the following types of rules:
To search for VMs in a particular vCloud server
vmware://<vCloud_server>?filter=<filter>
To search for VMs in a particular vApp or vApp template
vmware:/vApp/vapp-<vApp_id>?filter=<filter>
vmware:/vAppTemplate/vappTemplate-<vAppTemplate_id>?filter=<filter>
To search for VMs in a particular vApp or vApp template on a particular vCloud server
vmware://<vCloud_server>/vApp/vapp-<vApp_id>?filter=<filter>
vmware://<vCloud_server>/vAppTemplate/vappTemplate- <vAppTemplate_id>?filter=<filter>
The following detail from a Query Builder screen (Advanced Mode) shows two rules for narrowing the search within a vCloud environment. The first rule searches a single vApp on vCloud server
vCD1.acme.com
. The second rule searches a different vApp on vCloud servervCD2.acme.com
. For help in finding the vApp identifiers, see the following topic:Example Query Builder rules for searching specific vCloud servers or vApps
For two or more search rules, you must enable multiple organizations for the policy.
In the policy VMware tab, click Advanced.
In the VMware - Advanced Attributes dialog, enable Multiple organizations per policy.
To use the nbdiscover command instead of the policy Query Builder, see the following topic:
Examples of the nbdiscover command for searching specific vCloud servers or vApps
In the NetBackup policy Query Builder, you can speed up discovery of vCloud VMs by using the following types of query rules:
To search for VMs in a particular vCloud server (note the double forward slash):
vmware://<vCloud_server>?filter=<filter>
Example rule:
vmware://vCD1.acme.com?filter=vCDvApp Contains "vapp1"
NetBackup searches for VMs only in the vCD1.acme.com server.
To search for VMs in a particular vApp or vApp template (note the single forward slash):
vmware:/vApp/vapp-<vApp_id>?filter=<filter>
vmware:/vAppTemplate/vappTemplate-<vAppTemplate_id>?filter=<filter>
The vApp_id or vAppTemplate_id is the identifier on the end of the vCloud vApp href. You can use a vCloud Director REST API query to find the identifier.
For example, the following is a REST API query for a vApp that is named
acmvappvm7
:https://acmvm5.acme.com/api/query?type=adminVApp&filter= name==acmvappvm7
The following example is an excerpt from the API query Response:
href="https://acmvm5.acme.com/api/vApp/vapp-afaafb99 -228c-4838-ad07-5bf3aa649d42"
In this example, the vApp identifier for vApp
acmvappvm7
isafaafb99-228c-4838-ad07-5bf3aa649d42
. You can use this identifier in a NetBackup Query Builder rule as follows:vmware:/vApp/vapp-afaafb99-228c-4838-ad07-5bf3aa649d42 ?filter=Displayname Contains "prod"
Where
Displayname Contains "prod"
is an example filter for the rule.To search for VMs in a particular vApp on a particular vCloud Director server:
vmware://<vCloud_server>/vApp/vapp-<vApp_id>?filter=<filter>
Example rule:
vmware://vCD1.acme.com/vApp/vapp-4c0d9722-80a4-4f19-b636-72ebf48e4e71 ?filter=Displayname Contains "prod"
To search additional vCloud Director servers or vApps from the same backup policy, include additional query rules in the Query Builder.
Note:
To enter multiple rules in the Query Builder, you must be in Advanced Mode.
Note:
Start each rule on its own line.
Example of two rules in the Query Builder:
vmware://vCD1.acme.com/vApp/vapp-4c0d9722-80a4-4f19-b636-72ebf48e4e71 ?filter=Displayname Contains "prod" vmware://vCD2.acme.com/vApp/vapp-5c0c9833-80a4-4f19-b636-72ebf48e4e63 ?filter=Displayname Contains "prod"
Use the following nbdiscover command format to search for VMs in specific vCloud servers or vCloud vApps:
nbdiscover "<vCloud_query>" - job_info "snaparg=enable_vCloud=1"
Example 1. Search for VMs in vCloud server vCD1.acme.com
only:
nbdiscover -noxmloutput "vmware://vCD1.acme.com?filter=DisplayName Contains 'prod1'" - job_info "snaparg=enable_vCloud=1"
The -noxmloutput option displays one VM per line.
Example 2. Search for VMs in a vCloud vApp that has the following vApp identifier:
4c0d9722-80a4-4f19-b636-72ebf48e4e71
nbdiscover -noxmloutput "vmware:/vApp/vapp-4c0d9722-80a4-4f19-b636 -72ebf48e4e71?filter=DisplayName Contains 'prod1'" - job_info "snaparg=enable_vCloud=1"
The following topic provides assistance in finding the vApp identifier:
See Example Query Builder rules for searching specific vCloud servers or vApps.
Example 3. Use two query rules to search for VMs prod1 and prod2 in a vCloud vApp:
nbdiscover -noxmloutput "vmware:/vApp/vapp-4c0d9722-80a4-4f19-b636 -72ebf48e4e71?filter=DisplayName Contains 'prod1'" "vmware:/vApp/ vapp-4c0d9722-80a4-4f19-b636-72ebf48e4e71?filter=DisplayName Contains 'prod2'" - job_info "snaparg=enable_vCloud=1,multi_org=1"
Note the two rules, each enclosed with double quotes and separated by a space, and the multi_org=1 option.