Ping can use only the Internet Control Message Protocol (ICMP) to test the reachability of the destination host and the roundtrip time of a packet to the destination. NQA (network quality analyzer) is an enhanced Ping tool used for testing the performance of protocols running on networks. Besides the Ping functions, NQA can provide the following functions:

l Detecting the availability and the response time of DHCP, FTP, HTTP, and SNMP services.

l Testing the delay jitter of the network.

l Verifying the availability of TCP, UDP, and DLSw packets.

Different from Ping, NQA does not display the roundtrip time or time-out time of each packet on the console terminal in a realtime way. In this case, you have to execute the display nqa results command to view NQA test results. In addition, NQA can help you to set parameters for various tests and start these tests through the network management system (NMS).

& Note:

For the detailed description on TCP, UDP, Jitter, ICMP, HTTP, FTP, DHCP, DLSw and SNMP, refer to the corresponding manuals.

1.1.2 NQA Server and NQA Client

In most NQA test systems, you only need to configure an NQA client. However, when you perform a TCP, UDP, or jitter test, you need to configure an NQA server. Figure 1-1 shows the relationship between an NQA client and an NQA server.

Figure 1-1 Relationship between NQA client and NQA server

The NQA server listens to test requests originated by the NQA client and makes a response to these requests. The NQA server can respond to requests originated by the NQA client only when the NQA server is enabled and the corresponding destination address and port number are configured on the server. The IP address and port number specified for a listening service on the server must be consistent with those on the client.

You can create multiple TCP or UDP listening services on the NQA server, with each listening service corresponding to a specified destination address and port number.

1.1.3 NQA Test Operation

NQA can test multiple protocols. A test group must be created for each type of NQA test. Each test group can be related to only one type of NQA test. Each test group has an administrator name and an operation tag. The administrator name and the operation tag uniquely identify a test group.

After you create a test group and enter test group view, you can configure related test parameters. Test parameters vary with the test type. For details, see the configuration procedure below.

For optional parameters common to different types of tests, refer to Configuring Optional Parameters for NQA Tests.

To perform an HW test successfully, proceed as follows:

1) Enable the NQA client.

2) Create a test group and configure test parameters according to the test type.

3) Perform the NQA test through the related enable command.

4) View the test results through the related display or debugging command.

& Note:

After you enable the NQA client, you can create multiple test groups to perform tests. In this way, you do not need to enable the NQA client repeatedly.

1.2 Configuring NQA Tests

& Note:

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

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

This section covers these topics:

l Configuring the ICMP Test

l Configuring the DHCP Test

l Configuring the FTP Test

l Configuring the HTTP Test

l Configuring the Jitter Test

l Configuring the SNMP Query Test

l Configuring the TCP Test

l Configuring the UDP Test

l Configuring the DLSw Test

1.2.1 Configuring the ICMP Test

The ICMP test is mainly used to test whether an NQA client can send packets to a specified destination and test the roundtrip time of packets.

I. Configuration procedure

Follow these steps to configure the ICMP test:

To do…	Use the command…	Remarks
Enter system view	system-view	—
Enable the NQA client	nqa-agent enable	Required
Create an NQA test group and enter its view	nqa admin-name operation-tag	—
Set the test type to ICMP	test-type icmp	Optional ICMP by default.
Configure a destination address for a test	destination-ip ip-address	Required
Configure the size of test packets sent	datasize size	Optional 56 bytes by default.
Configure a string of fill characters of a test packet	datafill text	Optional The string of fill characters of an ICMP packet is the string corresponding with the ASCII code 00 to 09 by default.
Specify a VPN instance	vpninstance name	Optional No VPN instance is specified by default. When there are multiple VPNs, you need to use this command to specify a VPN instance for test.
Specify the IP address of an interface as the source IP address of an ICMP test request packet	source-interface interface-type interface-number	Optional The interface specified by this command can only be VLAN interface. In addition, the interface must be up. Otherwise, the test will fail.
Configure common optional parameters	Refer to Configuring Optional Parameters for NQA Tests.	Optional
Enable the NQA test	test-enable	Required
View the test results	display nqa results [ admin-name operation-tag ]	Required You can execute the command in any view.

II. Configuration example

1) Network requirements

Use the NQA ICMP function to test whether the NQA client (Switch A) can send packets to the specified destination (Switch B) and test the roundtrip time of packets.

2) Network diagram

Figure 1-2 Network diagram for the ICMP test

3) Configuration procedure

Perform the following configurations on Switch A:

# Enable the NQA client, create an ICMP test group, and configure related test parameters.

