/
DNS Cache Acceleration CLI Commands
Document toolboxDocument toolbox

DNS Cache Acceleration CLI Commands

Owned by Panna .
Nov 16, 2023
7 min read

Infoblox NIOS has commands that can be used to change settings related to DNS Cache Acceleration in an appliance that supports DNS Cache Acceleration. To use these commands, you must connect through SSH or connect through the serial console port to the NIOS appliance and log in with the appropriate admin account.
The NIOS appliance supports the standard NIOS command-line interface for communicating with the device. For more information see the CLI section in the NIOS Documentation at docs.infoblox.com.

The CLI commands listed below are frequently used on the DNS Cache Acceleration appliances:

set temp_license

Generates and installs a temporary DNS cache acceleration license. You can add a temporary DNS Cache Acceleration license for up to one million QPS. Note that you cannot add a temporary license if a permanent license already exists. This command is used on software-based and hardware DNS Cache Acceleration appliances.

Syntax

set temp_license

Example

set temp_license

show license

The show license command displays the capacity of the applicable DNS cache acceleration license type.

Syntax

 show license  [ all | csv | gridwide | revoked ]

Example

Infoblox > show license all
Infoblox > show license csv
Infoblox > show license gridwide
Infoblox > show license revoked

set dns

The set dns command enables you to control the DNS cache. You can flush the cache of a DNS view or flush a particular entry from the cache.

Syntax

set dns flush all [dns_view]
set dns flush name [dns_view]

Argument

Description

Argument

Description

all

Flushes the cache file from the default view.

dns_view

Specifies a particular DNS view.

name

Flushes the specific entry from the cache.

Example

Infoblox > set dns flush name accounting.corp100.com
Infoblox > set dns flush all

show dns

The show dns command displays DNS query statistics for all DNS views. It also displays the recursive cache for the specified DNS views.

Syntax

show dns {stats | cache [wait_time ntime][dns_view...]}

Argument

Description

Argument

Description

stats

Displays DNS query statistics for all DNS views. If the DNS Cache Acceleration service is enabled, show dns stats will show the combined statistics for BIND and DNS Cache Acceleration service.

ntime

The maximum time (from 1 to 600 seconds) to wait for the cache file to be ready.

Example

Infoblox > show dns stats
success 6718810
referral 0
nxrrset 0
nxdomain 0
recursion 257
failure 0

 

set monitor

This command activates the DNS monitoring in NIOS. This command is applied on software-based DNS Cache Acceleration appliance.

Syntax

set monitor dns

Example

Infoblox > set monitor dns

 

show monitor dns

This command displays DNS network monitoring data. This command is applied on software-based DNS Cache Acceleration appliance.

Syntax

show monitor dns

 

Example

Infoblox > show monitor dns

 

set dns-accel log

Sets the logging level for the DNS Cache Acceleration service on a DNS Cache Acceleration capable appliance. The logging level is between 0 being the least verbose and 7 being the most verbose.

Syntax

set dns-accel log {level]

Argument

Description

Argument

Description

level

The logging level (from 0 to 7) of messages.

Example

Infoblox > set dns-accel log 7

 

set dns-accel log

Sets the logging level for the DNS Cache Acceleration service on software-based DNS Cache Acceleration appliance, where the level is between 0 being the least verbose and 7 being the most verbose.

 

Example

Infoblox > set dns-accel log 7

show dns-accel

The show dns-accel  command checks the status and settings of the DNS Cache Acceleration service.

Note

When you use this command on a specific appliance, the configuration applies only to that appliance. When using this command for an HA pair, you must run the command separately on both the active and passive nodes to ensure consistent behavior.

The show dns-accel command displays the following operating characteristics of the DNS Cache Acceleration appliance.

  • Firmware version

  • DNS query statistics

  • Cache status, enabled/disabled

  • DNS per-port packet count

  • Cache hit count

  • Log level

  • Cache miss count

  • Failed cores (if any)

  • DNS minimum cached TTL

 

Syntax

show dns-accel

Example

Infoblox > show dns-accel
Firmware version:     1.3.19, Nov 08, 2011
Cache:                Enabled
Cache hit count:      109397
Cache miss count:     3008
Minimum cached TTL:   10
DNS query stats:      SUCCESS=109380 NXDOMAIN=0 NXRRSET=0 FAILURE=0 REFERRAL=0
DNS UDP packet count: port0=299339 port1=93408 port2=0 port3=0
Log level:            6
Failed cores:         None

 

