- Table of Contents
-
- 10-MPLS Command Reference
- 00-Preface
- 01-Basic MPLS commands
- 02-Static LSP commands
- 03-LDP commands
- 04-MPLS TE commands
- 05-Static CRLSP commands
- 06-RSVP commands
- 07-Tunnel policy commands
- 08-MPLS L3VPN commands
- 09-IPv6 MPLS L3VPN commands
- 10-MPLS L2VPN commands
- 11-VPLS commands
- 12-MPLS OAM commands
- 13-MCE commands
- Related Documents
-
Title | Size | Download |
---|---|---|
01-Basic MPLS commands | 292.30 KB |
display mpls color-mapping flex-algo
display mpls multicast-lsp protocol mldp p2mp
display mpls multicast-lsp statistics p2mp
mpls label-usage threshold-alarm percent
mpls-forwarding statistics prefix-list
snmp-agent trap enable mpls-private
Basic MPLS commands
display mpls color-mapping flex-algo
Use display mpls color-mapping flex-algo to display mapping relationships between color values and flexible algorithms.
Syntax
display mpls color-mapping flex-algo [ color value ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
color value: Specifies a color value in the range of 1 to 4294967295. If you do not specify this option, the command displays mapping relationships between all color values and flexible algorithms.
Examples
# Display mapping relationships between color values and flexible algorithms.
<Sysname> display mpls color-mapping flex-algo
Color Flex-Algo
1 128
2 129
3 128
4 130
Table 1 Command output
Field |
Description |
Color |
Color value. |
Flex-Algo |
Flexible algorithm ID. |
display mpls forwarding ilm
Use display mpls forwarding ilm to display Incoming Label Map (ILM) entries.
display mpls forwarding ilm [ label ] [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
label: Displays the ILM entry with the specified incoming label. The value range for this argument is 16 to 1048575. If you do not specify an incoming label, this command displays ILM entry information for all incoming labels.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays ILM entries on the active MPU.
Usage guidelines
An ILM entry records the label operation type, outgoing label, and other forwarding information.
After an LSR receives a labeled packet, it performs the following operations:
1. Identifies the ILM entry that matches the top label of the packet.
2. Performs the specified label operation.
3. Forwards the packet.
Examples
# Display all ILM entries.
<Sysname> display mpls forwarding ilm
Total ILM entries: 3
Flags: T - Forwarded through a tunnel
N - Forwarded through the outgoing interface to the nexthop IP address
B - Backup forwarding information
A - Active forwarding information
M – P2MP forwarding information
InLabel Oper VRF Flag SwapInfo Forwarding Info
--------------------------------------------------------------------------------
30 SWAP 0 T 1000 1024
1279 POP 0 - - -
1407 SWAP 0 NA 1271 GE1/0/3 50.2.0.2
NB 1270 Tun0 0.0.0.0
Table 2 Command output
Field |
Description |
Total ILM entries |
Total number of ILM entries. |
InLabel |
Incoming label. |
Oper |
Operation type: · POP—Pops the label. · POPGO—Pops the label and forwards the packet to another tunnel. · SWAP—Swaps the label. |
VRF |
Index of a VPN instance. |
Flag |
Forwarding flag: · T—Forwarded through a tunnel. · N—Forwarded through the outgoing interface to the next hop IP address. · B—Backup forwarding information. · A—Active forwarding information. · M—P2MP forwarding information. |
SwapInfo |
Outgoing label value. |
Forwarding Info |
Forwarding information: · When the forwarding flag is N, the forwarding information records the outgoing interface and the next hop. · When the forwarding flag is T, the forwarding information records the NID. |
display mpls forwarding nhlfe
Use display mpls forwarding nhlfe to display Next Hop Label Forwarding Entry (NHLFE) entries.
Syntax
display mpls forwarding nhlfe [ nid [ relation ] | tunnel-type { crlsp | gre | local | lsp | te } ] [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
nid: Displays the NHLFE entry with the specified NID. The NID value range is 0 to 4294967294. If you do not specify an NID, this command displays NHLFE entry information for all NIDs.
relation: Displays information about entries associated with the specified NHLFE entry.
tunnel-type: Display NHLFE entry information for the specified type of tunnels. If you do not specify this keyword, the command displays NHLFE entry information for all types of tunnels.
crlsp: Specifies static and RSVP CRLSPs.
gre: Specifies GRE tunnels.
local: Specifies LSPs of directly connected next hops.
lsp: Specifies static, LDP, and BGP LSPs.
te: Specifies tunnels of MPLS TE tunnel interfaces.
v2v: Specifies V2V tunnels.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays NHLFE entries on the active MPU.
Usage guidelines
An NHLFE entry records label forwarding information, such as the outgoing label and outgoing interface. NHLFE entries are mainly used to add multiple labels to packets.
To add multiple labels to a packet, an LSR performs the following operations:
1. Obtains the bottom label and NID in the matching FIB or ILM entry.
2. Obtains the outer label in the NHLFE entry identified by the NID.
Examples
# Display the NHLFE entry with NID 2048.
<Sysname> display mpls forwarding nhlfe 2048
Flags: T - Forwarded through a tunnel
N - Forwarded through the outgoing interface to the nexthop IP address
B - Backup forwarding information
A - Active forwarding information
M – P2MP forwarding information
S – Secondary backup path
NID Tnl-Type Flag OutLabel Forwarding Info
Attri-Val --------------------------------------------------------------------------------
2048 LSP NA 2025 GE1/0/2 10.11.112.26
# Display all NHLFE entries.
<Sysname> display mpls forwarding nhlfe
Total NHLFE entries: 6
Flags: T - Forwarded through a tunnel
N - Forwarded through the outgoing interface to the nexthop IP address
B - Backup forwarding information
A - Active forwarding information
M – P2MP forwarding information
S – Secondary backup path
NID Tnl-Type Flag OutLabel Forwarding Info
Attri-Val
--------------------------------------------------------------------------------
10 - TA - 2049
20 - TA - 2050
2048 LSP NA 2025 GE1/0/2 10.11.112.26
2049 LSP NA 3024 GE1/0/2 10.11.112.26
TB 3026 20
2050 LSP NA 3025 GE1/0/1 10.11.113.26
268435456 TE TA - 256
Tunnel0
Table 3 Command output
Field |
Description |
Total NHLFE entries |
Total number of NHLFE entries. |
NID |
NHLFE entry index. |
Tnl-Type |
Tunnel type: · LOCAL—Direct LSP tunnel. · LSP—Static LSP tunnel, or LSP tunnel signaled using LDP or BGP. · TE—TE tunnel. · GRE—GRE tunnel. · V2V—V2V tunnel. This field displays a hyphen (-) if the tunnel type is invalid. |
Flag |
Forwarding flag: · T—Forwarded through a tunnel. · N—Forwarded through the outgoing interface to the next hop IP address. · B—Backup forwarding information. · A—Active forwarding information. · M—P2MP forwarding information. · S—The second backup tunnel. |
OutLabel |
Outgoing label. |
Forwarding Info |
Forwarding information: · When the forwarding flag is N, the forwarding information records the outgoing interface and the next hop. · When the forwarding flag is T, the forwarding information records the NID. |
Attri-Val |
Forwarding attribute. This field displays tunnel interface name and is displayed only when the value for the Tnl-Type field is TE or GRE. |
display mpls interface
Use display mpls interface to display MPLS interface information, including the interface name, interface status, and interface MPLS MTU.
Syntax
display mpls interface [ interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type interface-number: Specifies an interface by the interface type and number. If you do not specify an interface, this command displays MPLS information for all MPLS-enabled interfaces except VA interfaces. For more information about VA interfaces, see PPPoE in Layer 2—WAN Access Configuration Guide.
Examples
# Display all MPLS interfaces.
<Sysname> display mpls interface
Interface Status MPLS MTU
GE1/0/1 Up 1500
GE1/0/2 Up 1500
Table 4 Command output
Field |
Description |
Interface |
Interface name. |
Status |
Interface state. |
MPLS MTU |
MPLS MTU (in bytes) of the interface. This field displays a hyphen (-) if the interface is not configured with an MPLS MTU. |
Related commands
mpls enable
mpls mtu
display mpls label
Use display mpls label to display MPLS label information.
Syntax
display mpls label { label-value1 [ to label-value2 ] | all } [ state { alloc | idle | inuse | pending } ] [ verbose ] [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
label-value1: Specifies a label value in the range of 16 to 1048575. If used with the label-value2 argument, the label-value1 argument represents the start label of a label range.
to label-value2: Specifies the end label of the label range. The value range for the end label is 16 to 1048575. If you specify a label range by using the label-value1 argument and the to label-value2 option, this command displays usage information for the specified range of labels.
all: Specifies all labels.
state: Displays information about MPLS labels in the specified state. If you do not specify this keyword, the command displays information about MPLS labels in all states.
alloc: Displays MPLS labels that are being requested.
idle: Displays idle MPLS labels.
inuse: Displays MPLS labels in use.
pending: Displays MPLS labels that have been released but are still in use.
verbose: Displays detailed MPLS label information. If you do not specify this keyword, this command displays brief MPLS label information.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays MPLS label information on the active MPU.
Examples
# Display brief information for labels 1025 through 1027.
<Sysname> display mpls label 1025 to 1027
Label Owner State
1025 LDP Alloc
1026 LDP Alloc
1027 LDP Inuse
# Display brief information about labels that are being requested and in the range of 1025 to 1027.
<Sysname> display mpls label 1025 to 1027 state alloc
Label Owner State
1025 LDP Alloc
1026 LDP Alloc
# Display detailed information for labels 1025 through 1027.
<Sysname> display mpls label 1025 to 1027 verbose
Label: 1025
State: Idle
Owner: -
FEC : -
Version: 0
Label: 1026
State: Idle
Owner: -
FEC : -
Version: 0
Label: 1027
State: Idle
Owner: -
FEC : -
Version: 0
Table 5 Command output
Field |
Description |
Label |
Label value. |
Owner |
Protocol that is using the label: · Static—Static LSP. · LDP. · BGP. · StaticCR—Static CRLSP. · RSVP. · L2VPN. · ISIS. · OSPF. · VSRP. · NAT. This field displays a hyphen (-) when the label state is Idle. |
State |
Usage state of the label: · Idle—The label is idle. · Alloc—The label has been allocated. · Pending—The label has been released but is still used by an LSP entry. · Inuse—The label has been allocated and used by an LSP entry. |
FEC |
Forwarding equivalence class, which can be one of the following forms: · IP address/mask—Classifies FECs by destination address. · IP address/mask/LSINDEX—Classifies FECs by label stack index. · IP address/In Label—The LSP is created through BGP Peer-Set-SID. · IP address—Classifies FECs by next hop. · IP address/Out Label—Classifies FECs by next hop and outgoing label. · Ingress LSR ID/Tunnel ID/LSP ID—RSVP TE FEC. If this field displays a hyphen (-), it indicates that the LSP is a static transit LSP, static egress LSP, static transit CRLSP, static egress CRLSP, or adjacency path for aggregate interface member ports. If this field displays Backup, it indicates that the LSP is a backup LSP of the previous LSP. |
Version |
Label version. |
display mpls lsp
Use display mpls lsp to display LSP information.
Syntax
display mpls lsp [ egress | in-label label-value | ingress | outgoing-interface interface-type interface-number | protocol { bgp | isis | ldp | local | ospf | rsvp-te | static | static-cr } | transit ] [ vpn-instance vpn-instance-name ] [ ipv4-address mask-length | ipv6 [ ipv6-address prefix-length ] ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
egress: Displays the LSPs taking the current LSR as egress.
in-label label-value: Displays the LSPs using the specified label as the incoming label. The value range for the label-value argument is 16 to 1048575.
ingress: Displays the LSPs taking the current LSR as ingress.
outgoing-interface interface-type interface-number: Displays the LSPs using the specified interface as the outgoing interface. The interface-type interface-number argument specifies an interface by its type and number.
protocol: Displays the LSPs established by a protocol.
bgp: Displays BGP LSPs.
ldp: Displays LDP LSPs.
local: Displays LSPs destined for the direct next hops, or displays LSPs that use the local MPLS TE tunnel interfaces or tunnel bundle interfaces as the LSP heads.
rsvp-te: Displays CRLSPs established by RSVP-TE.
static: Displays static LSPs.
static-cr: Displays static CRLSPs.
transit: Displays the LSPs taking the current LSR as a transit LSR.
vpn-instance vpn-instance-name: Displays LSPs for the specified MPLS L3VPN instance. The vpn-instance-name is a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays LSPs for the public network.
ipv4-address mask-length: Displays the IPv4 LSP for an FEC specified by an IPv4 address and a mask length. The value range for the mask length is 0 to 32.
ipv6: Displays IPv6 LSP information. If you do not specify this keyword, the command displays IPv4 LSP information.
ipv6-address prefix-length: Displays the IPv6 LSP for an FEC specified by an IPv6 address and a prefix length. The value range for the prefix length is 0 to 128.
verbose: Displays detailed LSP information. If you do not specify this keyword, the command displays brief LSP information.
Usage guidelines
If you do not specify any parameters, this command displays brief information about all LSPs. If you specify only the verbose keyword, this command displays detailed information about all LSPs.
Examples
# Display brief information about all IPv4 LSPs.
<Sysname> display mpls lsp
FEC Proto In/Out Label Out Inter/NHLFE/LSINDEX
100.100.100.100/24 LDP -/1049 GE1/0/1
Backup -/1050 GE1/0/2
100.100.100.10/24 LDP -/1051 GE1/0/3
Backup -/1050 GE1/0/2
100.100.100.10/24 LDP -/1049 GE1/0/4
101.100.100.10/24 LDP 1026/1049 GE1/0/1
102.100.100.10/24 LDP 1027/- -
103.100.100.10/24 LDP 1028/1049 Tunnel10
110.100.100.20/24 BGP -/1049 GE1/0/1
111.100.100.10/24 BGP 2028/1049 GE1/0/1
112.100.100.10/24 BGP 2029/- GE1/0/1
113.100.100.10/24 BGP 2030/1049 NHLFE1500
114.100.100.10/24 BGP 2031/1050 Tunnel100
100.100.100.100 Local -/- GE1/0/1
101.101.101.101/32 Static -/100 GE1/0/1
- Static 100/200 GE1/0/1
- Static 101/- GE1/0/1
200.200.200.200/64000/64000 RSVP -/1030 GE1/0/5
201.200.200.200/64000/64000 RSVP 1024/1031 GE1/0/5
202.200.200.200/64000/64000 RSVP 1025/- -
150.140.150.100/64001/0 StaticCR -/1000 GE1/0/5
- StaticCR 50/1001 GE1/0/5
- StaticCR 51/- -
Table 6 Command output
Field |
Description |
FEC |
Forwarding equivalence class: · IP address/mask—Classifies FECs by destination address. · IP address/mask/LSINDEX—Classifies FECs by label stack index. · IP address—Classifies FECs by next hop. · IP address/Out Label—Classifies FECs by next hop and outgoing label. · IP address/Color—Classifies FECs by destination address and color attribute. · NID—Classifies FECs by NID. · Ingress LSR ID/Tunnel ID/LSP ID—RSVP TE FEC. · IP address/mask (Flex-Algo ID)—Classifies FECs by destination address and flexible algorithm ID. · IP address/private data/VPN instance index—Classifies FECs by IP address, private data, and VPN instance index. · This field displays a hyphen (-) if the LSP is a static transit LSP, static egress LSP, static transit CRLSP, or static egress CRLSP. This field displays Backup if the LSP is a backup LSP of the primary LSP. This field displays SecondBackup if the LSP is the second backup LSP of the primary LSP. |
Proto |
Label distribution protocol: · LDP. · BGP. · RSVP. · Static. · StaticCR—Static CRLSP. · Local—LSP to a direct next hop, or LSP that uses a local MPLS TE tunnel interface or tunnel bundle interface as the LSP head. · RSVP-P2MP—P2MP CRLSP established by RSVP-TE. |
In/Out Label |
Incoming label/outgoing label. |
Out Inter/NHLFE/LSINDEX |
Outgoing interface name, NHLFE entry index, or label stack index of the LSP. NHLFEnumber specifies the ingress LSP selected for the current LSP after route recursion. The ingress LSP is the one that matches the NHLFE entry with an NID of number. LSINDEXnumber specifies the ingress LSP selected for the current LSP after route recursion. The ingress LSP is the one that matches the LSINDEX entry with a label stack index of number. |
# Display IPv6 LSP information.
<Sysname> display mpls lsp ipv6
FEC : 100:100:100:100:100:100:100:100/128
Protocol : BGP In-Label : 1200
Out-Label: 1300 Out-Interface: GE1/0/1
BkLabel : 1400 BkInterface : GE1/0/2
Table 7 Command output
Field |
Description |
FEC |
Forwarding equivalence class: · IP address/mask—Classifies FECs by destination address. · IP address—Classifies FECs by next hop. · IP address/Out Label—Classifies FECs by next hop and outgoing label. · Ingress LSR ID/Tunnel ID/LSP ID—RSVP TE FEC or static SRLSP FEC. This field displays a hyphen (-) if the LSP is a static transit LSP, static egress LSP, static transit CRLSP, or static egress CRLSP. |
Protocol |
Label distribution protocol: · LDP. · BGP. · RSVP. · Static. · StaticCR—Static CRLSP. · Local—LSP to a direct next hop, or LSP that uses a local MPLS TE tunnel interface or tunnel bundle interface as the LSP head. · RSVP-P2MP—P2MP CRLSP established by RSVP-TE. |
BkLabel |
Outgoing label of the backup LSP. |
BkInterface |
Outgoing interface of the backup LSP. |
# Display detailed information about all LSPs.
<Sysname> display mpls lsp verbose
Destination : 56.10.10.2
FEC : 56.10.10.2/32
Protocol : LDP
LSR Type : Egress
Service : Statistics
Create Time : 2021-07-05 11:44:06
Last Chg Time: 2021-07-05 11:44:06
In-Label : 1024
State : Active
Inbound Statistics:
Octets : 13000
Packets : 100
Errors : 0
Discards : 0
Destination : 56.10.10.4
FEC : 56.10.10.2/32
Protocol : LDP
LSR Type : Transit
Service : Statistics
Create Time : 2021-07-05 11:44:06
Last Chg Time: 2021-07-05 11:44:06
In-Label : 1026
Inbound Statistics:
Octets : 10600
Packets : 100
Errors : 0
Discards : 0
Path ID : 0x40000000.1
State : Active
Out-Label : 1800
Nexthop : 10.1.1.2
Out-Interface: GE1/0/1
BkLabel : 1900
BkNexthop : 20.1.1.2
BkInterface : GE1/0/2
Outbound Statistics:
Octets : 12600
Packets : 100
Errors : 0
Discards : 0
Destination : 56.10.10.4
FEC : 56.10.10.2/32
Protocol : LDP
LSR Type : Ingress
Service : -
Create Time : 2021-07-05 11:44:06
Last Chg Time: 2021-07-05 11:44:06
NHLFE ID : 2000
State : Active
Out-Label : 1800
Nexthop : 10.1.1.2
Out-Interface: GE1/0/1
Table 8 Command output
Field |
Description |
Destination |
LSP destination address. |
FEC |
Forwarding equivalence class: · IP address/mask—Classifies FECs by destination address. · IP address—Classifies FECs by next hop. · IP address/Out Label—Classifies FECs by next hop and outgoing label. · IP address/Color—Classifies FECs by destination address and color attribute. · NID—Classifies FECs by NID. · Ingress LSR ID/Tunnel ID/LSP ID—RSVP TE FEC. · IP address/mask (Flex-Algo ID)—Classifies FECs by destination address and flexible algorithm ID. · IP address/private data/VPN instance index—Classifies FECs by IP address, private data, and VPN instance index. This field displays a hyphen (-) if the LSP is a static transit LSP, static egress LSP, static transit CRLSP, or static egress CRLSP. |
Protocol |
Label distribution protocol: · LDP. · BGP (instance-name)—The instance-name specifies a BGP instance name. The value of default represents the default BGP instance. · RSVP. · Static. · StaticCR—Static CRLSP. · Local—LSP to a direct next hop, or LSP that uses a local MPLS TE tunnel interface or tunnel bundle interface as the LSP head. · RSVP-P2MP—P2MP CRLSP established by RSVP-TE. |
LSR Type |
LSR type: · Ingress—The current LSR is the ingress node of the LSP. · Transit—The current LSR is a transit node of the LSP. · Egress—The current LSR is the egress node of the LSP. |
Service |
Service deployed on the LSP. The service can only be Statistics, which indicates the MPLS forwarding statistics feature. |
Create Time |
Time when the LSP generated. |
Last Chg Time |
Time when the LSP changed most recently. |
Path ID |
Forwarding path. The value is in the format of 0xnn.m. The nn represents the NHLFE group ID of the outer LSPs that carry the current LSP, and m represents the sequence number of the equivalence path. |
NHLFE ID |
NHLFE entry index. |
State |
LSP state: · Active—The LSP is in use. · Inactive—The LSP is idle. |
Inbound Statistics |
MPLS forwarding statistics in inbound direction: · Octets—Number of received octets. · Packets—Number of received packets. · Errors—Number of received error packets. · Discards—Number of discarded packets. |
BkLabel |
Outgoing label of the backup LSP. |
BkNexthop |
Next hop address of the backup LSP. |
BkInterface |
Outgoing interface of the backup LSP. |
SBKOut interface |
Outgoing interface of the second backup LSP. |
BkLsIndex |
Label stack index of the backup LSP. |
Outbound Statistics |
MPLS forwarding statistics in outbound direction: · Octets—Number of sent octets. · Packets—Number of sent packets. · Errors—Number of error packets. · Discards—Number of discarded packets. |
Related commands
display mpls lsp statistics
display mpls lsp statistics
Use display mpls lsp statistics to display LSP statistics.
Syntax
display mpls lsp statistics [ ipv6 ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
ipv6: Displays IPv6 LSP statistics. If you do not specify this keyword, the command displays IPv4 LSP statistics.
Examples
# Display IPv4 LSP statistics.
<Sysname> display mpls lsp statistics
LSP Type Ingress/Transit/Egress Active
Static LSP 0/0/0 0/0/0
Static CRLSP 0/0/0 0/0/0
LDP LSP 2/2/1 2/2/1
RSVP CRLSP 0/0/0 0/0/0
BGP LSP 0/0/0 0/0/0
Local LSP 2/0/0 2/0/0
ISIS LSP 0/0/0 0/0/0
OSPF LSP 0/0/0 0/0/0
SR LSP 0/0/0 0/0/0
SR Policy LSP 0/0/0 0/0/0
-----------------------------------------------------
Total 4/2/1 4/2/1
# Display IPv6 LSP statistics.
<Sysname> display mpls lsp statistics ipv6
LSP Type Ingress/Transit/Egress Active
Static LSP 0/0/0 0/0/0
Static CRLSP 0/0/0 0/0/0
LDP LSP 6/6/2 6/6/2
RSVP CRLSP 0/0/0 0/0/0
BGP LSP 0/0/0 0/0/0
Local LSP 2/0/0 2/0/0
ISIS LSP 0/0/0 0/0/0
OSPF LSP 0/0/0 0/0/0
SR LSP 0/0/0 0/0/0
SR Policy LSP 0/0/0 0/0/0
-----------------------------------------------------
Total 8/6/2 8/6/2
Table 9 Command output
Field |
Description |
LSP Type |
LSP types: · Static LSP. · Static CRLSP—Static CRLSP. · LDP LSP. · Local LSP—LSP to a direct next hop, or LSP that uses a local MPLS TE tunnel interface or tunnel bundle interface as the LSP head. · RSVP CRLSP. · BGP LSP. · (Not supported.) IS-IS. · (Not supported.) OSPF. · (Not supported.) SR LSP—Dynamic SRLSPs established by SR and stateful PCE. · (Not supported.) SR Policy LSP—SRLSP established by SR-MPLS TE policies. |
Total |
Total number of LSPs. |
Ingress |
Number of LSPs that take the local device as the ingress node. |
Transit |
Number of LSPs that take the local device as a transit node. |
Egress |
Number of LSPs that take the local device as the egress node. |
Active |
Number of active LSPs of a type. |
display mpls multicast-lsp protocol mldp p2mp
Use display mpls multicast-lsp protocol mldp p2mp to display information about P2MP LSPs signaled by using mLDP.
Syntax
display mpls multicast-lsp protocol mldp p2mp [ root-ip ip-address { lsp-id lsp-id | opaque-value opaque-value } ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
root-ip ip-address: Specifies the root IP address of the P2MP LSPs to be displayed. If you do not specify this option, the command displays information about all P2MP LSPs signaled by using mLDP.
lsp-id lsp-id: Specifies the LSP ID of the P2MP LSPs to be displayed. The value range for the lsp-id argument is 0 to 4294967295.
opaque-value opaque-value: Specifies the opaque value of the P2MP LSPs to be displayed. The opaque-value argument is a hexadecimal string of 1 to 255 characters.
Examples
# Display information about all mLDP-signaled P2MP LSPs.
<Sysname> display mpls multicast-lsp protocol mldp p2mp
Root IP : 1.1.1.1
Opaque value : 01000400000001
Tunnel ID : 1
Protocol : mLDP
LSR type : Ingress
NHLFE ID : 2000
State : Active
Out label : 1800
Nexthop : 10.1.1.2
Out interface: GE1/0/1
Root IP : 1.1.1.9
Opaque value : 010004e4000000
Tunnel ID : 1
Protocol : mLDP
LSR type : Transit
In label : 1279
Path ID : 0x250000002.1
State : Active
Out label : 1279
Nexthop : 20.1.1.2
Out interface: GE1/0/2
Table 10 Command output
Field |
Description |
Root IP |
IP address of the root node of the mLDP P2MP LSPs. |
Opaque value |
Original opaque value in the mLDP protocol packet. |
Tunnel ID |
ID of the mLDP P2MP tunnel. |
Protocol |
Signaling protocol. The value of this field is mLDP, which indicates that the LSP is a P2MP LSP signaled by using mLDP. |
LSR type |
LSR type: · Ingress—Ingress node. · Transit—Transit node. · Egress—Egress node. · Bud—Both transit and egress nodes. |
In label |
Incoming label. |
Path ID |
Forwarding path. The value is in the format of 0xnn.m. nn represents the NHLFE group ID of the outer LSPs that carry the current LSP, and m represents the sequence number of the equivalence path. |
NHLFE ID |
NHLFE entry index. |
State |
LSP state: · Active. · Inactive. |
Out label |
Outgoing label. |
Nexthop |
Next hop address. |
Out interface |
Outgoing interface. |
Related commands
display mpls multicast-lsp statistics p2mp
display mpls multicast-lsp statistics p2mp
Use display mpls multicast-lsp statistics p2mp to display P2MP LSP statistics.
Syntax
display mpls multicast-lsp statistics p2mp
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display P2MP LSP statistics.
<Sysname> display mpls multicast-lsp statistics p2mp
LSP type Ingress/Transit/Egress/Bud Active
mLDP LSP 1/0/0/0 1/0/0/0
-----------------------------------------------------
Total 1/0/0/0 1/0/0/0
Table 11 Command output
Field |
Description |
LSP Type |
LSP type. The value of this field is mLDP, which indicates that the LSP is signaled by using mLDP. |
Total |
Total number of LSPs. |
Ingress |
Number of LSPs that use the local device as the ingress node. |
Transit |
Number of LSPs that use the local device as a transit node. |
Egress |
Number of LSPs that use the local device as the egress node. |
Bud |
Number of LSPs that use the local device as both transit and egress nodes. |
Active |
Total number of active LSPs. |
Related commands
display mpls lsp statistics
display mpls nib
Use display mpls nib to display MPLS Nexthop Information Base (NIB) information.
Syntax
display mpls nib [ nib-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
nib-id: Specifies a next hop ID in the range of 1 to FFFFFFFFFFFFFFFE. If you do not specify a next hop, this command displays information about all MPLS next hops.
Examples
# Display information about all MPLS next hops.
<Sysname> display mpls nib
NIB ID: 0x40000000
Users: 1
Status: Active
ECMP number: 1
Outgoing NHLFE ID: 1024
Backup outgoing NHLFE ID: 1027
Table 12 Command output
Field |
Description |
NIB ID |
ID of the next hop. |
Users |
Number of ILM entries that use this next hop. |
Status |
Next hop status: · Active—The next hop is active. · Dummy—The next hop is inactive. |
ECMP number |
Number of equal-cost NHLFE entries. |
Outgoing NHLFE ID |
ID of the NHLFE entry to which the next hop corresponds. |
Backup outgoing NHLFE ID |
ID of the backup NHLFE entry. |
display mpls nid
Use display mpls nid to display usage information for NIDs.
Syntax
display mpls nid [ nid-value1 [ to nid-value2 ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
nid-value1: Specifies an NID in the range of 0 to 65535. If used with the nid-value2 argument, the nid-value1 argument represents the start NID of an NID range.
to nid-value2: Specifies the end NID of the NID range. The value range for the end NID is 0 to 65535. If you specify an NID range by using the nid-value1 argument and the to nid-value2 option, this command displays usage information for the specified range of NIDs.
Usage guidelines
NIDs are 32-bit binary numbers. They include fixed NIDs and dynamic NIDs.
· Fixed NIDs—Generated for tunnel interfaces or tunnel bundle interfaces. The highest four bits are a value other than 0000.
· Dynamic NIDs—NIDs except fixed NIDs. The highest four bits are 0s.
This command displays usage information only for dynamic NIDs.
If you do not specify any parameters, this command displays usage information for all dynamic NIDs.
Examples
# Display usage information for dynamic NIDs 1028 through 1500.
<Sysname> display mpls nid 1028 to 1500
NID alloc state: '.' means not used, '$' means used
1028 :...$.... ........ ........ ........ ........ ........ ........ ........
1092 :........ ........ ........ ........ ........ ........ ........ ........
1156 :........ ........ ........ ........ ........ ........ ........ ........
1220 :........ ........ ........ ........ ........ ........ ........ ........
1284 :........ ........ ........ ........ ........ ........ ........ ........
1348 :........ ........ ........ ........ ........ ........ ........ ........
1412 :........ ........ ........ ........ ........ ........ ........ ........
1476 :........ ........ ........ .
display mpls summary
Use display mpls summary to display MPLS summary information.
Syntax
display mpls summary
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display MPLS summary information.
<Sysname> display mpls summary
MPLS LSR ID : 1.1.1.1
Egress Label Type: Implicit-null
Labels:
Range Idle Owner
16-14999 14984 Static
StaticCR
StaticPW
Static SR Adj
15000-15999(default SRLB) 1000 Default SR Adj
16000-55999(default SRGB, reusable) 40000 Default SR Prefix
25000-27000(SRGB) 2001 ISIS-1 SR Prefix
56000-88888 32889 LDP
RSVP
BGP
BGP SR EPE
OSPF SR Adj
ISIS SR Adj
VPWS
VPLS
100000-200000(global SRGB, reusable) 100001 SR Prefix
210000-220000(global SRLB) 10001 SR Adj
Protocols:
Type State
LDP Normal
RSVP Normal
BGP(default) Normal
Static Normal
CCC Normal
StaticCR Normal
Local Normal
BGP(xy) Normal
BGP(abc) Normal
mLDP Normal
Table 13 Command output
Field |
Description |
Egress Label Type |
Label type that the egress node assigns to the penultimate hop: · Implicit-null. · Explicit-null. · Non-null. |
Labels |
Label information. |
Range |
Label range. · If labels within the label range can be reused, this field displays (reusable) behind the label range. · If the default label range is used, this field displays (default) behind the label range. · If the configured global label range is used, this field displays (global) behind the label range. · If the label range is the SRGB range, this field displays (SRGB) behind the label range. · If the label range is the SRLB range, this field displays (SRLB) behind the label range. |
Idle |
Number of idle labels in the label range. |
Owner |
Label range owner. · LDP. · BGP. · RSVP. · Static—Static LSP. · StaticCR—Static CRLSP. · StaticPW—Static PW. · Static SR Adj—Static SR adjacency SID. · Default SR Adj—Default SR adjacency SID. · SR Adj—Configured global SR adjacency SID. · Default SR Prefix—Default SR prefix SID. · SR Prefix—Configured global SR prefix SID. · OSPF SR Adj—SR adjacency SID automatically allocated to OSPF. · ISIS SR Adj—SR adjacency SID automatically allocated to IS-IS. · ISIS-1 SR Prefix—SR prefix SID of IS-IS process 1. · OSPF-1 SR Prefix—SR prefix SID of OSPF process 1. · VPWS. · VPLS. · BGP SR EPE—BGP PeerNode SID, PeerAdj SID, or PeerSet SID. · VRF—Label range specified for all VPN instances. |
Protocols |
Label distribution protocols that generated LSPs and their running states. |
Type |
Protocol type: · LDP. · mLDP. · BGP (instance-name). The instance-name specifies a BGP instance name. The value of default represents the default BGP instance. · RSVP. · Static—Static LSP. · StaticCR—Static CRLSP. · TE. · CCC. · ISIS. · OSPF. |
State |
Label distribution protocol running state: · Normal—The protocol is in normal state. · Recover—The protocol is in the GR process. |
ftn enable
Use ftn enable to enable the device to maintain FEC-to-NHLFE map (FTN) entries in the RIB.
Use undo ftn enable to disable the device to maintain FTN entries in the RIB.
Syntax
ftn enable
undo ftn enable
Default
The device does not maintain FTN entries in the RIB.
Views
RIB IPv4 address family view
Predefined user roles
network-admin
Usage guidelines
FTN entries are FIB entries that contain outgoing labels. When an LSR receives an unlabeled packet, it searches the corresponding FTN entry based on the destination IP address. If a match is found, the LSR adds the outgoing label in the FTN entry to the packet and forwards the labeled packet.
For the device to collect FTN forwarding statistics, you must execute the ftn enable command first, and then use the mpls-forwarding statistics prefix-list command to enable FTN forwarding statistics.
Examples
# Enable the device to maintain FTN entries in the RIB.
<Sysname> system-view
[Sysname] rib
[system-rib] address-family ipv4
[system-rib-ipv4] ftn enable
mpls-forwarding statistics prefix-list
mpls bandwidth-based-sharing
Use mpls bandwidth-based-sharing to enable bandwidth-based load sharing on an MPLS transit node.
Use undo mpls bandwidth-based-sharing to disable bandwidth-based load sharing on an MPLS transit node.
Syntax
mpls bandwidth-based-sharing
undo mpls bandwidth-based-sharing
Default
Bandwidth-based load sharing is disabled on an MPLS transit node.
Views
System view
Predefined user roles
network-admin
Usage guidelines
If equal-cost LDP LSPs exist on a transit node, the node evenly transmits MPLS packets through the LSPs. After you enable this feature, MPLS packets are transmitted through the LSPs in the proportion calculated based on the bandwidth of the egress interfaces.
Examples
# Enable bandwidth-based load sharing on an MPLS transit node.
<Sysname> system-view
[Sysname] mpls bandwidth-based-sharing
mpls enable
Use mpls enable to enable MPLS on an interface.
Use undo mpls enable to disable MPLS on an interface.
Syntax
mpls enable
undo mpls enable
Default
MPLS is disabled on an interface.
Views
Interface view
Predefined user roles
network-admin
Examples
# Enable MPLS on GigabitEthernet 1/0/1.
<Sysname> System-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] mpls enable
Related commands
display mpls interface
mpls forwarding split-horizon
Use mpls forwarding split-horizon to enable split horizon for MPLS forwarding.
Use undo mpls forwarding split-horizon to disable split horizon for MPLS forwarding.
Syntax
mpls forwarding split-horizon
undo mpls forwarding split-horizon
Default
Split horizon is disabled for MPLS forwarding.
Views
System view
Predefined user roles
network-admin
Examples
# Enable split horizon for MPLS forwarding.
<Sysname> system-view
[Sysname] mpls forwarding split-horizon
mpls label advertise
Use mpls label advertise to specify the type of label the egress node will advertise to the penultimate hop.
Use undo mpls label advertise to restore the default.
Syntax
mpls label advertise { explicit-null | implicit-null | non-null }
undo mpls label advertise
Default
As egress, the device advertises an implicit null label to the penultimate hop.
Views
System view
Predefined user roles
network-admin
Parameters
explicit-null: Specifies the egress node to advertise an explicit null label of 0 or 2 to the penultimate hop. The explicit null label value is 0 in IPv4 networks and 2 in IPv6 networks.
implicit-null: Specifies the egress node to advertise an implicit null label of 3 to the penultimate hop.
non-null: Specifies the egress node to advertise a non-null label to the penultimate hop.
Usage guidelines
As a best practice, configure the egress node to advertise an implicit null label to the penultimate hop if the penultimate hop supports PHP.
If you want to simplify packet forwarding on egress but keep labels to determine QoS policies, configure the egress node to advertise an explicit null label to the penultimate hop.
Use non-null labels only in particular scenarios. For example, when OAM is configured on the egress node, the egress node can get the OAM function entity status only through non-null labels.
As a penultimate hop, the device accepts the implicit null label, explicit null label, or non-null label advertised by the egress node.
For LDP LSPs, the mpls label advertise command triggers LDP to delete the LSPs established before the command is executed and re-establishes new LSPs.
For BGP LSPs, the mpls label advertise command takes effect only on the BGP LSPs established after the command is executed. To apply the new setting to BGP LSPs established before the command is executed, delete the routes corresponding to the BGP LSPs, and then redistribute the routes.
Examples
# Configure the egress node to advertise an implicit null label to the penultimate hop.
<Sysname> system-view
[Sysname] mpls label advertise implicit-null
Related commands
reset mpls ldp
mpls label range
Use mpls label range to set the value range for dynamic labels that the device can allocate.
Use undo mpls label range to restore the default.
Syntax
mpls label range minimum maximum
undo mpls label range
Default
The value range for dynamic labels that the device can allocate is not configured.
Views
System view
Predefined user roles
network-admin
Parameters
minimum: Specifies the minimum label value that the device can allocate. The value range for this argument is 15000 to 1048574.
maximum: Specifies the maximum label value that the device can allocate. The value range for this argument is 15001 to 1048575.
Usage guidelines
This command sets the value range in which label distribution protocols can dynamically allocate labels.
This command does not take effect on static LSP labels, static CRLSP labels, or static PW labels. For more information about static LSP labels, see "Configuring a static LSP." For more information about static CRLSP labels, see "Configuring a static CRLSP." For more information about static PW labels, see "Configuring VPLS" and "Configuring MPLS L2VPN."
If you configure this command multiple times, the most recent configuration takes effect.
Examples
# Set the value range to 10000 to 15000 for dynamic labels that the device can allocate.
<Sysname> system-view
[Sysname] mpls label range 10000 15000
mpls label-block
Use mpls label-block to configure an MPLS label block.
Use undo mpls label-block to delete an MPLS label block.
Syntax
mpls label-block name name range minimum-label maximum-label
undo mpls label-block name name
Default
No MPLS label block is configured.
Views
System view
Predefined user roles
network-admin
Parameters
name name: Specifies a name for the MPLS label block, a case-sensitive string of 1 to 127 characters.
range: Specifies the range of labels of the MPLS label block.
minimum-label: Minimum label value of the MPLS label block. The value range for this argument is 15000 to 1048574.
maximum-label: Maximum label value of the MPLS label block. The value range for this argument is 15000 to 1048574.
Usage guidelines
An MPLS label block configured by using this command can be used by the SRLB and SRGBs, so IGP and BGP use the labels within the MPLS label block.
If an MPLS label block has been used, you cannot delete the MPLS label block.
If you configure MPLS label blocks with the same name multiple times, the most recent configuration takes effect.
MPLS label blocks with different names cannot contain overlapping label values.
Examples
# Configure an MPLS label block named srgb, and specify its label range as 10000 to 15000.
<Sysname> system-view
[Sysname] mpls label-block name srgb range 10000 15000
mpls label-usage threshold-alarm percent
Use mpls label-usage threshold-alarm percent to set alarm thresholds for MPLS label usage.
Use undo mpls label-usage threshold-alarm percent to restore the default.
Syntax
mpls label-usage threshold-alarm percent { dynamic | egress | egress6 | l3vpn | srgb | srlb |static | vpls | vpws } upper-limit upper-percent lower-limit lower-percent
undo mpls label-usage threshold-alarm percent { dynamic | egress | egress6 | l3vpn | srgb | srlb | static | vpls | vpws }
Default
The usage alarm upper threshold is 80% and lower threshold is 70% for all types of MPLS labels.
Views
System view
Predefined user roles
network-admin
Parameters
dynamic: Specifies dynamic allocated MPLS labels.
egress: Specifies egress MPLS labels (labels allocated to egress LSPs).
egress6: Specifies IPv6 egress MPLS labels (labels allocated to IPv6 egress LSPs).
l3vpn: Specifies L3VPN MPLS labels (labels allocated to MPLS L3VPN).
srgb: Specifies SRGB MPLS labels (labels allocated to SRGB).
srlb: Specifies SRLB MPLS labels (labels allocated to SRLB).
static: Specifies statically configured MPLS labels.
vpls: Specifies VPLS MPLS labels (labels allocated to VPLS).
vpws: Specifies VPWS MPLS labels (labels allocated to VPWS).
upper-limit upper-percent: Specifies the upper threshold for MPLS label usage, in the range of 1% to 99%.
lower-limit lower-percent: Specifies the lower threshold for MPLS label usage, in the range of 1% to 99%.
Usage guidelines
After SNMP notifications for MPLS label usage are enabled, the device generates a notification when MPLS label usage exceeds the upper threshold or drops below the lower threshold. To enable SNMP notifications for MPLS label usage, use the snmp-agent trap enable mpls-private label-threshold command.
The MPLS label usage upper threshold must be greater than the lower threshold.
Examples
# Set the usage alarm upper threshold to 90% and lower threshold to 80% for dynamic MPLS labels.
<Sysname> system-view
[Sysname] mpls label-usage threshold-alarm percent dynamic upper-limit 90 lower-limit 80
Related commands
snmp-agent trap enable mpls-private
mpls load-sharing mode
Use mpls load-sharing mode to configure an MPLS load sharing mode.
Use undo mpls load-sharing mode to restore the default.
Syntax
mpls load-sharing mode { per-flow { label | ip } | per-packet }
undo mpls load-sharing mode
Views
System view
Default
No MPLS load sharing mode is configured.
Predefined user roles
network-admin
Parameters
per-flow: Enables per-flow load sharing.
label: Enables per-flow load sharing based on labels.
ip: Enables per-flow load sharing based on IP information.
per-packet: Enables per-packet load sharing.
Usage guidelines
The device supports the following MPLS load sharing modes:
· Per-flow load sharing based on labels
¡ If the label stack in packets contains five or less MPLS labels:
- For MPLS packets carrying IP packets, the device performs load sharing based on the destination IP, source IP, destination port, source port, protocol number, and the ToS field in the IP packets.
- For MPLS packets carrying TCP and UDP packets, the device performs load sharing based on the destination IP, source IP, protocol number, and the ToS field in the IP packets.
- For MPLS packets carrying non-IP packets, the device performs load sharing based on all MPLS labels in the packets.
¡ If the label stack in packets contains more than five MPLS labels, the device performs load sharing based on the outmost five MPLS labels.
· Per-flow load sharing based on IP information
¡ If the label stack in packets contains five or less MPLS labels, the device performs load sharing based on the five tuples of packets.
¡ If the label stack in packets contains more than five MPLS labels, the device performs load sharing based on the outmost five MPLS labels.
· Per-packet load sharing—Uses a polling method to select a path for fowarding each packet in turn according to the packet arrival order.
Examples
# Enable per-flow load sharing based on labels.
<Sysname> system-view
[Sysname] mpls load-sharing mode per-flow label
Related commands
flow-label (MPLS L2VPN)
flow-label (VPLS)
mpls lsr-id
Use mpls lsr-id to configure an LSR ID for the local LSR.
Use undo mpls lsr-id to restore the default.
Syntax
mpls lsr-id lsr-id
undo mpls lsr-id
Default
An LSR has no LSR ID.
Views
System view
Predefined user roles
network-admin
Parameters
lsr-id: Specifies an ID for identifying the LSR, in dotted decimal notation.
Usage guidelines
As a best practice, use the address of a loopback interface on the LSR as the LSR ID.
If no LDP LSR ID is configured for the public network or a VPN instance, LDP uses the MPLS LSR ID configured by the mpls lsr-id command. If you modify the MPLS LSR ID, the LDP sessions in the public network or VPN instance will be re-established. To configure an LDP LSR ID for the public network or a VPN instance, use the lsr-id command in LDP view or LDP-VPN instance view.
Examples
# Configure the LSR ID as 3.3.3.3 for the local node.
<Sysname> system-view
[Sysname] mpls lsr-id 3.3.3.3
# Change the LSR ID to 4.4.4.4.
[Sysname] mpls lsr-id 4.4.4.4
All LDP sessions using the MPLS LSR ID will be reset. Continue? [Y/N]:Y
Related commands
lsr-id
mpls mtu
Use mpls mtu to set the MPLS MTU for an interface.
Use undo mpls mtu to restore the default.
Syntax
mpls mtu size
undo mpls mtu
Default
The MPLS MTU of an interface is not configured. Fragmentation for MPLS packets is based on the MTU set on the interface by the ip mtu command. If no MTU is set by the ip mtu command, the fragmentation is based on the MTU of the interface. The length of a fragment does not include that of the MPLS label. Thus, after an MPLS label is added into a fragment, the length of the MPLS fragment might exceed the interface MTU.
If the peer interface cannot receive packets larger than the IP MTU, set the MPLS MTU of the local interface to be smaller than the IP MTU to ensure normal packet forwarding.
Views
Interface view
Predefined user roles
network-admin
Parameters
size: Specifies the MPLS MTU of the interface, in the range of 46 to 65535 bytes.
Usage guidelines
This command is effective only when MPLS is enabled on the interface.
If the MPLS MTU is larger than the interface MTU, data forwarding might fail.
MPLS TE tunnel interfaces do not support this command.
Examples
# Set the MPLS MTU of GigabitEthernet 1/0/1 to 1000 bytes.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] mpls enable
[Sysname-GigabitEthernet1/0/1] mpls mtu 1000
Related commands
display mpls interface
mpls statistics
Use mpls statistics to enable MPLS label forwarding statistics for LSPs.
Use undo mpls statistics to disable MPLS label forwarding statistics for LSPs.
Syntax
mpls statistics { all | [ vpn-instance vpn-instance-name ] { ipv4 ipv4-address mask-length | ipv6 ipv6-address prefix-length } | static | te ingress-lsr-id tunnel-id }
undo mpls statistics { all | [ vpn-instance vpn-instance-name ] { ipv4 ipv4-address mask-length | ipv6 ipv6-address prefix-length } | static | te ingress-lsr-id tunnel-id }
Default
MPLS label forwarding statistics are disabled for all LSPs.
Views
System view
Predefined user roles
network-admin
Parameters
all: Specifies all LSPs.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command enables MPLS forwarding statistics for public LSPs.
ipv4 ipv4-address mask-length: Specifies the IPv4 LSP for an FEC specified by an IPv4 address and a mask length. The mask length is in the range of 0 to 32.
ipv6 ipv6-address prefix-length: Specifies the BGP-IPv6 LSP for an FEC specified by an IPv6 address and a prefix length. The prefix length is in the range of 0 to 128.
static: Specifies static LSPs and static CRLSPs.
te ingress-lsr-id tunnel-id: Specifies an RSVP-TE tunnel. The ingress-lsr-id represents the LSR ID of the ingress node of the tunnel. The tunnel-id argument represents the ID of the tunnel. The value range for the tunnel-id argument is 0 to 20479. If you specify this option, the device automatically sets the MPLS label forwarding statistics collection interval to 30 seconds.
Usage guidelines
MPLS label forwarding forwards a labeled packet based on its incoming label. MPLS label forwarding statistics is enabled by this command.
FTN forwarding adds a label to an unlabeled packet, and forwards the labeled packet. FTN forwarding statistics collection is enabled by the mpls-forwarding statistics prefix-list command in RIB IPv4 address family view.
To display MPLS label forwarding statistics for the specified LSPs by using the display mpls lsp verbose command, you must perform the following tasks:
· Use the mpls statistics command to enable the MPLS label forwarding statistics feature for the LSPs.
· Use the mpls statistics interval command to set the MPLS label forwarding statistics collection interval.
If you specify the te ingress-lsr-id tunnel-id option in the mpls statistics command, the MPLS label forwarding statistics collection interval is automatically set to 30 seconds. If you also execute the mpls statistics interval command, the interval set by the mpls statistics interval command takes effect.
The execution of the mpls statistics enable command on a PE enables MPLS label forwarding statistics for a VPN instance and for all LSPs in the VPN instance. For more information about enabling MPLS label forwarding statistics for a VPN instance, see the MPLS L3VPN configuration in MPLS Configuration Guide.
The undo mpls statistics all command cannot disable MPLS label forwarding statistics for a VPN instance or a protocol after the mpls statistics command is executed with the vpn-instance, ipv4, ipv6, static, or te keyword specified. To disable MPLS label forwarding statistics for the VPN instance or protocol, execute the undo mpls statistics command with the vpn-instance, ipv4, ipv6, static, or te keyword specified.
Examples
# Enable MPLS label forwarding statistics for the LSP destined for 2.2.2.2/32.
<Sysname> system-view
[Sysname] mpls statistics ipv4 2.2.2.2 32
Related commands
display mpls lsp verbose
mpls statistics interval
reset mpls statistics
mpls statistics interval
Use mpls statistics interval to set the MPLS label forwarding statistics collection interval.
Use undo mpls statistics interval to delete the MPLS label forwarding statistics collection interval.
Syntax
mpls statistics interval interval
undo mpls statistics interval
Default
The MPLS forwarding statistics collection interval is not set.
Views
System view
Predefined user roles
network-admin
Parameters
interval: Specifies the MPLS label forwarding statistics collection interval, in the range of 30 to 65535 seconds.
Usage guidelines
To display MPLS label forwarding statistics for the specified LSPs by using the display mpls lsp verbose command, you must perform the following tasks:
· Use the mpls statistics command to enable the MPLS label forwarding statistics feature for the LSPs.
· Use the mpls statistics interval command to set the MPLS label forwarding statistics collection interval.
If you specify the te ingress-lsr-id tunnel-id option in the mpls statistics command, the MPLS label forwarding statistics collection interval is automatically set to 30 seconds. If you also execute the mpls statistics interval command, the interval set by the mpls statistics interval command takes effect.
Examples
# Set the MPLS label forwarding statistics collection interval to 30 seconds.
<Sysname> system-view
[Sysname] mpls statistics interval 30
Related commands
display ip vpn-instance mpls statistics
display mpls lsp verbose
mpls statistics
mpls statistics enable
reset ip vpn-instance mpls statistics
reset mpls statistics
mpls ttl expiration enable
Use mpls ttl expiration enable to enable sending MPLS TTL-expired messages.
Use undo mpls ttl expiration enable to disable sending MPLS TTL-expired messages.
Syntax
mpls ttl expiration enable
undo mpls ttl expiration enable
Default
The MPLS TTL-expired messages sending feature is enabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
This command enables an LSR to generate an ICMP TTL-expired message upon receiving an MPLS packet with TTL being 1.
· If the MPLS packet has only one label, the LSR sends the ICMP TTL-expired message back to the source through IP routing.
· If the MPLS packet has multiple labels, the LSR forwards the ICMP TTL-expired message along the LSP of the MPLS packet to the egress node. Then, the egress node sends the message back to the source.
Examples
# Disable sending MPLS TTL-expired messages.
<Sysname> system-view
[Sysname] undo mpls ttl expiration enable
mpls ttl propagate
Use mpls ttl propagate to enable TTL propagation.
Use undo mpls ttl propagate to disable TTL propagation.
Syntax
mpls ttl propagate { public | vpn }
undo mpls ttl propagate { public | vpn }
Default
TTL propagation is enabled for public network packets and is disabled for VPN packets.
Views
System view
Predefined user roles
network-admin
Parameters
public: Specifies public network packets.
vpn: Specifies VPN packets.
Usage guidelines
When TTL propagation is enabled, MPLS performs the following operations:
· Copies the IP TTL to the label TTL for packets entering the MPLS network.
· Copies the label TTL to the IP TTL for packets leaving the MPLS network.
If you enable TTL propagation on both ingress and egress, the IP tracert facility can show the real path in the MPLS network.
When TTL propagation is disabled, MPLS performs the following operations:
· Sets the label TTL to 255 for packets entering the MPLS network.
· Pops the label for packets leaving the MPLS network, without copying the label TTL value to the IP TTL.
The IP tracert facility cannot show the real path in the MPLS network.
Within an MPLS network, TTL is always copied between the labels of an MPLS packet. The mpls ttl propagate command affects only the propagation between IP TTL and label TTL.
As a best practice, set the same TTL processing mode on all LSRs of an LSP.
To enable TTL propagation for a VPN, you must enable it on all PE devices in the VPN. This allows you to obtain the same traceroute result (hop count) from those PEs.
Examples
# Enable TTL propagation for VPN packets.
<Sysname> system-view
[Sysname] mpls ttl propagate vpn
mpls-forwarding statistics prefix-list
Use mpls-forwarding statistics prefix-list to enable FTN forwarding statistics for a destination network.
Use undo mpls-forwarding statistics prefix-list to disable FTN forwarding statistics for a destination network.
Syntax
mpls-forwarding statistics prefix-list prefix-list-name
undo mpls-forwarding statistics prefix-list prefix-list-name
Default
FTN forwarding statistics are disabled for all destination networks.
Views
RIB IPv4 address family view
Predefined user roles
network-admin
Parameter
prefix-list-name: Specifies an IPv4 address prefix list, a case-sensitive string of 1 to 63 characters. This command applies only to the destination networks that permitted by the prefix list.
Usage guidelines
FTN forwarding adds a label to an unlabeled packet, and forwards the labeled packet. FTN forwarding statistics collection is enabled by this command.
MPLS label forwarding forwards a labeled packet based on its incoming label. MPLS label forwarding statistics collection is enabled by the mpls statistics command.
Before executing this command, use the ftn enable command to enable the device to maintain FTN entries in the RIB.
Examples
# Enable FTN forwarding statistics for destination network 2.2.2.0/24.
<Sysname> system-view
[Sysname] ip prefix-list abc permit 2.2.2.0 24
[Sysname] rib
[system-rib] address-family ipv4
[system-rib-ipv4] ftn enable
[system-rib-ipv4] mpls-forwarding statistics prefix-list abc
Related commands
ftn enable
mpls statistics
mpls statistics interval
reset mpls statistics
Use reset mpls statistics to clear MPLS forwarding statistics for the specified LSPs.
Syntax
reset mpls statistics { all | [ vpn-instance vpn-instance-name ] { ipv4 ipv4-address mask-length | ipv6 ipv6-address prefix-length } | static | te ingress-lsr-id tunnel-id }
Views
User view
Predefined user roles
network-admin
Parameters
all: Specifies all LSPs.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears MPLS forwarding statistics for public LSPs.
ipv4 ipv4-address mask-length: Specifies the IPv4 LSP for an FEC specified by an IPv4 address and a mask length. The mask length is in the range of 0 to 32.
ipv6 ipv6-address prefix-length: Specifies the BGP-IPv6 LSP for an FEC specified by an IPv6 address and a prefix length. The prefix length is in the range of 0 to 128.
static: Specifies static LSPs and static CRLSPs.
te ingress-lsr-id tunnel-id: Specifies an RSVP-TE tunnel. The ingress-lsr-id argument represents the LSR ID of the ingress node of the tunnel. The tunnel-id argument represents the ID of the tunnel. The value range for the tunnel-id argument is 0 to 20479.
Examples
# Clear MPLS forwarding statistics for the LSP destined for 2.2.2.2/32.
<Sysname> reset mpls statistics ipv4 2.2.2.2 32
Related commands
display mpls lsp verbose
mpls statistics
mpls statistics interval
snmp-agent trap enable mpls
Use snmp-agent trap enable mpls to enable SNMP notifications for MPLS.
Use undo snmp-agent trap enable mpls to disable SNMP notifications for MPLS.
Syntax
snmp-agent trap enable mpls
undo snmp-agent trap enable mpls
Default
SNMP notifications for MPLS are disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
To report critical MPLS events to an NMS, enable SNMP notifications for MPLS. For MPLS event notifications to be sent correctly, you must also configure SNMP on the device. For more information about SNMP configuration, see the network management and monitoring configuration guide for the device.
Examples
# Enable SNMP notifications for MPLS.
<Sysname> system-view
[Sysname] snmp-agent trap enable mpls
snmp-agent trap enable mpls-private
Use snmp-agent trap enable mpls-private to enable private SNMP notifications for MPLS.
Use undo snmp-agent trap enable mpls-private to disable private SNMP notifications for MPLS.
Syntax
snmp-agent trap enable mpls-private [ label-threshold | label-total | slsp-up-down | tunnel-to-vpn ] *
undo snmp-agent trap enable mpls-private [ label-threshold | label-total | slsp-up-down | tunnel-to-vpn ] *
Default
Private SNMP notifications for MPLS are disabled.
Views
System view
Predefined user roles
network-admin
Parameters
label-threshold: Sends a notification when MPLS label usage exceeds the upper threshold or drops below the lower threshold. To set the MPLS label usage upper and lower thresholds, use the mpls label-usage threshold-alarm percent command.
label-total: Sends a notification when MPLS label usage reaches 100% or drops from 100% to 95%.
slsp-up-down: Sends a notification when a static LSP goes up or down.
tunnel-to-vpn: Sends a notification when the recursive tunnel for a VPN instance changes.
Usage guidelines
This command enables generating SNMP notifications for MPLS events of label-threshold, label-total, slsp-up-down, and tunnel-to-vpn. These notifications are not defined in an RFC and are private MPLS notifications supported by Comware. For SNMP to output the private MPLS notifications correctly, you must also configure parameters for sending SNMP notifications. For more information about SNMP configuration, see Network Management and Monitoring Configuration Guide.
If you do not specify any parameters, this command enables or disables all private SNMP notifications for MPLS.
Examples
# Enable all private SNMP notifications for MPLS.
<Sysname> system-view
[Sysname] snmp-agent trap enable mpls-private
Related commands
snmp-agent trap enable mpls