Interface Properties

SONiC switches support various types of interfaces: physical interfaces, port channel interfaces, and VLAN interfaces. Each interface has different characteristics, some of which are configurable.

The switch has two types of physical interfaces: 48 ports with 1G speed and six ports with 25G speed.

  • 25G Ports (10G Ports): The switch has six 25G speed capable SFP28 Ethernet ports. These ports can also be configured to operate at 10G speed with SFP+ cables and transceivers and also can operate at 1G speed. These ports are named from Ethernet48 to Ethernet53.

  • 1 Gigabit Ethernet Ports: The switch has 48 Gigabit Ethernet ports and they operate at 1G speed. These ports can be configured to operate at 100 Mb speed.

Defaults

Interface Name

Interface Numbers

Speed

MTU

Auto-neg

FEC

Gigabit ethernet

Ethernet0–Ethernet47

1G default

Can operate at 100 Mb

9100

Enabled

N/A

Fx-ethernet

Ethernet48–Ethernet53

25G default

Can operate at 10G/1G

9100

Enabled

None

Note: In show interfaces commands, if the naming mode is set to default, then use the interface name. For example, show interfaces status Ethernet1.
If the naming mode is set to alias, then use the alias name. For example, show interfaces status Gi0/2.

Description

Follow the step below to display the interface description string.

Step

Command

Description

1

show interfaces description [interface_name]

Display the interface description configuration.

  • interface_name may be any of the following: Ethernet0–Ethernet53.

The example below shows the commands used to display interface description.

Output from SSE-G3748:

admin@sonic: ~$ show interfaces description

Interface

Oper

Admin

Alias

Description

- - -

- - -

- - -

- - -

- - -

Ethernet0

up

up

Gi0/1

 

Ethernet1

down

up

Gi0/2

 

Ethernet2

down

up

Gi0/3

 

Ethernet3

down

up

Gi0/4

 

Ethernet4

down

up

Gi0/5

 

Ethernet5

down

up

Gi0/6

 

Ethernet6

down

up

Gi0/7

 

Ethernet7

down

up

Gi0/8

 

Ethernet8

down

up

Gi0/9

 

Ethernet9

down

up

Gi0/10

 

Ethernet10

down

up

Gi0/11

 

Ethernet11

down

up

Gi0/12

 

Ethernet12

down

up

Gi0/13

 

Ethernet13

down

up

Gi0/14

 

Ethernet14

down

up

Gi0/15

 

Ethernet15

down

up

Gi0/16

 

Ethernet16

down

up

Gi0/17

 

Ethernet17

down

up

Gi0/18

 

Ethernet18

down

up

Gi0/19

 

Ethernet19

down

up

Gi0/20

 

Ethernet20

down

up

Gi0/21

 

Ethernet21

down

up

Gi0/22

 

Ethernet22

down

up

Gi0/23

 

Ethernet23

down

up

Gi0/24

 

Ethernet24

down

up

Gi0/25

 

Ethernet25

down

up

Gi0/26

 

Ethernet26

down

up

Gi0/27

 

Ethernet27

down

up

Gi0/28

 

Ethernet28

down

up

Gi0/29

 

Ethernet29

down

up

Gi0/30

 

Ethernet30

down

up

Gi0/31

 

Ethernet31

down

up

Gi0/32

 

Ethernet32

down

up

Gi0/33

 

Ethernet33

down

up

Gi0/34

 

Ethernet34

down

up

Gi0/35

 

Ethernet35

down

up

Gi0/36

 

Ethernet36

down

up

Gi0/37

 

Ethernet37

down

up

Gi0/38

 

Ethernet38

down

up

Gi0/39

 

Ethernet39

down

up

Gi0/40

 

Ethernet40

down

up

Gi0/41

 

Ethernet41

down

up

Gi0/42

 

Ethernet42

down

up

Gi0/43

 

Ethernet43

down

up

Gi0/44

 

Ethernet44

down

up

Gi0/45

 

Ethernet45

down

up

Gi0/46

 

Ethernet46

down

up

Gi0/47

 

Ethernet47

down

up

Gi0/48

 

Ethernet48

down

up

Fx0/1

 

Ethernet49

down

up

Fx0/2

 

Ethernet50

down

up

Fx0/3

 

Ethernet51

down

up

Fx0/4

 

Ethernet52

down

up

Fx0/5

 

Ethernet53

down

up

Fx0/6

 

admin@sonic: ~$

admin@sonic: ~$ show interfaces description Ethernet33

Interface

Oper

Admin

Alias

Description

- - -

- - -

- - -

- - -

- - -

Ethernet33

down

up

Gi0/34

 

Output from SSE-T7132:

admin@sonic: ~$ show interfaces description

Interface

Oper

Admin

Alias

Description

- - -

- - -

- - -

- - -

- - -

Ethernet0

down

up

Eth1

 

Ethernet8

down

up

Eth2

 

Ethernet16

down

up

Eth3

 

Ethernet24

down

up

Eth4

 

Ethernet32

down

up

Eth5

 

Ethernet40

down

up

Eth6

 

Ethernet48

down

up

Eth7

 

Ethernet56

down

up

Eth8

 

Ethernet64

down

up

Eth9

 

Ethernet72

down

up

Eth10

 

Ethernet80

down

up

Eth11

 

Ethernet88

down

up

Eth12

 

Ethernet96

up

up

Eth13

 

Ethernet104

down

up

Eth14

 

Ethernet112

down

up

Eth15

 

Ethernet120

down

up

Eth16

 

Ethernet128

down

up

Eth17

 

Ethernet136

down

up

Eth18

 

Ethernet144

down

up

Eth19

 

Ethernet152

down

up

Eth20

 

Ethernet160

up

up

Eth21

 

Ethernet168

down

up

Eth22

 

Ethernet176

down

up

Eth/23

 

Ethernet184

down

up

Eth/24

 

Ethernet192

down

up

Eth/25

 

Ethernet200

down

up

Eth/26

 

Ethernet208

down

up

Eth/27

 

Ethernet216

down

up

Eth28

 

Ethernet224

down

up

Eth29

 

Ethernet232

down

up

Eth30

 

Ethernet240

down

up

Eth31

 

Ethernet248

down

up

Eth32

 

Ethernet256

down

up

Eth33

 

Ethernet257

down

up

Eth34

 

admin@sonic:~$ show interface des Ethernet96

Interface

Oper

Admin

Alias

Description

- - -

- - -

- - -

- - -

- - -

Ethernet96

up

up

Eth13

 

Auto-Negotiation in SSE-G3748

Interface speed is negotiated between the connected devices if both ends support negotiation.

Auto-negotiation is enabled by default on all the Gi ports and all the Fx ports.

Step

Command

Description

1

config interface autoneg <interface_name> <mode>

Turn auto-negotiation on or off.

  • interface_name may be any of the following interfaces: Ethernet0–Ethernet53.

  • mode: Enable or disable auto-negotiation.

2

show interface autoneg status

Display the auto-negotiation status for all interfaces.

3

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

The example below shows the commands used to configure interface auto-negotiation.

admin@sonic:~$ sudo config interface autoneg Ethernet0 enabled

admin@sonic:~$ show interface autoneg status |grep Ethernet0

Ethernet0

enabled

1G

N/A

N/A

N/A

up

up

admin@sonic:~$ sudo config interface autoneg Ethernet50 disabled

admin@sonic:~$ show interface autoneg status |grep Ethernet50

Ethernet50

disabled

25G

N/A

N/A

N/A

down

up

admin@sonic:~$

Auto-Negotiation in SSE-T7132

Interface speed is negotiated between the connected devices, if both ends support negotiation. The auto-negotiation in high speed interface includes FEC and link training. Currently, auto-negotiation cannot be enabled or disabled from the SONiC CLI. SSE-T7132S does not support 400G auto-negotiation.

Auto-negotiation can be enabled while creating the devport. Link training must be enabled and the auto-negotiation and base-page technology abilities must be set appropriately based on the number of lanes assigned to the port.

Auto-negotiation is disabled by default on all ports. The switch supports the following modes for the ports:

  • 10GBASE-KR

  • 40GBASE-KR4

  • 40GBASE-CR4

  • 100GBASE-KR4

  • 100GBASE-CR4

  • 25GBASE-KR-S/CR-S

  • 25GBASE-KR/CR

  • 50GBASE-KR/CR

  • 100GBASE-KR2/CR2

  • 200GBASE-KR4/CR4