show dns-accel

The show dns-accel command displays the following operating characteristics of the software-based DNS Cache Acceleration appliance:

Infoblox > show dns-accel
Log level:                       6(Info)
Cache:                           Enabled
Minimum cached TTL:              1
Maximum cached lifetime:         86400
Cache hit count:                 0
Cache miss count:                0
DNS query stats:                 SUCCESS=0 NXDOMAIN=0 NXRRSET=0 FAILURE=0 REFERRAL=0
System UDP DNS query count:      MGMT=0 LAN1=0 HA=0 LAN2=0
System UDP DNS response count:   0
System DOH/DOT query count:      MGMT=0 LAN1=0 HA=0 LAN2=0 BOND0=0
System DOH/DOT response count:   0
Infoblox >

 

You can view information about the SFPs on the DNS Cache Acceleration appliance. To view the details:

  1. From the Grid tab, select the Grid Manager tab

  2. Click the Members tab -> member check box -> Detailed Status icon.

    You can also use this command to view the VLAN ID, tagged networks, and additional IP addresses that are configured for the network when you enable VLAN on an DNS Cache Acceleration appliance. For more information about enabling VLAN support using CLI commands, see Infoblox DNS Firewall.

 

show dns-accel-cache

You can view the current accelerator cache contents or view the prior cache data file. This command may affect DNS query response performance for around 15 seconds during execution. This command applies only to appliances with DNS cache acceleration license enabled.

Syntax

show dns-accel-cache

Example

Infoblox > show dns-accel-cache

The following warning message is displayed, after you run this command.

 

 

WARNING

This operation will temporarily disable the acceleration cache to obtain the latest cached data.
The operation should take about 15 seconds to complete.
During this period, this member's DNS query performance may be significantly reduced, and changes to the member's DNS configuration will not be permitted.

 

1,88ff8189f2f7548d.pacebook.com,AAAA,IN,NO,0,1,3600,3557,6828,0,AA,AAAA,88ff8189f2f7548d.pacebook.com,3600,356f:3f49:366f:3f49:376f:3f49:386f:3f49,,0,2320,3557
2,abe4d043815df77d.akamaidn.edu,A,IN,NO,0,1,3600,3557,1151352,0,AA,A,abe4d043815df77d.akamaidn.edu,3600,52.111.63.73,,0,2321,3557
3,7443b4a129f534b6.applexxx.net,AAAA,IN,NO,0,1,3600,3557,1438037,0,AA,AAAA,7443b4a129f534b6.applexxx.net,3600,306f:3f49:316f:3f49:326f:3f49:336f:3f49,,0,2322,3557
4,c42e7ae4ad44b227.pacebook.com,AAAA,IN,NO,0,1,3600,3557,492849,0,AA,AAAA,c42e7ae4ad44b227.pacebook.com,3600,396f:3f49:3a6f:3f49:3b6f:3f49:3c6f:3f49,,0,2323,3557
5,51bd345d7ac2a4b2.facebook.com,AAAA,IN,NO,0,1,3600,3557,412,0,AA,AAAA,51bd345d7ac2a4b2.facebook.com,3600,3d6f:3f49:3e6f:3f49:3f6f:3f49:406f:3f49,,0,2324,3557

show dns-accel-cache

The show dns-accel-cache command displays the operating characteristics of the software-based DNS Cache Acceleration appliance.

Syntax

show dns-accel-cache

Example

Infoblox > show dns-accel-cache This operation should take about 15 seconds to complete. During this period, there may be a slight impact on the DNS query performance for this member. WRED feature also will be hit with this command. Are you sure you want to proceed with this operation (y/n): y Cache data obtained at 2022-10-03-19:47:12 Cache is empty

show dns-accel-cache [existing-file]

The show dns-accel-cache existing file displays the DNS Cache Information, fetches new acceleration cache data and displays it when using existing-file option.

Syntax

show dns-accel-cache existing file

Example

Infoblox > show dns-accel-cache existing file

