The term switch in this document refers to a switch in a generic sense or an access controller configured with the switching function unless otherwise specified.

NQA Client Configuration Commands

data-fill

Syntax

data-fill string

undo data-fill

View

ICMP-echo, UDP-echo, UDP-jitter test type view

Parameters

string: String used to fill a probe packet, in the range 1 to 200. It is case sensitive.

Description

Use the data-fill command to configure the string used to fill a probe packet.

Use the undo data-fill command to restore the default.

By default, the string used to fill a probe packet is the string corresponding to the ASCII code 00 to 09.

l If the probe packet is smaller than the fill data, the system uses only the first part of the character string to encapsulate the packet.

l If the probe packet is larger than the fill data, the system fills the character string cyclically to encapsulate the packet until it is full.

For example, when the fill data is abcd and the size of a probe packet is 3 byte, abc is used to fill the packet. When the probe size is 6 byte, abcdab is used to fill the packet.

l Because the first five bytes of a probe packet in a UDP-echo test have some specific usage, the configured character string is used to fill the remaining bytes in the probe packet.

l Because the first 68 bytes of a probe packet in UDP-jitter test have some specific usage, the configured character string is used to fill the remaining bytes in the probe packet.

Examples

# Configure the string used to fill an ICMP-echo probe packet as 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

Syntax

data-size size

undo data-size

View

ICMP-echo, UDP-echo, UDP-jitter test type view

Parameters

size: Size of a probe packet in bytes, in the range 20 to 8100 for an ICMP-echo or a UDP-echo test and in the range 68 to 8100 for a UDP-jitter test.

Description

Use the data-size command to configure the size of a probe packet sent, namely, the size of a packet sent (IP header, ICMP header and UDP header excluded) in a probe.

Use the undo data-size command to restore the default.

By default, the size of a probe packet is 100 bytes.

Examples

# Configure the size of an ICMP-echo probe packet as 80 bytes.

<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

Syntax

description string

undo description

View

Any NQA test type view

Parameters

string: Descriptive string of a test group, in the range 1 to 200. It is case sensitive.

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 configured description information.

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

Examples

# Configure the descriptive string for a test group as 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

Syntax

destination ip ip-address

undo destination ip

View

DLSw, FTP, HTTP, ICMP-echo, SNMP, TCP, UDP-echo, UDP-jitter test type view

Parameters

ip-address: Destination IP address of a test operation.

Description

Use the destination ip command to configure a destination IP address for a test operation.

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

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

Examples

# Configure the destination IP address of an ICMP-echo test operation as 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

Syntax

destination port port-number

undo destination port

View

TCP, UDP-echo, UDP-jitter test type view

Parameters

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

Description

Use the destination port command to configure a destination port number for a test operation.

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

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

Note that you are not recommended to perform a TCP, UDP-echo, or UDP-jitter test on ports from 1 to 1023 (known ports). Otherwise, the NQA test will fail or the corresponding services of this port will be unavailable.

Examples

# Configure the destination port number of a test operation as 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

Syntax

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

View

Any view

Parameters

result: Displays the results of the last test.

history: Displays the history records of a test.

admin-name: Specifies the name of the administrator who creates NQA operations, a string of 1 to 32 characters. It is case-insensitive.

operation-tag: Specifies the test operation tag, a string of 1 to 32 characters. It is case-insensitive.

Description

Use the display nqa command to display operation information of an NQA test or tests.

If neither of the test group arguments (admin-name and operation-tag) is specified, information of all test groups is displayed.

Examples

# Display the results of the last test.

<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

Table 1-1 display nqa result command output description

