High Availability Configuration

MC-LAG

MC-LAG View

Table 1 MC-LAG View

Command	Purpose
show mclag state [domain-id]	Display information about MC-LAG.
show mclag consistency_check_result	Display the results of the parameter consistency check of MC-LAG.
show interface errdown	Display interfaces with err-down status.
show loopback-detect [ethernet|link-aggregation interface_name]	Display MC-LAG loopback detection configuration.

show mclag state [domain-id]

[Command]

show mclag state [domain-id]

[Purpose]

Display information about MC-LAG.

[Parameters]

Parameter	Description
domain-id	Specify the domain ID, and the range is from 1 to 4095.

[View]

Privileged User View

[Use Cases]

sonic# show mclag state 11
The MCLAG's keepalive is: OK
MCLAG info sync is: completed
Domain id: 11
Local Ip: 11.0.0.6
Peer Ip: 11.0.0.7
Peer Link Interface: Ethernet100
Keepalive time: 1
sesssion Timeout : 15
Peer Link Mac: 18:17:25:37:67:20
Role: Active
MCLAG Interface: PortChannel0009
Loglevel: NOTICE

show mclag consistency_check_result

[Command]

show mclag consistency_check_result

[Purpose]

Display the results of the parameter consistency check of MC-LAG.

[View]

Privileged User View

[Use Cases]

sonic# show mclag consistency_check_result
---------------------------------------------------------------------------------
ifname        mode(lacp/static)   fast-rate   fallback    trunk_mode  allowed_vlan
---------------------------------------------------------------------------------
lag203             Pass                Pass         Pass          Pass          Pass
lag202             Pass                Pass         Pass          Pass          Pass

show interface errdown

[Command]

show interface errdown

[Purpose]

Display interfaces with err-down status.

[View]

Privileged User View

[Use Cases]

sonic# show interface errdown
Interface        Status
---------------  --------
Ethernet0        errdown
Ethernet1        up
Ethernet2        up
Ethernet3        up
Ethernet4        up
Ethernet5        up
Ethernet6        up
Ethernet7        up
Ethernet8        up
Ethernet9        up
Ethernet10       up
Ethernet11       up
Ethernet12       up
Ethernet13       up
Ethernet14       up
Ethernet15       up
Ethernet16       up
Ethernet17       up
Ethernet18       up
Ethernet19       up
Ethernet20       up
Ethernet21       up
Ethernet22       up
Ethernet23       up
Ethernet24       up
Ethernet25       up
Ethernet26       up
Ethernet27       up
Ethernet28       up
Ethernet29       up
Ethernet30       up
Ethernet31       up
Ethernet32       up
Ethernet33       up
Ethernet34       errdown
Ethernet35       up
Ethernet36       up
Ethernet37       up
Ethernet38       up
Ethernet39       up
Ethernet40       up
Ethernet41       up
Ethernet42       up
Ethernet43       up
Ethernet44       up
Ethernet45       up
Ethernet46       up
Ethernet47       errdown
Ethernet48       errdown
Ethernet52       up
Ethernet56       errdown
Ethernet60       errdown
Ethernet64       errdown
Ethernet68       up
Ethernet72       up
Ethernet76       up
PortChannel0001  errdown
PortChannel0099  up

show loopback-detect [ethernet|link-aggregation interface_name]

[Command]

show loopback-detect [ethernet|link-aggregation interface_name]

[Purpose]

Display MC-LAG loopback detection configuration.

[Parameters]

Parameter	Description
interface_name	Interface name (eg.0/1)

[View]

Privileged User View

[Use Cases]

sonic# show loopback-detect
Port    Policy    Vlan       Interval    Wait time  Vlans with loop
------  --------  -------  ----------  -----------  -----------------
lag111  shutdown  100-200          10           60
sonic# show loopback-detect link-aggregation 111
Port    Policy    Vlan       Interval    Wait time  Vlans with loop
------  --------  -------  ----------  -----------  -----------------
lag111  shutdown  100-200          10           60

MC-LAG Config

Table 2 MC-LAG Config

Command	Purpose
mclag domain domain-id	Create a MC-LAG domain.
peer-link {ethernet|link-aggregation} interface_name	Set peer-link for MC-LAG.
peer-address {A.B.C.D|A::B}	Configure peer IP address of MC-LAG control link.
local-address {A.B.C.D|A::B}	Configure local IP address of MC-LAG control link.
heartbeat-interval interval	Set the sending interval for MC-LAG keepalive messages.
session-timeout timeout	Set the timeout for MC-LAG sessions.
member lag lag-id	Configure the member ports for MC-LAG.
vrf vrf_name	Specify the vrf that MC-LAG keepalive session belongs to.
consistency-check-action {default|graceful|idle}	Specify the mode for MC-LAG consistency check.
backup-channel vlan vlan-id	Configure ICCP backup channel for MC-LAG.
dad local-address {A.B.C.D|A::B}	Configure local IP address of MC-LAG DAD link.
dad peer-address {A.B.C.D|A::B}	Configure peer IP address of MC-LAG DAD link.
dad detection-delay delay_time	Specify the delay time for MC-LAG DAD detection.
dad recovery-delay {non-mlag|mlag} delay_time	Specify the delay time for the interfaces in error-down to be brought up on MC-LAG standby side.
dad vrf vrf_name	Specify the vrf where MC-LAG DAD link is located.
loopback-detect vlan vlan-id [policy {shutdown|block-vlan} interval interval [wait-time wait-time]]	Configure MC-LAG loopback detection.
unique-ip vlan vlan-id [diff_mac|same_mac]	Enable unique-ip feature for the VLAN.

Notes:

