Contents

Monitor Link commands· 1

display monitor-link group· 1

downlink up-delay· 2

group-name· 3

monitor-link disable· 3

monitor-link group· 4

port 5

port monitor-link group· 6

uplink up-port-threshold· 7

 

Monitor Link commands

display monitor-link group

Use display monitor-link group to display information about monitor link groups.

Syntax

display monitor-link group { group-id | all }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

group-id: Specifies a monitor link group by its ID. The value range for this argument is 1 to 16.

all: Specifies all monitor link groups.

Usage guidelines

This command does not display information about ports that belong to a link aggregation group.

Examples

# Display information about all monitor link groups.

<Sysname> display monitor-link group all

Monitor link protocol global status: Disabled

Monitor link group 1 information:

  Monitor link protocol status : Disabled

  Group name       : group1

  Group status     : N/A

  Downlink up-delay: 0(s)

  Last-up-time     : -

  Last-down-time   : -

  Up-port-threshold: 1

 

  Member                    Role       Status       Weight

  HGE1/0/1                  UPLINK     UP

  HGE1/0/2                  DOWNLINK   UP

Table 1 Command output

Field	Description
Monitor link protocol global status	Whether Monitor Link is enabled globally: ·     Enabled. ·     Disabled.
Monitor link protocol status	Whether Monitor Link is enabled for a monitor link group: ·     Enabled. ·     Disabled.
Group status	Monitor link group status: ·     DOWN. ·     UP. ·     N/A—Monitor Link is disabled. The monitor link group does not operate.
Downlink up-delay	Switchover delay of the downlink interfaces in the monitor link group, in seconds.
Last-up-time	Last time when the monitor link group came up.
Last-down-time	Last time when the monitor link group went down.
Up-port-threshold	Uplink interface threshold for triggering monitor link group state switchover.
Member	Member interfaces of the monitor link group.
Role	Interface role, which can be uplink interface or downlink interface.
Status	Member interface state: ·     DOWN. ·     DOWN (Monitor Link)—The member interface is shut down by Monitor Link. ·     UP.
Weight	Weight of a member interface. If this field displays 0 for a downlink interface, the weight of the downlink interface equals the total weight of all uplink interfaces in the monitor link group.

 

downlink up-delay

Use downlink up-delay to set the switchover delay for the downlink interfaces in a monitor link group.

Use undo downlink up-delay to restore the default.

Syntax

downlink up-delay delay

undo downlink up-delay

Default

The switchover delay is 0 seconds. The downlink interfaces come up as soon as an uplink interface in the monitor link group comes up.

Views

Monitor link group view

Predefined user roles

network-admin

Parameters

delay: Sets the switchover delay in the range of 1 to 4294967295 seconds.

Usage guidelines

To avoid frequent state changes of downlink interfaces in the event that the uplink interfaces in the monitor link group flap, you can configure a switchover delay. The switchover delay is the time that the downlink interfaces wait before they come up following an uplink interface.

Examples

# Set the switchover delay to 50 seconds for the downlink interfaces in monitor link group 1.

<Sysname> system-view

[Sysname] monitor-link group 1

[Sysname-mtlk-group1] downlink up-delay 50

group-name

Use group-name to configure the name of a monitor link group.

Use undo group-name to restore the default.

Syntax

group-name name

undo group-name

Default

A monitor link group is named groupXX, where XX is the monitor link group ID. For example, monitor link group 1 is named group1 by default.

Views

Monitor link group view

Predefined user roles

network-admin

Parameters

name: Specifies a group name, a case-sensitive string of 1 to 31 characters. To contain spaces in a group name, enclose the group name in double quotation marks. For example, to configure the name of a monitor link group as group 1, enter "group 1". A group name cannot contain only spaces.

Usage guidelines

A monitor link group cannot use the default group name of another monitor link group. Different monitor link groups cannot have the same group name.

Examples

# Configure the name of monitor link group 1 as first-group.

<Sysname> system-view

[Sysname] monitor-link group 1

[Sysname-mtlk-group1] group-name first-group

monitor-link disable

Use monitor-link disable to disable Monitor Link globally or for a monitor link group.

