The configuration examples in this document were created and verified in a lab environment, and all the devices were started with the factory default configuration. When you are working on a live network, make sure you understand the potential impact of every command on your network.

This document assumes that you have basic knowledge of H3C NQA.

Example: Configuring an ICMP echo operation

Network configuration

As shown in Figure 1, configure an ICMP echo operation to test the roundtrip time between Router A and Router D through Router B.

Figure 1 Network diagram

Restrictions and guidelines

When you configure an ICMP echo operation, follow these restrictions and guidelines:

· Make sure the devices can reach each other before you start the ICMP echo operation.

· You cannot modify the operation configuration for a running NQA operation.

Procedures

# Create an ICMP echo operation.

<RouterA> system-view

[RouterA] nqa entry admin test

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

# Specify the destination IP address of ICMP echo requests as 60.1.1.1.

[RouterA-nqa-admin-test-icmp-echo] destination ip 60.1.1.1

# Specify the next hop of ICMP echo requests as 10.1.1.2.

[RouterA-nqa-admin-test-icmp-echo] next-hop ip 10.1.1.2

# Configure the ICMP echo operation to perform 10 probes.

[RouterA-nqa-admin-test-icmp-echo] probe count 10

# Specify the probe timeout time as 500 milliseconds for the ICMP echo operation.

[RouterA-nqa-admin-test-icmp-echo] probe timeout 500

# Configure the ICMP echo operation to repeat at an interval of 5000 milliseconds.

[RouterA-nqa-admin-test-icmp-echo] frequency 5000

# Enable saving history records.

[RouterA-nqa-admin-test-icmp-echo] history-record enable

# Configure the maximum number of history records that can be saved as 10.

[RouterA-nqa-admin-test-icmp-echo] history-record number 10

[RouterA-nqa-admin-test-icmp-echo] quit

Verifying the configuration

# Start the ICMP echo operation.

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

# After the ICMP echo operation runs for a time period, stop the operation.

[RouterA] undo nqa schedule admin test

# Display the most recent result of the ICMP echo operation.

[RouterA] display nqa result admin test

NQA entry (admin admin, tag test) test results:

Send operation times: 10 Receive response times: 10

Min/Max/Average round trip time: 2/5/3

Square-Sum of round trip time: 96

Last succeeded probe time: 2021-03-23 15:00:01.2

Extended results:

Packet loss ratio: 0%

Failures due to timeout: 0

Failures due to internal error: 0

Failures due to other errors: 0

# Display the history records of the ICMP echo operation.

[RouterA] display nqa history admin test

NQA entry (admin admin, tag test) history records:

Index Response Status Time

370 3 Succeeded 2021-03-23 15:00:01.2

369 3 Succeeded 2021-03-23 15:00:01.2

368 3 Succeeded 2021-03-23 15:00:01.2

367 5 Succeeded 2021-03-23 15:00:01.2

366 3 Succeeded 2021-03-23 15:00:01.2

365 3 Succeeded 2021-03-23 15:00:01.2

364 3 Succeeded 2021-03-23 15:00:01.1

363 2 Succeeded 2021-03-23 15:00:01.1

362 3 Succeeded 2021-03-23 15:00:01.1

361 2 Succeeded 2021-03-23 15:00:01.1

The output shows that the packets sent by Router A can reach Router D through Router B. No packet loss occurs during the operation. The minimum, maximum, and average round-trip times are 2, 5, and 3 milliseconds, respectively.

Configuration files

nqa entry admin test

type icmp-echo

destination ip 60.1.1.1

frequency 5000

history-record enable

history-record number 10

next-hop ip 10.1.1.2

probe count 10

probe timeout 500

Example: Configuring a DHCP operation

Network configuration

As shown in Figure 2, configure a DHCP operation to test the time required for Router A to obtain an IP address from the DHCP server (Router B).

Figure 2 Network diagram

Restrictions and guidelines

When you configure a DHCP operation, follow these restrictions and guidelines:

· Complete the DHCP server configuration before you start the DHCP operation.

· Make sure the devices can reach each other before you start the DHCP operation.

· You cannot modify the operation configuration for a running NQA operation.

Procedures

# Create a DHCP operation.

<RouterA> system-view

[RouterA] nqa entry admin test

[RouterA-nqa-admin-test] type dhcp

# Specify the DHCP server IP address 10.1.1.2 as the destination address.

[RouterA-nqa-admin-test-dhcp] destination ip 10.1.1.2

