Command Line Reference
High Availability Configuratio...
MC-LAG
35 min
mc lag view mc lag view table 1 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 \[ 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 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 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 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 mc lag config table 2 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 for specific configuration commands mclag domain 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} 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 { 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 { 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 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 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 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 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} 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 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 { 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 { 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 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} 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 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 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 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 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 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
