---
title: "DNS Cache Acceleration CLI Commands"
canonical: "https://docs.infoblox.com/space/dca9x/399474987/DNS%20Cache%20Acceleration%20CLI%20Commands"
format: markdown
---
Infoblox NIOS has commands that can be used to change settings related to DNS Cache Acceleration in an appliance that supports DNS Cache Acceleration. To use these commands, you must connect through SSH or connect through the serial console port to the NIOS appliance and log in with the appropriate admin account.  
The NIOS appliance supports the standard NIOS command-line interface for communicating with the device. For more information see the CLI section in the NIOS Documentation at *[docs.infoblox.com](https://docs.infoblox.com/)*.

The CLI commands listed below are frequently used on the DNS Cache Acceleration appliances:

> Macro (toc)

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

| **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. 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 > 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 dns-accel log

Sets the logging level for the DNS Cache Acceleration service on a DNS Cache Acceleration capable appliance. The logging 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`


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

The `show dns-accel`  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 dns-accel` command displays the following operating characteristics of the DNS Cache Acceleration appliance.

|  |  |
| --- | --- |
| - 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 dns-accel`

## Example

`Infoblox > show dns-accel`  
`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 DNS Cache Acceleration appliance. 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 DNS Cache Acceleration appliance. For more information about enabling VLAN support using CLI commands, see *[Infoblox DNS Firewall](https://infoblox-docs.atlassian.net/wiki/spaces/DAAG/pages/10748029)*.


# show dns-accel-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 appliances with DNS cache acceleration license enabled.

## Syntax

`show dns-accel-cache`

## Example

`Infoblox > show dns-accel-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 dns-accel-cache [existing-file]

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

## Syntax

`show dns-accel-cache existing file`

## Example

`Infoblox > show dns-accel-cache existing file`

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

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


# set vdca_type64_support

This command allows you to enable or disable caching of DNS type 64 records. When the caching is enabled, the responses to DNS type 64 queries are cached in and returned from the virtual DNS Cache Acceleration cache.

## Syntax

`set vdca_type64_support` `[ on | off ]`

| **Argument** | **Description** |
| --- | --- |
| on | Enables caching of DNS type 64 records. |
| off | Disables caching of DNS type 64 records. |

## Examples

Enabling caching of DNS type 64 responses:

`Infoblox > set vdca_type64_support on`  
`Enabled caching for Type 64 queries`  


Disabling caching for DNS type 64 responses:

`Infoblox > set vdca_type64_support off`  
`Disabled caching for Type 64 queries`  


# set vdca_type65_support

This command allows you to enable or disable caching of DNS type 65 records. When the caching is enabled, the responses to DNS type 65 queries are cached in and returned from the virtual DNS Cache Acceleration cache.

## Syntax

`set vdca_type65_support` `[ on | off ]`

| **Argument** | **Description** |
| --- | --- |
| on | Enables caching of DNS type 65 response. |
| off | Disables caching of DNS type 65 response. |

## Examples

Enabling caching of DNS type 65 responses

`Infoblox > set vdca_type65_support on`  
`Enabled caching for Type 65 queries`  


Disabling caching of DNS type 65 response

`Infoblox > set vdca_type65_support off`  
`Disabled caching for Type 65 queries`


# show vdca_type64_support

This command allows you to view whether the DNS type 64 responses are configured to be cached at virtual DNS Cache Acceleration. For example, `Enabled` returned in the output indicates that caching is enabled.

## Syntax

`show vdca_type64_support`

## Example

`Infoblox > show vdca_type64_support`  
`Type 64 support:         Enabled`

`Infoblox > show vdca_type64_support`  
`Type 64 support:         Disabled`


# show vdca_type65_support

This command allows you to view whether the DNS type 65 responses are configured to be cached at virtual DNS Cache Acceleration. For example, `Enabled` returned in the output indicates that caching is enabled.

## Syntax

`show vdca_type65_support`

This command has no arguments.

## Example

`Infoblox > show vdca_type65_support`  
`Type 65 support:         Enabled`

`Infoblox > show vdca_type65_support`  
`Type 65 support:        Disabled`