/
DNS Cache Acceleration CLI Commands

DNS Cache Acceleration CLI Commands

Note

  • From NIOS 9.0 onwards, IB-4030 and IB-4030-10GE appliances are not supported.
    Similar features and functionalities are available on software-based DNS Cache Acceleration appliances, and it is recommended to use the software-based DCA supported appliances. For a list of supported appliances, see as described in Supported DNS Cache Acceleration Appliances.
  • For software-based DNS Cache Acceleration appliances, replace smartnic keyword with dns-accel in the CLI command. For example,  set smartnic log CLI command is replaced by set dns-accel log CLI command. 

The NIOS-based IB-4030 or IB-4030-10GE appliance provides several commands to change settings in the system. To use these commands, you must connect through SSH or connect through the serial console port to the IB-4030 or IB-4030-10GE and login with the appropriate admin account.
The IB-4030 or IB-4030-10GE appliance supports the standard NIOS command-line interface for communicating with the device. For more information see the NIOS Documentation at docs.infoblox.comCLI section.

The CLI commands listed below are frequently used on the DNS Cache Acceleration appliance(s). For more information see the NIOS Documentation, CLI section at docs.infoblox.com.


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]

ArgumentDescription
allFlushes the cache file from the default view.
dns_viewSpecifies a particular DNS view.
nameFlushes 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 in the IB-4030 or IB-4030-10GE appliance. It also displays the recursive cache for the specified DNS views.

Syntax

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

ArgumentDescription
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 smartnic log

Sets the logging level for the DNS Cache Acceleration service on the IB-4030 or IB-4030-10GE appliance, where the level is between 0 being the least verbose and 7 being the most verbose.

Syntax

set smartnic log {level]

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

Example

Infoblox > set smartnic 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 smartnic

The show smartnic  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 smartnic command displays the following operating characteristics of the IB-4030 or IB-4030-10GE:

  • 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 smartnic

Example

Infoblox > show smartnic
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 IB-4030 or IB-4030-10GE application. 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 IB-4030 or IB-4030-10GE appliance. For more information about enabling VLAN support using CLI commands, see Infoblox DNS Firewall.


show smartnic-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 IB-4030 and IB-4030-10GE appliances with DNS cache acceleration license enabled.

Syntax

show smartnic-cache

Example

Infoblox > show smartnic-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 smartnic-cache [existing-file]

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

Syntax

show smartnic-cache existing file

Example

Infoblox > show smartnic-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>


ArgumentDescription
max-cached-lifetimeThe 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