The speed and FEC type are not mandatory when auto-negotiation is enabled.

In the corresponding configuration file for each SKU, devports and their properties (like speed, physical lane number, and number of lanes) are defined. The first devport with the eth type in the YAML config file is mapped to the first interface in SONiC, such as Ethernet0, 2nd devport with the eth type mapped to Ethernet8 if it is a 400G speed interface. The index number of the SONiC Ethernet interface is determined by the SerDes lane index, which starts from zero in SONiC. For example, in the default 400G SKU configuration, each Ethernet interface takes eight SerDes lanes, so the logical interface index is 0, 8, 16, 24, and so on.

The example below shows a devport definition in the config file, config_16x400G_64x100G_sse_t7132s.yaml under /usr/share/sonic/device/x86_64-supermicro_sse_t7132s-r0/Supermicro_sse_t7132s_16x400_64x100_habana.

devports

-

id: “0”

◄Devport ID

 

sysport: “1000”

◄System-port associated with this devport

 

type: “cpu”

◄Devport type: to CPU

-

fec: “KPFEC”

◄FEC type for devport 241

 

id: “241”

◄Devport ID

 

lanes: “0:8”

◄SerDes lanes associated with this devport

 

serdes_group: “30”

◄Innovium SerDes Group associated with this devport

 

speed: “400G”

◄Speed

 

sysport: “241”

◄System-port associated with this devport

 

type: “eth”

◄Devport type

The speed and FEC type are not mandatory when auto-negotiation is enabled.

The example below shows the config file change to enable auto-negotiation on devport ID 241.

devports

-

id: “0”

 

sysport: “1000”

 

type: “cpu”

-

fec: “KPFEC”

◄Not mandatory when auto_neg is true

 

 

id: “241”

◄Devport ID

 

 

lanes: “0:8”

 

serdes_group: “30”

 

speed: “400G”

◄Not mandatory when auto_neg is true

 

 

auto_neg: "true"

 

link_training: "true"

◄Must be true when auto_neg is true

 

 

bp_tech_ability: “200GBASE_KR4_CR4, 100GBASE_KR2_CR2, 50GBASE_KR_CR”

◄Base page tech ability

 

sysport: “241”

 

type: “eth”

Forward Error Correction (FEC) Mode in SSE-G3748

The switch allows user to enable or disable FEC mode on Fx-Ethernet ports. FEC mode can be useful in noisy links where errors in transmission cause retransmission. The switch supports Reed-Solomon (RS), and Fire-code (FC) FECs. By default on all Fx-Ethernet ports, the FEC is set to RS.

Follow the steps below to enable FEC mode on an interface.

Step

Command

Description

1

config interface fec <interface_name> <interface_fec>

Configure FEC on the interface.

  • interface_name may be any of the following interfaces: Ethernet48–Ethernet53.

  • interface_fec: rs, fc, and none.

2

show interface status

Display the interface status for all interfaces with the current FEC.

3

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

The example below shows the commands used to configure the FEC for the Fx-Ethernet interface.

admin@sonic:~$ sudo config interface fec Ethernet53 rs

admin@sonic:~$ show interface status |grep -E "Ethernet53|--|Interface"

Interface

Lanes

Speed

MTU

FEC

Alias

Vlan

Oper

Admin

Type

Asym PFC

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet53

53

25G

9100

rs

Fx0/6

routed

up

up

SFP/SFP+/SFP28

N/A

admin@sonic:~$

FEC in SSE-T7132

There are eight SerDes lanes in each QSFP-DD which can support different lane speeds (10G/25G/50G) and form different MAC speeds of 400 GbE, 200 GbE, and 100 GbE. The following table shows the combinations of MAC speed, FEC, and Lanes.

MAC Speed

PCS-FEC

Lanes

Start Lane

Restriction

400 GbE

CL119 PCS with KP-FEC

8

0

None

200 GbE

CL119 PCS with KP-FEC

8

0

None

200 GbE

CL119 PCS with KP-FEC

4

0, 4

None

100 GbE

CL91 PCS with KP-FEC/KR-FEC

2

0, 2, 4, 6

0,2: no KR-FEC mixed with KP-FEC

4,6: no KR-FEC mixed with KP-FEC

100 GbE

CL91 PCS with KP-FEC/KR-FEC

4

0, 4

None

100 GbE

CL82 PCS with no FEC

4

0, 4

None

50 GbE

CL133 PCS with KP-FEC/KR-FEC

1

0, 1, 2, ...7

0,1,2,3: no KR-FEC mixed with KP-FEC

4,5,6,7: no KR-FEC mixed with KP-FEC

50 GbE

CL133PCS with KP-FEC/KR-FEC/no FEC

2

0, 2, 4, 6

0,2: no KR-FEC mixed with KP-FEC

4,6: no KR-FEC mixed with KP-FEC

25 GbE

CL107/25GEC PCS with KR-FEC/FC-FEC/no FEC

1

0, 1, 2, ...7

0,1,2,3: no KR-FEC mixed with KP-FEC

4,5,6,7: no KR-FEC mixed with KP-FEC

40 GbE

CL82 PCS with no FEC

4

0, 4

None

10 GbE

CL49 PCS with no FEC

1

0, 1, 2, ...7

None

Follow the steps below to enable FEC mode on the interface.

The example below shows the field in the config file used to configure the FEC for devport 241, interface Ethernet0.

devports

-

id: “0”

◄Devport ID

 

sysport: “1000”

◄System-port associated with this devport

 

type: “cpu”

◄Devport type: to CPU

-

fec: “NONE”

◄FEC type for devport 241

 

id: “241”

 

 

lanes: “0:8”

 

 

serdes_group: “30”

 

 

speed: “400G”

 

 

sysport: “241”

 

 

type: “eth”

 

The example below shows the commands used to check the FEC setting.

admin@sonic:~$ show interface status Ethernet0

Interface

Lanes

Speed

MTU

FEC

Alias

Vlan

Oper

Admin

Type

Asym PFC

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet0

241, 242, 243, 244, 245, 246, 247, 248

400G

9100

none

Eth1

routed

down

up

 

N/A

N/A

Speed in SSE-G3748

The Gigabit Ethernet interfaces Ethernet0 to Ethernet47 auto-negotiate to operate at 1G or 100 Mb by default. The 25G-Ethernet interfaces Ethernet48 to Ethernet53 operate at 25G by default. This default speed can be changed.

25G Ethernet ports can be configured to operate in speed 10G or 1G. FEC and negotiation must be disabled before setting the 25G-Ethernet ports to 10G.

1G Gigabit Ethernet ports can be configured to operate at 100 Mb. The auto-negotiation must be disabled before setting the Gi-Ethernet ports to 100 Mb.

Follow the steps below to configure interface speed.

Step

Command

Description

1

config interface speed <interface_name> <interface_speed>

Configure the speed for the interface.

  • interface_name may be any of the following interfaces: Ethernet0–Ethernet53.

  • interface_speed: The interface speed in Mbps.

2

show interface status

Display the interface status for all interfaces with the current speed.

3

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

The example below shows the commands used to configure the speed for the Gi-Ethernet interface.

admin@sonic:~$ sudo config interface autoneg Ethernet0 disabled

admin@sonic:~$ sudo config interface speed Ethernet0 100

admin@sonic:~$ show interface status |grep -E "Ethernet0|--|Interface"

Interface

Lanes

Speed

MTU

FEC

Alias

Vlan

Oper

Admin

Type

Asym PFC

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet0

0

100M

9100

none

Gi0/1

routed

down

up

N/A

N/A

admin@sonic:~$

The example below shows the commands used to configure the speed for the Fx-Ethernet interface.

admin@sonic:~$ sudo config interface autoneg Ethernet53 disabled

admin@sonic:~$ sudo config interface fec Ethernet53 none

admin@sonic:~$ sudo config interface speed Ethernet53 10000

admin@sonic:~$ show interface status |grep -E "Ethernet53|--|Interface"

Interface

Lanes

Speed

MTU

FEC

Alias

Vlan

Oper

Admin

Type