<SwitchA> system-view

[SwitchA] nqa-agent enable

[SwitchA] nqa admin icmp

[SwitchA-nqa-admin-icmp] test-type icmp

[SwitchA-nqa-admin-icmp] destination-ip 10.2.2.2

# Configure optional parameters.

[SwitchA-nqa-admin-icmp] count 10

[SwitchA-nqa-admin-icmp] timeout 5

# Enable the ICMP test.

[SwitchA-nqa-admin-icmp] test-enable

# View the test results with the display nqa results command.

[SwitchA-nqa-admin-icmp] display nqa results admin icmp

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

Destination ip address: 10.2.2.2

Send operation times: 10 Receive response times: 10

Min/Max/Average Round Trip Time: 1/3/1

Square-Sum of Round Trip Time: 29

Last succeeded test time: 2006-06-07 15:02:03.0

Extend result:

Packet lost in test: 0%

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

Failures due to Other Errors: 0

1.2.2 Configuring the DHCP Test

The DHCP test is mainly used to test the existence of a DHCP server on the network as well as the time necessary for the DHCP server to respond to a client request and assign an IP address to the client.

I. Configuration prerequisites

The interface specified by the source-interface command must be up.

Before the DHCP test, you need to perform some configurations on the DHCP server. For example, you need to enable the DHCP service and configure an address pool. If the NQA (DHCP) client and the DHCP server are not in the same network segment, you need to configure a DHCP relay. For detailed configurations, refer to the DHCP Configuration part of the manual.

II. Configuration procedure

Follow these steps to configure the DHCP test

To do…	Use the command…	Remarks
Enter system view	system-view	—
Enable the NQA client	nqa-agent enable	Required
Create an NQA test group and enter its view	nqa admin-name operation-tag	—
Set the test type to DHCP	test-type dhcp	Required
Specify an interface for a DHCP test	source-interface interface-type interface-number	Required The interface in the command must be VLAN interface. In addition, the interface must be up. Otherwise, the test will fail.
Configure common optional parameters	Refer to Configuring Optional Parameters for NQA Tests	Optional
Enable the NQA test	test-enable	Required
View the test results	display nqa results [ admin-name operation-tag ]	Required Available in any view.

III. Configuration example

1) Network requirements

Use the NQA DHCP function to test the time necessary for Switch A to obtain an IP address from the DHCP server Switch B.

2) Network diagram

Figure 1-3 Network diagram for the DHCP test

3) Configuration procedure

& Note:

For the configuration of DHCP Server, refer to the DHCP Configuration part of the manual.

Perform the following configurations on Switch A:

# Enable the NQA client, create a DHCP test group, and configure related test parameters.

<SwitchA> system-view

[SwitchA] nqa-agent enable

[SwitchA] nqa admin dhcp

[SwitchA-nqa-admin-dhcp] test-type dhcp

[SwitchA-nqa-admin-dhcp] source-interface ethernet 1/0

# Enable the DHCP test.

[SwitchA-nqa-admin-dhcp] test-enable

# View the test results with the display nqa results command.

[SwitchA-nqa-admin-dhcp] display nqa results admin dhcp

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

Send operation times: 1 Receive response times: 1

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

Square-Sum of Round Trip Time: 277729

Last succeeded test time: 2006-06-07 13:15:07.3

Extend result:

Packet lost in test: 0%

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

Failures due to Other Errors: 0

1.2.3 Configuring the FTP Test

The FTP test is mainly used to test the connection with a specified FTP server and the time necessary for the FTP client to transfer a file to the FTP server.

I. Configuration prerequisites

Before the FTP test, you need to perform some configurations on the FTP server. For example, you need to configure the username and password used to log onto the FTP server. For the FTP server configurations, refer to the File System Management Configuration part of the manual.

II. Configuration procedure

Follow these steps to configure the FTP test:

To do…	Use the command…	Remarks
Enter system view	system-view	—
Enable the NQA client	nqa-agent enable	Required
Create an NQA test group and enter its view	nqa admin-name operation-tag	—
Set the test type to FTP	test-type ftp	Required
Configure a destination address for a test	destination-ip ip-address	Required Here it is the IP address of the FTP server.
Configure the source IP address of a test request packet	source-ip ip-address	Required The source IP address must be that of an interface on the device and the interface must be up. Otherwise, the test will fail.
Configure the operation type	ftp-operation { get \| put }	Optional get by default, meaning to get files from the FTP server.
Configure a login username	username name	Required
Configure a login password	password password	Optional
Specify a file to be transferred between the FTP server and the FTP client.	filename file-name	Required
Configure common optional parameters	Refer to Configuring Optional Parameters for NQA Tests.	Optional
Enable the NQA test	test-enable	Required
View the test results	display nqa results [ admin-name operation-tag ]	Required Available in any view.