# Enable the saving of history records.

[RouterA-nqa-admin-test-dhcp] history-record enable

[RouterA-nqa-admin-test-dhcp] quit

Verifying the configuration

# Start the DHCP operation.

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

# After the operation runs for a time period, stop the operation.

[RouterA] undo nqa schedule admin test

# Display the most recent result of the DHCP operation.

[RouterA] display nqa result admin test

NQA entry(admin admin, tag test) test results:

Send operation times: 1 Receive response times: 1

Min/Max/Average round trip time: 624/624/624

Square-Sum of round trip time: 389376

Last succeeded probe time: 2021-03-24 09:56:03.2

Extend results:

Packet loss ratio: 0%

Failures due to timeout: 0

Failures due to internal error: 0

Failures due to other errors: 0

# Display the history records of the DHCP operation.

[RouterA] display nqa history admin test

NQA entry(admin admin, tag test) history records:

Index Response Status Time

1 624 Succeeded 2021-03-24 09:56:03.2

The output shows that it took Router A 624 milliseconds to obtain an IP address from the DHCP server.

Configuration files

nqa entry admin test

type dhcp

destination ip 10.1.1.2

history-record enable

Example: Configuring an FTP operation

Network configuration

As shown in Figure 3, configure an FTP operation to test the file transmission time between Router A and the FTP server. The login username and password are admin and systemtest, respectively.

Figure 3 Network diagram

Restrictions and guidelines

When you configure an FTP operation, follow these restrictions and guidelines:

· Make sure the devices can reach each other before you start the FTP operation.

· You cannot modify the operation configuration for a running NQA operation.

· When you perform the put operation with the filename command configured, make sure the file exists on the NQA client.

· Take the network bandwidth into consideration when you set the file size and the probe timeout.

Procedures

# Create an FTP operation.

<RouterA> system-view

[RouterA] nqa entry admin test

[RouterA-nqa-admin-test] type ftp

# Specify the URL of the FTP server.

[RouterA-nqa-admin-test-ftp] url ftp://10.2.2.2

# Specify 10.1.1.1 as the source IP address.

[RouterA-nqa-admin-test-ftp] source ip 10.1.1.1

# Specify the FTP operation type as put.

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

# Specify the file to be uploaded as config.txt.

[RouterA-nqa-admin-test-ftp] filename config.txt

# Specify the username for the FTP operation as admin.

[RouterA-nqa-admin-test-ftp] username admin

# Specify the password for the FTP operation as systemtest.

[RouterA-nqa-admin-test-ftp] password simple systemtest

# Enable the saving of history records.

[RouterA-nqa-admin-test-ftp] history-record enable

[RouterA-nqa-admin-test-ftp] quit

Verifying the configuration

# Start the FTP operation.

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

# After the FTP operation runs for a time period, stop the operation.

[RouterA] undo nqa schedule admin test

# Display the most recent result of the FTP operation.

[RouterA] display nqa result admin test

NQA entry(admin admin, tag test) test results:

Send operation times: 1 Receive response times: 1

Min/Max/Average round trip time: 173/173/173

Square-Sum of round trip time: 29929

Last succeeded probe time: 2021-03-25 10:07:28.6

Extend results:

Packet loss ratio: 0%

Failures due to timeout: 0

Failures due to disconnect: 0

Failures due to no connection: 0

Failures due to internal error: 0

Failures due to other errors: 0

# Display the history records of the FTP operation.

[RouterA] display nqa history admin test

NQA entry(admin admin, tag test) history records:

Index Response Status Time

1 173 Succeeded 2021-03-25 10:07:28.6

The output shows that it took Router A 173 milliseconds to upload a file to the FTP server.

Configuration files

nqa entry admin test

type ftp

filename config.txt

history-record enable

operation put

password cipher $c$3$BP255atzDilAfIPwfh+RMHqmP5LTiKWpVf/hpBs=

source ip 10.1.1.1

url ftp://10.2.2.2

username admin

Example: Configuring an HTTP operation

Network configuration

As shown in Figure 4, configure an HTTP operation on the NQA client to test the time required to obtain data from the HTTP server.

Figure 4 Network diagram

Restrictions and guidelines

When you configure an HTTP operation, follow these restrictions and guidelines:

· Make sure the devices can reach each other before you start the HTTP operation.

· You cannot modify the operation configuration for a running NQA operation.

Procedures

# Create an HTTP operation.

<RouterA> system-view