1,88ff8189f2f7548d.pacebook.com,AAAA,IN,NO,0,1,3600,3557,6828,0,AA,AAAA,88ff8189f2f7548d.pacebook.com,3600,356f:3f49:366f:3f49:376f:3f49:386f:3f49,,0,2320,3557
2,abe4d043815df77d.akamaidn.edu,A,IN,NO,0,1,3600,3557,1151352,0,AA,A,abe4d043815df77d.akamaidn.edu,3600,52.111.63.73,,0,2321,3557
3,7443b4a129f534b6.applexxx.net,AAAA,IN,NO,0,1,3600,3557,1438037,0,AA,AAAA,7443b4a129f534b6.applexxx.net,3600,306f:3f49:316f:3f49:326f:3f49:336f:3f49,,0,2322,3557
4,c42e7ae4ad44b227.pacebook.com,AAAA,IN,NO,0,1,3600,3557,492849,0,AA,AAAA,c42e7ae4ad44b227.pacebook.com,3600,396f:3f49:3a6f:3f49:3b6f:3f49:3c6f:3f49,,0,2323,3557
5,51bd345d7ac2a4b2.facebook.com,AAAA,IN,NO,0,1,3600,3557,412,0,AA,AAAA,51bd345d7ac2a4b2.facebook.com,3600,3d6f:3f49:3e6f:3f49:3f6f:3f49:406f:3f49,,0,2324,3557

show dns-accel-cache [existing-file]

The show dns-accel-cache existing-file displays the existing cache data file of software-based DNS Cache acceleration appliance.

Syntax

show dns-accel-cache existing-file

Example

Infoblox > show dns-accel-cache existing-file Cache data obtained at 2022-10-03-19:47:12 Cache is empty Infoblox > show date Mon Oct 3 19:50:25 UTC 2022 Infoblox > show dns-accel-cache existing-file Cache data obtained at 2022-10-03-19:47:12 Cache is empty Infoblox > show dns-accel-cache existing-file Cache data obtained at 2022-10-03-19:47:12 Cache is empty Infoblox > show date Mon Oct 3 19:56:07 UTC 2022

set dns-accel-debug

This command sets the maximum cached lifetime for DNS Cache Acceleration of software-based DNS Cache Acceleration appliance in seconds to a value range between 60 and 86400.

Syntax

set dns-accel-debug <max-cached-lifetime> <value>

 

Argument

Description

Argument

Description

max-cached-lifetime

The maximum cached lifetime value.

Example

Infoblox > set dns-accel-debug max-ttl 86400

 

show dns-accel-debug

This command displays the DNS Cache Acceleration configuration of software-based DNS Cache acceleration appliance.

Syntax

show dns-accel-debug [caching-conf | reporting-conf] [ tail [ <num> ] | /regex/ ]

 

Example

Infoblox > show dns-accel-debug caching-conf tail 9 view_count8

 

set vdca_type64_support

This command allows you to enable or disable caching of DNS type 64 records. When the caching is enabled, the responses to DNS type 64 queries are cached in and returned from the virtual DNS Cache Acceleration cache.

Syntax

set vdca_type64_support [ on | off ]

Argument

Description

Argument

Description

on

Enables caching of DNS type 64 records.

off

Disables caching of DNS type 64 records.

Examples

Enabling caching of DNS type 64 responses:

Infoblox > set vdca_type64_support on
Enabled caching for Type 64 queries

Disabling caching for DNS type 64 responses:

Infoblox > set vdca_type64_support off
Disabled caching for Type 64 queries

set vdca_type65_support

This command allows you to enable or disable caching of DNS type 65 records. When the caching is enabled, the responses to DNS type 65 queries are cached in and returned from the virtual DNS Cache Acceleration cache.

Syntax

set vdca_type65_support [ on | off ]

Argument

Description

Argument

Description

on

Enables caching of DNS type 65 response.

off

Disables caching of DNS type 65 response.

Examples

Enabling caching of DNS type 65 responses

Infoblox > set vdca_type65_support on
Enabled caching for Type 65 queries

Disabling caching of DNS type 65 response

Infoblox > set vdca_type65_support off
Disabled caching for Type 65 queries

 

show vdca_type64_support

This command allows you to view whether the DNS type 64 responses are configured to be cached at virtual DNS Cache Acceleration. For example, Enabled returned in the output indicates that caching is enabled.

Syntax

show vdca_type64_support

Example

Infoblox > show vdca_type64_support
Type 64 support:         Enabled

Infoblox > show vdca_type64_support
Type 64 support:         Disabled

 

show vdca_type65_support

This command allows you to view whether the DNS type 65 responses are configured to be cached at virtual DNS Cache Acceleration. For example, Enabled returned in the output indicates that caching is enabled.

Syntax

show vdca_type65_support

This command has no arguments.

Example

Infoblox > show vdca_type65_support
Type 65 support:         Enabled

Infoblox > show vdca_type65_support
Type 65 support:        Disabled

Related content