08-三层技术-IP路由命令参考

07-策略路由命令

1 策略路由

MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-LM-HK/810-W-LM-HK/2630/3610/3620/3620-DP/3640/3660/3600-28/3600-51/MSR2600-10-X1路由器使用集中式命令行，MSR 5620/5660/5680路由器使用分布式命令行。

1.1 策略路由配置命令

1.1.1 apply access-vpn vpn-instance

apply access-vpn vpn-instance命令用来设置报文在指定VPN实例中进行转发。

undo apply access-vpn vpn-instance命令用来取消报文在指定VPN实例中进行转发的设置或者删除一个或多个指定的VPN实例对应的配置。

【命令】

apply access-vpn vpn-instance vpn-instance-name&<1-n>

undo apply access-vpn vpn-instance [ vpn-instance-name&<1-n> ]

未设置报文在指定VPN实例中进行转发。

vpn-instance-name：表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。指定的VPN实例必须已经存在。

&<1-n>：表示前面的参数最多可以输入n次，n的实际取值为4。

【使用指导】

每个节点最多可以配置m个VPN实例，m的实际取值为6。当满足匹配规则后，将根据第一个可用的VPN实例转发表进行转发。

配置undo命令时，如果指定了VPN实例名，将删除该VPN实例对应的配置；如果未指定VPN实例名，将取消报文在指定VPN实例内转发的配置。

【举例】

# 在策略节点中设置报文在名为vpn1、vpn2的VPN实例中进行转发（VPN实例vpn1、vpn2已存在）。

<Sysname> system-view

[Sysname] policy-based-route policy1 permit node 10

[Sysname-pbr-policy1-10] apply access-vpn vpn-instance vpn1 vpn2

【相关命令】

· apply remark-vpn

1.1.2 apply continue

apply continue命令用来设置匹配成功的当前节点指定转发路径失败后，继续进行后续节点的处理。

undo apply continue命令用来恢复缺省情况。

【命令】

apply continue

undo apply continue

【缺省情况】

匹配成功的当前节点指定转发路径失败后，不再进行下一节点的匹配。

本命令仅在策略节点的匹配模式为permit时生效。

在配置了该命令后，如果当前节点中没有配置影响报文转发路径的五个apply子句（apply access-vpn vpn-instance、apply next-hop、apply output-interface、apply default-next-hop和apply default-output-interface），或者配置了这五个子句中的一个或多个，但配置的子句都失效（下一跳不可达、出接口down或者报文在指定VPN内转发失败）时，会进行下一节点的处理。

【举例】

# 设置匹配成功的当前节点转发失败后继续进行后续节点的处理。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply continue

1.1.3 apply default-next-hop

apply default-next-hop命令用来设置指导报文转发的缺省下一跳。

undo apply default-next-hop命令用来取消指导报文转发的缺省下一跳的设置。

【命令】

apply default-next-hop [ vpn-instance vpn-instance-name | inbound-vpn ] { ip-address [ direct ] [ track track-entry-number ] }&<1-n>

undo apply default-next-hop [ [ vpn-instance vpn-instance-name | inbound-vpn ] ip-address&<1-n> ]

vpn-instance vpn-instance-name：缺省下一跳所在的VPN实例。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。指定的VPN实例必须已经存在。

inbound-vpn：报文入接口所在的VPN实例。

ip-address：缺省下一跳的IP地址。不指定vpn-instance或inbound-vpn参数，表示指定的是公网下一跳。

direct：指定当前缺省下一跳生效的条件为直连下一跳。

track track-entry-number：指定Track项的序号，track-entry-number取值范围为1～1024。

&<1-n>：表示前面的参数最多可以输入n次，n的实际取值为4。

【使用指导】

用户可以同时配置多个缺省下一跳（通过一次或多次配置本命令实现），起到主备或负载分担的作用。

每个节点最多可以配置m个缺省下一跳，m的实际取值为16。

配置undo命令时，如果指定了缺省下一跳IP地址，将取消已配置的该缺省下一跳；如果没有指定缺省下一跳IP地址，将取消已配置的所有缺省下一跳。

【举例】

# 设置指导报文转发的缺省直连下一跳为1.1.1.1。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply default-next-hop 1.1.1.1 direct

