13.10. Multi-Link Commands

Command Purpose

Use this command to create a multi-link group and enter multi-link group configuration mode. To destroy the multi-link group, used no form of this command.

Prerequisites

Command Syntax

multi-link group GROUP-ID

no multi-link group (GROUP-ID|all)

Command Mode

Global Config

Default

There is no any multi-link group.

Usage

Up to 16 multi-link groups can be created.

Examples

Create a multi-link group with ID 1:

Switch# configure terminal
Switch(config)# multi-link group 1

Related Commands

show multi-link group

Command Purpose

Use this command to enable the switch to relay the multi-link flush packet. To disable relaying the packets, use no form of this command.

Prerequisites

Command Syntax

multi-link relay enable

no multi-link relay enable

Command Mode

Global Config

Default

Relaying the multi-link flush packet is enabled.

Usage

By default, the multi-link flush packet could be flooded. Use the command, “no multi-link relay enable”, to disable the packet flooding to other switches.

Examples

The example shows how to enable multi-link relay:

Switch# configure terminal
Switch(config)# multi-link relay enable

The example shows how to disable multi-link relay:

Switch# configure terminal
Switch(config)# no multi-link relay enable

Related Commands

None

Command Purpose

Use this command to set master or slave member interface of the multi-link group. To unset the member uses the no form of this command.

Prerequisites

Command Syntax

interface (IFPHYSICAL|IFAGG) priority PRIORITY

no interface (priority PRIORITY|all)

Command Mode

Multi-link Group Configuration

Default

There is no any interface member in the multi-link group by default.

Usage

Every multi-link group has more than two member interfaces. The interfaces should be physical (i.e. eth-0-1) or aggregator (i.e. agg1) switch interface.

NOTE: STP must be disabled in the multi-link interfaces first.

Examples

This example shows how to set interfaces eth-0-9 and eth-0-13 as the interfaces of multi-link group 1:

Switch# configure terminal
Switch(config)# interface eth-0-9
Switch(config-if)# spanning-tree port disable
Switch(config-if)# exit
Switch(config)# interface eth-0-13
Switch(config-if)# spanning-tree port disable
Switch(config-if)# exit
Switch(config)# multi-link group 1
Switch(config-multilk-group)# interface eth-0-9 master
Switch(config-multilk-group)# interface eth-0-13 slave
Switch(config-multilk-group)# end
Switch# show multi-link group 1
Multi-link group 1 information:
The multi-link group was disabled.
 ============================================================
Auto-restore:
state time count Last-time
disabled 60 0 N/A
 ============================================================
Protected instance:
Load balance instance:
 ============================================================
INTERFACE:
Role Member DownCount Last-Down-Time FlushCount Last-Flush-Time
MASTER eth-0-9 0 N/A 0 N/A
SLAVE eth-0-13 0 N/A 0 N/A

Related Commands

show multi-link group

Command Purpose

Use this command to set/unset protected MSTP instance to the multi-link group.

Prerequisites

Command Syntax

protected mstp instance INSTANCE-ID

no protected mstp instance (all|INSTANCE-ID)

Command Mode

Multi-link Group Configuration

Default

There is no protected MSTP instance in the multi-link group by default.

Usage

The multi-link groups only protect these VLANs in the protected MSTP instances. The multi-link group can’t be enabled if no protected instance is configured. To protect those VLANs which are not bound with MSTP instance, use the command protected mstp instance 0.

NOTE: If the MTSP instance is removed, it will be removed from multi-link group at the same time.

Examples

This example shows how to set MSTP instance 0, 10 and 100 to the multi-link group 1:

Switch# configure terminal
Switch(config)# multi-link group 1
Switch(config-multilk-group)# protected mstp instance 0
Switch(config-multilk-group)# protected mstp instance 10
Switch(config-multilk-group)# protected mstp instance 100
Switch(config-multilk-group)# end
Switch# show multi-link group 1
Multi-link group 1 information:
The multi-link group was enabled.
 ============================================================
Auto-restore:
state time count Last-time
disabled 60 0 N/A
 ============================================================
Protected instance: 0 10 100
Load balance instance:
 ============================================================
INTERFACE:
Role Member DownCount Last-Down-Time FlushCount Last-Flush-Time
PRI1 eth-0-9 0 N/A 0 N/A
PRI2 eth-0-10 0 N/A 0 N/A
PRI3 N/A 0 N/A 0 N/A
PRI4 eth-0-12 0 N/A 0 N/A
 ============================================================
Instance states in the member interfaces:
A - ACTIVE , B -BLOCK , D-The interface is link-down
Map-instance-ID P1(eth-0-9 ) P2(eth-0-10) P3(N/A ) P4(eth-0-12)
0 A B D B
10 A B D B
100 A B D B

Related Commands

show multi-link group

Command Purpose

Use this command to set/unset load-balancing to the multi-link group.

Prerequisites

Command Syntax

load-balance instance INSTANCE-ID priority PRIORITY

no load-balance instance (all|INSTANCE-ID)