• It is recommended to use low-speed interfaces for the member ports of MC-LAG. To improve system reliability, it is recommended to set the link aggregation mode of member ports to LACP, and it is also recommended to enable fast-rate to improve the performance of failover convergence.
• Set a directly connected aggregation link between two MC-LAG peers as peer-link. It is recommended to use high-speed interfaces for peer-link. In order to improve the reliability of MC-LAG, it is recommended to set peer-link as static aggregation, and the number of member ports is no less than two. You need to manually assign a private VLAN for peer-link and add it to the service VLANs. No other configuration is allowed on the interfaces that are configured as peer-link.
• It is recommended to use low-speed interfaces for DAD-link (currently does not support out-of-band Management Interface ). DAD-link and peer-link cannot be shared.
• Please configure DAD-link when the peer-link status is up to prevent the ports of the standby side from being mistakenly set as error-down.
• You need to manually set a monitor link group for MC-LAG active and standby side. The uplink port is configured as uplink, and the downlink port is configured as downlink, please refer to section Monitor Link Config for specific configuration commands.

mclag domain domain-id

[Command]

mclag domain domain-id

[Purpose]

Create a MC-LAG domain.

[Parameters]

Parameter	Description
domain-id	Specify the domain ID, and the range is from 1 to 4095.

[View]

Global Configuration View

[Notes]

Run command no mclag domain domain-id to delete MC-LAG domain.

[Use Cases]

sonic# configure terminal
sonic(config)# mclag domain 1

peer-link {ethernet|link-aggregation} interface_name

[Command]

peer-link {ethernet|link-aggregation} interface_name

[Purpose]

Set peer-link for MC-LAG.

[Parameters]

Parameter	Description
interface_name	Interface name (eg.0/1)

[View]

MC-LAG Domain Configuration View

[Notes]

Run command no peer-link to delete peer-link configuration.

[Use Cases]

sonic# configure terminal
sonic(config)# mclag domain 1
sonic(mclag-domain)# peer-link ethernet 0/100
sonic(mclag-domain)# peer-link link-aggregation 10

peer-address {A.B.C.D|A::B}

[Command]

peer-address {A.B.C.D|A::B}

[Purpose]

Configure peer IP address of MC-LAG control link.

[Parameters]

Parameter	Description
A.B.C.D	IPv4 address
A::B	IPv6 address

[View]

MC-LAG Domain Configuration View

[Notes]

Run command no peer-address to delete peer IP address of MC-LAG control link.

[Use Cases]

sonic# configure terminal
sonic(config)# mclag domain 1
sonic(mclag-domain)# peer-address 11.0.0.6

local-address {A.B.C.D|A::B}

[Command]

local-address {A.B.C.D|A::B}

[Purpose]

Configure local IP address of MC-LAG control link.

[Parameters]

Parameter	Description
A.B.C.D	IPv4 address
A::B	IPv6 address

[View]

MC-LAG Domain Configuration View

[Notes]

Run command no local-address to delete local IP address of MC-LAG control link.

[Use Cases]

sonic# configure terminal
sonic(config)# mclag domain 1
sonic(mclag-domain)# local-address 11.0.0.6

heartbeat-interval interval

[Command]

heartbeat-interval interval

[Purpose]

Set the sending interval for MC-LAG keepalive messages.

[Parameters]

Parameter	Description
interval	Specify the interval in seconds. The range is from 1 to 60, and the default is 1.

[View]

MC-LAG Domain Configuration View

[Notes]

The keepalive message interval value should be less than 1/3 of the session timeout, and the session timeout should be a multiple of the keepalive message interval. Run command no heartbeat-interval to restore MC-LAG keepalive message sending interval to the default.

[Use Cases]

sonic# configure terminal
sonic(config)# mclag domain 1
sonic(mclag-domain)# heartbeat-interval 6

session-timeout timeout

[Command]

session-timeout timeout

[Purpose]

Set the timeout for MC-LAG sessions.

[Parameters]

Parameter	Description
timeout	Specify the timeout in seconds. The range is from 3 to 3600, and the default is 15.

[View]

MC-LAG Domain Configuration View

[Notes]

The keepalive message interval value should be less than 1/3 of the session timeout, and the session timeout should be a multiple of the keepalive message interval. Run command no session-timeout to restore MC-LAG session timeout to the default.

[Use Cases]

sonic# configure terminal
sonic(config)# mclag domain 1
sonic(mclag-domain)# session-timeout 6

member lag lag-id

[Command]

member lag lag-id

[Purpose]

Configure the member ports for MC-LAG.

[Parameters]

Parameter	Description
lag-id	LAG ID, the range is from 1 to 9999.

[View]

MC-LAG Domain Configuration View

[Notes]

Supports configuring multiple MC-LAG member ports. Run command no member lag lag-id to delete MC-LAG member ports configuration.

[Use Cases]

sonic# configure
sonic(config)# mclag domain 1
sonic(mclag-domain)# member lag 9

vrf vrf_name

[Command]

vrf vrf_name

[Purpose]

Specify the vrf that MC-LAG keepalive session belongs to.

[Parameters]

Parameter	Description
vrf_name	Specify the VRF name, the default VRF is default.

[View]

MC-LAG Domain Configuration View

[Notes]

Configure the vrf that MC-LAG keepalive session belongs to, that is, specify the vrf of the router interface to which local-address belongs. Run command no vrf to delete MC-LAG keepalive vrf configuration and restore to default vrf.

[Use Cases]

sonic# configure
sonic(config)# mclag domain 1
sonic(mclag-domain)# vrf 9

consistency-check-action {default|graceful|idle}

[Command]

consistency-check-action {default|graceful|idle}

[Purpose]

Specify the mode for MC-LAG consistency check.

[Parameters]

Parameter	Description
default	In this mode, if the consistency check fails, the active and standby switches will bring the member ports down administratively at the same time.
graceful	In this mode, if the consistency check fails, only standby switch will bring the member ports down administratively, and the active switch will keep the member ports up.
idle	In this mode, it only displays the result of the consistency check, without any corresponding action.

[View]

MC-LAG Domain Configuration View

[Notes]

The consistency check is in idle mode by default.

[Use Cases]

sonic# configure
sonic(config)# mclag domain 1
sonic(mclag-domain)# consistency-check-action default

backup-channel vlan vlan-id

[Command]

backup-channel vlan vlan-id

[Purpose]

Configure ICCP backup channel for MC-LAG.

[Parameters]

Parameter	Description
vlan-id	VLAN ID, the range is [1,4094].

[View]

MC-LAG Domain Configuration View

[Notes]

