技术支持文档中心交换机园区交换机S1700&S2700参考指南命令参考

S1720, S2700, S5700, S6720 V200R011C10 命令参考

本文档介绍了设备中各特性的配置命令，包括每条命令的功能、格式、参数、视图、缺省级别、使用指南、举例和相关命令。

NQA配置命令

NQA配置命令

命令支持情况

默认所有款型均支持本章节命令，如有个别命令行或参数存在差异，请详见具体命令行中的说明。

agetime

命令功能

agetime命令用来配置NQA测试例的老化时间。

undo agetime命令用来恢复NQA测试例老化时间的缺省值。

缺省情况下，老化时间为0，表示测试例永不老化。

命令格式

agetime hh:mm:ss

undo agetime

参数说明

参数 参数说明 取值
hh:mm:ss 老化时间。 hh取值范围是0～23，mm取值范围是0～59，ss取值范围是0～59。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

为了防止测试例无休止地运行在系统中，需要定期对测试例进行老化。执行agetime命令配置老化时间，可以改变测试例在系统中存在的时间。

  • 当测试例处于inactive状态时，老化时间启动。当老化时间超时后，系统自动删除该测试例。
  • 当测试例处于active状态时，老化时间重新开始计时。

前置条件

使用命令前，必先用命令test-type指定测试例的测试类型。

注意事项

不能修改正在执行的测试例的老化时间。

使用实例

# 设置测试例user test的老化时间。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type icmp
[HUAWEI-nqa-user-test] agetime 1:0:0
相关主题

clear-records

命令功能

clear-records命令用来清除NQA测试例的统计信息。

命令格式

clear-records

参数说明

无

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

NQA使用结果统计表（results）和历史统计表（history）对测试例执行结果进行记录。每次测试例执行完毕，都会根据执行情况把统计信息记入结果统计表和历史统计表，通过以下命令可以对统计表进行查询，得到网络质量检测的统计数据： 多次测试后，如果统计表过大，可以执行clear-records命令清除本测试例的结果统计信息和历史统计信息。

配置影响

执行clear-records命令清除的统计信息无法恢复。

注意事项

不允许清除正在运行的测试例的统计信息。

使用该命令的前提为测试例下已有用test-type命令指定测试例的测试类型存在。

使用实例

# 清除测试例user test的所有统计结果。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type jitter
[HUAWEI-nqa-user-test] clear-records

community read cipher

命令功能

community read cipher命令用来配置用于SNMP测试的团体名。

undo community命令用来删除用于用户SNMP测试的团体名。

缺省情况下，系统中SNMP测试的团体名为public。

命令格式

community read cipher community-name

undo community

参数说明

参数 参数说明 取值
community-name 指定用户SNMP测试的团体名。 字符串形式，区分大小写，不能输入空格和问号等命令行专用字符。如果为明文，长度为1～32，如果为密文，长度为32～68。
说明：
当输入的字符串两端使用引号时，可在字符串中输入空格。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

团体是NMS和SNMP Agent的集合，用团体名来标志。团体名相当于密码，团体内的设备通信时需要使用团体名来进行认证。只有NMS和SNMP Agent上配置的团体名相同时，才能互相访问。

当SNMP Agent的版本为SNMPv1或者SNMPv2c时，SNMP测试例必须使用community read cipher命令配置团体名，且配置的团体名必须为被测SNMP Agent上已配置的只读权限团体名。当SNMP Agent的版本为SNMPv3时，由于SNMPv3没有团体名概念，可以不配置团体名。

前置条件

配置SNMP测试的团体名前，必须已经通过命令nqa成功配置NQA测试例，且通过命令test-type命令指定测试例的测试类型为SNMP。

使用实例

# 配置SNMP测试团体名。

<HUAWEI> system-view 
[HUAWEI] nqa test-instance user test1
[HUAWEI-nqa-user-test1] test-type snmp
[HUAWEI-nqa-user-test1] community read cipher Huawei-123

datafill

命令功能

datafill命令用来配置NQA测试例的填充字符。

undo datafill命令用来删除NQA测试例的填充字符。

缺省情况下，无填充字符。

命令格式

datafill fillstring

undo datafill

参数说明

参数 参数说明 取值
fillstring NQA测试报文的填充字符串。 字符串形式，支持空格但是不支持“？”，区分大小写，长度范围是1～230。缺省值是空字符串（长度为零）。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

在NQA测试中，为了得到更精确的统计数据，需要根据实际业务模拟数据报的大小，通过执行datasize命令可以设置报文数据区大小。为了能够区分不同的测试例发出的报文，可以在报文数据区填充指定的特殊字符串，来实现对测试报文的标识。

前置条件

必先执行test-type命令指定测试例的测试类型，支持的测试类型为：

  • UDP
  • UDP Jitter
  • ICMP
  • Trace
  • Path Jitter

配置影响

在执行datafill命令进行报文填充时：

  • 如果测试例发送数据包的大小比配置的填充数据小，只使用填充字符串的前一部分。

  • 如果测试例发送数据包的大小比配置的填充数据大，则使用填充字符串循环填充。

例如，配置填充字符串为“abcd”，如果测试数据包大小为3，则只使用“abc”填充；如果测试数据包大小为6，则使用“abcdab”填充。

注意事项

不能修改正在执行的测试例的填充字符。

使用实例

# 设置测试例user test的填充字符串为“abcd”。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type icmp
[HUAWEI-nqa-user-test] datafill abcd

datasize

命令功能

datasize命令用来配置NQA测试例的报文大小。

undo datasize命令用来恢复NQA测试例的报文大小的缺省值。

缺省情况下，datasize的值为0，表示不携带负载报文。

命令格式

datasize size

undo datasize

参数说明

参数 参数说明 取值
size

NQA测试发送的报文大小。
单位是字节，整数形式，取值范围是0～8100。如果配置的报文大小比报文默认长度小，实际的报文大小就按默认报文长度处理。
说明：
仅对于MAC Ping测试例，取值范围是95～9000。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

执行datasize命令可以设置报文数据区大小，从而实现模拟实际业务数据包大小，得到更加精确的统计数据。

例如，使用UDP jitter测试例对VoIP（Voice over IP）业务进行检测时，可以执行datasize命令设置数据包大小，使其与实际的语音数据包大小一致，实现在一段时间内模拟某种数据的真实流量。

如果需要模拟64kbit/s的语音流，可以设置报文大小为172字节（160 bytes payload +12 bytes RTP header + 28 bytes IP header and UDP header），每隔20ms发一个包。这样，一分钟可以发送3000个报文。

前置条件

使用命令前，必先用命令test-type指定测试类的测试类型。

只能对LSP Ping、LSP Jitter、PWE3 Ping、ICMP、MAC Ping、Path Jitter、Trace、UDP和UDP Jitter类型的测试例配置测试报文大小。

注意事项

不能修改正在执行的测试例的报文大小。

使用实例

# 设置测试例user test发送的报文大小为100字节。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type icmp
[HUAWEI-nqa-user-test] datasize 100

description（NQA测试例视图）

命令功能

description命令用来配置NQA测试例的描述信息。

undo description命令用来删除NQA测试例的描述信息。

缺省情况下，NQA测试例没有配置描述信息。

命令格式

description string

undo description

参数说明

参数 参数说明 取值
string NQA测试例的描述信息。 字符串形式，支持空格，区分大小写，长度范围是1～230。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

执行description命令可以对一个测试例进行简要的描述，以方便维护。通常用于描述一个测试例所做的测试项或测试目的。

前置条件

使用命令前，必先用命令test-type指定测试例的测试类型。

配置影响

如果已经配置过某个测试例的描述信息，再执行description命令操作将覆盖原来的设置。

注意事项

不能修改正在执行的测试例的描述信息。

使用实例

# 设置测试例user test的描述信息为“fortest”。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type jitter
[HUAWEI-nqa-user-test] description fortest
相关主题

destination-address

命令功能

destination-address命令用来配置NQA测试例的目的地址。

undo destination-address命令用来删除NQA测试例的目的地址。

缺省情况下，没有配置目的地址。

命令格式

destination-address ipv4 ipv4-address [ lsp-masklen masklen | lsp-loopback loopback-address ] * [ vpn-frr-path ]

destination-address mac mac-address

destination-address remote-mep mep-id rmep-id

destination-address url urlstring

undo destination-address

参数说明

参数 参数说明 取值
ipv4 ipv4-address 目的地址为IPv4类型。 地址采用点分十进制格式。
lsp-masklen masklen 设置LSP IPv4地址前缀的掩码长度。 整数形式，取值范围是0～32。
lsp-loopback loopback-address 设置MPLS Echo Request报文头中127/8系列的IP地址。 -
vpn-frr-path 指定VPN FRR备路径连通性检测。 -
mac mac-address 设置单播mac地址。 地址采用H-H-H格式，每个H代表一个十六位数字。
remote-mep mep-id rmep-id 设置对端ID。 整数形式，取值范围是1～8191。
url urlstring 设置目的地址为URL类型。 字符串形式，不支持空格，不区分大小写，长度范围是1～230。当输入的字符串两端使用引号时，可在字符串中输入空格。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

NQA对业务特性的检测是通过创建测试例来完成的。NQA把测试两端称为客户端和服务器端，NQA的测试由客户端发起。对于测试例而言，对服务器端的指定是通过执行destination-address命令配置NQA测试例的目的地址来实现的。

例如，如果要检测对端设备是否可达，首先需要先执行nqa命令创建一个NQA测试例，然后配置此测试例的类型为ICMP，执行destination-address命令配置目的地址为对端IP地址，最后启动该测试例。根据返回的报文信息，可以了解对端设备是否可达。

注意事项

  • 只有LSP类型的测试例可以配置LSP参数。
  • 只有MAC Ping类型的测试例可以配置mac和remote-mep mep-id参数。
  • 只有HTTP、Trace和DNS类型的测试例可以将目的地址配置为URL类型，HTTP测试例只支持配置绝对URL路径。
  • DNS类型测试例的目的地址只能是URL，不能是IPv4地址，并且URL中必须含有"."，否则会导致测试失败。
  • 不能修改正在执行的测试例的目的地址。

使用实例

# 设置测试例user test的目的地址。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type icmp
[HUAWEI-nqa-user-test] destination-address ipv4 10.1.1.1
相关主题

destination-port

命令功能

destination-port命令用来配置NQA测试例的目的端口号。

undo destination-port命令用来恢复NQA测试例目的端口号的缺省值。

缺省情况下，各个测试例的目的端口号是：
  • TCP和UDP：7
  • HTTP：80
  • FTP：21
  • Trace：33434
  • Jitter：无缺省端口号，为必配参数

在对jitter测试类型配置目的端口号时，为了避免与其它协议默认端口号冲突导致配置后执行失败，建议配置10000以上的端口号。

命令格式

destination-port port-number

undo destination-port

参数说明

参数 参数说明 取值
port-number 目的端口号。

整数形式，取值范围是1～65535。不能是知名端口号或者被其他模块占用的端口号。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

NQA对业务特性的检测是通过创建测试例来完成的。NQA把测试两端称为客户端和服务器端，NQA的测试是由客户端发起。在客户端通过命令行配置测试例后，NQA把相应的操作类型放入到测试例队列中。在测试例启动后，根据返回的报文，可以对相关协议的运行状态提供数据信息。

对于测试例而言，对服务器端访问端口的指定是通过在客户端执行destination-port命令配置NQA测试例的目的端口号来实现的。

例如，如果要使用TCP测试例检测对端设备TCP服务是否正常，那么需要进行如下配置。

  • 服务器端：配置NQA测试的TCP服务器（包括支持的客户端IP地址和对其开放的TCP端口号）。

  • 客户端：
    • 创建NQA测试例，且配置其类型为TCP。
    • 配置目的IP地址（服务器IP地址）和目的端口号（必须与服务器对客户端开放的TCP端口号保持一致）。
    • 启动测试例。

注意事项

对于UDP和TCP测试例，配置的目的端口号必须与在服务器端配置开启的端口号一致。

只能对FTP、HTTP、TCP、Trace、UDP和UDP Jitter类型的测试例配置目的端口号。

不能修改正在执行的测试例的目的端口号。

使用实例

# 设置测试例user test的目的端口号为2020。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type jitter
[HUAWEI-nqa-user-test] destination-port 2020
相关主题

display nqa history

命令功能

display nqa history命令用来查看NQA测试的历史统计信息。

命令格式

display nqa history [ test-instance admin-name test-name ]

参数说明

参数 参数说明 取值
test-instance NQA测试例。 -
admin-name NQA测试例的管理者。

设备上已经存在的NQA测试例的管理者。
test-name NQA测试例的测试例名。

设备上已经存在的NQA测试例的测试例名。

视图

所有视图

缺省级别

1：监控级

使用指南

应用场景

NQA（Network Quality Analysis）提供的测试例不仅可以实现对网络运行情况的准确测试，输出统计信息，还有效的节约了成本。NQA可以测量网络上运行的各种协议的性能。

执行display nqa history命令可以查询到测试例检测过程中每个探测包的执行情况，包括每个探测包的状态，往返时延等，深入了解网络状态。

对于UDP Jitter测试例，如果测试失败，将不会记录在历史统计中。

注意事项

如果不指定可选参数，将显示所有NQA测试例的历史统计信息。

为了使用户每次查看的结果表和历史表总是最新的，增加用户体验，NQA测试例在分屏显示结果表和历史表信息时，总是尽量优先显示最新的记录。

使用实例

# 查看NQA测试的历史统计信息。

<HUAWEI> display nqa history
 NQA entry(admin, ftp) history:
 Index  T/H/P     Response Status        Address        Time
 1       1/1/1     1157ms  success       10.2.1.2       2012-07-15 10:16:38.188
 2       2/1/1     3000ms  success       10.2.1.2       2012-07-15 10:18:2.922
 NQA entry(admin, http) history:
 Index  T/H/P     Response Status        Address        Time
 1       1/1/1     0ms     busy          unknown        2012-07-15 11:16:39.915
 2       1/1/2     0ms     busy          unknown        2012-07-15 11:16:39.978
 3       1/1/3     0ms     busy          unknown        2012-07-15 11:16:39.40
