Search <book_title>...

Veritas NetBackup™ for Hyper-V Administrator's Guide

Last Published: 2018-09-17

Product(s): NetBackup (8.3.0.1, 8.3, 8.2, 8.1.2, 8.1.1)

Test Query screen for Hyper-V

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 events 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.

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: Test Query screen fields

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 The IsSet operator in queries.
Included: Excluded: Failed:	The bottom of the screen 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 The IsSet operator in queries.

Included:

Excluded:

Failed:

The bottom of the screen gives a tally of how many virtual machines were included, excluded, or failed in the test.