12-NQA命令
本章节下载: 12-NQA命令 (217.39 KB)
目 录
1.1.3 description (any NQA test type view)
1.1.14 nqa agent max-concurrent
1.1.16 operation (FTP test type view)
1.1.17 operation (HTTP test type view)
1.1.19 password (FTP test type view)
1.1.27 route-option bypass-route
1.1.35 username (FTP test type view)
1.1.36 vpn-instance (ICMP-echo test type view)
1.2.1 display nqa server status
【命令】
data-fill string
undo data-fill
【视图】
ICMP-echo/UDP-echo/UDP-jitter测试类型视图
【缺省级别】
2:系统级
【参数】
string:探测报文的填充内容,为1~200个字符的字符串,区分大小写。
【描述】
data-fill命令用来配置发送的探测报文的填充字符串。undo data-fill命令用来恢复缺省情况。
缺省情况下,探测报文的填充字符串为十六进制数值00010203040506070809。
l 如果探测报文的数据段长度比配置的填充数据长度小,系统在报文封装时以报文的数据段长度为界截取该字符串的前一部分;
l 如果探测报文的数据段长度比配置的填充数据长度大,系统在报文封装时用该字符串进行循环填充,直到填满。
例如,配置填充数据为“abcd”,当探测报文数据段长度为3字节时,则取“abc”作为填充数据;当探测报文大小为6字节时,则使用“adcdab”作为填充数据。
l 在ICMP-echo测试中,配置的字符串用来填充ICMP Echo消息的数据字段。
l 在UDP-echo测试中,由于UDP报文数据字段的前5个字节具有特定用途,所以只用所配置的字符串填充报文中剩余的字节;
l 在UDP-jitter测试中,UDP报文数据字段的前68个字节具有特定用途,所以只用所配置的字符串填充报文中剩余的字节。
【举例】
# 配置ICMP-echo探测报文的填充字符串为abcd。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-echo] data-fill abcd
【命令】
data-size size
undo data-size
【视图】
ICMP-echo/UDP-echo/UDP-jitter测试类型视图
【缺省级别】
2:系统级
【参数】
size:探测报文的大小,单位为字节,ICMP-echo和UDP-echo测试类型取值范围为20~8100,UDP-jitter测试类型取值范围为68~8100。
【描述】
data-size命令用来配置发送的探测报文的大小。undo data-size命令用来恢复缺省情况。
缺省情况下,发送的探测报文为100字节。
l 对于ICMP-echo测试,探测报文大小为ICMP Echo消息中数据字段的长度。
l 对于UDP-echo和UDP-jitter测试,探测报文大小为UDP报文中数据字段的长度。
【举例】
# 配置发送的ICMP-echo探测报文为80字节。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-echo] data-size 80
【命令】
description text
undo description
【视图】
任意测试类型视图
【缺省级别】
2:系统级
【参数】
text:测试组的描述,为1~200个字符的字符串,区分大小写。
【描述】
description命令用来对测试组进行简要描述,通常用于描述一个测试组的测试类型或测试目的。undo description命令用来删除已配置的描述信息。
缺省情况下,未配置描述字符串。
【举例】
# 配置测试组的描述字符串为icmp-probe。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-echo] description icmp-probe
【命令】
destination ip ip-address
undo destination ip
【视图】
DLSw/FTP/HTTP/ICMP-echo/SNMP/TCP/UDP-echo/UDP-jitter测试类型视图
【缺省级别】
2:系统级
【参数】
ip-address:测试操作的目的IP地址。
【描述】
destination ip命令用来配置测试操作的目的IP地址。undo destination ip命令用来删除已配置的目的IP地址。
缺省情况下,未配置测试操作的目的IP地址。
【举例】
# 配置ICMP-echo测试操作的目的IP地址为10.1.1.1。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-echo] destination ip 10.1.1.1
【命令】
destination port port-number
undo destination port
【视图】
TCP/UDP-echo/UDP-jitter测试类型视图
【缺省级别】
2:系统级
【参数】
port-number:测试操作的目的端口号,取值范围为1~65535。
【描述】
destination port命令用来配置测试操作的目的端口号。undo destination port命令用来删除已配置的目的端口号。
缺省情况下,未配置测试操作的目的端口号。
需要注意的是,建议不要对1~1023之间的端口(知名端口)进行UDP-jitter测试,否则可能导致NQA测试失败或该知名端口对应的服务不可用。
【举例】
# 配置测试操作的目的端口号为9000。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type udp-echo
[Sysname-nqa-admin-test-udp-echo] destination port 9000
【命令】
display nqa { result | history } [ admin-name operation-tag ]
【视图】
任意视图
【缺省级别】
2:系统级
【参数】
result:显示最近一次测试的结果。
history:显示测试的历史记录。
admin-name:指定创建操作的管理员名字,为1~32字符的字符串,不区分大小写。
operation-tag:指定测试操作的标签,为1~32字符的字符串,不区分大小写。
【描述】
display nqa命令用来显示NQA测试操作信息。
如果不指定测试组参数(admin-name和operation-tag),将显示所有测试组的信息。
【举例】
# 查看管理员名字为administrator,测试操作标签为jitter的NQA测试最后一次测试的结果。
<Sysname> display nqa result administrator jitter
NQA entry(admin administrator, tag jitter) test results:
Destination IP address: 192.168.0.81
Send operation times: 10 Receive response times: 0
Min/Max/Average round trip time: 0/0/0
Square-Sum of round trip time: 0
Last succeeded probe time: 0-00-00 00:00:00.0
Extend results:
Packet lost in test: 100%
Failures due to timeout: 10
Failures due to disconnect: 0
Failures due to no connection: 0
Failures due to sequence error: 0
Failures due to internal error: 0
Failures due to other errors: 0
UDP-jitter results:
RTT number: 0
SD max delay: 0 DS max delay: 0
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 average: 0 Positive DS average: 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 average: 0 Negative DS average: 0
Negative SD square sum: 0 Negative DS square sum: 0
SD lost packet(s): 0 DS lost packet(s): 0
Lost packet(s) for unknown reason: 10
表1-1 display nqa result命令显示信息描述表
字段 |
描述 |
Destination IP address |
目的IP地址 |
Send operation times |
发送的探测报文数 |
Receive response times |
收到的响应报文数 |
Min/Max/Average round trip time |
最小/最大/平均往返时间 |
Square-Sum of round trip time |
往返时间平方和 |
Last succeeded probe time |
一次测试中最后一次成功探测的完成时间,如果一次测试中的探测均失败,则该时间显示为全0 |
Packet lost in test |
平均丢包率 |
Failures due to timeout |
测试过程中超时的次数 |
Failures due to disconnect |
对方强制断开连接的次数 |
Failures due to no connection |
和对方建立连接失败的次数 |
Failures due to sequence error |
因报文失序失败的次数 |
Failures due to internal error |
因内部错误失败的次数 |
Failures due to other errors |
其它错误数 |
UDP-jitter results |
UDP-jitter测试的结果,只在UDP-jitter测试中存在此信息 |
RTT number |
收到的响应报文数 |
SD max delay |
源到目的的最大时延 |
DS max delay |
目的到源的最大时延 |
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 average |
源到目的方向抖动时延为正值的平均值 |
Positive DS average |
目的到源方向抖动时延为正值的平均值 |
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 average |
源到目的方向抖动时延为负值的绝对值的平均值 |
Negative DS average |
目的到源方向抖动时延为负值的绝对值的平均值 |
Negative SD square sum |
源到目的方向抖动时延为负值的平方和 |
Negative DS square sum |
目的到源方向抖动时延为负值的平方和 |
SD lost packet(s) |
源到目的方向丢失的报文个数 |
DS lost packet(s) |
目的到源方向丢失的报文个数 |
Lost packet(s) for unknown reason |
不能确定原因丢失的报文个数 |
# 查看管理员名字为administrator,测试操作标签为test的NQA测试的历史记录。
<Sysname> display nqa history administrator test
NQA entry(admin administrator, tag test) history record(s):
Index Response Status Time
10 329 Succeeded 2007-04-29 20:54:26.5
9 344 Succeeded 2007-04-29 20:54:26.2
8 328 Succeeded 2007-04-29 20:54:25.8
7 328 Succeeded 2007-04-29 20:54:25.5
6 328 Succeeded 2007-04-29 20:54:25.1
5 328 Succeeded 2007-04-29 20:54:24.8
4 328 Succeeded 2007-04-29 20:54:24.5
3 328 Succeeded 2007-04-29 20:54:24.1
2 328 Succeeded 2007-04-29 20:54:23.8
1 328 Succeeded 2007-04-29 20:54:23.4
表1-2 display nqa history命令显示信息描述表
字段 |
描述 |
Index |
历史记录的编号 |
Response |
测试成功时,为测试报文的往返时延;如果测试超时,则为超时时间;不能完成测试时,则为0。单位为毫秒 |
Status |
测试结果的状态值,具体如下: l Succeeded:测试成功,接收到响应报文 l Unknown error:未知错误 l Internal error:内部错误 l Timeout:请求超时 |
Time |
测试完成时间 |
【命令】
filename filename
undo filename
【视图】
FTP测试类型视图
【缺省级别】
2:系统级
【参数】
filename:FTP服务器和客户端之间传送文件的文件名,为1~200个字符的字符串,区分大小写。
【描述】
filename命令用来配置FTP服务器和客户端之间传送文件的文件名。undo filename命令用来恢复缺省情况。
缺省情况下,未配置FTP服务器和客户端之间传送文件的文件名。
【举例】
# 配置FTP服务器和客户端之间要传送文件的文件名为config.txt。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type ftp
[Sysname-nqa-admin-test-ftp] filename config.txt
【命令】
frequency interval
undo frequency
【视图】
任意测试类型视图
【缺省级别】
2:系统级
【参数】
interval:连续两次测试开始时间的时间间隔,取值范围为0~604800000,单位为毫秒。时间间隔为0,表示两次测试的时间间隔为无穷,即只进行一次测试。
【描述】
frequency命令用来配置测试组连续两次测试开始时间的时间间隔。undo frequency命令用来恢复缺省情况。
缺省情况下,测试组连续两次测试开始时间的时间间隔为0毫秒,即只进行一次测试。
通过nqa schedule命令启动NQA测试后,每隔interval时间启动一次测试。
如果到达frequency指定的时间间隔时,上次测试尚未完成,则不启动新一轮测试。
【举例】
# 配置连续两次测试开始时间的时间间隔为1000毫秒。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-echo] frequency 1000
【命令】
history-records number
undo history-records
【视图】
任意测试类型视图
【缺省级别】
2:系统级
【参数】
number:在一个测试组中能够保存的最大历史记录个数,取值范围为0~50。
【描述】
history-records命令用来配置在一个测试组中能够保存的最大历史记录个数。undo history-records命令用来恢复缺省情况。
缺省情况下,一个测试组中能够保存的最大历史记录个数为50。
如果历史记录个数超过设定的最大数目,则最早的探测的历史记录将会被丢弃。
【举例】
# 配置一个测试组中能够保存的最大历史记录数为10个。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-echo] history-records 10
【命令】
http-version v1.0
undo http-version
【视图】
HTTP测试类型视图
【缺省级别】
2:系统级
【参数】
v1.0:HTTP测试使用的版本为1.0。
【描述】
http-version命令用来配置测试所使用的版本。undo http-version命令用来恢复缺省情况。
缺省情况下,HTTP测试使用的版本为1.0。
【举例】
# 配置HTTP测试使用的版本为1.0。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type http
[Sysname-nqa-admin-test-http] http-version v1.0
【命令】
next-hop ip-address
undo next-hop
【视图】
ICMP-echo测试类型视图
【缺省级别】
2:系统级
【参数】
ip-address:下一跳IP地址。
【描述】
next-hop命令用来配置IP报文的下一跳IP地址。undo next-hop命令用来删除所配置的下一跳IP地址。
缺省情况下,未配置下一跳IP地址。
【举例】
# 配置下一跳IP地址为10.1.1.1。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-echo] next-hop 10.1.1.1
【命令】
nqa entry admin-name operation-tag
undo nqa { all | entry admin-name operation-tag }
【视图】
系统视图
【缺省级别】
2:系统级
【参数】
admin-name:创建操作的管理员名字,为1~32个字符的字符串,字符串中不能包括“-”,不区分大小写。
operation-tag:测试操作的标签,为1~32个字符的字符串,字符串中不能包括“-”,不区分大小写。
all:所有NQA测试组。
【描述】
nqa命令用来创建NQA测试组,并进入NQA测试组视图。undo nqa命令用来删除NQA测试组。
需要注意的是,如果测试组已经配置了测试类型,执行本命令时将直接进入测试组测试类型视图。
【举例】
# 创建一个管理员名为admin,测试操作标签为test的NQA测试组,并进入NQA测试组视图。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test]
【命令】
nqa agent enable
undo nqa agent enable
【视图】
系统视图
【缺省级别】
2:系统级
【参数】
无
【描述】
nqa agent enable命令用来开启NQA客户端功能。undo nqa agent enable命令用来关闭NQA客户端功能,并停止所有正在进行的测试。
缺省情况下,NQA客户端功能处于开启状态。
相关配置可参考命令nqa server enable。
【举例】
# 开启NQA客户端功能。
<Sysname> system-view
[Sysname] nqa agent enable
【命令】
nqa agent max-concurrent number
undo nqa agent max-concurrent
【视图】
系统视图
【缺省级别】
2:系统级
【参数】
number:处于测试状态的NQA测试的最大个数。取值范围为1~5。
【描述】
nqa agent max-concurrent命令用来配置允许同时处于测试状态的NQA测试的最大个数。undo nqa agent max-concurrent命令用来恢复缺省情况。
缺省情况下,处于测试状态的NQA测试的最大个数为2个。
从测试开始,到本次测试结束,NQA测试处于测试状态;本次测试结束,到下一次测试开始,NQA测试处于等待状态。
【举例】
# 配置处于测试状态的NQA测试操作的最大个数为50。
<Sysname> system-view
[Sysname] nqa agent max-concurrent 50
【命令】
nqa schedule admin-name operation-tag start-time now lifetime forever
undo nqa schedule admin-name operation-tag
【视图】
系统视图
【缺省级别】
2:系统级
【参数】
admin-name:创建操作的管理员名字,为1~32个字符的字符串,不区分大小写。
operation-tag:测试操作的标签,为1~32个字符的字符串,不区分大小写。
now:测试组立即开始测试。
forever:测试组将一直进行测试。
【描述】
nqa schedule命令用来设置测试组测试的起始时间和时间周期。undo nqa schedule命令用来停止该测试组的测试。
需要注意的是:
l 测试组被调度后不允许进入测试组视图和测试类型视图。
l 设备暂不支持配置NQA测试的结束时间,需要通过执行undo nqa schedule命令停止测试。
【举例】
# 启动管理员名字为admin,标签为test的测试组进行测试。
<Sysname> system-view
[Sysname] nqa schedule admin test start-time now lifetime forever
【命令】
operation { get | put }
undo operation
【视图】
FTP测试类型视图
【缺省级别】
2:系统级
【参数】
get:从FTP服务器获取文件。
put:向FTP服务器传送文件。
【描述】
operation命令用来配置FTP测试的操作方式。undo operation命令用来恢复缺省情况。
缺省情况下,FTP测试的操作方式为get操作。
【举例】
# 配置FTP测试的操作方式为put操作。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type ftp
[Sysname-nqa-admin-test-ftp] operation put
【命令】
operation { get | post }
undo operation
【视图】
HTTP测试类型视图
【缺省级别】
2:系统级
【参数】
get:从HTTP服务器获取数据。
post:向HTTP服务器传送数据。
【描述】
operation命令用来配置HTTP测试的操作方式。undo operation命令用来恢复缺省情况。
缺省情况下,HTTP测试的操作方式为get操作。
【举例】
# 配置HTTP测试的操作方式为post操作。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type http
[Sysname-nqa-admin-test-http] operation post
【命令】
operation interface interface-type interface-number
undo operation interface
【视图】
DHCP测试类型视图
【缺省级别】
2:系统级
【参数】
interface-type interface-number:进行DHCP测试的接口类型和接口编号。
【描述】
operation interface命令用来指定进行DHCP测试的接口。undo operation interface命令用来恢复缺省情况。
缺省情况下,没有指定进行DHCP测试的接口。
需要注意的是,该命令指定的接口必须为up状态,否则会导致测试失败。
【举例】
l 路由应用
# 指定进行DHCP测试的接口为Ethernet1/1。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type dhcp
[Sysname-nqa-admin-test-dhcp] operation interface ethernet 1/1
l 交换应用
# 指定进行DHCP测试的接口为VLAN接口2。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type dhcp
[Sysname-nqa-admin-test-dhcp] operation interface vlan-interface 2
【命令】
password password
undo password
【视图】
FTP测试类型视图
【缺省级别】
2:系统级
【参数】
password:登录FTP服务器时所需的密码,为1~32个字符的字符串,区分大小写。
【描述】
password命令用来配置登录FTP服务器时客户端需要输入的密码。undo password命令用来取消已配置的密码。
缺省情况下,未配置登录FTP服务器时客户端需要输入的密码。
相关配置可参考命令username和operation。
【举例】
# 配置登录FTP服务器密码为ftpuser。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type ftp
[Sysname-nqa-admin-test-ftp] password ftpuser
【命令】
probe count times
undo probe count
【视图】
任意测试类型视图
【缺省级别】
2:系统级
【参数】
times:一次NQA测试中进行探测的次数,取值范围为1~15。
【描述】
probe count命令用来设置一次NQA测试中探测的次数。undo probe count命令用来恢复缺省情况。
缺省情况下,一次NQA测试中的探测次数为1次。
l 对于TCP和DLSw测试,一次探测是指一次连接;
l 对于UDP-jitter测试,一次探测发送探测报文的个数由probe packet-number命令确定;
l 对于FTP、HTTP和DHCP测试,一次探测是指完成一次相应的功能;
l 对于ICMP-echo和UDP-echo测试,一次探测发送一个探测报文;
l 对于SNMP测试,一次探测发送三个探测报文。
如果配置次数大于1,那么系统在进行第一次探测之后,等待回应。如果一直没有收到回应,则等到探测定时器超时,发起第二次探测。如此反复,直到完成指定次数的探测。
【举例】
# 配置一次ICMP-echo测试中探测的次数为10次。
<Sysname> system-view
[Sysname] nqa entry admin-test
[Sysname-nqa-admin-test] type icmp-echo
[Syaname-nqa-admin-test-icmp-echo] probe count 10
【命令】
probe packet-interval packet-interval
undo probe packet-interval
【视图】
UDP-jitter测试类型视图
【缺省级别】
2:系统级
【参数】
packet-interval:UDP-jitter测试中发送探测报文的时间间隔,取值范围为10~1000,单位为毫秒。
【描述】
probe packet-interval命令用来配置UDP-jitter测试中发送探测报文的时间间隔。undo probe packet-interval命令用来恢复缺省情况。
缺省情况下,UDP-jitter测试中发送探测报文的时间间隔为20毫秒。
【举例】
# 配置UDP-jitter测试中发送探测报文的时间间隔为100毫秒。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type udp-jitter
[Syaname-nqa-admin-test-udp-jitter] probe packet-interval 100
【命令】
probe packet-number packet-number
undo probe packet-number
【视图】
UDP-jitter测试类型视图
【缺省级别】
2:系统级
【参数】
packet-number:一次UDP-jitter探测中发送探测报文的个数,取值范围为10~1000。
【描述】
probe packet-number命令用来配置一次UDP-jitter探测中发送探测报文的个数。undo probe packet-number命令用恢复缺省情况。
缺省情况下,一次UDP-jitter探测中发送10个探测报文。
【举例】
# 配置一次UDP-jitter探测中发送100个探测报文。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type udp-jitter
[Syaname-nqa-admin-test-udp-jitter] probe packet-number 100
【命令】
probe packet-timeout packet-timeout
undo probe packet-timeout
【视图】
UDP-jitter测试类型视图
【缺省级别】
2:系统级
【参数】
packet-timeout:UDP-jitter测试中等待响应报文的超时时间,取值范围为10~3600000,单位为毫秒。
【描述】
probe packet-timeout命令用来设置UDP-jitter测试中等待响应报文的超时时间。undo probe packet-timeout命令用来恢复缺省情况。
缺省情况下,UDP-jitter测试中等待响应报文的超时时间为3000毫秒。
【举例】
# 配置UDP-jitter测试中等待响应报文的超时时间为100毫秒。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type udp-jitter
[Syaname-nqa-admin-test-udp-jitter] probe packet-timeout 100
【命令】
probe timeout timeout
undo probe timeout
【视图】
DHCP/DLSw/FTP/HTTP/ICMP-echo/SNMP/TCP/UDP-echo测试类型视图
【缺省级别】
2:系统级
【参数】
timeout:除UDP-jitter探测以外,一次探测的超时时间,单位为毫秒。在FTP、HTTP探测中,取值范围为10~86400000;在DHCP、DLSw、ICMP-echo、SNMP、TCP、UDP-echo探测中,取值范围为10~3600000。
【描述】
probe timeout命令用来设置探测的超时时间。undo probe timeout命令用来恢复缺省情况。
缺省情况下,探测的超时时间为3000毫秒。
NQA探测开始后,如果在probe timeout命令指定的时间内没有完成NQA探测,则认为本次探测超时。
【举例】
# 配置DHCP探测的超时时间为10000毫秒。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type dhcp
[Syaname-nqa-admin-test-dhcp] probe timeout 10000
【命令】
reaction item-num checked-element probe-fail threshold-type consecutive occurrences [ action-type { none | trigger-only } ]
undo reaction item-num
【视图】
DHCP/DLSw/FTP/HTTP/ICMP-echo/SNMP/TCP/UDP-echo测试类型视图
【缺省级别】
2:系统级
【参数】
item-num:联动项序号,取值范围为1~10。
checked-element:联动的监测元素类型,目前监测元素的类型只能是探测失败。
probe-fail:监测元素的类型为探测失败。
threshold-type consecutive:门限类型为连续探测失败。
occurrences:连续探测失败次数,取值范围为1~16。
action-type:触发的动作类型,缺省动作类型为none。
none:不做任何动作。
trigger-only:只触发其他模块联动。
【描述】
reaction命令用来建立联动项,对当前所在测试组中的探测进行监测,当连续探测失败次数达到阈值时,就触发其他模块联动。undo reaction命令用来删除联动项。
缺省情况下,未配置联动项。
需要注意的是,联动项创建后,不能再通过reaction命令修改该联动项的内容。
相关配置可参考“系统分册/Track命令”中的命令track。
【举例】
# 建立序号为1的联动项,连续探测失败3次,触发其他模块联动。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type tcp
[Sysname-nqa-admin-test-tcp] reaction 1 checked-element probe-fail threshold-type consecutive 3 action-type trigger-only
【命令】
reaction trap { probe-failure consecutive-probe-failures | test-complete | test-failure cumulate-probe-failures }
undo reaction trap { probe-failure | test-complete | test-failure }
【视图】
任意测试类型视图
【缺省级别】
2:系统级
【参数】
probe-failure consecutive-probe-failures:一次NQA测试中探测连续失败consecutive-probe-failures次后向网管服务器发送探测失败的Trap消息。consecutive-probe-failures为一次测试中连续探测失败的次数,取值范围为1~15。
test-complete:当测试完成时发送测试完成的Trap消息。
test-failure cumulate-probe-failures:一次NQA测试中探测失败的累计次数大于或等于cumulate-probe-failures次后向网管服务器发送测试失败的Trap消息。对于一次测试,只在测试完成后,发送一次该Trap消息。cumulate-probe-failures为一次测试中累计探测失败的次数,取值范围为1~15。
【描述】
reaction trap命令用来配置在指定条件下向网管服务器发送Trap消息。undo reaction trap命令用来恢复缺省情况。
缺省情况下,不向网管服务器发送Trap消息。
【举例】
# 配置ICMP-echo测试中连续探测失败5次之后发送探测失败的Trap消息。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-echo] reaction trap probe-failure 5
【命令】
route-option bypass-route
undo route-option bypass-route
【视图】
DLSw/FTP/HTTP/ICMP-echo/SNMP/TCP/UDP-echo/UDP-jitter测试类型视图
【缺省级别】
2:系统级
【参数】
无
【描述】
route-option bypass-route命令用来启动路由表旁路功能,探测直连目的地的连通情况。undo route-option bypass-route命令用来关闭路由表旁路功能。
缺省情况下,路由表旁路功能处于关闭状态。
需要注意的是,启动该功能后,将不进行路由查找,而直接将报文发送到直连网络的目的地。
【举例】
# 启动路由旁路功能。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-echo] route-option bypass-route
【命令】
source interface interface-type interface-number
undo source interface
【视图】
ICMP-echo测试类型视图
【缺省级别】
2:系统级
【参数】
interface-type interface-number:探测报文源接口的接口类型和接口编号。
【描述】
source interface命令用来配置将指定接口的IP地址作为ICMP-echo测试中探测请求报文的源IP地址。undo source interface命令用来取消已配置的接口地址作为ICMP-echo探测请求报文的源IP地址。
缺省情况下,未配置发送探测请求报文的源接口。
需要注意的是:
l 如果使用source ip命令配置了ICMP-echo测试的源IP地址,则source interface命令配置无效。
l 该命令指定的接口必须处于up状态,否则探测将会失败。
相关配置可参考命令source ip。
【举例】
l 路由应用
# 配置将接口Ethernet1/1的IP地址作为ICMP-echo探测请求报文的源IP地址。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-echo] source interface ethernet 1/1
l 交换应用
# 配置将VLAN接口2的IP地址作为ICMP-echo探测请求报文的源IP地址。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-echo] source interface vlan-interface 2
【命令】
source ip ip-address
undo source ip
【视图】
DLSw/FTP/HTTP/ICMP-echo/SNMP/TCP/UDP-echo/UDP-jitter测试类型视图
【缺省级别】
2:系统级
【参数】
ip-address:测试操作的源IP地址。
【描述】
source ip命令用来配置测试操作中探测请求报文的源IP地址。undo source ip命令用来取消已配置的源IP地址,即以报文发送接口的IP地址作为探测请求报文中的源IP地址。
缺省情况下,未指定源IP地址。
需要注意的是:
l 对于ICMP-echo测试类型,如果没有指定源IP地址,但是配置了source interface,则该源接口的IP地址将作为探测请求报文中的源IP地址。
l source ip命令指定的源IP地址必须是设备上接口的IP地址,且接口为up状态,否则测试将会失败。
相关配置可参考命令source interface。
【举例】
# 配置ICMP-echo探测请求报文中的源IP地址为10.1.1.1。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-echo] source ip 10.1.1.1
【命令】
source port port-number
undo source port
【视图】
SNMP/UDP-echo/UDP-jitter测试类型视图
【缺省级别】
2:系统级
【参数】
port-number:测试操作的源端口号,取值范围为1~50000。
【描述】
source port命令用来配置测试操作中探测请求报文中的源端口号。undo source port命令用来取消已配置的端口号。
缺省情况下,未指定源端口号。
【举例】
# 配置发送探测请求报文的源端口号为8000。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type udp-echo
[Sysname-nqa-admin-test-udp-echo] source port 8000
【命令】
type { dhcp | dlsw | ftp | http | icmp-echo | snmp | tcp | udp-echo | udp-jitter }
【视图】
NQA测试组视图
【缺省级别】
2:系统级
【参数】
dhcp:测试类型为DHCP。
dlsw:测试类型为DLSw。
ftp:测试类型为FTP。
http:测试类型为HTTP。
icmp-echo:测试类型为ICMP-echo。
snmp:测试类型为SNMP。
tcp:测试类型为TCP。
udp-echo:测试类型为UDP-echo。
udp-jitter:测试类型为UDP-jitter。
【描述】
type命令用来配置当前所在测试组的测试类型,并进入测试组测试类型视图。
缺省情况下,没有配置测试类型。
【举例】
# 配置测试组的测试类型为FTP测试。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type ftp
[Sysname-nqa-admin-test-ftp]
【命令】
tos value
undo tos
【视图】
DLSw/FTP/HTTP/ICMP-echo/SNMP/TCP/UDP-echo/UDP-jitter测试类型视图
【缺省级别】
2:系统级
【参数】
value:探测报文IP报文头中服务类型域的值,取值范围为0~255。
【描述】
tos命令用来配置NQA探测报文IP报文头中服务类型域的值。undo tos命令用来恢复缺省情况。
缺省情况下,NQA探测报文IP报文头中服务类型域的值为0。
【举例】
# 配置探测报文IP报文头中服务类型域的值为1。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-echo] tos 1
【命令】
ttl value
undo ttl
【视图】
DLSw/FTP/HTTP/ICMP-echo/SNMP/TCP/UDP-echo/UDP-jitter测试类型视图
【缺省级别】
2:系统级
【参数】
value:探测报文在网络中可以经过的最大跳数,取值范围1~255。
【描述】
ttl命令用来配置探测报文在网络中可以经过的最大跳数。undo ttl命令用来恢复缺省情况。
缺省情况下,探测报文在网络中可以经过的最大跳数为20跳。
需要注意的是,配置route-option bypass-route命令后,探测报文在网络中可以经过的最大跳数为1,ttl命令不会生效。
【举例】
# 配置探测报文在网络中可以经过的最大跳数为16跳。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-echo] ttl 16
【命令】
url url
undo url
【视图】
HTTP测试类型视图
【缺省级别】
2:系统级
【参数】
url:HTTP测试访问的网址,为1~185个字符的字符串,区分大小写。
【描述】
url命令用来配置HTTP测试访问的网址。undo url命令用来取消已配置的HTTP测试访问的网址。
需要注意的是,配置的网址字符串中不允许有空格。
【举例】
# 配置HTTP测试访问的网址为/index.htm。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type http
[Sysname-nqa-admin-test-http] url /index.htm
【命令】
username username
undo username
【视图】
FTP测试类型视图
【缺省级别】
2:系统级
【参数】
username:登录FTP服务器时所需的用户名,为1~32个字符的字符串,区分大小写。
【描述】
username命令用来配置登录FTP服务器时客户端需要输入的用户名。undo username命令用来取消已配置的用户名。
缺省情况下,未配置登录FTP服务器时客户端需要输入的用户名。
相关配置可参考命令password和operation。
【举例】
# 配置登录FTP服务器的用户名为administrator。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type ftp
[Sysname-nqa-admin-test-ftp] username administrator
【命令】
vpn-instance instance
undo vpn-instance
【视图】
ICMP-echo测试类型视图
【缺省级别】
2:系统级
【参数】
instance:VPN实例的名字,为1~31个字符的字符串,区分大小写。
【描述】
vpn-instance命令用来配置VPN实例信息。undo vpn-instance命令用来取消配置的VPN实例信息。
缺省情况下,未配置VPN实例信息。
配置VPN实例信息后,NQA将测试指定VPN隧道的连通情况。
对于S3610&S5510系列交换机,只有当工作在MCE模式下时才支持vpn-instance命令,有关交换机工作模式的介绍,请参见IP业务分册中的“双协议栈命令”。
【举例】
# 配置VPN实例信息为vpn1。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-echo] vpn-instance vpn1
只有在测试类型为UDP-jitter、TCP、UDP-echo时,才需要配置NQA服务器。
【命令】
display nqa server status
【视图】
任意视图
【缺省级别】
2:系统级
【参数】
无
【描述】
display nqa server status命令用来显示服务器的状态信息。
【举例】
# 显示服务器的状态信息。
<Sysname> display nqa server status
nqa server is: enabled
tcp-connect:
IP Address Port Status
2.2.2.2 2000 active
udp-echo:
IP Address Port Status
3.3.3.3 3000 inactive
表1-3 display nqa server status命令输出信息描述
字段 |
描述命令 |
tcp-connect |
NQA TCP测试中服务器的状态信息 |
udp-echo |
NQA UDP测试中服务器的状态信息 |
IP Address |
NQA服务器TCP/UDP监听服务的IP地址 |
Port |
NQA服务器TCP/UDP监听服务的端口号 |
Status |
监听服务的状态:active表示监听服务就绪;inactive表示监听服务未就绪 |
【命令】
nqa server enable
undo nqa server enable
【视图】
系统视图
【缺省级别】
2:系统级
【参数】
无
【描述】
nqa server enable命令用来开启NQA服务器功能。undo nqa server enable命令用来关闭NQA服务器功能。
缺省情况下,NQA服务器功能处于关闭状态。
相关配置可参考命令nqa server tcp-connect和nqa server udp-echo。
【举例】
# 开启NQA服务器功能。
<Sysname> system-view
[Sysname] nqa server enable
【命令】
nqa server tcp-connect ip-address port-number
undo nqa server tcp-connect ip-address port-number
【视图】
系统视图
【缺省级别】
2:系统级
【参数】
ip-address:NQA服务器TCP监听服务的IP地址。
port-number:NQA服务器TCP监听服务的端口号,取值范围为1~50000。
【描述】
nqa server tcp-connect命令用来在NQA服务器上创建TCP监听服务。undo nqa server tcp-connect命令用来删除已建立的TCP监听服务。
需要注意的是:
l 只有在测试类型为TCP时,才需在NQA服务器上配置此命令。
l 所配置的IP地址和端口号必须与NQA客户端的配置一致,且不能与已有的监听服务冲突。
l 所配置的IP地址必须是作为服务器的设备上接口的IP地址,否则配置无效。
相关配置可参考命令nqa server enable。
【举例】
# 创建IP地址为169.254.10.2,端口号为9000的TCP监听服务。
<Sysname> system-view
[Sysname] nqa server tcp-connect 169.254.10.2 9000
【命令】
nqa server udp-echo ip-address port-number
undo nqa server udp-echo ip-address port-number
【视图】
系统视图
【缺省级别】
2:系统级
【参数】
ip-address:NQA服务器UDP监听服务的IP地址。
port-number:NQA服务器UDP监听服务的端口号,取值范围为1~50000。
【描述】
nqa server udp-echo命令用来在NQA服务器上创建UDP监听服务。undo nqa server udp-echo命令用来删除已建立的UDP监听服务。
需要注意的是:
l 只有在测试类型为UDP-jitter或UDP-echo时,才需在NQA服务器上配置此命令。
l 配置的IP地址和端口号必须与NQA客户端的配置一致,且不能与已有的监听服务冲突。
l 所配置的IP地址必须是作为服务器的设备上接口的IP地址,否则配置无效。
相关配置可参考命令nqa server enable。
【举例】
# 创建IP地址为169.254.10.2、端口号为9000的UDP监听服务。
<Sysname> system-view
[Sysname] nqa server udp-echo 169.254.10.2 9000
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!