表16-57  display nqa history命令输出信息描述

项目

描述

NQA entry(admin, ftp) history
NQA测试例的历史统计信息：

  • admin：NQA测试例的管理者。

  • ftp：NQA测试例的名称。

该参数可通过nqa命令进行配置。

Index

测试记录的索引值。

T/H/P

  • T：Times，表示这是该测试例第几次测试。

  • H：Hop，表示这是第几跳。

  • P：Probe，表示这是本次测试中第几次探测。

Response

从发出探测报文到收到响应报文所经过的时间。

Status
本次探测的状态：

  • success：探测成功结束。

  • timeout：探测超时，没有收到响应报文。

  • busy：资源不足导致发包失败，此时Response为0ms。

  • drop：链路不通导致发包失败，此时Response为0ms。

Address

进行测试的目的IP地址。

Time

收到响应报文的时间。

display nqa results

命令功能

display nqa results命令用来查看NQA测试的结果信息。

命令格式

display nqa results [ test-instance admin-name test-name ] [ verbose ]

参数说明

参数 参数说明 取值
test-instance NQA测试例。 -
admin-name NQA测试例的管理者。 设备上已经存在的NQA测试例的管理者。
test-name NQA测试例的测试例名。 设备上已经存在的NQA测试例的测试例名。
verbose 指定显示详细信息。
说明：

仅ICMP、UDP、ICMP Jitter和UDP Jitter测试例支持显示详细信息。

 -

视图

所有视图

缺省级别

1：监控级

使用指南

应用场景

NQA的测试结果不会自动输出，必须通过display nqa results命令查看。

如果不指定测试例名称，在具体的测试例视图下，只显示本测试例的测试结果；在系统视图或其他非测试例视图下，将显示所有NQA测试例的测试结果。如果指定测试例名称，则只显示该测试例的测试结果。

display nqa results命令的输出信息分为两部分：

  • 通用的测试例执行结果，这部分内容不随测试例的类型变化。

  • 各测试例的具体统计信息，对于不同类型的测试例，提供的统计项目也有所差异。

注意事项

display nqa results命令只能查看已经结束的测试例的测试结果。

为了使用户每次查看的结果表和历史表总是最新的，增加用户体验，NQA测试例在分屏显示结果表和历史表信息时，总是尽量优先显示最新的记录。

结果表时延统计相关字段的单位默认是毫秒。UDP Jitter和ICMP Jitter测试例的结果表时延统计相关字段的单位由timestamp-unit指定。

通过display nqa results命令查看UDP Jitter和ICMP Jitter测试例的单次测试结果表时：
  • 若SendProbe字段显示0，此时未发送测试报文，Packet Loss Ratio显示100%仅表示默认值；
  • 若SendProbe字段显示非0，Packet Loss Ratio显示100%表示测试报文全丢。
通过display nqa results collection命令查看UDP Jitter和ICMP Jitter测试例的累加结果表时：
  • 若SendProbe字段显示0，表示历次测试累积发包数为0，Packet Loss Ratio显示0%，仅表示默认值；
  • 若SendProbe字段显示非0，Packet Loss Ratio显示0%，表示测试报文无丢包。

累积丢包率的计算公式为：累积丢包率=（累积发包数-累积收包数）/累积发包数 * 100%，单次测试结果SendProbe为0时，不计入累积丢包率。

使用实例

# 查看ICMP类型的NQA测试例测试结果。

<HUAWEI> display nqa results test-instance admin icmp
  NQA entry(admin, icmp) :testflag is inactive ,testtype is icmp                  
  1 . Test 1 result   The test is finished                                      
   Send operation times: 3              Receive response times: 3               
   Completion:success                   RTD OverThresholds number: 0            
   Attempts number:1                    Drop operation number:0                 
   Disconnect operation number:0        Operation timeout number:0              
   System busy operation number:0       Connection fail number:0                
   Operation sequence errors number:0   RTT Status errors number:0              
   Destination ip address:10.138.77.21                                          
   Min/Max/Average Completion Time: 2/2/2                                       
   Sum/Square-Sum  Completion Time: 6/12                                        
   Last Good Probe Time: 2012-07-02 17:09:18.1                                  
   Lost packet ratio: 0 %

# 查看ICMP类型的NQA测试例的详细测试结果。

<HUAWEI> display nqa results test-instance admin icmp verbose
  NQA entry(admin, icmp) :testflag is inactive ,testtype is icmp                  
  1 . Test 1 result   The test is finished                                      
   Send operation times: 3              Receive response times: 3               
   Completion:success                   RTD OverThresholds number: 0            
   Attempts number:1                    Drop operation number:0                 
   Disconnect operation number:0        Operation timeout number:0              
   System busy operation number:0       Connection fail number:0                
   Operation sequence errors number:0   RTT Status errors number:0              
   Destination ip address:10.138.77.21                                          
   Min/Max/Average Completion Time: 2/2/2                                       
   Sum/Square-Sum  Completion Time: 6/12                                        
   Last Good Probe Time: 2012-07-02 17:09:18.1                                  
   Lost packet ratio: 0 %      
   Detailed result information:
表16-58  display nqa results test-instance admin icmp和display nqa results test-instance admin icmp verbose命令输出信息描述

项目

描述

NQA entry(admin, icmp)
NQA测试项，包括：

  • admin：NQA测试例的管理者标识。

  • icmp：NQA测试例的名称。

该参数可通过nqa命令进行配置。

testflag
测试标志：

  • active：测试正在执行。执行中查看测试结果没有实际意义。

  • inactive：测试已经结束。此时显示的是实际测试结果。

testtype

测试例的测试类型。

该参数可通过test-type命令进行配置。

1 . Test 1 result

测试结果的序号，按测试完成的时间顺序编号。

The test is finished
测试的状态：

  • finished：测试已经结束。

  • running：测试正在运行。

Send operation times

发送的测试报文数。此字段表示发送的报文个数，不是测试次数。

Receive response times

收到的响应报文数。此字段接收的报文个数，不是测试次数。

Completion
测试完成状态：

  • success：测试成功结束。

  • no result：测试正在运行，还没有得到结果或者测试完成后没有得到结果。

  • failed：测试失败。

RTD OverThresholds number

超过双向延时阈值的次数。

Attempts number

测试次数。

Drop operation number

分配系统资源失败的次数。

Disconnect operation number

对方强制断开连接的次数。

Operation timeout number

测试过程中超时的次数。

System busy operation number

测试冲突的次数。

Connection fail number

和对方建立连接失败的次数。

Operation sequence errors number

收到的失序包数。

RTT Status errors number

RTT状态错误数。

Destination ip address

测试的目的地址。

该参数可通过destination-address命令进行配置。

Min/Max/Average Completion Time

最小/最大/平均完成时间。

Sum/Square-Sum Completion Time

完成时间的总和/平方和。

Last Good Probe Time

最近一次探测完成的时间。

Lost packet ratio

丢包率。

Detailed result information

详细结果信息。

# 查看UDP Jitter测试例的测试结果。

<HUAWEI> display nqa results test-instance admin jitter
 NQA entry(admin, jitter) :testflag is inactive ,testtype is jitter                      
  1 . Test 1 result   The test is finished                                      
   SendProbe:60                         ResponseProbe:0                         
   Completion:failed                    RTD OverThresholds number:0             
   Min/Max/Avg/Sum RTT:0/0/0/0          RTT Square Sum:0                        
   NumOfRTT:0                           Drop operation number:0                 
   Operation sequence errors number:0   RTT Stats errors number:0               
   System busy operation number:0       Operation timeout number:60             
   Min Positive SD:0                    Min Positive DS:0                       
   Max Positive SD:0                    Max Positive DS:0                       
   Positive SD Number:0                 Positive DS Number:0                    
   Positive SD Sum:0                    Positive DS Sum:0                       
   Positive SD Square Sum:0             Positive DS Square Sum:0                
   Min Negative SD:0                    Min Negative DS:0                       
   Max Negative SD:0                    Max Negative DS:0                       
   Negative SD Number:0                 Negative DS Number:0                    
   Negative SD Sum:0                    Negative DS Sum:0                       
   Negative SD Square Sum:0             Negative DS Square Sum:0                
   Min Delay SD:0                       Min Delay DS:0                          
   Avg Delay SD:0                       Avg Delay DS:0                          
   Max Delay SD:0                       Max Delay DS:0                          
   Packet Loss SD:0                     Packet Loss DS:0                        
   Packet Loss Unknown:0                Average of Jitter:0                     
   Average of Jitter SD:0               Average of Jitter DS:0                  
   Jitter out value:0.0000000           Jitter in value:0.0000000               
   NumberOfOWD:0                        OWD SD Sum:0                            
   OWD DS Sum:0                         TimeStamp unit: ms                      
   Packet Rewrite Number: 0             Packet Rewrite Ratio: 0%                
   Packet Disorder Number: 0            Packet Disorder Ratio: 0%               
   Fragment-disorder Number: 0          Fragment-disorder Ratio: 0%             
   Start time: 2014-09-01 10:47:57+08:00                                                                                            
   End time: 2014-09-01 10:48:01+08:00
表16-59  display nqa results test-instance admin jitter命令输出信息描述

项目

描述

NQA entry(admin, jitter)
NQA测试项，包括：

  • admin：NQA测试例的管理者标识。

  • jitter：NQA测试例的名称。

testflag
测试标志：

  • active：测试正在执行。执行中查看测试结果没有实际意义。

  • inactive：测试已经结束。此时显示的是实际测试结果。

testtype

测试例的测试类型。

SendProbe

发送的探针的数目。

ResponseProbe

接收到回应探针的数目。

Completion
测试完成状态：

  • success：测试成功结束。

  • no result：测试正在运行，还没有得到结果或者测试完成后没有得到结果。

  • failed：测试失败。

RTD OverThresholds number

超过双向延时阈值的次数。

Min/Max/Avg/Sum RTT

探针往返时间的最小值/最大值/平均值/总和。

RTT Square Sum

探针往返时间的平方和。

NumOfRTT

RTT值的数量。

Drop operation number

分配系统资源失败的次数。

Operation sequence errors number

客户端收到错误报文的顺序号。

RTT Stats errors number

RTT状态错误数。

System busy operation number

测试冲突的次数。

Operation timeout number

测试过程中超时的次数。

Min Positive SD

从源到目的的最小正向抖动值。

Min Positive DS

从目的到源的最小正向抖动值。

Max Positive SD

从源到目的的最大正向抖动值。

Max Positive DS

从目的到源的最大正向抖动值。

Positive SD Number

从源到目的的正向抖动次数。

Positive DS Number

从目的到源的正向抖动次数。

Positive SD Sum

从源到目的正向抖动值之和。

Positive DS Sum

从目的到源的正向抖动值之和。

Positive SD Square Sum

从源到目的正向抖动值平方和。

Positive DS Square Sum

从目的到源的正向抖动值平方和。

Min Negative SD

从源到目的的最小负向抖动值。

Min Negative DS

从目的到源的最小负向抖动值。

Max Negative SD

从源到目的的最大负向抖动值。

Max Negative DS

从目的到源的最大负向抖动值。

Negative SD Number

从源到目的的负向抖动次数。

Negative DS Number

从目的到源的负向抖动次数。

Negative SD Sum

从源到目的负向抖动值之和。

Negative DS Sum

从目的到源的负向抖动值之和。

Negative SD Square Sum

从源到目的的负向抖动平方和。

Negative DS Square Sum

从目的到源的负向抖动平方和。
Min Delay SD

从源到目的最小延时。
Min Delay DS

从目的到源的最小延时。
Avg Delay SD

从源到目的平均延时。
Avg Delay DS

从目的到源的平均延时。

Max Delay SD

从源到目的最大延时。

Max Delay DS

从目的到源的最大延时。

Packet Loss SD

从源到目的方向的最大丢包数。

Packet Loss DS

从目的到源方向的最大丢包数。

Packet Loss Unknown

未知方向的丢包数。

Average of Jitter

平均抖动值。

Average of Jitter SD

从源到目的的平均抖动值。

Average of Jitter DS

从目的到源的平均抖动值。

Jitter out value

发送报文的抖动值。

Jitter in value

接收报文的抖动值。

NumberOfOWD

单向延时报文的数量。

OWD SD Sum

从源到目的的单向延时总和。

OWD DS Sum

从目的到源的单向延时总和。

TimeStamp unit

时间戳单位。

Packet Rewrite Number

报文改写个数。

Packet Rewrite Ratio

报文改写所占比例。

Packet Disorder Number

乱序报文个数。

Packet Disorder Ratio

乱序报文所占比例。

Fragment-disorder Number

分片发生乱序的报文个数。

Fragment-disorder Ratio

分片发生乱序的报文所占比例。
Start time 测试开始时间。
End time 测试结束时间。
相关主题

display nqa-agent

命令功能

display nqa-agent命令用来查看NQA客户端上指定或所有NQA测试例的状态和配置信息。

命令格式

display nqa-agent [ admin-name test-name ] [ verbose ]

参数说明

参数 参数说明 取值
admin-name NQA测试例的管理者。 字符串形式，长度范围是1～32。
test-name NQA测试例的测试例名。 字符串形式，长度范围是1～32。
verbose 显示NQA测试客户端状态的详细信息。 -

视图

所有视图

缺省级别

1：监控级

使用指南

NQA客户端测试例配置完成之后，可以使用命令display nqa-agent查看NQA客户端上指定或所有NQA测试例的状态和配置信息。

使用实例

# 查看NQA客户端上所有NQA测试例的状态和配置信息。