【相关命令】

· apply loadshare

1.1.4 apply default-output-interface

apply default-output-interface命令用来设置指导报文转发的缺省出接口。

undo apply default-output-interface命令用来取消指导报文转发的缺省出接口的设置。

【命令】

apply default-output-interface { interface-type interface-number [ track track-entry-number ] }&<1-n>

undo apply default-output-interface [ { interface-type interface-number }&<1-n> ]

interface-type interface-number：指定接口类型和接口编号。

track track-entry-number：指定Track项的序号，track-entry-number取值范围为1～1024。

&<1-n>：表示前面的参数最多可以输入n次，n的实际取值为4。

【使用指导】

用户可以同时配置多个缺省出接口（通过一次或多次配置本命令实现），起到主备或负载分担的作用。

每个节点最多可以配置m个缺省出接口，m的实际取值为16。

指定缺省出接口类型需配置为P2P（Point-to-Point，点到点）接口，对于非P2P接口（广播类型的接口和NBMA类型的接口），比如以太网接口、Virtual-Template接口，由于有多个可能的下一跳，可能会造成报文转发不成功的现象。NBMA（Non Broadcast MultiAccess，非广播多路访问）指全连通、非广播、多点可达的网络，这种网络采用单播方式发送报文。

配置undo命令时，如果指定了接口，将取消已配置的该缺省出接口；如果没有指定接口，将取消已配置的所有缺省出接口。

【举例】

# 设置报文的缺省出接口为GigabitEthernet2/0/1。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply default-output-interface gigabitethernet 2/0/1

【相关命令】

· apply loadshare

1.1.5 apply ip-df

apply ip-df命令用来设置IP报文头中的DF（Don’t Fragment，不分片）标志。

undo apply ip-df命令用来恢复缺省情况。

【命令】

apply ip-df df-value

不对IP报文头中的DF标志进行设置。

df-value：设置IP报文头中的DF标志，取值0或1。0表示将IP报文头中的DF标志位置为0；1表示将IP报文头中的DF标志位置为1。

【使用指导】

报文中DF标志位置为0，表示可以对报文进行分片处理。

报文中DF标志位置为1，表示不可对报文进行分片处理。

【举例】

# 将报文IP首部的DF标志位置为0。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply ip-df 0

1.1.6 apply loadshare

apply loadshare命令用来设置多个下一跳(出接口、缺省下一跳和缺省出接口)工作在负载分担模式。

undo apply loadshare命令用来恢复缺省情况。

【命令】

apply loadshare { default-next-hop | default-output-interface | next-hop | output-interface }

undo apply loadshare { default-next-hop | default-output-interface | next-hop | output-interface }

【缺省情况】

多个下一跳(出接口、缺省下一跳和缺省出接口)工作在主备模式。

default-next-hop：设置指导报文转发的多个缺省下一跳工作在负载分担模式。

default-output-interface：设置指导报文转发的多个缺省出接口工作在负载分担模式。

next-hop：设置指导报文转发的多个下一跳工作在负载分担模式。

output-interface：设置指导报文转发的多个出接口工作在负载分担模式。

【使用指导】

多个出接口(下一跳、缺省下一跳和缺省出接口)的工作模式有两种：主备模式、负载分担模式。以多个出接口为例：

· 主备模式：按照配置顺序，以第一个配置的出接口作为主用出接口，指导报文转发。当主用出接口失效时，按配置顺序选择后续的第一个有效的出接口指导报文转发。

· 负载分担模式：按照配置顺序，逐包轮流选择有效的出接口指导报文转发。下一跳的负载分担模式则有些不同，会按照下一跳的权重指导报文转发。缺省情况下，多个下一跳会按照缺省的权重值平均分配带宽，多个下一跳的转发流量的比例是相同的。

缺省下一跳和缺省出接口的情况请参考多个出接口。

【举例】

# 设置多个下一跳工作在负载分担模式。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply next-hop 1.1.1.1 2.2.2.2

[Sysname-pbr-aa-11] apply loadshare next-hop

# 设置多个出接口工作在负载分担模式。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply output-interface Vlan-interface 1 Vlan-interface 2

[Sysname-pbr-aa-11] apply loadshare output-interface

