Cumulus Linux vs Cisco NX-OS: Interface Show Commands

Follow

Cumulus Linux includes a number of interface show commands to troubleshoot your switch. While Cumulus Linux is Linux, and the same tried and true Linux commands work in the same way, the Cumulus Linux network command line utility shows even more relevant information in a single command.

{{table_of_contents}}

Showing Layer 1/2 Interface Status

Network OS Output
Cumulus Linux Show current interface state for all switch ports:
cumulus@switch:~$ net show interface all
       Name           Master     Speed      MTU  Mode            Remote Host      Remote Port        Summary
-----  -------------  ---------  -------  -----  --------------  ---------------  -----------------  ---------------------------------------
UP     lo             None       N/A      65536  Loopback                                            IP: 10.254.0.3/32, 127.0.0.1/8, ::1/128
UP     eth0           mgmt       1G        1500  Mgmt            oob-mgmt-switch  swp8               IP: 192.168.0.13/24(DHCP)
UP     swp1           bond-swp1  1G        1500  BondMember      server03         44:38:39:00:00:28  Master: bond-swp1(UP)
UP     swp2           bond-swp2  1G        1500  BondMember      server04         44:38:39:00:00:23  Master: bond-swp2(UP)
UP     swp49          peerlink   1G        1500  BondMember      leaf04           swp49              Master: peerlink(UP)
UP     swp50          peerlink   1G        1500  BondMember      leaf04           swp50              Master: peerlink(UP)
UP     swp51          None       1G        1500  BGP Unnumbered  spine01          swp3
UP     swp52          None       1G        1500  BGP Unnumbered  spine02          swp3
UP     bond-swp1      bridge     1G        1500  Bond/Access                                         Bond Members: swp1(UP)
UP     bond-swp2      bridge     1G        1500  Bond/Access                                         Bond Members: swp2(UP)
UP     bridge         None       N/A       1500  Bridge/L2                                           Untagged Members: bond-swp1-2, peerlink
UP     mgmt           None       N/A      65536  Interface/L3                                        IP: 127.0.0.1/8
UP     peerlink       bridge     2G        1500  Bond/Trunk                                          Bond Members: swp49(UP), swp50(UP)
UP     peerlink.4094  None       2G        1500  SubInt/L3                                           IP: 169.254.1.1/30
ADMDN  vagrant        None       0M        1500  NotConfigured
UP     vlan20         None       N/A       1500  Interface/L3                                        IP: 10.3.20.253/24
UP     vlan20-v0      None       N/A       1500  Interface/L3                                        IP: 10.3.20.254/32
  Show current interface state for all switch ports that are up:
cumulus@switch:~$ net show interface | grep UP
Cisco Nexus 3000 Series Show current interface state for all switch ports:
switch# show interface brief
--------------------------------------------------------------------------------
Port   VRF          Status IP Address                              Speed    MTU
--------------------------------------------------------------------------------
mgmt0  --           up     192.168.0.1                             1000     1500
--------------------------------------------------------------------------------
Ethernet      VLAN   Type Mode   Status  Reason                   Speed     Port
Interface                                                                   Ch #
--------------------------------------------------------------------------------
Eth1/1        1      eth  access up      none                       1000(D) --
Eth1/2        --     eth  routed down    Administratively down      auto(D) --
...
  Another way to show current interface state for all switch ports that are up:
switch# show interface brief | include up

Showing IP Address Information

IP addresses information for interfaces can be seen a variety of ways in Cumulus Linux. The best way is to use NCLU.

Network OS Output
Cumulus Linux Show current IP addresses for all ports (includes ports with or without an IP address):
cumulus@switch:~$ net show interface
       Name           Master     Speed      MTU  Mode            Remote Host      Remote Port        Summary