<HUAWEI> display nqa-agent
nqa test-instance admin ftp                                                     
 test-type ftp                                                                  
 ftp-operation get                                                              
 nqa status : normal                                                            
nqa test-instance admin icmp                                                    
 nqa status : normal                                                            
nqa test-instance admin jitter                                                  
 test-type jitter                                                               
 destination-address ipv4 10.10.10.10                                           
 destination-port 100                                                           
 nqa status : normal
表16-60  display nqa-agent命令输出信息描述

项目

描述

nqa test-instance admin icmp

test-type icmp

destination-address ipv4 192.168.1.2

nqa status : normal
NQA测试例icmp的管理者是admin，下面显示的是该测试例的参数配置：
  • test-type：测试类型
  • destination-address：目的地址
  • nqa status：NQA状态

NQA测试例可通过nqa命令进行配置。NQA测试例需要配置的参数不完全一样，可参见配置NQA测试例，此处不再赘述。

display nqa-server

命令功能

display nqa-server命令用来查看NQA测试的服务器端信息。

命令格式

display nqa-server

参数说明

无

视图

所有视图

缺省级别

1：监控级

使用指南

执行命令display nqa-server可以查看NQA测试的服务器端信息，包括设备可配置的NQA服务器的最大数量，当前配置的NQA服务器类型和数量等其他信息。

使用实例

# 查看NQA测试的服务器端信息。

<HUAWEI> display nqa-server 
NQA Server Max:100                        NQA Server Num:3
NQA Concurrent TCP Server:1               NQA Concurrent UDP Server:2
 nqa-server tcpconnect 10.1.1.1 2000    ACTIVE
 nqa-server udpecho 10.1.1.1 2000       ACTIVE
 nqa-server udpecho 10.1.1.1 6000       ACTIVE
表16-61  display nqa-server命令输出信息描述

项目

描述

NQA Server Max

可配置的NQA服务器的最大数量。

NQA Server Num

当前NQA服务器的数量。

NQA Concurrent TCP Server

配置的TCP服务器的数量。

NQA Concurrent UDP Server

配置的UDP服务器的数量。

nqa-server

逐条显示当前启动的NQA服务器项目。

ACTIVE

NQA服务器项目的状态。

dns-server

命令功能

dns-server命令用来配置NQA测试中DNS服务器地址。

undo dns-server命令用来删除NQA测试中DNS服务器地址。

缺省情况下，系统未配置DNS服务器地址。

命令格式

dns-server ipv4 ip-address

undo dns-server

参数说明

参数 参数说明 取值
ipv4 ip-address 指定DNS服务器的IPv4地址。 点分十进制格式。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

当需要检测给定的DNS名称解析成IP地址的速度时，需要配置DNS服务器。

前置条件

使用命令前，必先用命令test-type指定测试类的测试类型，且测试类型只能为DNS或HTTP。

注意事项

不能更改正在运行的测试例的DNS服务器设置。

使用实例

# 设置测试例user test的DNS服务器地址为10.1.1.1。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type dns
[HUAWEI-nqa-user-test] dns-server ipv4 10.1.1.1

fail-percent

命令功能

fail-percent命令用来配置NQA测试失败百分比。

undo fail-percent命令用来删除NQA测试失败百分比。

缺省情况下，测试失败百分比为100%，即只有全部探测失败，本次测试才视为失败。

命令格式

fail-percent percent

undo fail-percent

参数说明

参数 参数说明 取值
percent 指定NQA测试失败的百分比。 整数形式，取值范围是1～100。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

当启动一个NQA测试例进行测试时，每次测试会发送多个探针进行检测。通过多次探测得到的统计数据，对网络质量进行检测。

在实际情况中，由于网络中存在的一些干扰，会导致某次探测失败，但是，并不能认为一次探测失败即可说明整个测试的失败。可以通过设置NQA测试失败的百分比（测试例中探测失败次数占总探测次数的百分比），来判断某次测试是否失败。如果发送探测包失败的次数超过该比值，则认为该次测试失败。

例如，执行probe-count命令设置发包个数为10，但是在探测过程中7个探测包丢失：
  • 如果设置fail-percent是80，则测试例探测结果显示成功。
  • 如果设置fail-percent是60，则测试例探测结果显示失败。

前置条件

必先执行test-type命令指定测试类的测试类型，但不能对如下测试类型进行配置：
  • FTP
  • Trace
  • LSP Trace
  • PWE3 Trace
  • DNS
  • Path Jitter

注意事项

不能更改正在运行的测试例的失败百分比。

使用实例

# 配置对于测试例user test，当探测失败比例达到10%时，就认为本次测试失败。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type icmp
[HUAWEI-nqa-user-test] fail-percent 10
相关主题

frequency

命令功能

frequency命令用来配置NQA测试例自动执行测试的时间间隔。

undo frequency命令用来取消NQA测试例自动执行测试的时间间隔。

缺省情况下，没有配置自动测试间隔，即只进行一次测试。

命令格式

frequency interval

undo frequency

参数说明

参数 参数说明 取值
interval 测试例连续两次执行的时间间隔。 整数形式，取值范围是1～604800，单位是秒。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

执行start命令可以配置测试例启动的开始时间和结束时间。如果需要测试例在开始时间到结束时间内进行周期性测试，可以执行frequency命令配置NQA测试例自动执行测试的时间间隔，过了间隔时间，测试例自动执行一次。

配置NQA测试例自动执行测试的时间间隔，避免了繁琐的手动执行。

前置条件

使用命令前，必先用命令test-type指定测试例的测试类型。

注意事项

对于Trace、LSP Trace、PWE3Trace测试，配置的frequency需要大于或等于60s。

若配置的frequency小于或等于（probe-count - 1） * interval + timeout + 1，测试例执行结果可能为no result。对于支持jitter-packetnum参数配置的测试例，发包数为probe-count * jitter-packetnum。

对于FTP测试例，frequency的值必须大于timeout的值两秒以上，否则可能会导致FTP测试例执行失败。

如果在测试例测试结束前，NQA客户端设备发生了主备倒换：
  • 对于没有配置自动测试间隔的测试例，主备倒换后，测试停止，不再继续执行。
  • 对于配置了自动测试间隔的测试例，主备倒换后，从下一个周期开始执行。

如果没有配置结束时间，测试不能自动停止，必须通过手动停止。不能更改正在运行的测试例的测试周期。

使用实例

# 设置测试例user test两次测试之间间隔20秒。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type icmp
[HUAWEI-nqa-user-test] frequency 20

ftp-filename

命令功能

ftp-filename命令用来配置NQA测试FTP测试例的文件名和文件路径。

undo ftp-filename命令用来删除NQA测试FTP测试例的文件名和文件路径。

缺省情况下，没有配置文件名和文件路径。

命令格式

ftp-filename file-name

undo ftp-filename

参数说明

参数 参数说明 取值
file-name FTP测试的操作文件的路径和文件名。 字符串形式，长度范围是1～230。

视图

NQA测试例视图

缺省级别

3：管理级

使用指南

ftp-filename命令只对FTP类型的测试有效。

不能更改正在运行的测试例的文件路径和文件名。

可以不指定文件路径，系统会在当前路径下查找该文件。

文件名不能以字符“/”或“\”结尾。

文件名中可以包含扩展名，但不能只有扩展名。如.txt。

由于不同FTP服务器所支持的文件名的长度范围可能存在差异。因此，在配置此命令之前，请先确认目标FTP服务器所支持的文件名的长度范围，并确保所指定的文件名长度在允许的范围之内。否则，在使用FTP传输NQA测试结果时，可能导致FTP传输不成功。

使用实例

# 设置测试例user test的FTP操作文件的路径和文件名为D:\abc和abc.txt。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type ftp
[HUAWEI-nqa-user-test] ftp-filename D:\abc\abc.txt

ftp-filesize

命令功能

ftp-filesize命令用来配置NQA测试中FTP测试例的文件大小。

undo ftp-filesize命令用来恢复NQA测试中FTP测试例的文件大小的缺省配置。

缺省情况下，FTP测试的文件大小为1000Kbyte。

命令格式

ftp-filesize size

undo ftp-filesize

参数说明

参数 参数说明 取值
size 文件大小。 整数形式，单位是Kbyte，取值范围是1～10000。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

不能更改正在运行的测试例的操作文件大小。

采用指定文件大小的方式进行上载速度测试时，FTP客户端将自动构建指定大小的文件，文件名为“nqa-ftp-test.txt”。如果多次执行测试，后上载的“nqa-ftp-test.txt”文件将覆盖之前上载的文件。

必须先用命令test-type指定测试例的测试类型为ftp。

使用实例

# 设置测试例user test的FTP操作文件大小为1M字节。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type ftp
[HUAWEI-nqa-user-test] ftp-filesize 1024

ftp-operation

命令功能

ftp-operation命令用来配置NQA测试中FTP测试例的操作类型。

undo ftp-operation命令用来恢复NQA测试中FTP测试例操作类型的缺省配置。

缺省情况下，FTP测试的操作类型是get。

命令格式

ftp-operation { get | put }

undo ftp-operation put

参数说明

参数 参数说明 取值
get 下载指定文件到客户端，并记录下载速度。 -
put 将本地文件或构造的数据包上载到服务器，并记录上载速度。 -

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

在NQA的FTP测试中，将本地作为FTP客户端，从FTP服务器下载指定文件或向FTP服务器上载指定文件，可以获得FTP各个阶段的统计数据，如FTP控制连接建立时间、数据传输时间。

执行ftp-operation命令指定FTP的操作为上载（put）或者下载（get），通过FTP服务器的地址、用户名、密码与其建立控制连接，并记录下连接建立的时间。

前置条件

必先用命令test-type指定测试例的测试类型为ftp。

注意事项

不能更改正在运行的测试例的操作类型。

使用实例

# 设置测试例user test进行FTP下载速度测试。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type ftp
[HUAWEI-nqa-user-test] ftp-operation get

ftp-password

命令功能

ftp-password命令用来配置NQA测试中FTP测试例的FTP用户密码。

undo ftp-password命令用来删除NQA测试中FTP测试例的FTP用户密码。

缺省情况下，没有配置FTP测试例的FTP用户密码。

命令格式

ftp-password { password | cipher cipher-password }

undo ftp-password

参数说明

参数 参数说明 取值
password 指定FTP测试例使用的FTP用户密码。

字符串形式，不支持空格，区分大小写，长度范围是1～32或者32～68。

  • 如果密码是明文类型，则密码长度是1～32。
  • 如果密码是密文类型，则密码长度是32～68。
  • 当密码长度是32时，如配置的密文能够解密成功，则按照密文配置；如果配置的密文解密失败，则按照明文加密，并对明文进行合法性检查。
说明：
当输入的字符串两端使用引号时，可在字符串中输入空格。
cipher cipher-password 指定FTP测试例使用的FTP用户密码。

字符串形式，不支持空格，区分大小写，长度范围是1～32或者32～68。

  • 如果密码是明文类型，则密码长度是1～32。
  • 如果密码是密文类型，则密码长度是32～68。
  • 当密码长度是32时，如配置的密文能够解密成功，则按照密文配置；如果配置的密文解密失败，则按照明文加密，并对明文进行合法性检查。
说明：
当输入的字符串两端使用引号时，可在字符串中输入空格。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

在NQA的FTP测试中，将本地作为FTP客户端，从FTP服务器下载指定文件或向FTP服务器上载指定文件，可以获得FTP各个阶段的统计数据，如，FTP控制连接建立时间、数据传输时间。

为了提高测试的安全性能，防止未授权的用户进行检测，必须进行必要的身份验证。执行ftp-password用来配置已指定的用户名对应的密码。在进行检测时，只有输入授权的用户名和密码方可对FTP进行操作。

前置条件

必先执行test-type命令指定测试例的测试类型为ftp。

注意事项

不能更改正在运行的测试例的FTP用户密码。

使用实例

# 设置测试例user test的FTP测试的FTP用户密码为“Huawei-123”。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type ftp
[HUAWEI-nqa-user-test] ftp-password Huawei-123

ftp-username

命令功能

ftp-username命令用来配置NQA测试中FTP测试例的FTP用户名。

undo ftp-username命令用来删除NQA测试中FTP测试例的FTP用户名。

缺省情况下，没有配置FTP测试的FTP用户名。

命令格式

ftp-username name

undo ftp-username

参数说明

参数 参数说明 取值
name FTP用户名。 字符串形式，不支持空格，区分大小写，长度范围是1～255。
说明：
当输入的字符串两端使用引号时，可在字符串中输入空格。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

在NQA的FTP测试中，将本地作为FTP客户端，从FTP服务器下载指定文件或向FTP服务器上载指定文件，可以获得FTP各个阶段的统计数据，如，FTP控制连接建立时间、数据传输时间。

为了提高测试的安全性能，防止未授权的用户进行检测，必须进行必要的身份验证。执行ftp-username用来配置在FTP测试中所使用的FTP用户名。在进行检测时，只有输入授权的FTP用户名及其对应的密码方可对FTP进行操作。

前置条件

必先执行test-type命令指定测试例的测试类型为ftp。

注意事项

不能更改正在运行的测试例的FTP用户名。

使用实例

# 设置测试例user test的FTP测试FTP用户名为“user1”。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type ftp
[HUAWEI-nqa-user-test] ftp-username user1

http-operation

命令功能

http-operation命令用来配置NQA测试HTTP测试例的操作类型。

缺省情况下，HTTP测试例的操作类型为GET。

命令格式

http-operation get

参数说明

参数 参数说明 取值
get 指定从HTTP服务器获取数据。 -

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

只能对HTTP类型的测试例配置HTTP操作类型。

不能更改正在运行的HTTP测试例的操作类型。

使用实例

# 设置测试例user test的HTTP测试操作类型为get。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type http
[HUAWEI-nqa-user-test] http-operation get
相关主题