This feature requires an additional link. Add the interface to a separate VLAN and configure VLANIF with interface vlan vlan-id command, and then use this VLANIF as the ICCP backup channel. Run command no backup-channel to delete ICCP backup channel for MC-LAG.

[Use Cases]

sonic# configure
sonic(config)# mclag domain 1
sonic(mclag-domain)# backup-channel vlan 10

dad local-address {A.B.C.D|A::B}

[Command]

dad local-address {A.B.C.D|A::B}

[Purpose]

Configure local IP address of MC-LAG DAD link.

[Parameters]

Parameter	Description
A.B.C.D	IPv4 address
A::B	IPv6 address

[View]

MC-LAG Domain Configuration View

[Notes]

Run command no dad local-address to delete local IP address of MC-LAG DAD link.

[Use Cases]

sonic# configure
sonic(config)# mclag domain 1
sonic(mclag-domain)# dad local-address 10.0.0.3

dad peer-address {A.B.C.D|A::B}

[Command]

dad peer-address {A.B.C.D|A::B}

[Purpose]

Configure peer IP address of MC-LAG DAD link.

[Parameters]

Parameter	Description
A.B.C.D	IPv4 address
A::B	IPv6 address

[View]

MC-LAG Domain Configuration View

[Notes]

Run command no dad peer-address to delete peer IP address of MC-LAG DAD link.

[Use Cases]

sonic# configure
sonic(config)# mclag domain 1
sonic(mclag-domain)# dad peer-address 10.0.0.2

dad detection-delay delay_time

[Command]

dad detection-delay delay_time

[Purpose]

Specify the delay time for MC-LAG DAD detection.

[Parameters]

Parameter	Description
delay_time	Specify the delay time in seconds. The range is from 0 to 512, and the default is 15.

[View]

MC-LAG Domain Configuration View

[Notes]

Run command no dad detection-delay time to restore the delay time to default.

[Use Cases]

sonic# configure
sonic(config)# mclag domain 1
sonic(mclag-domain)# dad detection-delay 60

dad recovery-delay {non-mlag|mlag} delay_time

[Command]

dad recovery-delay {non-mlag|mlag} delay_time

[Purpose]

Specify the delay time for the interfaces in error-down to be brought up on MC-LAG standby side.

[Parameters]

Parameter	Description
non-mlag	Configure the delay time for non-MC-LAG members.
mlag	Configure the delay time for MC-LAG members.
delay_time	Specify the delay time for error-down interface state recovery in seconds. The range is from 0 to 1000. The default value is 60 for MC-LAG members and 0 for non-MC-LAG members.

[View]

MC-LAG Domain Configuration View

[Notes]

Run command no dad recovery-delay {non-mlag|mlag} to restore the delay time to default.

[Use Cases]

sonic# configure
sonic(config)# mclag domain 1
sonic(mclag-domain)# dad recovery-delay non-mlag 30
sonic(mclag-domain)# dad recovery-delay mlag 90

dad vrf vrf_name

[Command]

dad vrf vrf_name

[Purpose]

Specify the vrf where MC-LAG DAD link is located.

[Parameters]

Parameter	Description
vrf_name	Specify the VRF name, the default VRF is default.

[View]

MC-LAG Domain Configuration View

[Notes]

Run command no dad vrf to restore the VRF of MC-LAG DAD link to default VRF.

[Use Cases]

sonic# configure
sonic(config)# mclag domain 1
sonic(mclag-domain)# dad vrf 200

loopback-detect vlan vlan-id [policy {shutdown|block-vlan} interval interval [wait-time wait-time]]

[Command]

loopback-detect vlan vlan-id [policy {shutdown|block-vlan} interval interval [wait-time wait-time]]

[Purpose]

Configure MC-LAG loopback detection.

[Parameters]

Parameter	Description
vlan-id	VLAN ID, the range is [1,4094].
policy	Optionally configure the execution policy after a loopback has been detected. The default is shutdown mode.
shutdown	Indicates that the switch will shut down interfaces with loopback detection configured.
block-vlan	Indicates that the switch will block the VLAN with loopback detection configured.
interval	Specify the interval time in seconds, and the default value is 5 seconds.
wait-time	Specifies the wait time in seconds before restoring a blocked port or VLAN. The default value is 60 seconds.

[View]

Physical Interface Configuration View / LAGIF Configuration View

[Notes]

This feature is enabled on the MC-LAG downlink aggregation port to avoid traffic looping due to configuration mistakes. Run command no loopback-detect to disable loopback detection.

[Use Cases]

sonic# configure
sonic(config)# interface ethernet 0/52
sonic(config-if-0/52)# loopback-detect vlan 10 policy shutdown interval 3
sonic(config)# interface link-aggregation 111
sonic(config-lagif-111)# loopback-detect vlan 200-300

unique-ip vlan vlan-id [diff_mac|same_mac]

[Command]

unique-ip vlan vlan-id [diff_mac|same_mac]

[Purpose]

Enable unique-ip feature for the VLAN.

[Parameters]

Parameter	Description
vlan-id	VLAN ID, the range is [1,4094].
diff_mac	Use diff_mac mode when the MAC of the MC-LAG Peer’s protocol VLAN is different and the default is diff-mac mode when not specified.
same_mac	Use same_mac mode when the MAC of the MC-LAG Peer’s protocol VLAN is the same.

[View]

MC-LAG Domain Configuration View

[Notes]

This feature supports the MC-LAG Peer to establish a routing protocol with the access side to transmit routes. There are two programmes currently supported:

1. The gateway VLAN and the routing protocol VLAN are shared. The primary IP of the SVI are supposed to be different for protocol interactions, while the secondary IP be the same for external gateway. The VLAN MAC should be set to the same value (not the same with system MAC or interface MAC of the peers). In addition, it is required to enable unique-ip in same_mac mode and ARP proxy in EVPN mode for this VLAN.
2. Dual VLANs, that is, the gateway VLAN is separate from the routing protocol VLAN. The IP and the MAC of the gateway VLAN should be the same. While the IP of the routing protocol VLAN should be different from one another and the MAC can just use the default value. In addition, it is required to enable unique-ip in diff_mac mode and ARP proxy in EVPN mode for routing protocol VLAN. Run command no unique-ip vlan vlan-id to disable unique-ip for vlan.

