The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
iping [ -V vrf ] [ -c count ] [ -i wait ] [ -p pattern ] [ -s packetsize ] [ -t timeout ] host
iping | |
-V vrf |
The Virtual Routing and Forwarding (VRF) instance from which to source the ping message. |
-c count |
Number of ping packets that are sent to the destination address. The default is 5. |
-i wait |
The time interval between sending of ping packets. |
-p pattern |
The data pattern of the ping payload. Different data patterns are used to troubleshoot framing errors and clocking problems on serial lines. The default is [0xABCD]. |
-s packetsize |
Size of the ping packet (in bytes). |
-t timeout |
Timeout interval. The ping is declared successful only if the ECHO REPLY packet is received before this time interval. |
host |
The IP address or host name of the destination EP. |
pod1-leaf1# iping -V overlay-1 10.0.59.154 PING 10.0.59.154 (10.0.59.154): 56 data bytes 64 bytes from 10.0.59.154: icmp_seq=0 ttl=55 time=0.254 ms 64 bytes from 10.0.59.154: icmp_seq=1 ttl=55 time=0.256 ms 64 bytes from 10.0.59.154: icmp_seq=2 ttl=55 time=0.245 ms 64 bytes from 10.0.59.154: icmp_seq=3 ttl=55 time=0.241 ms 64 bytes from 10.0.59.154: icmp_seq=4 ttl=55 time=0.23 ms --- 10.0.59.154 ping statistics --- 5 packets transmitted, 5 packets received, 0.00% packet loss round-trip min/avg/max = 0.23/0.245/0.256 ms
iping6 [ -V vrf ] [ -c count ] [ -i wait ] [ -p pattern ] [ -s packetsize ] [ -t timeout ] host
iping6 | |
-V vrf |
The Virtual Routing and Forwarding (VRF) instance from which to source the ping message. |
-c count |
Number of ping packets that are sent to the destination address. The default is 5. |
-i wait |
The time interval between sending of ping packets. |
-p pattern |
The data pattern of the ping payload. Different data patterns are used to troubleshoot framing errors and clocking problems on serial lines. The default is [0xABCD]. |
-s packetsize |
Size of the ping packet (in bytes). |
-t timeout |
Timeout interval. The ping is declared successful only if the ECHO REPLY packet is received before this time interval. |
host |
The IPv6 address or host name of the destination EP. |
Release |
Modification |
---|---|
11.2 |
This command was introduced. |
pod1-leaf1# iping6 -V overlay-1 2001:0DB8::3/64
itraceroute dest-ip-address [payload-size]
itraceroute |
Trace steps to destination |
dest-ip-address |
Destination IP address |
payload-size |
Size of traceroute packet payload field |
Use this command to find multiple paths to a destination leaf from the current leaf. This command will execute a trace on the overlay VRF.
pod1-leaf1# itraceroute 10.0.71.61 Node traceroute to 10.0.71.61, infra VRF overlay-1, from [10.0.71.63], payload 56 bytes Path 1 1: TEP 10.0.71.62 intf eth1/35 0.596 ms 2: TEP 10.0.71.61 intf eth1/98 0.392 ms Path 2 1: TEP 10.0.71.62 intf eth1/33 0.672 ms 2: TEP 10.0.71.61 intf eth1/97 0.432 ms Path 3 1: TEP 10.0.71.62 intf eth1/35 0.693 ms 2: TEP 10.0.71.61 intf eth1/97 0.484 ms Path 4 1: TEP 10.0.71.62 intf eth1/33 0.954 ms 2: TEP 10.0.71.61 intf eth1/98 0.824 ms
itraceroute6 dest-ip-address [payload-size]
itraceroute6 |
Trace steps to destination |
dest-ip-address |
Destination IPv6 address |
payload-size |
Size of traceroute packet payload field |
Use this command to find multiple paths to a destination leaf from the current leaf. This command will execute a trace on the overlay VRF.
Release |
Modification |
---|---|
11.2 |
This command was introduced. |
pod1-leaf1# itraceroute6 2001:0DB8::3/64
itraceroute dest-ip-address vrf vrf-name [ encap vlan [vlan-encap] ] [ payload payload-size ]
itraceroute |
Trace steps to destination |
dest-ip-address |
IP address of the destination EP |
vrf |
Trace within a virtual routing and forwarding (VRF) instance |
vrf-name |
Name of the VRF |
encap |
Source EP is encapsulated |
vlan |
VLAN encapsulation |
vlan-encap |
VLAN or EPG encapsulation to which the source EP belongs |
payload |
Specify the size of the traceroute packet payload field |
payload-size |
Size of traceroute packet payload field |
Use this command to find multiple paths to a destination endpoint (EP) from the current leaf on behalf of a physical link EP that is a directly connected host, and whose endpoint group (EPG) is identified with VLAN encapsulation. The multiple paths will include nodes inside the fabric.
Note | When the destination EP and source EP are in the same leaf (the current leaf), only one node appears in the path and the interface is marked as unspecified. |
pod1-leaf1# itraceroute 56.17.0.11 vrf t31:ctx31 encap vlan 594 Tenant traceroute to 56.17.0.11, tenant VRF t31:ctx31, source encap vlan-594, from [10.0.90.157], payload 56 bytes Path 1 1: TEP 10.0.90.158 intf eth1/7 0.554 ms 2: TEP 10.0.90.159 intf eth1/49 0.676 ms Path 2 1: TEP 10.0.90.158 intf eth1/29 0.618 ms 2: TEP 10.0.90.159 intf eth1/51 0.787 ms Path 3 1: TEP 10.0.90.158 intf eth1/5 0.656 ms 2: TEP 10.0.90.159 intf eth1/51 0.855 ms Path 4 1: TEP 10.0.90.158 intf eth1/29 0.677 ms 2: TEP 10.0.90.159 intf eth1/49 0.923 ms Path 5 1: TEP 10.0.90.158 intf eth1/7 0.695 ms 2: TEP 10.0.90.159 intf eth1/51 1.015 ms Path 6 1: TEP 10.0.90.158 intf eth1/5 0.808 ms 2: TEP 10.0.90.159 intf eth1/49 1.311 ms
itraceroute dest-ip-address vrf vrf-name encap vxlan [vxlan-encap] dst-mac dest-mac-address [ payload payload-size ]
itraceroute |
Trace steps to destination |
dest-ip-address |
IP address of the destination EP |
vrf |
Trace within a virtual routing and forwarding (VRF) instance |
vrf-name |
Name of the VRF |
encap |
Source EP is encapsulated |
vxlan |
VXLAN encapsulation |
vxlan-encap |
VXLAN encapsulation to which the source EP belongs |
dst-mac |
Specifies MAC address of the destination EP |
dest-mac-address |
MAC address of the destination EP |
payload |
Specify the size of the traceroute packet payload field |
payload-size |
Size of traceroute packet payload field |
Use this command to find multiple paths to a destination endpoint (EP) from the current leaf on behalf of an EP that is behind a virtual tunnel endpoint (VTEP), and whose endpoint group (EPG) is identified with VXLAN encapsulation. The multiple paths will include nodes inside the fabric.
Note | When the destination EP and source EP are in different bridge domains, the destination MAC address must be the switch virtual interface (SVI) MAC address of the source EP bridge domain. |
pod1-leaf1# itraceroute 100.2.2.201 vrf t2:L3C2 encap vxlan 5003 dst-mac 00:50:56:B3:5E:3D Tenant traceroute to 100.2.2.201, tenant VRF t2:L3C2, source encap vxlan-5003, VTEP IP 10.0.0.95, from [10.0.90.159], payload 56 bytes Path 1 1: TEP 10.0.90.128 intf eth4/1 0.608 ms 2: TEP 10.0.90.131 intf eth1/49 0.566 ms Path 2 1: TEP 10.0.90.128 intf eth3/1 0.879 ms 2: TEP 10.0.90.131 intf eth1/50 0.810 ms Path 3 1: TEP 10.0.90.128 intf eth4/1 0.943 ms 2: TEP 10.0.90.131 intf eth1/50 1.057 ms Path 4 1: TEP 10.0.90.128 intf eth3/1 0.957 ms 2: TEP 10.0.90.131 intf eth1/49 1.116 ms