& Note:

l Transfer a small file for a get operation. If the file is too large, the test may fail because of time-out.

l When you perform a get operation, the file obtained from the FTP server will not be saved on the device, either. If there is no such file-name file on the FTP server, the FTP test will fail.

l When you perform a put operation, a file-name file with a fixed size and contents will be created on the FTP server, but the uploaded file will not be saved.

III. Configuration example

1) Network requirements

Use the NQA FTP function to test the connection with a specified FTP server and the time necessary for the FTP client to upload a file to the FTP server. The login username is admin, the login password is nqa, and the file to be transferred to the FTP server is config.txt.

2) Network diagram

Figure 1-4 Network diagram for the FTP test

3) Configuration procedure

& Note:

For the configuration of FTP Server, refer to the File System Management Configuration part of the manual.

Perform the following configurations on Switch A:

# Enable the NQA client, create an FTP test group, and configure related test parameters.

<SwitchA> system-view

[SwitchA] nqa-agent enable

[SwitchA] nqa admin ftp

[SwitchA-nqa-admin-ftp] test-type ftp

[SwitchA-nqa-admin-ftp] destination-ip 10.2.2.2

[SwitchA-nqa-admin-ftp] source-ip 10.1.1.1

[SwitchA-nqa-admin-ftp] ftp-operation put

[SwitchA-nqa-admin-ftp] username admin

[SwitchA-nqa-admin-ftp] password nqa

[SwitchA-nqa-admin-ftp] filename config.txt

# Enable the FTP test.

[SwitchA-nqa-admin-ftp] test-enable

# View the test results with the display nqa results command.

[SwitchA-nqa-admin-ftp] display nqa results admin ftp

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

Destination ip address: 10.2.2.2

Send operation times: 1 Receive response times: 1

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

Square-Sum of Round Trip Time: 36481

Last succeeded test time: 2000-06-07 13:21:23.9

Extend result:

Packet lost in test: 0%

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

Failures due to Other Errors: 0

1.2.4 Configuring the HTTP Test

The HTTP test is mainly used to test the connection with a specified HTTP server and the time required to obtain data from the HTTP server.

I. Configuration procedure

Follow these steps to configure the HTTP test:

To do…	Use the command…	Remarks
Enter system view	system-view	—
Enable the NQA client	nqa-agent enable	Required
Create an NQA test group and enter its view	nqa admin-name operation-tag	—
Set the test type to HTTP	test-type http	Required
Configure a destination address for a test	destination-ip ip-address	Required Here it is the IP address of the HTTP server.
Configure the HTTP operation type	http-operation { get \| post }	Optional get by default, meaning to get data from the HTTP server.
Configure an HTTP operation string	http-string string version	Required
Configure common optional parameters	Refer to Configuring Optional Parameters for NQA Tests.	Optional
Enable the NQA test	test-enable	Required
View the test results	display nqa results [ admin-name operation-tag ]	Required Available in any view.

II. Configuration example

1) Network requirements

Use the HTTP function to test the connection with a specified HTTP server and the time required to obtain data from the HTTP server.

2) Network diagram

Figure 1-5 Network diagram for the HTTP test

3) Configuration procedure

& Note:

For the configuration of HTTP Server, refer to the Login Configuration part of the manual.

Perform the following configurations on Switch A:

# Enable the NQA client, create an HTTP test group, and configure related test parameters.

<SwitchA> system-view

[SwitchA] nqa-agent enable

[SwitchA] nqa admin http

[SwitchA-nqa-admin-http] test-type http

[SwitchA-nqa-admin-http] destination-ip 10.2.2.2

[SwitchA-nqa-admin-http] http-operation get

[SwitchA-nqa-admin-http] http-string /index.htm HTTP/1.0

# Enable the HTTP test.

[SwitchA-nqa-admin-http] test-enable

# View the test results with the display nqa results command.

[SwitchA-nqa-admin-http] display nqa results admin http

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

Destination ip address: 10.2.2.2

Send operation times: 1 Receive response times: 1

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

Square-Sum of Round Trip Time: 225

Last succeeded test time: 2006-12-28 11:01:07.6

Extend result:

Packet lost in test: 0%

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

Failures due to Other Errors: 0

1.2.5 Configuring the Jitter Test

Caution:

You are not recommended to perform an NQA 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.

