MRV Optiswitch OS904 OS906 OS912 debug and diagnostic commands

in Linux
#Linux

MRV Communications (acquired in 2017 by ADVA Optical Networking) is an Israeli company known for their optical network equipment, most notably their Optiswitch Carrier Ethernet Switch series. The switches (OS904, OS906G, OS912) are not available for purchase from them anymore, but if you work for a telco company, you surely still have these boxes around doing their work.

Unfortunately, with the merger and the end of sale, all the documentation disappeared as well. To help you a bit I bring below some debug and diagnostic commands to be run on the CLI. You can still find the datasheet here www.cornet-solutions.co.jp/pdf/mrv_os_900_sdb_a4_hi.pdf

Command Description

no cli-paging/cli-paging

Enable/disable paging the output.

show <smth> | <include/begin/end/exclude> <search term>

Pipe output of some show command, e.g. find specific MAC address: show lt | include B1:12 (search terms are case sensitive). Also can pipe to few Linux commands, e.g. count number of learned/dynamic MACs: show lt | grep -c "DYNAMIC"

show run

Show the running configuration

show port

Show port summary: state (on/off), speed, media (copper/sfp), duplex state

show interface

List of logical/vlan interfaces, MAC addresses, IP address (if any)

show port detail n

Show details of the port number n: media type, speed/duplex configured and actual, state, shaping applied.

show port statistics n

Show real-time statistics: packets/bytes received/sent, CRC and other error count

show l2cntrl-protocol-counters

Show counters of received/transmitted Layer 2 control protocols - LACP, MSTP, RSTP, OAM.

show run ports

Show running configuration for all ports

show port tag

Show tagging/vlans configured on each port

show port sfp-diag n

Show real-time diagnostic data for the interface: TX/RX power in dBm, voltage, temperature

show port sfp-params

Physical parameters of the SFP interface

show port rate portnumber time seconds

Show the rate of the traffic passing the interface real-time

monitor port statistics portnumber

Show the same data as show port statistics but refresh every other second

(config)# port state disable/enable portnumber

Disable/enable MRV port number portnumber (shut/no shut in Cisco terminology). Make sure you don’t disable th eport you are connected through.

(config)# port media-select <sfp/sfp100/copper/auto/sgmii>

Set manually type of physical interface installed in MRV.

(config)# port speed <10/100/1000/auto> <portnumber/all>

Force specific speed settting for a port.

show lt [port <portnumber> tag all]

Show MAC address table - static and learned dynamic. Output also gives timestamp when MAC address displayed was last changed. Optionally, specify port to show only MACs on this port.

(config)# clear lt

Delete all learned MAC addresses from Learning Table.

show syslog <all/debug/info/warning/error/fatal> [start-date] [end-date]

Show logs per their severity. Optional start/end dates are in format mm-dd-ff:mm:ss . If remote syslog is configured in the MRV, there will be NO local logs, to verify - look in configuration show run | i rsyslog.

clear syslog

Delete all local log entries.

show ver

Show the device model, hardware, fan status, OS installed, MAC address, serial number and uptime.

show time

Show system time. Important for checking alarms and logs

show cpu

CPU properties

Examples

show syslog info

Feb 16 14:04:20 sw-1 sport_srv[667]: INFO, port_tbl.c(681), - Port 3:TO_CLIENT_LAN: link changed UP->DOWN
Feb 16 14:06:13 sw-1 sport_srv[667]: INFO, port_tbl.c(681), - Port 3:TO_CLIENT_LAN: link changed DOWN->UP

show interface

    INTERFACES TABLE
    ================
    Name    M  Device     IP                State MAC               Tag  Ports
    -------------------------------------------------------------------------------
    vif327  *  vif327     172.35.101.118/25  UP   3C:A7:2B:11:22:33  327  6
    vif777     vif777     -                  UP   3C:A7:2B:11:22:33  777 3,5
    vif277     vif277     -                  UP   3C:A7:2B:11:22:33  277 2,6
    vif555     vif555     -                  UP   3C:A7:2B:11:22:33  555 4,6
    agFPGA     vif333     -                  UP   3C:A7:2B:11:22:33  333
    vif0       vif0       -                  UP   3C:A7:2B:11:22:33  0001 1

show port tag

Value of ethertype 1 is 0x8100 (default value)
Value of ethertype 2 is 0x8100 (default value)

PORT TAG CONFIGURATION
======================
port   OUTBOUND-TAGGED DEF/EFF-TAG NUM-TAGS ETHERTYPE     TAGS-LIST
------------------------------------------------------------------------------
1      q-in-q           777           0     CORE1:0x8100
2      q-in-q          1151           1     CORE1:0x8100  1735
3      untagged         778           1     CORE1:0x8100  778
4      q-in-q          3069           1     CORE1:0x8100  3069
5      tagged             0           1     CORE1:0x8100  778
6      tagged             0           3     CORE1:0x8100  301,1735,3069

