run service-probe query dnsNEW!

run service-probe instance_id query dns [primary | secondary | tertiary | default] [fqdn]

Description

Tests DNS name resolution from within the network context of a Service Probe.

Syntax Description

instance_idIdentifier of the Service Probe to use. Valid range is 1–9999.
primaryDirects the query to the first configured name server.
secondaryDirects the query to the second configured name server.
tertiaryDirects the query to the third configured name server.
defaultUses the standard system resolver (glibc) rather than querying a specific server directly.
fqdn(Optional) Fully qualified domain name to resolve. Maximum length is 128 characters. If omitted, a default test hostname is used.

Usage Guidelines

If no server keyword is specified, the query is sent to all configured name servers in sequence and the result for each is displayed.

This command requires at least one DNS name server to be in use by the probe, either from DHCP or manual configuration. The command returns an error if no name servers are configured.

The results of the most recent DNS query (excluding queries using default) are stored and displayed in the output of show service-probe detail.

The primary, secondary, tertiary, and default keywords were added in version 33.6.1. In version 33.5.x, the command queries configured name servers using the default system resolver and requires an FQDN.

Example

The following command queries all configured name servers using Service Probe 1:

run service-probe 1 query dns www.extremenetworks.com

Sample output:

DNS query using Service Probe with ID 1:
Pass: DNS query for www.extremenetworks.com using primary server 11.100.100.1 succeeded
Fail: DNS query for www.extremenetworks.com using secondary server 8.8.8.8 failed

The following command queries only the primary name server:

run service-probe 1 query dns primary www.extremenetworks.com

History

This command was first available in version 33.5.1. The primary, secondary, tertiary, and default keywords were added in version 33.6.1.

Platform Availability

All platforms.