Command Mode

Multi-link Group Configuration

Default

There is no load-balancing instance in the multi-link group by default.

Usage

Load-balancing instances will be active in the slave interface. If user want to configure load-balancing instances, should before the smart-group is enabled.

Examples

This example shows how to set protected instance 10 as the load-balancing instance:

Switch# configure terminal
Switch(config)# multi-link group 1
Switch(config-multilk-group)# load-balance instance 10 priority 2

Related Commands

show multi-link group

Command Purpose

Use this command to set restore time of the multi-link group.

Prerequisites

Command Syntax

restore time RESTORE-TIME

no restore time

Command Mode

Multi-link Group Configuration

Default

The default restore time is 60 seconds.

Usage

When the master interface is resumed, the links will not be immediately restored to the master interface, but will be delayed a while. The delay time is called restore time.

Examples

This example shows how to set restore time as 30 seconds in the multi-link group 1:

Switch# configure terminal
Switch(config)# multi-link group 1
Switch(config-multilk-group)# restore time 30

Related Commands

show multi-link group

Command Purpose

Use this command to enable/disable restoring feature of the multi-link group.

Prerequisites

Command Syntax

restore enable

no restore enable

Command Mode

Multi-link Group Configuration

Default

The restoring feature of the multi-link group is disabled by default.

Usage

When master interface fails, the link will be switched to the slave interface. Then, if master interface is resumed, the link will not be switched back to keep the flow stable by default. If restoring feature is enabled, the link will be switched back.

NOTE: If load-balancing instance is configured, this feature is recommended strongly.

Examples

This example shows how to enable the restoring feature in the multi-link group 1:

Switch# configure terminal
Switch(config)# multi-link group 1
Switch(config-multilk-group)# restore enable

Related Commands

show multi-link group

Command Purpose

Use this command to set/unset the flush packet sender in the multi-link group.

Prerequisites

Command Syntax

flush send control-vlan VLAN-ID password simple PASSWORD

no flush send

Command Mode

Multi-link Group Configuration

Default

There is no flush sender in the multi-link group by default.

Usage

Mac address-table should be updated when a master (forwarding) link goes down and the slave link begins forwarding traffic. Flush packet is used for this purpose.

NOTE: If the control-vlan is not existed in the switch, sending flush packet will fail.

Examples

This example shows how to configure flush sender of the multi-link group 1, control-vlan is 4 and password is “test”:

Switch# configure terminal
Switch(config)# multi-link group 1
Switch(config-multilk-group)# flush send control-vlan 4 password simple test

Related Commands

show multi-link group

multi-link flush receive

Command Purpose

Use this command to enable/disable the multi-link group.

Prerequisites

Command Syntax

group enable

no group enable

Command Mode

Multi-link Group Configuration

Default

Multi-link group is disabled by default.

Usage

After interface and protected instance configuration is finished, this command could be used to enable the group.

Examples

This example shows how to enable the multi-link group 1:

Switch# configure terminal
Switch(config)# multi-link group 1
Switch(config-multilk-group)# group enable

Related Commands

show multi-link group

Command Purpose

Use this command to set/unset the flush packet receiver in the switch interface.

Prerequisites

Command Syntax

multi-link flush receive control-vlan VLAN-ID password simple PASSWORD

no multi-link flush receive

Command Mode

Interface Configuration

Default

There is no flush receiver by default.

Usage

The received flush packet should have the same VLAN-ID and password with the sender. Otherwise, the packet will be discarded.

Examples

This example shows how to configure flush receiver in the interface eth-0-9, control-vlan is 4 and password is “test”:

Switch# configure terminal
Switch(config)# interface eth-0-9
Switch(config-if)# multi-link flush receive control-vlan 4 password simple test
Switch(config-if)# end
Switch# show multi-link
Relay multi-link flush packet is enabled
Multi-link received flush packet number:0
Multi-link processed flush packet number:0
Multi-link tcn is enabled
Multi-link tcn query count :2
Multi-link tcn query interval :3
Multi-link Group Number is 1.
Group-ID State Pri-1 Pri-2 Pri-3 Pri-4
1 enabled eth-0-9 eth-0-10 N/A eth-0-12

Related Commands

flush send

show multi-link

Command Purpose

Use this command to enable multi-link TCN. To disable the multi-link TCN, used no form of this command.

Prerequisites

Command Syntax

multi-link tcn enable

no multi-link tcn enable

Command Mode

Global Config

Default

Disable

Usage

None

Examples

Switch# configure terminal
Switch(config)# multi-link tcn enable
Switch# configure terminal
Switch(config)# no multi-link tcn enable

Related Commands

show multi-link

Command Purpose

Use this command to set multi-link TCN query count. To reset the multi-link TCN query count to default value, used no form of this command.

Prerequisites

Command Syntax

multi-link tcn query-count QUERY-COUNT

no multi-link tcn query-count

Command Mode

Global Config

Default

2

Usage

None

Examples

This example shows how to set multi-link TCN query count to 5:

Switch# configure terminal
Switch(config)# multi-link tcn query-count 5

Related Commands

show multi-link

Command Purpose

Use this command to set multi-link tcn query interval. To reset the multi-link TCN query interval to default value, used no form of this command.

Prerequisites

Command Syntax

multi-link tcn query-interval QUERY-INTERVAL

no multi-link tcn query-interval

Command Mode

Global Config

Default

10 s

Usage

None

Examples

This example shows how to set multi-link TCN query interval to 50:

Switch# configure terminal
Switch(config)# multi-link tcn query-interval 50

This example shows how to restore the default multi-link tcn query interval to 50:

Switch# configure terminal
Switch(config)# no multi-link tcn query-interval

Related Commands

show multi-link

Command Purpose

Use this command to display information of all multi-link groups.

Prerequisites

Command Syntax

show multi-link

Command Mode

Privileged EXEC

Default

None

Usage

This command is used to display a summary information of Multi-link group status, including received flush packet, processed flush packet and current Multi-link group number, etc.

Examples

Switch# show multi-link
Relay multi-link flush packet is enabled
Multi-link received flush packet number:0
Multi-link processed flush packet number:0
Multi-link tcn is enabled
Multi-link tcn query count :2
Multi-link tcn query interval :3
Multi-link Group Number is 1.
Group-ID State Pri-1 Pri-2 Pri-3 Pri-4
1 enabled eth-0-9 eth-0-10 N/A eth-0-12

Related Commands

None

Command Purpose

Use this command to display detailed information of all multi-link groups or a specific group.

Prerequisites

Command Syntax

show multi-link group (GROUP-ID| )

Command Mode

Privileged EXEC

Default

None

Usage

This command is used to display detail information of a specified Multi-link group or all Multi-link groups’ status.

Examples

Switch# show multi-link group 1

Related Commands

None

Command Purpose

Use this command to clear the statistic of the multi-link groups.

Prerequisites

Command Syntax

clear multi-link statistic

Command Mode

Privileged EXEC

Default

None

Usage

This command is used to clear the statistic of the multi-link groups.

Examples

Switch# clear multi-link statistic

Related Commands

None

Command Purpose

Use this command to debug detail information of multi-link.

Prerequisites

Command Syntax

debug multi-link (all|flush|instance|interface|restore)

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

Switch# debug multi-link all

Related Commands

None

Command Purpose

Use this command to set/unset the multilink enhance interface which sends enhanced packets in the multi-link group.

Prerequisites

Command Syntax

multilink-enhance interface (IFPHYSICAL|IFAGG)

no multilink-enhance interface

Command Mode

Multi-link Group Configuration

Default

There is no flush sender in the multi-link group by default.

Usage

The interface of multilink-enhance is generally out of multi-link group, when you want to configure multilink-enhance interface, you should set the control VLAN ID and password of flush send.

Examples

This example shows how to configure multilink-enhance of multi-link group 1:

Switch# configure terminal
Switch(config)# multi-link group 1
Switch(config-multilk-group)# multilink-enhance interface eth-0-1

Related Commands

show multi-link group

Command Purpose

Use this command to set/unset the multilink enhance interface which receives enhanced packets in multi-link group.

Prerequisites

Command Syntax

multilink-enhance receive control-vlan VLAN-ID password simple PASSWORD interface (IFPHYSICAL|IFAGG)

no multilink-enhance receive interface (IFPHYSICAL|IFAGG)

Command Mode

Multi-link Group Configuration

Default

There is no flush sender in the multi-link group by default.

Usage

The received interface of multilink-enhance must be the member of multi-link group with the lowest priority. When the interface enabling receiving enhanced packets, it should not be set the load-balance, and doesn’t add the lower priority interface in multi-link group.

Examples

This example shows how to configure multilink-enhance received interface of multi-link group 1:

Switch# configure terminal
Switch(config)# multi-link group 1
Switch(config-multilk-group)# multilink-enhance receive control-vlan 10 password b interface eth-0-2

Related Commands

show multi-link group

Command Purpose

Use this command to set the interval of sending enhance packets.

Prerequisites

Command Syntax

multilink-enhance send-interval INTERVAL>

no multilink-enhance send-interval

Command Mode

Multi-link Group Configuration

Default

10

Usage

NONE.

Examples

This example shows how to configure the interval of sending enhance packets, its value is 20:

Switch# configure terminal
Switch(config)# multi-link group 1
Switch(config-multilk-group)# multilink-enhance send-interval 20

Related Commands

show multi-link group

Command Purpose

Use this command to set the interval of checking received enhance packets.

Prerequisites

Command Syntax

multilink-enhance timeout TIMEOUT

no multilink-enhance timeout

Command Mode

Multi-link Group Configuration

Default

10

Usage

NONE

Examples

This example shows how to configure the interval of checking received enhance packets, its value is 20:

Switch# configure terminal
Switch(config)# multi-link group 1
Switch(config-multilk-group)# multilink-enhance timeout 20

Related Commands

show multi-link group