[Use Cases]

sonic# configure
sonic(config)# mclag domain 1
sonic(mclag-domain)# unique-ip vlan 3010 same_mac

BFD

BFD View

Table 3 BFD View

Command	Purpose
show bfd peers [OPTIONs]	Display BFD session information.
show bfd peer {A.B.C.D|X:X::X:X} [multihop|local-address|interface|json|counters]	Display the specified BFD session information.
clear bfd peers counters	Clear BFD session statistics.
clear bfd peer {A.B.C.D|X:X::X:X} [multihop|local-address|interface] counters	Clear the specified BFD session statistics.

show bfd peers [OPTIONs]

[Command]

show bfd peers [OPTIONs]

[Purpose]

Display BFD session information.

[Options]

Option	Description
brief	Display abbreviated BFD information.
json	Display in json format.
counters	Display BFD statistics.

[View]

Privileged User View

[Use Cases]

sonic# show bfd peers
BFD Peers:
        peer 10.226.46.2 multihop local-address 10.226.33.2 vrf default
                ID: 1634016920
                Remote ID: 2927170466
                Passive mode
                Minimum TTL: 254
                Status: up
                Uptime: 32 minute(s), 14 second(s)
                Diagnostics: ok
                Remote diagnostics: ok
                Peer Type: configured
                Local timers:
                        Detect-multiplier: 3
                        Receive interval: 300ms
                        Transmission interval: 300ms
                        Echo receive interval: 50ms
                        Echo transmission interval: disabled
                Remote timers:
                        Detect-multiplier: 3
                        Receive interval: 300ms
                        Transmission interval: 300ms
                        Echo receive interval: 50ms
sonic# show bfd peers brief
Session count: 2
SessionId  LocalAddress                             PeerAddress                             Status
=========  ============                             ===========                             ======
1634016920 10.226.33.2                              10.226.46.2                             up
2943610781 2000:226:33::2                           2000:226:46::2                          admin-down
sonic# show bfd peers counters
BFD Peers:
        peer 10.226.46.2 multihop local-address 10.226.33.2 vrf default
                Control packet input: 7808 packets
                Control packet output: 7675 packets
                Echo packet input: 0 packets
                Echo packet output: 0 packets
                Session up events: 1
                Session down events: 3
                Zebra notifications: 1

show bfd peer { A.B.C.D|X:X::X:X } [multihop| local-address| interface| json| counters]

[Command]

show bfd peer { A.B.C.D|X:X::X:X } [multihop| local-address| interface| json| counters]

[Purpose]

Display the specified BFD session information.

[Parameters]

Parameter	Description
A.B.C.D	IPv4 neighbor address.
X:X::X:X	IPv6 neighbor address.

[View]

Privileged User View

[Use Cases]

sonic# show bfd peer 10.226.46.2 local-address 10.226.33.2 multihop
BFD Peer:
        peer 10.226.46.2 multihop local-address 10.226.33.2 vrf default
                ID: 1634016920
                Remote ID: 2927170466
                Passive mode
                Minimum TTL: 254
                Status: up
                Uptime: 3 minute(s), 56 second(s)
                Diagnostics: ok
                Remote diagnostics: ok
                Peer Type: configured
                Local timers:
                        Detect-multiplier: 3
                        Receive interval: 300ms
                        Transmission interval: 300ms
                        Echo receive interval: 50ms
                        Echo transmission interval: disabled
                Remote timers:
                        Detect-multiplier: 3
                        Receive interval: 300ms
                        Transmission interval: 300ms
                        Echo receive interval: 50ms

clear bfd peers counters

[Command]

clear bfd peers counters

[Purpose]

Clear BFD session statistics.

[View]

Privileged User View

[Use Cases]

sonic# clear bfd peers counters

clear bfd peer { A.B.C.D|X:X::X:X } [multihop| local-address| interface] counters

[Command]

clear bfd peer { A.B.C.D|X:X::X:X } [multihop| local-address| interface] counters

[Purpose]

Clear the specified BFD session statistics.

[Parameters]

Parameter	Description
A.B.C.D	IPv4 neighbor address.
X:X::X:X	IPv6 neighbor address.

[View]

Privileged User View

[Use Cases]

sonic# clear bfd peer 10.226.46.2 multihop local-address 10.226.33.2 interface ethernet 0/81 counters
sonic#

BFD Config

Table 4 BFD Config

Command	Purpose
bfd	Enter BFD Configuration View.
peer { A.B.C.D|X:X::X:X } [multihop| local-address| interface]	Create a BFD peer, and enter BFD Peer Configuration View.
profile profile_name	Create a BFD configuration template, and enter BFD Profile Configuration View.
profile-accelerate profile_name	Create a hardware accelerated BFD configuration template, and enter BFD Profile-accelerate Configuration View.
detect-multiplier detect-multiplier-value	Set BFD detection times
echo-mode	Enable echo mode.
echo {transmit-interval interval | receive-interval {interval | disabled} }	Specify the transmit or receive interval of echo packets.
echo-interval interval	Specify both the transmit and receive interval of echo packets.
passive-mode	Set BFD to passive mode.
receive-interval interval	Specify the receive interval of BFD control messages.
transmit-interval interval	Specify the transmit interval of BFD control messages.
shutdown	Shutdown the BFD session.
profile profile_name	Use BFD profile settings.

bfd

[Command]

bfd

[Purpose]

Enter BFD Configuration View.

[View]

Global Configuration View

[Use Cases]

sonic# configure terminal
sonic(config)# bfd
sonic(config-bfd)#

peer { A.B.C.D|X:X::X:X } [multihop| local-address| interface]

[Command]

peer { A.B.C.D|X:X::X:X } [multihop| local-address| interface]

[Purpose]

Create a BFD peer, and enter BFD Peer Configuration View.

[Parameters]

Parameter	Description
A.B.C.D	IPv4 neighbor address.
X:X::X:X	IPv6 neighbor address.

[View]

BFD Configuration View

