07 MPLS命令参考

01-MPLS基础命令

1 MPLS基础

MPLS功能中所指的“接口”为三层口，包括VLAN接口、三层以太网接口等。三层以太网接口是指被配置为三层模式的以太网口，有关以太网口模式切换的操作，请参见“二层技术-以太网交换配置指导”中的“以太网接口”。

1.1 MPLS基础配置命令

1.1.1 display mpls forwarding ilm

display mpls forwarding ilm命令用来显示ILM（Incoming Label Map，入标签映射）表项信息。

【命令】

display mpls forwarding ilm [ label ] [ slot slot-number ]

label：显示指定入标签的ILM表项，标签的取值范围为16～1048575。如果不指定本参数，则显示所有ILM表项信息。

slot slot-number：显示指定成员设备上的ILM表项。slot-number为设备在IRF中的成员编号。

【使用指导】

ILM用于根据入标签查找对应的标签操作类型、出标签值等。LSR接收到带有标签的报文后，根据报文中的栈顶标签值查找对应的ILM表项，执行相应的标签操作，并转发该报文。

【举例】

# 显示指定入标签的ILM表项。

<Sysname> display mpls forwarding ilm 30

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

InLabel Oper VRF Flag SwapLabel Forwarding Info

--------------------------------------------------------------------------------

30 SWAP 0 T 1000 1024

# 显示3号成员设备上的所有ILM表项。

<Sysname> display mpls forwarding ilm slot 3

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

InLabel Oper VRF Flag SwapLabel Forwarding Info

--------------------------------------------------------------------------------

30 SWAP 0 T 1000 1024

1279 POP 0 - - -

1407 SWAP 0 NA 1271 Vlan10 50.2.0.2

NB 1270 Tun0 0.0.0.0

表1-1 display mpls forwarding ilm命令显示信息描述表

字段	描述
Total ILM entries	ILM表项总数
InLabel	入标签
Oper	操作类型，取值包括： · POP：弹出标签 · POPGO：弹出标签，并将报文转发到另一条隧道 · SWAP：交换标签
VRF	VPN实例的索引
Flag	转发标记，取值包括： · T：隧道转发 · N：出接口/下一跳转发 · B：备份转发信息 · A：在用转发信息
SwapLabel	交换的标签值，即出标签值
Forwarding Info	转发信息 · 转发标记为N时，转发信息为出接口和下一跳 · 转发标记为T时，转发信息为NID

1.1.2 display mpls forwarding nhlfe

display mpls forwarding nhlfe命令用来显示NHLFE（Next Hop Label Forwarding Entry，下一跳标签转发项）表项信息。

【命令】

display mpls forwarding nhlfe [ nid ] [ slot slot-number ]

nid：显示指定NHLFE表项的信息。nid为NHLFE表项索引，取值范围为0～4294967294。如果不指定本参数，则显示所有NHLFE表项信息。

slot slot-number：显示指定成员设备上的NHLFE表项。slot-number为设备在IRF中的成员编号。

【使用指导】

NHLFE表项描述了标签的转发信息（如出标签、出接口等），NHLFE表项主要用于为报文添加多层标签的情况。需要为报文添加多层标签时，LSR首先通过FIB表项或ILM表项获取最内层标签和对应的NHLFE表项索引，然后根据NHLFE表项索引查找NHLFE表项，从该表项中获取报文的外层标签。

【举例】

# 显示索引号为2048的NHLFE表项。

<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

NID Tnl-Type Flag OutLabel Forwarding Info

--------------------------------------------------------------------------------

2048 LSP NA 2025 Vlan10 10.11.112.26

# 显示3号成员设备上的所有的NHLFE表项。

<Sysname> display mpls forwarding nhlfe slot 3

Total NHLFE entries: 5

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

NID Tnl-Type Flag OutLabel Forwarding Info

--------------------------------------------------------------------------------

10 - TA - 2049

20 - TA - 2050

2048 LSP NA 2025 Vlan2 10.11.112.26

2049 LSP NA 3024 Vlan2 10.11.112.26

TB 3026 20

