• 产品与解决方案
  • 行业解决方案
  • 服务
  • 支持
  • 合作伙伴
  • 关于我们

07-三层技术-IP业务命令参考

目录

15-IP转发基础命令

本章节下载 15-IP转发基础命令  (330.32 KB)

15-IP转发基础命令


1 IP转发基础

1.1  IP转发基础配置命令

1.1.1  clear hpf trace

clear hpf trace命令用来清除设备上所有的HPF Trace信息。

【命令】

clear hpf trace slot slot-number

【视图】

用户视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number:指定单板。slot-number为单板所在的槽位号。对于本产品,slot-number只能为固定取值,表示整台设备。‌

【使用指导】

本命令仅在当前转发模式为HPF转发模式时生效。

【举例】

# 清除Slot 1上所有的Trace信息。‌‌

<Sysname> clear hpf trace slot 1

This operation will clear all HPF trace data. Are you sure you want to continue? [Y/N]:

【相关命令】

·     hpf trace add

·     hpf trace filter

·     display hpf trace

1.1.2  display hpf memory heap

display hpf memory heap命令用来显示依赖HPF的业务模块使用的堆内存统计信息

【命令】

display hpf memory heap [ tag tag-id ] [ size block-size | verbose ] [ slot slot-number [ cpu cpu-number ] ]