[Notes]

Run command no peer { A.B.C.D|X:X::X:X } [multihop| local-address| interface] to delete BFD peer.

[Use Cases]

sonic# configure terminal
sonic(config)# bfd
sonic(config-bfd)# peer 10.226.46.2 multihop local-address 10.226.33.2
sonic(config-bfd-peer)#

profile profile_name

[Command]

profile profile_name

[Purpose]

Create a BFD configuration template, and enter BFD Profile Configuration View.

[Parameters]

Parameter	Description
profile_name	BFD profile name.

[View]

BFD Configuration View

[Notes]

Run command no profile profile_name to delete the profile.

[Use Cases]

sonic# configure termina
sonic(config)# bfd
sonic(config-bfd)# profile profile1
sonic(config-bfd-profile)#

profile-accelerate profile_name

[Command]

profile-accelerate profile_name

[Purpose]

Create a hardware accelerated BFD configuration template, and enter BFD Profile-accelerate Configuration View.

[Parameters]

Parameter	Description
profile_name	BFD profile name.

[View]

BFD Configuration View

[Notes]

The distributed BFD feature is recommended when there is a requirement for the number of BFD sessions (more than 64) or when the detection accuracy is required to be high (the packet sending interval is less than 100ms). Currently, only the physical Layer 3 ports on the CX308P-48Y-N-V2, CX532P-N-V2 and CX732Q-N-V2 support distributed BFD, and there are limitations on its use: multihop mode, echo mode and passive mode are not supported. It supports at most 7 different local detection durations. There will be more than 7 different local detection durations in the following scenarios:

1. Only one profile-accelerate profile is configured on local system, but over 7 different session parameters are configured on remote system.
2. More than 8 profile-accelerate profiles is configured on local system and is bound to BFD sessions. The calculation method for local detection duration is as follows: Local actual receiving time interval = MAX {local receive interval, remote transmission interval} Local detection duration= local actual receiving time interval x remote Detect-multiplier. It is not supported to work alone with at present, you can combine it with other protocol
3. Work with BGP. Run command neighbor {A.B.C.D|X:X::X:X|String} bfd profile profile_name in BGP Configuration View;
4. Work with OSPF/OSPFv3. Run command ip ospf bfd profile profile_name/ipv6 ospf6 bfd profile profile_name in Physical Interface Configuration View. Run command no profile-accelerate profile_name to delete the profile.

[Use Cases]

sonic# configure terminal
sonic(config)# bfd
sonic(config-bfd)# profile-accelerate profile1
sonic(config-bfd-profile-accelerate)#

detect-multiplier detect-multiplier-value

[Command]

detect-multiplier detect-multiplier-value

[Purpose]

Set BFD detection times

[Parameters]

Parameter	Description
detect-multiplier-value	The default value is 3, and the range is 2~255.

[View]

BFD Peer Configuration View / BFD Profile Configuration View / BFD Profile-accelerate Configuration View

[Use Cases]

sonic# configure terminal
sonic(config)# bfd
sonic(config-bfd)# peer 10.226.46.2 multihop local-address 10.226.33.2
sonic(config-bfd-peer)# detect-multiplier 5

echo-mode

[Command]

echo-mode

[Purpose]

Enable echo mode.

[View]

BFD Peer Configuration View / BFD Profile Configuration View

[Notes]

The default is asynchronous mode. Only single-hop BFD sessions can be configured as echo mode. Run command no echo-mode to disable echo mode and restore to asynchronous mode.

[Use Cases]

sonic# configure terminal
sonic(config)# bfd
sonic(config-bfd)# peer 10.226.46.2
sonic(config-bfd-peer)# echo-mode

echo {transmit-interval interval|receive-interval {interval|disabled}}

[Command]

echo {transmit-interval interval|receive-interval {interval|disabled}}

[Purpose]

Specify the transmit or receive interval of echo packets.

[Parameters]

Parameter	Description
interval	Specify the interval in msec, and the default value is 50.

[View]

BFD Peer Configuration View / BFD Profile Configuration View

[Notes]

echo receive-interval disabled indicates not to receive echo packets.

[Use Cases]

sonic# configure terminal
sonic(config)# bfd
sonic(config-bfd)# peer 10.226.33.1
sonic(config-bfd-peer)# echo transmit-interval 100
sonic(config-bfd-peer)# echo receive-interval 100

echo-interval interval

[Command]

echo-interval interval

[Purpose]

Specify both the transmit and receive interval of echo packets.

[Parameters]

Parameter	Description
interval	Specify the interval in msec, and the default value is 50.

[View]

BFD Peer Configuration View / BFD Profile Configuration View

[Use Cases]

sonic# configure terminal
sonic(config)# bfd
sonic(config-bfd)# peer 10.226.33.1
sonic(config-bfd-peer)# echo-interval 100

passive-mode

[Command]

passive-mode

[Purpose]

Set BFD to passive mode.

[View]

BFD Peer Configuration View / BFD Profile Configuration View

[Notes]

In passive mode, the switch does not attempt to start a session. Run command no passive-mode to revert to active mode.

[Use Cases]

sonic# configure termina
sonic(config)# bfd
sonic(config-bfd)# peer 10.226.33.1
sonic(config-bfd-peer)# passive-mode

receive-interval interval

[Command]

receive-interval interval

[Purpose]

Specify the receive interval of BFD control messages.

[Parameters]

Parameter	Description
interval	Specify the interval in msec, and the default value is 300.

[View]

BFD Peer Configuration View / BFD Profile Configuration View / BFD Profile-accelerate Configuration View

[Notes]

This configuration affects the local BFD session detection duration. Local BFD detection duration = peer detection multiplier * MAX{local receive interval, peer transmit interval}. The detection duration less than 100ms may cause BFD session flapping.

[Use Cases]

sonic# configure termina
sonic(config)# bfd
sonic(config-bfd)# peer 10.226.33.1
sonic(config-bfd-peer)# receive-interval 100

transmit-interval interval

[Command]

transmit-interval interval

[Purpose]

Specify the transmit interval of BFD control messages.

[Parameters]

Parameter	Description
interval	Specify the interval in msec, and the default value is 300.

