3.14. MLAG Commands

Command Purpose

The mlag configuration command enters MLAG configuration mode to configure Multichassis Link Aggregation (MLAG) features.

The no mlag configuration command removes all MLAG configuration command from running-config.

Prerequisites

Command Syntax

mlag configuration

no mlag configuration

Command Mode

Global Config

Default

None

Usage

The mlag configuration command enters MLAG configuration mode to configure Multichassis Link Aggregation (MLAG) features. The exit command does not affect the configuration. The no mlag configuration command removes all MLAG configuration command from running-config.

Examples

This example shows how to enter MLAG configuration mode:

Switch# configure terminal
Switch(config)# mlag configuration

Related Commands

show mlag

Command Purpose

The peer-address command specifies the peer IPv4 address for a MLAG domain.

The no peer-address command removes the MLAG peer’s IPv4 address assignment by deleting the peer-address command from running-config.

Prerequisites

Command Syntax

peer-address IP_ADDR

no peer-address

Command Mode

MLAG Configuration

Default

None

Usage

The peer-address command specifies the peer IPv4 address for a MLAG domain. MLAG control traffic is sent to the peer IPv4 address.

The no peer-address command removes the MLAG peer’s IPv4 address assignment by deleting the peer-address command from running-config.

Examples

This example shows how to specify the peer IPv4 address for a MLAG domain:

Switch# configure terminal
Switch(config)# mlag configuration
Switch(config-mlag)# peer-address 12.1.1.2
Switch(config-mlag)#

Related Commands

show mlag peer

Command Purpose

The peer-link command specifies the interface that connects MLAG peers.

The no peer-link command removes the peer link by deleting the peer-link command from running-config

Prerequisites

Command Syntax

peer-link IFNAME

no peer-link

Command Mode

MLAG Configuration

Default

None

Usage

The peer-link command specifies the interface that connects MLAG peers. To form an MLAG, two switches are connected through an interface called a apeer link. The peer link carries control and data traffic between the two switches.

The no peer-link command removes the peer link by deleting the peer-link command from running-config.

Examples

This example shows how to specify the interface that connects MLAG peers:

Switch# configure terminal
Switch(config)# mlag configuration
Switch(config-mlag)# peer-link eth-0-9
Switch(config-mlag)#

Related Commands

show mlag

Command Purpose

The timers mlag command specifies the keepalive interval and holdtime timers.

The no timers mlag command removes the specified timer and returns it to default value.

Prerequisites

Command Syntax

timers mlag keepalive holdtime

no timers mlag

Command Mode

MLAG Configuration

Default

Default keepalive interval is 1 seconds and default holdtime is 5 seconds.

Usage

The timers mlag command specifies the keepalive interval and holdtime timers. It will be take effective by next time when the peer goes to established. Between the locally configured keepalive timer and the calculated value by the remote holdtime/4 carried in open message, system uses the smaller one in actual calculation.

The no timers mlag command removes the specified timer and returns it to default value.

Examples

This example shows how to specify the keeepalive interval and holdtime timers:

Switch# configure terminal
Switch(config)# mlag configuration
Switch(config-mlag)# timers mlag 10 100
Switch(config-mlag)#

Related Commands

show mlag peer

Command Purpose

The reload-delay command specifies the period that non-peer links are disabled after an MLAG peer reboots.

The no reload-delay command restores the default value of 300 by deleting the reload-delay mlag statement from running-config.

Prerequisites

Command Syntax

reload-delay ( auto | period )

no reload-delay

Command Mode

MLAG Configuration

Default

300 seconds.

Usage

When an MLAG peer reboots, all ports except those in peer-link port-channel remain in errdisabled state for a specified period. This period allows all topology states to stabilize before the switch begins forwarding traffic. The specified period is configured by this command.

Examples

This example shows how to specify the dealy interval:

Switch# configure terminal
Switch(config)# mlag configuration
Switch(config-mlag)# reload-delay 100
Switch(config-mlag)#

Related Commands

show mlag

Command Purpose

The sync-orphan command specifies the mlag peers to sync MAC entries on orphan port.

The no sync-orphan command disable the function.

Prerequisites

Command Syntax

sync-orphan

no sync-orphan

Command Mode

MLAG Configuration

Default

Enable

Usage

If this function is disabled, MLAG peers will only sync those MAC entries in MLAG group.

Examples

This example shows how to specify the mlag peers to sync MAC entries on orphan port:

Switch# configure terminal
Switch(config)# mlag configuration
Switch(config-mlag)# sync-orphan
Switch(config-mlag)#

Related Commands

show mlag

Command Purpose

The sync-overlay command specifies the mlag peers to sync MAC entries on overlay logic port.

The no sync-overlay command disable the function.