display hpf memory heap tag [ slot slot-number [ cpu cpu-number ] ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

tag tag-id:显示指定业务模块使用的堆内存的统计信息。tag-id表示依赖HPF的业务模块的标识,用十六进制字符串表示,取值范围为0~FFFFFFFF。不指定tag-id参数时,表示所有依赖HPF的业务模块。

size block-size:内存块大小,取值范围为1~4294967295,单位为字节。

verbose显示堆内存详细统计信息。不指定该参数时,显示堆内存概要统计信息。

slot slot-number:指定单板。slot-number为单板所在的槽位号。如果不指定本参数,则表示指定主用主控板。对于本产品,slot-number只能为固定取值,无论是否指定本参数,均表示整台设备。‌

cpu cpu-number:表示CPU的编号。

【使用指导】

HPF转发流程被拆分为多个子功能模块,不同的报文可以同时由不同的子功能模块并行处理。相对于普通的转发模式,HPF转发模式使用了报文并行处理、子功能模块无锁化调度等技术,大大提升了报文转发速率。

【举例】

# 显示依赖HPF的业务模块使用的堆内存统计信息。

<Sysname> display hpf memory heap

Total HPF memory heap space(in bytes): 344256

# 按不同tag显示依赖HPF的业务模块使用的堆内存统计信息。

<Sysname> display hpf memory heap tag

Heap usage:

Tag            Used blocks    Used bytes            Usage ratio

0x0            1              960                          0.3%

0x3b50000      78             343296                      99.7%

 

Summary:

Total HPF memory heap space(in bytes): 344256

# 显示依赖HPF的业务模块使用的堆内存详细统计信息。

<Sysname> display hpf memory heap verbose

Heap usage:

Size (bytes)   Used bytes              Usage ratio

64             64                             0.0%

96             96                             0.0%

416            416                            0.1%

480            480                            0.1%

560            560                            0.2%

960            960                            0.3%

1136           1136                           0.3%

1184           78144                         22.7%

2384           2384                           0.7%

5040           5040                           1.5%

5840           5840                           1.7%

58928          58928                         17.1%

63456          63456                         18.4%

126752         126752                        36.8%

 

Summary:

Total HPF memory heap space(in bytes): 344256

# 显示依赖HPF的业务模块申请的1184字节的内存块的首地址(最多显示128个)。

<Sysname> display hpf memory heap size 1184

0x7fc82df7fc48  0x7fc82df800e8  0x7fc82df80588  0x7fc82df8acc8

0x7fc82df8b288  0x7fc82df8b728  0x7fc82df8bbc8  0x7fc82df8c068

0x7fc82df8c508  0x7fc82df8c9a8  0x7fc82df8ce48  0x7fc82df8d2e8

0x7fc82df8d788  0x7fc82df8de88  0x7fc82df8fa48  0x7fc82df8fee8

0x7fc82df90388  0x7fc82df9d8d8  0x7fc82df9dd78  0x7fc82df9e268

0x7fc82df9e708  0x7fc82df9eba8  0x7fc82df9f048  0x7fc82df9f4e8

0x7fc82df9f988  0x7fc82df9fe28  0x7fc82dfa02c8  0x7fc82dfa0768

0x7fc82dfa0c08  0x7fc82dfa10a8  0x7fc82dfa1648  0x7fc82dfa1ae8

0x7fc82dfa1f88  0x7fc82dfa2428  0x7fc82dfa28c8  0x7fc82dfa2d68

0x7fc82dfa3208  0x7fc82dfa36a8  0x7fc82dfa3b48  0x7fc82dfa3fe8

0x7fc82dfa4488  0x7fc82dfa4928  0x7fc82dfa4dc8  0x7fc82dfa5268

0x7fc82dfa5708  0x7fc82dfa5ba8  0x7fc82dfa6048  0x7fc82dfa64e8

0x7fc82dfa6988  0x7fc82dfa7698  0x7fc82dfa7b98  0x7fc82dfa8038

0x7fc82dfa84d8  0x7fc82dfa8978  0x7fc82dfa8e18  0x7fc82dfa92b8

0x7fc82dfa9758  0x7fc82dfa9bf8  0x7fc82dfaa098  0x7fc82dfaa538

0x7fc82dfaa9d8  0x7fc82dfaae78  0x7fc82dfab4f8  0x7fc82dfab998

0x7fc82dfabe38  0x7fc82dfac2d8

表1-1 display hpf memory heap命令显示信息描述表

字段

描述

Heap usage

堆内存的使用情况

Tag

依赖HPF的业务模块的编号

Used blocks

使用的内存块个数

Used bytes

使用的内存大小,单位为字节

Usage ratio

业务功能模块使用的内存大小占HPF堆内存总大小的比例

Size (bytes)

内存块大小,单位为字节

Summary:

Total HPF memory heap space (in bytes)

HPF已经申请的堆内存总大小,单位为字节

 

【相关命令】

·     system-working-mode(设备管理命令参考/设备基本配置)

1.1.3  display hpf memory pool

display hpf memory pool命令用来显示依赖HPF的业务模块使用的Pool内存的统计信息

【命令】

display hpf memory pool [ slot slot-number [ cpu cpu-number ] ] [ pool-name name ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number:指定单板。slot-number为单板所在的槽位号。如果不指定本参数,则表示指定主用主控板。对于本产品,slot-number只能为固定取值,无论是否指定本参数,均表示整台设备。‌

cpu cpu-number:表示CPU的编号。

pool-name name:表示Pool内存的名称,为1~31个字符的字符串。不指定该参数时,显示所有Pool结构内存。

【举例】

# 显示依赖HPF的业务模块使用的Pool内存的统计信息。

<Sysname> display hpf memory pool

Pool memory name  : l3vpnIFVrfIndex

Total size        : 1056 bytes

Number of elements: 0

Free indices      :

表1-2 display hpf memory pool命令显示信息描述表

字段

描述

Pool memory name

Pool内存的名称

Total size

当前Pool内存的大小,单位为字节

Number of elements

当前Pool内存中可存放的元素的个数

Free indices

Pool内存中空闲内存块的索引

 

【相关命令】

·     system-working-mode(设备管理命令参考/设备基本配置)

1.1.4  display hpf trace

display hpf trace命令用来显示HPF Trace信息。

【命令】

display hpf trace [ max max-number ] slot slot-number

【视图】

用户视图

【缺省用户角色】

network-admin

network-operator

【参数】

max max-number:每个线程允许显示Trace信息的最大数目。max-number指定Trace信息数量,取值范围为1~100。不指定该参数时,默认每个线程允许显示Trace信息的最大数目为50。

slot slot-number:指定单板。slot-number为单板所在的槽位号。对于本产品,slot-number只能为固定取值,表示整台设备。‌

【使用指导】

HPF转发模式下,一个报文由入口Node节点开始,流经各个Node节点的处理流程会形成一条Trace信息。通过Trace信息可以定位HPF报文转发流程中出现的问题,如报文不通。

在通过hpf trace filter命令创建Trace信息过滤规则后,通过display hpf trace命令可以查看过滤后的Trace信息。

如果执行undo hpf trace filter命令删除Trace信息过滤规则后,通过display hpf trace命令可以查看当前设备上保存的Trace信息。

本命令仅在当前转发模式为HPF转发模式时执行生效。

【举例】

# 显示Slot 1注册的所有Trace信息。‌‌

<Sysname> display hpf trace slot 1

------------------- Start of thread 1 -------------------

Packet 1

Node Name: device-input

  Thread Index: 1             Time: 1818661423

  Node info:

  Input Interface Name: Ten-GigabitEthernet1/0/0

  Buffer Index: 2028             Software Interface Index: 2

  Packet Contents:

  00000000: ffffffffffffaa112233446a08060001080006040001aa112233446a4c01010b

  00000020: 0000000000004c01010200000000000000000000000000000000000000000000

Node Name: eth-input-single

  Thread Index: 1             Time: 1818661423

  Node info:

  Protocol Type:SrcMacAddr -> DstMacAddr:

  0806: aa:11:22:33:44:6a -> ff:ff:ff:ff:ff:ff

Node Name: arp-input

  Thread Index: 1             Time: 1818661423

 Node info:

 Opcode request,type hardwareType ethernet/ProtoType ip,address size HwAddrLen 6/ProtoAddrLen 4

 SrcMacAddr/SrcProtoAddr -> DstMacAddr/DstProtoAddr:

 aa:11:22:33:44:6a/76.1.1.11 -> 00:00:00:00:00:00/76.1.1.2

表1-3 display hpf trace命令显示信息描述表

字段

描述

Start of thread n

第n个线程的Trace信息

Packet n

第n个报文的Trace信息

Node Name

Node节点的名称

Thread Index

线程的索引

Time

记录Trace信息的时长

Node info

Node节点上报的Trace信息,具体内容与业务模块相关

 

1.1.5  display hpf trace filter

display hpf trace filter命令用来显示已配置的HPF Trace过滤规则。

【命令】

display hpf trace filter

【视图】

用户视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 显示已配置的HPF Trace过滤规则。

<Sysname> display hpf trace filter

HPF Trace:

Start Node: device-input(355)

Max Number: 100

Total Number: 2000

Start Node: ip4-local-output(220)

Max Number: 100

Total Number: 2000

 

HPF Filter:

Filter Rule: -

Filter Node: -

 

Module Filter:

  ETH: interface: Ten-GigabitEthernet1/0/1, ACL number: 2000

  IP: ACL number: 2500

  IPv6: ACL number: 3000

  TCP: ACL number: 2100, ACL6 number: 2900

  UDP: ACL number:2200, ACL6 number: 2600

表1-4 display hpf trace filter命令显示信息描述表

字段

描述

HPF Trace

HPF Trace相关信息

Start Node

HPF Trace起始Node节点名称和索引

Max Number

HPF Trace记录最大Trace数目

Total Number

HPF Trace筛查报文数目

HPF Filter

HPF框架的过滤信息

Filter Rule

过滤规则,若不存在规则,则显示为“-”

Filter Node

过滤的HPF Node节点,若不存在则显示为“-”

Module Filter

模块过滤信息

ETH

ETH模块

IP

IP模块

TCP

TCP模块

UDP

UDP模块

ACL number

过滤引用的ACL编号

ACL6 number

过滤引用的IPv6 ACL编号

 

【相关命令】

·     hpf trace filter

·     hpf trace filter ethernet

·     hpf trace filter ip

·     hpf trace filter ipv6

·     hpf trace filter tcp

·     hpf trace filter udp

1.1.6  display fib

display fib命令用来显示FIB表项的信息。

【命令】

display fib [ vpn-instance vpn-instance-name ] [ ip-address [ mask | mask-length ] ] [ slot slot-number ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

vpn-instance vpn-instance-name:显示指定VPN实例的FIB表项的信息。vpn-instance-name表示MPLS L3VPN的VPN实例名称,为1~31个字符的字符串,区分大小写。如果不指定VPN实例,则显示公网的FIB表项的信息。

ip-address:显示与指定目的IP地址匹配的FIB表项的信息。

mask:IP地址掩码。

mask-length:IP地址掩码长度,取值范围为0~32。

slot slot-number:指定单板。slot-number为单板所在的槽位号。如果不指定本参数,则表示指定主用主控板。对于本产品,slot-number只能为固定取值,无论是否指定本参数,均表示整台设备。‌

【使用指导】

通过本命令可以查看下发硬件成功的FIB数量。

如果配置ip-address时不指定掩码和掩码长度,则显示与指定目的IP地址最长匹配的FIB表项的信息;如果配置ip-address时指定了掩码或掩码长度,则显示与指定目的IP地址和掩码精确匹配的FIB表项的信息。

【举例】

# 显示公网的所有FIB表项的信息。

<Sysname> display fib

Route destination count: 5

Directly-connected host count: 0

Entries issued to hardware: 5

 

Flag:

  U:Usable    G:Gateway   H:Host   B:Blackhole   D:Dynamic   S:Static

  R:Relay     F:FRR

 

Destination/Mask   Nexthop         Flag     OutInterface/Token       Label

0.0.0.0/32         127.0.0.1       UH       InLoop0                  Null

1.1.1.0/24         192.168.126.1   USGF     M-GE0/0/0                Null

127.0.0.0/8        127.0.0.1       U        InLoop0                  Null

127.0.0.0/32       127.0.0.1       UH       InLoop0                  Null

127.0.0.1/32       127.0.0.1       UH       InLoop0                  Null

# 显示私网的FIB表项的信息。

<Sysname> display fib vpn-instance vpn1

Route destination count: 8

Directly-connected host count: 0

Entries issued to hardware: 5

 

Flag:

  U:Usable   G:Gateway   H:Host   B:Blackhole   D:Dynamic   S:Static

  R:Relay     F:FRR

 

Destination/Mask   Nexthop         Flag     OutInterface/Token       Label

0.0.0.0/32         127.0.0.1       UH       InLoop0                  Null

20.20.20.0/24      20.20.20.25     U        M-GE0/0/0                Null

20.20.20.0/32      20.20.20.25     UBH      M-GE0/0/0                Null

20.20.20.25/32     127.0.0.1       UH       InLoop0                  Null

20.20.20.25/32     20.20.20.25     H        M-GE0/0/0                Null

20.20.20.255/32    20.20.20.25     UBH      M-GE0/0/0                Null

20.20.20.255/32    1000:2000:3000:4000:5000:6000:7000:8000 UBH      MGE0

/0/0                Null

# 显示目的地址为10.2.1.1的FIB表项的信息。

<Sysname> display fib 10.2.1.1

FIB entry count: 1

Entries issued to hardware: 1

 

Flag:

  U:Usable   G:Gateway   H:Host   B:Blackhole   D:Dynamic   S:Static

  R:Relay     F:FRR

 

Destination/Mask   Nexthop         Flag     OutInterface/Token       Label

10.2.1.1/32        127.0.0.1       UH       InLoop0                  Null

表1-5 display fib命令显示信息描述表

字段

描述

Route destination count

路由目的地址的个数

Directly-connected host count

通过ARP等特性学到的直连主机个数

Entries issued to hardware

下发硬件成功的FIB表项个数

FIB entry count

FIB表项数目

Destination/Mask

目的地址/掩码长度

Nexthop

转发的下一跳地址

Flag

路由的标志:

·     U:表示可用路由

·     G:表示网关路由

·     H:表示主机路由

·     B:表示黑洞路由

·     D:表示动态路由

·     S:表示静态路由

·     R:表示迭代路由

·     F:表示快速重路由

OutInterface/Token

转发接口/LSP索引号

Label

内层标签值

 

1.1.7  display fib prefix diff

display fib prefix diff命令用来对比并显示指定Slot间FIB表项的差异信息。

【命令】

display fib prefix diff [ all | [ vpn-instance vpn-instance-name ] [ ip-address [ mask | mask-length ] ] ] slot slot-number1 slot slot-number2

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

all:对比全部公网和私网的FIB表项。

vpn-instance-name:对比指定VPN实例的FIB表项。vpn-instance-name表示MPLS L3VPN的VPN实例名称,为1~31个字符的字符串,不可以包含空格,区分大小写。

ip-address:对比与指定目的IPv4地址匹配的FIB表项的信息。

mask:IPv4地址掩码。

mask-length:IPv4地址掩码长度,取值范围为0~32。

slot slot-number1 slot slot-number2:对比指定单板的FIB表项的信息。slot-number1为指定单板所在的槽位号,slot-number2为另一个指定单板所在的槽位号。使用本命令时必须指定两块不同的单板。‌

【使用指导】

应用场景

当出现主控板与接口板间报文丢包、接口板处理报文不及时或接口板报文队列积压等异常时,可能是由于Slot间表项不一致造成,可以通过本命令对比主控板与接口板间的FIB表项的差异信息,查看是否存在板间表项不一致的情况。如果出现板间表项不一致的情况,可以在任意视图下执行display current-configuration diff命令,对比下次启动配置文件与运行配置之间的差异,并排查是否存在不必要的配置。

工作机制

指定ip-address时可以选择匹配网段范围,如果配置ip-address时不指定掩码和掩码长度,则对比与指定目的IPv4地址最长匹配的FIB表项;如果配置ip-address时指定了掩码或掩码长度,则对比与指定目的IPv4地址和掩码精确匹配的FIB表项。

【举例】

# 对比Slot 0和Slot 3的FIB表项差异。‌‌

<Sysname> display fib prefix diff slot 0 slot 3

--- Slot 0 CPU 0

+++ Slot 3 CPU 0

@@ -1,19 +0,0 @@

-

-Destination/Mask:0.0.0.0/32           VNID:0x310000003        VPN:--

-Destination/Mask:10.0.0.0/24          VNID:0x710000007        VPN:--

-Destination/Mask:10.0.0.0/32          VNID:0x710000007        VPN:--

-Destination/Mask:10.0.0.1/32          VNID:0x310000003        VPN:--

-Destination/Mask:10.0.0.2/32          VNID:--                 VPN:--

-Destination/Mask:10.0.0.255/32        VNID:0x710000007        VPN:--

-Destination/Mask:30.0.0.0/24          VNID:0x17000000         VPN:--

-Destination/Mask:127.0.0.0/8          VNID:0x310000003        VPN:--

-Destination/Mask:127.0.0.0/32         VNID:0x410000004        VPN:--

-Destination/Mask:127.0.0.1/32         VNID:0x310000003        VPN:--

-Destination/Mask:127.255.255.255/32   VNID:0x410000004        VPN:--

-Destination/Mask:172.16.94.0/24       VNID:0x610000006        VPN:--

-Destination/Mask:172.16.94.0/32       VNID:0x610000006        VPN:--

-Destination/Mask:172.16.94.100/32     VNID:0x310000003        VPN:--

-Destination/Mask:172.16.94.200/32     VNID:--                 VPN:--

-Destination/Mask:172.16.94.201/32     VNID:--                 VPN:--

-Destination/Mask:172.16.94.255/32     VNID:0x610000006        VPN:--

-Destination/Mask:255.255.255.255/32   VNID:0x310000003        VPN:--

\ No newline at end of file

+Destination/Mask:192.168.100.10/24    VNID:--                 VPN:--

+Destination/Mask:192.168.100.20/24    VNID:--                 VPN:--

\ No newline at end of file

表1-6 display fib prefix diff命令显示信息描述表

字段

描述

--- A

+++ B

·     A表示参与比较的源Slot和CPU编号

·     B表示参与比较的目的Slot和CPU编号

@@ -linenumber1,number1 +linenumber2,number2 @@

·     -linenumber1,number1:表示从Alinenumber1开始显示,共显示number1

·     +linenumber2,number2:表示从Blinenumber2开始显示,共显示number2

Destination/Mask

目的地址/掩码长度。

·     该字段前面显示为“-”时,表示表项在A中存在,在B中不存在

·     该字段前面显示为“+”时,表示表项在B中存在,在A中不存在

VNID

VN ID,显示为“--”时表示无VN ID

VPN

VPN实例名称,显示为“--”时表示公网

No newline at end of file

没有更多的对比结果

 

1.1.8  display fib vn diff

display fib vn diff命令用来对比并显示指定Slot间FIB VN表项差异信息。

【命令】

display fib vn diff [ id id ] slot slot-number1 slot slot-number2

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

id id:按指定VN ID对比VN表项详细信息。

slot slot-number1 slot slot-number2:对比指定单板的VN表项的信息。slot-number1为指定单板所在的槽位号,slot-number2为另一个指定单板所在的槽位号。使用本命令时必须指定两块不同的单板。‌

【使用指导】

当出现主控板与接口板间报文丢包、接口板处理报文不及时或接口板报文队列积压等异常时,可能是由于Slot间表项不一致造成,可以通过本命令对比主控板与接口板间的VN表项的差异信息,查看是否存在板间表项不一致的情况。如果出现板间表项不一致的情况,可以在任意视图下执行display current-configuration diff命令,对比下次启动配置文件与运行配置之间的差异,并排查是否存在不必要的配置。

不指定id时对比全部FIB VN表项。

【举例】

# 对比Slot 0和Slot 3的FIB VN表项差异。‌‌

<Sysname> display fib vn diff slot 0 slot 3

--- Slot 0 CPU 0

+++ Slot 3 CPU 0

@@ -1,19 +1,2 @@

 

-VNID:0x810000008        NextHopNum:1     Flag:U    Nexthop:[0]10.0.0.1

-VNID:0x70000001         NextHopNum:1     Flag:--   Nexthop:[0]Invalid

-VNID:0x10000000         NextHopNum:1     Flag:U    Nexthop:[0]127.0.0.1

-VNID:0x20000000         NextHopNum:1     Flag:U    Nexthop:[0]::1

-VNID:0x510000005        NextHopNum:1     Flag:U    Nexthop:[0]127.0.0.1

-VNID:0x520000005        NextHopNum:1     Flag:U    Nexthop:[0]::

-VNID:0x210000002        NextHopNum:1     Flag:--   Nexthop:[0]0.0.0.0

-VNID:0x220000002        NextHopNum:1     Flag:U    Nexthop:[0]::1

-VNID:0x710000007        NextHopNum:1     Flag:U    Nexthop:[0]10.0.0.1

-VNID:0x410000004        NextHopNum:1     Flag:U    Nexthop:[0]127.0.0.1

-VNID:0x420000004        NextHopNum:1     Flag:U    Nexthop:[0]::

-VNID:0x110000001        NextHopNum:1     Flag:U    Nexthop:[0]127.0.0.1

-VNID:0x120000001        NextHopNum:1     Flag:U    Nexthop:[0]::

-VNID:0x610000006        NextHopNum:1     Flag:U    Nexthop:[0]172.16.94.100

-VNID:0x17000000         NextHopNum:2     Flag:--   Nexthop:[0]172.16.94.200

-VNID:0x17000000         NextHopNum:2     Flag:--   Nexthop:[1]172.16.94.201

-VNID:0x310000003        NextHopNum:1     Flag:--   Nexthop:[0]0.0.0.0

-VNID:0x320000003        NextHopNum:1     Flag:U    Nexthop:[0]::

\ No newline at end of file

+VNID:0x70000001         NextHopNum:1     Flag:--   Nexthop:[0]Invalid

\ No newline at end of file

表1-7 display fib vn diff命令显示信息描述表

字段

描述

--- A

+++ B

·     A表示参与比较的源Slot和CPU编号

·     B表示参与比较的目的Slot和CPU编号

@@ -linenumber1,number1 +linenumber2,number2 @@

·     -linenumber1,number1:表示从Alinenumber1开始显示,共显示number1

·     +linenumber2,number2:表示从Blinenumber2开始显示,共显示number2

VNID

虚拟下一跳的ID

NextHopNum

总下一跳个数

Nexthop

下一跳信息[Number]IP,其中:

·     Number:下一跳的编号,从0开始编号

·     IP:IPv4或者IPv6下一跳地址

Flag

标记位,取值及含义如下:

·     U:下一跳生效

·     --:下一跳不生效

No newline at end of file

没有更多的对比结果

 

1.1.9  hpf frame-queue-trace enable

hpf frame-queue-trace enable命令用来开启指定业务模块的frame-queue的Trace信息记录功能。

undo hpf frame-queue-trace命令用来关闭指定业务模块的frame-queue的Trace信息记录功能。

【命令】

hpf frame-queue-trace { name name | index index } enable slot slot-number

undo hpf frame-queue-trace { name name | index index } slot slot-number

【缺省情况】

指定业务模块的frame-queue的Trace信息记录功能处于关闭状态。

【视图】

用户视图

【缺省用户角色】

network-admin

network-operator

【参数】

name name:业务模块的frame queue名称,name表示frame queue的名称,取值范围为1~32个字符,支持字母和横杠或下划线,区分大小写。

index index:业务模块的frame queue索引,创建frame queue时会为其分配索引,index表示frame queue的索引,取值范围为1~65535。

slot slot-number:指定单板。slot-number为单板所在的槽位号。对于本产品,slot-number只能为固定取值,表示整台设备。‌

【使用指导】

HPF转发模式下,报文可能会跨线程处理,例如IPv4报文分片重组时,需要将同一个报文的不同分片整合到同一个线程上进行重组。frame queue是业务模块跨线程处理报文时生成的数据结构,用于暂时存放报文。

通过本命令开启指定业务模块的frame-queue的Trace信息记录功能后,当指定业务模块出现跨线程报文处理时,可以通过display system internal hpf frame-queue trace命令查看到相关的trace信息,并通过display system internal hpf frame-queue histogram trace查看到报文跨线程处理的频率。

【举例】

# 查看Slot 1所有业务模块的frame queue的Trace信息。‌‌

<Sysname> display system internal hpf frame-queue trace slot 1

Worker handoff frame queue name ip4-full-reassembly index 0 (next node ip4-full-reassembly):

No trace data for frame queues

Worker handoff frame queue name ip6-full-reassembly index 1 (next node ip6-full-reassembly):

No trace data for frame queues

……

# 在Slot 1开启frame-queue名称为ip4-full-reassembly的IPv4报文分片重组业务模块的Trace信息记录功能。‌‌

<Sysname> hpf frame-queue-trace name ip4-full-reassembly enable slot 1

【相关命令】

·     display system internal hpf frame-queue trace

·     display system internal hpf frame-queue histogram trace

1.1.10  hpf thread clear

hpf thread clear命令用来清除HPF所有线程的运行数据。

【命令】

hpf thread clear slot slot-number

【视图】

用户视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number:指定单板。slot-number为单板所在的槽位号。对于本产品,slot-number只能为固定取值,表示整台设备。‌

【使用指导】

本命令仅在当前转发模式为HPF转发模式时执行生效。

【举例】

# 清除Slot 1所有线程的运行数据。‌‌

<Sysname> hpf thread clear slot 1

1.1.11  hpf trace add

hpf trace add命令用来开启指定起始Node节点的Trace信息记录功能。

undo hpf trace add关闭指定起始Node节点的Trace信息记录功能。

【命令】

hpf trace add { node-name node-name | node-index node-index } max-record-count max-record-number [ total-filter-count total-filter-number ] slot slot-number

undo hpf trace add { node-name node-name | node-index node-index } slot slot-number

【缺省情况】

指定起始Node节点的Trace信息记录功能处于关闭状态。

【视图】

用户视图

【缺省用户角色】

network-admin

network-operator

【参数】

node-name node-name:Node节点的名称。node-name表示Node节点的名称,取值范围为1~32个字符,支持字母和横杠或下划线,区分大小写。目前支持的Node名称为device-input、ip4-local-output和ip6-localout。

node-index node-index:Node节点的索引。node-index表示Node节点的索引,取值范围为1~65535。

max-record-count max-record-number:每个HPF转发线程每次记录指定起始Node节点Trace信息的最大数量,如果配置了其它业务模块的过滤规则,则表示命中规则的Trace信息最大数量。max-record-number表示记录Trace信息的最大数量,取值范围为1~100,每个线程最多累计记录1000条指定Node的Trace信息。

total-filter-count total-filter-number:每个线程允许过滤的Trace信息的最大数量,超过这个数量后,自动停止记录Trace。total-number表示过滤处理报文信息的最大数量,取值范围为1~1000000。

slot slot-number:指定单板。slot-number为单板所在的槽位号。对于本产品,slot-number只能为固定取值,表示整台设备。‌

【使用指导】

应用场景

HPF转发模式下,不同报文的起始Node节点可能不同。通过本命令指定Node节点,只有报文的起始节点为指定节点时,才记录报文的Trace信息。

工作机制

执行命令后:

·     当配置total-filter-number时,每个HPF转发线程会从最近total-filter-number个Trace信息内,过滤出max-record-number个Trace信息。

·     当没有配置total-filter-number时,每个HPF转发线程会从所有记录的Trace信息内,过滤出max-record-number个Trace信息。

多次执行本命令,对于特定Node节点而言,生效的max-record-number值是每一次执行值的和,而不是最后一次的执行值,当一个线程的max-record-number累计达到1000后,再次执行display hpf trace命令将无法查看到该线程新的Trace信息,此时需要通过clear hpf trace清除掉所有HPF Trace信息,重新配置本命令来查看新生成的Trace信息。

推荐配置

建议配置total-filter-number的值大于max-record-number值。

注意事项

本命令仅在当前转发模式为HPF转发模式时执行生效。

【举例】

# 在Slot 1开启入口Node节点为device-input的100个报文的Trace信息记录功能。‌‌

<Sysname> hpf trace add device-input max-record-count 100 slot 1

【相关命令】

·     clear hpf trace

·     trace hpf filter

·     display hpf trace

1.1.12  hpf trace filter

hpf trace filter命令用来配置以Node节点名称/索引来过滤HPF Trace信息的规则。

undo hpf trace filter命令用来删除以Node节点名称/索引来过滤HPF Trace信息的规则。

【命令】

hpf trace filter { exclude | include } { node-name node-name | node-index node-index } max-count count-num slot slot-number

undo trace hpf filter slot slot-number

【缺省情况】

未配置以Node节点名称/索引来过滤HPF Trace信息的规则。

【视图】

用户视图

【缺省用户角色】

network-admin

network-operator

【参数】

exclude:过滤结果不包含指定Node节点的Trace信息。

include:过滤结果只包含指定Node节点的Trace信息。

node-name node-name:过滤条件中指定Node节点的名称。node-name表示Node节点的名称,取值范围为1~32个字符,支持字母和横杠或下划线,区分大小写。

node-index node-index:过滤条件中指定Node节点的索引。node-index表示Node节点的索引,取值范围为1~65535。

max-count count-num:过滤后允许获取Trace信息的最大数目,取值范围为1~100。以时间顺序过滤最近的Trace信息。

slot slot-number:指定单板。slot-number为单板所在的槽位号。对于本产品,slot-number只能为固定取值,表示整台设备。‌

【使用指导】

应用场景

当网络出现丢包时,可以通过本命令配置HPF Trace信息的过滤规则,用于查看指定Node处理报文的Trace信息。通过过滤后的Trace信息来判断报文在哪个Node节点丢弃以及丢弃的原因。

执行本命令后,通过display hpf trace命令可以查看经过指定Node处理的报文的Trace信息。

注意事项

本命令仅在当前转发模式为HPF转发模式生效。

多次执行本命令,以最后一次执行的结果为准。

【举例】

# 配置Slot 1过滤Trace信息的结果只包含名称为error-drop的Node。‌‌

<Sysname> trace hpf filter include node-name error-drop max-count 1 slot 1

【相关命令】

·     trace hpf add

·     display hpf trace

·     clear hpf trace

1.1.13  hpf trace filter ethernet

hpf trace filter ethernet命令用来配置Ethernet模块HPF Trace信息的过滤规则。

【命令】

hpf trace filter ethernet { acl { [ ipv6 ] { advanced-acl-number | basic-acl-number } | mac mac-acl-number } | interface interface-type interface-number } slot slot-number

undo hpf trace filter ethernet slot slot-number

【缺省情况】

未配置Ethernet模块HPF Trace信息的过滤规则。

【视图】

用户视图

【缺省用户角色】

network-admin

network-operator

【参数】

acl:指定ACL为规则过滤HPF Trace信息。

ipv6:IPv6 ACL。

advanced-acl-number:高级ACL的编号,取值范围为3000~3999。

basic-acl-number:基本ACL的编号,取值范围为2000~2999。

mac mac-acl-number:二层ACL的编号,取值范围为4000~4999。

interface interface-type interface-number:指定报文的出/入接口为规则过滤HPF Trace信息,interface-type interface-number:指定接口的类型和编号。

slot slot-number:指定单板。slot-number为单板所在的槽位号。对于本产品,slot-number只能为固定取值,表示整台设备。‌

【使用指导】

执行本命令后,通过display hpf trace命令可以查看过滤后的报文Trace信息。

引用ACL时,若引用的ACL不存在,或者引用的ACL中没有配置规则,过滤规则不生效。

【举例】

# 在Slot 1上指定Ethernet模块HPF Trace信息的过滤规则匹配IPv4 ACL 2001。‌‌

<Sysname> hpf trace filter ethernet acl 2001 slot 1

# 在Slot 1上指定Ethernet模块HPF Trace信息的过滤规则匹配IPv6 ACL 3001。

<Sysname> hpf trace filter ethernet acl ipv6 3001 slot 1

# 在Slot 1上指定Ethernet模块HPF Trace信息的过滤规则匹配二层ACL 4001。

<Sysname> hpf trace filter ethernet mac 4001 slot 1

1.1.14  hpf trace filter ip

hpf trace filter ip命令用来配置IP模块HPF Trace信息的过滤规则。

【命令】

hpf trace filter ip acl acl-number slot slot-number

undo hpf trace filter ip slot slot-number

【缺省情况】

未配置IP模块HPF Trace信息的过滤规则。

【视图】

用户视图

【缺省用户角色】

network-admin

network-operator

【参数】

acl acl-number:IPv4 ACL编号,取值范围及其代表的ACL类型如下:

·     2000~2999:表示基本ACL。

·     3000~3999:表示高级ACL。

slot slot-number:指定单板。slot-number为单板所在的槽位号。对于本产品,slot-number只能为固定取值,表示整台设备。‌

【使用指导】

执行本命令后,通过display hpf trace命令可以查看过滤后的报文Trace信息。

引用ACL时,若引用的ACL不存在,或者引用的ACL中没有配置规则,过滤规则不生效。

【举例】

# 指定Slot 1上IP模块HPF Trace信息的过滤规则匹配IPv4 ACL 2001。‌‌

<Sysname> hpf trace filter ip acl 2001 slot 1

1.1.15  hpf trace filter ipv6

hpf trace filter ipv6命令用来配置IPv6模块HPF Trace信息的过滤规则。

【命令】

hpf trace filter ipv6 acl acl-number slot slot-number

undo hpf trace filter ipv6 slot slot-number

【缺省情况】

未配置IPv6模块HPF Trace信息的过滤规则。

【视图】

用户视图

【缺省用户角色】

network-admin

network-operator

【参数】

acl acl-number:IPv6 ACL编号,取值范围及其代表的ACL类型如下:

·     2000~2999:表示基本ACL。

·     3000~3999:表示高级ACL。

slot slot-number:指定单板。slot-number为单板所在的槽位号。对于本产品,slot-number只能为固定取值,表示整台设备。‌

【使用指导】

执行本命令后,通过display hpf trace命令可以查看过滤后的报文Trace信息。

引用ACL时,若引用的ACL不存在,或者引用的ACL中没有配置规则,过滤规则不生效。

【举例】

# 指定Slot 1上IPv6模块HPF Trace信息的过滤规则匹配IPv6 ACL 2001。‌‌

<Sysname> hpf trace filter ipv6 acl 2001 slot 1

1.1.16  hpf trace filter tcp

hpf trace filter tcp命令用来配置TCP模块HPF Trace信息的过滤规则。

【命令】

hpf trace filter tcp { acl acl-number | acl6 ipv6-acl-number } slot slot-number

undo hpf trace filter tcp { acl | acl6 } slot slot-number

【缺省情况】

未配置TCP模块HPF Trace信息的过滤规则。

【视图】

用户视图

【缺省用户角色】

network-admin

network-operator

【参数】

acl acl-number:IPv4 ACL编号,取值范围及其代表的ACL类型如下:

·     2000~2999:表示基本ACL。

·     3000~3999:表示高级ACL。

acl6 ipv6-acl-number:IPv6 ACL编号,取值范围及其代表的ACL类型如下:

·     2000~2999:表示基本ACL。

·     3000~3999:表示高级ACL。

slot slot-number:指定单板。slot-number为单板所在的槽位号。对于本产品,slot-number只能为固定取值,表示整台设备。‌

【使用指导】

执行本命令后,通过display hpf trace命令可以查看过滤后的报文Trace信息。

引用ACL时,若引用的ACL不存在,或者引用的ACL中没有配置规则,过滤规则不生效。

【举例】

# 指定TCP模块HPF Trace信息的过滤规则匹配IPv4 ACL 2001‌‌

<Sysname> hpf trace filter tcp acl 2001 slot 1

#指定TCP模块HPF Trace信息的过滤规则匹配IPv6 ACL 2001

<Sysname> hpf trace filter tcp acl6 2001 slot 1

1.1.17  hpf trace filter udp

hpf trace filter udp命令用来配置UDP模块HPF Trace信息的过滤规则。

【命令】

hpf trace filter udp { acl acl-number | acl6 ipv6-acl-number } slot slot-number

undo hpf trace filter udp { acl | acl6 } slot slot-number

【缺省情况】

未配置UDP模块HPF Trace信息的过滤规则。

【视图】

用户视图

【缺省用户角色】

network-admin

network-operator

【参数】

acl acl-number:IPv4 ACL编号,取值范围及其代表的ACL类型如下:

·     2000~2999:表示基本ACL。

·     3000~3999:表示高级ACL。

acl6 ipv6-acl-number:IPv6 ACL编号,取值范围及其代表的ACL类型如下:

·     2000~2999:表示基本ACL。

·     3000~3999:表示高级ACL。

slot slot-number:指定单板。slot-number为单板所在的槽位号。对于本产品,slot-number只能为固定取值,表示整台设备。‌

【使用指导】

执行本命令后,通过display hpf trace命令可以查看过滤后的报文Trace信息。

引用ACL时,若引用的ACL不存在,或者引用的ACL中没有配置规则,过滤规则不生效。

【举例】

# 指定Slot 1上UDP模块HPF Trace信息的过滤规则匹配IPv4 ACL 2001‌‌

<Sysname> hpf trace filter udp acl 2001 slot 1

# 指定Slot 1上UDP模块HPF Trace信息的过滤规则匹配IPv6 ACL 2001

<Sysname> hpf trace filter udp acl6 2001 slot 1

1.1.18  ip fib consistency-check enable

ip fib consistency-check enable命令用来开启IPv4 FIB表项一致性检查功能。

undo ip fib consistency-check enable命令用来关闭IPv4 FIB表项一致性检查功能。

【命令】

ip fib consistency-check enable

undo ip fib consistency-check enable

【缺省情况】

IPv4 FIB表项一致性检查功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

通过本功能判断是否因为软硬件IPv4 FIB表项不一致导致报文丢包。开启IPv4 FIB表项一致性检查功能后,设备将定时对所有的IPv4 FIB软件表项和硬件表项进行检查,如果软件表项和硬件表项不一致,则根据IPv4 FIB软件表项刷新硬件表项。

【举例】

# 开启IPv4 FIB表项一致性检查功能。

<Sysname> system-view

[Sysname] ip fib consistency-check enable

1.1.19  ip forwarding

ip forwarding命令用来在接口未配置IPv4地址时,开启接口的IPv4报文转发功能。

undo ip forwarding命令用来在接口未配置IPv4地址时,关闭接口的IPv4报文转发功能。

【命令】

ip forwarding

undo ip forwarding

【缺省情况】

在接口未配置IPv4地址时,接口的IPv4报文转发功能处于关闭状态。

【视图】

接口视图

【缺省用户角色】

network-admin

【使用指导】

在同时支持IPv4协议和IPv6协议的设备上,IPv4路由的下一跳可以是IPv4地址或IPv6地址。如果出接口上未配置IPv4地址,IPv4报文将无法在该接口上进行转发。通过配置本命令,可以在接口未配置IPv4地址的情况下,实现IPv4报文在接口上的转发功能。

【举例】

# 在GigabitEthernet0/0/1接口未配置IPv4地址时,开启接口的IPv4报文转发功能。‌

<Sysname> system-view

[Sysname] interface gigabitethernet 0/0/1

[Sysname-GigabitEthernet0/0/1] ip forwarding

1.1.20  ip last-hop hold

ip last-hop hold命令用来开启转发保持上一跳功能。

undo ip last-hop hold命令用来关闭转发保持上一跳功能。

【命令】

ip last-hop hold

undo ip last-hop hold

【缺省情况】

转发保持上一跳功能处于关闭状态。

【视图】

三层以太网接口视图

三层以太网子接口视图

Dialer接口视图

【缺省用户角色】

network-admin

【使用指导】

接口上开启保持上一跳功能后,当该接口接收到正向流量的第一个IP报文,设备会根据流量特征以及上一跳信息,记录相反方向的转发邻居信息,当反向流量报文到达设备进行转发时,可以直接通过该转发邻居信息指导报文进行转发。

在支持快速转发的设备上,保持上一跳功能依赖于快速转发表项的建立,对于以太网类型的链路,如果上一跳的MAC地址发生变化,对应的快速转发表项需要重建才能使保持上一跳功能正常工作。

本命令不适用于MPLS组网中。

【举例】

# 开启转发保持上一跳功能。

<Sysname> system-view

[Sysname] interface gigabitethernet 0/0/1

[Sysname-GigabitEthernet0/0/1] ip last-hop hold

1.1.21  snmp-agent trap enable fib

snmp-agent trap enable fib命令用来开启FIB模块的告警功能。

undo snmp-agent trap enable fib命令用来关闭FIB模块的告警功能。

【命令】

snmp-agent trap enable fib

undo snmp-agent trap enable fib

【缺省情况】

FIB模块的告警功能处于开启状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

开启FIB模块的告警功能后,该模块会生成告警信息,用于报告该模块的重要事件,例如FIB消息的队列长度超过阈值时,设备将此信息记录在告警信息中,生成的告警信息将发送到设备的SNMP模块,通过设置SNMP中告警信息的发送参数,来决定告警信息输出的相关属性。有关告警信息的详细介绍,请参见“网络管理和监控配置指导”中的“SNMP”。

【举例】

# 关闭FIB的告警功能。

<Sysname> system-view

[Sysname] undo snmp-agent trap enable fib

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

新华三官网
联系我们