---
title: "DNS Cache Acceleration CLI Commands"
canonical: "https://docs.infoblox.com/space/DAAG/10748010/DNS%20Cache%20Acceleration%20CLI%20Commands"
format: markdown
---
> ⚠️ **Note**
> ⚠️ 
> ⚠️ - <span style="color: #333333">F</span><span style="color: #333333">rom NIOS 9.0 onwards, IB-4030 and IB-4030-10GE appliances are not supported.</span>  
> ⚠️ <span style="color: #333333">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 </span>[*<span style="color: #0000ff">Supported DNS Cache Acceleration Appliances</span>*](https://infoblox-docs.atlassian.net/wiki/spaces/DAAG/pages/10747938)<span style="color: #333333">.</span>
> ⚠️ - <span style="color: #333333">For software-based DNS Cache Acceleration appliances, replace smartnic keyword with dns-accel in the CLI command. </span>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. <span style="color: #091e42">For more information see the NIOS Documentation at </span>[*<span style="color: #091e42">docs.infoblox.com</span>*](https://docs.infoblox.com/)*<span style="color: #091e42">, </span>*<span style="color: #091e42">CLI section</span><span style="color: #091e42">.</span>

The CLI commands listed below are frequently used on the <span style="color: #091e42">DNS Cache Acceleration appliance(s).</span> <span style="color: #091e42">For more information see the NIOS Documentation, </span><span style="color: #091e42">CLI section</span><span style="color: #091e42"> at </span>[*<span style="color: #091e42">docs.infoblox.com</span>*](https://docs.infoblox.com/)<span style="color: #091e42">.</span>


# <span style="color: #091e42">set temp_license</span>

<span style="color: #091e42">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. </span><span style="color: #091e42">This command is used on software-based and hardware </span><span style="color: #091e42">DNS Cache Acceleration appliances</span><span style="color: #091e42">.</span>

## <span style="color: #091e42">Syntax</span>

`set temp_license`

## <span style="color: #091e42">Example</span>

`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`<span style="color: #1d1c1d"> all</span>  
`Infoblox > ``show license`<span style="color: #1d1c1d"> csv</span>  
`Infoblox > ``show license`<span style="color: #1d1c1d"> gridwide</span>  
`Infoblox > ``show license`<span style="color: #1d1c1d"> revoked</span>


# 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 <span style="color: #1d1c1d">software-based DNS Cache Acceleration appliance.</span>

## 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 <span style="color: #1d1c1d">software-based DNS Cache Acceleration appliance.</span>

## 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

<span style="color: #091e42">The </span>`show dns-accel`<span style="color: #091e42">** **</span><span style="color: #091e42">command displays the following operating characteristics of the software-based DNS Cache Acceleration appliance:</span>

`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 [*<span style="color: #0000ff">Infoblox DNS Firewall</span>*](https://infoblox-docs.atlassian.net/wiki/spaces/DAAG/pages/10748029)<span style="color: #003300">.</span>


# 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](http://88ff8189f2f7548d.pacebook.com/),AAAA,IN,NO,0,1,3600,3557,6828,0,AA,AAAA,[88ff8189f2f7548d.pacebook.com](http://88ff8189f2f7548d.pacebook.com/),3600,356f:3f49:366f:3f49:376f:3f49:386f:3f49,,0,2320,3557  
2,[abe4d043815df77d.akamaidn.edu](http://abe4d043815df77d.akamaidn.edu/),A,IN,NO,0,1,3600,3557,1151352,0,AA,A,[abe4d043815df77d.akamaidn.edu](http://abe4d043815df77d.akamaidn.edu/),3600,52.111.63.73,,0,2321,3557  
3,[7443b4a129f534b6.applexxx.net](http://7443b4a129f534b6.applexxx.net/),AAAA,IN,NO,0,1,3600,3557,1438037,0,AA,AAAA,[7443b4a129f534b6.applexxx.net](http://7443b4a129f534b6.applexxx.net/),3600,306f:3f49:316f:3f49:326f:3f49:336f:3f49,,0,2322,3557  
4,[c42e7ae4ad44b227.pacebook.com](http://c42e7ae4ad44b227.pacebook.com/),AAAA,IN,NO,0,1,3600,3557,492849,0,AA,AAAA,[c42e7ae4ad44b227.pacebook.com](http://c42e7ae4ad44b227.pacebook.com/),3600,396f:3f49:3a6f:3f49:3b6f:3f49:3c6f:3f49,,0,2323,3557  
5,[51bd345d7ac2a4b2.facebook.com](http://51bd345d7ac2a4b2.facebook.com/),AAAA,IN,NO,0,1,3600,3557,412,0,AA,AAAA,[51bd345d7ac2a4b2.facebook.com](http://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`

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

# 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 <span style="color: #1d1c1d">maximum cached lifetime for DNS Cache Acceleration </span><span style="color: #1d1c1d">of software-based DNS Cache Acceleration appliance </span><span style="color: #1d1c1d">in seconds to a value range between 60 and 86400</span><span style="color: #1d1c1d">.</span>


## Syntax

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


| **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 <span style="color: #1d1c1d">DNS Cache Acceleration configuration of software-based DNS Cache acceleration appliance.</span>

## Syntax

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


## Example

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