# 设置多个缺省下一跳工作在负载分担模式。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply default-next-hop 1.1.1.1 2.2.2.2

[Sysname-pbr-aa-11] apply loadshare default-next-hop

# 设置多个缺省出接口工作在负载分担模式。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply default-output-interface Vlan-interface 1 Vlan-interface 2

[Sysname-pbr-aa-11] apply loadshare default-output-interface

【相关命令】

· apply default-next-hop

· apply default-output-interface

· apply next-hop

· apply output-interface

1.1.7 apply next-hop

apply next-hop命令用来设置报文转发的下一跳。

undo apply next-hop命令用来取消报文转发下一跳的设置。

【命令】

apply next-hop [ vpn-instance vpn-instance-name | inbound-vpn ] { ip-address [ direct ] [ track track-entry-number ] [ weight weight-value ] }&<1-n>

undo apply next-hop [ [ vpn-instance vpn-instance-name | inbound-vpn ] ip-address&<1-n> ]

vpn-instance vpn-instance-name：下一跳所在的VPN实例。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。指定的VPN实例必须已经存在。

inbound-vpn：报文入接口所在的VPN实例。

ip-address：下一跳IP地址。不指定vpn-instance或inbound-vpn参数，表示指定的是公网下一跳。

direct：指定当前下一跳生效的条件为直连下一跳。

track track-entry-number：指定Track项的序号，track-entry-number取值范围为1～1024。

&<1-n>：表示前面的参数最多可以输入n次，n的实际取值为4。

weight weight-value：指定下一跳负载分担的权重。设备根据权重确定该下一跳转发流量的比例。例如，三个下一跳配置的负载分担权重分别为1、1和2，则它们的负载分担的比例分别为1/4、1/4和1/2。weight-value取值范围为1～100，缺省值为10。

【使用指导】

用户可以同时配置多个下一跳（通过一次或多次配置本命令实现），起到主备或负载分担的作用。

每个节点最多可以配置m个下一跳，m的实际取值为16。

配置undo命令时，如果指定了下一跳IP地址，将取消已配置的该下一跳；如果没有指定下一跳IP地址，将取消已配置的所有下一跳。

【举例】

# 设置报文的直连下一跳为1.1.1.1。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply next-hop 1.1.1.1 direct

【相关命令】

· apply loadshare

1.1.8 apply output-interface

apply output-interface命令用来设置指导报文转发的出接口。

undo apply output-interface命令用来取消指导报文转发的出接口的设置。

【命令】

apply output-interface { interface-type interface-number [ track track-entry-number ] }&<1-n>

undo apply output-interface [ { interface-type interface-number }&<1-n> ]

interface-type interface-number：指定接口类型和接口编号。

track track-entry-number：指定Track项的序号，track-entry-number取值范围为1～1024。

&<1-n>：表示前面的参数最多可以输入n次，n的实际取值为4。

【使用指导】

用户可以同时配置多个出接口（通过一次或多次配置本命令实现），起到主备或负载分担的作用。

每个节点最多可以配置m个出接口，m的实际取值为16。

指定出接口类型需配置为P2P接口，对于非P2P接口（广播类型的接口和NBMA类型的接口），比如以太网接口、Virtual-Template接口，由于有多个可能的下一跳，可能会造成报文转发不成功的现象。

配置undo命令时，如果指定了接口，将取消已配置的该出接口；如果未指定接口，将取消已配置的所有出接口。

【举例】

# 对已经匹配的IP报文指定出接口为GigabitEthernet2/0/1。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply output-interface gigabitethernet 2/0/1

【相关命令】

· apply loadshare

1.1.9 apply precedence

apply precedence 命令用来设置IP报文的优先级。

undo apply precedence命令用来恢复缺省情况。

【命令】

apply precedence { type | value }

undo apply precedence

不对IP报文的优先级进行设置。

type：IP报文的优先级类型。

value：IP报文的优先级值，IP报文共有8（0～7）个优先级，每个数值对应一个优先级类型。在输入参数的时候可以输入数值，也可以输入优先级类型。对应关系如表1-1所示。

表1-1 IP优先级值与优先级类型对应表

优先级值	优先级类型
0	routine
1	priority
2	immediate
3	flash
4	flash-override
5	critical
6	internet
7	network