The jitter test is used to take statistics of delay jitter of UDP packet transmission. Delay jitter refers to the difference between the interval of receiving two packets consecutively and the interval of sending these two packets. During the test, the source port sends data packets to the destination port at regular intervals. The destination port affixes a time stamp to each packet that it receives and then sends it back to the source port. After the source port receives the data packet, the delay jitter can be calculated.

To improve the accuracy of the statistics results, you must send multiple test packets when you perform a test. The more test packets are sent, the more accurate the statistics results are. However, it takes a longer time to complete the test. You can quicken a jitter test by reducing the interval of sending test packets. However, doing so will cause an impact on the network.

The error in the statistics results of a jitter test is big since there is a delay in both sending and receiving data packets.

A jitter test requires cooperation between the NQA server and the NQA client. You must configure the UDP listening function on the NQA server, and a destination address and a destination port on the NQA client, and ensure that the destination address and destination port on the NQA client are respectively the listening IP address and port on the NQA server.

I. Configuration procedure

1) Configure the NQA server

Follow these steps to configure the NQA server for a jitter test:

To do…	Use the command…	Remarks
Enter system view	system-view	—
Enable the NQA server	nqa-server enable	Required Disabled by default
Configure the UDP listening function on the NQA server	nqa-server udpecho ip-address port-number	Required The listening IP address and port number must be the destination IP address and port on the NQA client.

2) Configure the NQA client

Follow these steps to configure the NQA client for a jitter test:

To do…	Use the command…	Remarks
Enter system view	system-view	—
Enable the NQA client	nqa-agent enable	Required
Create an NQA test group and enter its view	nqa admin-name operation-tag	—
Set the test type to jitter	test-type jitter	Required
Configure a destination address for a test	destination-ip ip-address	Required The destination address is the listening IP address on the NQA server.
Configure a destination port	destination-port port-number	Required The destination port is the listening port on the NQA server.
Configure the number of jitter test packets sent in a probe	jitter-packetnum number	Optional 10 by default.
Configure the interval for sending jitter test packets	jitter-interval interval	Optional 20 ms by default.
Configure common optional parameters	Refer to Configuring Optional Parameters for NQA Tests.	Optional
Enable the NQA test	test-enable	Required
View the test results	display nqa results [ admin-name operation-tag ]	Required Available in any view.
View the recorded delay jitter of UDP packet transmission in the last NQA jitter test	display nqa jitter [ admin-name operation-tag ]	Optional Available in any view.

& Note:

The number of probes made in a jitter test depends on the count command, while the number of test packets sent in each probe depends on the jitter-packetnum command.

II. Configuration example

1) Network requirements

Use the NQA jitter function to test the delay jitter of packet transmission between the local port (Switch A) and the specified destination port (Switch B).

2) Network diagram

Figure 1-6 Network diagram for the jitter test

3) Configuration procedure

l Configuration on Switch B

# Enable the NQA server and configure the listening IP address and port number.

<SwitchB> system-view

[SwitchB] nqa-server enable

[SwitchB] nqa-server udpecho 10.2.2.2 9000

l Configuration on Switch A

# Enable the NQA client, create a jitter test group, and configure related test parameters.

<SwitchA> system-view

[SwitchA] nqa-agent enable

[SwitchA] nqa admin jitter

[SwitchA-nqa-admin-jitter] test-type jitter

[SwitchA-nqa-admin-jitter] destination-ip 10.2.2.2

[SwitchA-nqa-admin-jitter] destination-port 9000

# Enable the jitter test.

[SwitchA-nqa-admin-jitter] test-enable

# View the test results with the display nqa results and display nqa jitter commands.

[SwitchA-nqa-admin-jitter] display nqa results admin jitter

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

Destination ip address: 10.2.2.2

Send operation times: 10 Receive response times: 10

Min/Max/Average Round Trip Time: 1/9/2

Square-Sum of Round Trip Time: 114

Last succeeded test time: 2006-08-15 15:19:10.9

Extend result:

Packet lost in test: 0%

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

Failures due to Other Errors: 0

Jitter result:

RTT Number: 10

SD Maximal delay: 4 DS Maximal delay: 4

Min Positive SD: 1 Min Positive DS: 0

Max Positive SD: 1 Max Positive DS: 0

Positive SD Number: 1 Positive DS Number: 0

Positive SD Sum: 1 Positive DS Sum: 0

Positive SD average: 0 Positive DS average: 0

Positive SD Square Sum: 1 Positive DS Square Sum: 0

Min Negative SD: 1 Min Negative DS: 1

Max Negative SD: 6 Max Negative DS: 1