Field	Description
Destination IP address	IP address of the destination
Send operation times	Number of probe packets sent
Receive response times	Number of response packets received
Min/Max/Average round trip time	Minimum/maximum/average roundtrip time
Square-Sum of round trip time	Square sum of roundtrip time
Last succeeded probe time	Time of the last successful probe in a test
Packet lost in test	Average packet loss ratio
Failures due to timeout	Number of timeout occurrences in a test
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	Failures due to other errors
UDP-jitter results	UDP-jitter test results, available only in UDP-jitter tests.
RTT number	Number of response packets received
SD max delay	Maximum delay from the source to the destination
DS max 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 absolute value of negative jitter delays from the source to the destination
Negative DS average	Average absolute value 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 packet(s)	Number of lost packets from the source to the destination
DS lost packet(s)	Number of lost packets from the destination to the source
Lost packet(s) for unknown reason	Number of lost packets for unknown reasons

# Display the history records of tests.

<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

Table 1-2 display nqa history command output description

Field	Description
Index	History record number
Response	Roundtrip delay of a test packet in the case of a successful test, timeout time in the case of timeout, or 0 in the case that a test cannot be completed (in milliseconds)
Status	Status value of test results, including: l Succeeded l Unknown error l Internal error l Timeout
Time	Time when the test is completed

filename

Syntax

filename filename

undo filename

View

FTP test type view

Parameters

filename: Name of the file transferred between the FTP server and the FTP client, a string of 1 to 200 characters. It is case sensitive.

Description

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

Use the undo filename command to restore the default.

By default, no file is specified.

Examples

# Specify the file to be transferred between the FTP server and the FTP client as 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

Syntax

frequency interval

undo frequency

View

Any NQA test type view

Parameters

interval: Interval between two consecutive tests, in milliseconds, in the range 0 to 604800000. If the interval is 0, it indicates that only one test is performed.

Description

Use the frequency command to configure the interval between two consecutive tests for a test group.

Use the undo frequency command to restore the default.

By default, the interval between two consecutive tests for a test group is 0 milliseconds, that is, only one test is performed.

After you use the nqa schedule command to start an NQA test, one test is started at interval.

If the last test is not completed when the interval specified by the frequency command is reached, a new test is not started.

Examples

# Configure the interval between two consecutive tests as 1000 milliseconds.

<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

Syntax

history-records number

undo history-records

View

Any NQA test type view

Parameters

number: Maximum number of history records that can be saved in a test group, in the range 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 number of history records exceeds the maximum number, the earliest history record for a probe will be discarded.

Examples

# Configure the maximum number of history records that can be saved in a test group as 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

Syntax

http-version v1.0

undo http-version

View

HTTP test type view

Parameters

v1.0: The HTTP version is 1.0 in an HTTP test.

Description

Use the http-version command to configure the HTTP version used in an HTTP test.

Use the undo http-version command to restore the default.

By default, HTTP 1.0 is used in an HTTP test.

Examples

# Configure the HTTP version as 1.0 in an HTTP test.

<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

Syntax

next-hop ip-address

undo next-hop

View

ICMP-echo test type view

Parameters

ip-address: IP address of the next hop.

Description

Use the next-hop command to configure the next hop IP address for an IP packet.

Use the undo next-hop command to remove the configured next hop IP address.

By default, no next hop IP address is configured.

Examples

# Configure the next hop IP address as 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

Syntax

nqa entry admin-name operation-tag

undo nqa { all | entry admin-name operation-tag }

View

System view

Parameters

admin-name: Specifies the name of the administrator who creates the NQA test operation, a string of 1 to 32 characters, with “-” excluded. It is case-insensitive.

operation-tag: Specifies the tag of a test operation, a string of 1 to 32 characters, with “-” excluded. It is case-insensitive.

all: All NQA test groups.

Description

Use the nqa command to create an NQA test group and enter NQA test group view.

Use the undo nqa command to remove the test group.

Note that if the test type has been configured for the test group, you will directly enter NQA test type view when you execute the nqa command.

Examples

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

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test]

nqa agent enable

Syntax

nqa agent enable

undo nqa agent enable

View

System view

Parameters

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 and stop all the tests being performed.

By default, the NQA client is enabled.

