OAM 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>
Command Parameters
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>
Command Parameters

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 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>
Command Parameters

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>
Command Parameters

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

OAM 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

Show OAM CFM

The command displays the CFM session information.

show oam cfm session <option>

Option Description

detail

Shows detailed information about CFM sessions.

interface

Shows CFM session details for the specified logical interface.

Example: CFM session

supervisor@rtbrick.net: cfg> show oam cfm session
Interface          Maintenance Domain       Maintenance Association  Local MEP  Remote MEP State
ifl-0/0/0/1        MD_BNG                   MA_DEFAULT_100           1000       2000       Up
ifl-0/0/1/1        MD_BNG                   MA_DEFAULT_200           1001       2001       Up

Example: CFM session details for a specific interface

supervisor@rtbrick.net: cfg> show oam cfm session interface ifl-0/0/0/100
Interface name: ifl-0/0/0/100, CFM state: Up
  Maintenance domain name: MD_BNG, Format: None
    Maintenance association name: MA_DEFAULT_100, Format: Character string
    Continuity check interval: 1s, Loss threshold: 3 Frames
    Local endpoint ID: 1000, Remote endpoint ID: 2000
    CCM packet last sequence received: 7, CCM packet last sequence sent: 55224
    CCM packet received count: 431344, CCM packet transmit count: 55225
    Last error: None

Example: Detailed view of CFM session

supervisor@rtbrick.net: cfg> show oam cfm session detail
Interface name: ifl-0/0/0/100, CFM state: Up
  Maintenance domain name: MD_BNG, Format: None
    Maintenance association name: MA_DEFAULT_100, Format: Character string
    Continuity check interval: 1s, Loss threshold: 3 Frames
    Local endpoint ID: 1000, Remote endpoint ID: 2000
    CCM packet last sequence received: 7, CCM packet last sequence sent: 55224
    CCM packet received count: 431344, CCM packet transmit count: 55225
    Last error: None
Interface name: ifl-0/0/1/200, CFM state: Up
  Maintenance domain name: MD_BNG, Format: None
    Maintenance association name: MA_DEFAULT_200, Format: Character string
    Continuity check interval: 1s, Loss threshold: 3 Frames
    Local endpoint ID: 1001, Remote endpoint ID: 2001
    CCM packet last sequence received: 7, CCM packet last sequence sent: 55224
    CCM packet received count: 431343, CCM packet transmit count: 55225
    Last error: None