http-url

命令功能

http-url命令用来配置HTTP测试例的URL和版本信息。

undo http-url命令用来删除HTTP测试例的URL和版本信息。

缺省情况下，没有配置HTTP测试例的URL和版本信息。

命令格式

http-url deststring [ verstring ]

undo http-url

参数说明

参数 参数说明 取值
deststring 网页名，HTTP测试的网页。 字符串形式，不支持空格，不区分大小写，长度范围是1～230。
说明：
当输入的字符串两端使用引号时，可在字符串中输入空格。
verstring HTTP的版本信息。 长度不能超过7个字符。可以配置为v1.0或v1.1，缺省为HTTP1.0版本。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

本测试例支持HTTP1.0版本和HTTP1.1版本。

注意事项

只能对HTTP测试例配置http-url命令。不能更改正在运行的HTTP测试例的URL。

执行命令http-url，输入的内容应当包含域名或者服务端IP地址，否则会导致测试例失败。

使用实例

# 配置测试例名为user test的HTTP测试例，URL为http://www.***.com。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type http
[HUAWEI-nqa-user-test] http-url http://www.***.com

icmp-jitter-mode

命令功能

icmp-jitter-mode命令用来指定ICMP Jitter测试例测试模式的类型。

undo icmp-jitter-mode命令用来恢复ICMP Jitter测试例测试模式的缺省类型。

缺省情况下，ICMP Jitter测试例测试模式的类型为icmp-timestamp。

命令格式

icmp-jitter-mode { icmp-echo | icmp-timestamp }

undo icmp-jitter-mode

参数说明

参数 参数说明 取值
icmp-echo 指定ICMP Jitter测试例的测试模式为使用ICMP Echo报文进行测试。 -
icmp-timestamp 指定ICMP Jitter测试例的测试模式为使用ICMP Timestamp报文进行测试。 -

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

只有在配置测试例类型为ICMP Jitter或者Path Jitter时，才能执行icmp-jitter-mode命令配置ICMP Jitter测试例的测试模式类型。

使用实例

# 指定ICMP Jitter测试的模式类型为使用ICMP echo报文进行测试。

<HUAWEI> system-view
[HUAWEI] nqa test-instance admin icmpjitter
[HUAWEI-nqa-admin-icmpjitter] test-type icmpjitter
[HUAWEI-nqa-admin-icmpjitter] icmp-jitter-mode icmp-echo
相关主题

interval（NQA测试例视图）

命令功能

interval命令用来配置NQA测试例的发送报文的时间间隔。

undo interval命令用来恢复NQA测试例的发送报文的时间间隔的缺省值。

缺省情况下，各种测试例发送报文的时间间隔如下：

  • 对于UDP Jitter、Path Jitter和ICMP Jitter类型的测试例，S5720S-SI、S5720SI、S5730SI、S5730S-EI、S5720EI、S5720HI、S6720SI、S6720S-SI、S6720EI和S6720S-EI的时间间隔是50毫秒，其他设备的时间间隔是100毫秒。

  • 对于其他类型的测试例，时间间隔是4秒。

命令格式

interval { milliseconds interval | seconds interval }

undo interval

参数说明

参数 参数说明 取值
milliseconds interval

以毫秒为单位设置发送报文的时间间隔。

说明：

当配置的发包间隔的毫秒数是1000的整数倍时，系统会自动把毫秒数转换为秒的形式。

 整数形式，取值范围是20～60000。
seconds interval 指定以秒设置发送报文的时间间隔。 整数形式，取值范围是1～60。单位是秒。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

当启动一个NQA测试例进行测试时，每次测试会发送多个探针进行检测。通过多次探测得到的统计数据，对网络质量进行检测。探测报文（即探针）是以一定的时间间隔进行发送的。

  • 网络质量较差，就需要增大发送报文的时间间隔，否则测试例会导致网络恶化。
  • 网络质量良好，就可以减小发送报文的时间间隔，避免长时间等待测试例结束。

前置条件

必先执行test-type命令指定测试例的测试类型。只能对ICMP、ICMP Jitter、Path Jitter、SNMP、LSP Jitter、LSP Ping、PWE3 Ping、TCP、UDP或UDP Jitter类型的测试例配置报文间隔。

配置影响

  • 只能对UDP Jitter、Path Jitter和ICMP Jitter类型的测试例配置毫秒级的报文时间间隔。除了UDP Jitter、Path Jitter和ICMP Jitter类型的测试例外，其他类型测试例的发包间隔必须大于timeout命令设置的测试超时时间。
  • 如果已经配置过发送报文的时间间隔，再次执行interval命令将覆盖原有配置。

注意事项

不能更改正在运行的测试例的发送报文的时间间隔。

使用实例

# 设置测试例user test的报文间隔为1000毫秒。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type jitter
[HUAWEI-nqa-user-test] interval milliseconds 1000

ip-forwarding

命令功能

ip-forwarding命令用来配置头节点强制走IP转发。

undo ip-forwarding命令用来取消头节点强制走IP转发。

命令格式

ip-forwarding

undo ip-forwarding

参数说明

无

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

当网络出现故障时，可以首先使用ping命令测试网络连接是否正常工作。但是在MPLS网络中，当MPLS网络故障且控制层面无法正常感知时，会出现ping不通的情况，指定ping头节点强制走IP转发，区分是MPLS网络问题还是IP网络问题，可以帮助用户快速定位故障。

仅ICMP测试例支持此配置。

当ip-forwarding和sendpacket passroute同时配置时，sendpacket passroute命令生效，报文不查找路由表发送报文。

使用实例

# 设置测试例的转发模式为IP转发。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type icmp
[HUAWEI-nqa-user-test] ip-forwarding
相关主题

jitter-packetnum

命令功能

jitter-packetnum命令用来配置NQA测试例每次探测的发包数。

undo jitter-packetnum命令用来恢复NQA测试例每次探测发包数的缺省值。

缺省情况下，每次探测的发包数是20。

命令格式

jitter-packetnum number

undo jitter-packetnum

参数说明

参数 参数说明 取值
number 测试例每次探测（probe-count）执行的发包数。 整数形式，取值范围是1～3000。缺省值是20。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

当进行NQA测试时，如果希望模拟出在一段时间内某种数据的真实流量，通过执行jitter-packetnum命令设置连续发包数目来实现。可以更加精确地进行业务模拟，应用广泛。

例如，当需要使用Jitter测试例对VoIP（Voice over IP）业务进行检测，执行jitter-packetnum命令设置连续发包数为3000，并以20毫秒的时间间隔进行发送，可以在一分钟内模拟G.711流量。

前置条件

必须执行test-type命令配置测试例执行类型，只能对UDP Jitter、LSP Jitter、Path Jitter和ICMP Jitter类型的测试例配置发包数。

配置影响

  • 对于UDP Jitter、LSP Jitter、Path Jitter和ICMP Jitter测试例，测试例发送的报文数是jitter-packetnum和probe-count的乘积，且该乘积不能超过3000。

  • 如果已经配置过发包数，那么再次执行jitter-packetnum命令将覆盖原有配置。

注意事项

不能更改正在运行的测试例的发包数。

使用实例

# 设置测试例user test的一次测试包含3次探测，每次探测发送1000个报文。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type jitter
[HUAWEI-nqa-user-test] probe-count 3
[HUAWEI-nqa-user-test] jitter-packetnum 1000

local-pw-id

命令功能

local-pw-id命令用来配置本端的PW ID或者VC ID。

undo local-pw-id命令用来取消本端PW ID或者VC ID的配置。

缺省情况下，没有配置local-pw-id。

命令格式

local-pw-id local-pw-id

undo local-pw-id

参数说明

参数 参数说明 取值
local-pw-id 指定的本端PW ID或VC ID。

十进制整数形式。

  • 当测试类型是PWE3Ping时：支持VC-Type为LDP方式。整数形式，取值范围是1～4294967295。
  • 当测试类型是PWE3Trace时：当VC-Type为LDP时，整数形式，取值范围是1～4294967295；当VC-Type为BGP时，整数形式，取值范围是0～65534。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

使用PWE3 PING/PWE3 TRACE测试例可以检测的场景如下：

单跳PW连通性和故障节点检测。执行local-pw-id命令用来在NQA视图下配置本端的PW ID或者VC ID，此时可以唯一指定进行检测的PW。

多跳PW连通性和故障节点检测。执行local-pw-id命令用来在NQA视图下配置本端的PW ID或者VC ID之后，还需要指定目的地址：
  • 当label-type为control-word时，执行命令remote-pw-id remote-pw-id，配置对端PW ID。
  • 当label-type为label-alert或normal时，执行命令destination-address ipv4 ipv4-address [ lsp-masklen masklen | lsp-masklen masklen lsp-loopback loopback-address | lsp-loopback loopback-address lsp-masklen masklen ]，配置PWE3 Trace和PWE3 Ping测试的目的地址。

前置条件

使用local-pw-id命令前，需要先在NQA视图下配置NQA测试例的测试类型为PWE3 Trace或者PWE3 Ping。

注意事项

local-pw-id的取值必须与display mpls l2vc命令回显信息中的VC ID保持一致，否则可能导致测试失败。

使用实例

# 在NQA视图下配置本端的PW ID为100。

<HUAWEI> system-view
[HUAWEI] nqa test-instance admin pwe3
[HUAWEI-nqa-admin-pwe3] test-type pwe3trace
[HUAWEI-nqa-admin-pwe3] local-pw-id 100

local-pw-type

命令功能

local-pw-type命令用来配置本端的PW类型。

undo local-pw-type命令用来取消配置的本端PW类型。

缺省情况下，本端的PW类型为ethernet。

命令格式

local-pw-type local-pw-type

undo local-pw-type

参数说明

参数 参数说明 取值
local-pw-type 指定的本端PW类型。 目前支持的封装类型有ethernet、ip-interworking和vlan。缺省值是ethernet。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

根据检测网络指定PW的封装类型，执行local-pw-type命令配置测试例的本端PW类型和被监控网络的PW封装类型一致。

前置条件

使用local-pw-type命令前，需要先在NQA视图下配置NQA测试例的测试类型为PWE3 Trace或者PWE3 Ping，否则无法配置local-pw-type命令。

注意事项

local-pw-type的取值必须与display mpls l2vc命令回显信息中的VC type保持一致，否则可能导致测试失败。

使用实例

# 在NQA视图下配置本端的pw-type为VLAN。

<HUAWEI> system-view
[HUAWEI] nqa test-instance admin pwe3
[HUAWEI-nqa-admin-pwe3] test-type pwe3trace
[HUAWEI-nqa-admin-pwe3] local-pw-type vlan
相关主题

label-type

命令功能

label-type命令用来配置报文的封装类型。

undo label-type命令用来取消配置的报文封装类型。

缺省情况下，报文封装类型使用控制字control-word方式。

命令格式

label-type { control-word | { label-alert | normal } [ no-control-word ] }

undo label-type

参数说明

参数 参数说明 取值
control-word 指定在报文中封装control word控制字信息。 -
label-alert 指定在报文中封装router alert标签。 -
normal 普通方式，MPLS echo request报文不封装control word和router alert选项。 -
no-control-word 去使能control-word选项，用在NQA PWE3 Ping和NQA PWE3 Trace中。 -

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

各封装类型的应用场景如下：

  • control-word：

    • 封装control word后，多跳的情况下，在switch节点，如果标签TTL值不超时，则MPLS echo request报文不会被上送CPU处理。这种方式下，源端获得的PW信息较少，但对设备的性能影响较小，并且源端看不到该switch节点的下游信息。当报文多的时候，推荐用此方式。
    • 当vc-type是BGP，lsp-version是draft6时，只支持配置control-word。

  • label-alert：

    • 封装label alert后，多跳的情况下，在switch节点，MPLS echo request报文被上送CPU处理。这种方式下，源端获得的PW信息较多，但如果报文太多时，对设备的性能影响较大。如果测试例比较少时，推荐采用此方式，以获取switch节点的详细信息。
    • 当vc-type是BGP，lsp-version是rfc4379时，只支持配置control-word或label-alert。

  • no-control-word：与华为公司老版本互通时，如果是label-alert或normal方式，需要加上no-control-word选项。

  • normal：当lsp-version是draft6时，不支持normal类型。

前置条件

使用label-type命令前，需要先在NQA视图下配置NQA测试例的测试类型为PWE3 Trace或者PWE3 Ping，否则无法配置label-type命令。

注意事项

label-type的取值须与display mpls l2vc命令回显信息中的local VCCV保持一致，否则可能导致测试失败。

使用实例

# 在NQA视图下配置报文的封装类型为label-alert。

<HUAWEI> system-view
[HUAWEI] nqa test-instance admin pwe3
[HUAWEI-nqa-admin-pwe3] test-type pwe3trace
[HUAWEI-nqa-admin-pwe3] label-type label-alert
相关主题

lsp-exp

命令功能

lsp-exp命令用来配置NQA测试的LSP EXP值。

undo lsp-exp命令用来恢复缺省配置。

缺省情况下，LSP EXP值是0。

命令格式

lsp-exp exp

undo lsp-exp

参数说明

参数 参数说明 取值
exp EXP值。 整数形式，取值范围是0～7。缺省值是0。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

实验比特位EXP（Experimental Bits）是MPLS报文头中长度为3bit的保留域段。该域通常用于标识MPLS报文的服务级别。

通过配置LSP的EXP值，可以指定探测报文选择的队列，其目的在于：
  • 让探测报文走不同队列，避免链路拥塞。
  • 让探测报文走指定队列，实现对某队列的检测。

注意事项

只能对LSP类型的测试例配置LSP EXP。

不能更改正在运行的测试例的LSP EXP值。

使用实例

# 设置测试例user test的LSP EXP值为5。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type lspping
[HUAWEI-nqa-user-test] lsp-exp 5
相关主题

lsp-nexthop