Related commands: nqa server enable.

Examples

# Enable the NQA client.

<Sysname> system-view

[Sysname] nqa agent enable

nqa agent max-concurrent

Syntax

nqa agent max-concurrent number

undo nqa agent max-concurrent

View

System view

Parameters

number: Maximum number of the tests that the NQA client can simultaneously perform, in the range 1 to 5. The default value is 2.

Description

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

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

The default settings for this command vary with device models.

From the beginning to the end of a test, the NQA test is in the test status; from the end of a test to the beginning of the next test, the NQA test is in the waiting status.

Examples

# Configure the maximum number of the tests that the NQA client can simultaneously perform as 5.

<Sysname> system-view

[Sysname] nqa agent max-concurrent 5

nqa schedule

Syntax

nqa schedule admin-name operation-tag start-time now lifetime forever

undo nqa schedule admin-name operation-tag

View

System view

Parameters

admin-name: Specifies the name of the administrator who creates the NQA test operation, a string of 1 to 32 characters. It is case-insensitive.

operation-tag: Specifies the test operation tag, a string of 1 to 32 characters. It is case-insensitive.

now: Specifies to start the test for a test group immediately.

forever: Specifies that the test is performed for a test group forever.

Description

Use the nqa schedule command to configure the test start time and test period for a test group.

Use the undo nqa schedule command to stop the test for the test group.

Note that it is not allowed to enter test group view or test type view after a test group is scheduled.

Examples

# Start a test for the test group with the administrator name admin and operation tag test.

<Sysname> system-view

[Sysname] nqa schedule admin test start-time now lifetime forever

operation (FTP test type view)

Syntax

operation { get | put }

undo operation

View

FTP test type view

Parameters

get: Obtains a file from the FTP server.

put: Transfers a file to the FTP server.

Description

Use the operation command to configure the FTP operation type.

Use the undo operation command to restore the default.

By default, the FTP operation type is get.

Examples

# Configure the FTP operation type as put.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type ftp

[Sysname-nqa-admin-test-ftp] operation put

operation (HTTP test type view)

Syntax

operation { get | post }

undo operation

View

HTTP test type view

Parameters

get: Obtains data from the HTTP server.

post: Transfers data to the HTTP server.

Description

Use the operation command to configure the HTTP operation type.

Use the undo operation command to restore the default.

By default, the HTTP operation type is get.

Examples

# Configure the HTTP operation type as post.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type http

[Sysname-nqa-admin-test-http] operation post

operation interface

Syntax

operation interface interface-type interface-number

undo operation interface

View

DHCP test type view

Parameters

interface-type interface-number: Type and number of the interface that is performing a DHCP test.

Description

Use the operation interface command to specify the interface to perform a DHCP test.

Use the undo operation interface command to restore the default.

By default, no interface is specified to perform a DHCP test.

Note that the specified interface must be up; otherwise, the test will fail.

Examples

l On an Ethernet interface

# Specify the interface to perform a DHCP test as Ethernet 1/0.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type dhcp

[Sysname-nqa-admin-test-dhcp] operation interface ethernet 1/0

l On a VLAN interface

# Specify the interface to perform a DHCP test as VLAN-interface 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

Syntax

password password

undo password

View

FTP test type view

Parameters

password: Password used to log onto the FTP server, a string of 1 to 32 characters. It is case sensitive.

Description

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

Use the undo password command to remove the configured password.

By default, no password is configured for logging onto the FTP server.

Related commands: username, operation.

Examples

# Configure the password used for logging onto the FTP server as ftpuser.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type ftp

[Sysname-nqa-admin-test-ftp] password ftpuser

probe count

Syntax

probe count times

undo probe count

View

Any NQA test type view

Parameters

times: Number of probes in a test, in the range 1 to 15.

Description

Use the probe count command to configure the number of probes in a test.

Use the undo probe count command to restore the default.

By default, one probe is performed in a test.