-----  -------------  ---------  -------  -----  --------------  ---------------  -----------------  ---------------------------------------
UP     lo             None       N/A      65536  Loopback                                            IP: 10.254.0.3/32, 127.0.0.1/8, ::1/128
UP     eth0           mgmt       1G        1500  Mgmt            oob-mgmt-switch  swp8               IP: 192.168.0.13/24(DHCP)
UP     swp1           bond-swp1  1G        1500  BondMember      server03         44:38:39:00:00:28  Master: bond-swp1(UP)
UP     swp2           bond-swp2  1G        1500  BondMember      server04         44:38:39:00:00:23  Master: bond-swp2(UP)
UP     swp49          peerlink   1G        1500  BondMember      leaf04           swp49              Master: peerlink(UP)
UP     swp50          peerlink   1G        1500  BondMember      leaf04           swp50              Master: peerlink(UP)
UP     swp51          None       1G        1500  BGP Unnumbered  spine01          swp3
UP     swp52          None       1G        1500  BGP Unnumbered  spine02          swp3
UP     bond-swp1      bridge     1G        1500  Bond/Access                                         Bond Members: swp1(UP)
UP     bond-swp2      bridge     1G        1500  Bond/Access                                         Bond Members: swp2(UP)
UP     bridge         None       N/A       1500  Bridge/L2                                           Untagged Members: bond-swp1-2, peerlink
UP     mgmt           None       N/A      65536  Interface/L3                                        IP: 127.0.0.1/8
UP     peerlink       bridge     2G        1500  Bond/Trunk                                          Bond Members: swp49(UP), swp50(UP)
UP     peerlink.4094  None       2G        1500  SubInt/L3                                           IP: 169.254.1.1/30
ADMDN  vagrant        None       0M        1500  NotConfigured
UP     vlan20         None       N/A       1500  Interface/L3                                        IP: 10.3.20.253/24
UP     vlan20-v0      None       N/A       1500  Interface/L3                                        IP: 10.3.20.254/32
  Show current interface state for all switch ports that are up:
cumulus@switch:~$ net show interface | grep UP
Cisco Nexus 3000 Series Show current IP addresses for all ports (this includes only ports with an IP address):
switch# sh ip[v6] interface brief
IP Interface Status for VRF "default"(1)
Interface            IP Address      Interface Status
eth1/1               192.168.0.1     protocol-up/link-up/admin-up
eth1/2               10.10.10.10     protocol-up/link-up/admin-up
...
  Another way to show current interface state for all switch ports that are up:
switch# show ip interface brief | include up

Showing LLDP Neighbor Information

LLDP is used as a way to gather and show information on neighbors and the ports they are connected through. This is very similar CDP in a Cisco Nexus 3000.

Network OS Output
Cumulus Linux Show LLDP neighbors:
cumulus@switch:~$ net show lldp
Summary                    LocalPort    Speed    Mode           RemotePort         RemoteHost
-------------------------  -----------  -------  -------------  -----------------  ---------------
IP: 192.168.0.13/24(DHCP)  eth0         1G       Mgmt           swp8               oob-mgmt-switch
Master: bond-swp1(UP)      swp1         1G       BondMember     44:38:39:00:00:28  server03
Master: bond-swp2(UP)      swp2         1G       BondMember     44:38:39:00:00:23  server04
Master: peerlink(UP)       swp49        1G       BondMember     swp49              leaf04
Master: peerlink(UP)       swp50        1G       BondMember     swp50              leaf04
                           swp51        1G       NotConfigured  swp3               spine01
                           swp52        1G       NotConfigured  swp3               spine02
Cisco Nexus 3000 Series Show current CDP neighbors:
switch# show cdp neighbors  
Capability Codes: R - Router, T - Trans-Bridge, B - Source-Route-Bridge 
                  S - Switch, H - Host, I - IGMP, r - Repeater, 
                  V - VoIP-Phone, D - Remotely-Managed-Device, 
                  s - Supports-STP-Dispute 
 
 
Device ID              Local Intrfce   Hldtme  Capability  Platform      Port ID 
 
d13-dist-1               mgmt0           148     S I      WS-C2960-24TC  Fas0/9 
n5k(FLC12080012)         Eth1/1          8       S I s    N5K-C5020P-BA  Eth1/5 
...

Showing Interface Counters

The ability to see interface counters from NetStat helps in monitoring traffic across each interface.