Negative SD Number: 2 Negative DS Number: 1

Negative SD Sum: 7 Negative DS Sum: 1

Negative SD average: 4 Negative DS average: 1

Negative SD Square Sum: 37 Negative DS Square Sum: 1

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

Unknown result lost packet number: 0

1.2.6 Configuring the SNMP Query Test

The SNMP query test is used to test the time the NQA client takes to send an SNMP query packet to the SNMP agent and then receive a response packet.

I. Configuration prerequisites

The SNMP agent function must be enabled on the device serving as an SNMP agent.

II. Configuration procedure

Follow these steps to configure the SNMP query test:

To do…	Use the command…	Remarks
Enter system view	system-view	—
Enable the NQA client	nqa-agent enable	Required
Create an NQA test group and enter its view	nqa admin-name operation-tag	—
Set the test type to SNMP query	test-type snmpquery	Required
Configure a destination address for a test	destination-ip ip-address	Required
Configure common optional parameters	Refer to Configuring Optional Parameters for NQA Tests.	Optional
Enable the NQA test	test-enable	Required
View the test results	display nqa results [ admin-name operation-tag ]	Required Available in any view.

III. Configuration example

1) Network requirements

Use the NQA SNMP query function to test the time it takes Switch A to send an SNMP query packet to the SNMP agent and receive a response packet.

2) Network diagram

Figure 1-7 Network diagram for the SNMP query test

3) Configuration procedure

l Configure Switch B.

# Enable the SNMP agent service and set the SNMP version to v2c, the read community to public, and the write community to private.

<SwitchB> system-view

[SwitchB] snmp-agent sys-info version v2c

[SwitchB] snmp-agent community read public

[SwitchB] snmp-agent community write private

& Note:

l SNMP must be enabled on the SNMP agent. Otherwise, no response packet will be received.

l In this example, the configuration is based on the SNMPv2c. If the SNMP of other versions is enabled, the configuration may be different. For details, refer to the SNMP-RMON Configuration part of this manual.

l Configure Switch A:

# Enable the NQA client, create an SNMP query test group, and configure related test parameters.

<SwitchA> system-view

[SwitchA] nqa-agent enable

[SwitchA] nqa admin snmp

[SwitchA-nqa-admin-snmp] test-type snmpquery

[SwitchA-nqa-admin-snmp] destination-ip 10.2.2.2

# Enable the SNMP query test.

[SwitchA-nqa-admin-snmp] test-enable

# View the test results with the display nqa results command.

[SwitchA-nqa-admin-snmp] display nqa results admin snmp

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

Destination ip address: 10.2.2.2

Send operation times: 1 Receive response times: 1

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

Square-Sum of Round Trip Time: 25

Last succeeded test time: 2006-06-09 11:19:28.2

Extend result:

Packet lost in test: 0%

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

Failures due to Other Errors: 0

1.2.7 Configuring the TCP Test

Caution:

You are not recommended to perform an NQA TCP 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.

The TCP test is used to test the TCP connection between the client and the specified server and the setup time for the connection.

The TCP test includes TCP-Public test and TCP-Private test.

l For the TCP-Public test, a connection setup request is permanently initiated to TCP port 7 of the destination address. No destination port needs to be configured on the client, but TCP port 7 used for listening needs to be configured on the server. Even if a port is configured on the client, the port does not take effect.

l For the TCP-Private test, a connection setup request is initiated to the specified port of the destination address.

I. Configuration procedure

1) Configure the NQA server

Follow these steps to configure the NQA server for the TCP test:

To do…	Use the command…	Remarks
Enter system view	system-view	—
Enable the NQA server	nqa-server enable	Required Disabled by default
Configure the TCP listening function on the NQA server	nqa-server tcpconnect ip-address port-number	Required The listening IP address and port number must be the destination IP address and port on the NQA client. If the test type is TCP-Public, the port number must be set to 7.

2) Configure the NQA client

Follow these steps to configure NQA client for the TCP test:

To do…	Use the command…	Remarks
Enter system view	system-view	—
Enable the NQA client	nqa-agent enable	Required
Create an NQA test group and enter its view	nqa admin-name operation-tag	—
Set the test type to TCP	test-type { tcpprivate \| tcppublic }	Required
Configure a destination address for a test	destination-ip ip-address	Required The destination address must be the listening IP address on the NQA server.
Configure a destination port	destination-port port-number	If the test type is TCP-Public, no port needs to be configured. If the test type is TCP-Private, a port must be configured and it must be the listening port configured on the NQA server.
Configure common optional parameters	Configuring Optional Parameters for NQA Tests	Optional
Enable the NQA test	test-enable	Required
View the test results	display nqa results [ admin-name operation-tag ]	Required Available in any view.