2050 LSP NA 3025 Vlan10 10.11.113.26

表1-2 display mpls forwarding nhlfe命令显示信息描述表

字段	描述
Total NHLFE entries	NHLFE表项总数
NID	NHLFE表项索引
Tnl-Type	隧道类型，取值包括： · LOCAL：表示直连下一跳LSP隧道 · LSP：表示静态LSP隧道、采用LDP或BGP协议建立的LSP隧道 · TE：表示MPLS TE隧道接口对应的隧道 · CRLSP：表示静态CRLSP隧道或采用RSVP协议建立的CR-LSP隧道 · -：表示隧道类型为无效值
Flag	转发标记，取值包括： · T：隧道转发 · N：出接口/下一跳转发 · B：备份转发信息 · A：在用转发信息
OutLabel	出标签值
Forwarding Info	转发信息 · 转发标记为N时，转发信息为出接口和下一跳 · 转发标记为T时，转发信息为NID

字段	描述
Interface	接口名称
Status	接口状态
MPLS MTU	接口的MPLS MTU，单位为字节

1.1.4 display mpls label

display mpls label命令用来显示MPLS标签的使用状态。

【命令】

display mpls label { label-value1 [ to label-value2 ] | all }

label-value1：显示指定标签的使用状态。label-value1为标签值，取值范围为16～1048575。当与label-value2一起使用时，label-value1表示标签范围的起始值。

to label-value2：标签范围的结束值，label-value2的取值范围为16～1048575。如果同时指定了label-value1和本参数，则显示label-value1到label-value2之间标签的使用状态。

all：显示所有标签的使用状态。

【举例】

# 显示1025～1027之间标签的使用状态。

<Sysname> display mpls label 1025 to 1027

Label Owner State

1025 LDP Alloc

1026 LDP Alloc

1027 LDP Inuse

表1-4 display mpls label命令显示信息描述表

字段	描述
Label	标签值
Owner	标签使用者，即使用该标签的协议，取值包括：LDP、BGP、RSVP和L2VPN
State	标签的使用状态，取值包括： · Idle：标签空闲 · Alloc：标签已被申请 · Pending：标签已释放，但仍被LSP表项使用 · Inuse：标签已被申请，同时被LSP表项使用

字段	描述
FEC	转发等价类，包括以下形式： · IP地址/掩码：表示根据目的地址划分FEC · IP地址：表示根据下一跳地址划分FEC · IP地址/Out Label：表示根据下一跳地址和出标签划分FEC · Ingress LSR ID/Tunnel ID/LSP ID：表示RSVP TE的FEC · -：表示静态Transit LSP、静态Egress LSP、静态Transit CR-LSP或静态Egress CR-LSP 如果显示为“Backup”，则表示该LSP是前一条LSP的备份LSP
Proto	标签分发协议，取值包括： · LDP：表示该LSP为采用LDP协议建立的LDP LSP · BGP：表示该LSP为采用BGP协议建立的BGP LSP · RSVP：表示该LSP为采用RSVP协议建立的CR-LSP · Static：表示该LSP为手工配置的静态LSP · StaticCR：表示该LSP为手工配置的静态CR-LSP · Local：表示该LSP为直连下一跳LSP
In/Out Label	入标签值/出标签值
Interface/Out NHLFE	出接口名称或NHLFE索引取值为NHLFEnumber时，表示该LSP迭代到NID为number的NHLFE表项对应的Ingress LSP

字段	描述
FEC	转发等价类，包括以下形式： · IP地址/掩码：表示根据目的地址划分FEC · IP地址：表示根据下一跳地址划分FEC · IP地址/Out Label：表示根据下一跳地址和出标签划分FEC · Ingress LSR ID/Tunnel ID/LSP ID：表示RSVP TE的FEC · -：表示静态Transit LSP、静态Egress LSP、静态Transit CR-LSP或静态Egress CR-LSP
Protocol	标签分发协议，取值包括： · LDP：表示该LSP为采用LDP协议建立的LDP LSP · BGP：表示该LSP为采用BGP协议建立的BGP LSP · RSVP：表示该LSP为采用RSVP协议建立的CR-LSP · Static：表示该LSP为手工配置的静态LSP · StaticCR：表示该LSP为手工配置的静态CR-LSP · Local：表示该LSP为直连下一跳LSP
In-Label	入标签值
Out-Label	出标签值
Out-Interface	出接口
BkLabel	备份LSP的出标签值
BkInterface	备份LSP的出接口