[RouterA] nqa entry admin test

[RouterA-nqa-admin-test] type http

# Specify the URL of the HTTP server.

[RouterA-nqa-admin-test-http] url http://10.2.2.2/index.htm

# Enable the saving of history records.

[RouterA-nqa-admin-test-http] history-record enable

[RouterA-nqa-admin-test-http] quit

Verifying the configuration

# Start the HTTP operation.

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

# After the HTTP operation runs for a time period, stop the operation.

[RouterA] undo nqa schedule admin test

# Display the most recent result of the HTTP operation.

[RouterA] display nqa result admin test

NQA entry(admin admin, tag test) test results:

Send operation times: 1 Receive response times: 1

Min/Max/Average round trip time: 64/64/64

Square-Sum of round trip time: 4096

Last succeeded probe time: 2021-03-25 11:12:47.9

Extend results:

Packet loss ratio: 0%

Failures due to timeout: 0

Failures due to disconnect: 0

Failures due to no connection: 0

Failures due to internal error: 0

Failures due to other errors: 0

# Display the history records of the HTTP operation.

[RouterA] display nqa history admin test

NQA entry(admin admin, tag test) history records:

Index Response Status Time

1 64 Succeeded 2021-03-25 11:12:47.9

The output shows that it took Router A 64 milliseconds to obtain data from the HTTP server.

Configuration files

nqa entry admin test

type http

history-record enable

url http://10.2.2.2/index.htm

Example: Configuring a UDP jitter operation

Network configuration

As shown in Figure 5, configure a UDP jitter operation to test the jitter, delay, and round-trip time between Router A and Router B.

Figure 5 Network diagram

Restrictions and guidelines

When you configure a UDP jitter operation, follow these restrictions and guidelines:

· Make sure the devices can reach each other before you start the UDP jitter operation.

· Configure Router B as the NQA server before you start the UDP jitter operation.

· You cannot modify the operation configuration for a running NQA operation.

Procedures

Configuring Router B

# Enable the NQA server.

<RouterB> system-view

[RouterB] nqa server enable

# Configure a UDP listening service to listen on the IP address 10.2.2.2 and UDP port 9000.

[RouterB] nqa server udp-echo 10.2.2.2 9000

Configuring Router A

# Create a UDP jitter operation.

<RouterA> system-view

[RouterA] nqa entry admin test

[RouterA-nqa-admin-test] type udp-jitter

# Configure 10.2.2.2 as the destination IP address and port 9000 as the destination port.

[RouterA-nqa-admin-test-udp-jitter] destination ip 10.2.2.2

[RouterA-nqa-admin-test-udp-jitter] destination port 9000

# Configure the operation to repeat at an interval of 1000 milliseconds.

[RouterA-nqa-admin-test-udp-jitter] frequency 1000

[RouterA-nqa-admin-test-udp-jitter] quit

Verifying the configuration

# Start the UDP jitter operation.

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

# Stop the UDP jitter operation after the operation runs for a time period, for example, 30 seconds.

[RouterA] undo nqa schedule admin test

# Display the most recent result of the UDP jitter operation.

[RouterA] display nqa result admin test

NQA entry (admin admin, tag test) test results:

Send operation times: 10 Receive response times: 10

Min/Max/Average round trip time: 1/1/1

Square-Sum of round trip time: 10

Last packet received time: 2021-07-30 09:46:36.9

Extended results:

Packet loss ratio: 0%

Failures due to timeout: 0

Failures due to internal error: 0

Failures due to other errors: 0

Packets out of sequence: 0

Packets arrived late: 0

UDP-jitter results:

RTT number: 10

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: 1 Positive DS average: 0

Positive SD square-sum: 1 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 average: 0 DS average: 0

One way results:

Max SD delay: 0 Max DS delay: 0

Min SD delay: 0 Min DS delay: 0

Number of SD delay: 0 Number of DS delay: 0

Sum of SD delay: 0 Sum of DS delay: 0

Square-Sum of SD delay: 0 Square-Sum of DS delay: 0

SD lost packets: 0 DS lost packets: 0

Lost packets for unknown reason: 0

# Display the statistics of the UDP jitter operation.

[RouterA] display nqa statistics admin test

NQA entry (admin admin, tag test) test statistics:

NO. : 1

Start time: 2021-07-30 09:46:22.7

Life time: 14 seconds

Send operation times: 150 Receive response times: 150

Min/Max/Average round trip time: 1/4/1