Use undo monitor-link disable to enable Monitor Link globally or for a monitor link group.

Syntax

monitor-link disable

undo monitor-link disable

Default

Monitor Link is enabled both globally and for a monitor link group.

Views

System view

Monitor link group view

Predefined user roles

network-admin

Usage guidelines

A monitor link group can operate only after you enable Monitor Link both globally and for the monitor link group. When you disable Monitor Link globally or for a monitor link group, the monitor link group cannot operate and the downlink interfaces brought down by it resume their original states.

Examples

# Disable Monitor Link globally.

<Sysname> system-view

[Sysname] monitor-link disable

monitor-link group

Use monitor-link group to create a monitor link group and enter its view, or enter the view of an existing monitor link group.

Use undo monitor-link group to remove a monitor link group.

Syntax

monitor-link group group-id

undo monitor-link group group-id

Default

No monitor link groups exist.

Views

System view

Predefined user roles

network-admin

Parameters

group-id: Specifies a monitor link group ID. The value range for this argument is 1 to 16.

Examples

# Create monitor link group 1 and enter its view.

<Sysname> system-view

[Sysname] monitor-link group 1

[Sysname-mtlk-group1]

port

Use port to assign an interface to a monitor link group.

Use undo port to remove an interface from a monitor link group.

Syntax

port interface-type { interface-number | interface-number.subnumber } { downlink | uplink } [ weight weight-value ]

undo port interface-type interface-number

Default

No member interfaces exist in a monitor link group.

Views

Monitor link group view

Predefined user roles

network-admin

Parameters

interface-type: Specifies an interface by its type.

interface-number: Specifies an interface by its number.

interface-number.subnumber: Specifies a subinterface by its number. The argument subnumber is in the range of 1 to 4094.

downlink: Specifies a downlink interface.

uplink: Specifies an uplink interface.

weight weight-value: Specifies the interface weight in the range of 1 to 1000. The default weight of an uplink interface is 10. The default weight of a downlink interface is the total weight of all uplink interfaces in the monitor link group.

Usage guidelines

You can assign an interface to only one monitor link group.

You can also assign an interface to a monitor link group by using the port monitor-link group command in interface view.

If you have configured an interface as the downlink interface of a monitor link group, do not configure its subinterfaces as the uplink interfaces of any monitor link group.

Because the state of subinterfaces is associated with the state of the interface, do not add them to the same monitor link group.

If you have configured a Selected port of an aggregation group as the downlink interface of a monitor link group, do not configure an Unselected port of the aggregation group as the uplink interface of the monitor link group.

Do not assign an aggregate interface and member ports of the aggregate group to the same monitor link group.

A monitor link group forces downlink interfaces down if either of the following conditions exists:

·     The number of uplink interfaces in up state in the monitor link group is smaller than the uplink interface threshold. In this case, the monitor link group shuts down all downlink interfaces.

·     The total weight of all uplink interfaces in down state is greater than or equal to the weight of certain downlink interfaces in the monitor link group. In this case, the monitor link group shuts down only these downlink interfaces.

As a best practice, set a downlink interface weight to be smaller than or equal to the total weight of all uplink interfaces in a monitor link group. Without this setting, Monitor Link cannot shut down the downlink interface based on uplink interface state change.

To avoid downlink interface flapping, you must disable Monitor Link before performing the following tasks on a member interface in a monitor link group:

·     Remove the member interface from the monitor link group.

·     Remove and then reinsert the card where the member interface resides.

·     Change the link mode of the member interface to Layer 2 or Layer 3 mode by using the port link-mode command.

Examples

# Configure HundredGigE 1/0/1 as an uplink interface and HundredGigE 1/0/2 as a downlink interface for monitor link group 1.

<Sysname> system-view

[Sysname] monitor-link group 1

[Sysname-mtlk-group1] port hundredgige 1/0/1 uplink

[Sysname-mtlk-group1] port hundredgige 1/0/2 downlink

Related commands

port monitor-link group

port monitor-link group

Use port monitor-link group to assign an interface to a monitor link group.

Use undo port monitor-link group to remove an interface from a monitor link group.

Syntax