【举例】

# 设置IP报文的优先级为5（critical）。

<Sysname> system-view

[Sysname] policy-based-route aa permit node 11

[Sysname-pbr-aa-11] apply precedence critical

1.1.10 apply remark-vpn

apply remark-vpn命令用来重标记报文的VPN实例。

undo apply remark-vpn命令用来恢复缺省情况。

【命令】

apply remark-vpn

undo apply remark-vpn

【缺省情况】

未重标记报文的VPN实例。

【视图】

策略节点视图

【缺省用户角色】

network-admin

【使用指导】

默认情况下，配置apply access-vpn vpn-instance命令仅在指定的VPN实例内转发报文，但是不会重标记报文的VPN实例信息，后续业务模块看到的还是之前的VPN，如果要重标记报文的VPN实例信息则需要配置本命令。

本命令必须和apply access-vpn vpn-instance命令同时使用。

只有apply access-vpn vpn-instance命令能够成功指导报文转发时，本命令才能重标记报文的VPN实例信息，标记的VPN实例是生效的apply access-vpn vpn-instance命令配置的VPN实例。

【举例】

# 配置为匹配ACL 3000的报文重标记VPN实例为vpn1。

<Sysname> system-view

[Sysname] policy-based-route aaa permit node 10

[Sysname-pbr-aaa-10] if-match acl 3000

[Sysname-pbr-aaa-10] apply access-vpn vpn-instance vpn1

[Sysname-pbr-aaa-10] apply remark-vpn

【相关命令】

· apply access-vpn vpn-instance

· ip policy-based-route

1.1.11 display ip policy-based-route

display ip policy-based-route命令用来显示已经配置的策略。

【命令】

display ip policy-based-route [ policy policy-name ]

policy policy-name：显示指定的策略。policy-name表示策略名，唯一标识一个策略，为1～19个字符的字符串，区分大小写。

【使用指导】

如果不指定策略名，将显示所有已经配置的策略；如果指定策略名，将显示指定的策略。

【举例】

# 显示所有已经配置的策略。

<Sysname> display ip policy-based-route

Policy name: aaa

node 1 permit:

if-match acl 2000

apply next-hop 1.1.1.1

表1-2 display ip policy-based-route命令显示信息描述表

字段	描述
Policy name	策略名
node 1 permit	节点1的匹配模式为允许
if-match acl	满足ACL的报文被匹配
apply next-hop	为匹配的报文指定下一跳

【相关命令】

· policy-based-route

1.1.12 display ip policy-based-route interface

display ip policy-based-route interface命令用来显示接口下转发策略路由的配置信息和统计信息。

【命令】

集中式设备：

display ip policy-based-route interface interface-type interface-number

分布式设备－独立运行模式/集中式IRF设备：

display ip policy-based-route interface interface-type interface-number [ slot slot-number ]

分布式设备－IRF模式：

display ip policy-based-route interface interface-type interface-number [ chassis chassis-number slot slot-number ]

interface-type interface-number：用来指定接口的类型和编号。

slot slot-number：显示指定单板上转发策略路由的配置信息和统计信息。slot-number表示单板所在的槽位号。（分布式设备－独立运行模式）

slot slot-number：显示指定成员设备上转发策略路由的配置信息和统计信息。slot-number表示设备在IRF中的成员编号。（集中式IRF设备）

chassis chassis-number slot slot-number：显示指定成员设备上指定单板上转发策略路由的配置信息和统计信息。chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。（分布式设备－IRF模式）

【举例】

# 显示接口GigabitEthernet2/0/1下转发策略路由的配置信息和统计信息。

<Sysname> display ip policy-based-route interface gigabitethernet 2/0/1

Policy based routing information for interface GigabitEthernet2/0/1(failed):

Policy name: aaa

node 0 deny:

Matched: 0

node 1 permit:

if-match acl 3999

Matched: 0

node 2 permit:

if-match acl 2000

apply next-hop 2.2.2.2

Matched: 0

node 5 permit:

if-match acl 3101

apply next-hop 1.1.1.1

apply output-interface GigabitEthernet2/0/2 track 1 (down)

apply output-interface GigabitEthernet2/0/3 track 2 (inactive)