II. Configuration example

1) Network requirements

Use the NQA TCP-Private function to test the time for setting up a TCP connection between the local port (Switch A) and the specified destination port (Switch B). The port number used is 9000.

2) Network diagram

Figure 1-8 Network diagram for the TCP-Private test

3) Configuration procedure

l Configuration on Switch B

# Enable the NQA server and configure the listening IP address and port number.

<SwitchB> system-view

[SwitchB] nqa-server enable

[SwitchB] nqa-server tcpconnect 10.2.2.2 9000

l Configuration on Switch A

# Enable the NQA client, create a TCP test group, and configure related test parameters.

<SwitchA> system-view

[SwitchA] nqa-agent enable

[SwitchA] nqa admin tcpprivate

[SwitchA-nqa-admin-tcpprivate] test-type tcpprivate

[SwitchA-nqa-admin-tcpprivate] destination-ip 10.2.2.2

[SwitchA-nqa-admin-tcpprivate] destination-port 9000

# Enable the TCP test.

[SwitchA-nqa-admin-tcpprivate] test-enable

# View the test results with the display nqa results command.

[SwitchA-nqa-admin-tcpprivate] display nqa results admin tcpprivate

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

Destination ip address: 10.2.2.2

Send operation times: 1 Receive response times: 1

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

Square-Sum of Round Trip Time: 1

Last succeeded test time: 2009-08-15 15:24:34.8

Extend result:

Packet lost in test: 0%

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

Failures due to Other Errors: 0

1.2.8 Configuring the UDP Test

Caution:

You are not recommended to perform an NQA UDP 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.

The UDP test is used to test the roundtrip time of a UDP packet from the client to the specified server.

The UDP test includes UDP-Public test and UDP-Private test.

l For the UDP-Public test, a connection setup request is permanently initiated to UDP port 7 of a destination address. No port needs to be configured on the client, but port 7 for listening needs to be configured on the server. Even if a port is configured on the client, the port does not take effect.

l For the UDP-Private test, a connection setup request is initiated to the specified port of the destination address.

I. Configuration procedure

1) Configure the NQA server

Follow these steps to configure the NQA server for the UDP test:

To do…	Use the command…	Remarks
Enter system view	system-view	—
Enable the NQA server	nqa-server enable	Required Disabled by default.
Configure the UDP listening function on the NQA server	nqa-server udpecho ip-address port-number	Required The listening IP address and port number must be the destination IP address and port on the NQA client. If the test type is UDP-Public, the port number must be set to 7.

2) Configure the NQA client

Follow these steps to configure the NQA client for the UDP test:

To do…	Use the command…	Remarks
Enter system view	system-view	—
Enable the NQA client	nqa-agent enable	Required
Create an NQA test group and enter its view	nqa admin-name operation-tag	—
Set the test type to UDP	test-type { udpprivate \| udppublic }	Required
Configure a destination address for a test	destination-ip ip-address	Required The destination address must be the listening IP address configured on the NQA server.
Configure a destination port	destination-port port-number	If the test type is UDP-Public, no port needs to be configured. If the test type is UDP-Private, a port must be configured and it must be the listening port configured on the NQA server.
Configure the size of test packets sent	datasize size	Optional 100 bytes by default.
Configure a string of fill characters of a test packet	datafill text	Optional The string of fill characters of a UDP packet is the string corresponding with the ASCII code 00 to FF by default.
Configure common optional parameters	Refer to Configuring Optional Parameters for NQA Tests.	Optional
Enable the NQA test	test-enable	Required
View the test results	display nqa results [ admin-name operation-tag ]	Required Available in any view.

II. Configuration example

1) Network requirements

Use the NQA UDP-Private function to test the setup time for the UDP connection between the local port (Switch A) and the specified destination port (Switch B). The port number used is 8000.

2) Network diagram

Figure 1-9 Network diagram for the UDP-Private test

3) Configuration procedure

l Configuration on Switch B

# Enable the NQA server and configure the listening IP address and port number.

<SwitchB> system-view

[SwitchB] nqa-server enable

[SwitchB] nqa-server udpecho 10.2.2.2 8000

l Configuration on Switch A

# Enable the NQA client, create a UDP-Private test group, and configure related test parameters.

<SwitchA> system-view

[SwitchA] nqa-agent enable

[SwitchA] nqa admin udpprivate

[SwitchA-nqa-admin-udpprivate] test-type udpprivate