Prerequisites

Command Syntax

sync-overlay

no sync-overlay

Command Mode

MLAG Configuration

Default

Enable

Usage

If this function is disabled, MLAG peers will only sync those MAC entries in MLAG group.

Examples

This example shows how to specify the mlag peers to sync MAC entries on overlay logic ports:

Switch# configure terminal
Switch(config)# mlag configuration
Switch(config-mlag)# sync-overlay
Switch(config-mlag)#

Related Commands

show mlag

Command Purpose

The mlag command assigns an MLAG ID to a port-channel.

The no mlag command removes the MLAG ID assignment from the configuration mode interface by deleting the corresponding mlag command from running-config.

Prerequisites

Command Syntax

mlag MLAGID

no mlag

Command Mode

Interface Configuration

Default

None

Usage

The mlag command assigns an MLAG ID to a port-channel. MLAG peer switches form an MLAG when each switch configures the same MLAG ID to a port-channel interface. Only one MLAG ID can be assigned to an interface. An individual MLAG number cannot be assigned to more than one interface.

The no mlag command removes the MLAG ID assignment from the configuration mode interface by deleting the corresponding mlag command from running-config.

Examples

This example shows how to assigns an MLAG ID to a port-channel:

Switch# configure terminal
Switch(config)# interface agg1
Switch(config-if)# mlag 1

Related Commands

show mlag interface

Command Purpose

The clear mlag count command clears mlag count information.

Prerequisites

Command Syntax

clear mlag count

Command Mode

Privileged EXEC

Default

None

Usage

Use this command to clear mlag count information which can be displayed by show mlag peer command.

Examples

This example shows how to clear mlag count information and display information about the MLAG peer:

Switch# clear mlag count
Switch# show mlag peer 

MLAG neighbor is 12112, MLAG version 1
MLAG state = Established, up for 000039
Last read 000015, hold time is 240, keepalive interval is 60 seconds
Received 0 messages,Sent 0 messages
Open      received 0, sent 0
KAlive    received 0, sent 0
Fdb sync  received 0, sent 0
Failover  received 0, sent 0
Conf      received 0, sent 0
Syspri    received 0, sent 0
Peer fdb  received 0, sent 0
STP Total received 0, sent 0
 Global   received 0, sent 0
 Packet   received 0, sent 0
 Instance received 0, sent 0
 State    received 0, sent 0
Connections established 1; dropped 0
Local host 12111, Local port 61000
Foreign host 12112, Foreign port 37335
remote_sysid 0ecb30301100 

Related Commands

show mlag peer

Command Purpose

The show mlag command displays information about the MLAG configuration.

Prerequisites

Command Syntax

show mlag

Command Mode

Privileged EXEC

Default

None

Usage

Use this command to display information about the MLAG configuration.

Examples

This example shows how to display information about the MLAG configuration:

Switch# show mlag 

MLAG configuration
-----------------
role          Master
local_sysid   001e080a6fca
remote_sysid  000000000000
mlag_sysid    001e080a6fca
local_syspri  32768
remote_syspri 0
mlag_syspri   32768
peer-link     -
peer conf     No
reload-delay  300

Related Commands

mlag configuration

Command Purpose

The show mlag peer command displays information about the MLAG peer.

Prerequisites

Command Syntax

show mlag peer ( vlan-if | )

Command Mode

Privileged EXEC

Default

None

Usage

Use this command to display information about the MLAG peer.

Examples

This example shows how to display information about the MLAG peer:

Switch# show mlag peer

MLAG neighbor is 12112, MLAG version 1
MLAG state = Established, up for 4d02h14m
Last read 000029, hold time is 240, keepalive interval is 60 seconds
Received 6835 messages,Sent 7185 messages
Open      received 1, sent 2
KAlive    received 6831, sent 6830
Fdb sync  received 0, sent 0
Failover  received 0, sent 87
Conf      received 1, sent 1
STP Total received 2, sent 265
 Global   received 2, sent 3
 Packet   received 0, sent 0
 Instance received 0, sent 0
 State    received 0, sent 262
Connections established 1; dropped 0
Local host 12111, Local port 61000
Foreign host 12112, Foreign port 34283
remote_sysid 5e266a03d400

Related Commands

peer-address

Command Purpose

The show mlag interface command displays information about the MLAG interface.

Prerequisites

Command Syntax

show mlag interface ( MLAGID | )

Command Mode

Privileged EXEC

Default

None

Usage

Use this command to display information about the MLAG interface.

Examples

This example shows how to display information about the MLAG interface:

Switch# show mlag interface 


mlagid  local-if  local-state    remote-state   
1       agg1      up             up          
2       agg2      up             up          

Related Commands

mlag MLAGID