For a TCP test, one probe means one connection; for a Jitter test, the number of packets sent in one probe depends on the jitter-packetnum command; for an SNMP test, three packets are sent in one probe; for other types of tests, one packet is sent for one probe.

If the number of probes in a test is greater than 1, the system sends a second packet after it sends the first packet and receives a response packet. If the system does not receive a response packet, the system waits for the test timer to expire before sending a second test packet. The process is repeated until the specified probes are completed.

Example

# Configure the number of probes in a test to 10.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] count 10

1.1.2 datafill

Syntax

datafill text

undo datafill

View

NQA test group view

Parameter

text: String of fill characters of a test packet, in the range 1 to 200.

Description

Use the datafill command to configure a string of fill characters for a test packet.

Use the undo datafill command to restore the default.

By default, the fill string for ICMP test packets is the string corresponding to ASCII codes 00 to 09; starting from the second byte, the fill string for UDP test packets is the string corresponding to ASCII codes 00 to FF, with the first byte used for control.

The fill data of an NQA test packet can be any string of characters. If the test packet is smaller than the fill data, the system uses only the first part of the character string to encapsulate the packet. If the test packet is larger than the fill data, the system fills the character string cyclically to encapsulate the test packet until the packet is full. For example, when the fill data is “abcd” and the size of a test packet is “3”, “adc” is used to fill. When the test packet size is “6”, “abcdab” is used to fill.

Note that the datafill command is valid for an ICMP test and a UDP test.

Example

# Configure the string of fill characters of a test packet to “abcd”.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] datafill abcd

1.1.3 datasize

Syntax

datasize size

undo datasize

View

NQA test group view

Parameter

size: Size of a test packet in bytes, in the range of 1 to 8100.

Description

Use the datasize command to configure the size of a test packet, namely, an echo request packet (IP header and ICMP header excluded).

Use the undo datasize command to restore the size of a test request packet to the default value.

By default, the size of an ICMP test packet is 56 bytes and that of a UDP test packet is 100 bytes.

Note that:

l The datasize command is valid only for ICMP and UDP tests.

l For an ICMP test, if the value of the size argument is less than 20, the system automatically fills ICMP test packets to 20 bytes. If you configure a string of fill characters, the system fills this string in test packets. If you do not configure any string of fill characters, the system fills the default character string in test packets and what you can see is “.”.

l When you perform a UDP test, the size of test packets is subject to the configuration.

Example

# Configure the size of test packets to 50 bytes.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] datasize 50

1.1.4 description

Syntax

description text

undo description

View

NQA test group view

Parameter

text: Descriptive string of 1 to 200 characters for a test group.

Description

Use the description command to give a brief description of a test group, usually, the test type or test purpose of a test group.

Use the undo description command to remove the description information.

By default, no descriptive string is available to a test group.

Example

# Configure a descriptive string for a test group as “icmp-test”.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] description icmp-test

1.1.5 destination-ip

Syntax

destination-ip ip-address

undo destination-ip

View

NQA test group view

Parameter

ip-address: Destination IP address of a test request packet.

Description

Use the destination-ip command to configure a destination IP address for a test request packet.

Use the undo destination-ip command to remove the destination IP address.

By default, no destination IP address is configured for a test request packet.

Related command: destination-port.

Example

# Set the destination IP address of a test request packet to 10.1.1.1.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] destination-ip 10.1.1.1

1.1.6 destination-port

Syntax

destination-port port-number

undo destination-port

View

NQA test group view

Parameter

port-number: Destination port number of a test request packet, in the range of 1 to 65535.

Description

Use the destination-port command to configure a destination port number for a test request packet.

Use the undo destination-port command to remove the destination port number.

By default, no destination port number is configured for a test request packet.

Note that the destination-port command is valid only for jitter, TCP-Private, and UDP-Private tests.

Related command: destination-ip

& Note:

l The destination-port command is applicable to only jitter, TCP-Private, and UDP-Private tests.

l You are not recommended to perform a TCP, UDP, or jitter test on a known port(1 to 1023). Otherwise, the NQA test will fail or the corresponding services of this port will be unavailable.

Example

# Set the destination port number of a test request packet to 9000.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] destination-port 9000

1.1.7 display nqa

Syntax

display nqa { results | history | jitter } [ admin-name operation-tag ]

