Table of Contents

Chapter 1 NQA Configuration. 1-1

1.1 NQA Overview. 1-1

1.1.1 Introduction to NQA. 1-1

1.1.2 NQA Server and NQA Client 1-2

1.1.3 NQA Test Operation. 1-2

1.2 Configuring NQA Tests. 1-3

1.2.1 Configuring the ICMP Test 1-3

1.2.2 Configuring the DHCP Test 1-5

1.2.3 Configuring the FTP Test 1-7

1.2.4 Configuring the HTTP Test 1-9

1.2.5 Configuring the Jitter Test 1-11

1.2.6 Configuring SNMP Query Test 1-14

1.2.7 Configuring the TCP Test 1-16

1.2.8 Configuring the UDP Test 1-18

1.2.9 Configuring the DLSw Test 1-21

1.3 Configuring Optional Parameters for NQA Tests. 1-23

1.3.1 Configuring Optional Parameters Common to NQA. 1-23

1.3.2 Configuring Optional Parameters Common to an NQA Test Group. 1-23

1.3.3 Configuring Trap Delivery. 1-26

1.4 Displaying and Maintaining NQA. 1-26

 

Chapter 1  NQA Configuration

 

 

When configuring NQA, go to these sections for information you are interested in:

l           NQA Overview

l           Configuring NQA Tests

l           Configuring Optional Parameters for NQA Tests

l           Displaying and Maintaining NQA

1.1  NQA Overview

This section covers these topics:

l           Introduction to NQA

l           NQA Server and NQA Client

l           NQA Test Operation

1.1.1  Introduction to NQA

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 real-time 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).

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 section 1.3  "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)         Display the test results through the related display or debugging command.

 

 

1.2  Configuring NQA Tests

 

 

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 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	Required
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 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.
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 a VLAN interface. In addition, the interface must be up. Otherwise, the test will fail.
Configure common optional parameters	Refer to section 1.3   “Configuring Optional Parameters for NQA Tests".	Optional
Enable the NQA test	test-enable	Required
Display 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 (SwitchA) can send packets to the specified destination (SwitchB) and test the roundtrip time of packets.

l           SwitchA serves as the NQA client and the IP address is 10.1.1.1/16.

l           SwitchB serves as the object that is to be pinged from Device 1 and the IP address is 10.2.2.2/16.

2)         Network diagram

Figure 1-2 Network diagram for the ICMP test

3)         Configuration procedure

Perform the following configurations on SwitchA:

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

<Sysname> system-view

[Sysname] nqa-agent enable

[Sysname] nqa admin icmp

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

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

# Configure optional parameters.

[Sysname-nqa-admin-icmp] count 10

[Sysname-nqa-admin-icmp] timeout 5

# Enable the ICMP test.

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

You can view the configuration result using the display nqa results command.

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 DHCP Operation 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	Required
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 a VLAN interface.
Configure common optional parameters	Refer to section 1.3  “Configuring Optional Parameters for NQA Tests”	Optional
Enable the NQA test	test-enable	Required
Display the test results	display nqa results [ admin-name operation-tag ]	Required You can execute the command in any view.

 

III. Configuration example

1)         Network requirements

SwitchB is configured as the DHCP server. The time it takes for SwitchA to obtain an IP address from SwitchB is tested with the NQA DHCP function.

l           SwitchA serves as the NQA client and the IP address is 10.1.1.1/16

l           SwitchB serves as the DHCP server and the IP address is 10.2.2.2/16

2)         Network diagram

Figure 1-3 Network diagram for the DHCP test

3)         Configuration procedure

Perform the following configurations on the SwitchA:

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

<Sysname> system-view

[Sysname] nqa-agent enable

[Sysname] nqa admin dhcp

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

[Sysname-nqa-admin-dhcp] source-interface Vlan-interface 3

# Enable the DHCP test.

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

You can view the configuration result using the display nqa results command.

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 in to the FTP server. For the FTP server configurations, refer to File System Management Operation 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	Required
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 section 1.3  “Configuring Optional Parameters for NQA Tests”	Optional
Enable the NQA test	test-enable	Required
Display the test results	display nqa results [ admin-name operation-tag ]	Required You can execute the command in any view.

 

 

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

Perform the following configurations on the SwitchA:

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

<Sysname> system-view

[Sysname] nqa-agent enable

[Sysname] nqa admin ftp

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

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

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

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

[Sysname-nqa-admin-ftp] username admin

[Sysname-nqa-admin-ftp] password nqa

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

# Enable the FTP test.

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

You can view the configuration result using the display nqa results command.

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	Required
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 section 1.3  “Configuring Optional Parameters for NQA Tests”	Optional
Enable the NQA test	test-enable	Required
Display 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 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

Perform the following configurations on the SwitchA:

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

<Sysname> system-view

[Sysname] nqa-agent enable

[Sysname] nqa admin http

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

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

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

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

# Enable the HTTP test.

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

You can view the configuration result using the display nqa results command.