Square-Sum of round trip time: 165

Extended results:

Packet loss ratio: 0%

Failures due to timeout: 0

Failures due to internal error: 0

Failures due to other errors: 0

Packets out of sequence: 0

Packets arrived late: 0

UDP-jitter results:

RTT number: 150

Min positive SD: 1 Min positive DS: 1

Max positive SD: 6 Max positive DS: 1

Positive SD number: 11 Positive DS number: 5

Positive SD sum: 16 Positive DS sum: 5

Positive SD average: 1 Positive DS average: 1

Positive SD square-sum: 46 Positive DS square-sum: 5

Min negative SD: 5 Min negative DS: 1

Max negative SD: 5 Max negative DS: 1

Negative SD number: 1 Negative DS number: 1

Negative SD sum: 5 Negative DS sum: 1

Negative SD average: 5 Negative DS average: 1

Negative SD square-sum: 25 Negative DS square-sum: 1

SD average: 0 DS average: 0

One way results:

Max SD delay: 0 Max DS delay: 0

Min SD delay: 0 Min DS delay: 0

Number of SD delay: 0 Number of DS delay: 0

Sum of SD delay: 0 Sum of DS delay: 0

Square-Sum of SD delay: 0 Square-Sum of DS delay: 0

SD lost packets: 0 DS lost packets: 0

Lost packets for unknown reason: 0

Configuration files

· Router B:

nqa server enable

nqa server udp-echo 10.2.2.2 9000

· Router A:

nqa entry admin test

type udp-jitter

destination ip 10.2.2.2

destination port 9000

frequency 1000

Example: Configuring an SNMP operation

Network configuration

As shown in Figure 6, configure an SNMP operation to test the time the NQA client uses to get a response from the SNMP agent.

Figure 6 Network diagram

Restrictions and guidelines

When you configure an SNMP operation, follow these restrictions and guidelines:

· Make sure the devices can reach each other before you start the SNMP operation.

· Configure Router B as the SNMP agent before you start the SNMP operation.

· You cannot modify the operation configuration for a running NQA operation.

Procedures

Configuring Router B

# Set the SNMP version to all.

<RouterB> system-view

[RouterB] snmp-agent

[RouterB] snmp-agent sys-info version all

# Set the read community to public.

[RouterB] snmp-agent community read public

# Set the write community to private.

[RouterB] snmp-agent community write private

Configuring Router A

# Create an SNMP operation.

<RouterA> system-view

[RouterA] nqa entry admin test

[RouterA-nqa-admin-test] type snmp

# Configure 10.2.2.2 as the destination IP address of the SNMP operation.

[RouterA-nqa-admin-test-snmp] destination ip 10.2.2.2

# Enable the saving of history records.

[RouterA-nqa-admin-test-snmp] history-record enable

[RouterA-nqa-admin-test-snmp] quit

Verifying the configuration

# Start the SNMP operation.

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

# Stop the SNMP operation after the operation runs for a time period, for example, 30 seconds.

[RouterA] undo nqa schedule admin test

# Display the most recent result of the SNMP operation.

[RouterA] display nqa result admin test

NQA entry (admin admin, tag test) test results:

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 probe time: 2021-07-30 10:07:28.2

Extended results:

Packet loss ratio: 0%

Failures due to timeout: 0

Failures due to internal error: 0

Failures due to other errors: 0

# Display the history records of the SNMP operation.

[RouterA] display nqa history admin test

NQA entry (admin admin, tag test) history records:

Index Response Status Time

1 1 Succeeded 2021-07-30 10:07:28.2

Configuration files

· Router B:

snmp-agent

snmp-agent local-engineid 800063A20300E0FC123456

snmp-agent community read public

snmp-agent community write private

snmp-agent sys-info version all

· Router A:

nqa entry admin test

type snmp

destination ip 10.2.2.2

history-record enable

Example: Configuring a TCP operation

Network configuration

As shown in Figure 7, configure a TCP operation to test the time required for Router A and Router B to establish a TCP connection.

Figure 7 Network diagram

Restrictions and guidelines

When you configure a TCP operation, follow these restrictions and guidelines:

· Make sure the devices can reach each other before you start the TCP operation.

· Configure Router B as the NQA server before you start the TCP operation.

· You cannot modify the operation configuration for a running NQA operation.

Procedures

Configuring Router B

# Enable the NQA server.

<RouterB> system-view

[RouterB] nqa server enable