l For a TCP or DLSw test, one probe means one connection;

l For a UDP-jitter test, the number of packets sent in one probe depends on the probe packet-number command;

l For an FTP, HTTP or DHCP test, one probe means to carry out a corresponding function;

l For an ICMP-echo or UDP-echo test, one packet is sent in one probe;

l For an SNMP test, three packets are sent in a probe.

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

Examples

# Configure the number of probes in an ICMP-echo test as 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

Syntax

probe packet-interval packet-interval

undo probe packet-interval

View

UDP-jitter test type view

Parameters

packet-interval: Interval for consecutive packets sent, in milliseconds, in the range 10 to 1000.

Description

Use the probe packet-interval command to configure the interval for sending consecutive packets.

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

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

Examples

# Configure the interval for sending consecutive packets as 100 milliseconds.

<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

Syntax

probe packet-number packet-number

undo probe packet-number

View

UDP-jitter test type view

Parameters

packet-number: Number of consecutive packets sent in a UDP-jitter test, in the range 10 to 1000.

Description

Use the probe packet-number command to configure the number of consecutive packets sent in a UDP-jitter probe.

Use the undo probe packet-number command to restore the default.

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

Examples

# Configure the number of consecutive packets in a UDP-jitter probe as 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

Syntax

probe packet-timeout packet-timeout

undo probe packet-timeout

View

UDP-jitter test type view

Parameters

packet-timeout: Timeout time for waiting for responses in a UDP-jitter test, in the range 10 to 3600000 milliseconds.

Description

Use the probe packet-timeout command to configure the timeout time for waiting for responses in a UDP-jitter test.

Use the undo probe packet-timeout command to restore the default.

By default, the timeout time in a UDP-jitter test is 3000 milliseconds.

Examples

# Configure the timeout time for waiting for responses in a UDP-jitter test as 100 milliseconds.

<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

Syntax

probe timeout timeout

undo probe timeout

View

DHCP, DLSw, FTP, HTTP, ICMP-echo, SNMP, TCP, UDP-echo test type view

Parameters

timeout: Timeout time in a probe except UDP-jitter probe, in milliseconds. For an FTP or HTTP probe, the value range is 10 to 86400000; for a DHCP, DLSw, ICMP-echo, SNMP, TCP or UDP-echo probe, the value range is 10 to 3600000.

Description

Use the probe timeout command to configure the timeout time in a probe.

Use the undo probe timeout command to restore the default.

By default, the timeout time is 3000 milliseconds.

Examples

# Configure the timeout time in a DHCP probe as 10000 milliseconds.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type dhcp

[Syaname-nqa-admin-test-dhcp] probe timeout 10000

reaction

Syntax

reaction item-num checked-element probe-fail threshold-type consecutive occurrences [ action-type { none | trigger-only } ]

undo reaction item-num

View

DHCP, DLSw, FTP, HTTP, ICMP-echo, SNMP, TCP, UDP-echo test type view

Parameters

item-num: Number of the reaction entry, in the range 1 to 10.

checked-element: Type of the monitored element in collaboration. At present, the type of the monitored element can be probe failure only.

probe-fail: The type of the monitored element is probe failure.

threshold-type consecutive: Threshold type is consecutive probe failures.

occurrences: Number of consecutive probe failures, in the range 1 to 16.

action-type: Triggered action type, defaulting to none.

none: No actions.

trigger-only: Triggers collaboration between other modules only.

Description

Use the reaction command to establish a collaboration entry to monitor the probe results of the current test group. If the number of consecutive probe failures reaches the threshold, collaboration with other modules is triggered.

Use the undo reaction command to remove the collaboration entry.

By default, no collaboration entries are configured.

Note that you cannot modify the content of a collaboration object using the reaction command after the collaboration object is created.

Related commands: track in the Track Commands.

Examples

# Create collaboration object 1. If the number of consecutive probe failures reaches 3, collaboration with other modules is triggered.