show run ports

port media-select sfp 5-6
port media-select copper 1-4
port description 1 TO_CLIENT_LAN
port description 2 TO_CLIENT_LAN6
port description 3 TO_CLIENT_15LAN
port speed 1000 3-4,6
port duplex full 3-4,6
port l2protocol-tunnel cdp 1,4-5
port l2protocol-tunnel dtp 1,4-5
port l2protocol-tunnel pagp 1,4-5
port l2protocol-tunnel udld 1,4-5
port l2protocol-tunnel lamp 1,4-5
port l2protocol-tunnel efm 1,4-5
port l2protocol-tunnel dot1x 1,4-5
port l2protocol-tunnel elmi 1,4-5
port l2protocol-tunnel lldp 1,4-5
port l2protocol-tunnel garp 1,4-5
port l2protocol-tunnel stp 1,4-5
port l2protocol-tunnel vtp 1,4-5
port l2protocol-tunnel lacp 1,4-5

! Flood limiting configuration
port flood-limiting rate 16m 1-2,4,6
port flood-limiting multicast 1-2,4,6
port flood-limiting broadcast 1-2,4,6
port flood-limiting tcp-syn 1-2,4,6
!
! Port shaping configuration
port ingress-shaping rate 200m burst-size 500K 1
port ingress-shaping rate 500m burst-size 500K 2
port ingress-shaping rate 200m burst-size 500K 4
port mtu-size 1 9000
port mtu-size 2 9000
port mtu-size 3 9000
port mtu-size 4 9000
port mtu-size 5 9000
port mtu-size 6 9000
!
! Port tag configuration
port tag-outbound-mode q-in-q 1 777
port tag-outbound-mode q-in-q 2 1151
port tag-outbound-mode q-in-q 4 3069
port tag-outbound-mode tagged 5-6
!
! Port access-group configuration
port acl-binding-mode by-port 1-2,4
port access-group extra MARK-GOLD 1-2

show port detail 1

Port 1 details:
-------------------
Description         : TO_CLIENT_LAN
Type                : ETH10/100/1000
Media-select mode   : COPPER
Link                : ON Copper (22w5d23h7m54s)
Duplex state        : FULL
PHY                 : COMBO+100FX
Speed selected      : AUTO
Actual speed        :  1 Gbps
Auto-Neg Advertise  : Default
Selected cross mode : AUTO
Actual cross mode   : MDI-X
Bypass mode         : ENABLE
State               : ENABLE
Priority            : 1
Ingress-shaping      : rate 200m, burst-size 500K
Flow control mode   : off
Ethertype           : CORE1:0x8100
OutBound Tagged     : q-in-q
DEI Remarking       : Unsupported
UDLD Protocol       : -
Flood limiting      : rate 16m
Flood limiting      : multicast
Flood limiting      : broadcast
Flood limiting      : tcp-syn

show port statistics 1

PORTS STATISTICS
================

Port 1 Ethernet counters
---------------------------
Good bytes received                   : 21109023744
Good packets received                 : 229858629
Good unicast packets received         : 44563
Good broadcast packets received       : 189225588
Good multicast packets received       : 40588478
Bytes transmitted                     : 24736
Packets transmitted                   : 184
Unicast packets transmitted           : 0
Broadcast packets transmitted         : 22
Multicast packets transmitted         : 162
CRC or Alignment error received       : 0
Undersize received                    : 0
Oversize received                     : 0
Fragments received                    : 0
Jabber received                       : 0
Collisions received and transmitted   : 0
Incoming packets discarded            : 0

Port 1 RMON Packet Size Distribution Counters
------------------------------------------------
    -  64 Octets : 7651257
  65- 127 Octets : 219471486
128- 255 Octets : 1965361
256- 511 Octets : 762381
512-1023 Octets : 832
1024-     Octets : 7496

monitor port statistics 6

================
PORTS STATISTICS
Port 6 Ethernet counters
---------------------------
Good bytes received                   : 40184915539765
Good packets received                 : 38232352643
Good unicast packets received         : 38183697762 72
Good broadcast packets received       : 7212122 037
Good multicast packets received       : 41442759 26
Bytes transmitted                     : 26733233507233
Packets transmitted                   : 32870177824
Unicast packets transmitted           : 32764627741 95
Broadcast packets transmitted         : 80848488 19087
Multicast packets transmitted         : 24701595 91071
CRC or Alignment error received       : 0 232343275 13
Undersize received                    : 0 183688400 61
Oversize received                     : 0 12122 825
Fragments received                    : 0 442753 59 38
Jabber received                       : 0 733232292897
Collisions received and transmitted   : 0 870173381
Incoming packets discarded            : 0 764623299 87
Broadcast packets transmitted         : 80848488 95
Multicast packets transmitted         : 24701594 14
CRC or Alignment error received       : 0 848488 85197
Undersize received                    : 0 701593 01
Oversize received                     : 0 764602923
Fragments received                    : 0 848488
Jabber received                       : 0 701590
Collisions received and transmitted   : 0
Incoming packets discarded            : 0
Collisions received and transmitted   : 0
Incoming packets discarded            : 0
Jabber received                       : 0
Collisions received and transmitted   : 0
Incoming packets discarded            : 0