Matched: 0

Total matched: 0

<Sysname> display ip policy-based-route interface gigabitethernet 2/0/1

Policy based routing information for interface GigabitEthernet2/0/1:

Policy name: aaa

node 0 deny(not support):

Matched: 0

node 1 permit:

if-match acl 3999

Matched: 0

node 2 permit(no resource):

if-match acl 2000

apply next-hop 2.2.2.2

apply output-interface GigabitEthernet2/0/2 track 1 (down)

apply output-interface GigabitEthernet2/0/3 track 2 (inactive)

Matched: 0

node 5 permit:

if-match acl 3101

apply next-hop 1.1.1.1

Matched: 0 (no statistics resource)

Total matched: 0

表1-3 display ip policy-based-route interface命令显示信息描述表

字段	描述
Policy based routing information for interface GigabitEthernet2/0/1(failed)	接口GigabitEthernet2/0/1下转发策略路由的配置信息和统计信息（failed表示策略下发驱动失败，此时所有节点都下发失败，不再显示节点一级的失败提示）显示全局接口（全局接口只有一维编号，例如VLAN接口10）的信息时，必须在命令中指定slot slot-number或chassis chassis-number slot slot-number参数，才会显示括号中的信息。
Policy name	策略名
node 0 deny(not support) node 2 permit(no resource)	节点的匹配模式为允许（permit）/拒绝（deny）。（not support表示设备不支持该节点设置的规则；no resource表示设备的ACL等资源不足，为该节点分配ACL等资源失败）显示全局接口（全局接口只有一维编号，例如VLAN接口10）的信息时，必须在命令中指定slot slot-number或chassis chassis-number slot slot-number参数，才会显示括号中的信息。
if-match acl	满足ACL的报文被匹配
apply next-hop	为匹配的报文指定下一跳
apply output-interface GigabitEthernet2/0/2 track 1 (down)	为匹配的报文指定出接口。括号中显示接口的状态：up、down、inactive。接口不在位时，显示inactive；接口网络层down时，显示down
Matched: 0 (no statistics resource)	节点匹配成功的次数（no statistics resource表示统计资源不足）显示全局接口（全局接口只有一维编号，例如VLAN接口10）的信息时，必须在命令中指定slot slot-number或chassis chassis-number slot slot-number参数，才会显示括号中的信息。
Total matched	策略所有节点匹配成功的次数

1.1.13 display ip policy-based-route local

display ip policy-based-route local命令用来显示本地策略路由的配置信息和统计信息。

【命令】

集中式设备：

display ip policy-based-route local

分布式设备－独立运行模式/集中式IRF设备：

display ip policy-based-route local [ slot slot-number ]

分布式设备－IRF模式：

display ip policy-based-route local [ chassis chassis-number slot slot-number ]

slot slot-number：显示指定单板上本地策略路由的配置信息和统计信息。slot-number表示单板所在的槽位号。（分布式设备－独立运行模式）

slot slot-number：显示指定成员设备上本地策略路由的配置信息和统计信息。slot-number表示设备在IRF中的成员编号。（集中式IRF设备）

chassis chassis-number slot slot-number：显示指定成员设备上指定单板上本地策略路由的配置信息和统计信息。chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。（分布式设备－IRF模式）

【举例】

# 显示本地策略路由的配置信息和统计信息。

<Sysname> display ip policy-based-route local

Policy based routing information for local:

Policy name: aaa

node 0 deny:

Matched: 0

node 1 permit:

if-match acl 3999

Matched: 0

node 2 permit:

if-match acl 2000

apply next-hop 2.2.2.2

Matched: 0

node 5 permit:

if-match acl 3101

apply next-hop 1.1.1.1

Matched: 0

Total matched: 0

表1-4 display ip policy-based-route local命令显示信息描述表

字段	描述
Policy based routing information for local	本地策略路由的配置信息和统计信息
Policy name	策略名
node 0 deny/node 2 permit	节点的匹配模式为允许（permit）/拒绝（deny）
if-match acl	满足ACL的报文被匹配
apply next-hop	为匹配的报文指定下一跳
Matched: 0	节点匹配成功的次数
Total matched	策略所有节点匹配成功的次数