RAD ETX 203, 205, 220 debug and information commands


Carrier Ethernet Devices by RAD (ETX-203AX, ETX-203AM, ETX-203AX-T, ETX-205A, ETX-220A) are quite popular with telco companies around the world for connecting end clients to the backbone at layer 2. And while reference documentation is available, I couldn’t find the debug/information commands digest on the Internet at all. This post, I hope, comes to fill the gap.

The commands below are meant to be run on the device CLI itself, not on provisioning system of some kind (e.g RADvision). I show examples of using them below as well.

Cheat sheet of debug commands

Command Description

show configure port summary

Show port summary: state (up/down), speed

show config port name status

Show port status: administrative and operational states, speed/duplex, connector type, MAC address, and most important (for fiber) - RX/TX signal power (dBm)

show config port name statistics

Statistics of the port: total bits/frames passed,maximum/minimum bits/sec seen, and most interesting - CRC errors, error frames, oversize frames, discards.

config port ethernet number

clear-statistics

Clear all statistics/counters for this port.

config flow

flow flow-name

show statistics running

Show detailed counters for the given flow, will include bps, max/min bps seen after reboot, drops if any.

config port name

rate-measure interval seconds

show rate

Show port utilization in bits/sec in real-time

Responder:

config flow

service-ping-response local-ip 13.13.13.2/30 next-hop 13.13.13.1 egress-port ethernet 4/2 vlan 777

Ping sender:

config flow

service-ping local-ip 13.13.13.1/30 dst-ip 13.13.13.2 next-hop 13.13.13.2 egress-port ethernet 4/1 vlan 777 number-of-packets 10 payload-size 1450

Send ping over the client vlan (here 777) from ETX to ETX to measure latency and packet loss. You configure one ETX as responder and another one as sender.

show configure flows summary brief

List all flows configured on this ETX briefly

show configure flows summary details

List all flows configured on this ETX with details

config flow name

mac-learning

show mac-table

no mac-learning

Enable MAC address learning inside a flow and show the MAC table. The flow should be the one where those MAC addresses are supposed to be learned, and in the appropriate direction. E.g. if the equipment of the end client is connected to ETX port ethernet 0/10, then you should run this command under the flow that has ingress port 0/10, to see if the ETX can see client’s equipment. WARNING: after showing the results, make sure to disable the MAC learning, as it may interfere with the client’s traffic.

show config system system-date

Show system time of the appliance, important for logs/alarms correlation.

show config reporting brief-alarm-log

Show alarms log, their severity/state/last raised time

exit all

Exit all sub-configuration modes to the top level.

show file startup

Show startup configuration.

save

Save the configuration.

Examples

show configure port summary

Output:

Port           Number         Name            Admin    Oper      Speed
-----------------------------------------------------------------------------
Ethernet       0/101          MNG-ETH         Up       Up        100000000
Ethernet       1/1            ETH-1/1         Up       Up        1000000000
Ethernet       1/2            ETH-1/2         Up       Down      1000000000
Ethernet       1/3            ETH-1/3         Up       Down      1000000000
Ethernet       1/4            ETH-1/4         Up       Down      1000000000
Ethernet       1/5            ETH-1/5         Up       Down      1000000000

show config port eth 4/2 status

Name ETH-4/2

Administrative Status : Up
Operational Status    : Up
Connector Type        : XFP In
Auto Negotiation      : Disabled
Speed And Duplex      : 10G FX Full Duplex
MAC Address           : 00-20-D2-AA-AA-AA

SFP
-----------------------------------------------------------------------------
Connector Type           :  LC
Manufacturer Name        : MRV
Manufacturer Part Number  : XFP-10GD-SX
Typical Maximum Range (Meter):   82
Wave Length (nm)              :  850.00
Fiber Type                    :  MM

RX Power (dBm)              : -3.1 dBm
TX Power (dBm)              : -2.6 dBm
Laser Bias (mA)             : 2.0 mA
Laser Temperature (Celsius) : 39.0 C
Power Supply (V)            : 3.02 V

show config port eth 4/1 statistics

Rates Sampling Window
-----------------------------------------------------------------------------
Window Size [Min.]        : 15
Window Remain Time [Min.] : 9


Running
-----------------------------------------------------------------------------
Counter                    Rx                   Tx
Total Frames               2049273965           12684791780
Total Octets               1035148165812        8985802047420
Total Frames/Sec           226                  927
Total Bits/Sec             376416               7256088
Minimum Bits/Sec           138984               5216176
Maximum Bits/Sec           16865840             42490664
Total Bits/Sec (L1)        412603               7404440
Minimum Bits/Sec (L1)      167304               5355056
Maximum Bits/Sec (L1)      16986640             42612264
Total Bits/Sec (L2)        376416               7256088
Minimum Bits/Sec (L2)      138984               5216176
Maximum Bits/Sec (L2)      16865840             42490664
Unicast Frames             1112614221           12425146359
Multicast Frames           866141791            108411074
Broadcast Frames           70518377             151236130