[View]

BFD Peer Configuration View / BFD Profile Configuration View / BFD Profile-accelerate Configuration View

[Notes]

This configuration affects the local BFD session detection duration. Local BFD detection duration = peer detection multiplier * MAX{local receive interval, peer transmit interval}. The detection duration less than 100ms may cause BFD session flapping.

[Use Cases]

sonic# configure termina
sonic(config)# bfd
sonic(config-bfd)# peer 10.226.33.1
sonic(config-bfd-peer)# transmit-interval 100

shutdown

[Command]

shutdown

[Purpose]

Shutdown the BFD session.

[View]

BFD Peer Configuration View / BFD Profile Configuration View / BFD Profile-accelerate Configuration View

[Notes]

Run command no shutdown to start the BFD session.

[Use Cases]

sonic# configure termina
sonic(config)# bfd
sonic(config-bfd)# peer 10.226.33.1
sonic(config-bfd-peer)# shutdown
sonic(config-bfd-peer)#

profile profile_name

[Command]

profile profile_name

[Purpose]

Use BFD profile settings

[Parameters]

Parameter	Description
profile_name	BFD profile name.

[View]

BFD Peer Configuration View

[Notes]

Run command no profile profile_name to unbind the profile. When a BFD session is configured with parameters and a BFD Profile is bound, the parameters configured under the BFD Peer Configuration View take precedence.

[Use Cases]

sonic# configure termina
sonic(config)# bfd
sonic(config-bfd)# peer 10.226.33.1
sonic(config-bfd-peer)# profile profile1
sonic(config-bfd-peer)# no profile profile1

Monitor Link

Monitor Link View

show monitor-link

[Command]

show monitor-link

[Purpose]

Display monitor-link configuration.

[View]

Privileged User View

[Use Cases]

sonic# show monitor-link
+--------------+---------+------------------+--------------------+
| Group Name   |   Delay | Uplink Members   | Downlink Members   |
+==============+=========+==================+====================+
| test         |       2 |                  |                    |
+--------------+---------+------------------+--------------------+
| test2        |       5 |                  |                    |
+--------------+---------+------------------+--------------------+

Monitor Link Config

Table 5 Monitor Link Config

Command	Purpose
monitor-link-group group-name [delay-time]	Configure a monitor-link group.
monitor-link group-name {uplink|downlink}	Configure uplink and downlink.

monitor-link-group group-name [delay-time]

[Command]

monitor-link-group group-name [delay-time]

[Purpose]

Configure a monitor-link group.

[Parameters]

Parameter	Description
group-name	Set the monitor-link group name.
delay-time	(Optional) The delay time is in seconds and the default value is 0.

[View]

Global Configuration View

[Notes]

Run command no monitor-link-group group-name to delete monitor-link group configuration.

[Use Cases]

sonic# configure terminal
sonic(config)# monitor-link-group test 2

monitor-link group-name {uplink|downlink}

[Command]

monitor-link group-name {uplink|downlink}

[Purpose]

Configure uplink and downlink.

[Parameters]

Parameter	Description
group-name	Specify the monitor-link group name.

[View]

Physical Interface Configuration View

[Notes]

Run command no monitor-link group-name to delete monitor-link interface configuration.

[Use Cases]

sonic# configure terminal
sonic(config)# interface ethernet 0/0
sonic(config-if-0/0)# monitor-link test downlink

VRRP/VRRP6

VRRP/VRRP6 View

Table 6 VRRP/VRRP6 View

Command	Purpose
show {vrrp|vrrp6} [interface {ethernet interface_name[.subinterface-number]|link-aggregation lag-id[.subinterface-number] |vlan vlan-id}] [vrid] [json|summary]	Display VRRP/VRRP6 status information.

show {vrrp|vrrp6} [interface {ethernet interface_name[.subinterface-number]|link-aggregation lag-id[.subinterface-number] |vlan vlan-id}] [vrid] [json|summary]

[Command]

show {vrrp|vrrp6} [interface {ethernet interface_name[.subinterface-number]|link-aggregation lag-id[.subinterface-number]|vlan vlan-id}] [vrid] [json|summary]

[Purpose]

Display VRRP/VRRP6 status information.

[Parameters]

Parameter	Description
interface_name	Interface name (eg.0/1).
lag-id	LAG ID, the range is [1,9999].
subinterface-number	Subinterface number.
vlan-id	VLAN ID, the range is [1,4094].
vrid	Virtual Router ID,the range is [0,255].

[View]

Privileged User View

[Notes]

Currently only supported on CX308P-48Y-N-V2, CX532P-N-V2 and CX732Q-N-V2.

[Use Cases]

sonic# show vrrp 1
 Virtual Router ID                    1
 Protocol Version                     3
 Shutdown                             No
 Interface                            ethernet 0/4.3002
 VRRP interface (v4)                  Vrrp4-1
 Primary IP (v4)                      107.2.0.171
 Virtual MAC (v4)                     00:00:5e:00:01:01
 Status (v4)                          Master
 Priority                             110
 Effective Priority (v4)              110
 Preempt Mode                         Yes
 Accept Mode                          Yes
 Checksum with IPv4 Pseudoheader      Yes
 Advertisement Interval               1000 ms
 Master Advertisement Interval (v4)   1000 ms
 Advertisements Tx (v4)               36448
 Advertisements Rx (v4)               8
 Gratuitous ARP Tx (v4)               1216
 State transitions (v4)               2
 Skew Time (v4)                       570 ms
 Master Down Interval (v4)            3570 ms
 Tracking interface                   0
 IPv4 Addresses                       1
..................................   107.2.0.1

VRRP/VRRP6 Config

Table 7 VRRP/VRRP6 Config