[SwitchA-nqa-admin-udpprivate] destination-ip 10.2.2.2

[SwitchA-nqa-admin-udpprivate] destination-port 8000

# Enable the TCP test.

[SwitchA-nqa-admin-udpprivate] test-enable

# View the test results with the display nqa results command.

[SwitchA-nqa-admin-udpprivate] display nqa results admin udpprivate

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

Destination ip address: 10.2.2.2

Send operation times: 1 Receive response times: 1

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

Square-Sum of Round Trip Time: 121

Last succeeded test time: 2009-08-15 15:26:01.8

Extend result:

Packet lost in test: 0%

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

Failures due to Other Errors: 0

1.2.9 Configuring the DLSw Test

Data Link Switching (DLSw) was jointly developed by advanced peer-to-peer networking (APPN), implementers workshop (AIW) and the Data-Link Switching related interest group (DLSw RIG) for transmitting Systems Network Architecture (SNA) traffic over a TCP/IP network. For the detailed description of DLSw, refer to the related manuals of routers supporting the DLSw function.

The DLSw test is used to test the response time of the DLSw device.

I. Configuration prerequisites

Before the DLSw test, a TCP connection can be set up between the NQA client and the specified device and the DLSw function must be enabled on the specified device.

II. Configuration procedure

Follow these steps to configure the DLSw test:

To do…	Use the command…	Remarks
Enter system view	system-view	—
Enable the NQA client	nqa-agent enable	Required
Create an NQA test group and enter its view	nqa admin-name operation-tag	—
Set the test type to DLSw	test-type dlsw	Required
Configure a destination address for a test	destination-ip ip-address	Required
Configure common optional parameters	Refer to Configuring Optional Parameters for NQA Tests.	Optional
Enable the NQA test	test-enable	Required
View the test results	display nqa results [ admin-name operation-tag ]	Required Available in any view.

III. Configuration example

1) Network requirements

Use the NQA DLSw function to test the response time of the DLSw device.

2) Network diagram

Figure 1-10 Network diagram for the DLSw test

3) Configuration procedure

& Note:

For the configuration of DLSw devices, refer to the related manuals of routers supporting the DLSw function.

l Configure Switch A:

# Enable the NQA client, create a DLSw test group, and configure related test parameters.

<SwitchA> system-view

[SwitchA] nqa-agent enable

[SwitchA] nqa admin dlsw

[SwitchA-nqa-admin-dlsw] test-type dlsw

[SwitchA-nqa-admin-dlsw] destination-ip 10.2.2.2

# Enable the DLSw test.

[SwitchA-nqa-admin-dlsw] test-enable

# View the test results with the display nqa results command.

[SwitchA-nqa-admin-dlsw] display nqa results admin dlsw

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

Destination ip address: 10.2.2.2

Send operation times: 1 Receive response times: 1

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

Square-Sum of Round Trip Time: 25

Last succeeded test time: 2006-06-07 13:25:45.1

Extend result:

Packet lost in test: 0%

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

Failures due to Other Errors: 0

1.3 Configuring Optional Parameters for NQA Tests

Unless otherwise specified, the following parameters are applicable to all test types and they can be configured according to the actual conditions. Optional parameters common to NQA are valid for all NQA tests, while those common to an NQA test group are valid only for tests in this test group. This section covers these topics:

l Configuring Optional Parameters Common to NQA

l Configuring Optional Parameters Common to an NQA Test Group

l Configuring Trap Delivery

1.3.1 Configuring Optional Parameters Common to NQA

Follow these steps to configure optional parameters common to NQA:

To do…	Use the command…	Remarks
Enter system view	system-view	—
Configure the maximum number of tests that the NQA client can simultaneously perform	nqa-agent max-requests number	Optional 5 by default

To do…

Use the command…

Remarks

Enter system view

system-view

—

Configure the maximum number of tests that the NQA client can simultaneously perform

nqa-agent max-requests number

Optional

5 by default

1.3.2 Configuring Optional Parameters Common to an NQA Test Group

Follow these steps to configure the optional parameters common to an NQA test group:

