Note
- From NIOS 9.0 onwards, IB-4030 and IB-4030-10GE appliances are not supported.
Similar features are available on software based DNS cache acceleration appliances. You can enable them by using the DNS cache acceleration CLI commands. - For software based DNS cache acceleration appliances, all
smartnic
CLI commands are replaced bydns-accel
CLI commands. 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 docs.infoblox.com, CLI section.
Supported IB-4030 and IB-4030-10GE CLI commands include the following:
set dns transfer
–Schedules zone transfers. Note thatset dns transfer
is not used by IB-4030 or IB-4030-10GE with an active DNS Cache Acceleration license.set monitor dns
–Activates DNS monitoring in NIOS. This command is disabled on IB-4030 or IB-4030-10GE with an active DNS Cache Acceleration license.show monitor dns
–Displays DNS network monitoring data. This command is disabled on IB-4030 or IB-4030-10GE with an active DNS Cache Acceleration license.show dns
–Displays DNS query statistics for all DNS views in the IB-4030 or IB-4030-10GE appliance.show smartnic
–Displays the current status of the appliance. This command applies only to IB-4030 or IB-4030-10GE appliances.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.set smartnic 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 smartnic-cache existing-file
–Displays the existing cache data file of IB-4030 and IB-4030-10GE.
The CLI commands listed below are frequently used on the appliance. For more information see docs.infoblox.com, CLI section.
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 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
show dns-accel-cache
The show dns-accel-cache
command displays the following 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
Displays the existing cache data file of IB-4030 and IB-4030-10GE. On hardware appliance.
Example
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 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