View

Any view

Parameter

results: Displays the results of the last test.

history: Displays the history records of tests.

jitter: Displays the recorded delay jitter of UDP packet transmission in the last NQA jitter test.

admin-name: Name of the administrator who creates NQA test groups, a string of 1 to 32 characters.

operation-tag: Operation tag, a string of 1 to 32 characters.

Description

Use the display nqa to display results of an NQA test or tests.

If neither of the test group arguments (admin-name and operation-tag) is specified, results of all test groups are displayed. Otherwise, results of only the specified test group(s) are displayed.

Related command: test-enable.

Example

# Display the results of the last test.

<Sysname> display nqa results administrator icmp

NQA entry(admin administrator, tag icmp) test result:

Destination ip address: 169.254.10.2.1.1.1

Send operation times: 1 Receive response times: 0

Min/Max/Average Round Trip Time: 0/0/0

Square-Sum of Round Trip Time: 0

Last succeeded test time: 0-00-00 00:00:00.0

Extend result:

Packet lost in test: 100%

Failures due to Timeout: 0

Failures due to System Busy: 0

Failures due to Disconnect: 0

Failures due to No Connection: 0

Failures due to Sequence Error: 0

Failures due to Internal Error: 1

Failures due to Other Errors: 0

Table 1-1 Description on fields of the display nqa results command

Field	Description
Destination ip address	IP address of the destination
Send operation times	Number of sent probe packets
Receive responds times	Number of received response packets
Min/Max/Average Round Trip Time	Minimum/maximum/average roundtrip time
Square-Sum of Round Trip Time	Square sum of roundtrip time
Last succeeded test time	Completion time of the last successful test
SD Maximal delay	Maximum delay from the source to the destination
DS Maximal delay	Maximum delay from the destination to the source
Packet lost in test	Average packet loss ratio
Disconnect operation number	Number of disconnections by the peer
Failures due to Timeout	Number of time-out occurrences in a test
Failures due to System Busy	Number of test failures owing to the system being busy
Failures due to Disconnect	Number of disconnections by the peer
Failures due to No Connection	Number of failures to connect with the peer
Failures due to Sequence Error	Number of failures owing to out-of-sequence packets
Failures due to Internal Error	Number of failures owing to internal errors
Failures due to Other Errors	Number of failures owing to other errors

#: Display the history records of tests.

<Sysname> display nqa history administrator test

NQA entry(admin administrator, tag test) history record:

Index Response Status LastRC Time

1 1 1 0 2004-11-25 16:28:55.0

2 1 1 0 2004-11-25 16:28:55.0

3 1 1 0 2004-11-25 16:28:55.0

4 1 1 0 2004-11-25 16:28:55.0

5 1 1 0 2004-11-25 16:28:55.0

6 2 1 0 2004-11-25 16:28:55.0

7 1 1 0 2004-11-25 16:28:55.0

8 1 1 0 2004-11-25 16:28:55.0

9 1 1 0 2004-11-25 16:28:55.9

10 1 1 0 2004-11-25 16:28:55.9

Table 1-2 Description on fields of the display nqa history command

Field	Description
Index	History record number
Response	Roundtrip delay of a test packet in the case of a successful test, time-out time in the case of time-out, or 0 in the case of a test failure (in seconds)
Status	Status value of test results, including: 1: responseReceived 2: unknown 3: internalError 4: requestTimedOut 5: unknownDestinationAddress 6: noRouteToTarget 7: interfaceInactiveToTarget 8: arpFailure 9: maxConcurrentLimitReached 10: unableToResolveDnsName 11: invalidHostAddress
LastRC	Temporarily, this field is not supported.
Time	Time when the test is completed

# Display the recorded delay jitter of UDP packet transmission in the last NQA jitter test.

<Sysname> display nqa jitter admin jitter

NQA entry(admin admin, tag jitter) test jitter result:

RTT Number: 10

SD Maximal delay: 2 DS Maximal delay: 2

Min Positive SD: 1 Min Positive DS: 1

Max Positive SD: 1 Max Positive DS: 1

Positive SD Number: 4 Positive DS Number: 2

Positive SD Sum: 4 Positive DS Sum: 2

Positive SD average: 1 Positive DS average: 1

Positive SD Square Sum: 4 Positive DS Square Sum: 2

