mpls te record-route (Tunnel interface view)

Function

The mpls te record-route command enables the route and label record function for a tunnel.

The undo mpls te record-route command restores the default setting.

This command varies in transport and router modes. For detailed differences, see Differences Between Commands in Transport and Router Modes. This topic describes the command configuration in router mode.

By default, the route and label record is disabled.

Format

mpls te record-route

mpls te record-route label

undo mpls te record-route

Parameters

Parameter	Description	Value
label	Enables the label record function.	-

Parameter

Description

Value

label

Enables the label record function.

Views

Tunnel interface view

Default Level

2: Configuration level

Task Name and Operations

Task Name	Operations
mpls-te	write

Usage Guidelines

Usage Scenario

If an MPLS TE tunnel is not established over an explicit path, the system does not record detailed path information. In this case, to view detailed path information about the tunnel, run the mpls te record-route command on a tunnel interface. After the configuration, RROs are carried in Path and Resv messages and record the IP address of each hop along the tunnel. In addition, the keyword label can be configured to record the label of each hop along the tunnel.

The route record function is automatically enabled in one of the following situations:

The mpls te backup hot-standby command is run to enable hot standby. The route record function that is automatically enabled helps prevent a primary tunnel and a hot-standby tunnel from sharing nodes.
The mpls te fast-reroute command is run to enable FRR. The route record function that is automatically enabled helps prevent a primary tunnel and a bypass tunnel from sharing nodes.
The mpls te bypass-tunnel command is run to configure a bypass tunnel. The route record function that is automatically enabled helps prevent a primary tunnel and a bypass tunnel to which the primary tunnel is bound from sharing nodes.

Configuration Impact

The mpls te record-route command enables the ingress to collect route and label information on a tunnel.

The ingress uses the collected information to determine the path for a hot-standby or FRR bypass tunnel.

After hot standby is enabled, the route record function provides information for the ingress, and the ingress determines whether or not a primary tunnel is bound to an FRR bypass tunnel.
After FRR is enabled, the route record function provides information for the ingress, and the ingress determines whether or not a primary tunnel is bound to a hot-standby tunnel.

Follow-up Procedure

The display mpls te tunnel path command can be run to display routes and labels associated with each hop along a TE tunnel.

Precautions

The undo mpls te record-route command must be run before the mpls te signal-protocol command is run.

Example

# Enable the route record function on an MPLS TE tunnel.

<HUAWEI> system-view
[~HUAWEI] mpls
[*HUAWEI-mpls] mpls te
[*HUAWEI-mpls] quit
[*HUAWEI] interface tunnel 1
[*HUAWEI-Tunnel1] tunnel-protocol mpls te
[*HUAWEI-Tunnel1] mpls te record-route