字段	描述
Destination	LSP的目的地址
FEC	转发等价类，包括以下形式： · IP地址/掩码：表示根据目的地址划分FEC · IP地址：表示根据下一跳地址划分FEC · IP地址/Out Label：表示根据下一跳地址和出标签划分FEC · Ingress LSR ID/Tunnel ID/LSP ID：表示RSVP TE的FEC · -：表示静态Transit LSP、静态Egress LSP、静态Transit CR-LSP或静态Egress CR-LSP
Protocol	标签分发协议，取值包括： · LDP：表示该LSP为采用LDP协议建立的LDP LSP · BGP：表示该LSP为采用BGP协议建立的BGP LSP · RSVP：表示该LSP为采用RSVP协议建立的CR-LSP · Static：表示该LSP为手工配置的静态LSP · StaticCR：表示该LSP为手工配置的静态CR-LSP · Local：表示该LSP为直连下一跳LSP
LSR Type	LSR类型，取值包括： · Ingress：LSP的入节点 · Transit：LSP的中间节点 · Egress：LSP的出节点
Service	LSP上部署的业务，目前仅支持Statistics，表示MPLS转发统计功能
In-Label	入标签值
Path ID	转发路径，取值为0xnn.m，nn表示承载本层LSP的外层LSP的NHLFE组ID，m表示等价路径编号
NHLFE ID	NHLFE表项索引
State	LSP状态，取值包括： · Active：LSP正在使用 · Inactive：LSP空闲未用
Inbound Statistics	入方向的MPLS转发统计信息，包括入方向接收的字节数（Octets）、接收的报文数（Packets）、接收的错误报文数（Errors）和丢弃的报文数（Discards）
Out-Label	出标签值
Nexthop	下一跳地址
Out-Interface	出接口
BkLabel	备份LSP的出标签值
BkNexthop	备份LSP的下一跳地址
BkInterface	备份LSP的出接口
Outbound Statistics	出方向的MPLS转发统计信息，包括出方向发送的字节数（Octets）、发送的报文数（Packets）、错误报文数（Errors）和丢弃的报文数（Discards）

1.1.6 display mpls lsp statistics

display mpls lsp statistics命令用来显示LSP的统计信息。

【命令】

display mpls lsp statistics

# 显示LSP的统计信息。

<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

-----------------------------------------------------

Total 4/2/1 4/2/1

表1-8 display mpls lsp statistics命令显示信息描述表

字段	描述
LSP Type	LSP的类型，取值包括： · Static LSP：静态LSP · Static CRLSP：静态CR-LSP · LDP LSP：通过LDP建立的LSP · Local LSP：直连下一跳LSP · RSVP CRLSP：通过RSVP建立的CR-LSP · BGP LSP：通过BGP建立的LSP
Total	各种类型LSP的总数
Ingress	本设备作为入节点的LSP数量
Transit	本设备作为中间节点的LSP数量
Egress	本设备作为出节点的LSP数量
Active	处于可用状态的各种类型LSP的数量

1.1.7 display mpls nib

display mpls nib命令用来显示MPLS的NIB（Nexthop Information Base，下一跳信息库）信息。

【命令】

display mpls nib [ nib-id ]

nib-id：显示指定MPLS下一跳的信息。nib-id为MPLS下一跳的索引，取值范围为1～FFFFFFFFFFFFFFFE。如果不指定本参数，则显示所有MPLS下一跳的信息。

【举例】

# 显示所有MPLS下一跳的信息。

<Sysname> display mpls nib

NIB ID: 0x40000000

Users: 1

Status: Active

ECMP number: 1

Outgoing NHLFE ID: 1024

Backup outgoing NHLFE ID: 1027

表1-9 display mpls nib命令显示信息描述表