Min Negative SD: 1 Min Negative DS: 1

Max Negative SD: 2 Max Negative DS: 1

Negative SD Number: 2 Negative DS Number: 3

Negative SD Sum: 3 Negative DS Sum: 3

Negative SD average: 2 Negative DS average: 1

Negative SD Square Sum: 5 Negative DS Square Sum: 3

SD lost packets number: 0 DS lost packet number: 0

Unknown result lost packet number: 0

Table 1-3 Description on fields of the display nqa jitter command

Field	Description
RTT Number	Number of received response packets
SD Maximal delay	Maximum delay from the source to the destination
DS Maximal delay	Maximum delay from the destination to the source
Min Positive SD	Minimum positive jitter delay from the source to the destination
Min Positive DS	Minimum positive jitter delay from the destination to the source
Max Positive SD	Maximum positive jitter delay from the source to the destination
Max Positive DS	Maximum positive jitter delay from the destination to the source
Positive SD Number	Number of positive jitter delays from the source to the destination
Positive DS Number	Number of positive jitter delays from the destination to the source
Positive SD Sum	Sum of positive jitter delays from the source to the destination
Positive DS Sum	Sum of positive jitter delays from the destination to the source
Positive SD average	Average of positive jitter delays from the source to the destination
Positive DS average	Average of positive jitter delays from the destination to the source
Positive SD Square Sum	Sum of the square of positive jitter delays from the source to the destination
Positive DS Square Sum	Sum of the square of positive jitter delays from the destination to the source
Min Negative SD	Minimum absolute value of negative jitter delays from the source to the destination
Min Negative DS	Minimum absolute value of negative jitter delays from the destination to the source
Max Negative SD	Maximum absolute value of negative jitter delays from the source to the destination
Max Negative DS	Maximum absolute value of negative jitter delays from the destination to the source
Negative SD Number	Number of negative jitter delays from the source to the destination
Negative DS Number	Number of negative jitter delays from the destination to the source
Negative SD Sum	Sum of absolute values of negative jitter delays from the source to the destination
Negative DS Sum	Sum of absolute values of negative jitter delays from the destination to the source
Negative SD average	Average of negative jitter delays from the source to the destination
Negative DS average	Average of negative jitter delays from the destination to the source
Negative SD Square Sum	Sum of the square of negative jitter delays from the source to the destination
Negative DS Square Sum	Sum of the square of negative jitter delays from the destination to the source
SD lost packets number	Number of lost packets from the source to the destination
DS lost packet number	Number of lost packets from the destination to the source
Unknown result lost packet number	Number of lost packets for unknown reasons

1.1.8 filename

Syntax

filename file-name

undo filename

View

NQA test group view

Parameter

file-name: Name of the file transferred between the FTP server and the FTP client, a string of 1 to 200 characters.

Description

Use the filename command to specify a file to be transferred between the FPT server and the FTP client.

Use the undo filename command to cancel the file.

By default, no file is specified.

Note that the filename command is valid only for the FTP test.

Related command: username, password, and ftp-operation.

Example

# Specify the config.txt file to be transferred between the FTP server and the FTP client.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] filename config.txt

1.1.9 frequency

Syntax

frequency interval

undo frequency

View

NQA test group view

Parameter

interval: Interval of performing a cyclic test in seconds, in the range of 1 to 65535.

Description

Use the frequency command to configure the interval of performing a cyclic test. After you carry out the test-enable command to start an NQA test, the test will be performed at intervals.

Use the undo frequency to restore the default.

By default, no cyclic test is performed.

Note that the frequency command is invalid for the DHCP test.

Related command: test-enable.

Example

# Configure the interval of performing a cyclic test to 10 seconds.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] frequency 10

1.1.10 ftp-operation

Syntax

ftp-operation { get | put }

undo ftp-operation

View

NQA test group view

Parameter

get: Obtains a file from the FTP server.

put: Transfers a file to the FTP server.

Description

Use the ftp-operation command to configure the FTP operation type.

Use the undo ftp-operation command to restore the default FTP operation type.

By default, the FTP operation type is “get” (obtain a file from the FTP server).

Note that the ftp-operation command is valid only for FTP tests.

Related command: username and password.

Example

# Obtain a file from the FTP server.

[Sysname-nqa-administrator-test] ftp-operation get

