Page 1
Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference First Published: October 2008 Last Modified: August 2013 Americas Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387)
Page 2
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks.
Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference OL-27555-03...
Page 4
Contents show ip sla group schedule show ip sla statistics tcp-connect threshold timeout track udp-echo udp-jitter verify-data Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference OL-27555-03...
Page 5
Preface This preface describes the audience, organization, and conventions of the Cisco Nexus 7000 Series NX-OS IP SLAs Command Reference and how to obtain related documentation. This chapter includes the following sections: Audience, page 1 • Organization, page 1 •...
Page 6
Related Documentation Cisco NX-OS includes the following documents: Release Notes Cisco Nexus 7000 Series NX-OS Release Notes, Release 6.x Cisco NX-OS Configuration Guides Cisco Nexus 2000 Series Fabric Extender Software Configuration Guide Cisco Nexus 7000 Series NX-OS Configuration Examples Cisco Nexus 7000 Series NX-OS FabricPath Configuration Guide...
Page 7
Cisco Nexus 7000 Series NX-OS Virtual Device Context Configuration Guide Cisco Nexus 7000 Series NX-OS Virtual Device Context Quick Start Cisco NX-OS FCoE Configuration Guide for Cisco Nexus 7000 and Cisco MDS 9500 NX-OS Command References Cisco Nexus 7000 Series NX-OS Command Reference Master Index...
Page 8
What’s New in Cisco Product Documentation. To receive new and revised Cisco technical content directly to your desktop, you can subscribe to What’s New in Cisco Product Documentation RSS feed. The RSS feeds are a free service.
To check for additional information about this Cisco NX-OS Release, see the Cisco NX-OS Release Notes available at the following Cisco website: http://www.cisco.com/c/en/us/support/switches/nexus-7000-series-switches/products-release-notes-list .html The following table summarizes the new and changed features for the Cisco Nexus 7000 Series NX-OS IP Service Level Agreements Command Reference. Table 1 New and Changed Information...
Page 10
Added the history enhanced command. 6.1(1) Added the history filter command. 6.1(1) Added the history hours-of-statistics-kept 6.1(1) command. Added the history lives-kept command. 6.1(1) Added the history 6.1(1) statistics-distribution-interval command. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference OL-27555-03...
C H A P T E R Cisco Nexus 7000 Series IP SLAs Commands This chapter describes the Cisco NX-OS IP SLAs commands for the Cisco Nexus 7000 series devices. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference...
To set the acceptable Network Time Protocol (NTP) clock synchronization tolerance for a one-way Cisco NX-OS IP Service Level Agreements (SLAs) operation measurement, use the clock-tolerance command. To return to the default value, use the no form of this command.
To specify the data pattern in a Cisco NX-OS IP Service Level Agreements (SLAs) operation to test for data corruption, use the data pattern command. To remove the data pattern specification, use the no form of this command.
Page 14
Usage Guidelines Before starting the operation, install and enable the fabricpath feature set on the device. Examples This example shows how to configure operation 6 as a Cisco NX-OS IP SLA FabricPath operation: switch# configure terminal switch(config)# feature sla sender...
10 life 300 start-time after 00:05:00 switch(config)# Related Commands Command Description show ip sla auto group Displays the configuration including default values of IP SLAs auto-measure groups. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference OL-27555-03...
To set the number of history buckets that are kept during the lifetime of a Cisco NX-OS IP Service Level Agreements (SLAs) operation, use the history buckets-kept command. To return to the default value, use the no form of this command.
To set the number of statistics distributions kept per hop during a Cisco NX-OS IP Service Level Agreements (SLAs) operation, use the history distributions-of-statistics-kept command. To return to the default value, use the no form of this command.
Page 18
Cisco Nexus 7000 Series IP SLAs Commands history distribution-of-statistics-kept Related Commands Command Description show ip sla auto group Displays the configuration including default values of IP SLAs auto-measure groups. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference OL-27555-03...
IP SLAs allows for the aggregation interval to be shorter than one hour. This command does not require a license. Examples This example shows how to enable enhanced history gathering for a Cisco NX-OS IP Service Level Agreements (SLAs) operation: Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference...
Page 20
900 buckets 100 switch(config-ip-sla-udp)# Related Commands Command Description show ip sla auto group Displays the configuration including default values of IP SLAs auto-measure groups. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-10 OL-27555-03...
To define the type of information kept in the history table for a Cisco NX-OS IP Service Level Agreements (SLAs) operation, use the history filter command. To return to the default value, use the no form of this command.
To set the number of hours for which statistics are maintained for a Cisco NX-OS IP Service Level Agreements (SLAs) operation, use the history hours-of-statistics-kept command. To return to the default value, use the no form of this command.
To set the number of lives maintained in the history table for a Cisco NX-OS IP Service Level Agreements (SLAs) operation, use the history lives-kept command. To return to the default value, use the no form of this command.
Page 24
Cisco Nexus 7000 Series IP SLAs Commands history lives-kept Command Description show ip sla auto group Displays the configuration including default values of IP SLAs auto-measure groups. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-14 OL-27555-03...
This command does not require a license. Examples This example shows how to set the time interval for each statistics distribution kept for a Cisco NX-OS IP Service Level Agreements (SLAs) operation: switch(config)# ip sla 1 switch(config-ip-sla)# udp-echo 192.199.199.2 1...
Cisco Nexus 7000 Series IP SLAs Commands icmp-echo icmp-echo To configure a Cisco nx-OS IP Service Level Agreements (SLA) Internet Control Message Protocol (ICMP) echo probe operation, use the icmp-echo command. To remove the settings, use the no form of this command.
Begins the configuration for an IP SLAs operation and enters IP SLA configuration mode. ip sla responder udp Permanently enables the IP SLAs Responder functionality on a specified IP echo ipaddress address and port. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-17 OL-27555-03...
Displays the aggregated statistical errors and distribution information for all aggregated IP SLAs operations or a specified operation. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-18 OL-27555-03...
Displays the aggregated statistical errors and distribution information for all aggregated IP SLAs operations or a specified operation. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-19 OL-27555-03...
To begin configuring a Cisco NX-OS IP Service Level Agreements (SLAs) operation and enter IP SLA configuration mode, use the ip sla command. To remove all configuration information for an operation, including the schedule of the operation, reaction configuration, and reaction triggers, use the no form of this command.
Page 31
Displays the aggregated statistical errors and distribution information for all aggregated IP SLAs operations or a specified operation. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-21 OL-27555-03...
To perform group scheduling for Cisco NX-OS IP Service Level Agreements (SLAs) operations, use the show ip sla group schedule command. To cause all the IP SLAs operations that belong to a multioperation schedule to become inactive, use the no form of this command.
Page 33
The multioperation schedule is placed in a pending state (that is, the group of IP SLAs operations are enabled but are not actively collecting information). Command Modes Global configuration mode (config) Command History Release Modification 6.1(1) This command was introduced. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-23 OL-27555-03...
Page 34
Displays the configuration details of the IP SLAs operation. configuration show ip sla group Displays the group scheduling details of the IP SLAs operations. schedule Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-24 OL-27555-03...
To configure the scheduling parameters for a single Cisco NX-OS IP Service Level Agreements (SLAs) operation, use the ip sla schedule command. To stop the operation and place it in the default state (pending), use the no form of this command.
Page 36
1:30 a.m.: switch(config)# ip sla schedule 15 start-time 01:30:00 recurring switch(config)# Related Commands Command Description ip sla group schedule Performs group scheduling for IP SLAs operations. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-26 OL-27555-03...
Defines the type of information kept in the history table for the IP SLAs operation. ip sla monitor Begins the configuration for an IP SLAs operation and enters IP SLA monitor configuration mode. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-27 OL-27555-03...
Page 38
Sets the number of lives maintained in the history table for the IP SLAs operation. samples-of-history-kept Sets the number of entries kept in the history table per bucket for the IP SLAs operation. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-28 OL-27555-03...
Sets the number of lives maintained in the history table for the IP SLAs operation. samples-of-history-kept Sets the number of entries kept in the history table per bucket for the IP SLAs operation. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-29 OL-27555-03...
Cisco Nexus 7000 Series IP SLAs Commands operation-packet-priority operation-packet-priority To specify the packet priority in a Cisco NX-OS IP Service Level Agreements (SLAs) operation template, use the operation-packet priority command. To return to the default value, use the no form of this command.
To configure the Simple Network Management Protocol (SNMP) owner of a Cisco NX-OS IP Service Level Agreements (SLAs) operation, use the owner command in the appropriate submode of IP SLA configuration. To return to the default value, use the no form of this command.
10.2.2.20/24 10.1.1.1/32 switch(config-acl)# Related Commands Command Description show ip sla auto group Displays the configuration including default values of IP SLAs auto-measure groups. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-32 OL-27555-03...
To set the level of precision at which the statistics for a Cisco NX-OS IP Service Level Agreements (SLAs) operation are measured, use the precision command. To return to the default value, use the no form of this command.
To set the protocol data size in the payload of a Cisco NXOS IP Service Level Agreements (SLAs) operation’s request packet, use the request-data-size command. To return to the default value, use the no form of this command.
Related Commands Command Description auto ip sla Begins the configuration for an IP SLAs LSP Health Monitor operation and mpls-lsp-monitor enters auto IP SLA MPLS configuration mode. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-35 OL-27555-03...
Page 46
The set commands specify the set actions—the particular routing actions to perform if the criteria enforced by the match commands are met. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-36 OL-27555-03...
Page 47
Defines the conditions for redistributing routes from one routing protocol into another, or enables policy routing. set as-path Modifies an autonomous system path for BGP routes. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-37 OL-27555-03...
Page 48
Specifies the address of the next hop. set tag Sets a tag value of the destination routing protocol. set weight Specifies the BGP weight for the routing table. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-38 OL-27555-03...
10.3.3.2 track 1 Related Commands Command Description show ip sla auto group Displays the configuration including default values of IP SLAs auto-measure groups. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-39 OL-27555-03...
Page 50
To indicate where to output packets that pass a match clause of a route map for policy routing and for which the Cisco NX-OS software has no explicit route to a destination, use the set ipv6 default next-hop command. To delete an entry, use the no form of this command.
Page 51
Sets the metric value for a routing protocol. set metric-type Sets the metric type for the destination routing protocol. set next-hop Specifies the address of the next hop. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-41 OL-27555-03...
Page 52
Command Description set tag Sets a tag value of the destination routing protocol. set weight Specifies the BGP weight for the routing table. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-42 OL-27555-03...
Page 53
2001:DB8:1::1 track 1 Related Commands Command Description show ip sla auto group Displays the configuration including default values of IP SLAs auto-measure groups. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-43 OL-27555-03...
Cisco Nexus 7000 Series IP SLAs Commands show ip sla application show ip sla application To display global information about the Cisco NX-OS IP Service Level Agreements (SLAs) application, use the show ip sla application command. show ip sla application Syntax Description This command has no arguments or keywords.
Page 55
Cisco Nexus 7000 Series IP SLAs Commands show ip sla application Related Commands Command Description show ip sla auto group Displays the configuration including default values of IP SLAs auto-measure groups. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-45 OL-27555-03...
This command does not require a license. Examples This example shows how to display the configuration values including all defaults for all Cisco NX-OS IP Service Level Agreements (SLAs) operations or a specified operation: switch# show ip sla configuration 3...
Page 57
Number of history Buckets kept: 15 History Filter Type: None switch# Related Commands Command Description show ip sla auto group Displays the configuration including default values of IP SLAs auto-measure groups. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-47 OL-27555-03...
Cisco Nexus 7000 Series IP SLAs Commands show ip sla group schedule show ip sla group schedule To display the group schedule details for Cisco NX-OS IP Service Level Agreements (SLAs) operations, use the show ip sla group schedule command. show ip sla group schedule group-operation-number...
To display the current operational status and statistics of all Cisco NX-OS IP Service Level Agreements (SLAs) operations or a specified operation over the last one hour, use the show ip sla statistics command.
Page 60
Source to Destination Jitter Min/Avg/Max: 0/0/0 milliseconds Destination to Source Jitter Min/Avg/Max: 0/0/0 milliseconds Packet Loss Values: Loss Source to Destination: 0 Source to Destination Loss Periods Number: 0 Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-50 OL-27555-03...
Page 61
Start Time Index: 02:22:20 UTC Fri Apr 13 2012 Number of successes: 0 Number of failures: 37 IPSLA operation id: 99 Start Time Index: 01:32:53 UTC Fri Apr 13 2012 Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-51 OL-27555-03...
Page 62
Number of successes: 0 Number of failures: 5 switch# Related Commands Command Description show ip sla auto group Displays the configuration including default values of IP SLAs auto-measure groups. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-52 OL-27555-03...
Cisco Nexus 7000 Series IP SLAs Commands To specify the data pattern in a Cisco NX-OS IP Service Level Agreements (SLAs) operation to test for data corruption, use the tag command. To remove the data pattern specification, use the no form of this command.
IP SLAs make a TCP connection to any port number specified by the user. If the destination is a non-Cisco IP host, you must specify a known target port number (for example, 21 for FTP, 23 for Telnet, or 80 for an HTTP server). This operation is useful in testing Telnet or HTTP connection times.
Page 65
Cisco Nexus 7000 Series IP SLAs Commands tcp-connect The control protocol is required when the target device is a Cisco router that does not natively provide the UDP or TCP Connect service. Prior to sending an operation packet to the target router, IP SLAs sends a control message to the IP SLAs responder to enable the destination port.
Cisco Nexus 7000 Series IP SLAs Commands threshold threshold To set the class of service (CoS) for a Cisco NX-OS IP Service Level Agreements (SLAs) Ethernet operation, use the threshold command. To return to the default value, use the no form of this command. threshold milliseconds...
This example shows how to set the timeout value for an IP SLAs operation 1 from 5000 ms: switch(config)# ip sla 1 switch(config-ip-sla)# udp-echo 172.16.1.176 1 switch(config-ip-sla-udp)# timeout 5000 switch(config-ip-sla-udp)# ip sla schedule 1 start-time now switch(config)# Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-57 OL-27555-03...
Page 68
Enters IP SLA template configuration mode for defining an auto IP SLAs operation template. ip sla responder Defines the IP address of the source for the Cisco NX-OS IP SLAs responder tcp-connect ipaddress for TCP connect operations. ip sla responder...
Cisco Nexus 7000 Series IP SLAs Commands To define a type of service (ToS) byte in the IPv4 header of a Cisco NX-OS IP Service Level Agreements (SLAs) operation, use the tos command. To return to the default value, use the no form of this command.
Begins the configuration for an IP SLAs operation and enters IP SLA configuration mode. ip sla monitor Begins the configuration for an IP SLAs operation and enters IP SLA monitor configuration mode. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-60 OL-27555-03...
To define a Cisco NX-OS IP Service Level Agreements (SLAs) User Datagram Protocol (UDP) echo operation, use the udp-echo command. To remove the list, use the no form of this command. udp-echo {destination-ip-address | destination-hostname} destination-port [source-ip {ip-address...
Page 72
Cisco Nexus 7000 Series IP SLAs Commands udp-echo The control protocol is required when the target device is a Cisco router that does not natively provide the UDP or TCP Connect service. If you disable control by using the control disable keyword combination, you must define the IP address of the source for the IP SLAs Responder by using the ip sla responder udp-echo ipaddress command on the destination device.
Cisco Nexus 7000 Series IP SLAs Commands udp-jitter udp-jitter To configure a Cisco NX-OS IP Service Level Agreements (SLA) User Datagram Protocol (UDP) operation that returns Voice over IP (VoIP) scores, use the udp-jitter command with codec option. udp-jitter {destination-ip-address | destination-hostname} destination-port codec codec-type...
Page 74
The control protocol is required when the target device is a Cisco router that does not natively provide the UDP or TCP Connect service. If you disable the control by using the control disable keyword combination with this command, you must define the IP address of the source for the IP SLAs responder by using the ip sla responder udp-echo ipaddress command on the destination device.
Page 75
Begins the configuration for an IP SLAs operation and enters IP SLA configuration mode. request-data-size Sets the payload size for IP SLAs operation request packets. Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-65 OL-27555-03...
Cisco Nexus 7000 Series IP SLAs Commands verify-data verify-data To cause a Cisco NX-OS IP Service Level Agreements (SLAs) operation to check each reply packet for data corruption, use the verify-data command. To return to the default value, use the no form of this command.
Page 77
Chapter 1 Cisco Nexus 7000 Series IP SLAs Commands verify-data Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-67 OL-27555-03...
Page 78
Chapter 1 Cisco Nexus 7000 Series IP SLAs Commands verify-data Cisco Nexus 7000 Series NX-OS IP Service Level Agreements (SLAs) Command Reference 1-68 OL-27555-03...