Skip to main content
Cisco SD-WAN
Support
Product Documentation
Viptela Documentation

Operational Commands

Overview of Operational Commands
c
clear app cflowd flow-all
Clear the cflowd flows in all VPNs.
clear app cflowd flows
Clear the cflowd flows in a specific VPN.
clear app cflowd statistics
Zero cflowd packet statistics.
clear app dpi all
Clear all DPI flows on the vEdge router.
clear app dpi apps
Clear specific applications in a particular VPN on the vEdge router.
clear app dpi flows
Clear specific DPI flows in a particular VPN on the vEdge router.
clear app log flow-all
Clear all logged flows.
clear app log flows
Clear the information logged flows.
clear arp
Refresh dynamically created entries in the ARP cache.
clear bfd transitions
Clear the counters for BFD transitions.
clear bgp all
Reset BGP peering sessions with all neighbors in a specific VPN.
clear bgp neighbor
Reset the peering sessions with a specific BGP neighbor in a VPN.
clear bridge mac
Clear the MAC addresses that the vEdge router has learned.
clear bridge statistics
Clear the bridging statistics.
clear cellular errors
Clear errors associated with cellular interfaces.
clear cellular session statistics
Clear the statistics for cellular sessions.
clear cloudexpress computations
Clear computations for Cloud OnRamp for SaaS.
clear cloudinit data
Clear bootstrap information received from cloud-init in order to attach a new cloud-init file.
clear control connections
Reset the DTLS connections from the local device to all Viptela devices.
clear control connections-history
Erase the connection history on the local device.
clear crash
Delete the core files on the local device.
clear dhcp server-bindings
Clear the bindings to DHCP servers.
clear dhcp state
Clear IPv4 DHCP state on the local device.
clear dns cache
Clear the cache of DNS entries on the local device.
clear dot1x client
Deauthenticate a client connected on an 802.1X or 802.11i interface.
clear history
Clear the history of the commands issued in operational mode.
clear igmp interface
Clear the interfaces on which IGMP is enabled on the router.
clear igmp protocol
Flush all IGMP groups and relearn them.
clear igmp statistics
Zero IGMP statistics.
clear installed-certificates
Clear all the certificates on the local device, and return the device to the factory-default state.
clear interface statistics
Zero interface statistics.
clear ipsec ike sessions
Clear the IKE sessions on the router.
clear ipv6 dhcp state
Clear IPv6 DHCP state on the local device.
clear ipv6 neighbor
Refresh dynamically created IPv6 entries in the Address Resolution Protocol (ARP) cache.
clear ipv6 policy
Reset all counters for IPv6 access lists.
clear ip mfib record
Clear the statistics for a particular group, source, or VPN from the Multicast Forwarding Information Base.
clear ip mfib stats
Clear all statistics from the Multicast Forwarding Information Base.
clear ip nat filter
Clear the NAT translational filters.
clear ip nat statistics
Clear the NAT translational interface statistics.
clear omp all
Reset OMP peering sessions with all OMP peers.
clear omp peer
Reset the OMP peering sessions with a specific peer.
clear omp routes
Recalculate the OMP routes and resend the routes to the IP route table.
clear omp tlocs
Recalculate the OMP TLOCs and resend the TLOCs to the route table.
clear orchestrator connections-history
Clear the history of connections and connection attempts made by the vBond orchestrator.
clear ospf all
Reset OSPF in a VPN.
clear ospf database
Delete the entries in the OSPF link-state database learned from OSPF neighbors.
clear pim interface
Clear PIM interfaces, and relearn all PIM neighbors and joins.
clear pim neighbor
Clear a PIM neighbor.
clear pim protocol
Clear all PIM protocol state.
clear pim rp-mapping
Clear the mappings of multicast groups to RPs.
clear pim statistics
Clear all PIM-related statistics on the router, and relearn all PIM neighbors and joins.
clear policer statistics
Clear the policer OOS packet statistics.
clear policy
Reset all counters for IPv4 access lists or data policies.
clear pppoe statistics
Zero pppoe statistics.
clear system statistics
Clear system-wide forwarding statistics.
clear tunnel statistics
Zero the information about the packets transmitted and received on IPsec connections that originate on the local router.
clear wlan radius-stats
Clear the statistics about the sessions with RADIUS servers being used for WLAN authentication.
clock
Set the time and date on the device.
commit
Confirm or abort a pending commit operation.
complete-on-space
Have the CLI automatically complete a command name when you type an unambiguous string and then press the space bar, or have the CLI list all possible completions when you type an ambiguous string and then press the space bar.
config
Enter configuration mode.
d
debug
Enable and disable debugging mode for all or selected software function.
e
exit
Exit from the CLI session.
f
file list
List the files in a directory on the Viptela device.
file show
Display the contents of a file on the Viptela device.
h
help
Display help information about a CLI command.
history
Set the number of history items that the CLI tracks in operational mode.
i
idle-timeout
Set how long the CLI is inactive before the user is logged out.
j
job stop
Stop a job that is monitoring a file on the local device.
l
logout
Terminate the current CLI session, a specific CLI session, or the session of a specific user.
m
monitor start
Begin monitoring a file on the local device.
monitor stop
Stop monitoring a file on the local device.
n
nslookup
Display the IP address of a vBond orchestrator if the vBond address in the configuration is listed as a DNS name.
p
paginate
Control the pagination of command output.
ping
Verify that a network device is reachable, by sending ICMP ECHO_REQUEST packets to them.
poweroff
Shut down the Viptela system.
prompt1
Set the operational prompt.
prompt2
Set the configuration mode prompt.
q
quit
Exit from the CLI session.
r
reboot
Reboot the Viptela device or switch to the software image installed on the other partition.
request aaa unlock-user
Reset the account of a user whose account is locked. An account becomes locked when the user can no longer log in to a Viptela device.
request admin-tech
Collect system status information in a tar file to aid in troubleshooting and diagnostics.
request certificate
Install a certificate on the Viptela device.
request container image install
Install a vSmart software image on a vSmart controller container host.
request container image remove
Install a vSmart software image on a vSmart controller container host.
request control-tunnel add
Create a temporary tunnel to use when debugging a failed control connection.
request control-tunnel delete
Delete a temporary tunnel that you created to debug a failed control connection.
request controller-upload serial-file
Upload the certificate serial number file to the local device.
request controller add serial-num
Send the certificate serial number of a vManage NMS or a vSmart controller to the vBond orchestrator.
request controller delete serial-num
Delete a vSmart serial number from the vSmart controller serial number file on the local device.
request csr upload
Upload a certificate signing request (CSR) to the Viptela device.
request daemon ncs restart
Restart the NCS network configuration process.
request device
Add or delete a vEdge router chassis number on the vBond orchestrator that is acting as a ZTP server.
request device-upload
Add  vEdge router chassis numbers by uploading a file that contains the device information onto the vBond orchestrator that is acting as a ZTP server.
request download
Download a software image or other file to the Viptela device.
request execute
Execute a shell command from within the Viptela CLI.
request firmware upgrade
Upgrade the boot loader.
request interface-reset
Reset an interface.
request ipsec ike-rekey
Force IKE to generate new keys for IKE sessions.
request ipsec ipsec-rekey
Force IKE to generate new keys for IPsec tunnels that are being used for IKE sessions.
request nms-server
Start and stop a vManage NMS, and display the status of the NMS.
request nms all
Start, stop, and perform other operations on all vManage cluster components.
request nms application-server
Start, stop, and perform other operations on a vManage HTTP web server.
request nms configuration-db
Start, stop, and perform other operations on the local vManage configuration database.
request nms coordination-server
Start, stop, and perform other operations on the local vManage coordination and messaging server.
request nms messaging-server
Start, stop, and perform other operations on the local vManage messaging server.
request nms statistics-db
Start, stop, and perform other operations on the local vManage statistics database.
request on-vbond-controller
Delete the serial number of a vEdge router.
request on-vbond-vsmart
Delete the serial number of a vEdge router.
request port-hop
Manually rotate to the next OMP port in the group of preselected OMP port numbers when a connection cannot be established.
request reset configuration
Reset the device's configuration to the factory-default configuration.
request reset logs
Clear the contents of all syslog logging files on the local device.
request root-cert-chain
Install or uninstall a file containing the root certificate key chain.
request security ipsec-rekey
Force IPsec to generate new keys. Use this command when the IPsec keys have been compromised.
request software activate
Activate a software image on the local Viptela device.
request software install
Install a software image on the Viptela device.
request software install-image
Install a software image on the Viptela device.
request software remove
Remove a software image from the local Viptela device.
request software reset
Return the Viptela device to the factory-default configuration.
request software secure-boot
Check and enforce the secure boot state of the system software images and, for vEdge hardware routers, of the boot loader.
request software set-default
Set a software image to be the default image on the device.
request software upgrade-confirm
Confirm that the upgrade to a new software image is successful.
request software verify-image
Verify that a Viptela software image is valid and has been signed.
request upload
Upload a file from the Viptela device to another device in the network.
request vedge
Add a vEdge serial number–chassis number pair to or delete a vEdge serial number-chassis number pair from the vEdge authorized serial number file on the local device.
request vedge-cloud activate
request vedge-cloud activate—Request activation of a vEdge Cloud router.
request vsmart-upload serial-file
Upload the vSmart serial number file.
request vsmart add serial-num
Send the certificate serial number of a vManage NMS or a vSmart controller to the vBond orchestrator.
request vsmart delete serial-num
Delete a vSmart serial number from the vSmart controller serial number file on the local device.
s
screen-length
Set the length of the terminal window. Use the more and nomore command filters to control the length of the output.
screen-width
Set the width of the terminal window. Use the tab and notab command filters to control the width of the output.
show aaa usergroup
List the groups configured for AAA role-based access to a Viptela device.
show app-route sla-class
Display information about the SLA classes operating on the vEdge router.
show app-route stats
Display statistics about data traffic characteristics for all data plane tunnels.
show app cflowd collector
Display information about the configured cflowd collectors that the vEdge router has learned from a vSmart controller.
show app cflowd flow-count
Display the number of current cflowd traffic flows.
show app cflowd flows
Display cflowd flow information.
show app cflowd statistics
Display cflowd packet statistics.
show app cflowd template
Display the cflowd template information that the vEdge router transmits periodically to the cflowd collector.
show app dpi applications
Display application-aware applications running on the vEdge router.
show app dpi flows
Display flow information for the application-aware applications running on the vEdge router.
show app dpi summary statistics
Display summary statistics for DPI flows on the vEdge router.
show app dpi supported-applications
List all the application-aware applications supported by the Viptela software on the vEdge router .
show app log flow-count
Display the count of packet flows that are being logged.
show app log flows
Display flow logging information.
show app tcp-opt
Display information about TCP-optimized flows.
show arp
Display the IPv4 entries in the Address Resolution Protocol table, which lists the mapping of IP addresses to device MAC addresses.
show bfd history
Display the history of the BFD sessions running on a vEdge router.
show bfd sessions
Display information about the BFD sessions running on the local vEdge router.
show bfd summary
Display summary information about the BFD sessions running on the local vEdge router.
show bfd tloc-summary-list
Display BFD session summary information per TLOC.
show bgp neighbor
List the router's BGP neighbors.
show bgp routes
List the router's BGP neighbors.
show bgp summary
Display the status of all BGP connections.
show boot-partition
Display the active boot partition and the software version installed in the boot partitions.
show bridge interface
List the interfaces on which bridging is running.
show bridge mac
List the MAC addresses that the vEdge router has learned.
show bridge table
List the information in the bridge forwarding table.
show cellular modem
Display cellular modem information and status.
show cellular network
Display cellular network information.
show cellular profiles
Display cellular profile information.
show cellular radio
Display cellular radio frequency information.
show cellular sessions
Display cellular session information.
show cellular status
Display cellular status information.
show certificate installed
Display the device's certificate.
show certificate root-ca-cert
Display the root certification installed on a Viptela device.
show certificate serial
Display the serial number for a vBond orchestrator or a vSmart controller. Display the serial number and chassis number for a vEdge router.
show certificate signing-request
Display the certificate signing requests installed on a vSmart controller or vBond orchestrator.
show certificate validity
Find out how long a certificate is valid for.
show cli
Display the CLI settings.
show clock
Display the system time.
show cloudexpress applications
Display the best interfaces for applications configured with Cloud OnRamp for SaaS.
show cloudexpress gateway-exits
Display loss and latency on each gateway exit for applications configured with Cloud OnRamp for SaaS.
show cloudexpress local-exits
Display application loss and latency computed by Cloud OnRamp for SaaS.
show configuration commit list
Display a list of all configuration commits on the Viptela device.
show container images
List the Viptela software images associated with the vSmart controller containers.
show container instances
List information about the vSmart controller containers running on the container host.
show control affinity config
Display configuration information about the control connections between the vEdge router and one or more vSmart controllers.
show control affinity status
Display the status of the control connections between the vEdge router and one or more vSmart controllers.
show control connection-info
Display information about the control plane connections on the Viptela device.
show control connections
Display information about active control plane connections.
show control connections-history
Display information about control plane connection attempts initiated by the local device.
show control local-properties
Display basic configuration parameters and local properties related to the control plane.
show control statistics
Display statistics about the packets that a vEdge router or vSmart controller has transmitted and received in the process of establishing and maintaining secure DTLS connections to Viptela devices in the overlay network.
show control summary
Display a count of the vBond orchestrators, vManage NMSs, and vSmart controllers in the overlay network.
show control valid-vedges
List the chassis numbers of the valid vEdge routers in the overlay network.
show control valid-vsmarts
List the serial numbers of the valid vSmart controllers in the overlay network.
show crash
Display a list of the core files on the local device.
show devices
Display information about the Viptela devices that a vManage NMS is managing.
show dhcp interface
Display information about the interfaces that are DHCPv4 clients.
show dhcp server
Display information about the DHCP server functionality that is enabled on the router.
show dot1x clients
Display information about the 802.1X clients in the network.
show dot1x interfaces
Display information about 802.1X–enabled interfaces.
show dot1x radius
Display information about the RADIUS servers being used for IEEE 802.1X and 802.11i authentication.
show hardware alarms
Display information about currently active hardware alarms.
show hardware environment
Display status information about the router components, including component temperature.
show hardware inventory
Display an inventory of the hardware components in the router, including serial numbers.
show hardware real time information
Display real-time information about hardware vEdge routers.
show hardware temperature-thresholds
Display temperature thresholds at which green, yellow, and red alarms are generated.
show history
Display the history of the commands issued in operational mode.
show igmp groups
Display information about multicast groups.
show igmp interface
Display information about the interfaces on which IGMP is enabled on the router.
show igmp statistics
Display IGMP statistics.
show igmp summary
Display information about the IGMP version and IGMP timers.
show interface
Display information about IPv4 interfaces on a Viptela device.
show interface arp-stats
Display the ARP statistics for each interface.
show interface description
Display information information, including the configured interface description.
show interface errors
Display error statistics for interfaces.
show interface packet-sizes
Display packet size information for each interface.
show interface port-stats
Display interface port statistics.
show interface queue
Display interface queue statistics.
show interface sfp detail
Display detailed SFP status and digital diagnostic information for bytes 0 through 95 of an SPF A0 section, as described in SFF-8472.
show interface sfp diagnostic
Display  SFP diagnostic information for fiber-based SFPs only.
show interface statistics
Display interface statistics.
show ipsec ike inbound-connections
Display information about the IKE sessions that have been established to the local router.
show ipsec ike outbound-connections
Display information about the IKE sessions that the local router has established to remote IKE peers.
show ipsec ike sessions
Display information about the IKE sessions on the router.
show ipsec inbound-connections
Display information about IPsec tunnels that originate on remote routers.
show ipsec local-sa
Display security association information for IPsec tunnels created for local TLOCs.
show ipsec outbound-connections
Display information about the IPsec connections to remote routers.
show ipv6 dhcp interface
Display information about interfaces that are DHCPv6 clients.
show ipv6 fib
Display the IPv6 entries in the local forwarding table.
show ipv6 interface
Display information about IPv6 interfaces on a Viptela device.
show ipv6 neighbor
Display the entries in the Address Resolution Protocol (ARP) table for IPv6 neighbors, which lists the mapping of IPv6 addresses to device MAC addresses.
show ipv6 policy access-list-associations
Display the IPv6 access lists that are operating on each interface.
show ipv6 policy access-list-counters
Display the number of packets counted by IPv6 access lists configured on the vEdge router.
show ipv6 policy access-list-names
Display the names of the IPv6 access lists configured on the vEdge router.
show ipv6 policy access-list-policers
Display information about the policers configured in IPv6 access lists.
show ipv6 routes
Display the IPv6 entries in the local route table.
show ip fib
Display the IPv4 entries in the local forwarding table.
show ip mfib oil
Display the list of outgoing interfaces from the Multicast Forwarding Information Base.
show ip mfib stats
Display packet transmission and receipt statistics for active entries in the Multicast Forwarding Information Base.
show ip mfib summary
Display a summary of all active entries in the Multicast Forwarding Information Base.
show ip nat filter
Display the NAT translational filters.
show ip nat interface
List the interfaces on which NAT is enabled and the NAT translational filters on those interfaces.
show ip nat interface-statistics
List packet, NAT, and ICMP statistics for the interfaces on which NAT is enabled.
show ip routes
Display the IPv4 entries in the local route table.
show jobs
View a list of the files that are currently being monitored on the local device.
show licenses
Display the licenses for the software packages used by the Viptela software.
show log
Display the contents of system log (syslog) files.
show logging
Display the settings for logging syslog messages.
show multicast replicator
List information about multicast replicators.
show multicast rpf
List multicast reverse-path forwarding information.
show multicast topology
List information related to the topology of the multicast domain.
show multicast tunnel
List information about the IPsec tunnels between multicast peers.
show nms-server running
Display whether a vManage NMS server is operational.
show notification stream
Display notifications about events that have occurred on the Viptela device.
show ntp associations
Display information about the NTP peers with which the Viptela software is synchronizing its clocks.
show ntp peer
Display information about the NTP peers with which the Viptela software is synchronizing its clocks.
show omp cloudexpress
Display OMP routes for applications configured with Cloud OnRamp for SaaS.
show omp multicast-auto-discover
List the peers that support multicast.
show omp multicast-routes
List the multicast routes that OMP has learned from PIM join messages.
show omp peers
Display information about the OMP peering sessions that are active on the local vSmart controller or vEdge router.
show omp routes
Display information about OMP routes.
show omp services
Display the services learned from OMP peering sessions.
show omp summary
Display information about the OMP sessions running between vSmart controllers and vEdge routers.
show omp tlocs
Display information learned from the TLOC routes advertised over the OMP sessions running between vSmart controllers and vEdge routers.
show orchestrator connections
List the Viptela devices that have active DTLS connections to the vBond orchestrator.
show orchestrator connections-history
List the history of connections and connection attempts made by the vBond orchestrator.
show orchestrator local-properties
Display the basic configuration parameters of a vBond orchestrator.
show orchestrator statistics
Display statistics about the packets that a vBond orchestrator has transmitted and received in the process of establishing and maintaining secure DTLS connections to Viptela devices in the overlay network.
show orchestrator summary
Display a count of the vBond orchestrators, vManage NMSs, and vSmart controllers in the overlay network.
show orchestrator valid-vedges
List the chassis numbers of the valid vEdge routers in the overlay network.
show orchestrator valid-vmanage-id
List the chassis numbers of the valid vManage NMSs in the overlay network
show orchestrator valid-vsmarts
List the serial numbers of the valid vSmart controllers in the overlay network.
show ospf database
List the entries in the OSPF Link-State Advertisement database.
show ospf database-summary
List how many of each type of LSA is present in the OSPF database, along with the total number of LSAs in the database.
show ospf interface
List interfaces that are running OSPF.
show ospf neighbor
List information about OSPF neighbors.
show ospf process
Display information about the OSPF routing process.
show ospf routes
Display the entries that the route table has learned from OSPF.
show parser dump
Display all CLI operational commands and their syntax.
show pim interface
List interfaces that are running PIM.
show pim neighbor
List PIM neighbors.
show pim rp-mapping
Display the mappings of multicast groups to RPs.
show pim statistics
Display all PIM-related statistics on the router.
show policer
Display information about the policers that are in effect.
show policy access-list-associations
Display the IPv4 access lists that are operating on each interface.
show policy access-list-counters
Display the number of packets counted by IPv4 access lists configured on the vEdge router.
show policy access-list-names
Display the names of the IPv4 access lists configured on the vEdge router.
show policy access-list-policers
Display information about the policers configured in IPv4 access lists.
show policy data-policy-filter
Display information about data policy filters for configured counters and policers, and for out-of-sequence packets.
show policy from-vsmart
Display a centralized data policy, an application-aware policy, or a cflowd policy that a vSmart controller has pushed to the vEdge router.
show policy qos-map-info
Display information about the QoS maps are applied to each interface.
show policy qos-scheduler-info
Display information about the configured QoS schedulers and the associated QoS map.
show policy service-path
Display data traffic path information for IPsec data plane tunnels coming from the service side, for use by application-aware routing.
show policy tunnel-path
Display data traffic path information for IPsec data plane tunnels coming from the tunnel side, for use by application-aware routing.
show pppoe session
Display PPPoE session information.
show pppoe statistics
Display statistics for PPPoE sessions.
show ppp interface
Display PPP interface information.
show reboot history
Display the history of when this device has been rebooted.
show running-config
Display the active configuration that is running on the Viptela device.
show sdwan
show sdwan—Display SD-WAN related information about the IOS XE router.
show sdwan policy
show sdwan policy—Display information about policy configuration on the IOS XE router.
show security-info
List the configured security information for IPsec tunnel connections.
show software
List the software images that are installed on the local device.
show system buffer-pool-status
show system buffer-pool-status—Display statistics about internal data packet buffers, which are used in the forwarding path.
show system netfilter
Display the iptable entries on the local device.
show system statistics
Display system-wide forwarding statistics.
show system status
Display time and process information for the device, as well as CPU, memory, and disk usage data.
show transport connection
Display the status of the DTLS connection to a vBond orchestrator.
show tunnel gre-keepalives
Display information about the keepalive packets transmitted and received on GRE tunnels that originate on the local router.
show tunnel inbound-connections
Display information about the IPsec tunnel connections that originate on the local router, showing the TLOC addresses for both ends of the tunnel.
show tunnel local-sa
Display the IPsec tunnel security associations for the local TLOCs.
show tunnel statistics
Display information about the packets transmitted and received on the data plane tunnels that originate on the local router.
show uptime
Show how long the system has been running.
show users
Display the users currently logged in to the device.
show version
Display the active version of the Viptela software running on the device.
show vrrp
Display information about the configured VRRP interfaces and groups.
show wlan clients
Display information about the clients on the wireless WAN.
show wlan interfaces
Display information about the virtual access point interfaces.
show wlan radios
Display information about the WLAN radios.
show wlan radius
Display information about the sessions with RADIUS servers being used for WLAN authentication.
show ztp entries
Display a list of the vEdge router chassis numbers that are present in the ZTP table on the vBond orchestrator that is acting as a ZTP server.
t
tcpdump
Print a description of the contents of packets on a network interface that match a boolean expression.
timestamp
Control the inclusion of timestamp information in command output and logging files.
tools ip-route
Display IP routes and the routing cache.
tools iperf
tools iperf—Run tests to display various parameters related to timing, buffers, and protocols.
tools minicom
Connect to the serial console through USB ports.
tools netstat
Display information about network connections, routing tables, interface statistics, masquerading connections, and multicast memberships.
tools nping
Generate network packets, analyze responses, and measure response times.
tools ss
Display socket statistics for a Viptela device.
tools stun-client
Discover the local device's external IP address when that device is located behind a NAT device.
traceroute
Display the path that packets take to reach a host or IP address on the network.
v
vshell
Exit from the Viptela CLI to the UNIX shell running on the device.
  • Was this article helpful?