1.2.5  Configuring the Jitter Test

 

 

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	Required
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 section 1.3  “Configuring Optional Parameters for NQA Tests”.	Optional
Enable the NQA test	test-enable	Required
Display the test results	display nqa results [ admin-name operation-tag ]	Required You can execute the command in any view.
Display the recorded delay jitter of UDP packet transmission in the last NQA jitter test	display nqa jitter [ admin-name operation-tag ]	Optional You can execute the command in any view.

 

 

II. Configuration example

1)         Network requirements

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

2)         Network diagram

Figure 1-6 Network diagram for the jitter test

3)         Configuration procedure

l           Configuration on SwitchB

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

<Sysname> system-view

[Sysname] nqa-server enable

[Sysname] nqa-server udpecho 10.2.2.2 9000

l           Configuration on SwitchA

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

<Sysname> system-view

[Sysname] nqa-agent enable

[Sysname] nqa admin jitter

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

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

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

# Enable the jitter test.

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

You can view the configuration result using the display nqa results and display nqa jitter command.

1.2.6  Configuring SNMP Query Test

The SNMP query test is mainly 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 test group view	nqa admin-name operation-tag	Required
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 section 1.3  “Configuring Optional Parameters for NQA Tests”.	Optional
Enable the NQA test	test-enable	Required
Display the test results	display nqa results [ admin-name operation-tag ]	Required You can execute the command in any view.

 

III. Configuration example

1)         Network requirements

Use the NQA SNMP query function to test the time it takes the SwitchA to send an SNMP query packet to the SwitchB (SNMP agent) and receive a response packet.

2)         Network diagram

Figure 1-7 Network diagram for the SNMP query test

3)         Configuration procedure

l           Perform the following configurations on SNMP agent.

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

<Sysname> system-view

[Sysname] snmp-agent sys-info version v2c

[Sysname] snmp-agent community read public

[Sysname] snmp-agent community write private  

 

 

Perform the following configurations on the SwitchA:

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

<Sysname> system-view

[Sysname] nqa-agent enable

[Sysname] nqa admin snmp

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

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

# Enable the SNMP query test.

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

You can view the configuration result using the display nqa results command.

1.2.7  Configuring the TCP Test

 

 

The TCP test is mainly 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 test group view	nqa admin-name operation-tag	Required
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	1.3  Configuring Optional Parameters for NQA Tests	Optional
Enable the NQA test	test-enable	Required
Display 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 TCP-Private function to test the time for setting up a TCP connection between the local port (SwitchA) and the specified destination port (SwitchB). 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 SwitchB

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

<Sysname> system-view

[Sysname] nqa-server enable

[Sysname] nqa-server tcpconnect 10.2.2.2 9000

l           Configuration on SwitchA

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

<Sysname> system-view

[Sysname] nqa-agent enable

[Sysname] nqa admin tcpprivate

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

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

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

# Enable the TCP test.

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

# Display the test results.

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

1.2.8  Configuring the UDP Test

 

 

The UDP test is mainly 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 TCP-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 test group view	nqa admin-name operation-tag	Required
Set the test type to UDP	test-type { udpprivate | udppublic }	Required
Configure a destination address for a test	destination-ip ip-address	Required Equivalent to a destination address in the Ping command. 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 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.
Configure common optional parameters	Refer to section 1.3  “Configuring Optional Parameters for NQA Tests”	Optional
Enable the NQA test	test-enable	Required
Display 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 UDP-Private function to test the setup time for the UDP connection between the local port (SwitchA) and the specified destination port (SwitchB). The port number used is 9000.

2)         Network diagram

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

3)         Configuration procedure

l           Configuration on SwitchB

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

<Sysname> system-view

[Sysname] nqa-server enable

[Sysname] nqa-server udpecho 10.2.2.2 9000

l           Configuration on SwitchA

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

<Sysname> system-view

[Sysname] nqa-agent enable

[Sysname] nqa admin udpprivate

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

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

[Sysname-nqa-admin-udpprivate] destination-port 9000

# Enable the TCP test.

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

You can view the configuration result using the display nqa results command.

1.2.9  Configuring the DLSw Test

The DLSw test is mainly 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 test group view	nqa admin-name operation-tag	Required
Set the test type to DLSw	test-type dlsw	Required
Configure a destination address for a test	destination-ip ip-address	Required Equivalent to a destination address in the Ping command.
Configure common optional parameters	Refer to section 1.3  “Configuring Optional Parameters for NQA Tests”.	Optional
Enable the NQA test	test-enable	Required
Display the test results	display nqa results [ admin-name operation-tag ]	Required You can execute the command 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

Perform the following configurations on the device:

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

<Sysname> system-view

[Sysname] nqa-agent enable

[Sysname] nqa administrator dlsw

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

[Sysname-nqa-administrator-dlsw] destination-ip 10.2.2.2

# Enable the DLSw test.

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

You can view the configuration result using the display nqa results command.

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

 

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	Required
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 protocol, 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, make sure you configure an IP address of the network management server that will receive Trap messages on the device. For detailed configurations, refer to SNMP-RMON Operation 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 test group 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.

 

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