Asym PFC

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet53

53

10G

9100

none

Fx0/6

routed

up

up

SFP/SFP+/SFP28

N/A

admin@sonic:~$

Speed in SSE-T7132

The Ethernet256 and Ethernet257 are fixed at 10G without auto-negotiation and cannot be changed.

The speed of other Ethernet interfaces depends on the devport setting in the SKU config file. The switch does not support the speed commands.

Shutdown/Startup

The admin statuses of interfaces are set to up by default. Follow the steps below to shut down or start up (no shutdown) the interface.

Step

Command

Description

1

config interface startup <interface_name>

Change the admin state of the interface to up.

  • interface_name may be any of the following interfaces: Ethernet0–Ethernet53.

2

config interface shutdown <interface_name>

Change the admin state of the interface to down.

  • interface_name may be any of the following interfaces: Ethernet0–Ethernet53.

3

show interface status

Display the admin state and operational state of the interfaces.

4

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

The example below shows the commands used to shut down the interface.

admin@sonic:~$ sudo config interface shutdown Ethernet0

admin@sonic:~$ show interface status |grep -E "Ethernet0|--|Interface"

Interface

Lanes

Speed

MTU

FEC

Alias

Vlan

Oper

Admin

Type

Asym PFC

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet0

0

1G

9100

none

Gi0/1

routed

down

down

N/A

N/A

admin@sonic:~$

The example below shows the commands used to start up (no shutdown) the interface.

admin@sonic:~$ sudo config interface speed Ethernet53 10000

admin@sonic:~$ show interface status |grep -E "Ethernet53|--|Interface"

Interface

Lanes

Speed

MTU

FEC

Alias

Vlan

Oper

Admin

Type

Asym PFC

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet0

0

1G

9100

none

Gi0/1

routed

up

up

N/A

N/A

admin@sonic:~$

MTU

The Maximum Transmission Unit (MTU) size is the maximum size of the frame that can be switched through the interface. The MTU value for an interface can be changed.

Follow the steps below to configure the interface MTU.

Step

Command

Description

1

config interface mtu <interface_name> <mtu_value>

Configure interface MTU.

  • interface_name may be any of the following: Ethernet0–Ethernet53.

  • mtu_value: Maximum transmission unit.

2

show interface status

Display the interface configuration.

3

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

The example below shows the commands used to configure the interface MTU.

admin@sonic: ~$ sudo config interface mtu Ethernet44 1500

admin@sonic: ~$ show interfaces status

Interface

Lanes

Speed

MTU

FEC

Alias

Vlan

Oper

Admin

Type

Asym PFC

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet43

43

1G

9100

none

Gi0/44

routed

down

up

N/A

N/A

Ethernet44

44

1G

1500

none

Gi0/45

routed

down

up

N/A

N/A

admin@sonic:~$

Advertised-Speed

Follow the steps below to configure interface advertised-speeds.

Step

Command

Description

1

config interface autoneg [OPTIONS] <interface_name> <mode>

config interface advertised-speeds <interface_name> <speed_list>

Configure interface advertised-speeds.

  • interface_name may be any of the following: Ethernet0–Ethernet53.

  • mode: Enable or disable auto-negotiation.

  • speed_list: Valid speeds are 1000, 100, 10000, 0, and all.

2

show interface autoneg status

Display the interface auto-negotiation configuration.

3

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

Note: To configure advertised-speed for an interface, auto-negotiation must be enabled on that interface (e.g: sudo config interface autoneg Ethernet4 enabled).

The example below shows the commands used to configure the interface advertised-speed. The Rmt Adv Speeds value displayed is the value advertised by the peer device and may vary depending on the peer device’s capability.

admin@sonic:~$ sudo config interface autoneg Ethernet4 enabled

admin@sonic:~$ sudo config interface advertised-speeds Ethernet4 all

admin@sonic:~$ show interface autoneg status Ethernet4

Interface

Auto-Neg Mode

Speed

Adv Speeds

Rmt Adv Speeds

Type

Adv Types

Oper

Admin

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet4

enabled

1000M

all

100M, 1000M

N/A

N/A

up

up

admin@sonic:~$ sudo config interface advertised-speeds Ethernet4 1000

admin@sonic:~$ show interface autoneg status Ethernet4

Interface

Auto-Neg Mode

Speed

Adv Speeds

Rmt Adv Speeds

Type

Adv Types

Oper

Admin

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet4

enabled

1000M

1000M

100M, 1000M

N/A

N/A

up

up

admin@sonic:~$

Advertised-Type

Follow the steps below to configure interface advertised-type.

Step

Command

Description

1

config interface autoneg [OPTIONS] <interface_name> <mode>

config interface advertised-type <interface_name> <interface_type_list>

Configure interface advertised-type.

  • interface_name may be any of the following: Ethernet0–Ethernet53.

  • mode: Enable or disable auto-negotiation.

  • interface_type_list: Valid interface types are KR, XGMII, KR4, SR4, LR, CR2, XLAUI, XFI, SR, SR2, CR, LR4, none, GMII, SFI, CR4, CAUI, XAUI, CAUI4, KR2, and all.

2

show interface autoneg status

Display the interface auto-negotiation configuration.

3

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

Note: To configure advertised-type for an interface, auto-negotiation must be enabled on that interface (e.g: sudo config interface autoneg Ethernet4 enabled).

The example below shows the commands used to configure interface advertised-types.

admin@sonic:~$ sudo config interface autoneg Ethernet10 enabled

admin@sonic:~$ sudo config interface advertised-types Ethernet10 all

admin@sonic:~$ show interface autoneg status Ethernet10

Interface

Auto-Neg Mode

Speed

Adv Speeds

Type

Adv Types

Oper

Admin

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet10

enabled

1G

N/A

N/A

all

down

up

admin@sonic:~$

admin@sonic:~$ sudo config interface advertised-types Ethernet10 CR

admin@sonic:~$ show interface autoneg status Ethernet10

Interface

Auto-Neg Mode

Speed

Adv Speeds

Type

Adv Types

Oper

Admin

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet10

enabled

1G

N/A

N/A

CR

down

up

admin@sonic:~$

Note: This command will accept only the supported advertised-types for the given platform and given port; the supported advertised-types values will vary based on the platform and port.

Configure IPv4 Address

Follow the steps below to configure the IPv4 address for an interface.

Step

Command

Description

1

config interface ip add <interface_name> <ip_addr> <default gateway IP address>

Configure interface IP.

  • interface_name may be any of the following: Ethernet0–Ethernet53.

  • ip_addr: A valid IPv4 address.

  • gateway IP address: A valid IPv4 address.

2

show interface status

Display the interface configuration.

3

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

The example below shows the commands used to configure the IP address for an interface.

admin@sonic:~$ sudo config interface ip add Ethernet3 192.168.80.13/24

admin@sonic:~$ show ip interfaces

Note: Truncated output is added here.

Interface

Master

IPv4 address/mask

Admin/Oper

BGP Neighbor

Neighbor IP

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet3

 

192.168.80.13/24

up/up

N/A

N/A

docker0

 

240.127.1.1/24

up/down

N/A

N/A

eth0

 

172.18.0.154/24

up/up

N/A

N/A

lo

 

127.0.0.1/16

up/up

N/A

N/A

admin@sonic:~$ sudo config interface ip add Ethernet1 192.168.12.13/24 192.168.12.254

admin@sonic:~$ show ip interfaces

Interface

Master

IPv4 address/mask

Admin/Oper

BGP Neighbor

Neighbor IP

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet1

 

192.168.12.13/24

up/up

N/A

N/A

Ethernet3

 

192.168.80.13/24

up/up

N/A

N/A

docker0

 

240.127.1.1/24

up/down

N/A

N/A

eth0

 

172.18.0.154/24

up/up

N/A

N/A

lo

 

127.0.0.1/16

up/up

N/A

N/A

Remove IPv4 Address

Follow the steps below to remove the IPv4 address from an interface.

Step

Command

Description

1

config interface ip remove <interface_name> <ip_addr>

Configure interface IP.

  • interface_name may be any of the following: Ethernet0–Ethernet53.

  • ip_addr: A valid IPv4 address.

2

show interface status

Display the interface configuration.

3

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