Network OS Output
Cumulus Linux Show interface counters:
cumulus@switch:~$ net show counters
Kernel Interface table
Iface            MTU    Met    RX_OK    RX_ERR    RX_DRP    RX_OVR    TX_OK    TX_ERR    TX_DRP    TX_OVR  Flg
-------------  -----  -----  -------  --------  --------  --------  -------  --------  --------  --------  -----
bond-swp1       1500      0     1298         0         0         0     1950         0         0         0  BMmRU
bond-swp2       1500      0     1322         0         0         0     1976         0         0         0  BMmRU
bridge          1500      0       26         0         0         0       27         0         0         0  BMRU
eth0            1500      0     9306         0         0         0     6462         0         0         0  BMRU
lo             65536      0        0         0         0         0        0         0         0         0  LRU
mgmt           65536      0     6001         0         0         0     4907         0         0         0  OmRU
peerlink        1500      0     4643         0         4         0     4645         0         0         0  BMmRU
peerlink.4094   1500      0     1533         0         0         0     1534         0         0         0  BMRU
swp1            1500      0     1306         0         0         0     1950         0         0         0  BMsRU
swp2            1500      0     1330         0         0         0     1976         0         0         0  BMsRU
swp49           1500      0     2328         0         0         0     2324         0         0         0  BMsRU
swp50           1500      0     2315         0         2         0     2321         0         0         0  BMsRU
swp51           1500      0     1235         0         0         0     1212         0         0         0  BMRU
swp52           1500      0     1046         0         0         0     1049         0         0         0  BMRU
vlan20          1500      0       24         0         0         0       20         0         0         0  BMRU
vlan20-v0       1500      0       15         0         0         0       13         0         0         0  BMRU
Cisco Nexus 3000 Series Show interface counters: Cisco equivalent to net show counters
show int counter er          

Port        Align-Err    FCS-Err   Xmit-Err    Rcv-Err UnderSize OutDiscards
Te1/1               0          0          0          0         0           0
Te1/2               0          0          0          0         0           0
Te1/3               0          0          0          0         0           0
Te1/4               0          0          0          0         0           0
Te1/5               0          0          0          0         0           0
Te1/6               0          0          0          0         0           0
Te1/7               0          0          0          0         0           0
Te1/8               0          0          0          0         0           0
Te2/1               0          0          0          0         0           0
Te2/2               0          0          0          0         0           0
Te2/3               0          0          0          0         0           0
Te2/4               0          0          0          0         0           0
Te2/5               0          0          0          0         0           0
Te2/6               0          0          0          0         0           0
Te2/7               0          0          0          0         0           0
Te2/8               0          0          0          0         0           0
Gi5/1               0          0          0          0         0           0
Gi5/2               0          0          0          0         0           0
Gi5/3               0          0          0          0         0           0
Te5/4               0          0          0          0         0           0
Te5/5               0          0          0          0         0           0
          
Port        Align-Err    FCS-Err   Xmit-Err    Rcv-Err UnderSize OutDiscards
Gi6/1               0          0          0          0         0           0
Gi6/2               0          0          0          0         0           0
Gi6/3               0          0          0          0         0           0
Te6/4               0          0          0          0         0           0
Te6/5               0          0          0          0         0           0
Po1                 0          0          0          0         0           0
Po2                 0          0          0          0         0           0
Po100               0          0          0          0         0           0

Port      Single-Col Multi-Col  Late-Col Excess-Col Carri-Sen     Runts    Giants
Te1/1              0         0         0          0         0         0         0
Te1/2              0         0         0          0         0         0         0
Te1/3              0         0         0          0         0         0         0
Te1/4              0         0         0          0         0         0         0
Te1/5              0         0         0          0         0         0         0
Te1/6              0         0         0          0         0         0         0
          
Port      Single-Col Multi-Col  Late-Col Excess-Col Carri-Sen     Runts    Giants
Te1/7              0         0         0          0         0         0         0
Te1/8              0         0         0          0         0         0         0
Te2/1              0         0         0          0         0         0         0
Te2/2              0         0         0          0         0         0         0
Te2/3              0         0         0          0         0         0         0
Te2/4              0         0         0          0         0         0         0
Te2/5              0         0         0          0         0         0         0
Te2/6              0         0         0          0         0         0         0
Te2/7              0         0         0          0         0         0         0
Te2/8              0         0         0          0         0         0         0
Gi5/1              0         0         0          0         0         0         0
          
Port      Single-Col Multi-Col  Late-Col Excess-Col Carri-Sen     Runts    Giants
Gi5/2              0         0         0          0         0         0         0
Gi5/3              0         0         0          0         0         0         0
Te5/4              0         0         0          0         0         0         0
Te5/5              0         0         0          0         0         0         0
Gi6/1              0         0         0          0         0         0         0
Gi6/2              0         0         0          0         0         0         0
Gi6/3              0         0         0          0         0         0         0
Te6/4              0         0         0          0         0         0         0
Te6/5              0         0         0          0         0         0         0
Po1                0         0         0          0         0         0         0
Po2                0         0         0          0         0         0         0
          