CRC Errors                 1
Error Frames               0
L2CP Discarded             0
OAM Discarded              0
Unknown Protocol Discarded 0
CRC Errors/Sec             0
Jabber Errors              0
Oversize Frames            0                    0
Unmapped Cos Frames        0                    --
MTU Discarded              --                   0

64 Octets                  21190551             42432272
65-127 Octets              1180598932           4979404426
128-255 Octets             196747840            843109301
256-511 Octets             58653981             985646955
512-1023 Octets            34030086             667058975
1024-1518 Octets           36603900             4471126030
1519-2047 Octets           521449100            696016158
2048-Max Octets            0                    0

MTU Discarded Flow         --                   --

Measuring the traffic rate passing the interface

ETX220AA>config>port>eth(4/1)# rate-measure interval 10
ETX220AA>config>port>eth(4/1)# show rate

ETX220AA>config>port>eth(4/1)# show rate
Name                       : ETH-4/1
Status                     : In Progress
Time Left  to Elapse (Sec) : 7

ETX220AA>config>port>eth(4/1)#
Name           : ETH-4/1
Status         : Passed
Start Time     : 22-03-2020 13:11:30 UTC +03:00
Duration (Sec) : 10

                L1              L2
Rx Rate (bps) : 186987.20       156491.20
Tx Rate (bps) : 6879152.00      6729664.00

Run ping between 2 ETXes

ETX220AA>config>flows# service-ping local-ip 13.13.13.1/30  dst-ip 13.13.13.2 next-hop 13.13.13.2 egress-port ethernet 4/1 vlan 777 number-of-packets 10 payload-size 1450
# Redundant next-hop for destination in local-ip subnet

Reply from 13.13.13.2: bytes = 1450, packet number = 0, time <= 6 ms
Reply from 13.13.13.2: bytes = 1450, packet number = 1, time <= 2 ms
Reply from 13.13.13.2: bytes = 1450, packet number = 2, time <= 3 ms
Reply from 13.13.13.2: bytes = 1450, packet number = 3, time <= 3 ms
Reply from 13.13.13.2: bytes = 1450, packet number = 4, time <= 3 ms
Reply from 13.13.13.2: bytes = 1450, packet number = 5, time <= 3 ms
Reply from 13.13.13.2: bytes = 1450, packet number = 6, time <= 3 ms
Reply from 13.13.13.2: bytes = 1450, packet number = 7, time <= 3 ms
Reply from 13.13.13.2: bytes = 1450, packet number = 8, time <= 3 ms
Reply from 13.13.13.2: bytes = 1450, packet number = 9, time <= 3 ms
10 packets transmitted. 10 packets received, 0% packet loss
round-trip (ms) min/avg/max = 2/3/6

show config system system-date

22-03-2020   13:18:39  UTC  +03:00

show configure flows summary brief

Name                              Ingress
Admin | Oper | Classification     Egress


Client-A-flow-1  Ethernet     1
Up | Up | Client-A-classifier-50M- Ethernet     3


Client-A-flow-2  Ethernet     3
Up | Up | Client-A-classifier2-50M Ethernet     1

show configure flows summary detail

Name               : Client-A-flow-1
Type               :
Admin Status       : Up
Operational Status : Up
Service Name       : Client-A-Service-50M-ETH
Test               : Off
Classifier         : Client-A-classifier-50M

Ingress Port : Ethernet    1
Egress Port  : Ethernet    3



Name               : Client-A-flow-2
Type               :
Admin Status       : Up
Operational Status : Up
Service Name       : Client-A-Service-50M-ETH
Test               : Off
Classifier         : Client-A-classifier2-50M
Policer            : S.50M_NEW

Ingress Port : Ethernet    3
Egress Port  : Ethernet    1

show config reporting brief-alarm-log

Last Acknowledge On : --           --

              Critical   Major      Minor
Total     :   0          22         0
Since Ack :   0          22         0


Source                 Name                             Last Raised  Last Cleared Total Times
                       Severity                                                   Since Ack

System               pm_process_disabled              2020-02-10   --           1
                     Major                            11:15:00.07  --           1
Station Clock Port 1 los                              2020-01-21   --           1
                     Major                            02:34:08.07  --           1
Domain 1             station_clock_unlock             2020-01-21   --           1
                     Major                            02:33:24.07  --           1
Ethernet 1/1         los                              2020-01-21   2020-01-21   1
                     Major                            02:34:09.07  02:34:09.09  1
Ethernet 1/2         los                              2020-01-21   --           1
                     Major                            02:34:07.07  --           1

Resources

Follow me on https://www.linkedin.com/in/yurislobodyanyuk/ not to miss what I publish on Linkedin, Github, blog, and more.