The example below shows the commands used to remove the IPv4 address from an interface.

admin@sonic:~$ sudo config interface ip remove Ethernet1 192.168.12.13/24

admin@sonic:~$ show ip interfaces

Interface

Master

IPv4 address/mask

Admin/Oper

BGP Neighbor

Neighbor IP

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet0

 

10.0.0.0/31

up/up

BGPNeigh01

10.0.0.1

Ethernet1

 

10.0.0.2/31

up/up

BGPNeigh02

10.0.0.3

Ethernet2

 

10.0.0.4/31

up/up

BGPNeigh03

10.0.0.5

Ethernet3

 

10.0.0.6/31

up/up

BGPNeigh04

10.0.0.7

192.168.80.13/24

 

N/A

N/A

 

 

Ethernet4

 

10.0.0.8/31

up/up

BGPNeigh05

10.0.0.9

Ethernet5

 

10.0.0.10/31

up/down

BGPNeigh06

10.0.0.11

Configure IPv6 Address

Follow the steps below to configure the IPv6 address for an interface.

Step

Command

Description

1

config interface ip add <interface_name> <ip_addr> <default gateway IP address>

Configure interface IP.

  • interface_name may be any of the following: Ethernet0–Ethernet53.

  • ip_addr: A valid IPv6 address.

  • gateway IP address: A valid IPv6 address. The gateway IP address is optional.

2

show ipv6 interface

Display the interface IPv6 addresses.

3

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

The example below shows the commands used to configure the IP address for the interface.

admin@sonic:~$ sudo config interface ip add Ethernet0 2::2/64

admin@sonic:~$ show ipv6 interfaces

Note: Truncated output is added here.

Interface

Master

IPv4 address/mask

Admin/Oper

BGP Neighbor

Neighbor IP

- - -

- - -

- - -

- - -

- - -

- - -

Bridge

 

fe80::886e:d3ff:fe7c:5551%Bridge/64

up/down

N/A

N/A

Ethernet0

 

2::2/64

up/up

N/A

N/A

 

 

fe80::ec4:7aff:fe2e:17bd%Ethernet0/64

N/A

N/A

N/A

Ethernet1

 

fe80::ec4:7aff:fe2e:17bd%Ethernet1/64

up/up

N/A

N/A

Ethernet2

 

fe80::ec4:7aff:fe2e:17bd%Ethernet2/64

up/up

N/A

N/A

Ethernet3

 

fe80::ec4:7aff:fe2e:17bd%Ethernet3/64

up/up

N/A

N/A

Ethernet4

 

fe80::ec4:7aff:fe2e:17bd%Ethernet4/64

up/up

N/A

N/A

Ethernet5

 

fe80::ec4:7aff:fe2e:17bd%Ethernet5/64

up/up

N/A

N/A

The example below shows connecting to the switch using the IPv6 address.

root@Ubuntu-20:/home/G3748/build# ssh -6 admin@2::2%ens18

The authenticity of host 2::2%ens18 (2::2%ens18)' can't be established.

ECDSA key fingerprint is SHA256:CsAp9CFqVpli4lLz4Liexf1AzzXiUs4HZZuLpfXqJzU.

Are you sure you want to continue connecting (yes/no/[fingerprint])? yes

Warning: Permanently added 2::2%ens18' (ECDSA) to the list of known hosts.

admin@2::2%ens18's password:

Linux sonic 4.19.0-12-2-arm64 #1 SMP Debian 4.19.152-1 (2020-10-18) aarch64

You are on

SONiC

-- Software for Open Networking in the Cloud --

 

Unauthorized access and/or use are prohibited.

All access and/or use are subject to monitoring.

 

Help: http://azure.github.io/SONiC/

 

Last login: Fri Mar 24 05:53:23 2023 from 10.13.65.43

admin@sonic:~$

Remove IPv6 Address

Follow the steps below to remove the IPv6 address from an interface.

Step

Command

Description

1

config interface ip add <interface_name> <ip_addr> <default gateway IP address>

Configure interface IP.

  • interface_name may be any of the following: Ethernet0–Ethernet53.

  • ip_addr: A valid IPv6 address.

  • gateway IP address: A valid IPv6 address.

2

show ipv6 interface

Display the interface IPv6 addresses.

3

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

The example below shows the commands used to remove the IPv6 address from an interface.

admin@sonic:~$ sudo config interface ip remove Ethernet0 2::2/64

admin@sonic:~$ show ipv6 interfaces

Note: Truncated output is added here.

Interface

Master

IPv4 address/mask

Admin/Oper

BGP Neighbor

Neighbor IP

- - -

- - -

- - -

- - -

- - -

- - -

Bridge

 

fe80::886e:d3ff:fe7c:5551%Bridge/64

up/down

N/A

N/A

Ethernet0

 

fe80::ec4:7aff:fe2e:17bd%Ethernet0/64

up/up

N/A

N/A

Ethernet1

 

fe80::ec4:7aff:fe2e:17bd%Ethernet1/64

up/up

N/A

N/A

Ethernet2

 

fe80::ec4:7aff:fe2e:17bd%Ethernet2/64

up/up

N/A

N/A

Ethernet3

 

fe80::ec4:7aff:fe2e:17bd%Ethernet3/64

up/up

N/A

N/A

Ethernet4

 

fe80::ec4:7aff:fe2e:17bd%Ethernet4/64

up/up

N/A

N/A

Ethernet5

 

fe80::ec4:7aff:fe2e:17bd%Ethernet5/64

up/up

N/A

N/A

Configure IPv6 Address for Management Interface

Follow the steps below to configure the IPv6 address for the management interface.

Step

Command

Description

1

config interface ip add <interface_name> <ip_addr> <default gateway IP address>

Configure interface IPv6.

  • interface_name may be any of the following: Ethernet0–Ethernet53.

  • ip_addr: A valid IPv6 address.

  • gateway IP address: A valid IPv6 address.

2

show ipv6 interfaces

Display the IPv6 address of all interfaces.

3

show management_interface address

Display the management interface IP configuration.

4

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

The example below shows the commands used to configure management interface IPv6.

Switch A:

admin@sonic:~$ sudo config interface ip add eth0 2001::1/64

[ 5730.458254] mvneta 7f020000.ethernet eth0: Link is Down

[ 5734.212789] mvneta 7f020000.ethernet eth0: PHY [7f022004.mdio-mii:00] driver [Marvell 88E1510]

[ 5734.221825] mvneta 7f020000.ethernet eth0: configuring for phy/sgmii link mode

[ 5734.229268] mvneta 7f020000.ethernet eth0: Link is Up - 1Gbps/Full - flow control off

[ 5734.232555] IPv6: ADDRCONF(NETDEV_UP): eth0: link is not ready

[ 5734.243201] IPv6: ADDRCONF(NETDEV_CHANGE): eth0: link becomes ready

[ 5735.334464] mvneta 7f020000.ethernet eth0: Link is Down

[ 5738.403390] mvneta 7f020000.ethernet eth0: Link is Up - 1Gbps/Full - flow control off

admin@sonic:~$

admin@sonic:~$ show management_interface address

Management IP address = 2001::1/64

admin@sonic:~$

admin@sonic:~$ show ipv6 interfaces

Note: Truncated output is added here.

Interface

Master

IPv4 address/mask

Admin/Oper

BGP Neighbor

Neighbor IP

- - -

- - -

- - -

- - -

- - -

- - -

eth0

 

2001::1/64

up/up

N/A

N/A

 

 

fe80::ec4:7aff:fe2e:1635%eth0/64

 

N/A

N/A

lo

 

::1/128

up/up

N/A

N/A

admin@sonic:~$

Switch B:

admin@sonic:~$ sudo config interface ip add eth0 2001::2/64

[ 5739.430346] mvneta 7f020000.ethernet eth0: Link is Down

[ 5744.164528] mvneta 7f020000.ethernet eth0: PHY [7f022004.mdio-mii:00] driver [Marvell 88E1510]

[ 5744.173756] mvneta 7f020000.ethernet eth0: configuring for phy/sgmii link mode

[ 5744.182417] mvneta 7f020000.ethernet eth0: Link is Up - 1Gbps/Full - flow control off

[ 5744.197762] IPv6: ADDRCONF(NETDEV_UP): eth0: link is not ready

