The NIOS-Software based DNS cache acceleration appliances provide 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 software based DNS cache acceleration appliances and login with the appropriate admin account.
The Software based DNS cache acceleration appliances support the standard NIOS command-line interface for communicating with the device. For more information, refer to the Infoblox CLI Guide.
Supported software based DNS cache acceleration appliance CLI commands include the following:
- set dns transfer–Schedules zone transfers. Note that set dns transfer is not used by software based DNS cache acceleration appliances with an active DNS Cache Acceleration license.
- set monitor dns –Activates DNS monitoring in NIOS. This command is disabled on software based DNS cache acceleration appliances with an active DNS Cache Acceleration license.
- show monitor dns –Displays DNS network monitoring data. This command is disabled on software based DNS cache acceleration appliances with an active DNS Cache Acceleration license.
- show dns-accel–Shows the cusrrent status of the appliance. This command applies only to software based DNS cache acceleration appliances.
- show dns accel-cache–You can view the current accelerator cache contents or view the prior cache dump file. This command may affect DNS query response performance for around 15 seconds during execution. This command applies only to software based DNS cache acceleration appliances, with DNS cache acceleration license enabled.
- set dns-accel log–Specify the log level for the DNS Cache Acceleration service on the appliance.
- 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.
- show license–Displays the capacity of the applicable DNS cache acceleration license type.
- show dns-accel-cache existing-file–Displays the existing cache data file of software based DNS cache acceleration appliances.
The CLI commands listed below are frequently used on the appliance. For detailed information about the supported CLI commands, refer to the Infoblox CLI Guide.
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 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 software based DNS cache acceleration appliances. 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 dns-accel log
Sets the logging level for the DNS Cache Acceleration service on the software based DNS cache acceleration appliances, where the level is between 0 being the least verbose and 7 being the most verbose.
Syntax
set dns-accel log {level]
Argument | Description |
---|---|
level | The logging level (from 0 to 7) of messages. |
Example
Infoblox > set
dns-accel
log 7
show dns-accel
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.
Show dns-accel displays the following operating characteristics of the software based DNS cache acceleration appliances:
|
|
|
|
|
|
|
|
|
|
| System UDP DNS response count |
Syntax
show
dns-accel
Example
Infoblox > show dns-accelLog level: 6(Info)
Cache: Enabled
Minimum cached TTL: 1Maximum cached lifetime: 300
Cache hit count: 322110
Cache miss count: 1260DNS query stats: SUCCESS=322110 NXDOMAIN=0 NXRRSET=0 FAILURE=0 REFERRAL=0
System UDP DNS query count: LAN2=0 HA=0 LAN1=323370 MGMT=0 Failed cores: None
System UDP DNS response count: 323370
You can view information about the SFPs on the software based DNS cache acceleration appliances application. To view the details:
From the Grid tab, select the Grid Manager tab and 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 software based DNS cache acceleration appliances. For more information, see Enabling VLAN Support Using CLI Commands.