Command	Purpose
{vrrp|vrrp6} vrid [version 2|3]	Configure VRID and specify the running version.
{vrrp|vrrp6} vrid advertisement-interval time	Configure advertisement interval for VRRP messages.
{vrrp|vrrp6} vrid {ip A.B.C.D/M | ipv6 X:X::X:X/M}	Configure virtual IP.
no {vrrp|vrrp6} vrid preempt	Enable preempt mode.
{vrrp|vrrp6} vrid priority pri	Configure VRRP instance priority.
{vrrp|vrrp6} vrid shutdown	Shutdown the VRRP instance.
no vrrp vrid checksum-with-ipv4-pseudoheader	Configure checksum calculation with IPv4 packet pseudo-header.
{vrrp|vrrp6} vrid track-interface {ethernet interface_name|link-aggregation lag-id |vlan vlan-id} priority-dec pri	Configure interface for instance association.
{vrrp|vrrp6} vrid bfd peer peer-ip	Enable BFD for VRRP instances
{vrrp|vrrp6} vrid bfd profile bfd-profile	Configure BFD profile for VRRP instances

{vrrp|vrrp6} vrid [version 2|3]

[Command]

{vrrp|vrrp6} vrid [version 2|3]

[Purpose]

Configure VRID.

[Parameters]

Parameter	Description
vrid	Virtual Router ID,the range is [0,255].
version	Specify the VRRP running version, the default is 3, VRRP6 does not need to be specified.

[View]

Physical Interface / Sub-interface/ VLANIF / LAGIF Configuration View

[Notes]

Run command no {vrrp|vrrp6} vrid to delete the VRRP instance configuratio. Run command no vrrp vrid version to delete the VRRP version configuration. Currently only supported on CX308P-48Y-N-V2, CX532P-N-V2 and CX732Q-N-V2.

[Use Cases]

sonic# configure terminal
sonic(config)# interface ethernet 0/0
sonic(config-if-0/0)# vrrp 1

{vrrp|vrrp6} vrid advertisement-interval time

[Command]

{vrrp|vrrp6} vrid advertisement-interval time

[Purpose]

Configure advertisement interval for VRRP messages.

[Parameters]

Parameter	Description
vrid	Virtual Router ID,the range is [0,255].
time	Message advertisement interval, the range is [10, 40950].Unit is milliseconds, When the protocol version is 2, the value should be configured as a multiple of 1000; when the protocol version is 3, it should be configured as a multiple of 10.

[View]

Physical Interface / Sub-interface/ VLANIF / LAGIF Configuration View

[Notes]

Run command no {vrrp|vrrp6} vrid advertisement-interval to restore the VRRP advertisement interval to the default value. Currently only supported on CX308P-48Y-N-V2, CX532P-N-V2 and CX732Q-N-V2.

[Use Cases]

sonic# configure terminal
sonic(config)# interface ethernet 0/0
sonic(config-if-0/0)# vrrp 1 advertisement-interval 100

{vrrp|vrrp6} vrid {ip A.B.C.D/M | ipv6 X:X::X:X/M}

[Command]

{vrrp|vrrp6} vrid {ip A.B.C.D/M | ipv6 X:X::X:X/M}

[Purpose]

Configure virtual IP.

[Parameters]

Parameter	Description
vrid	Virtual Router ID,the range is [0,255].
A.B.C.D/M	Virtual IP
X:X::X:X/M	Virtual IPV6

[View]

Physical Interface / Sub-interface/ VLANIF / LAGIF Configuration View

[Notes]

Run command no {vrrp|vrrp6} vrid {ip A.B.C.D/M | ipv6 X:X::X:X/M} to delete the virtual IP configuration. Currently only supported on CX308P-48Y-N-V2, CX532P-N-V2 and CX732Q-N-V2.

[Use Cases]

sonic# configure terminal
sonic(config)# interface ethernet 0/0
sonic(config-if-0/0)# vrrp 1 ip 1.1.1.1/24

no {vrrp|vrrp6} vrid preempt

[Command]

no {vrrp|vrrp6} vrid preempt

[Purpose]

Disable preempt mode.

[Parameters]

Parameter	Description
vrid	Virtual Router ID,the range is [0,255].

[View]

Physical Interface / Sub-interface/ VLANIF / LAGIF Configuration View

[Notes]

Default enable. Currently only supported on CX308P-48Y-N-V2, CX532P-N-V2 and CX732Q-N-V2.

[Use Cases]

sonic# configure terminal
sonic(config)# interface ethernet 0/0
sonic(config-if-0/0)# no vrrp 0 preempt

{vrrp|vrrp6} vrid priority pri

[Command]

{vrrp|vrrp6} vrid priority pri

[Purpose]

Configure VRRP instance priority.

[Parameters]

Parameter	Description
vrid	Virtual Router ID,the range is [0,255].
pri	Priority.Default is 100, with range is [1, 254].

[View]

Physical Interface / Sub-interface/ VLANIF / LAGIF Configuration View

[Notes]

Run command no {vrrp|vrrp6} vrid priority to delete the instance priority configuration. Currently only supported on CX308P-48Y-N-V2, CX532P-N-V2 and CX732Q-N-V2.

[Use Cases]

sonic# configure terminal
sonic(config)# interface ethernet 0/0
sonic(config-if-0/0)# vrrp 1 priority 200

{vrrp|vrrp6} vrid shutdown

[Command]

{vrrp|vrrp6} vrid shutdown

[Purpose]

Shutdown the VRRP instance.

[Parameters]

Parameter	Description
vrid	Virtual Router ID,the range is [0,255].

[View]

Physical Interface / Sub-interface/ VLANIF / LAGIF Configuration View

[Notes]

Run command no {vrrp|vrrp6} vrid shutdown to delete the shutdown the instance configuration. Currently only supported on CX308P-48Y-N-V2, CX532P-N-V2 and CX732Q-N-V2.

[Use Cases]

sonic# configure terminal
sonic(config)# interface ethernet 0/0
sonic(config-if-0/0)# vrrp 1 shutdown

no vrrp vrid checksum-with-ipv4-pseudoheader

[Command]

no vrrp vrid checksum-with-ipv4-pseudoheader

[Purpose]

Configure checksum calculation without IPv4 packet pseudo-header,but only for VRRP version 3.

[Parameters]

Parameter	Description
vrid	Virtual Router ID,the range is [0,255].

[View]

Physical Interface / Sub-interface/ VLANIF / LAGIF Configuration View

[Notes]