1.1.11 history-records

Syntax

history-records number

undo history-records

View

NQA test group view

Parameter

number: Maximum number of history records that can be saved in a test group, in the range of 0 to 50..

Description

Use the history-records command to configure the maximum number of history records that can be saved in a test group.

Use the undo history-records command to restore the default.

By default, the maximum number of records that can be saved in a test group is 50.

If the history records exceed the predefined maximum number, the first test result will be discarded.

Example

# Configure the maximum number of history records that can be saved in a test group to 10

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] history-records 10

1.1.12 http-operation

Syntax

http-operation { get | post }

undo http-operation

View

NQA test group view

Parameter

get: Obtains data from the HTTP server.

post: Transfers data to the HTTP server.

Description

Use the http-operation command to configure the HTTP operation type.

Use the undo http-operation command to restore the default HTTP operation type.

By default, the HTTP operation type is “get” (obtain data from the HTTP server).

Note that the http-operation command is valid only for HTTP tests.

Related command: http-string.

Example

# Obtain data from the HTTP server.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] http-operation get

1.1.13 http-string

Syntax

http-string string version

undo http-string

View

NQA test group view

Parameter

string: HTTP operation string, which specifies a webpage to be accessed. The length of the string argument plus that of the version argument cannot exceed 200 characters.

version: HTTP version. Currently, it can only be “HTTP/1.0”, where HTTP must be upper-case.

Description

Use the http-string command to configure an HTTP operation string and version information.

Use the undo http-string command to remove the configuration of the HTTP operation string and version information.

By default, no HTTP operation string or version information is configured.

Note that the http-string command is valid only for HTTP tests.

Related command: http-operation.

Example

# Set the web page accessible via HTTP to /index.htm and the HTTP version to http/1.0.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] http-string /index.htm HTTP/1.0

1.1.14 jitter-interval

Syntax

jitter-interval interval

undo jitter-interval

View

NQA test group view

Parameter

interval: Interval for sending jitter test packets in milliseconds, in the range of 10 to 1,000.

Description

Use the jitter-interval command to configure the interval of sending jitter test packets.

Use the undo jitter-interval command to restore the default.

By default, the interval for sending jitter test packets is 20 milliseconds.

Note that the jitter-interval command is valid only for the jitter test.

Related command: jitter-packetnum.

Example

# Set the interval of sending jitter test packets to 30 milliseconds.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] jitter-interval 30

1.1.15 jitter-packetnum

Syntax

jitter-packetnum number

undo jitter-packetnum

View

NQA test group view

Parameter

number: Number of test packets sent in a probe, in the range of 10 to 100.

Description

Use the jitter-packetnum command to configure the number of jitter test packets sent in a probe.

Use the undo jitter-packetnum command to restore the default.

By default, the number of test packets sent in a probe is 10.

Note that the jitter-packetnum command is valid only for the jitter test.

Related command: jitter-interval.

Example

# Set the number of packets sent in a probe to 30.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] jitter-packetnum 30

1.1.16 nqa

Syntax

nqa admin-name operation-tag

undo nqa admin-name operation-tag

View

System view

Parameter

admin-name: Name of the administrator who creates NQA test groups, a string of 1 to 32 characters.

operation-tag: Tag of a test operation, a string of 1 to 32 characters.

Description

Use the nqa command to create an NQA test group and enter NQA test group view. If the test group already exists, you will directly enter NQA test group view when you carry out the nqa command.

Use the undo nqa command to delete the test group.

Example

# Create an NQA test group whose administrator name is “administrator” and whose operation tag is “test” and enter NQA test group view.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test]

1.1.17 nqa-agent enable

Syntax

nqa-agent enable

undo nqa-agent enable

View

System view

Parameter

None

Description

Use the nqa-agent enable command to enable the NQA client.

Use the undo nqa-agent enable command to disable the NQA client.

By default, the NQA client is disabled.

Note that you can perform tests only after the NQA client is enabled.

Related command: nqa-server enable.

Example

# Enable the NQA client.

<Sysname> system-view

[Sysname] nqa-agent enable

1.1.18 nqa-agent max-requests

Syntax

nqa-agent max-requests max-number

undo nqa-agent max-requests

View

System view

Parameter

max-number: Maximum number of tests that the NQA client can simultaneously perform, in the range 1 to 5.