命令功能

lsp-nexthop命令在发起测试的节点有负载分担的情况下，配置下一跳IP地址。

undo lsp-nexthop命令用来取消当前配置。

缺省情况下，随机在负载分担链路中选择下一跳地址。

命令格式

lsp-nexthop nexthop-ip-address

undo lsp-nexthop

参数说明

参数 参数说明 取值
nexthop-ip-address 指定下一跳地址。 点分十进制形式。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

在满足以下两个前提： 可以执行lsp-nexthop命令配置下一跳IP地址。目前支持的测试例类型如下：
  • LSP Ping
  • LSP Trace
  • LSP Jitter

注意事项

不能在正在运行的测试例下配置下一跳地址。

使用实例

# 为测试例类型为LSP Ping，lsp-type为IPv4并且lsp-version为rfc4379的测试例指定下一跳地址。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type lspping
[HUAWEI-nqa-user-test] lsp-type ipv4
[HUAWEI-nqa-user-test] lsp-version rfc4379
[HUAWEI-nqa-user-test] lsp-nexthop 10.1.2.20
相关主题

lsp-replymode

命令功能

lsp-replymode命令用来配置NQA测试LSP测试例的响应模式。

undo lsp-replymode命令用来恢复缺省配置。

缺省情况下，以UDP报文响应。

命令格式

lsp-replymode { no-reply | udp }

undo lsp-replymode

参数说明

参数 参数说明 取值
no-reply 不响应。

如果设置no-reply参数，目的端不会回应NQA探测报文，这种配置通常用于在目的端针对收到的探测报文进行统计或者其他应用，无需回应探测报文。同时，NQA测试例因为无法收到回应报文而失败。
udp 以IPv4 UDP报文响应。 -

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

可以执行lsp-replymode命令设置测试例的应答报文按照什么方式响应。目前支持的测试例类型如下：
  • LSP Ping
  • LSP Trace
  • LSP Jitter
  • PWE3 Ping
  • PWE3 Trace

注意事项

配置lsp-replymode no-reply进行单向测试，客户端显示超时表明测试成功，否则会提示LSP不存在。

不能更改正在运行的测试例的LSP响应类型。

使用实例

# 设置测试例user test的响应模式是以UDP报文响应。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type lspping
[HUAWEI-nqa-user-test] lsp-replymode udp
相关主题

lsp-tetunnel

命令功能

lsp-tetunnel命令用来配置NQA测试LSP测试例的TE隧道。

undo lsp-tetunnel命令用来取消LSP测试例的TE隧道。

缺省情况下，LSP测试例未配置TE隧道。

命令格式

lsp-tetunnel tunnel interface-number [ hot-standby | primary ]

undo lsp-tetunnel

参数说明

参数 参数说明 取值
tunnel interface-number TE Tunnel的接口编号。 -
hot-standby 指定TE隧道接口的热备份隧道。 -
primary 指定TE隧道接口的主隧道。 -

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

热备份（Hot-standby）：创建主CR-LSP（Constraint-based Routed Label Switched Path）后随即创建备份CR-LSP。主CR-LSP失效时，将业务切换至备份CR-LSP。当主CR-LSP恢复时，将业务切回到主CR-LSP。

主隧道配置CR-LSP备份后，当主CR-LSP故障时，流量会切换到备份CR-LSP上，从而提供了端到端的保护。

NQA可以对以下类型的LSP进行可达性检测，并收集SLA相关统计信息。
  • MPLS TE隧道：执行lsp-tetunnel tunnel interface-number命令，配置TE隧道的接口编号。
  • MPLS CR-LSP热备份隧道：执行lsp-tetunnel tunnel interface-number hot-standby命令配置TE隧道接口的热备份隧道接口编号。
  • MPLS TE主隧道：执行lsp-tetunnel tunnel interface-number primary命令，配置TE主隧道的接口编号。

前置条件

在使用lsp-tetunnel命令配置NQA测试LSP测试例的TE隧道前，必须先进行以下操作：

  • 执行interface tunnel interface-number命令创建Tunnel接口。
  • 执行lsp-type te命令指定NQA测试例的LSP测试类型为TE检测。

注意事项

LSP Jitter测试例不支持对TE隧道接口的热备份隧道进行检测。

不能更改正在运行的测试例的LSP TE隧道。

使用实例

# 设置测试例user test的TE隧道。

<HUAWEI> system-view
[HUAWEI] interface tunnel 1
[HUAWEI-Tunnel1] quit
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type lspping
[HUAWEI-nqa-user-test] lsp-type te
[HUAWEI-nqa-user-test] lsp-tetunnel tunnel 1

# 设置测试例user test的TE备份隧道。

<HUAWEI> system-view
[HUAWEI] interface tunnel 1
[HUAWEI-Tunnel1] quit
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type lspping
[HUAWEI-nqa-user-test] lsp-type te
[HUAWEI-nqa-user-test] lsp-tetunnel tunnel 1 hot-standby
相关主题

lsp-type

命令功能

lsp-type命令用来配置NQA测试例的LSP测试类型。

undo lsp-type命令用来恢复缺省配置。

缺省情况下，测试类型为IPv4。

命令格式

lsp-type { ipv4 | te | ipv4-vpn }

undo lsp-type

参数说明

参数 参数说明 取值
ipv4

指定LSP测试类型为IPv4。

 -
te

指定LSP测试类型为TE。

 -
ipv4-vpn

指定LSP测试类型为IPv4 L3VPN。

 -

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

执行lsp-type命令可以配置NQA测试例的LSP测试类型，实现对LDP和TE隧道的检测：
  • 如果配置ipv4参数，NQA测试例会对指定LDP进行测试。此时目的地址应已通过destination-address命令进行指定。
  • 如果配置te参数，NQA测试例会对指定TE隧道进行测试。此时目的地址应已通过lsp-tetunnel命令进行指定。
  • 如果配置ipv4-vpn参数，NQA测试例会对通过BGP建立的L3VPN网络进行测试。
    • 对通过BGP建立的L3VPN网络的主用隧道进行检测，此时目的地址应已通过destination-address lsp-masklen masklen命令进行指定。
    • 对通过BGP建立的L3VPN网络的备用隧道进行检测，此时目的地址应已通过destination-address lsp-masklen masklen vpn-frr-path命令进行指定。

前置条件

  • 对于IPv4 LSP测试类型，必须指定NQA的测试例类型为LSP Ping、LSP Trace和LSP Jitter。
  • 对于TE LSP测试类型，必须指定NQA的测试例类型为LSP Ping、LSP Trace和LSP Jitter。
  • 对于IPv4 L3VPN测试类型，必须指定NQA的测试例类型为LSP Ping。

注意事项

不能更改正在运行的测试例的LSP测试类型。

该命令配置成功后，无法对destination-address、lsp-tetunnel和lsp-version命令进行配置。

使用实例

# 设置测试例user test的LSP测试类型为IPv4的LSP Ping。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type lspping
[HUAWEI-nqa-user-test] lsp-type ipv4
相关主题

lsp-version

命令功能

lsp-version命令用来配置LSP类型测试例使用的协议。

undo lsp-version命令用来恢复缺省配置。

缺省情况下，LSP类型测试例使用draft6协议。

命令格式

lsp-version { rfc4379 | draft6 }

undo lsp-version

参数说明

参数 参数说明 取值
rfc4379 指定LSP使用的协议为rfc4379。 -
draft6 指定LSP使用的协议为Draft-ietf-mpls-lsp-ping-06。 -

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

执行命令lsp-version，指定测试例依据哪种协议对LSP进行检测。

前置条件

配置lsp-version为draft6或者rfc4379时，需要先配置test-type为lspping、lsptrace、lspjitter、pwe3ping或pwe3trace。

不能更改正在运行的测试例的LSP使用协议。

使用实例

# 指定LSP使用的协议为rfc4379。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type lspping
[HUAWEI-nqa-user-test] lsp-version rfc4379
相关主题

md

命令功能

md命令用来指定发出NQA测试报文的md和ma。只在MAC Ping类型的测试例时有效。

undo md命令用来删除配置的维护域。

缺省情况下，MAC Ping测试例的维护域未配置。

S1720GFR不支持该命令。

命令格式

md md-name ma ma-name

undo md

参数说明

参数 参数说明 取值
md-name 用来标识一个维护域。 字符串形式，不支持空格，区分大小写，长度范围是1～43。
ma-name 用来标识一个维护联盟（maintenance association）的名称。 字符串形式，不支持空格，区分大小写，长度范围是1～43。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

利用该命令指定MAC Ping测试例对应的MD、MA，指定了对应的MD、MA后相当于在该MA视图下进行连通性故障确认。使用该命令前需要创建对应的MD/MA，并指定测试例类型是macping。

测试例正在运行时不能修改对应的MD、MA。输入的MD和MA的名称的组合的字符长度不能超过44字符。

使用实例

# 配置NQA测试例的测试类型为macping测试，指定测试的MD名称为“mdcustomer”，MA名称为“macustomer”。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type macping
[HUAWEI-nqa-user-test] md mdcustomer ma macustomer
相关主题

mep

命令功能

mep命令用来配置NQA测试例的MEP ID。

undo mep命令用来取消NQA测试例的MEP ID配置。

缺省情况下，NQA测试例的MEP ID为0。

S1720GFR不支持该命令。

命令格式

mep mep-id mep-id

undo mep

参数说明

参数 参数说明 取值
mep-id 指定MEP ID。 整数形式，取值范围是1～8191。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

在NQA测试例启动前，mep-id mep-id需要先通过EOAM模块配置，否则会影响NQA正常检测。

仅NQA MAC Ping测试例支持配置该命令。

使用实例

# 配置测试例macping的MEP ID为1。

<HUAWEI> system-view
[HUAWEI] nqa test-instance test macping
[HUAWEI-nqa-test-macping] test-type macping
[HUAWEI-nqa-test-macping] mep mep-id 1
相关主题

nexthop

命令功能

nexthop命令用来配置NQA测试的下一跳地址。

undo nexthop命令用来删除配置的NQA测试的下一跳地址。

缺省情况下，查找路由表获取下一跳地址。

命令格式

nexthop ipv4 ip-address

undo nexthop

参数说明

参数 参数说明 取值
ipv4 ip-address

指定NQA测试的下一跳地址。

点分十进制格式。

说明：

指定的下一跳地址必须是与出接口直连的物理接口的IP地址。

视图

NQA视图

缺省级别

2：配置级

使用指南

应用场景

NQA联动静态路由场景下，当链路故障时，NQA ICMP测试例检测结果是失败，同时联动静态路由变为DOWN。一旦链路故障恢复，由于ICMP测试例报文发送时需要查找路由表，但此时路由已经被NQA联动置DOWN，导致ICMP测试例仍然检测失败，联动的静态路由也一直得不到恢复，业务流量也无法回切到原先的链路。

解决方案是指定ICMP测试例发送报文时的下一跳地址，这样在链路故障恢复之后可以正常发送NQA探测报文，测试结果恢复成功，同时可联动恢复静态路由。

前置条件

仅ICMP测试例支持指定下一跳地址。

注意事项

配置测试的下一跳地址后，测试例报文发送时将不再查找路由表，而是直接按指定的下一跳地址发送。

指定下一跳地址时，可以同时执行source-interface命令指定出接口。此时必须保证如下两个条件，否则将会导致测试失败。

  • 指定的下一跳地址和出接口相互匹配
  • 指定的出接口不能是逻辑接口的成员口

使用实例

# 配置NQA测试的下一跳地址。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type icmp
[HUAWEI-nqa-user-test] nexthop ipv4 10.1.1.1

nqa

命令功能

nqa命令用来创建NQA测试例，并进入NQA测试例视图。

undo nqa命令用来删除NQA测试例。

命令格式

nqa test-instance admin-name test-name

undo nqa { test-instance admin-name test-name | all-test-instance }

参数说明

参数 参数说明 取值
admin-name NQA测试例的管理者。
字符串形式，取值范围1～32。不能包含?、空格、-。
说明：
当输入的字符串两端使用双引号时，可在字符串中输入空格。
test-name NQA测试例的测试例名。
字符串形式，取值范围1～32。不能包含?、空格、-。
说明：
当输入的字符串两端使用双引号时，可在字符串中输入空格。
all-test-instance 所有NQA测试例实例。 -

视图

系统视图

缺省级别

2：配置级

使用指南

应用场景

网络质量分析NQA（Network Quality Analysis）是设备上集成网络测试功能，不仅可以实现对网络运行情况的准确测试，输出统计信息，有效的节约成本。

NQA可以检测网络上运行的各种协议的性能，使企业用户能够实时采集到各种网络运行指标，例如：HTTP的总时延、TCP连接时延、DNS解析时延、文件传输速率、FTP连接时延、DNS解析错误率等。

对于上述诸多业务特性的检测，NQA是通过创建测试例来完成的。NQA把测试两端称为客户端和目的端，并在客户端发起测试，目的端接收报文后，返回给源端相应的回应信息。根据返回的报文信息，了解相应的网络状况。

配置影响

执行命令undo nqa all-test-instance，将删除所有的NQA测试例（不包括正在运行的测试例）。

注意事项

不能删除正在运行的测试例。

使用实例

# 创建名为user test的测试例。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test]
相关主题

nqa-jitter tag-version

命令功能

nqa-jitter tag-version命令用来配置UDP Jitter测试例的报文版本号。

undo nqa-jitter tag-version命令用来恢复UDP Jitter测试例的报文版本号的缺省值。

缺省情况下，UDP Jitter测试例的报文版本号是1。

命令格式

nqa-jitter tag-version version-number

undo nqa-jitter tag-version

参数说明

参数 参数说明 取值
version-number UDP Jitter测试例的报文版本号。 取值是1或者2。

视图

系统视图

缺省级别

2：配置级

使用指南

应用场景

版本1不支持单向丢包统计。

