• 产品与解决方案
  • 行业解决方案
  • 服务
  • 支持
  • 合作伙伴
  • 新华三人才研学中心
  • 关于我们

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

目录

07-策略路由命令

本章节下载 07-策略路由命令  (179.19 KB)

docurl=/cn/Service/Document_Software/Document_Center/Home/Switches/00-Public/Command/Command_Manual/H3C_S12500-X_S12500X-AF_CR(R113x)-6W101/05/202001/1258909_30005_0.htm

07-策略路由命令


1 策略路由

1.1  策略路由配置命令

1.1.1  apply default-next-hop

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

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

【命令】

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

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

【缺省情况】

未设置指导报文转发的缺省下一跳。

【视图】

策略节点视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

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

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

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

track track-entry-number:指定Track项的序号,track-entry-number取值范围为1~1024。

&<1-n>:表示前面的参数最多可以输入n次。n的取值为2。

【使用指导】

用户可以同时配置多个缺省下一跳(通过一次或多次配置本命令实现),起到主备的作用。

每个节点最多可以配置2个缺省下一跳。

配置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

1.1.2  apply next-hop

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

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

【命令】

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

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

【缺省情况】

未设置报文转发的下一跳。

【视图】

策略节点视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

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

ip-address:下一跳IP地址。不指定vpn-instance参数,表示指定的是公网下一跳。

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

track track-entry-number:指定Track项的序号,track-entry-number取值范围为1~1024。

&<1-n>:表示前面的参数最多可以输入n次。n的取值为2。

【使用指导】

用户可以同时配置多个下一跳(通过一次或多次配置本命令实现),起到主备的作用。

每个节点最多可以配置2个下一跳。

配置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

1.1.3  apply output-interface NULL 0

apply output-interface NULL 0命令用来设置报文转发的出接口为NULL 0

undo apply output-interface NULL 0命令用来取消设备报文转发的出接口为NULL 0

【命令】

apply output-interface NULL 0 [ track track-entry-number ]

undo apply output-interface NULL 0

【缺省情况】

未设置指导报文转发的出接口为NULL 0。

【视图】

策略节点视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

track track-entry-number:指定Track项的序号,track-entry-number取值范围为1~1024。

【举例】

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

<Sysname> system-view

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

[Sysname-pbr-aa-11] apply output-interface NULL 0

1.1.4  display ip policy-based-route

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

【命令】

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【参数】

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-1 display ip policy-based-route命令显示信息描述表

字段

描述

Policy name

策略名

node 1 permit

节点1的匹配模式为允许

if-match acl

满足ACL的报文被匹配

apply next-hop

为匹配的报文指定下一跳

 

【相关命令】

·            policy-based-route

1.1.5  display ip policy-based-route interface

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

【命令】

独立运行模式:

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 ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【参数】

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

slot slot-number:显示指定单板上转发策略路由的配置信息和统计信息。slot-number表示单板所在的槽位号。(独立运行模式)

chassis chassis-number slot slot-number:显示指定成员设备上指定单板上转发策略路由的配置信息和统计信息。chassis-number表示设备在IRF中的成员编号,slot-number表示单板所在的槽位号。(IRF模式)

【举例】

# 显示接口Vlan-interface1下转发策略路由的配置信息和统计信息。

<Sysname> display ip policy-based-route interface Vlan-interface 1 slot 1

Policy based routing information for interface Vlan-interface1(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

  Matched: 0

Total matched: 0

<Sysname> display ip policy-based-route interface Vlan-interface 1 slot 1

Policy based routing information for interface Vlan-interface1:

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

  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-2 display ip policy-based-route interface命令显示信息描述表

字段

描述

Policy based routing information for interface Vlan-interface1(failed)

接口Vlan-interface1下转发策略路由的配置信息和统计信息(failed表示策略下发驱动失败,此时所有节点都下发失败,不再显示节点一级的失败提示)

说明

显示全局接口(全局接口只有一维编号,例如VLAN接口1)的信息时,必须在命令中指定slot slot-numberchassis 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接口1)的信息时,必须在命令中指定slot slot-numberchassis chassis-number slot slot-number参数,才会显示括号中的信息。

if-match acl

满足ACL的报文被匹配

apply next-hop

为匹配的报文指定下一跳

apply output-interface Vlan-interface2 track 1 (down)

为匹配的报文指定出接口。括号中显示接口的状态:up、down、inactive。接口不在位时,显示inactive;接口网络层down时,显示down

Matched: 0 (no statistics resource)

