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 byset 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.com, CLI 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
allInfoblox >
show license
csvInfoblox >
show license
gridwideInfoblox >
show license
revokedInfoblox >
show license
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 |
---|---|
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 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...]}
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 > s
et 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:
|
|
|
|
|
|
|
|
|
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:
- From the Grid tab, select the Grid Manager tab
- 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
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
d
isplays 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 |
---|---|
max-cached-lifetime | The maximum cached lifetime value. |
Example
max-ttl 86400Infoblox >
set dns-accel-debug
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
caching-conf tail 9 view_count8Infoblox >
show dns-accel-debug