Port      Single-Col Multi-Col  Late-Col Excess-Col Carri-Sen     Runts    Giants
Po100              0         0         0          0         0         0         0

Port       SQETest-Err Deferred-Tx IntMacTx-Err IntMacRx-Err Symbol-Err
Te1/1                0           0            0            0          0
Te1/2                0           0            0            0          0
Te1/3                0           0            0            0          0
Te1/4                0           0            0            0          0
Te1/5                0           0            0            0          0
Te1/6                0           0            0            0          0
Te1/7                0           0            0            0          0
Te1/8                0           0            0            0          0
Te2/1                0           0            0            0          0
Te2/2                0           0            0            0          0
Te2/3                0           0            0            0          0
Te2/4                0           0            0            0          0
Te2/5                0           0            0            0          0
Te2/6                0           0            0            0          0
Te2/7                0           0            0            0          0
Te2/8                0           0            0            0          0
Gi5/1                0           0            0            0          0
Gi5/2                0           0            0            0          0
          
Port       SQETest-Err Deferred-Tx IntMacTx-Err IntMacRx-Err Symbol-Err
Gi5/3                0           0            0            0          0
Te5/4                0           0            0            0          0
Te5/5                0           0            0            0          0
Gi6/1                0           0            0            0          0
Gi6/2                0           0            0            0          0
Gi6/3                0           0            0            0          0
Te6/4                0           0            0            0          0
Te6/5                0           0            0            0          0
Po1                  0           0            0            0          0
Po2                  0           0            0            0          0
Po100                0           0            0            0          0

show int counter   

Port            InOctets   InUcastPkts   InMcastPkts   InBcastPkts
Te1/1                  0             0             0             0
Te1/2                  0             0             0             0
Te1/3                  0             0             0             0
Te1/4             233333            41          1392             0
Te1/5             209475             0          1323             0
Te1/6                  0             0             0             0
Te1/7                  0             0             0             0
Te1/8                  0             0             0             0
Te2/1             496926            20          4403             0
Te2/2             215649             0          1323             0
Te2/3             497358            20          4407             0
Te2/4             215649             0          1323             0
Te2/5                  0             0             0             0
Te2/6                  0             0             0             0
Te2/7                  0             0             0             0
Te2/8                  0             0             0             0
Gi5/1                  0             0             0             0
Gi5/2                  0             0             0             0
Gi5/3            5361234          2855         57437          3876
Te5/4                  0             0             0             0
Te5/5                  0             0             0             0
          
Port            InOctets   InUcastPkts   InMcastPkts   InBcastPkts
Gi6/1                  0             0             0             0
Gi6/2                  0             0             0             0
Gi6/3                  0             0             0             0
Te6/4                  0             0             0             0
Te6/5                  0             0             0             0
Po1               442808            41          2715             0
Po2              1425672            40         11457             0
Po100                  0             0             0             0

Port           OutOctets  OutUcastPkts  OutMcastPkts  OutBcastPkts
Te1/1                  0             0             0             0
Te1/2                  0             0             0             0
Te1/3                  0             0             0             0
Te1/4             360918            41          1485             0
Te1/5             353770             0          1442             0
Te1/6                  0             0             0             0
Te1/7                  0             0             0             0
Te1/8                  0             0             0             0
Te2/1            5966040             0         81656             0
Te2/2             414592             0          2327             0
Te2/3            3411794             0         31756             0
Te2/4             417438            40          2327             0
Te2/5                  0             0             0             0
          
Port           OutOctets  OutUcastPkts  OutMcastPkts  OutBcastPkts
Te2/6                  0             0             0             0
Te2/7                  0             0             0             0
Te2/8                  0             0             0             0
Gi5/1                  0             0             0             0
Gi5/2                  0             0             0             0
Gi5/3             238494            33           533             0
Te5/4                  0             0             0             0
Te5/5                  0             0             0             0
Gi6/1                  0             0             0             0
Gi6/2                  0             0             0             0
Gi6/3                  0             0             0             0
Te6/4                  0             0             0             0
Te6/5                  0             0             0             0
Po1               714688            41          2927             0
Po2             10209864            40        118066             0
Po100                  0             0             0             0
Have more questions? Submit a request

Comments

Powered by Zendesk