port monitor-link group group-id { downlink | uplink } [ weight weight-value ]

undo port monitor-link group group-id

Default

An interface is not a monitor link group member.

Views

Layer 2 Ethernet interface view/Layer 3 Ethernet interface/Layer 3 Ethernet subinterface view

Layer 2 aggregate interface view/Layer 3 aggregate interface/Layer 3 aggregate subinterface view

Predefined user roles

network-admin

Parameters

group-id: Specifies a monitor link group by its ID. The value range for this argument is 1 to 16.

downlink: Specifies a downlink interface.

uplink: Specifies an uplink interface.

weight weight-value: Specifies the interface weight in the range of 1 to 1000. The default weight of an uplink interface is 10. The default weight of a downlink interface is the total weight of all uplink interfaces in the monitor link group.

Usage guidelines

You can assign an interface to only one monitor link group.

You can also assign an interface to a monitor link group by using the port command in monitor link group view.

If you have configured an interface as the downlink interface of a monitor link group, do not configure its subinterfaces as the uplink interfaces of any monitor link group.

Because the state of subinterfaces is associated with the state of the interface, do not add the interface and its subinterfaces to the same monitor link group.

If you have configured a Selected port of an aggregation group as the downlink interface of a monitor link group, do not configure an Unselected port of the aggregation group as the uplink interface of the monitor link group.

Do not assign an aggregate interface and member ports of the aggregate group to the same monitor link group.

A monitor link group forces downlink interfaces down if either of the following conditions exists:

·     The number of uplink interfaces in up state in the monitor link group is smaller than the uplink interface threshold. In this case, the monitor link group shuts down all downlink interfaces.

·     The total weight of all uplink interfaces in down state is greater than or equal to the weight of certain downlink interfaces in the monitor link group. In this case, the monitor link group shuts down only these downlink interfaces.

As a best practice, set a downlink interface weight to be smaller than or equal to the total weight of all uplink interfaces in a monitor link group. Without this setting, Monitor Link cannot shut down the downlink interface based on uplink interface state change.

To avoid downlink interface flapping, you must disable Monitor Link before performing the following tasks on a member interface in a monitor link group:

·     Remove the member interface from the monitor link group.

·     Remove and then reinsert the card where the member interface resides.

·     Change the link mode of the member interface to Layer 2 or Layer 3 mode by using the port link-mode command.

Examples

# Configure HundredGigE 1/0/1 as an uplink interface and HundredGigE 1/0/2 as a downlink interface for monitor link group 1.

<Sysname> system-view

[Sysname] monitor-link group 1

[Sysname-mtlk-group1] quit

[Sysname] interface hundredgige 1/0/1

[Sysname-HundredGigE1/0/1] port monitor-link group 1 uplink

[Sysname-HundredGigE1/0/1] quit

[Sysname] interface hundredgige 1/0/2

[Sysname-HundredGigE1/0/2] port monitor-link group 1 downlink

Related commands

port

uplink up-port-threshold

Use uplink up-port-threshold to configure the uplink interface threshold for triggering monitor link group state switchover.

Use undo uplink up-port-threshold to restore the default.

Syntax

uplink up-port-threshold number-of-port

undo uplink up-port-threshold

Default

The uplink interface threshold for triggering monitor link group state switchover is 1.

Views

Monitor link group view

Predefined user roles

network-admin

Parameters

number-of-port: Specifies the uplink interface threshold for triggering monitor link group state switchover, in the range of 1 to 1024.

Usage guidelines

When the number of uplink interfaces in up state in a monitor link group is less than the specified threshold, the monitor link group goes down and shuts down its downlink interfaces. When the number of uplink interfaces in up state reaches the threshold, the monitor link group comes up and brings up all its downlink interfaces.

As a best practice, use the display monitor-link group command to display the total number of uplink interfaces before executing the uplink up-port-threshold command. If you set the threshold to be greater than the total number of uplink interfaces, the monitor link group cannot come up and data will be lost.

Examples

# Set the uplink interface threshold for triggering monitor link group state switchover to 5.

<Sysname> system-view

[Sysname] monitor-link group 1

[Sysname-mtlk-group1] uplink up-port-threshold 5