[ 5744.204056] IPv6: ADDRCONF(NETDEV_CHANGE): eth0: link becomes ready

[ 5745.286659] mvneta 7f020000.ethernet eth0: Link is Down

[ 5748.355337] mvneta 7f020000.ethernet eth0: Link is Up - 1Gbps/Full - flow control off

admin@sonic:~$

admin@sonic:~$ show management_interface address

Management IP address = 2001::2/64

admin@sonic:~$

admin@sonic:~$ show ipv6 interfaces

Note: Truncated output is added here.

Interface

Master

IPv4 address/mask

Admin/Oper

BGP Neighbor

Neighbor IP

- - -

- - -

- - -

- - -

- - -

- - -

eth0

 

2001::2/64

up/up

N/A

N/A

 

 

fe80::ec4:7aff:fe2e:6769%eth0/64

 

N/A

N/A

lo

 

::1/128

up/up

N/A

N/A

admin@sonic:~$

Test the connectivity between the switches over IPv6.

Switch A:

admin@sonic:~$ ping 2001::2

PING 2001::2(2001::2) 56 data bytes

64 bytes from 2001::2: icmp_seq=1 ttl=64 time=0.648 ms

64 bytes from 2001::2: icmp_seq=2 ttl=64 time=0.658 ms

^C

--- 2001::2 ping statistics ---

3 packets transmitted, 3 received, 0% packet loss, time 57ms

rtt min/avg/max/mdev = 0.626/0.644/0.658/0.013 ms

admin@sonic:~$

Switch B:

admin@sonic:~$ ping 2001::1

PING 2001::1(2001::1) 56 data bytes

64 bytes from 2001::1: icmp_seq=6 ttl=64 time=0.658 ms

64 bytes from 2001::1: icmp_seq=7 ttl=64 time=0.632 ms

^C

--- 2001::1 ping statistics ---

10 packets transmitted, 5 received, 50% packet loss, time 217ms

rtt min/avg/max/mdev = 0.632/0.641/0.658/0.033 ms

admin@sonic:~$

Remove Management Interface IPv6

Follow the steps below to remove management interface IPv6.

Step

Command

Description

1

config interface ip remove <interface_name> <ip_addr>

Remove interface IPv6.

  • interface_name may be any of the following: Ethernet0–Ethernet53.

  • ip_addr: A valid IPv6 address.

2

show ipv6 interfaces

Display the IPv6 address of all interfaces.

3

show management_interface address

Display the management interface IP configuration.

4

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

The example below shows the commands used to remove management interface IPv6.

Switch A:

admin@sonic:~$ sudo config interface ip remove eth0 2001::1/64

[ 7425.080933] mvneta 7f020000.ethernet eth0: Link is Down

[ 7428.759705] mvneta 7f020000.ethernet eth0: PHY [7f022004.mdio-mii:00] driver [Marvell 88E1510]

[ 7428.772979] mvneta 7f020000.ethernet eth0: configuring for phy/sgmii link mode

[ 7428.780403] mvneta 7f020000.ethernet eth0: Link is Up - 1Gbps/Full - flow control off

[ 7428.792580] IPv6: ADDRCONF(NETDEV_UP): eth0: link is not ready

[ 7428.799610] IPv6: ADDRCONF(NETDEV_CHANGE): eth0: link becomes ready

[ 7429.894484] mvneta 7f020000.ethernet eth0: Link is Down

[ 7432.963349] mvneta 7f020000.ethernet eth0: Link is Up - 1Gbps/Full - flow control off

admin@sonic:~$

admin@sonic:~$ show management_interface address

admin@sonic:~$

admin@sonic:~$ show ipv6 interfaces

Note: Truncated output is added here.

Interface

Master

IPv4 address/mask

Admin/Oper

BGP Neighbor

Neighbor IP

- - -

- - -

- - -

- - -

- - -

- - -

eth0

 

fe80::ec4:7aff:fe2e:1635%eth0/64

up/up

N/A

N/A

lo

 

::1/128

up/up

N/A

N/A

admin@sonic:~$

Switch B:

admin@sonic:~$ sudo config interface ip remove eth0 2001::2/64

[ 7415.502728] mvneta 7f020000.ethernet eth0: Link is Down

[ 7419.027702] mvneta 7f020000.ethernet eth0: PHY [7f022004.mdio-mii:00] driver [Marvell 88E1510]

[ 7419.036918] mvneta 7f020000.ethernet eth0: configuring for phy/sgmii link mode

[ 7419.044560] mvneta 7f020000.ethernet eth0: Link is Up - 1Gbps/Full - flow control off

[ 7419.056490] IPv6: ADDRCONF(NETDEV_UP): eth0: link is not ready

[ 7419.062493] IPv6: ADDRCONF(NETDEV_CHANGE): eth0: link becomes ready

[ 7420.138419] mvneta 7f020000.ethernet eth0: Link is Down

[ 7423.203414] mvneta 7f020000.ethernet eth0: Link is Up - 1Gbps/Full - flow control off

admin@sonic:~$ show management_interface address

admin@sonic:~$

admin@sonic:~$ show ipv6 interfaces

Note: Truncated output is added here.

Interface

Master

IPv4 address/mask

Admin/Oper

BGP Neighbor

Neighbor IP

- - -

- - -

- - -

- - -

- - -

- - -

eth0

 

fe80::ec4:7aff:fe2e:6769%eth0/64

up/up

N/A

N/A

lo

 

::1/128

up/up

N/A

N/A

admin@sonic:~$

Enable IPv6 Link Local

Follow the steps below to enable interface IPv6.

Step

Command

Description

1

config interface ipv6 enable use-link-local-only <interface_name>

Enable interface IPv6.

  • interface_name may be any of the following: Ethernet0–Ethernet53.

2

show ipv6 link-local-mode

Display IPv6 link-local-mode.

3

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

The example below shows the commands used to enable interface IPv6.

admin@sonic:~$ sudo config interface ipv6 enable use-link-local-only Ethernet5

admin@sonic:~$ sudo config interface ipv6 enable use-link-local-only PortChannel0033

admin@sonic:~$ show ipv6 link-local-mode

Note: Truncated output is added here.
- - - - - -

 

Interface Name

Mode

 

___

___

 
- - - - - -

 

Ethernet5

Enabled

 
- - - - - -

 

Ethernet50

Disabled

 
- - - - - -

 

Ethernet51

Disabled

 
- - - - - -

 

Ethernet52

Disabled

 
- - - - - -

 

Ethernet53

Disabled

 
- - - - - -

 

Ethernet6

Disabled

 
- - - - - -

 

Ethernet7

Disabled

 
- - - - - -

 

Ethernet8

Disabled

 
- - - - - -

 

Ethernet9

Disabled

 
- - - - - -

 

PortChannel0033

Enabled

 
- - - - - -

 

Disable IPv6 Link Local

Follow the steps below to disable interface IPv6.

Step

Command

Description

1

config interface ipv6 disable use-link-local-only <interface_name>

Disable interface IPv6.

  • interface_name may be any of the following: Ethernet0–Ethernet53.

2

show ipv6 link-local-mode

Display IPv6 link-local-mode.

3

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

The example below shows the commands used to disable interface IPv6.

admin@sonic:~$ sudo config interface ipv6 disable use-link-local-only Ethernet5

admin@sonic:~$ sudo config interface ipv6 disable use-link-local-only PortChannel0033

admin@sonic:~$ show ipv6 link-local-mode

Note: Truncated output is added here.
- - - - - -

 

Interface Name

Mode

 

___

___

 
- - - - - -

 

Ethernet5

Disabled

 
- - - - - -

 

Ethernet50

Disabled

 
- - - - - -

 

Ethernet51

Disabled

 
- - - - - -

 

Ethernet52

Disabled

 
- - - - - -

 

Ethernet53

Disabled

 
- - - - - -

 

Ethernet6

Disabled

 
- - - - - -

 

Ethernet7

Disabled

 
- - - - - -

 

Ethernet8

Disabled

 
- - - - - -

 

Ethernet9

Disabled

 
- - - - - -

 

PortChannel0033

Disabled

 
- - - - - -

 

admin@sonic:~$

 

 

MAC

Follow the steps below to configure and display the MAC Address for the Layer 2 interface.

