Operational Commands
IP Ping
The IP ping utility is used to check the reachability of an IP address.
IP Ping in default instance
The ping command allows you to ping to a destination to see if a networked device is reachable.
Syntax
ping <destination-ip> [source-interface <interface>] count <count> interval <interval> size <size> source-ip <source-ip> ttl <ttl> tos <tos>
| destination-ip | ipv4 destination address |
|---|---|
interface |
source interface |
count |
count of the ping packet (default 5) |
do-not-fragment |
set the do-not-fragment (DF) bit in IP header |
interval |
interval between the packets (default 1 sec) |
size |
size of the ping packet (default 60) |
source-ip |
IPv4 source address |
ttl |
Time-to-live to be used in the packet |
tos |
Type of Service (TOS) to be used in the packet |
Example:
admin@rtbrick: op> ping 198.51.100.111 68 bytes from 198.51.100.111: icmp_seq=1 ttl=64 time=11.8707 ms 68 bytes from 198.51.100.111: icmp_seq=2 ttl=64 time=1.9824 ms 68 bytes from 198.51.100.111: icmp_seq=3 ttl=64 time=5.0726 ms 68 bytes from 198.51.100.111: icmp_seq=4 ttl=64 time=5.6529 ms 68 bytes from 198.51.100.111: icmp_seq=5 ttl=64 time=10.6588 ms Statistics: 5 sent, 5 received, 0% packet loss
IP Ping in specific instance and afi/safi
This command allows you to ping to a destination in a particular VRF.
Syntax
ping <destination-ip> [instance <instance-name> afi <afi> safi<safi>] [source-interface <interface>] count <count> interval <interval> size <size> source-ip <source-ip> ttl <ttl> tos <tos>
destination-ip |
ipv4 destination address |
instance-name |
instance on which ping has to be executed |
afi |
IPv4 Address Family Identifier (AFI) |
safi |
Subsequent address family identifier (SAFI) |
interface |
source interface |
count |
count of the ping packet (default 5) |
do-not-fragment |
set the do-not-fragment (DF) bit in IP header |
interval |
interval between the packets (default 1 sec) |
size |
size of the ping packet (default 60) |
source-ip |
IPv4 source address |
ttl |
Time-to-live to be used in the packet |
tos |
Type of Service (TOS) to be used in the packet |
| The afi/safi attributes are optional; if not specified, afi would be ipv4 and safi would be unicast. |
Example:
admin@rtbrick: op> ping 198.51.100.80 instance vrf1 afi ipv4 safi labeled-unicast 68 bytes from 198.51.100.80: icmp_seq=1 ttl=64 time=18.1306 ms 68 bytes from 198.51.100.80: icmp_seq=2 ttl=64 time=32.1058 ms 68 bytes from 198.51.100.80: icmp_seq=3 ttl=64 time=19.8205 ms 68 bytes from 198.51.100.80: icmp_seq=4 ttl=64 time=20.0144 ms 68 bytes from 198.51.100.80: icmp_seq=5 ttl=64 time=32.0085 ms Statistics: 5 sent, 5 received, 0% packet loss
IPv6 Ping
The IPv6 ping utility is used to check the reachability of an IPv6 address.
IPv6 Ping in the default instance
The ping command allows you to ping to an IPv6 destination to see if a networked device is reachable.
Syntax
ping <destination-ipv6> [source-interface <interface>] count <count> interval <interval> size <size> source-ip <source-ipv6> ttl <ttl> tos <tos>
destination-ipv6 |
ipv6 destination address |
interface |
source interface |
count |
count of the ping packet (default 5) |
do-not-fragment |
set the do-not-fragment (DF) bit in IP header |
interval |
interval between the packets (default 1 sec) |
size |
size of the ping packet (default 60) |
source-ipv6 |
IPv6 source address |
ttl |
Time-to-live to be used in the packet |
tos |
Type of Service (TOS) to be used in the packet |
Example:
admin@rtbrick: op> ping 2001:db8:0:42:: 68 bytes from 2001:db8:0:42::: icmp_seq=1 ttl=64 time=.0503 ms 68 bytes from 2001:db8:0:42::: icmp_seq=2 ttl=64 time=.0321 ms 68 bytes from 2001:db8:0:42::: icmp_seq=3 ttl=64 time=.0314 ms 68 bytes from 2001:db8:0:42::: icmp_seq=4 ttl=64 time=.0325 ms 68 bytes from 2001:db8:0:42::: icmp_seq=5 ttl=64 time=.0354 ms Statistics: 5 sent, 5 received, 0% packet loss
IPv6 Ping in specific instance and afi/safi
This command allows you to ping to an IPv6 destination in a particular VRF.
Syntax
ping <destination-ipv6> [instance <instance-name> afi<afi> safi<safi>] [source-interface <interface>] count <count> interval <interval> size <size> source-ip <source-ipv6> ttl <ttl> tos <tos>
destination-ipv6 |
ipv6 destination address |
instance-name |
instance on which ping has to be executed |
afi |
IPv4 Address Family Identifier (AFI) |
safi |
Subsequent address family identifier (SAFI) |
interface |
source interface |
count |
count of the ping packet (default 5) |
do-not-fragment |
set the do-not-fragment (DF) bit in IP header |
interval |
interval between the packets (default 1 sec) |
size |
size of the ping packet (default 60) |
source-ipv6 |
IPv6 source address |
ttl |
Time-to-live to be used in the packet |
tos |
Type of Service (TOS) to be used in the packet |
| The afi/safi attributes are optional; if not specified, afi would be ipv6 and safi would be unicast. |
Example:
admin@rtbrick: op> ping 2001:db8:0:42:: instance abc afi ipv6 safi labeled-unicast 68 bytes from 2001:db8:0:42::: icmp_seq=1 ttl=64 time=.0503 ms 68 bytes from 2001:db8:0:42::: icmp_seq=2 ttl=64 time=.0321 ms 68 bytes from 2001:db8:0:42::: icmp_seq=3 ttl=64 time=.0314 ms 68 bytes from 2001:db8:0:42::: icmp_seq=4 ttl=64 time=.0325 ms 68 bytes from 2001:db8:0:42::: icmp_seq=5 ttl=64 time=.0354 ms Statistics: 5 sent, 5 received, 0% packet loss
IP Traceroute
IP Traceroute in default instance
This command allows you to traceroute to a particular IP destination.
Syntax:
traceroute <destination-ip> [source-interface <interface>] repeat <repeat> interval <interval> size <pktsize> source-ip <source-ip> maxhop <maxhop>
destination-ip |
ipv4 destination address |
interface |
source interface |
repeat |
no of packets for each hop (default 3) |
interval |
interval between the packets (default 1 sec) |
pktsize |
size of the traceroute packet (default 60) |
source-ip |
source IP address |
maxhop |
max number of hops before the TTL expires (default 30) |
Example:
admin@rtbrick: op> traceroute 198.51.100.80 traceroute to 198.51.100.80, 30 hops max, 60 byte packets 1 198.51.100.90 39.401 ms 19.919 ms 20.074 ms 2 198.51.100.80 55.544 ms 36.765 ms 45.989 ms
IP Traceroute in specific instance and afi/safi
This command allows you to traceroute to a particular IP destination in a specific VRF.
Syntax:
traceroute <destination-ip> [instance <instance-name> afi <afi> safi<safi>] [source-interface <interface>] repeat <repeat> interval <interval> size <pktsize> source-ip <source-ip> maxhop <maxhop>
destination-ip |
ipv4 destination address |
instance-name |
instance on which traceroute has to be executed |
afi |
IPv4 Address Family Identifier (AFI) |
safi |
Subsequent address family identifier (SAFI) |
interface |
source interface |
repeat |
no of packets for each hop (default 3) |
interval |
interval between the packets (default 1 sec) |
pktsize |
size of the traceroute packet (default 60) |
source-ip |
source IP address |
maxhop |
max number of hops before the TTL expires (default 30) |
| The afi/safi attributes are optional; if not specified, afi would be ipv4 and safi would be unicast. |
Example:
supervisor@S1-STD-28-2901>bm13-tst.fsn.rtbrick.net: cfg> traceroute 198.51.100.80 instance default afi ipv4 safi labeled-unicast source-interface
ifl-0/0/0/1 source-ip 198.51.100.55
traceroute to 198.51.100.80 30 hops max, 60 byte packets
1 198.51.100.12 4.961 ms .421 ms .503 ms
MPLS Label=20071 Exp=0 TTL=1 S=1
2 198.51.100.80 .995 ms 6.456 ms .813 ms
| For the MPLS transport, it displays the ingress labels in each hop. |
IPv6 Traceroute
IPv6 Traceroute in default instance
This command allows you to traceroute to a particular IP destination.
Syntax
traceroute <destination-ipv6> [source-interface <interface>] repeat <repeat> interval <interval> size <pktsize> source-ip <source-ipv6> maxhop <maxhop>
destination-ipv6 |
ipv6 destination address |
interface |
source interface |
repeat |
no of packets for each hop (default 3) |
interval |
interval between the packets (default 1 sec) |
pktsize |
size of the traceroute packet (default 60) |
source-ip |
IPv6 source address |
maxhop |
max number of hops before the TTL expires (default 30) |
Example:
admin@rtbrick: op> traceroute 2001:db8:0:75:: traceroute to 2001:db8:0:75:: 30 hops max, 60 byte packets 1 2001:db8:0:90:: 21.247 ms 20.232 ms 20.052 ms 2 2001:db8:0:75:: 50.124 ms 59.822 ms 40.032 ms
IPv6 Traceroute in specific instance and afi/safi
This command allows you to traceroute to a particular IPv6 destination in a specific VRF.
Syntax
traceroute <destination-ipv6> [instance <instance-name> afi<afi> safi<safi>] [source-interface <interface>] repeat <repeat> interval <interval> size <pktsize> source-ip <source-ipv6> maxhop <maxhop>
destination-ipv6 |
ipv6 destination address |
instance-name |
instance on which traceroute has to be executed |
afi |
IPv4 Address Family Identifier (AFI) |
safi |
Subsequent address family identifier (SAFI) |
interface |
source interface |
repeat |
no of packets for each hop (default 3) |
interval |
interval between the packets (default 1 sec) |
pktsize |
size of the traceroute packet (default 60) |
source-ip |
IPv6 source address |
maxhop |
max number of hops before the TTL expires (default 30) |
| The afi/safi attributes are optional; if not specified, afi would be ipv6 and safi would be unicast. |
Example:
supervisor@rtbrick.net: cfg> traceroute 2001:db8:0:75:: instance default afi ipv6 safi labeled-unicast source-interface
ifl-0/0/0/1 source-ip 2001:db8:0:11::
traceroute to 2001:db8:0:75:: 30 hops max, 60 byte packets
1 2001:db8:0:90:: 6.782 ms .306 ms 6.380 ms
MPLS Label=20072 Exp=0 TTL=1 S=1
2 2001:db8:0:75:: .434 ms .657 ms .844 ms
| For the MPLS transport, it displays the ingress labels in each hop. |
LSP Ping
The ping mpls command allows you to ping to a MPLS labelled switch path destination to see if a networked device is reachable.
Syntax:
ping mpls <prefix> <instance> <fec-type> <size> <interval> <count> <source-ip>
| Attribute | Description |
|---|---|
<prefix> |
Specify the target fec. |
count |
Specify the number of ping packets to send. |
fec-type |
Specifies the type of FEC to help the device identify the exact type. Default fec-type is LDP. |
instance |
Specify the instance name. |
interval |
Specify the time (in seconds) between successive ping packets to send. |
size |
The size of the PAD TLV to be included in the MPLS Echo Request packet. |
source-ip |
Specify the source IP address for the MPLS Echo Request. |
Example: LSP ping for a prefix
supervisor@rtr:op> ping mpls 62.154.10.70/32 Sending 5 MPLS Echos to ldp FEC 62.154.10.70/32 Success: Response from 217.239.37.58 : Egress for the FEC: seq = 1 rtt = 47.30 ms Success: Response from 217.239.37.58 : Egress for the FEC: seq = 2 rtt = 13.96 ms Success: Response from 217.239.37.58 : Egress for the FEC: seq = 3 rtt = 10.65 ms Success: Response from 217.239.37.58 : Egress for the FEC: seq = 4 rtt = 7.61 ms Success: Response from 217.239.37.58 : Egress for the FEC: seq = 5 rtt = 14.85 ms ---62.154.10.70/32 mpls ping statistics --- 5 sent, 5 received, 0 errors, 0% loss, time 5001.93 ms rtt min/avg/max = 7.61/18.88/47.30 ms
Example: LSP ping for a FEC type
supervisor@rtr:op> ping mpls 62.154.20.70/32 fec-type isis Sending 5 MPLS Echos to isis FEC 62.154.20.70/32 Success: Response from 217.239.37.58: Egress for the FEC: seq = 2 rtt = 27.97 ms Success: Response from 217.239.37.58: Egress for the FEC: seq = 3 rtt = 16.76 ms Success: Response from 217.239.37.58: Egress for the FEC: seq = 4 rtt = 34.01 ms Success: Response from 217.239.37.58: Egress for the FEC: seq = 5 rtt = 11.23 ms ---62.154.10.70/32 mpls ping statistics --- 5 sent, 4 received, 0 errors, 20% packet loss, time 5001.93 ms rtt min/avg/max = 11.23/19.88/34.01 ms
Show Commands
Show OAM MPLS
The command displays LSP ping command details.
Syntax:
show oam mpls <option>
| Option | Description |
|---|---|
statistics |
Displays MPLS LSP ping statistics. |
Example: OAM MPLS LSP Ping statistics
supervisor@Brtbrick.net: cfg> show oam mpls statistics Sent Statistics: MPLS echo request sent : 0 MPLS echo reply sent : 0 Sent error : 0 Sent error - No table : 0 Sent error - No FEC : 0 Sent error - No Adjacency : 0 Sent error - No MPLS Adjacency : 0 Sent error - No interface : 0 Sent error - Encode failure : 0 Received Statistics: MPLS echo received : 0 MPLS echo request received : 0 MPLS echo reply received : 0 Receive error - L3 decode : 0 Receive error - header decode : 0 Receive error - TLV decode : 0 Receive error - FEV TLV decode : 0 Receive error - unsupported FEV : 0 Receive error - no session : 0