Search <book_title>...

Veritas NetBackup™ for VMware Administrator's Guide

Last Published: 2018-02-16

Product(s): NetBackup (8.1.1)

Test Query screen for VMware

This topic applies to policy configuration for NetBackup for VMware. You can use the Query Builder to enter rules for the automatic selection of VMware virtual machines for backup. Use the Test Query screen to test the rules.

This screen lists the virtual machines that NetBackup discovered in your virtual environment when you clicked Test Query. Later changes in the virtual environment may affect which virtual machines match the query rules. For example: if virtual machines are added, the test results may not be identical to the virtual machines that are selected for backup when the backup runs.

When the next backup runs from this policy, the following occur: NetBackup re-discovers virtual machines, consults the query rules, and backs up the virtual machines that match the rules.

The list of backed up virtual machines is saved but the virtual machines are not displayed in the policy's Clients tab. You can use the Activity Monitor to view the virtual machine jobs, or you can run a Virtual Client Summary report in OpsCenter.

Note:

An alternative to the Test Query screen is the nbdiscover command. For more information, see the NetBackup Commands Reference Guide.

See Using the Activity Monitor to monitor virtual machine backups.

See Using OpsCenter to report on virtual machine backups.

The Test Query function runs in the background. You can continue to configure the policy while the test runs. Any changes you make in the Query Builder however are not included in the currently running test. You must re-initiate the test to see the results of your Query Builder changes.

Table:

Field	Description
Test query for policy	Lists the rules in the Query Builder that were used in this test. The rules are specified in the Query Builder on the policy Clients tab.
Test Query Results	VM Name: Shows the display name of all discovered virtual machines. Selection: Lists the virtual machines that were discovered, as follows: INCLUDED: The virtual machine matches the rules in the query. EXCLUDED: The virtual machine does not match the rules in the query. FAILED: The virtual machine cannot be selected for backup because of a host name problem or other error. Also, the query cannot exclude the virtual machine. An explanation appears at the bottom of the Test Query screen. For example: VM does not have a host name to use as a client name, display name = See Test Query: Failed virtual machines. The operator IsSet can be used to filter out such virtual machines. More information is available on IsSet. See Table: Operators in the Operator drop-down. See The IsSet operator in queries.
Included: Excluded: Failed:	Gives a tally of how many virtual machines were included, excluded, or failed in the test.

Field

Description

Test query for policy

Lists the rules in the Query Builder that were used in this test. The rules are specified in the Query Builder on the policy Clients tab.

Test Query Results

VM Name: Shows the display name of all discovered virtual machines.

Selection: Lists the virtual machines that were discovered, as follows:

INCLUDED: The virtual machine matches the rules in the query.
EXCLUDED: The virtual machine does not match the rules in the query.
FAILED: The virtual machine cannot be selected for backup because of a host name problem or other error. Also, the query cannot exclude the virtual machine. An explanation appears at the bottom of the Test Query screen. For example:
```
VM does not have a host name to use as a 
client name, display name =
```
See Test Query: Failed virtual machines.
The operator IsSet can be used to filter out such virtual machines. More information is available on IsSet.
See Table: Operators in the Operator drop-down.
See The IsSet operator in queries.

Included:

Excluded:

Failed:

Gives a tally of how many virtual machines were included, excluded, or failed in the test.

See Using the Activity Monitor to monitor virtual machine backups.

More Information

About automatic virtual machine selection for NetBackup for VMware

Configuring automatic virtual machine selection