Step

Command

Description

1

config interface ip remove vlan <vlan_id> <ip_addr>

Remove an IP address for a VLAN.

  • vlan_id: Any VLAN number.

  • ip_addr: A valid IP address.

2

config vlan add <vid>

Create a VLAN.

  • vid: Any VLAN number 1–4094.

3

config vlan member add [-u | --untagged] <vlan_id> <member_portname>

Add an untagged member port in the already-created VLAN by using the option -u or --untagged.

  • vlan_id: Any VLAN number.

  • member_portname: Any interface name which is not a router interface.

4

show vlan brief

Display all bridge information.

5

show mac [OPTIONS]

Display MAC Address information. The following options are available:

  • -v, --vlan TEXT: VLAN ID.

  • -p, --port TEXT may be any of the following: Ethernet0–Ethernet53.

The example below shows the commands used to configure and display the MAC Address.

admin@sonic:~$ sudo config interface ip remove Ethernet0 10.0.0.0/31

admin@sonic:~$ sudo config vlan add 100

[ 208.767912] 8021q: 802.1Q VLAN Support v1.8

[ 208.784425] IPv6: ADDRCONF(NETDEV_UP): Vlan100: link is not ready

admin@sonic:~$ sudo config vlan member add -u 100 Ethernet0

[ 217.979642] Bridge: port 2(Ethernet0) entered blocking state

[ 217.985458] Bridge: port 2(Ethernet0) entered disabled state

[ 217.993949] device Ethernet0 entered promiscuous mode

[ 218.001930] Bridge: port 2(Ethernet0) entered blocking state

[ 218.007734] Bridge: port 2(Ethernet0) entered forwarding state

[ 218.015778] IPv6: ADDRCONF(NETDEV_CHANGE): Vlan100: link becomes ready

admin@sonic:~$

admin@sonic:~$ show vlan brief
- - - - - - - - - - - - - - - - - -

VLAN ID

IP Address

Ports

Port Tagging

Proxy ARP

DHCP Helper Address

___

___

___

___

___

___

100

 

Ethernet0

untagged

disabled

 
- - - - - - - - - - - - - - - - - -

admin@sonic:~$ show mac

No.

Vlan

MacAddress

Port

Type

 
- - - - - - - - - - - - - - -

 

1

100

0C:C4:7A:2E:67:69

Ethernet0

Dynamic

 

Total number of entries 1

admin@sonic:~$

admin@sonic:/$ show mac -v 100

No.

Vlan

MacAddress

Port

Type

 

- - -

- - -

- - -

- - -

- - -

 

1

100

0C:C4:7A:2E:67:69

Ethernet0

Dynamic

 

Total number of entries 1

admin@sonic:~$

admin@sonic:/$ show mac -p Ethernet0

No.

Vlan

MacAddress

Port

Type

 

- - -

- - -

- - -

- - -

- - -

 

1

100

0C:C4:7A:2E:67:69

Ethernet0

Dynamic

 

Total number of entries 1

admin@sonic:~$

Type

Follow the steps below to configure the interface type.

Step

Command

Description

1

config interface type <interface_name> <interface_type_value>

Configure interface type.

  • interface_name may be any of the following: Ethernet0–Ethernet53.

  • interface_type_value: Valid interface types are none, KR, KR4, GMII, XGMII, CR2, SR, CAUI, KR2, SR2, XAUI, XLAUI, SR4, SFI, LR4, XFI, CR4, CR, CAUI4, and LR.

2

show interface status

Display the interface configuration.

3

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

The example below shows the commands used to configure interface type.

admin@sonic:~$ sudo config interface type Ethernet4 CR4

admin@sonic:~$ show interfaces autoneg status Ethernet4

Interface

Auto-Neg Mode

Speed

Adv Speeds

Type

Adv Types

Oper

Admin

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet4

disabled

1G

N/A

CR4

N/A

down

up

admin@sonic:~$

Note: The interface type is configured correctly by default. It is not recommended to change this default type setting. This command will accept only the supported interface types for the given platform and port; the supported values will vary based on the platform and port.

Alias

Follow the step below to display the interface alias.

Step

Command

Description

1

show interfaces alias [interface_name]

Disable the interface alias configuration.

  • interface_name may be any of the following: Ethernet0–Ethernet53.

The example below shows the commands used to display interface alias.

admin@sonic:~$ show interfaces alias

Note: Truncated output is added here.

Name

Alias

 

- - -

- - -

 

Ethernet0

Gi0/1

 

Ethernet1

Gi0/2

 

Ethernet2

Gi0/3

 

Ethernet3

Gi0/4

 

Ethernet4

Gi0/5

 

Configure Interface Naming Mode

Follow the steps below to configure interface naming mode.

Step

Command

Description

1

config interface_naming_mode [default | alias]

Configure interface naming mode.

  • default: The default interface name.

  • alias: An alias interface name.

2

show interfaces naming_mode

Display the interface naming configuration.

3

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

The example below shows the commands used to configure interface naming mode.

admin@sonic:~$ sudo config interface_naming_mode alias

Please log out and log back in for changes to take effect.

admin@sonic:~$ show interfaces naming_mode

alias

admin@sonic:~$

admin@sonic:~$ sudo config interface_naming_mode default

Please log out and log back in for changes to take effect.

admin@sonic:~$ show interfaces naming_mode

default

admin@sonic:~$

Counters

Follow the step below to display interface counters.

Step

Command

Description

1

show interfaces counters [OPTIONS]

Display interface counters. The following options are available:

  • -a, --printall

  • -p, --period: Text.

  • -i, --interface: Text.

  • -d, --display [all]: Show internal interfaces (default: all).

  • -n, --namespace []: Namespace name or all.

The example below shows the commands used to display interface counters.

admin@sonic:~$ show interfaces counters

Note: Truncated output is added here.

IFACE

STATE

RX_OK

RX_BPS

RX_UTIL

RX_ERR

RX_DRP

RX_OVR

TX_OK

TX_BPS

TX_UTIL

TX_ERR

TX_DRP

TX_OVR

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet0

D

0

0.00 B/s

0.00%

0

0

0

0

0.00 B/s

0.00%

0

0

0

Ethernet1

D

0

0.00 B/s

0.00%

0

0

0

0

0.00 B/s

0.00%

0

0

0

Ethernet2

D

0

0.00 B/s

0.00%

0

0

0

0

0.00 B/s

0.00%

0

0

0

Counters Detailed

Follow the step below to display detailed interface counters.

Step

Command

Description

1

show interfaces counters detailed [OPTIONS] <interface_name>

Display the interface counters in detail.

  • interface_name may be any of the following: Ethernet0–Ethernet53.

  • The -p and --period (text) options are available to display statistics over a specified period in seconds.

The example below shows the commands used to display interface counters in detail.

admin@sonic:~$ show interfaces counters detailed Ethernet3

Note: Truncated output is added here.

Packets Received 64 Octets..................... 0

Packets Received 65-127 Octets................. 0

Packets Received 128-255 Octets................ 0

Packets Received 256-511 Octets................ 0

Packets Received 512-1023 Octets............... 0

Packets Received 1024-1518 Octets.............. 0

Packets Received 1519-2047 Octets.............. N/A

Packets Received 2048-4095 Octets.............. N/A

Packets Received 4096-9216 Octets.............. 0

Packets Received 9217-16383 Octets............. 0

 

Total Packets Received Without Errors.......... 0

Unicast Packets Received....................... 0

Counters Errors

Follow the step below to display errors for interface counters.

Step

Command

Description

1

show interfaces counters errors [OPTIONS]

Display errors for interface counters. The following options are available:

  • -p, --period: Text.

  • -d, --display [all]: Show internal interfaces (default: all).

  • -n, --namespace []: Namespace name or all.

The example below shows the commands used to display errors for interface counters.

admin@sonic:~$ show interfaces counters

Note: Truncated output is added here.

IFACE

STATE

RX_ERR

RX_DRP

RX_OVR

TX_ERR

TX_DRP

TX_OVR

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet0

D

0

0

0

0

0

0

Ethernet1

D

0

0

0

0

0

0

Counters Rates

Follow the step below to display rates for interface counters.

Step

Command

Description

1

show interfaces counters rates [OPTIONS]