Description

Use the nqa-agent max-requests command to configure the maximum number of tests that the NQA client can simultaneously perform.

Use the undo nqa-agent max-requests command to restore the default.

By default, the maximum number of tests that the NQA client can simultaneously perform is five.

Example

# Specify the NQA client to simultaneously perform four tests at most.

<Sysname> system-view

[Sysname] nqa-agent max-requests 4

1.1.19 password

Syntax

password password

undo password

View

NQA test group view

Parameter

password: Password used to log in to the FTP server, a string of 1 to 32 characters.

Description

Use the password command to configure a password used to log in to the FTP server.

Use the undo password command to remove the password.

By default, no password is configured.

Note that the password command is valid only for the FTP test.

Related command: username and ftp-operation.

Example

# Set the login password to nqa.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] test-type ftp

[Sysname-nqa-administrator-test] username aaa

[Sysname-nqa-administrator-test] password nqa

1.1.20 probe-failtimes

Syntax

probe-failtimes times

undo probe-failtimes

View

NQA test group view

Parameter

times: Number of consecutive probe failures in a test, in the range of 1 to 15.

Description

Use the probe-failtimes command to configure the number of consecutive probe failures in an NQA test before a trap message is sent to the network management server to indicate a probe failure.

Use the undo probe-failtimes command to restore the default.

By default, a Trap message is sent to the network management (NM) server once a probe fails in an NQA test.

& Note:

One test may involve multiple probes.

Example

# Configure the system to send a Trap message after three consecutive probe failures in an NQA test.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] probe-failtimes 3

1.1.21 sendpacket passroute

Syntax

sendpacket passroute

undo sendpacket passroute

View

NQA test group view

Parameter

None

Description

Use the sendpacket passroute command to enable the routing table bypass function to test the direct connectivity to the destination.

Use the undo sendpacket passroute command to disable the routing table bypass function.

By default, the routing table bypass function is disabled.

After this function is enabled, the routing table is not searched, and the packet is directly sent to the destination in a directly connected network. If the destination is not in the directly connected network, an error will be prompted.

Note that the sendpacket passroute command is invalid for DHCP tests.

Example

# Enable the routing table bypass function.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] sendpacket passroute

1.1.22 send-trap

Syntax

send-trap { all | { probefailure | testcomplete | testfailure }* }

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

View

NQA test group view

Parameter

probefailure: Sends a Trap message when a probe fails.

probecomplete: Sends a Trap message when a test is completed.

testfailure: Sends a Trap message when a test fails (the number of probe failures in a test is greater than or equal to the number configured by the test-failtimes command). For a test, only one trap message is sent.

all: Sends a Trap message in any of the above cases.

Description

Use the send-trap command to enable the Trap debugging (A Trap message is sent to the network management server).

Use the undo send-trap command to disable the Trap debugging (No Trap message is sent to the network management server).

By default, no trap message is sent to the network management server.

Example

# Send a Trap message when a test is completed.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] send-trap testcomplete

1.1.23 source-interface

Syntax

source-interface interface-type interface-number

undo source-interface

View

NQA test group view

Parameter

interface-type interface-number: Specifies the interface by its type and number.

Description

Use the source-interface command to specify the IP address of an interface as the source IP address of ICMP test request packets or specify an interface for a DHCP test.

Use the undo source-interface command to remove the configuration.

By default, no interface address is specified as the source IP address of ICMP test request packets, or no interface is specified for a DHCP test.

Note that:

l For the DHCP test, the source-interface command is required, for the ICMP test, it is optional, and for other tests, it is invalid.

l For an ICMP test, if a source IP address is configured by using the source-ip command, the configuration by using the source-interface command is invalid.

l The interface specified by the source-interface command can only be a layer 3 Ethernet interface or VLAN interface.

l The interface specified by the command must be up. Otherwise, the test will fail.

Example

# Specify Vlan-interface 3 for a DHCP test.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] source-interface Vlan-interface 3

1.1.24 source-ip

Syntax

source-ip ip-address

undo source-ip

View

NQA test group view

Parameter

ip-address: Source IP address of a test request packet.

Description

Use the source-ip command to configure a source IP address for a test request packet.

Use the undo source-ip command to remove the configured source address. That is, the IP address of the interface sending a test request packet serves as the source IP address of the test request packet.