节点匹配成功的次数(no statistics resource表示统计资源不足)

说明

显示全局接口(全局接口只有一维编号,例如VLAN接口1)的信息时,必须在命令中指定slot slot-numberchassis chassis-number slot slot-number参数,才会显示括号中的信息。

Total matched

策略所有节点匹配成功的次数

 

【相关命令】

·            reset ip policy-based-route statistics

1.1.6  display ip policy-based-route local

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

【命令】

独立运行模式:

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

IRF模式:

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

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【参数】

slot slot-number:显示指定单板上本地策略路由的配置信息和统计信息。slot-number表示单板所在的槽位号。(独立运行模式)

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-3 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

策略所有节点匹配成功的次数

 

【相关命令】

·            reset ip policy-based-route statistics

1.1.7  display ip policy-based-route setup

display ip policy-based-route setup命令用来显示已经应用的策略路由信息。

【命令】

display ip policy-based-route setup

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

mdc-admin

mdc-operator

【举例】

# 显示已经应用的策略路由信息。

<Sysname> display ip policy-based-route setup

Policy Name              Interface Name

pr01                     Vlan-interface1

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

字段

描述

policy Name

策略名

Interface Name

应用策略的接口

 

【相关命令】

·            ip policy-based-route

1.1.8  if-match acl

if-match acl命令用来设置ACL匹配规则。

undo if-match acl命令用来删除ACL匹配规则。

【命令】

if-match acl { acl-number | name acl-name }

undo if-match acl

【缺省情况】

未设置ACL匹配规则。

【视图】

策略节点视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

acl-number:访问控制列表号,取值范围为2000~3999。其中:

·            基本ACL,acl-number取值范围为2000~2999;

·            高级ACL,acl-number取值范围为3000~3999。

name acl-name:指定ACL的名称。acl-name表示ACL的名称,为1~63个字符的字符串,不区分大小写,必须以英文字母a~z或A~Z开头。为避免混淆,ACL的名称不允许使用英文单词all。

【举例】

# 设置满足ACL 2011的报文被匹配。

<Sysname> system-view

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

[Sysname-pbr-aa-11] if-match acl 2011

# 设置满足ACL名称为aaa的报文被匹配。

<Sysname> system-view

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

[Sysname-pbr-aa-11] if-match acl name aaa

1.1.9  if-match vxlan-id

说明

仅Release 1138P01及以上版本支持本命令。

 

if-match vxlan-id命令用来设置VXLAN匹配规则。

undo if-match vxlan-id命令用来恢复缺省情况。

【命令】

if-match vxlan-id vxlan-id

undo if-match vxlan-id

【缺省情况】

未设置VXLAN匹配规则。

【视图】

策略节点视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

vxlan-id:VXLAN ID,取值范围为0~16777215。

【举例】

# 设置VXLAN ID为1000的VXLAN报文被匹配。

<Sysname> system-view

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

[Sysname-pbr-aaa-11] if-match vxlan-id 1000

1.1.10  ip local policy-based-route

ip local policy-based-route命令用来对本地报文应用策略。

undo ip local policy-based-route命令用来删除对本地报文应用策略的设置。

【命令】

ip local policy-based-route policy-name

undo ip local policy-based-route

【缺省情况】

对本地报文没有应用策略。

【视图】

系统视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

policy-name:策略名,唯一标识一个策略,为1~19个字符的字符串,区分大小写。该策略必须已经存在。

【使用指导】

对本地报文只能应用一个策略。应用新的策略前必须删除本地原来已经应用的策略。

对本地报文应用的策略将对本地产生的所有报文进行匹配。若无特殊需求,建议用户不要配置本地策略路由。

【举例】

# 对本地报文应用策略aaa。

<Sysname> system-view

[Sysname] ip local policy-based-route aaa

【相关命令】

·            display ip policy-based-route setup

·            policy-based-route

1.1.11  ip policy-based-route

ip policy-based-route命令用来对接口转发的报文应用策略。

undo ip policy-based-route命令用来删除对接口转发的报文应用的策略。

【命令】

ip policy-based-route policy-name

undo ip policy-based-route

【缺省情况】

对接口转发的报文没有应用策略。

【视图】

接口视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

policy-name:策略名,唯一标识一个策略,为1~19个字符的字符串,区分大小写。该策略必须已经存在。

【使用指导】

对接口转发的报文应用策略时,一个接口只能应用一个策略。应用新的策略前必须删除接口上原来已经应用的策略。