Display rates for interface counters. The following options are available:

  • -p, --period: Text.

  • -d, --display [all]: Show internal interfaces (default: all).

  • -n, --namespace []: Namespace name or all.

The example below shows the commands used to display rates for interface counters.

admin@sonic:~$ show interfaces counters

Note: Truncated output is added here.

IFACE

STATE

RX_OK

RX_BPS

RX_PPS

RX_UTIL

TX_OK

TX_BPS

TX_PPS

TX_UTIL

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet0

D

0

0.00 B/s

0.00/s

0.00%

0

0.00 B/s

0.00/s

0.00%

Ethernet1

D

0

0.00 B/s

0.00/s

0.00%

0

0.00 B/s

0.00/s

0.00%

Counters Rif

Follow the step below to verify interface counters.

Step

Command

Description

1

show interfaces counters rif [OPTIONS] <interface_name>

Display the verification (rif) values for interface counters. The following options are available:

  • interface_name may be any of the following: Ethernet0–Ethernet53.

  • The -p and --period (text) options are available to display statistics over a specified period in seconds.

The example below shows the commands used to verify interface counters.

admin@sonic:~$ show interfaces counters rif Ethernet4

Ethernet4

- - -

- - -

- - -

 

RX:

 

 

 

0 packets

 

 

0 bytes

 

 

0 error packets

 

 

0 error bytes

 

TX:

 

 

 

0 packets

 

 

0 bytes

 

 

0 error packets

 

 

0 error bytes

admin@sonic:~$

Configure Loopback

Follow the steps below to configure loopback.

Step

Command

Description

1

config loopback add <loopback_name>

Create a loopback interface.

  • loopback_name: A valid string with the prefix “loopback” and a suffix range of 0–999.

2

config interface ip add <interface_name> <ip_addr> <default gateway IP address>

Configure interface IP.

  • interface_name may be any of the following: Ethernet0–Ethernet53.

  • ip_addr: A valid IPv4 address.

  • gateway IP address: A valid IPv4 address.

3

show ip interfaces

Display the interface configuration.

4

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

The example below shows the commands used to create a loopback interface.

admin@sonic:~$ sudo config loopback add Loopback11

admin@sonic:~$ sudo config interface ip add Loopback11 10.1.0.2/32

admin@sonic:~$ show ip interfaces

Interface

Master

IPv4 address/mask

Admin/Oper

BGP Neighbor

Neighbor IP

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet52

 

10.0.0.104/31

up/up

ARISTA26T0

10.0.0.105

Ethernet53

 

10.0.0.106/31

up/up

ARISTA27T0

10.0.0.107

Loopback0

 

10.1.0.1/32

up/up

N/A

N/A

Loopback11

 

10.1.0.2/32

up/up

N/A

N/A

docker0

 

240.127.1.1/24

up/down

N/A

N/A

eth0

 

192.168.86.34/24

up/up

N/A

N/A

lo

 

127.0.0.1/16

up/up

N/A

N/A

admin@sonic:~$

Remove Loopback

Follow the steps below to remove loopback.

Step

Command

Description

1

config loopback del <loopback_name>

Remove the loopback interface.

  • loopback_name: A valid string with the prefix “loopback” and a suffix range of 0–999.

2

show ip interfaces

Display the interface configuration.

3

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

The example below shows the commands used to remove the loopback interface.

admin@sonic:~$ sudo config loopback del Loopback11

admin@sonic:~$ show ip interfaces

Interface

Master

IPv4 address/mask

Admin/Oper

BGP Neighbor

Neighbor IP

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet52

 

10.0.0.104/31

up/up

ARISTA26T0

10.0.0.105

Ethernet53

 

10.0.0.106/31

up/up

ARISTA27T0

10.0.0.107

Loopback0

 

10.1.0.1/32

up/up

N/A

N/A

docker0

 

240.127.1.1/24

up/down

N/A

N/A

eth0

 

192.168.86.34/24

up/up

N/A

N/A

lo

 

127.0.0.1/16

up/up

N/A

N/A

admin@sonic:~$

Storm Control

Storm control prevents traffic on a LAN from being disrupted by a broadcast, multicast, or unicast storm on one of the physical interfaces. A LAN storm occurs when packets flood the LAN due to errors or mistakes in network configurations, etc. LAN storms degrade network performance.

Storm control monitors packets passing from an interface to the switching bus and determines if the packet is unicast, multicast, or broadcast. The switch counts the number of packets of a specified type received within the one-second time interval and compares the measurement with a predefined suppression-level threshold. The port blocks traffic when the rising threshold is reached and remains blocked until the traffic rate drops below the falling threshold before resuming normal forwarding.

Follow the steps below to configure storm control.

Step

Command

Description

1

config interface storm-control add [OPTIONS] <port_name> <storm_type> <kbps_value>

Configure storm control for broadcast or unknown-multicast or unknown-unicast packets.

2

config interface storm-control del [OPTIONS] <port_name> <storm_type>

Delete storm control for broadcast or unknown-multicast or unknown-unicast packets.

3

show storm-control

Display the storm control configuration.

4

sudo config save –y

Optional: Save the current configuration to be part of the startup configuration.

The example below shows the commands used to configure storm control.

admin@sonic:~$ sudo config interface storm-control add Ethernet10 broadcast 200000

admin@sonic:~$ sudo config interface storm-control add Ethernet20 unknown-multicast 100000

admin@sonic:~$ sudo config interface storm-control add Ethernet20 unknown-unicast 10000

admin@sonic:~$ show storm-control
- - - - - - - - -

 

Interface Name

Storm Type

Rate (kbps)

 

___

___

___

 

- - -

- - -

- - -

 

Ethernet10

broadcast

200000

 
- - - - - - - - -

 

Ethernet20

unknown-multicast

100000

 
- - - - - - - - -

 

Ethernet20

unknown-unicast

10000

 
- - - - - - - - -

 

The example below shows the commands used to delete storm control configuration.

admin@sonic:~$ sudo sudo config interface storm-control del Ethernet10 broadcast

admin@sonic:~$ show storm-control
- - - - - - - - -

 

Interface Name

Storm Type

Rate (kbps)

 

___

___

___

 

- - -

- - -

- - -

 

Ethernet20

unknown-multicast

100000

 
- - - - - - - - -

 

Ethernet20

unknown-unicast

10000

 
- - - - - - - - -  

Port Splitting/HWSKU in SSE-T7132

Each QSFP-DD connector has eight SerDes lanes and can have eight logical ports at maximum. The maximum logical port count is 168, including the two SFP+ ports per switch. Each SerDes lane can support 56 Gbps PAM4 or 28 Gbps NRZ. With combinations of different speed and lane numbers, the switch can have many physical interface configurations. The port configurations are hard-coded in the profiles and only loaded at the boot. Therefore, it is necessary to reboot the switch for a new interface configuration after any change. The switch does not support the dynamic port breakout and warm boot features due to chipset limitations.

There are predefined profiles for HWSKUs in the switch image as shown in the following table.

SKU Name

Interfaces Speed/Type

Comment

Supermicro_sse_t7132s

32 x 400G Ethernet interfaces

This is the default HWSKU.

Supermicro_sse_t7132s_128x100

128 x 100G (PAM4) Ethernet interfaces

 

Supermicro_sse_t7132s_32x100

32 100G (NRZ) Ethernet interfaces

One port per QSFP-DD connector. QSFP28 DACs or transceivers can be used.

Supermicro_sse_t7132s_64x100

64 x 100G (NRZ) Ethernet interfaces

Two ports per QSFP-DD connector.

Supermicro_sse_t7132s_64x200

64 x 200G Ethernet interfaces

Two ports per QSFP-DD connector.

Supermicro_sse_t7132s_16x400_64x100

64 x 100G (PAM4) and 16 x 400G Ethernet interfaces

The first 16 QSFP-DD connectors will be split into four ports and operate at 100G (PAM4) and the last 16 QSFP-DD will operate at 400G speed.