To do…	Use the command…	Remarks
Enter system view	system-view	—
Enter NQA test group view	nqa admin-name operation-tag	—
Configure a descriptive string for a test group	description text	Optional No descriptive string by default.
Configure the interval of performing a cyclic test	frequency interval	Optional No cyclic test is performed by default. This command is invalid for the DHCP test.
Configure the number of probes in a test	count times	Optional 1 by default. For the TCP test, a probe means a connection. For the jitter test, the number of test packets sent in a probe is determined by the jitter-packetnum command. For the SNMP test, three test packets are sent in a probe. For the other tests, one test packet is sent in a probe.
Configure the NQA probe time-out time	timeout time	Optional Three seconds by default. If no response packet is received within the time-out time of a request packet, the probe fails.
Configure the maximum number of history records that can be saved in a test group	history-records number	Optional 50 by default If the number of history records exceeds this value, the earliest test results are discarded.
Configure the maximum number of hops a test request packet traverses in the network	ttl number	Optional 20 by default. This command is invalid for the DHCP test.
Configure the ToS field in an IP packet header	tos value	Optional 0 by default. This command is invalid for the DHCP test.
Configure the source IP address of a test request packet	source-ip ipaddress	This command is required for the FTP test but optional for other tests. You can specify an IP address as the source IP address of a test request packet. Otherwise, the IP address of the interface sending packets serves as the source IP address of the test request packet. 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. This command is invalid for the DHCP test.
Configure the source port of a test request packet	source-port port-number	Optional You can specify a port as the source port of a test request packet. Otherwise, the system automatically assigns a port to serve as the source port of the test request packet. This command is only valid for jitter, UDP, and SNMP tests.
Enable the routing table bypass function	sendpacket passroute	Optional Disabled by default. If you want to test the connectivity between the local address and the destination address, you can enable this function. After this function is enabled, the routing table will not be searched, and the packet is directly sent to the destination in the directly connected network. If the destination is not in the directly connected network, an error will be prompted. This command is invalid for the DHCP test.

1.3.3 Configuring Trap Delivery

I. Configuration prerequisites

Before configuring Trap delivery, you should configure the address of the network management server which receives the Trap message. For detailed configuration procedure, refer to the SNMP-RMON Configuration part of the manual.

II. Configuring Trap delivery

A trap message is generated no matter whether an NQA test succeeds or fails. You can set a switch to control the delivery of the trap message to the network management server.

Follow these steps to configure Trap:

To do…	Use the command…	Remarks
Enter system view	system-view	—
Create an NQA test group and enter its view	nqa admin-name operation-tag	Required
Enable trap debugging to send a trap message to the network management server	send-trap { all \| { probefailure \| testcomplete \| testfailure }* }	Optional No trap message is sent to the network management server by default.
Configure the minimum number of probe failures in an NQA test before a test failure trap message is sent	test-failtimes times	Optional 1 by default.
Configure the number of consecutive probe failures in an NQA test before a trap message is sent to indicate a probe failure	probe-failtimes times	Optional 1 by default.

& Note:

Currently, the device does not support Trap message delivery. Therefore, the above configuration does not take effect actually.

1.4 Displaying and Maintaining NQA

To do…	Use the command…	Remarks
Display history information of tests	display nqa history [ admin-name operation-tag ]	Available in any view
Display the results of the last NQA jitter test	display nqa jitter [ admin-name operation-tag ]	Available in any view
Display the results of the last test	display nqa results [ admin-name operation-tag ]	Available in any view

H3C S3610[S5510] Series Ethernet Switches Operation Manual-Release 5303(V1.01)

Chapter 1 NQA Configuration

1.1 NQA Overview

1.1.1 Introduction to NQA

1.1.3 NQA Test Operation

1.2 Configuring NQA Tests

1.2.1 Configuring the ICMP Test

I. Configuration procedure

II. Configuration example

1.2.2 Configuring the DHCP Test

I. Configuration prerequisites

II. Configuration procedure

III. Configuration example

1.2.3 Configuring the FTP Test

I. Configuration prerequisites

II. Configuration procedure

III. Configuration example

1.2.4 Configuring the HTTP Test

I. Configuration procedure

II. Configuration example

1.2.5 Configuring the Jitter Test

I. Configuration procedure

II. Configuration example

1.2.6 Configuring the SNMP Query Test

I. Configuration prerequisites

II. Configuration procedure

III. Configuration example

1.2.7 Configuring the TCP Test

I. Configuration procedure

II. Configuration example

1.2.8 Configuring the UDP Test

I. Configuration procedure

II. Configuration example

1.2.9 Configuring the DLSw Test

I. Configuration prerequisites

II. Configuration procedure

III. Configuration example

1.3 Configuring Optional Parameters for NQA Tests

1.3.1 Configuring Optional Parameters Common to NQA

1.3.2 Configuring Optional Parameters Common to an NQA Test Group

1.3.3 Configuring Trap Delivery

I. Configuration prerequisites

II. Configuring Trap delivery

1.4 Displaying and Maintaining NQA

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