track route-monitor-group

Function

The track route-monitor-group command associates an interface with a route monitoring group.

The undo track route-monitor-group command restores the default configuration.

By default, an interface is not associated with any route monitoring group.

Format

track route-monitor-group groupName [ trigger-down-weight trigger-down-weight-value ]

undo track route-monitor-group [ groupName [ trigger-down-weight trigger-down-weight-value ] ]

Parameters

Parameter	Description	Value
groupName	Specifies the name of a route monitoring group.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. The character string can contain spaces if it is enclosed in double quotation marks (").
trigger-down-weight trigger-down-weight-value	Specifies a weight value for the associated interface to automatically go Down.	The value is an integer ranging from 1 to 1000.

Parameter

Description

Value

groupName

Specifies the name of a route monitoring group.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported.

The character string can contain spaces if it is enclosed in double quotation marks (").

trigger-down-weight trigger-down-weight-value

Specifies a weight value for the associated interface to automatically go Down.

The value is an integer ranging from 1 to 1000.

Views

100GE-Trunk member Layer 2 interface view, 100GE-Trunk member interface view, Layer 2 100GE interface view, 100ge sub-interface view, 100GE interface view, Layer 2 10GE interface view, 10GE sub-interface view, 10GE interface view, 10G LAN interface view, 10G WAN interface view, EVC view of a 10GE interface, 200GE sub-interface view, 25GE-L2 view, 25GE sub-interface view, 25GE interface view, 400GE sub-interface view, 400GE interface view, 40GE-Trunk member Layer 2 interface view, 40GE-Trunk member interface view, Layer 2 40GE interface view, 40GE sub-interface view, 40GE interface view, 50GE sub-interface view, 50GE interface view, Eth-Trunk sub-interface view, Eth-Trunk interface view, FlexE sub-interface view, FlexE interface view, GE optical interface view, GE sub-interface view, GE interface view, GE electrical interface view, Global VE interface view, VE interface view, VLANIF interface view, XGE sub-interface view

Default Level

2: Configuration level

Task Name and Operations

Task Name	Operations
interface-mgr	write

Usage Guidelines

Usage Scenario

You can create a route monitoring group and add routes to it. If the route monitoring group is required to trigger the status of a user-side interface to change, run the track route-monitor-group command to associate the interface with the route monitoring group. When the fault weight of the route monitoring group reaches the value specified by downWeight, the interface goes Down. This event triggers traffic to be switched to the secondary link. When the fault weight of the route monitoring group falls below the value specified by downWeight, the interface goes Up. This event triggers traffic to be switched to the primary link. This process enables the interface to promptly detect route faults on the network side, ensuring service reliability on the user side.

Prerequisites

A route monitoring group has been created using the ip route-monitor-group command.

Precautions

Each interface can be associated with only one route monitoring group.
Routes in a route monitoring group cannot be those generated by the IP address of an interface that has been associated with the route monitoring group.
If trigger-down-weight is not specified when an interface is associated with a route monitoring group, the interface goes down only if all the routes in the monitoring group are unavailable.

Example

# Associate GE 0/1/0 with a route monitoring group named group1, and set a weight value for the associated interface to automatically go Down to 100.

<HUAWEI> system-view
[~HUAWEI] ip route-monitor-group group1
[*HUAWEI-route-monitor-group-group1] track ip route 10.1.1.0 24 down-weight 100
[*HUAWEI-route-monitor-group-group1] track ip route 10.1.2.0 24 down-weight 100
[*HUAWEI-route-monitor-group-group1] monitor enable
[*HUAWEI-route-monitor-group-group1] commit
[~HUAWEI-route-monitor-group-group1] quit
[~HUAWEI] interface GigabitEthernet 0/1/0
[~HUAWEI-GigabitEthernet0/1/0] track route-monitor-group group1 trigger-down-weight 100