<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

Syntax

reaction trap { probe-failure consecutive-probe-failures | test-complete | test-failure cumulate-probe-failures }

undo reaction trap { probe-failure | test-complete | test-failure }

View

Any NQA test type view

Parameters

probe-failure consecutive-probe-failures: Specifies to send a trap indicating a probe failure to the network management server after consecutive probe failures in an NQA test. consecutive-probe-failures is the number of consecutive probe failures in a test, in the range 1 to 15.

test-complete: Specifies to send a trap to indicate that the test is completed.

test-failure cumulate-probe-failures: Specifies to send a trap indicating a probe failure to the network management server if the total number of probe failures in an NQA test is larger than or equal to cumulate-probe-failures. For one test, the trap is sent only when the test is completed. cumulate-probe-failures is the total number of consecutive probe failures in a test, in the range 1 to 15.

Description

Use the reaction trap probe-fail command to configure to send traps to network management server under specified conditions.

Use the undo reaction trap probe-fail command to restore the default.

By default, no traps are sent to the network management server.

Examples

# Configure to send a trap indicating a probe failure after five consecutive probe failures in an ICMP-echo test.

<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

Syntax

route-option bypass-route

undo route-option bypass-route

View

DLSw, FTP, HTTP, ICMP-echo, SNMP, TCP, UDP-echo, UDP-jitter test type view

Parameters

None

Description

Use the route-option bypass-route command to enable the routing table bypass function to test the direct connectivity to the direct destination.

Use the undo route-option bypass-route command to disable the routing table bypass function.

By default, the routing table bypass function is disabled.

Note that 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.

Examples

# Enable the routing table bypass function.

<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

Syntax

source interface interface-type interface-number

undo source interface

View

ICMP-echo test type view

Parameters

interface-type interface-number: Interface type and the interface number of the source interface of a probe packet.

Description

Use the source interface command to specify the IP address of an interface as the source IP address of ICMP-echo probe requests.

Use the undo source interface command to remove the IP address of an interface as the source IP address of ICMP-echo probe requests.

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

Note that:

l If you use the source ip command to configure the source IP address of ICMP probe requests, the source interface command is invalid.

l The interface specified by the source interface command must be up; otherwise, the probe fails.

Related commands: source ip.

Examples

l On an Ethernet interface

# Specify the IP address of interface Ethernet 1/0 as the source IP address of ICMP-echo probe requests.

<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/0

l On a VLAN interface

# Specify the IP address of interface VLAN-interface 2 as the source IP address of ICMP-echo probe requests.

<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

Syntax

source ip ip-address

undo source ip

View

DLSw, FTP, HTTP, ICMP-echo, SNMP, TCP, UDP-echo, UDP-jitter test type view

Parameters

ip-address: Source IP address of a test operation.

Description

Use the source ip command to configure the source IP address of ICMP probe requests in a test operation.

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

By default, no source IP address is specified. For an ICMP-echo test, if no source IP address is specified, but the source interface is specified, the IP address of the source interface is taken as the source IP address of ICMP probe requests.

Related commands: source interface.

Examples

# Configure the source IP address of an ICMP-echo probe request as 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

Syntax

source port port-number

undo source port

View

SNMP, UDP-echo, UDP-jitter test type view

Parameters

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

Description

Use the source port command to configure the source port of ICMP probe requests in a test operation.

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

By default, no source port number is specified.

Examples

# Configure the source port number of a probe request as 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

tos

Syntax

tos value

undo tos

View

DLSw, FTP, HTTP, ICMP-echo, SNMP, TCP, UDP-echo, UDP-jitter test type view

Parameters

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

Description

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

Use the undo tos command to restore the default.

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

Examples

# Configure the ToS field in a IP packet header in an NQA probe packet as 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

Syntax

ttl value

undo ttl

View

DLSw, FTP, HTTP, ICMP-echo, SNMP, TCP, UDP-echo, UDP-jitter test type view