版本2的报文统计更加精确，其统计结果可以为网络管理员定位网络故障、检测恶意对网络的攻击提供依据。在配置UDP Jitter报文的版本号为2并配置单向丢包统计后，在测试结果中将可以看到，从源端到目的端、从目的端到源端和未知方向的丢包情况。

因此，推荐配置版本号为2。

配置影响

如果已经配置过UDP Jitter测试例的报文版本号，那么再次执行nqa-jitter tag-version命令将覆盖原有配置。

注意事项

不管UDP Jitter测试的报文版本号为1还是2，都必须执行nqa-server udpecho命令配置NQA服务器端，否则UDP Jitter测试会超时失败。

使用实例

# 配置UDP Jitter测试例的报文版本号为2。

<HUAWEI> system-view
[HUAWEI] nqa-jitter tag-version 2

nqa-server tcpconnect

命令功能

nqa-server tcpconnect命令用来配置TCP测试例的TCP服务器。

undo nqa-server tcpconnect命令用来删除TCP测试例的TCP服务器。

缺省情况下，未配置TCP服务器。

命令格式

nqa-server tcpconnect [ vpn-instance vpn-instance-name ] ip-address port-number

undo nqa-server tcpconnect { all | [ vpn-instance vpn-instance-name ] ip-address port-number }

仅S1720GW-E、S1720GWR-E、S1720X-E、S2720EI、S5720LI、S5720S-LI、S5720SI、S5720S-SI、S5730SI、S5730S-EI、S5720EI、S5720HI、S6720LI、S6720S-LI、S6720SI、S6720S-SI、S6720EI和S6720S-EI支持vpn-instance vpn-instance-name。

参数说明

参数 参数说明 取值
vpn-instance vpn-instance-name 指定TCP服务器所属的VPN实例名。
说明：

当指定的TCP服务器地址为环回地址时，不能配置该参数。

 必须是已存在的VPN实例名称。
all 指定所有的TCP服务器端地址和端口号。 -
ip-address 指定TCP服务器端的地址。 点分十进制格式。
port-number 指定TCP服务器端的端口号。

整数形式，取值范围是1～65535。不能是知名端口号或者被其他模块占用的端口号。

视图

系统视图

缺省级别

2：配置级

使用指南

应用场景

NQA的TCP测试用于检测主机与TCP Server之间经过三次握手建立TCP连接的速度。对于TCP测试例，需要配置TCP服务器，以对探测报文进行回应。

在客户端有以下针对服务器的配置：
  • 客户端执行destination-address命令配置NQA测试例的目的地址，即执行本命令所配置的TCP服务器地址。
  • 客户端执行destination-port命令配置NQA测试例的目的端口号，即执行本命令所配置的TCP服务器启动的端口号。TCP服务器端使用port-number参数对服务器端口进行开启，以供测试例访问。

如果客户端与服务器通过VPN相连，还需要指定VPN实例名。

配置影响

执行undo nqa-server tcpconnect all命令用来删除所有TCP服务器上配置的地址和端口号。

注意事项

只有TCP测试例才需要配置TCP服务器。

使用实例

# 创建TCP服务器，IP地址是10.10.10.1，TCP端口号是5000。

<HUAWEI> system-view
[HUAWEI] nqa-server tcpconnect 10.10.10.1 5000

nqa-server udpecho

命令功能

nqa-server udpecho命令用来配置NQA测试的UDP服务器。

undo nqa-server udpecho命令用来删除当前配置的NQA测试的UDP服务器。

缺省情况下，未配置UDP服务器。

命令格式

nqa-server udpecho [ vpn-instance vpn-instance-name ] ip-address port-number

undo nqa-server udpecho { [ vpn-instance vpn-instance-name ] ip-address port-number | all }

仅S1720GW-E、S1720GWR-E、S1720X-E、S2720EI、S5720LI、S5720S-LI、S5720SI、S5720S-SI、S5730SI、S5730S-EI、S5720EI、S5720HI、S6720LI、S6720S-LI、S6720SI、S6720S-SI、S6720EI和S6720S-EI支持vpn-instance vpn-instance-name。

参数说明

参数 参数说明 取值
vpn-instance vpn-instance-name 指定服务器所属的VPN实例名。
说明：

当指定的UDP服务器地址为环回地址时，不能配置该参数。

 字符串形式，取值范围是1～31。
all 指定所有UDP服务器端地址和端口号。 -
ip-address 指定UDP服务器端UDP的地址。 点分十进制格式。
port-number 指定UDP服务器端的端口号。

整数形式，取值范围是1～65535。不能是知名端口号或者被其他模块占用的端口号。

视图

系统视图

缺省级别

2：配置级

使用指南

应用场景

该命令在UDP服务器端配置。

UDP Jitter是以UDP报文为承载，通过记录在报文中的时间戳信息来统计时延、抖动和丢包。需要配置UDP服务器，以对探测报文进行回应。

由于DHCP动态分配等原因导致用户无法预知本地IPv4地址时，可以通过指定auto-address配置NQA服务器端UDP服务自动侦听全部IPv4地址。

配置影响

执行undo nqa-server udpecho all命令，将会删除所有UDP服务器上配置的地址和端口号。

注意事项

如果客户端与服务器通过VPN相连，还需要指定VPN实例名。

不管UDP Jitter测试的报文版本号为1还是2，都必须配置NQA服务器端，否则UDP Jitter测试会超时失败。

使用实例

# 创建NQA UDP服务器，服务器的IP地址是10.10.10.2，端口号是6000。

<HUAWEI> system-view
[HUAWEI] nqa-server udpecho 10.10.10.2 6000

probe-count

命令功能

probe-count命令用来配置NQA测试例的一次测试探针数目。

undo probe-count命令用来恢复NQA测试例的一次测试探针数目的缺省值。

缺省情况下，一次测试探针数目是3。

命令格式

probe-count number

undo probe-count

参数说明

参数 参数说明 取值
number 在一次NQA测试中测试探针的次数，即一次测试中探测的次数。

整数形式，取值范围是1～15。缺省值是3。

说明：

对于Trace测试例，其探针次数不能大于10次。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

在NQA测试时，一次测试包含多次探测。在默认情况下，对于一次测试，有一次或一次以上探测成功，即认为该测试是成功的；若全部探测失败，则认为该测试失败。因此，可根据网络质量来具体配置一次测试中探测的次数的大小：
  • 对于可靠的网络，可将探测次数设置的相对小些。因为可能发送较小次数的探测报文便能获得探测成功。
  • 对于不可靠网络，可将探测次数设置的相对大些。因为可能发送较大次数的探测报文才能获得探测成功。
反之，也可通过不断的调整探测的次数，根据多次探测得到的统计数据检测网络的质量，例如，
  • 若探测次数设置为一个较小的数值，即可获得探测成功，则说明网络质量较好。
  • 若探测次数设置为一个较大的数值，但是仍无法探测成功，则说明网络质量较差。

前置条件

必先执行test-type命令指定测试类的测试类型，但不能对如下测试类型进行配置：
  • FTP
  • DNS

配置影响

  • 对于UDP Jitter测试例、ICMP Jitter测试例、Path Jitter测试例、LSP Jitter测试例，测试例发送的报文数是probe-count和jitter-packetnum的乘积，且该乘积不能超过3000。

  • 如果已经配置过发送探针次数，那么再次执行probe-count命令将覆盖原有配置。

注意事项

如果测试例正在运行，则不能修改的发送探针个数。

使用实例

# 设置测试例user test的探测次数为6。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type jitter
[HUAWEI-nqa-user-test] probe-count 6

probe-failtimes

命令功能

probe-failtimes命令用来配置NQA测试探测失败后发送trap的阈值。即，连续探测失败的次数。

undo probe-failtimes命令用来恢复NQA测试探测失败后发送trap的阈值的缺省值。

缺省情况下，探测失败一次就会发送一条Trap信息。

命令格式

probe-failtimes times

undo probe-failtimes

参数说明

参数 参数说明 取值
times NQA测试中发送trap的阈值。即，连续探测失败的次数。 整数形式，取值范围是1～15。缺省值是1。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

NQA探测是用来检测某个探针是否收到相应的响应报文。如果连续没有收到响应报文的次数达到指定数目，系统就会根据配置的网管地址向网管发送探测失败Trap消息。

前置条件

必先执行test-type命令指定测试类的测试类型。但不能对Path Jitter测试进行配置。

后续任务

配置了probe-failtimes命令后，需执行send-trap probefailure命令打开发送探测失败Trap开关。否则无法正常发送Trap消息。

注意事项

不能更改正在运行的测试例的此项参数。

对于不支持probe-count的测试例，建议probe-failtimes配置成1，否则无法触发发送Trap消息。

对于支持probe-count的测试例，建议probe-failtimes配置的值小于等于probe-count，否则无法触发发送Trap消息。

使用实例

# 设置测试例user test的连续探测失败数为10次。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type tcp
[HUAWEI-nqa-user-test] probe-failtimes 10

records

命令功能

records命令用来配置NQA测试的历史记录和结果记录的最大数目。

undo records命令用来恢复NQA测试的历史记录和结果记录的最大数目的缺省值。

缺省情况下，历史记录为50；结果记录为5。

命令格式

records { history number | result number }

undo records { history | result }

参数说明

参数 参数说明 取值
history number 指定历史统计最大条数。

整数形式，取值范围是0～1000，缺省值是50。
result number 指定结果统计最大条数。 整数形式，取值范围是1～10，缺省值是5。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

用户可根据需要通过执行records配置保存NQA测试结果记录的数目。

用户创建的每个测试例都默认支持50条历史记录，为了保证历史记录总条数不会过大，需要控制设备上可产生总的历史记录条数。同时，需要设定一个用户可增加的历史表条数，即历史表余量。测试例配置的历史表条数相对历史表默认条数的增量的总和不能大于历史表余量。

注意事项

使用命令前，必先用命令test-type指定测试例的测试类型。

不能更改正在运行的测试例的此项参数。

使用实例

# 设置测试例user test的历史统计最大个数为30。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type jitter
[HUAWEI-nqa-user-test] records history 30

remote-pw-id

命令功能

remote-pw-id命令用来配置远端的PW ID或者VC ID。

undo remote-pw-id命令用来取消配置的远端PW ID或者VC ID。

当VC Type为LDP时，remote-pw-id的缺省值是0。

命令格式

remote-pw-id remote-pw-id

undo remote-pw-id

参数说明

参数 参数说明 取值
remote-pw-id 指定的远端PW ID或VC ID。

十进制整数形式。

  • 当测试类型是PWE3 Ping时：支持VC Type为LDP方式。整数形式，取值范围是1～4294967295。缺省值是0。取值为0时，表示没有配置远端的PW ID。
  • 当测试类型是PWE3 Trace时：当VC Type为LDP时，整数形式，取值范围是1～4294967295，缺省值是0；当VC Type为BGP时，整数形式，取值范围是0～65534。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

使用remote-pw-id命令前，需要先在NQA视图下配置NQA测试例的测试类型为PWE3 Trace或者PWE3 Ping。

注意事项

配置lsp-version为rfc4379后，不能配置该命令。

remote-pw-id的取值须与display mpls l2vc remote-info verbose命令回显信息中的VC ID保持一致，否则可能导致测试失败。

使用实例

# 在NQA视图下配置远端的PW ID为100，管理者为admin，测试类型为pwe3trace。

<HUAWEI> system-view
[HUAWEI] nqa test-instance admin pwe3
[HUAWEI-nqa-admin-pwe3] test-type pwe3trace
[HUAWEI-nqa-admin-pwe3] remote-pw-id 100
相关主题

restart（NQA测试例视图）

命令功能

restart命令用来停止当前正在执行的测试例，重新启动该测试例。

命令格式

restart

参数说明

无

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

执行restart命令的效果相当于执行start now命令。

使用实例

# 重新启动测试例user test。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type jitter
[HUAWEI-nqa-user-test] destination-port 8000
[HUAWEI-nqa-user-test] destination-address ipv4 10.1.1.1
[HUAWEI-nqa-user-test] restart
相关主题

sendpacket passroute

命令功能

sendpacket passroute命令用来配置NQA测试例不查找路由表发送报文。

undo sendpacket passroute命令用来恢复NQA测试例查找路由表发送报文。

缺省情况下，NQA测试查找路由表发送报文。

命令格式

sendpacket passroute

undo sendpacket passroute

参数说明

无

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

必须先执行test-type命令指定测试类的测试类型，但只能对如下测试类型进行配置：
  • ICMP
  • TCP
  • UDP
  • HTTP
  • UDP Jitter
  • FTP
  • SNMP
  • Trace

注意事项

不能更改正在运行的测试例的此项配置。

当sendpacket passroute和source-interface同时配置时，source-interface命令生效，报文按指定出接口发送。

配置sendpacket passroute后，由于测试报文不查找路由转发，因此会造成同时配置的TTL（ttl）或ip-forwarding参数（ip-forwarding）无效。

使用实例

# 设置测试例user test不查找路由表发送报文。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type jitter
[HUAWEI-nqa-user-test] sendpacket passroute
相关主题

send-trap

命令功能

send-trap命令用来配置Trap消息的发送条件。

undo send-trap命令用来删除Trap消息的发送条件。

缺省情况下，不发送Trap消息。

命令格式

send-trap { all | { probefailure | rtd | testcomplete | testfailure | testresult-change } * }

undo send-trap { all | { probefailure | rtd | testcomplete | testfailure | testresult-change } * }

参数说明

参数 参数说明 取值
all
下面任何一种情况发生时，发送Trap消息：
  • 双向延时超过阈值
  • 探测失败
  • 测试成功
  • 测试失败
 -
probefailure

当探测失败时，发送Trap消息。

说明：

不能对UDP Jitter和ICMPJitter类型的测试例配置该参数。

 -
rtd

双向延时超过阈值时，发送Trap消息。

 -