字段	描述
NIB ID	MPLS下一跳索引
Users	引用该MPLS下一跳的ILM表项数目
Status	MPLS下一跳的状态，取值包括： · Active，激活表项 · Dummy，非激活表项
ECMP number	等价路径数目
Outgoing NHLFE ID	MPLS下一跳对应的NHLFE表项索引
Backup outgoing NHLFE ID	MPLS下一跳对应的备份NHLFE表项的索引

1.1.8 display mpls nid

display mpls nid命令用来显示NHLFE表项索引的使用状态。

【命令】

display mpls nid [ nid-value1 [ to nid-value2 ] ]

nid-value1：显示指定NHLFE表项索引的使用状态。nid-value1为NHLFE表项索引，取值范围为0～65535。当与nid-value2一起使用时，nid-value1表示索引范围的起始值。

to nid-value2：NHLFE表项索引，表示索引范围的结束值，取值范围为0～65535。如果同时指定了nid-value1和本参数，则显示nid-value1到nid-value2之间的NHLFE表项索引的使用状态。

【使用指导】

设备上的NHLFE表项索引（该索引为32位二进制数）分为两类：

· 固定NHLFE表项索引：设备为隧道接口生成的NHLFE表项索引，该索引的高4位为非0值。

· 动态NHLFE表项索引：设备为LDP LSP、静态LSP、CRLSP等协议生成的LSP分配的NHLFE表项索引，该索引的高4位为0。

本命令只能用来显示动态NHLFE表项索引的使用状态。

执行本命令时，如果不指定任何参数，则显示所有动态NHLFE表项索引的使用状态。

【举例】

# 显示1028～1500之间的NHLFE表项索引的使用状态。

<Sysname> display mpls nid 1028 to 1500

NID alloc state: '.' means not used, '$' means used

1028 :...$.... ........ ........ ........ ........ ........ ........ ........

1092 :........ ........ ........ ........ ........ ........ ........ ........

1156 :........ ........ ........ ........ ........ ........ ........ ........

1220 :........ ........ ........ ........ ........ ........ ........ ........

1284 :........ ........ ........ ........ ........ ........ ........ ........

1348 :........ ........ ........ ........ ........ ........ ........ ........

1412 :........ ........ ........ ........ ........ ........ ........ ........

1476 :........ ........ ........ .

表1-10 display mpls nid命令显示信息描述表

字段	描述
NID alloc state	NID使用状态
'.' means not used	“.”表示没有使用
'$' means used	“$”表示已经使用

1.1.9 display mpls summary

display mpls summary命令用来显示MPLS汇总信息。

【命令】

display mpls summary

# 显示MPLS汇总信息。

<Sysname> display mpls summary

MPLS LSR ID : 2.2.2.2

Egress Label Type: Implicit-null

Labels:

Range Idle

16-1023 1008

1024-9215 8192

65536-73727 8192

131072-139263 8192

Protocols:

Type State

BGP Normal

Static Normal

表1-11 display mpls summary命令显示信息描述表

字段	描述
MPLS LSR ID	MPLS LSR标识符
Egress Label Type	Egress向倒数第二跳通告的标签类型，取值包括： · Implicit-null：隐式空标签 · Explicit-null：显式空标签 · Non-null：非空标签
Labels	标签相关信息
Range	标签范围
Idle	标签范围内空闲的标签数目
Protocols	正在运行的标签分发协议及其相关信息
Type	协议类型，取值包括：LDP、BGP、RSVP、Static、Static CRLSP、TE、L2VPN
State	标签分发协议运行状态，取值包括： · Normal：正常状态 · Recover：协议处于GR期间

1.1.10 mpls enable

mpls enable命令用来使能接口的MPLS能力。

undo mpls enable命令用来关闭接口的MPLS能力。

未使能接口的MPLS能力。

# 在接口Vlan-interface2上使能MPLS能力。

<Sysname> System-view

[Sysname] interface vlan-interface 2

[Sysname-Vlan-interface2] mpls enable

【相关命令】

· display mpls interface

1.1.11 mpls label advertise