Parameters

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

Description

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

Use the undo ttl command to restore the default.

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

Note that after you configure the route-option bypass-route command, the maximum number of hops a probe packet traverses in the network is 1.

Examples

# Configure the maximum number of hops that a probe request can traverse in a network as 16.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] ttl 16

type

Syntax

type { dhcp | dlsw | ftp | http | icmp-echo | snmp | tcp | udp-echo | udp-jitter }

View

NQA test group view

Parameters

dhcp: DHCP test.

dlsw: DLSw test.

ftp: FTP test.

http: HTTP test.

icmp-echo: ICMP-echo test.

snmp: SNMP test.

tcp: TCP test.

udp-echo: UDP-echo test.

udp-jitter: UDP-jitter test.

Description

Use the type command to configure the test type of the current test group and enter test type view.

By default, no test type is configured.

Examples

# Configure the test type of a test group as FTP.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type ftp

[Sysname-nqa-admin-test-ftp]

url

Syntax

url url

undo url

View

HTTP test type view

Parameters

url: Website an HTTP test visits, a string of 1 to 185 characters. It is case sensitive.

Description

Use the url command to configure the website an HTTP test visits.

Use the undo url command to remove the configured website an HTTP test visits.

Note that the character string of the configured URL cannot contain spaces.

Examples

# Configure the website that an HTTP test visits as /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

Syntax

username username

undo username

View

FTP test type view

Parameters

username: Username used to log onto the FTP server, a string of 1 to 32 characters. It is case sensitive.

Description

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

Use the undo username command to remove the configured username.

By default, no username is configured for logging onto the FTP server.

Related commands: password, operation.

Examples

# Configure the login username as administrator.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type ftp

[Sysname-nqa-admin-test-ftp] username administrator

NQA Server Configuration Commands

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

display nqa server status

Syntax

display nqa server status

View

Any view

Parameters

None

Description

Use the display nqa server status command to display NQA server status.

Examples

# 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

Table 1-3 display nqa server status command output description

Field	Description
tcp-connect	NQA server status in the NQA TCP test
udp-echo	NQA server status in the NQA UDP test
IP Address	IP address specified for the TCP/UDP listening service on the NQA server
Port	Port number of the TCP/UDP listening service on the NQA server
Status	Listening service status: active: Listening service is ready; inactive: Listening service is not ready.

nqa server enable

Syntax

nqa server enable

undo nqa server enable

View

System view

Parameters

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 commands: nqa server tcp-connect, nqa server udp-echo.

Examples

# Enable the NQA server.

<Sysname> system-view

[Sysname] nqa server enable

nqa server tcp-connect

Syntax

nqa server tcp-connect ip-address port-number

undo nqa server tcp-connect ip-address port-number

View

System view

Parameters

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 1 to 50000.-

Description

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

Use the undo nqa-server tcp-connect command to remove the TCP listening service created.

Note that:

l You need to configure the command on the NQA server for TCP tests only.

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. Otherwise, the configuration will be invalid.

Related commands: nqa server enable.

Examples

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

<Sysname> system-view

[Sysname] nqa server tcp-connect 169.254.10.2 9000

nqa server udp-echo

Syntax

nqa server udp-echo ip-address port-number

undo nqa server udp-echo ip-address port-number

View

System view

Parameters

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 1 to 50000.

Description

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

Use the undo nqa-server udp-echo command to remove the UDP listening service created.

Note that:

l You need to configure the command on the NQA server for UDP-jitter and UDP-echo tests only.

l The IP address and port number must be consistent with those configured on 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. Otherwise, the configuration will be invalid.

Related commands: nqa server enable.

Examples

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

<Sysname> system-view

[Sysname] nqa server udp-echo 169.254.10.2 9000

H3C WX6103 Access Controller Switch Interface Board Command Reference-6W102

NQA Server Configuration Commands

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us