testcomplete

当测试成功时，发送Trap消息。

 -
testfailure

当测试失败时，发送Trap消息。

 -
testresult-change 指定当探测结果发生变化时，发送Trap消息。
说明：

仅支持ICMP测试例。

 -

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

NQA测试成功或者失败都会产生Trap消息，可以通过设置Trap开关控制向网管发送何种类型的Trap消息。

当以下情况发生时，会向网管发送Trap消息

  • 发送双向延迟超过阈值：

    如果双向传输延迟超过设置的阈值时，则根据配置的网管地址向网管发送Trap消息。

  • 发送NQA探测失败：

    检查某个探针是否收到相应的响应报文。如果连续没有收到响应报文的次数达到指定数目，则根据配置的网管地址向网管发送Trap消息。

  • 发送NQA测试成功：

    当对某个目的地址的测试成功后，发送Trap通知网管。如果收到相应的响应报文，则根据配置的网管地址向网管发送Trap消息。

  • 发送NQA测试失败：

    检查某个测试是否失败。如果测试例连续测试的失败次数达到指定数目，则根据配置的网管地址向网管发送Trap消息。

执行send-trap可以配置发送Trap的条件，当符合指定条件时便向网管发送Trap消息。

前置条件

使用命令前，必先用命令test-type指定测试例的测试类型。但不能对Path Jitter测试进行配置。

除此之外，需要保证设备和网管设备路由可达，且相关配置已经完成。执行snmp-agent target-host trap命令，配置发送告警发送的主机，否则，Trap消息无法发送到网管端。

注意事项

不能对正在运行的测试例修改此项配置。

使用实例

# 允许测试例user test在测试失败情况下发送Trap消息。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type jitter
[HUAWEI-nqa-user-test] send-trap testfailure

sender-address

命令功能

sender-address命令用来在多跳PW场景下配置源IP地址。

undo sender-address命令用来恢复缺省配置。

缺省情况下，没有配置源IP地址。

命令格式

sender-address ipv4 ip-address

undo sender-address

参数说明

参数 参数说明 取值
ipv4 ip-address 指定IPv4源地址。 -

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

在多跳PW场景下进行pwe3ping，且指定lsp-version为rfc4379时，通过该命令指定与检测目的PE公网会话的源地址，通常为相邻SPE或UPE的地址。

注意事项

当配置了sender-address后，不能将lsp-version修改为draft6。

使用实例

# 多跳PW场景下指定pwe3ping测试例的sender-address为10.1.1.1。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type pwe3ping
[HUAWEI-nqa-user-test] lsp-version rfc4379
[HUAWEI-nqa-user-test] sender-address ipv4 10.1.1.1

set-df

命令功能

set-df命令用来设置报文的DF（Don't Fragment）位。即，不允许报文分片。

undo set-df命令用来恢复报文的DF（Don't Fragment）位的缺省值。

缺省情况下，允许报文被分片。

命令格式

set-df

undo set-df

参数说明

无

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

如果两台主机之间的通信需要经过多个网络，那么每个网络都可能具有不同的MTU值，所有网络中最小的MTU才是路径MTU。因此，当报文在不同网络中进行传输时，只有得知路径MTU才能确保报文的正常传输。

如果不设置对报文不分片，那么当报文的长度大于MTU值时，会将报文分成小于路径MTU的若干片，这样便无法检测出路径MTU。因此，如果想探测路径MTU，必须执行set-df设置测试例不允许报文分片，通过不断增加报文大小，达到测试路径MTU的目的。

前置条件

使用此命令前，必先执行test-type trace命令指定测试例的测试类型为Trace测试例。

注意事项

不能对正在运行的测试例修改此项配置。

使用实例

# 设置测试例user test发送的报文不被分片。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type trace
[HUAWEI-nqa-user-test] set-df
相关主题

source-address

命令功能

source-address命令用来配置NQA测试的源端的IP地址。

undo source-address命令用来恢复NQA测试的源端的IP地址的缺省值。

缺省情况下，使用发送测试报文的接口IP地址作为源IP地址。

命令格式

source-address ipv4 ipv4-address

undo source-address

参数说明

参数 参数说明 取值
ipv4 ipv4-address NQA测试例的IPv4源端地址。 IP地址为合法的点分十进制格式。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

当测试报文到达目的地址后，会将NQA测试例的源地址作为目的地址进行回应。执行source-address命令配置本次测试的源IP地址。若不指定源IP地址，系统将会使用发送测试报文的接口IP地址作为源IP地址。

前置条件

必先执行test-type命令指定测试例的测试类型，但所指定的测试类型不能为PWE3Ping、PWE3Trace和MAC Ping。

注意事项

不能对正在运行的测试例修改此项参数。

使用实例

# 设置测试例user test的源地址为10.1.1.1。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type jitter
[HUAWEI-nqa-user-test] source-address ipv4 10.1.1.1

source-interface

命令功能

source-interface命令用来配置NQA测试例的源端接口。

undo source-interface命令用来取消NQA测试例的源端接口配置。

缺省情况下，没有配置NQA测试例的源端接口。

命令格式

source-interface interface-type interface-number

undo source-interface

参数说明

参数 参数说明 取值
interface-type interface-number NQA测试源端接口类型和源端接口编号。 -

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

当测试报文到达目的地址后，会将NQA测试例的请求报文进行回应。执行source-interface命令可以配置NQA测试例的源接口，具体的应用场景如下：
  • 如果执行source-address命令指定NQA测试例的源IP地址，并且指定了NQA测试例的源接口。此时报文会从指定源接口发送出去，但是回应报文会从配置的源IP地址的接口返回。
  • 如果不指定NQA测试例的源IP地址，NQA测试例将会使用出接口的IP地址作为NQA测试例的源IP地址。此时NQA测试例的发送和回应报文都会走source-interface命令指定的出接口。

前置条件

使用命令前，必先用命令test-type指定测试类的测试类型，但只能对ICMP、ICMP Jitter、UDP Jitter、MAC Ping类型的测试例配置源接口。

注意事项

不能对正在运行的测试例修改此项参数。

配置NQA测试例的源端接口必须是已经配置了IP地址的接口，否则命令功能无法生效。

配置的源端接口不能为负载分担场景下的链路聚合接口或其成员口，否则命令功能无法生效。

使用实例

# 设置测试例user test的源接口为vlanif 100。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type icmp
[HUAWEI-nqa-user-test] source-interface vlanif 100

source-port

命令功能

source-port命令用来配置NQA测试的源端端口号。

undo source-port命令用来删除本次NQA测试的源端端口号的配置。

缺省情况下，测试例没有默认源端端口号，由系统随机分配。

命令格式

source-port port-number

undo source-port

参数说明

参数 参数说明 取值
port-number 指定测试的源端端口号。 不能配置成知名端口号。整数形式，取值范围是1～65535。不能是知名端口号或者被其他模块占用的端口号。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

通过指定NQA测试例的源端端口号，可以更加准确的规范NQA测试报文，避免类似ACL规则等对探测报文的过滤。执行source-port命令可以配置本次测试的源端端口号：
  • 如果不指定NQA测试例的源端端口号，则会随机选择可用的源端端口收发NQA测试例的报文。
  • 如果指定NQA测试例的源端端口号，则会从指定的源端端口号收发NQA测试例的报文。

前置条件

必先执行test-type命令指定测试例的测试类型，测试类型可以是FTP、HTTP、SNMP、UDP Jitter、TCP和UDP。

注意事项

执行source-port命令配置的源端端口号必须是有效端口号，否则探测失败。

(61441,65535]之间的端口号为产品预留端口号，不可使用，否则会导致探测失败。

不能对正在运行的测试例修改此项参数。

使用实例

# 设置测试例user test的源端端口号为3000。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type tcp
[HUAWEI-nqa-user-test] source-port 3000

start

命令功能

start命令用来配置NQA测试例的启动方式和结束方式。

undo start命令用来终止当前正在执行的测试例或者删除未执行NQA测试例的启动方式和结束方式的配置。

缺省情况下，测试报文发送完毕后，测试自动结束。

命令格式

start at [ yyyy/mm/dd ] hh:mm:ss [ end { at [ yyyy/mm/dd ] hh:mm:ss | delay { seconds second | hh:mm:ss } | lifetime { seconds second | hh:mm:ss } } ]

start delay { seconds second | hh:mm:ss } [ end { at [ yyyy/mm/dd ] hh:mm:ss | delay { seconds second | hh:mm:ss } | lifetime { seconds second | hh:mm:ss } } ]

start now [ end { at [ yyyy/mm/dd ] hh:mm:ss | delay { seconds second | hh:mm:ss } | lifetime { seconds second | hh:mm:ss } } ]

undo start

参数说明

参数 参数说明 取值
start at [ yyyy/mm/dd ] hh:mm:ss

开始执行测试例的时间点。

说明：

设定的时间必须晚于当前设备的时间。

 -
start delay { seconds second | hh:mm:ss }

延迟启动测试例执行的时间段。

  • seconds second：延迟指定的时间后启动。整数形式，取值范围是1～86399，单位是秒。

  • hh:mm:ss：延迟指定的时间后启动。以这种方式指定延迟时间后，系统会自动转换成以秒表示的形式。比如1:0:0表示延迟1小时（即3600秒）后启动。
start now 立即启动执行当前测试例。 -
end at [ yyyy/mm/dd ] hh:mm:ss 在指定的时间点结束当前执行的测试例。 -
end delay { seconds second | hh:mm:ss } 延迟结束测试例的执行。该延迟是相对于当前系统时间的延迟。例如：当用户在8:59:40执行命令start at 9:00:00 end delay seconds 60时，测试例在9:00:00开始执行，在9:00:40结束。

  • seconds second：延迟指定的时间后停止。整数形式，取值范围是6～86399，单位是秒。

  • hh:mm:ss：延迟指定的时间后停止。比如1:0:0表示测试例从当前系统时间算起，延迟3600s后停止。

说明：

延迟结束测试例的时间必须晚于延迟启动测试例的时间，且两者的时间差值必须大于等于6秒。
end lifetime { seconds second | hh:mm:ss } 配置测试例的持续时间。以测试例启动时间开始算起。例如：当用户在9:00:00执行命令start delay seconds 60 end lifetime seconds 120时，测试例开始执行时间是09:01:00，持续时间为120s，结束时间是09:03:00。

  • seconds second：以秒为单位设置测试例的生命周期。整数形式，取值范围是6～86399，单位是秒。

  • hh:mm:ss：设置测试例的生命周期。比如1:0:0表示从启动测试例时间算起，测试例的生命周期为3600s。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

配置完待执行的测试例及其相关属性之后，需要手工设置执行测试例的启动方式和结束方式，
  • 启动方式：
    • 在指定时间点开始测试例的执行。
    • 立即开始测试例的执行。
    • 延迟一段时间后开始测试例的执行。
  • 结束方式：
    • 在指定时间点结束测试例的执行。
    • 立即结束测试例的执行。
    • 延迟一段时间后结束测试例的执行。
    • 测试报文发送完毕后，测试自动结束。
可以根据实际需求灵活的设置启动方式和结束方式。

注意事项

如果当前正在执行的测试例总数已经达到系统允许的最大数目，start命令将失败。

对于同一个测试例，执行start now命令需要在上一次测试执行完成后，才能再次执行。若执行该命令的同时保存配置重启，重启后测试例会再执行一次。

配置在指定时间点开始测试例的执行时，需要注意当前设备的时间，以免造成设置无效时间。

使用实例

# 测试在当10小时后启动。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type jitter
[HUAWEI-nqa-user-test] destination-address ipv4 10.1.1.1
[HUAWEI-nqa-user-test] destination-port 4000
[HUAWEI-nqa-user-test] start delay 10:00:00

stop

命令功能

stop命令用来终止当前正在执行的NQA测试例。

命令格式

stop

参数说明

无

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

使用该命令只能终止当前正在进行的NQA测试例，也就是只能终止处于Active状态的测试例。

使用实例

# 停止测试例user test。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] stop
相关主题

test-failtimes

命令功能

test-failtimes命令用来配置在NQA测试失败后发送Trap的阈值。即，连续测试失败的次数。

undo test-failtimes命令用来恢复NQA测试失败后发送Trap的阈值的缺省值。

缺省情况下，测试失败一次就会发送一条Trap信息。

命令格式

test-failtimes times

undo test-failtimes

参数说明

参数 参数说明 取值
times NQA测试失败后发送trap的阈值。即，连续测试失败的次数。 整数形式，取值范围是1～15。缺省值是1。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

在NQA测试时，一次测试包含多次探测。在默认情况下，对于一次测试，有一次或一次以上探测成功，即认为该测试是成功的；若全部探测失败，则认为该测试失败。如果连续测试失败的次数达到了指定的数目，系统就会根据配置的网管地址向网管发送Trap消息。

前置条件

使用命令前，必先用命令test-type指定测试例的测试类型。但不能对Path Jitter测试进行配置。

后续任务

配置了test-failtimes命令后，需执行send-trap testfailure命令打开发送测试失败Trap开关。否则无法正常发送Trap消息。

注意事项

不能对正在运行的测试例更改此项配置。

使用实例

# 设置测试例user test的连续测试失败数为10。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type jitter
[HUAWEI-nqa-user-test] test-failtimes 10

test-type

命令功能

test-type命令用来配置NQA测试例的测试类型。

undo test-type命令用来取消NQA测试例的测试类型。

缺省情况下，未配置任何测试类型。

命令格式

test-type { dns | ftp | http | icmp | icmpjitter | jitter | lspjitter | lspping | lsptrace | macping | pathjitter | pwe3ping | pwe3trace | snmp | tcp | trace | udp }

undo test-type

S1720GFR不支持macping参数。

仅S5720EI、S5720HI、S6720EI和S6720S-EI支持lspjitter、lspping、lsptrace、pwe3ping和pwe3trace参数。