By default, the checksum calculation includes the IPv4 packet pseudo-header. Currently only supported on CX308P-48Y-N-V2, CX532P-N-V2 and CX732Q-N-V2.

[Use Cases]

sonic# configure terminal
sonic(config)# interface ethernet 0/0
sonic(config-if-0/0)# no vrrp 1 checksum-with-ipv4-pseudoheader

{vrrp|vrrp6} vrid track-interface {ethernet interface_name|link-aggregation lag-id |vlan vlan-id} priority-dec pri

[Command]

{vrrp|vrrp6} vrid track-interface {ethernet interface_name|link-aggregation lag-id |vlan vlan-id} priority-dec pri

[Purpose]

Configure interface for instance association.

[Parameters]

Parameter	Description
vrid	Virtual Router ID,the range is [0,255].
interface_name	Interface name (eg.0/1).
lag-id	LAG ID, the range is [1,9999].
vlan-id	VLAN ID, the range is [1,4094].
pri	Priority Reduction Value. The range is [10, 50].

[View]

Physical Interface / Sub-interface/ VLANIF / LAGIF Configuration View

[Notes]

Run command no {vrrp|vrrp6} vrid track-interface {ethernet interface_name|link-aggregation lag-id |vlan vlan-id} to delete the interface for instance association configuration. Currently only supported on CX308P-48Y-N-V2, CX532P-N-V2 and CX732Q-N-V2.

[Use Cases]

sonic# configure terminal
sonic(config)# interface ethernet 0/0
sonic(config-if-0/0)# vrrp 1 track-interface ethernet 0/4 priority-dec 50

{vrrp|vrrp6} vrid bfd peer peer-ip

[Command]

{vrrp|vrrp6} vrid bfd peer peer-ip

[Purpose]

Enable BFD for VRRP instances

[Parameters]

Parameter	Description
vrid	Virtual Router ID,the range is [0,255].
peer-ip	IP of BFD peer

[View]

Physical Interface / Sub-interface/ VLANIF / LAGIF Configuration View

[Notes]

Run command no {vrrp|vrrp6} vrid bfd peer to disable BFD for VRRP instances Currently only supported on CX308P-48Y-N-V2, CX532P-N-V2 and CX732Q-N-V2.

[Use Cases]

sonic# configure terminal
sonic(config)# interface ethernet 0/0
sonic(config-if-0/0)# vrrp 15 bfd peer 192.168.2.1

{vrrp|vrrp6} vrid bfd profile bfd-profile

[Command]

{vrrp|vrrp6} vrid bfdprofile bfd-profile

[Purpose]

Configure BFD profile for VRRP instances

[Parameters]

Parameter	Description
vrid	Virtual Router ID,the range is [0,255].
bfd-profile	Name of BFD profile

[View]

Physical Interface / Sub-interface/ VLANIF / LAGIF Configuration View

[Notes]

Run command no {vrrp|vrrp6} vrid bfd profile to delete BFD profile for VRRP instances Currently only supported on CX308P-48Y-N-V2, CX532P-N-V2 and CX732Q-N-V2.

[Use Cases]

sonic# configure terminal
sonic(config)# interface ethernet 0/0
sonic(config-if-0/0)# vrrp 15 bfd peer test

DHCP Server failover

Table 8 DHCP Server Failover Config

Command	Purpose
dhcp failover name	Enable DHCP Server failover
adddress {A.B.C.D|loopback 0}	Configure failover local IP
peer address A.B.C.D	Configure failover peer IP
auto-partner-down time	Configure peer offline time
max-response-delay time	Configure maximum communication interruption time
role {primary|secondary}	Configure primary and secondary roles

dhcp failover name

[Command]

dhcp failover name

[Purpose]

Enable DHCP Server failover.

[Parameters]

Parameter	Description
name	Instance name.

[View]

Global Configuration View

[Notes]

Run command no dhcp failover name to disable DHCP Server failover.

[Use Cases]

sonic# configure terminal
sonic(config)# dhcp failover t456

adddress {A.B.C.D|loopback 0}

[Command]

adddress {A.B.C.D|loopback 0}

[Purpose]

Configure local IP.

[Parameters]

Parameter	Description
A.B.C.D	IPv4 address.

[View]

DHCP failover Configuration View

[Notes]

Run command no address to delete local IP

[Use Cases]

sonic# configure terminal
sonic(config)# dhcp failover t456
sonic(config-dhcp-failover-t456)# address 20.0.0.1

peer address A.B.C.D

[Command]

peer address A.B.C.D

[Purpose]

Configure peer IP.

[Parameters]

Parameter	Description
A.B.C.D	IPv4 address.

[View]

DHCP failover Configuration View

[Notes]

Run command no peer address to delete peer IP

[Use Cases]

sonic# configure terminal
sonic(config)# dhcp failover t456
sonic(config-dhcp-failover-t456)# peer address 20.0.0.2

auto-partner-down time

[Command]

auto-partner-down time

[Purpose]

Configure peer offline time.

[Parameters]

Parameter	Description
time	Peer offline time, in seconds and ranging from 1 to 3600. By default, peers will not go offline.

[View]

DHCP failover Configuration View

[Notes]

Run command auto-partner-down to disable peer offline function

[Use Cases]

sonic# configure terminal
sonic(config)# dhcp failover t456
sonic(config-dhcp-failover-t456)# auto-partner-down 100

max-response-delay time

[Command]

max-response-delay time

[Purpose]

Configure maximum communication interruption time.

[Parameters]

Parameter	Description
time	The maximum communication interruption time, measured in seconds, ranges from 30 to 3600, with a default value of 60.

[View]

DHCP failover Configuration View

[Notes]

Run command nomax-response-delay to restore maximum communication time to default value

[Use Cases]

sonic# configure terminal
sonic(config)# dhcp failover t456
sonic(config-dhcp-failover-t456)# max-response-delay 100

role {primary|secondary}

[Command]

role {primary|secondary}

[Purpose]

Configure primary and secondary roles.

[View]

DHCP failover Configuration View

[Use Cases]

sonic# configure terminal
sonic(config)# dhcp failover t456
sonic(config-dhcp-failover-t456)# role primary