mpls label advertise命令用来配置设备作为Egress节点时分配的标签类型，即向倒数第二跳通告的标签类型。

undo mpls label advertise命令用来恢复缺省情况。

【命令】

mpls label advertise { explicit-null | implicit-null | non-null }

undo mpls label advertise

【缺省情况】

设备作为Egress节点时，向倒数第二跳通告隐式空标签（implicit-null）。

explicit-null：指定设备作为Egress节点时，向倒数第二跳通告显式空标签，标签值为0。

implicit-null：指定设备作为Egress节点时，向倒数第二跳通告隐式空标签，标签值为3。

non-null：指定设备作为Egress节点时，向倒数第二跳通告非空标签。标签的取值范围为16～1048575。

【使用指导】

· 请根据实际情况选择Egress节点分配的标签类型：如果倒数第二跳节点支持PHP（Penultimate Hop Popping，倒数第二跳弹出）功能，则建议采用隐式空标签；如果在简化Egress节点转发处理的同时，希望Egress节点能够根据标签中的TC等信息决定QoS策略，则建议采用显式空标签；非空标签只使用在一些比较特殊的场景，比如Egress节点上部署了OAM，只有根据标签才能对应到OAM功能实体的情况，通常情况下不建议使用非空标签。

· 设备作为倒数第二跳节点时，允许Egress节点向其通告显式空标签、隐式空标签和非空标签。

· 对于LDP LSP，执行mpls label advertise命令修改Egress分配的标签类型后，已经建立的LDP LSP会被拆除，并根据新的标签类型重新建立。

· 对于BGP LSP，mpls label advertise命令只对新建立的BGP LSP生效，执行本命令前已经建立的BGP LSP不受影响。若要使本命令对已经建立的BGP LSP生效，则需要从BGP路由表中删除BGP LSP对应的路由，并重新引入该路由。

【举例】

# 配置设备作为Egress节点时，向倒数第二跳通告显式空标签。

<Sysname> system-view

[Sysname] mpls label advertise explicit-null

【相关命令】

· reset mpls ldp（MPLS命令参考/LDP）

1.1.12 mpls lsr-id

mpls lsr-id命令用来配置本节点的LSR ID。

undo mpls lsr-id命令用来删除LSR的ID。

【命令】

mpls lsr-id lsr-id

lsr-id：LSR的ID，点分十进制格式，用于标识一个LSR。

【使用指导】

推荐使用LSR上某个Loopback接口的地址作为LSR ID。

【举例】

# 配置本节点的LSR ID为3.3.3.3。

<Sysname> system-view

[Sysname] mpls lsr-id 3.3.3.3

【相关命令】

· lsr-id（MPLS命令参考/LDP）

1.1.13 mpls mtu

mpls mtu命令用来配置接口的MPLS MTU值。

undo mpls mtu命令用来恢复缺省情况。

未配置接口的MPLS MTU值，此时根据接口的MTU值进行分片，分片的长度不包含MPLS标签栈的长度，为分片添加MPLS标签栈后MPLS报文的长度可能会大于接口MTU的值。

value：接口的MPLS MTU值，取值范围为46～65535，单位为字节。

【使用指导】

· 只有在接口上使能MPLS功能后，该命令才会生效。

· 配置的MPLS MTU值大于接口MTU时，有可能导致数据转发失败。

· MPLS TE隧道接口不支持本命令。

【举例】

# 配置接口Vlan-interface2的MPLS MTU值为1000。

<Sysname> system-view

[Sysname] interface vlan-interface 2

[Sysname-Vlan-interface2] mpls enable

[Sysname-Vlan-interface2] mpls mtu 1000

【相关命令】

· display mpls interface

1.1.14 mpls statistics

mpls statistics命令用来使能指定LSP的MPLS标签转发统计功能。

undo mpls statistics命令用来关闭指定LSP的MPLS标签转发统计功能。

【命令】

mpls statistics { all | [ vpn-instance vpn-instance-name ] { ipv4 ipv4-destination mask-length | ipv6 ipv6-destination prefix-length } | static | te ingress-lsr-id tunnel-id }