By default, no source IP address is specified. If a source interface is specified, the IP address of the source interface serves as the source IP address of a test request packet.

Note that:

l For the FTP test, the source-ip command is required, for the DHCP test, it is invalid, and for other tests, it is optional.

l The source IP address in the command must be the IP address of an interface on the device and the interface must be up. Otherwise, the test will fail.

Example

# Configure the source IP address of a test request packet to 10.1.1.1.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] source-ip 10.1.1.1

1.1.25 source-port

Syntax

source-port port-number

undo source-port

View

NQA test group view

Parameter

port-number: Source port number for a test request packet, in the range of 1 to 50000.

Description

Use the source-port command to configure a source port number for a test request packet.

Use the undo source-port command to remove the configured port number.

By default, no source port number is specified.

Note that this command is only valid for jitter, UDP, and SNMP tests.

Example

# Configure the source port number of a test request packet to 8000.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] source-port 8000

1.1.26 test-enable

Syntax

test-enable

undo test-enable

View

NQA test group view

Parameter

None

Description

Use the test-enable command to enable the NQA test.

Use the undo test-enable command to disable the NQA test.

Test results will not be displayed after you enable the NQA test. In this case, you need to carry out the display nqa command to display the test results.

Related command: display nqa.

Example

# Enable the NQA test.

<Sysname> system-view

[Sysname] nqa-agent enable

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] test-enable

1.1.27 test-failtimes

Syntax

test-failtimes times

undo test-failtimes

View

NQA test group view

Parameter

times: Minimum number of probe failures in a test before a Trap message is sent to indicate a test failure, in the range of 1 to 15.

Description

Use the test-failtimes command to configure the minimum number of probe failures in a test before a Trap message is sent to the network management server to indicate a test failure.

Use the undo test-failtimes command to restore the default.

By default, a Trap message is sent to the NM server once a probe fails in a test.

& Note:

One test may involve multiple probes.

Example

# Configure the system to send a Trap message to indicate a test failure after three probe failures in an NQA test

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] test-failtimes 3

1.1.28 test-type

Syntax

test-type test-type

undo test-type

View

NQA test group view

Parameter

test-type: Type of a test, including the following keywords:

l dhcp: DHCP test

l dlsw: DLSw test

l ftp: FTP test

l http: HTTP test

l icmp: ICMP test

l jitter: Analyzes and tests the delay jitter of UDP packet transmission

l snmpquery: SNMP test

l tcpprivate: Tests the TCP connection to a specified port.

l tcppublic: Tests the TCP connection to port 7.

l udpprivate: Tests the UDP connection to a specified port.

l tcppublic: Tests the UDP connection to port 7.

Description

Use the test-type command to configure the test type.

Use the undo test-type command to restore the default.

By default, the test type is ICMP.

Example

# Set the test type to FTP.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] test-type ftp

1.1.29 timeout

Syntax

timeout time

undo timeout

View

NQA test group view

Parameter

time: Probe time-out time in seconds, in the range of 1 to 60.

Description

Use the timeout command to configure the probe time-out time. If no response packet is received within the time-out time of a request packet, the probe fails.

Use the undo timeout command to restore the default.

By default, the probe time-out time is three seconds.

Example

# Configure the probe time-out time to 10 seconds.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] timeout 10

1.1.30 tos

Syntax

tos value

undo tos

View

NQA test group view

Parameter

value: Value of the ToS field in the IP header in an NQA test packet header, in the range of 0 to 15.

Description

Use the tos command to configure the value of the ToS field in the IP header in an NQA test packet.

Use the undo tos command to restore the default.

By default, the ToS field in the IP header of an NQA test packet is 0.

Note that the tos command is invalid for DHCP tests.

Example

# Set the ToS field in a IP packet header in an NQA test packet to 1.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] tos 1

1.1.31 ttl

Syntax

ttl number

undo ttl

View

NQA test group view

Parameter

number: Maximum number of hops a test request packet traverses in the network, in the range of 1 to 255.

Description

Use the ttl command to configure the maximum number of hops a test request packet traverses in the network.

Use the undo ttl command to restore the maximum number of hops to the default.

By default, the maximum number of hops that a test request packet can traverse in a network is 20.

& Note:

l The ttl command is invalid for the DHCP test.