参数说明

参数 参数说明 取值
dns DNS测试。 -
ftp FTP服务测试。 -
http HTTP服务测试。 -
icmp ICMP测试。 -
icmpjitter ICMP Jitter测试，通过ICMP报文测试网络的抖动情况。 -
jitter UDP Jitter测试，测试对UDP报文处理的抖动情况。 -
lspjitter LSP抖动测试。 -
lspping LSP Ping测试。 -
lsptrace LSP Trace route测试。 -
macping MAC Ping测试。 -
pathjitter Path Jitter测试，通过ICMP报文测试报文传送过程中逐跳抖动情况。 -
pwe3ping PWE3 Ping测试。 -
pwe3trace PWE3 Trace测试。 -
snmp SNMP测试。 -
tcp TCP测试。 -
trace Trace测试。 -
udp UDP测试。 -

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

  • 在创建了NQA测试例之后，需要指定测试例的类型，之后才能根据测试例的类型来配置测试例的其它参数。
  • 当该测试例正在运行时，无法更改测试例的测试类型。
  • ICMP测试主要用于连通性检测，并不能完全准确地体现链路时延，链路时延及其他性能检测建议使用ICMP Jitter测试或UDP Jitter测试。

使用实例

# 配置NQA测试例的测试类型为TCP测试。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type tcp
相关主题

timestamp-unit

命令功能

timestamp-unit命令用来设置NQA测试例的时间戳单位。

undo timestamp-unit命令用来恢复缺省配置。

缺省情况下，NQA测试例的时间戳单位是毫秒。

命令格式

timestamp-unit { millisecond | microsecond }

undo timestamp-unit microsecond

参数说明

参数 参数说明 取值
millisecond 设置时间戳的单位为毫秒。 -
microsecond 设置时间戳的单位为微秒。 -

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

只能对ICMP Jitter和UDP Jitter类型的测试例配置时间戳单位。

使用实例

# 配置NQA测试例的时间戳单位为微秒。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type jitter
[HUAWEI-nqa-user-test] timestamp-unit microsecond
相关主题

threshold

命令功能

threshold命令用来设置双向传输延迟阈值。

undo threshold命令用来取消设置的双向传输延迟阈值。

缺省情况下，没有配置阈值。

命令格式

threshold rtd rtd-value

undo threshold rtd

参数说明

参数 参数说明 取值
rtd rtd-value 双向传输延迟阈值。 整数形式，取值范围是1～60000，单位根据timestamp-unit中配置的时间戳单位而定。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

必先执行test-type命令指定测试例的测试类型。但不能对Path Jitter测试例进行配置。

使用实例

# 设置双向传输延迟阈值为2ms。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type jitter
[HUAWEI-nqa-user-test] threshold rtd 2
相关主题

timeout

命令功能

timeout命令用来配置NQA测试例的一次探测的超时时间。

undo timeout命令用来恢复NQA测试例的一次探测的超时时间的缺省值。

缺省情况下，除FTP测试类型的超时时间为15秒外，其他测试类型的超时时间为3秒。

命令格式

timeout time

undo timeout

参数说明

参数 参数说明 取值
time 指定一次探测的超时时间。 整数形式，取值范围是1～60，单位是秒。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

测试超时时间是指发送完探测报文后，等待响应报文的时间。如果超过此时间没有收到响应报文，认为该次测试失败。超时时间的设定需要根据具体网络。

对于质量较差、传输速率不高的网络，为了保证NQA探测报文能够收到回应，需要加大发送探测报文的超时时间。

前置条件

必先执行test-type命令指定测试例的测试类型。

注意事项

  • 建议根据测试例执行测试结果的RTT值来配置超时时间，要保证timeout命令设置的超时时间必须大于RTT值。
  • timeout命令设置的超时时间必须不大于interval命令设置的自动执行测试间隔，否则会导致报文超时。

注意事项

不能修改正在运行的测试例的此项配置。

在ICMP测试过程中，如果同时满足如下条件时，当前测试的结果表中的“Completion”字段会显示为“no result”：

使用实例

# 设置测试例user test的超时时间为20秒。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type jitter
[HUAWEI-nqa-user-test] timeout 20

tos

命令功能

tos命令用来配置NQA测试报文的服务类型。

undo tos命令用来恢复NQA测试报文的服务类型的缺省值。

缺省情况下，ToS的值为0。

命令格式

tos value

undo tos

参数说明

参数 参数说明 取值
value 报文的服务类型。 整数形式，取值范围是0～255。缺省值是0。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

ToS值包含两个子字段：优先权和ToS。其中优先权用来设置报文的优先级，ToS字段通常不用（所有位被设置为0）。通过配置ToS值，可以设置探测报文的优先级别。这样，在报文流量较大时可以优先处理优先级高的报文。

前置条件

必先执行命令test-type指定测试例的测试类型，支持如下测试类型：
  • FTP
  • HTTP
  • ICMP
  • ICMP Jitter
  • UDP Jitter
  • SNMP
  • TCP
  • UDP

配置影响

如果已经配置测试例的ToS值，再执行tos命令将覆盖原有配置。

注意事项

如果测试例正在运行，则不能修改ToS值。

使用实例

# 设置测试例user test的服务类型为10。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type icmp
[HUAWEI-nqa-user-test] tos 10
相关主题

tracert-hopfailtimes

命令功能

tracert-hopfailtimes命令用来配置NQA测试中Trace测试例失败的失败跳数。

undo tracert-hopfailtimes命令用来恢复NQA测试中Trace测试例失败的失败跳数的缺省值。

缺省情况下，一次探测中的失败跳数达到5次就认为此次探测失败。

命令格式

tracert-hopfailtimes times

undo tracert-hopfailtimes

参数说明

参数 参数说明 取值
times NQA测试连续失败跳数。 整数形式，取值范围是1～255。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

只能对Trace类型的测试例配置连续失败跳数。

不能修改正在运行的测试例的此项配置。

使用实例

# 设置测试例user test的连续测试失败数为6次。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type trace
[HUAWEI-nqa-user-test] tracert-hopfailtimes 6
相关主题

tracert-livetime

命令功能

tracert-livetime命令用来配置NQA测试Trace测试例的生存时间。

undo tracert-livetime命令用来恢复NQA测试Trace测试例的生存时间的缺省值。

缺省情况下，初始TTL值为1，最大TTL值为30。

命令格式

tracert-livetime first-ttl first-ttl max-ttl max-ttl

undo tracert-livetime

参数说明

参数 参数说明 取值
first-ttl first-ttl 指定报文的初始TTL值。 整数形式，取值范围是1～255。缺省值是1。
max-ttl max-ttl 指定报文的最大TTL值。 整数形式，取值范围是1～255。max-ttl的值不能小于first-ttl。缺省情况下，报文的最大TTL值为30。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

只能对Trace类型的测试例配置tracert-livetime命令。

不能改变正在运行的测试例的此项配置。

使用实例

# 设置测试例user test的生存时间，初始TTL为5，最大TTL为20。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type trace
[HUAWEI-nqa-user-test] tracert-livetime first-ttl 5 max-ttl 20
相关主题

ttl

命令功能

ttl命令用来配置NQA测试例测试报文的TTL值。

undo ttl命令用来恢复NQA测试例测试报文的TTL值的缺省值。

缺省情况下，TTL值为30。

命令格式

ttl number

undo ttl

参数说明

参数 参数说明 取值
number 指定TTL值。 整数形式，取值范围是1～255。缺省值是30。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

为了防止测试报文无休止地被传输，必须保证测试例在一定跳数范围内执行。

在最初创建测试报文时，ttl命令设置TTL为某个特定的值。当测试报文逐个沿三层路由设备进行传输时，每台三层路由设备都使TTL的数值减1，当TTL的值减为0时，三层路由设备将会丢弃该测试报文并向发送端发送错误信息。从而有效地防止了报文的无休止传输。

前置条件

必先执行test-type命令指定测试类的测试类型，但不能对如下测试类型进行配置：
  • DNS
  • Trace
  • MAC Ping
  • Path Jitter

配置影响

如果已经配置过TTL值，那么再次执行ttl命令将覆盖原有配置。

注意事项

不能修改正在运行的测试例的TTL值。

使用实例

# 设置测试例user test的报文TTL值为10。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type icmp
[HUAWEI-nqa-user-test] ttl 10
相关主题

ttl-copymode

命令功能

ttl-copymode命令用来在多跳VCCV检测中，指定标签复制模式，提供Pipe、Uniform两种模式供用户选择。

undo ttl-copymode命令用来取消在NQA测试例视图下配置的TTL复制模式。

缺省情况下，不同产品的缺省值不同。

命令格式

ttl-copymode { pipe | uniform }

undo ttl-copymode

参数说明

参数 参数说明 取值
pipe 设置TTL的复制方式为Pipe。 -
uniform 设置TTL的复制方式为Uniform。 -

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

在测试多跳VCCV时，如果网络中存在的产品缺省的TTL复制行为不同，即Pipe和Uniform方式并存，则用户需要指定头节点的TTL复制行为。该命令用于检测PWE3网络和BGP/MPLS IP VPN网络。

Pipe、Uniform两种模式对TTL的处理如下：
  • 设置TTL的复制方式为Pipe时，系统收到报文后，剥掉外层标签，将内层标签TTL减1，再将外层标签TTL设为255；
  • 设置TTL的复制方式为Uniform时，系统收到报文后，将外层标签TTL拷贝到内层标签中，再将内层标签TTL减1，再次封装外层标签时，TTL设为内层标签中TTL的值。

只有PWE3 Ping、PWE3 Trace、Trace测试例支持该命令。当测试类型为Trace时，需要先使用vpn-instance vpn-instance-name命令，将NQA测试例与VPN实例绑定。

使用实例

# 配置NQA Trace测试类型的TTL复制方式为pipe。

<HUAWEI> system-view
[HUAWEI] nqa test-instance admin trace
[HUAWEI-nqa-admin-trace] test-type trace
[HUAWEI-nqa-admin-trace] vpn-instance voice
[HUAWEI-nqa-admin-trace] ttl-copymode pipe
相关主题

undo no-control-word

命令功能

undo no-control-word命令用来使能control-word选项。

缺省情况下，报文封装类型使用控制字control-word方式。

命令格式

undo no-control-word

参数说明

无

视图

NQA视图

缺省级别

2：配置级

使用指南

control-word选项是在报文中封装的control-word控制字信息，用于转发层面报文顺序检测、报文分片和重组等功能。

缺省情况下，报文封装类型使用控制字control-word方式。当和其他厂商互通时，如果其他厂商的报文结构中没有control-word控制字信息，可以执行命令label-type { { label-alert | normal } no-control-word }，使用no-control-word参数去掉control-word选项。

为了恢复华为公司报文的结构，可以执行本命令。

仅PWE3 Ping测试例和PWE3 Trace测试例支持该命令。

使用实例

# 使能control-word选项。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type pwe3ping
[HUAWEI-nqa-user-test] label-type label-alert no-control-word
[HUAWEI-nqa-user-test] undo no-control-word
相关主题

vc-type

命令功能

vc-type命令用来在NQA测试例视图下配置建立L2VPN VC的协议类型。

undo vc-type命令用来取消在NQA测试例视图下配置的L2VPN VC的协议类型。

缺省情况下，建立L2VPN VC的协议类型为LDP方式。

命令格式

vc-type { ldp | bgp }

undo vc-type

参数说明

参数 参数说明 取值
ldp 指定LDP作为信令协议传播内层标签。 -
bgp 指定BGP作为信令协议传播内层标签。 -

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

应用场景

执行vc-type命令配置测试例的信令方式和待检测网络的PW的信令方式保持一致。

前置条件

支持配置vc-type ldp的测试例类型：
  • PWE3 Ping
  • PWE3 Trace
支持配置vc-type bgp的测试例类型：
  • PWE3 Trace

注意事项

不能改变正在执行测试例的信令协议。

使用实例

# 在NQA视图下配置建立L2VPN VC的协议类型为BGP。

<HUAWEI> system-view
[HUAWEI] nqa test-instance admin pwe3
[HUAWEI-nqa-admin-pwe3] test-type pwe3trace
[HUAWEI-nqa-admin-pwe3] vc-type bgp
相关主题

vpn-instance（NQA测试例视图）

命令功能

vpn-instance命令用来配置NQA测试例的VPN实例名。

undo vpn-instance命令用来删除NQA测试例的VPN实例名。

缺省情况下，未配置VPN实例名。

仅S1720GW-E、S1720GWR-E、S1720X-E、S2720EI、S5720LI、S5720S-LI、S5720SI、S5720S-SI、S5730SI、S5730S-EI、S5720EI、S5720HI、S6720LI、S6720S-LI、S6720SI、S6720S-SI、S6720EI和S6720S-EI支持此命令。

命令格式

vpn-instance vpn-instance-name

undo vpn-instance

参数说明

参数 参数说明 取值
vpn-instance-name 数据报文所属VPN实例的名称。 必须是已存在的VPN实例名称。

视图

NQA测试例视图

缺省级别

2：配置级

使用指南

只能对FTP、HTTP、ICMP、ICMP Jitter、Path Jitter、SNMP、TCP、Trace、UDP和UDP Jitter类型的NQA测试例配置VPN实例。

在PWE3 Trace测试例中，如果使用vc-type命令配置建立L2VPN VC的协议类型为BGP时，可以执行vpn-instance命令配置NQA测试例的VPN实例名。

不能更改正在运行的测试例的此项参数。

使用实例

# 设置测试例user test的VPN实例vrf1。

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type icmp
[HUAWEI-nqa-user-test] vpn-instance vrf1
相关主题
翻译
收藏
下载文档
更新时间：2021-10-30
文档编号：EDOC1000178145
浏览量：333752
下载量：5001
平均得分：5.0分

相关文档

数字签名

数字签名校验工具