【举例】

# 对接口Vlan-interface2转发的报文应用策略aaa。

<Sysname> system-view

[Sysname] vlan 2

[Sysname-Vlan2] interface vlan-interface 2

[Sysname-Vlan-interface2] ip policy-based-route aaa

【相关命令】

·            display ip policy-based-route setup

·            policy-based-route

1.1.12  ip policy-based-route egress

说明

仅Release 1138P01及以上版本支持本命令。

 

ip policy-based-route egress命令用来对从接口转发出去的报文应用策略路由。

undo ip policy-based-route egress命令用来恢复缺省情况。

【命令】

ip policy-based-route policy-name egress

undo ip policy-based-route egress

【缺省情况】

未对从接口发送出去的报文应用策略路由。

【视图】

VXLAN模式Tunnel接口视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

policy-name:策略名,唯一标识一个策略,为1~19个字符的字符串,区分大小写。该策略必须已经存在。

【举例】

# 配置Tunnel 0口出方向的策略路由。

<Sysname> system-view

[Sysname] interface Tunnel 0 mode vxlan

[Sysname-Tunnel0] ip policy-based-route aaa egress

1.1.13  ip policy-based-route vxlan-mode enable

说明

Release 1138P01及以上版本支持本命令

 

ip policy-based-route vxlan-mode enable命令用来开启VXLAN模式的策略路由功能。

undo ip policy-based-route vxlan-mode enable命令用来关闭VXLAN模式的策略路由功能。

【命令】

ip policy-based-route vxlan-mode enable

undo ip policy-based-route vxlan-mode enable

【缺省情况】

VXLAN模式的策略路由功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

mdc-admin

【使用指导】

因为以下两条原因,所以建议用户需要在接口上应用策略前执行本功能,避免设备重复刷新接口表项。

·            执行本命令切换模式会导致重复刷新所有接口表项,表项很多的情况下耗时较长。

·            重复刷新接口的顺序和配置顺序可能不相同,会导致命令执行前资源充足,执行后出现资源不足的情况。

【举例】

# 开启VXLAN模式的策略路由功能。

<Sysname> system-view

[Sysname] ip policy-based-route vxlan-mode enable

1.1.14  policy-based-route

policy-based-route命令用来创建策略节点,并进入策略节点视图。如果指定的策略节点已创建,则该命令直接用来进入该策略节点的视图。

undo policy-based-route命令用来删除已创建的策略或策略节点。

【命令】

policy-based-route policy-name [ deny | permit ] node node-number

undo policy-based-route policy-name [ deny | node node-number | permit ]

【缺省情况】

没有创建策略节点。

【视图】

系统视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

policy-name:策略名,唯一标识一个策略,为1~19个字符的字符串,区分大小写。

deny:指定策略节点的匹配模式为拒绝模式。

permit:指定策略节点的匹配模式为允许模式。缺省匹配模式为permit

node node-number:策略节点编号。节点编号越小优先级越高,先对优先级高的节点进行匹配操作,取值范围为0~255。

【使用指导】

删除策略之前,必须先取消该策略在所有接口或者本地上的应用,否则删除失败。

配置undo命令时,如果指定了策略节点,将删除指定的节点;如果指定了节点模式,将按模式删除策略内所有与该模式匹配的所有节点;如果两者都没有指定,将删除整个策略。

【举例】

# 配置一个策略policy1,其节点序列号为10,匹配模式为permit,并进入策略节点视图。

<Sysname> system-view

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

[Sysname-pbr-policy1-10]

【相关命令】

·            display ip policy-based-route

1.1.15  reset ip policy-based-route statistics

reset ip policy-based-route statistics命令用来清除策略路由的统计信息。

【命令】

reset ip policy-based-route statistics [ policy policy-name ]

【视图】

用户视图

【缺省用户角色】

network-admin

mdc-admin

【参数】

policy policy-name:清除指定策略的统计信息。policy-name表示策略名,唯一标识一个策略,为1~19个字符的字符串,区分大小写。

【使用指导】

系统按照策略名清除策略路由的统计信息。如果不指定策略名,将清除所有配置策略的匹配统计信息(该统计信息可以通过display ip policy-based-route interface命令查看);如果指定策略名,将清除指定策略的匹配统计信息。

【举例】

# 清除所有配置策略的统计信息。

<Sysname> reset ip policy-based-route statistics

【相关命令】

·            display ip policy-based-route interface

·            display ip policy-based-route local

 

不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!

新华三官网
联系我们