Users can change the switch HWSKU using the sonic-cfggen tool. For example, to configure the switch to boot with the Supermicro_sse_t7132s_32x100 HWKSU, follow the steps given below.

  1. Remove the current configuration.

    admin@sonic:~$ sudo rm /etc/sonic/config_db.json

  2. Change the default SKU.

    admin@sonic:~$ sudo -i

    root@sonic:~# sudo echo “Supermicro_sse_t7132s_32x100 t1” >

    /usr/share/sonic/device/x86_64-supermicro_sse_t7132s-r0/default_sku

  3. Reboot the switch to initialize it with new SKU profiles.

    admin@sonic:~$sudo reboot

If there is no suitable predefined HWSKU for your applications, contact Supermicro Support to get the suitable configuration.

There are configuration files under each HWSKU folder to set the interface properties. The following files are for the default 400G SKU.

admin@sonic:/usr/share/sonic/device/x86_64-supermicro_sse_t7132s-r0/Supermicro_sse_t7132s$ ls

buffers_defaults_def_lossy.j2

ivm.sai.datapath.config.yaml

 

buffers_defaults_t1.j2

pg_profile_lookup.ini

 

buffers.json.j2

port_config.ini

 

config_32x400G_sse_t7132s.yaml

qos_defaults_def_lossy.j2

 

innovium.77700_A

qos_defaults_t1.j2

 

innovium.77700_B

qos.json.j2

 

ivm.sai.config.yaml

sai.profile

 

The interface properties such as speed, FEC, and auto-negotiation are configured in the config_xxx_sse_t7132s.yaml file, where xxx represents the interface number or HWSKU.

The devport ID is used to identify the switch physical SerDes lane in the configuration file. The first devport with eth type in the file maps to SONiC Ethernet0, and the second devport with the eth type in the file maps to SONiC EthernetX, in which the number of SerDes lanes used by Ethernet0 determines the value of X. For example, Ethernet0 is a 400G interface, and then the next interface in SONiC is Ethernet8. The corresponding lane numbers are shown in show interface status.

The following is a portion of the default 400G SKU configuration file, config_32x400G_sse_t7132s.yaml, regarding the interface properties.

devports

-

id: “0”

◄Devport ID

 

sysport: “1000”

◄System-port associated with this devport

 

type: “cpu”

◄Devport type: to CPU

-

fec: “KPFEC”

◄FEC type for devport 241

 

id: “241”

◄Devport ID

 

lanes: “0:8”

◄SerDes lanes associated with this devport

 

serdes_group: “30”

◄Innovium SerDes group associated with this devport

 

speed: “400G”

◄Speed

 

sysport: “241”

◄System-port associated with this devport

 

type: “eth”

◄Devport type

-

fec: “KPFEC”

 

 

id: "249"

 

 

lanes: “0:8”

 

 

serdes_group: “31”

 

 

speed: “400G”

 

 

sysport: “249”

 

 

type: “eth”

 

-

fec: “KPFEC”

 

 

id: “225”

 

 

lanes: “0:8”

 

 

serdes_group: “28”

 

 

speed: “400G”

 

 

sysport: “225”

 

 

type: “eth”

 

To check the interface status, use the command show interface status.

admin@sonic:~$ show interface status

Interface

Lanes

Speed

MTU

FEC

Alias

Vlan

Oper

Admin

Type

Asym PFC

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

- - -

Ethernet0

241, 242, 243, 244, 245, 246, 247, 248

400G

9100

rs

Eth1

routed

down

up

N/A

N/A

Ethernet8

249, 250, 251, 252, 253, 254, 255, 256

400G

9100

rs

Eth2

routed

down

up

N/A

N/A

Ethernet16

225, 226, 227, 228, 229, 230, 231, 232

400G

9100

rs

Eth3

routed

down

up

N/A

N/A

Ethernet24

233, 234, 235, 236, 237, 238, 239, 240

400G

9100

rs

Eth4

routed

down

up

N/A

N/A

Ethernet0 includes SerDes lanes from 241 to 248, which maps to devport ID 241. Ethernet8 includes SerDes lanes from 249 to 256, which maps to devport ID 249.

Ethernet16 includes SerDes lanes from 225 to 232, which maps to devport ID 225.

Port_config.ini is a configuration file that includes the interface name, SerDes lanes, alias, speed, index, MTU, and FEC. Its content should be consistent with the SKU configuration file. The example below is a port_config.ini for the 400G SKU.

admin@sonic:~$

cat

/usr/share/sonic/device/x86_64-supermicro_sse_t7132s-r0/Supermicro_sse_t7132s/port_config.ini

# name

lanes

alias

speed

index

mtu

fec

Ethernet0

241, 242, 243, 244, 245, 246, 247, 248

Eth1

400000

0

9126

rs

Ethernet8

249, 250, 251, 252, 253, 254, 255, 256

Eth2

400000

1

9126

rs

Ethernet16

225, 226, 227, 228, 229, 230, 231, 232

Eth3

400000

2

9126

rs

Ethernet24

233, 234, 235, 236, 237, 238, 239, 240

Eth4

400000

3

9126

rs

Ethernet32

217, 218, 219, 220, 221, 222, 223, 224

Eth5

400000

4

9126

rs

Ethernet40

209, 210, 211, 212, 213, 214, 215, 216

Eth6

400000

5

9126

rs

Ethernet48

201, 202, 203, 204, 205, 206, 207, 208

Eth7

400000

6

9126

rs

Ethernet56

193, 194, 195, 196, 197, 198, 199, 200

Eth8

400000

7

9126

rs

Ethernet64

185, 186, 187, 188, 189, 190, 191, 192

Eth9

400000

8

9126

rs

Ethernet72

177, 178, 179, 180, 181, 182, 183, 184

Eth10

400000

9

9126

rs

Ethernet80

169, 170, 171, 172, 173, 174, 175, 176

Eth11

400000

10

9126

rs

Ethernet88

161, 162, 163, 164, 165, 166, 167, 168

Eth12

400000

11

9126

rs

Ethernet96

153, 154, 155, 156, 157, 158, 159, 160

Eth13

400000

12

9126

rs

Ethernet104

145, 146, 147, 148, 149, 150, 151, 152

Eth14

400000

13

9126

rs

Ethernet112

137, 138, 139, 140, 141, 142, 143, 144

Eth15

400000

14

9126

rs

Ethernet120

129, 130, 131, 132, 133, 134, 135, 136

Eth16

400000

15

9126

rs

Ethernet128

121, 122, 123, 124, 125, 126, 127, 128

Eth17

400000

16

9126

rs

Ethernet136

113, 114, 115, 116, 117, 118, 119, 120

Eth18

400000

17

9126

rs

Ethernet144

105, 106, 107, 108, 109, 110, 111, 112

Eth19

400000

18

9126

rs

Ethernet152

97, 98, 99, 100, 101, 102, 103, 104

Eth20

400000

19

9126

rs

Ethernet160

89, 90, 91, 92, 93, 94, 95, 96

Eth21

400000

20

9126

rs

Ethernet168

81, 82, 83, 84, 85, 86, 87, 88

Eth22

400000

21

9126

rs

Ethernet176

73, 74, 75, 76, 77, 78, 79, 80

Eth23

400000

22

9126

rs

Ethernet184

65, 66, 67, 68, 69, 70, 71, 72

Eth24

400000

23

9126

rs

Ethernet192

57, 58, 59, 60, 61, 62, 63, 64

Eth25

400000

24

9126

rs

Ethernet200

49, 50, 51, 52, 53, 54, 55, 56

Eth26

400000

25

9126

rs

Ethernet208

41, 42, 43, 44, 45, 46, 47, 48

Eth27

400000

26

9126

rs

Ethernet216

33, 34, 35, 36, 37, 38, 39, 40

Eth28

400000

27

9126

rs

Ethernet224

25, 26, 27, 28, 29, 30, 31, 32

Eth29

400000

28

9126

rs

Ethernet232

17, 18, 19, 20, 21, 22, 23, 24

Eth30

400000

29

9126

rs

Ethernet240

9, 10, 11, 12, 13, 14, 15, 16

Eth31

400000

30

9126

rs

Ethernet248

1, 2, 3, 4, 5, 6, 7, 8

Eth32

400000

31

9126

rs

Ethernet256

257

Eth33

10000

32

9126

none

Ethernet257

258

Eth34

10000

33

9126

none

To modify SONiC interface properties, the corresponding devport settings must be changed and saved. Then, reboot the switch to apply those settings during the switch initialization process.