show port rate 6 time 10

The answer will be ready in 10 seconds
Results for port 6:
Tx: 4779 Kbps, 1805 pps, rate 5.068 Mbps
Rx: 26639 Kbps, 3439 pps, rate 27.189 Mbps

show port sfp-params

SFP ports internal EEPROM data
================================
Port  1: Failed to get EEPROM Data, SFP is not inserted

Port 5: SFP EEPROM Parameters
**************************************************************************
  Identifier is SFP
  Connector code is LC
  Transceiver subcode is Base-BX10
  Serial encoding mechanism is 8B10B
  The nominal bit rate is 1300 Megabits/sec.
  Link length using single mode (9 micron) is greater than 20000 m.
  Link length using 50 micron multi-mode fiber is not supported.
  Link length using 62.5 micron multi-mode fiber is not supported.
  Vendor name is OEM
  Vendor PN is SFP-BD-BX43-M
  Vendor revision is 1.0
  Vendor SN is GS1601156303
  Nominal transmitter output wavelength at room temperature is 1490.00 nm.

show port sfp-diag 5

SFP ports internal EEPROM data
================================

   Port  5: SFP Digital Diagnostics
****************************************************
  Description           Real-Time Value
  --------------------  ---------------
  Temperature (C)/(F):    33/91
  Voltage         (V):     3.3292
  TX Bias        (mA):    17.658
  Tx Power (dBm)/(mW):   -6.0/0.252
  Rx Power (dBm)/(mW):   -8.2/0.151
****************************************************

show lt port 5 interface all

INDEX   MAC ADDRESS        VID  PORT   MODE     LAST CHANGE
-------------------------------------------------------------------
1       84:78:AC:11:22:33  901  5      DYNAMIC  03/12/2020 10:55:00

show time

Sun Apr 5 12:35:58 ISR 2020

show ver

MRV OptiSwitch 912C
=========================
Hardware
--------
Board serial number: 1212121212
Unit serial number : 12312312318

CPU: FERO5181, 400Mhz with 64MB flash and 256MB Dram memory
CPU Hardware: id 1, version 1
Device Hardware version: 1
Device temperature: 33C / 91F (normal)

FPGA HW type: 2
FPGA version: 0x2E

Power Supplies:
unit 1 AC: INSTALLED & ACTIVE  (hw-type 1)
unit 2 AC: INSTALLED & ACTIVE  (hw-type 1)

Fans:
Fan 1: ACTIVE

Valid ports: 1-12  (extra features: 1-10)
Valid e-ports: None

Software
--------
MasterOS version: 2_1_7B
Build time: Wed Jun 15 15:23:42 IDT 2011
Based on:
Linux CUST-8348-OS912AC2-1 2.6.22.7 #734 Tue Jan 4 10:08:14 IST 2011 armv5tejl
ZebOS 5.2 (arm-none-linux-gnueabi).
Driver v1.9.3.2, cpssDxCh v3.2.p2_Release

Base MAC address: 3C:A7:2B:11:22:33

Supported features:
-------------------
MSTP -     Yes
G.8032 -   Yes
ROUTING -  Yes
RIP -      Yes
OSPF -     Yes
ISIS -     Yes
BGP -      Yes
MPLS -     No
LDP -      No
RSVP -     No
WEB -      No
IPv6 -     No
Nextragen SIP test agent -   Yes

up 1173 days  4:51
users: remote - 1, console is closed

show ver | inc up

up 1173 days  4:51

show cpu

Processor       : ARM926EJ-S rev 0 (v5l)
BogoMIPS        : 266.24
Features        : swp half thumb fastmult edsp
CPU implementer : 0x41
CPU architecture: 5TEJ
CPU variant     : 0x0
CPU part        : 0x926
CPU revision    : 0
Cache type      : write-back
Cache clean     : cp15 c7 ops
Cache lockdown  : format C
Cache format    : Harvard
I size          : 32768
I assoc         : 1
I line length   : 32
I sets          : 1024
D size          : 32768
D assoc         : 1
D line length   : 32
D sets          : 1024

Hardware        : Feroceon
Revision        : 0000
Serial          : 0000000000000000
vendor          : Marvell FEROCEON
machine         : MRV SBC

Resources

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