# Configure a TCP listening service to listen on the IP address 10.2.2.2 and TCP port 9000.

[RouterB] nqa server tcp-connect 10.2.2.2 9000

Configuring Router A

# Create a TCP operation.

<RouterA> system-view

[RouterA] nqa entry admin test

[RouterA-nqa-admin-test] type tcp

# Configure 10.2.2.2 as the destination IP address and port 9000 as the destination port.

[RouterA-nqa-admin-test-tcp] destination ip 10.2.2.2

[RouterA-nqa-admin-test-tcp] destination port 9000

# Enable the saving of history records.

[RouterA-nqa-admin-test-tcp] history-record enable

[RouterA-nqa-admin-test-tcp] quit

Verifying the configuration

# Start the TCP operation.

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

# Stop the TCP operation after the operation runs for a time period, for example, 30 seconds.

[RouterA] undo nqa schedule admin test

# Display the most recent result of the TCP operation.

[RouterA] display nqa result admin test

NQA entry (admin admin, tag test) test results:

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 probe time: 2021-07-30 10:37:29.5

Extended results:

Packet loss ratio: 0%

Failures due to timeout: 0

Failures due to disconnect: 0

Failures due to no connection: 0

Failures due to internal error: 0

Failures due to other errors: 0

# Display the history records of the TCP operation.

[RouterA] display nqa history admin test

NQA entry (admin admin, tag test) history records:

Index Response Status Time

1 1 Succeeded 2021-07-30 10:37:29.5

Configuration files

· Router B:

nqa server enable

nqa server tcp-connect 10.2.2.2 9000

· Router A:

nqa entry admin test

type tcp

destination ip 10.2.2.2

destination port 9000

history-record enable

Example: Configuring a UDP echo operation

Network configuration

As shown in Figure 8, configure a UDP echo operation to test the round-trip time between Router A and Router B. The destination port number is 8000.

Figure 8 Network diagram

Restrictions and guidelines

When you configure a UDP echo operation, follow these restrictions and guidelines:

· Make sure the devices can reach each other before you start the UDP echo operation.

· Configure Router B as the NQA server before you start the UDP echo operation.

· You cannot modify the operation configuration for a running NQA operation.

Procedures

Configuring Router B

# Enable the NQA server.

<RouterB> system-view

[RouterB] nqa server enable

# Configure a UDP listening service to listen on the IP address 10.2.2.2 and UDP port 8000.

[RouterB] nqa server udp-echo 10.2.2.2 8000

Configuring Router A

# Create a UDP echo operation.

<RouterA> system-view

[RouterA] nqa entry admin test

[RouterA-nqa-admin-test] type udp-echo

# Configure 10.2.2.2 as the destination IP address and port 8000 as the destination port.

[RouterA-nqa-admin-test-udp-echo] destination ip 10.2.2.2

[RouterA-nqa-admin-test-udp-echo] destination port 8000

# Enable the saving of history records.

[RouterA-nqa-admin-test-udp-echo] history-record enable

[RouterA-nqa-admin-test-udp-echo] quit

Verifying the configuration

# Start the UDP echo operation.

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

# Stop the UDP echo operation after the operation runs for a time period, for example, 30 seconds.

[RouterA] undo nqa schedule admin test

# Display the most recent result of the UDP echo operation.

[RouterA] display nqa result admin test

NQA entry (admin admin, tag test) test results:

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 probe time: 2021-07-30 11:10:35.2

Extended results:

Packet loss ratio: 0%

Failures due to timeout: 0

Failures due to internal error: 0

Failures due to other errors: 0

# Display the history records of the UDP echo operation.

[RouterA] display nqa history admin test

NQA entry (admin admin, tag test) history records:

Index Response Status Time

1 1 Succeeded 2021-07-30 11:10:35.2

Configuration files

· Router B:

nqa server enable

nqa server udp-echo 10.2.2.2 8000

· Router A:

nqa entry admin test

type udp-echo

destination ip 10.2.2.2

destination port 8000

history-record enable

02-Typical configuration example

Example: Configuring an ICMP echo operation

Network configuration

Restrictions and guidelines

Example: Configuring a DHCP operation

Restrictions and guidelines

Procedures

Example: Configuring an FTP operation

Network configuration

Restrictions and guidelines

Procedures

Example: Configuring an HTTP operation

Network configuration

Restrictions and guidelines

Procedures

Procedures

Procedures

Related documentation

Cloud & AI

InterConnect

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Contact Us