undo mpls statistics { all | [ vpn-instance vpn-instance-name ] { ipv4 ipv4-destination mask-length | ipv6 ipv6-destination prefix-length } | static | te ingress-lsr-id tunnel-id }

【缺省情况】

所有LSP的MPLS标签转发统计功能均处于关闭状态。

all：统计所有LSP的信息。

vpn-instance vpn-instance-name：统计指定VPN实例的LSP信息。vpn-instance-name表示VPN实例名称，为1～31字符的字符串，区分大小写。如果没有指定本参数，则统计公网的LSP信息。

ipv4 ipv4-destination mask-length：统计指定FEC对应IPv4 LSP的信息。ipv4-destination为FEC的IPv4目的地址，mask-length为FEC目的地址的掩码长度，取值范围为0～32。

ipv6 ipv6-destination prefix-length：统计指定FEC对应BGP-IPv6 LSP的信息。ipv6-destination为FEC的IPv6目的地址，prefix-length为FEC目的地址的前缀长度，取值范围为0～128。

static：统计静态LSP和静态CR-LSP的信息。

te ingress-lsr-id tunnel-id：统计指定RSVP-TE隧道的信息。ingress-lsr-id为入节点的LSR ID，tunnel-id为隧道ID，取值范围为0～127。

【使用指导】

MPLS标签转发是指接收到带有标签的报文后，根据报文中的入标签转发该报文。本命令用来使能MPLS标签转发的统计功能。

只有通过本命令使能MPLS标签转发统计功能，并通过mpls statistics interval命令使能统计信息收集功能，用户才能利用display mpls lsp verbose命令查看MPLS标签转发的统计信息。

【举例】

# 使能目的地址为2.2.2.2/32的FEC对应LSP的MPLS标签转发统计功能。

<Sysname> system-view

[Sysname] mpls statistics ipv4 2.2.2.2 32

【相关命令】

· display mpls lsp verbose

· mpls statistics interval

· reset mpls statistics

1.1.15 mpls statistics interval

mpls statistics interval命令用来使能MPLS标签转发统计信息的收集功能，并设置统计信息收集的时间间隔。

undo mpls statistics interval命令用来关闭MPLS标签转发统计信息的收集功能。

【命令】

mpls statistics interval interval

undo mpls statistics interval

【缺省情况】

MPLS标签转发统计信息收集功能处于关闭状态。

interval：MPLS标签转发统计信息收集的时间间隔，取值范围为30～65535，单位为秒。

【使用指导】

只有通过mpls statistics命令使能MPLS标签转发统计功能，并通过本命令使能统计信息收集功能，用户才能利用display mpls lsp verbose命令查看MPLS标签转发统计信息。

【举例】

# 使能MPLS标签转发统计信息收集功能，并将统计信息收集时间间隔设置为30秒。

<Sysname> system-view

[Sysname] mpls statistics interval 30

【相关命令】

· display mpls lsp verbose

· mpls statistics

· reset mpls statistics

1.1.16 mpls ttl expiration enable

mpls ttl expiration enable命令用来使能MPLS的TTL超时消息发送功能。

undo mpls ttl expiration enable命令用来关闭MPLS的TTL超时消息发送功能。

【命令】

mpls ttl expiration enable

undo mpls ttl expiration enable

【缺省情况】

MPLS的TTL超时消息发送功能处于开启状态。

使能MPLS的TTL超时消息发送功能后，当LSR收到TTL为1的MPLS报文时，LSR会生成ICMP的TTL超时消息。对于一层标签的MPLS报文，LSR沿着本地IP路由返回ICMP TTL超时消息；对于多层标签的MPLS报文，LSR沿着发送MPLS报文的LSP转发ICMP TTL超时消息，由Egress节点将该消息返回给发送者。

关闭MPLS的TTL超时消息发送功能后，当LSR收到TTL为1的MPLS报文时，LSR不会生成ICMP的TTL超时消息。

【举例】

# 关闭MPLS的TTL超时消息发送功能。

<Sysname> system-view

[Sysname] undo mpls ttl expiration enable