l After you configure the sendpacket passroute command, the maximum number of hops a test request packet traverses in the network is 1.

Example

# Configure the maximum number of hops a test request packet traverses in the network to 16.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] ttl 16

1.1.32 username

Syntax

username name

undo username

View

NQA test group view

Parameter

name: Username used to log in to the FTP server, a string of 1 to 32 characters.

Description

Use the username command to configure a username used to log in to the FTP server.

Use the undo username command to remove the configured username.

By default, no username is configured.

Note that the username command is valid only for FTP tests.

Related command: password and ftp-operation.

Example

# Set the login username to administrator.

<Sysname> system-view

[Sysname] nqa administrator test

[Sysname-nqa-administrator-test] test-type ftp

[Sysname-nqa-administrator-test] username administrator

1.2 NQA Server Commands

& Note:

l You only need to configure the NQA server for jitter, TCP, and UDP tests.

l You are not recommended to configure NQA server for jitter, TCP, or UDP tests on a well-known port because this may cause the NQA test to fail or the service provided by the well-known port being unavailable.

1.2.1 nqa-server enable

Syntax

nqa-server enable

undo nqa-server enable

View

System view

Parameter

None

Description

Use the nqa-server enable command to enable the NQA server.

Use the undo nqa-server enable command to disable the NQA server.

By default, the NQA server is disabled.

Related command: nqa-agent enable, nqa-server tcpconnect, and nqa-server udpecho.

Example

# Enable the NQA server.

<Sysname> system-view

[Sysname] nqa-server enable

1.2.2 nqa-server tcpconnect

Syntax

nqa-server tcpconnect ip-address port-number

undo nqa-server tcpconnect ip-address port-number

View

System view

Parameter

ip-address: IP address specified for the TCP listening service on the NQA server.

port-number: Port number specified for the TCP listening service on the NQA server, in the range of 1 to 50000. For the TCP-Public test, the port number must be 7.

Description

Use the nqa-server tcpconnect command to create a TCP listening service on the NQA server.

Use the undo nqa-server tcpconnect command to remove the TCP listening service from the NQA server.

Note that:

l You need to configure the nqa-server tcpconnect command on the NQA server only for the TCP-Private and TCP-Public tests.

l The IP address and port number must be consistent with those on the NQA client and must be different from those for an existing listening service.

l The IP address must be that of an interface on the NQA server and must not be 0.0.0.0. Otherwise, the configuration will be invalid.

Related command: nqa-server enable.

Example

# Create a TCP listening service by using the IP address 169.254.10.2 and port 9000.

<Sysname> system-view

[Sysname] nqa-server tcpconnect 169.254.10.2 9000

1.2.3 nqa-server udpecho

Syntax

nqa-server udpecho ip-address port-number

undo nqa-server udpecho ip-address port-number

View

System view

Parameter

ip-address: IP address specified for the UDP listening service on the NQA server.

port-number: Port number specified for the UDP listening service on the NQA server, in the range of 1 to 50000. For the UDP-Public test, the port number must be 7.

Description

Use the nqa-server udpecho command to create a UDP listening service on the NQA server.

Use the undo nqa-server udpecho command to remove the UDP connection.

Note that:

l You need to configure the nqa-server udpecho command on the NQA server only for the jitter, UDP-Private, and UDP-Public tests.

l The IP address and port number must be consistent with those of the NQA client and must be different from those of an existing listening service.

l The IP address must be that of an interface on the NQA server and must not be 0.0.0.0. Otherwise, the configuration will be invalid.

Related command: nqa-server enable.

Example

# Create a UDP listening service by using the IP address 169.254.10.2 and port 9000.

<Sysname> system-view

[Sysname] nqa-server udpecho 169.254.10.2 9000

H3C S5500-SI Series Ethernet Switches Command Manual-Release 1205-(V1.03)

1.1.5 destination-ip

1.1.6 destination-port

1.1.7 display nqa

1.1.10 ftp-operation

1.1.12 http-operation

1.1.13 http-string

1.1.17 nqa-agent enable

1.1.19 password

1.1.23 source-interface

1.1.26 test-enable

1.1.32 username

1.2 NQA Server Commands

1.2.1 nqa-server enable

1.2.2 nqa-server tcpconnect

1.2.3 nqa-server udpecho

Cloud & AI

InterConnect

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Contact Us