Network quality analyzer (NQA) allows you to measure network performance, verify the service levels for IP services and applications, and troubleshoot network problems.

An NQA operation contains a set of parameters such as the operation type, destination IP address, and port number to define how the operation is performed. Each NQA operation is identified by the combination of the administrator name and the operation tag. You can configure the NQA client to run the operations at scheduled time periods.

As shown in Figure 1, the NQA source device (NQA client) sends data to the NQA destination device by simulating IP services and applications to measure network performance.

All types of NQA operations require the NQA client, but only the TCP, UDP echo, UDP jitter, and voice operations require the NQA server. The NQA operations for services that are already provided by the destination device such as FTP do not need the NQA server. You can configure the NQA server to listen and respond to specific IP addresses and ports to meet various test needs.

Figure 1 Network diagram

‌

After starting an NQA operation, the NQA client periodically performs the operation at the interval specified by using the frequency command.

You can set the number of probes the NQA client performs in an operation by using the probe count command.

For the voice and path jitter operations, the NQA client performs only one probe per operation and the probe count command is not available.

Threshold monitoring

Threshold monitoring enables the NQA client to take a predefined action when the NQA operation performance metrics violate the specified thresholds.

Table 1 describes the relationships between performance metrics and NQA operation types.

Table 1 Performance metrics and NQA operation types

Performance metric	NQA operation types that can gather the metric
Probe duration	ARP, ICMP echo, DHCP, DNS, FTP, HTTP, TCP, UDP echo, and DLSw
Number of probe failures	ARP, ICMP echo, DHCP, DNS, FTP, HTTP, TCP, UDP echo, and DLSw
Round-trip time	ICMP jitter, UDP jitter, and voice
Number of discarded packets	ICMP jitter, UDP jitter, and voice
One-way jitter (source-to-destination or destination-to-source)	ICMP jitter, UDP jitter, and voice
One-way delay (source-to-destination or destination-to-source)	ICMP jitter, UDP jitter, and voice
Calculated Planning Impairment Factor (ICPIF) (see "Configuring the voice operation")	Voice
Mean Opinion Scores (MOS) (see "Configuring the voice operation")	Voice

‌

NQA templates

An NQA template is a set of parameters (such as destination address and port number) that defines how an NQA operation is performed. Features can use the NQA template to collect statistics.

You can create multiple NQA templates on the NQA client. Each template must be identified by a unique template name.

Restrictions and guidelines: NQA configuration

To avoid probe failures, follow these restrictions and guidelines when configuring the listening ports on the NQA client and NQA server:

· Do not specify a well-known port.

· Make sure the specified port number is not used by any services on the device.

¡ To obtain the IPv4 addresses and the port numbers in use on this device, see the Local Addr:port field in the output from the display tcp and display udp commands.

¡ To obtain the IPv6 addresses and the port numbers in use on this device, see the LAddr->port field in the output from the display ipv6 tcp and display ipv6 udp commands.

The destination port configured for the operation (with the destination port command) on the NQA client must be the same as the listening port configured on the server.

For latency operation results to be accurate, synchronize time between the source and the destination with an accuracy higher than or equal to the operation result calculation accuracy.

NQA tasks at a glance

To configure NQA, perform the following tasks:

1. Configuring the NQA server

Perform this task on the destination device before you configure the TCP, UDP echo, UDP jitter, and voice operations.

2. Enabling the NQA client

3. Configuring NQA operations or NQA templates

Choose the following tasks as needed:

¡ Configuring NQA operations on the NQA client

¡ Configuring NQA templates on the NQA client

After you configure an NQA operation, you can schedule the NQA client to run the NQA operation.

An NQA template does not run immediately after it is configured. The template creates and run the NQA operation only when it is required by the feature to which the template is applied.

Configuring the NQA server

Restrictions and guidelines

To perform TCP, UDP echo, UDP jitter, and voice operations, you must configure the NQA server on the destination device.

The NQA server listens and responds to requests on the specified IP addresses and ports.

You can configure multiple TCP or UDP listening services on an NQA server, where each corresponds to a specific IP address and port number.

The IP address and port number for a listening service must be unique on the NQA server and match the configuration on the NQA client.

Procedure

1. Enter system view.

system-view

2. Enable the NQA server.

nqa server enable

By default, the NQA server is disabled.

3. Configure a TCP listening service.

nqa server tcp-connect { ipv4-address | ipv6 ipv6-address } port-number [ tos tos ]

This task is required for only TCP and DLSw operations. For the DLSw operation, the port number for the TCP listening service must be 2065.

4. Configure a UDP listening service.

¡ Configure a UDP listening service.

nqa server udp-echo { ipv4-address | ipv6 ipv6-address } port-number [ high-performance-mode ] [ tos tos ]

This task is required for only UDP echo, UDP jitter, and voice operations.

Enabling the NQA client

1. Enter system view.

system-view

2. Enable the NQA client.

nqa agent enable

By default, the NQA client is enabled.

The NQA client configuration takes effect after you enable the NQA client.

Configuring NQA operations on the NQA client

NQA operations tasks at a glance

To configure NQA operations, perform the following tasks:

1. Configuring an NQA operation

¡ Configuring the ARP operation

¡ Configuring the ICMP echo operation

¡ Configuring the ICMP jitter operation

¡ Configuring the DHCP operation

¡ Configuring the DNS operation

¡ Configuring the FTP operation

¡ Configuring the HTTP operation

¡ Configuring the UDP jitter operation

¡ Configuring the TCP operation

¡ Configuring the UDP echo operation

¡ Configuring the UDP tracert operation

¡ Configuring the voice operation

¡ Configuring the DLSw operation

¡ Configuring the path jitter operation

2. (Optional.) Configuring optional parameters for the NQA operation

3. (Optional.) Configuring threshold monitoring

4. (Optional.) Configuring the NQA statistics collection feature

5. (Optional.) Configuring the saving of NQA history records

6. Scheduling the NQA operation on the NQA client

Configuring the ARP operation

About this task

The ARP operation tests if the ARP service is available on the destination device.

The ARP operation sends an ARP request to the destination device per probe.

Procedure

1. Enter system view.

system-view

2. Create an NQA operation and enter NQA operation view.

nqa entry admin-name operation-tag

3. Specify the ARP type and enter its view.

type arp

4. Specify the destination IP address for ARP requests.

destination ip ip-address

By default, no destination IP address is specified.

5. Specify the source address for ARP requests.

source ip ip-address

By default, the source IP address of ICMP echo requests is the primary IP address of their output interface.

The specified source interface must be up.

Configuring the ICMP echo operation

About this task

The ICMP echo operation measures the reachability of a destination device. It has the same function as the ping command, but provides more output information. In addition, if multiple paths exist between the source and destination devices, you can specify the next hop for the ICMP echo operation.

The ICMP echo operation sends an ICMP echo request to the destination device per probe.

Procedure

1. Enter system view.

system-view

2. Create an NQA operation and enter NQA operation view.

nqa entry admin-name operation-tag

3. Specify the ICMP echo type and enter its view.

type icmp-echo

4. Specify the destination IP address for ICMP echo requests. Choose one option as needed:

¡ Specify the destination IP address for ICMP echo requests.

IPv4:

destination ip ip-address

IPv6:

destination ipv6 ipv6-address

By default, no destination IP address is specified.

¡ Specify the destination URL for the ICMP echo operation.

url url

By default, no destination URL is specified for an ICMP echo operation.

The URL is in the format of protocol://host:port, for example, http://host:port. The host parameter is required, and the protocol and port parameters can be unspecified or be any value.

5. Specify the source address for ICMP echo requests. Choose one option as needed:

¡ Use the IP address of the specified interface as the source IP address.

source interface interface-type interface-number

By default, the source IP address of ICMP echo requests is the primary IP address of their output interface.

The specified source interface must be up.

¡ Specify the source IPv4 address.

source ip ip-address

By default, the source IPv4 address of ICMP echo requests is the primary IPv4 address of their output interface.

The specified source IPv4 address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

¡ Specify the source IPv6 address.

source ipv6 ipv6-address

By default, the source IPv6 address of ICMP echo requests is the IPv6 address of their output interface.

The specified source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

6. Specify the output interface or the next hop IP address for ICMP echo requests. Choose one option as needed:

¡ Specify the output interface.

out interface interface-type interface-number

By default, the output interface is not specified. The NQA client determines the output interface based on the routing table lookup.

¡ Specify the next hop IPv4 address.

next-hop ip ip-address

By default, no next hop IPv4 address is specified.

¡ Specify the next hop IPv6 address.

next-hop ipv6 ipv6-address

By default, no next hop IPv6 address is specified.

7. (Optional.) Set the payload size for each ICMP echo request.

data-size size

The default payload size is 100 bytes.

8. (Optional.) Specify the payload fill string for ICMP echo requests.

data-fill string

The default payload fill string is the hexadecimal string 00010203040506070809.

Configuring the ICMP jitter operation

About this task

The ICMP jitter operation measures unidirectional and bidirectional jitters. The operation result helps you to determine whether the network can carry jitter-sensitive services such as real-time voice and video services.

The ICMP jitter operation works as follows:

1. The NQA client sends ICMP packets to the destination device.

2. The destination device time stamps each packet it receives, and then sends the packet back to the NQA client.

3. Upon receiving the responses, the NQA client calculates the jitter according to the timestamps.

The ICMP jitter operation sends a number of ICMP packets to the destination device per probe. The number of packets to send is determined by using the probe packet-number command.

Restrictions and guidelines

The display nqa history command does not display the results or statistics of the ICMP jitter operation. To view the results or statistics of the operation, use the display nqa result or display nqa statistics command.

Before starting the operation, make sure the network devices are time synchronized by using NTP. For more information about NTP, see System Management Configuration Guide.

Procedure

1. Enter system view.

system-view

2. Create an NQA operation and enter NQA operation view.

nqa entry admin-name operation-tag

3. Specify the ICMP jitter type and enter its view.

type icmp-jitter

4. Specify the destination IP address for ICMP packets.

destination ip ip-address

By default, no destination IP address is specified.

5. Set the number of ICMP packets sent per probe.

probe packet-number number

The default setting is 10.

6. Set the interval for sending ICMP packets.

probe packet-interval interval

The default setting is 20 milliseconds.

7. Specify how long the NQA client waits for a response from the server before it regards the response times out.

probe packet-timeout timeout

The default setting is 3000 milliseconds.

8. Specify the source IP address for ICMP packets.

source ip ip-address

By default, the source IP address of ICMP packets is the primary IP address of their output interface.

The source IP address must be the IP address of a local interface, and the interface must be up. Otherwise, no ICMP packets can be sent out.

Configuring the DHCP operation

About this task

The DHCP operation measures whether or not the DHCP server can respond to client requests. DHCP also measures the amount of time it takes the NQA client to obtain an IP address from a DHCP server.

The NQA client simulates the DHCP relay agent to forward DHCP requests for IP address acquisition from the DHCP server. The interface that performs the DHCP operation does not change its IP address. When the DHCP operation completes, the NQA client sends a packet to release the obtained IP address.

The DHCP operation acquires an IP address from the DHCP server per probe.

Procedure

1. Enter system view.

system-view

2. Create an NQA operation and enter NQA operation view.

nqa entry admin-name operation-tag

3. Specify the DHCP type and enter its view.

type dhcp

4. Specify the IP address of the DHCP server as the destination IP address of DHCP packets.

destination ip ip-address

By default, no destination IP address is specified.

5. Specify the output interface for DHCP request packets.

out interface interface-type interface-number

By default, the NQA client determines the output interface based on the routing table lookup.

6. Specify the source IP address of DHCP request packets.

source ip ip-address

By default, the source IP address of DHCP request packets is the primary IP address of their output interface.

The specified source IP address must be the IP address of a local interface, and the local interface must be up. Otherwise, no probe packets can be sent out.

Configuring the DNS operation

About this task

The DNS operation simulates domain name resolution, and it measures the time for the NQA client to resolve a domain name into an IP address through a DNS server. The obtained DNS entry is not saved.

The DNS operation resolves a domain name into an IP address per probe.

Procedure

1. Enter system view.

system-view

2. Create an NQA operation and enter NQA operation view.

nqa entry admin-name operation-tag

3. Specify the DNS type and enter its view.

type dns

4. Specify the IP address of the DNS server as the destination IP address of DNS packets.

destination ip ip-address

By default, no destination IP address is specified.

5. Specify the domain name to be translated.

resolve-target domain-name

By default, no domain name is specified.

Configuring the FTP operation

About this task

The FTP operation measures the time for the NQA client to transfer a file to or download a file from an FTP server.

The FTP operation uploads or downloads a file from an FTP server per probe.

Restrictions and guidelines

To upload (put) a file to the FTP server, use the filename command to specify the name of the file you want to upload. The file must exist on the NQA client.

To download (get) a file from the FTP server, include the name of the file you want to download in the url command. The file must exist on the FTP server. The NQA client does not save the file obtained from the FTP server.

Use a small file for the FTP operation. A big file might result in transfer failure because of timeout, or might affect other services because of the amount of network bandwidth it occupies.

Procedure

1. Enter system view.

system-view

2. Create an NQA operation and enter NQA operation view.

nqa entry admin-name operation-tag

3. Specify the FTP type and enter its view.

type ftp

4. Specify an FTP login username.

username username

By default, no FTP login username is specified.

5. Specify an FTP login password.

password { cipher | simple } string

By default, no FTP login password is specified.

6. Specify the source IP address for FTP request packets.

source ip ip-address

By default, the source IP address of FTP request packets is the primary IP address of their output interface.

The source IP address must be the IP address of a local interface, and the interface must be up. Otherwise, no FTP requests can be sent out.

7. Set the data transmission mode.

mode { active | passive }

The default mode is active.

8. Specify the FTP operation type.

operation { get | put }

The default FTP operation type is get.

9. Specify the destination URL for the FTP operation.

url url

By default, no destination URL is specified for an FTP operation.

Enter the URL in one of the following formats:

¡ ftp://host/filename.

¡ ftp://host:port/filename.

The filename argument is required only for the get operation.

10. Specify the name of the file to be uploaded.

filename file-name

By default, no file is specified.

This step is required only for the put operation.

The configuration does not take effect for the get operation.

Configuring the HTTP operation

About this task

The HTTP operation measures the time for the NQA client to obtain responses from an HTTP server.

The HTTP operation supports the following operation types:

· Get—Retrieves data such as a Web page from the HTTP server.

· Post—Sends data to the HTTP server for processing.

· Raw—Sends a user-defined HTTP request to the HTTP server. You must manually configure the content of the HTTP request to be sent.

The HTTP operation completes the operation of the specified type per probe.

Procedure

1. Enter system view.

system-view

2. Create an NQA operation and enter NQA operation view.

nqa entry admin-name operation-tag

3. Specify the HTTP type and enter its view.

type http

4. Specify the destination URL for the HTTP operation.

url url

By default, no destination URL is specified for an HTTP operation.

Enter the URL in one of the following formats:

¡ http://host/resource

¡ http://host:port/resource

5. Specify an HTTP login username.

username username

By default, no HTTP login username is specified.

6. Specify an HTTP login password.

password { cipher | simple } string

By default, no HTTP login password is specified.

7. Specify the HTTP version.

version { v1.0 | v1.1 }

By default, HTTP 1.0 is used.

8. Specify the HTTP operation type.

operation { get | post | raw }

The default HTTP operation type is get.

If you set the operation type to raw, the client pads the content configured in raw request view to the HTTP request to send to the HTTP server.

9. Configure the HTTP raw request.

a. Enter raw request view.

raw-request

Every time you enter raw request view, the previously configured raw request content is cleared.

b. Enter or paste the request content.

By default, no request content is configured.

For successful HTTP operations, make sure the raw request content is valid and does not contain command aliases configured by using the alias command. For more information about the alias command, see CLI commands in Fundamentals Command Reference.

c. Save the input and return to HTTP operation view.

quit

This step is required only when the operation type is set to raw.

10. Specify the source IP address for the HTTP packets.

source ip ip-address

By default, the source IP address of HTTP packets is the primary IP address of their output interface.

The source IP address must be the IP address of a local interface, and the interface must be up. Otherwise, no HTTP packets can be sent out.

11. Specify an output interface for HTTP packets.

out interface interface-type interface-number

By default, the NQA client determines the output interface based on the routing table lookup.

Configuring the UDP jitter operation

About this task

The UDP jitter operation measures unidirectional and bidirectional jitters. The operation result helps you determine whether the network can carry jitter-sensitive services such as real-time voice and video services.

The UDP jitter operation works as follows:

1. The NQA client sends UDP packets to the destination port.

2. The destination device time stamps each packet it receives, and then sends the packet back to the NQA client.

3. Upon receiving the responses, the NQA client calculates the jitter according to the timestamps.

The UDP jitter operation sends a number of UDP packets to the destination device per probe. The number of packets to send is determined by using the probe packet-number command.

The UDP jitter operation requires both the NQA server and the NQA client. Before you perform the UDP jitter operation, configure the UDP listening service on the NQA server. For more information about UDP listening service configuration, see "Configuring the NQA server."

Restrictions and guidelines

To ensure successful UDP jitter operations and avoid affecting existing services, do not perform the operations on well-known ports from 1 to 1023.

The display nqa history command does not display the results or statistics of the UDP jitter operation. To view the results or statistics of the UDP jitter operation, use the display nqa result or display nqa statistics command.

Before starting the operation, make sure the network devices are time synchronized by using NTP. For more information about NTP, see System Management Configuration Guide.

If you want to enable high performance mode for all UDP jitter operations on the device, use the nqa agent udp-jitter high-performance enable command in system view.

Procedure

1. Enter system view.

system-view

2. Create an NQA operation and enter NQA operation view.

nqa entry admin-name operation-tag

3. Specify the UDP jitter type and enter its view.

type udp-jitter

4. Specify the destination IP address and destination port number for UDP packets. Choose one option as needed:

¡ Specify the destination IP address and destination port number for UDP jitter requests.

destination port port-number

By default, no destination port number is specified.

The destination port number must be the same as the port number of the UDP listening service on the NQA server.

IPv4:

destination ip ip-address

By default, no destination IPv4 address is specified.

The destination IPv4 address must be the same as the IP address of the UDP listening service configured on the NQA server.

IPv6:

destination ipv6 ipv6-address

By default, no destination IPv6 address is specified.

The destination IPv6 address must be the same as the IPv6 address of the UDP listening service configured on the NQA server.

¡ Specify the destination URL for the UDP jitter operation.

url url

By default, no destination URL is specified for a UDP jitter operation.

The URL is in the format of protocol://host:port, for example, http://host:port. The host and port parameters are required, and the protocol parameter can be unspecified or any value.

5. Specify the source IP address for UDP packets.

IPv4:

source ip ip-address

By default, the source IPv4 address of UDP packets is the primary IPv4 address of their output interface.

The source IPv4 address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no UDP packets can be sent out.

IPv6:

source ipv6 ipv6-address

By default, the source IPv6 address of UDP packets is the IPv6 address of their output interface.

The source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no UDP packets can be sent out.

6. Specify the source port number for UDP packets.

source port port-number

By default, the NQA client randomly picks an unused port as the source port when the operation starts.

For the operation to succeed, make sure the specified port number is not used by any services on the device. As a best practice, use the default value.

7. Specify an output interface for UDP packets.

out interface interface-type interface-number

By default, the NQA client determines the output interface based on the routing table lookup.

8. Set the number of UDP packets sent per probe.

probe packet-number number

The default setting is 10.

9. Set the interval for sending UDP packets.

probe packet-interval interval

The default setting is 20 milliseconds.

10. Specify how long the NQA client waits for a response from the server before it regards the response times out.

probe packet-timeout timeout

The default setting is 3000 milliseconds.

11. (Optional.) Set the payload size for each UDP packet.

data-size size

The default payload size is 100 bytes.

12. (Optional.) Specify the payload fill string for UDP packets.

data-fill string

The default payload fill string is the hexadecimal string 00010203040506070809.

Configuring the TCP operation

About this task

The TCP operation measures the time for the NQA client to establish a TCP connection to a port on the NQA server.

The TCP operation requires both the NQA server and the NQA client. Before you perform a TCP operation, configure a TCP listening service on the NQA server. For more information about the TCP listening service configuration, see "Configuring the NQA server."

The TCP operation sets up a TCP connection per probe.

Procedure

1. Enter system view.

system-view

2. Create an NQA operation and enter NQA operation view.

nqa entry admin-name operation-tag

3. Specify the TCP type and enter its view.

type tcp

4. Specify the destination address for TCP packets.

IPv4:

destination ip ip-address

By default, no destination IPv4 address is specified.

The destination IPv4 address must be the same as the IPv4 address of the TCP listening service configured on the NQA server.

IPv6:

destination ipv6 ipv6-address

By default, no destination IPv6 address is specified.

The destination IPv6 address must be the same as the IPv6 address of the TCP listening service configured on the NQA server.

5. Specify the destination port number for TCP packets.

destination port port-number

By default, no destination port number is configured.

The destination port number must be the same as the port number of the listening service on the NQA server.

6. Specify the source IP address for TCP packets.

IPv4:

source ip ip-address

By default, the source IPv4 address of TCP packets is the primary IPv4 address of their output interface.

The source IPv4 address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no TCP packets can be sent out.

IPv6:

source ipv6 ipv6-address

By default, the source IPv6 address of TCP packets is the IPv6 address of their output interface.

The source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no TCP packets can be sent out.

Configuring the UDP echo operation

About this task

The UDP echo operation measures the round-trip time between the client and a UDP port on the NQA server.

The UDP echo operation requires both the NQA server and the NQA client. Before you perform a UDP echo operation, configure a UDP listening service on the NQA server. For more information about the UDP listening service configuration, see "Configuring the NQA server."

The UDP echo operation sends a UDP packet to the destination device per probe.

Procedure

1. Enter system view.

system-view

2. Create an NQA operation and enter NQA operation view.

nqa entry admin-name operation-tag

3. Specify the UDP echo type and enter its view.

type udp-echo

4. Specify the destination address for UDP packets.

IPv4:

destination ip ip-address

By default, no destination IPv4 address is specified.

The destination IPv4 address must be the same as the IPv4 address of the UDP listening service configured on the NQA server.

IPv6:

destination ipv6 ipv6-address

By default, no destination IPv6 address is specified.

The destination IPv6 address must be the same as the IPv6 address of the UDP listening service configured on the NQA server.

5. Specify the destination port number for UDP packets.

destination port port-number

By default, no destination port number is specified.

The destination port number must be the same as the port number of the listening service on the NQA server.

6. Specify the source IP address for UDP packets.

IPv4:

source ip ip-address

By default, the source IPv4 address of UDP packets is the primary IPv4 address of their output interface.

The source IPv4 address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no UDP packets can be sent out.

IPv6:

source ipv6 ipv6-address

By default, the source IPv6 address of UDP packets is the IPv6 address of their output interface.

The source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no UDP packets can be sent out.

7. Specify the source port number for UDP packets.

source port port-number

By default, the NQA client randomly picks an unused port as the source port when the operation starts.

For the operation to succeed, make sure the specified port number is not used by any services on the device. As a best practice, use the default value.

8. (Optional.) Set the payload size for each UDP packet.

data-size size

The default setting is 100 bytes.

9. (Optional.) Specify the payload fill string for UDP packets.

data-fill string

The default payload fill string is the hexadecimal string 00010203040506070809.

Configuring the UDP tracert operation

About this task

The UDP tracert operation determines the routing path from the source device to the destination device.

The UDP tracert operation sends a UDP packet to a hop along the path per probe.

Restrictions and guidelines

The UDP tracert operation is not supported on IPv6 networks. To determine the routing path that the IPv6 packets traverse from the source to the destination, use the tracert ipv6 command. For more information about the command, see Network Management and Monitoring Command Reference.

Prerequisites

Before you configure the UDP tracert operation, you must perform the following tasks:

· Enable sending ICMP time exceeded messages on the intermediate devices between the source and destination devices. If the intermediate devices are H3C devices, use the ip ttl-expires enable command.

· Enable sending ICMP destination unreachable messages on the destination device. If the destination device is an H3C device, use the ip unreachables enable command.

For more information about the ip ttl-expires enable and ip unreachables enable commands, see Network Connectivity Command Reference.

Procedure

1. Enter system view.

system-view

2. Create an NQA operation and enter NQA operation view.

nqa entry admin-name operation-tag

3. Specify the UDP tracert operation type and enter its view.

type udp-tracert

4. Specify the destination IP address for the UDP packets.

destination ip ip-address

By default, no destination IP address is specified.

5. Specify the destination port number for the UDP packets.

destination port port-number

By default, the destination port number is 33434.

The specified port number must be an unused port number on the destination device, so the destination device can reply with an ICMP port unreachable message.

6. Specify an output interface for UDP packets.

out interface interface-type interface-number

By default, the NQA client determines the output interface based on the routing table lookup.

7. Specify the source IP address for UDP packets.

¡ Specify the IP address of the specified interface as the source IP address.

source interface interface-type interface-number

By default, the source IP address of UDP packets is the primary IP address of their output interface.

¡ Specify the source IP address.

source ip ip-address

The specified source interface must be up. The source IP address must be the IP address of a local interface, and the local interface must be up. Otherwise, no probe packets can be sent out.

8. Specify the source port number for UDP packets.

source port port-number

By default, the NQA client randomly picks an unused port as the source port when the operation starts.

For the operation to succeed, make sure the specified port number is not used by any services on the device. As a best practice, use the default value.

9. Set the maximum number of consecutive probe failures.

max-failure times

The default setting is 5.

10. Set the initial TTL value for UDP packets.

init-ttl value

The default setting is 1.

11. (Optional.) Set the payload size for each UDP packet.

data-size size

The default setting is 100 bytes.

12. (Optional.) Enable the no-fragmentation feature.

no-fragment enable

By default, the no-fragmentation feature is disabled.

Configuring the voice operation

About this task

The voice operation measures VoIP network performance.

The voice operation works as follows:

1. The NQA client sends voice packets at sending intervals to the destination device (NQA server).

The voice packets are of one of the following codec types:

¡ G.711 A-law.

¡ G.711 µ-law.

¡ G.729 A-law.

2. The destination device time stamps each voice packet it receives and sends it back to the source.

3. Upon receiving the packet, the source device calculates the jitter and one-way delay based on the timestamp.

The voice operation sends a number of voice packets to the destination device per probe. The number of packets to send per probe is determined by using the probe packet-number command.

The following parameters that reflect VoIP network performance can be calculated by using the metrics gathered by the voice operation:

· Calculated Planning Impairment Factor (ICPIF)—Measures impairment to voice quality on a VoIP network. It is decided by packet loss and delay. A higher value represents a lower service quality.

· Mean Opinion Scores (MOS)—A MOS value can be evaluated by using the ICPIF value, in the range of 1 to 5. A higher value represents a higher service quality.

The evaluation of voice quality depends on users' tolerance for voice quality. For users with higher tolerance for voice quality, use the advantage-factor command to set an advantage factor. When the system calculates the ICPIF value, it subtracts the advantage factor to modify ICPIF and MOS values for voice quality evaluation.

The voice operation requires both the NQA server and the NQA client. Before you perform a voice operation, configure a UDP listening service on the NQA server. For more information about UDP listening service configuration, see "Configuring the NQA server."

Restrictions and guidelines

To ensure successful voice operations and avoid affecting existing services, do not perform the operations on well-known ports from 1 to 1023.

The display nqa history command does not display the results or statistics of the voice operation. To view the results or statistics of the voice operation, use the display nqa result or display nqa statistics command.

Before starting the operation, make sure the network devices are time synchronized by using NTP. For more information about NTP, see System Management Configuration Guide.

Procedure

1. Enter system view.

system-view

2. Create an NQA operation and enter NQA operation view.

nqa entry admin-name operation-tag

3. Specify the voice type and enter its view.

type voice

4. Specify the destination IP address for voice packets.

destination ip ip-address

By default, no destination IP address is configured.

The destination IP address must be the same as the IP address of the UDP listening service on the NQA server.

5. Specify the destination port number for voice packets.

destination port port-number

By default, no destination port number is configured.

The destination port number must be the same as the port number of the listening service on the NQA server.

6. Specify the source IP address for voice packets.

source ip ip-address

By default, the source IP address of voice packets is the primary IP address of their output interface.

The source IP address must be the IP address of a local interface, and the interface must be up. Otherwise, no voice packets can be sent out.

7. Specify the source port number for voice packets.

source port port-number

By default, the NQA client randomly picks an unused port as the source port when the operation starts.

For the operation to succeed, make sure the specified port number is not used by any services on the device. As a best practice, use the default value.

8. Configure the basic voice operation parameters.

¡ Specify the codec type.

codec-type { g711a | g711u | g729a }

By default, the codec type is G.711 A-law.

¡ Set the advantage factor for calculating MOS and ICPIF values.

advantage-factor factor

By default, the advantage factor is 0.

9. Configure the probe parameters for the voice operation.

¡ Set the number of voice packets to be sent per probe.

probe packet-number number

The default setting is 1000.

¡ Set the interval for sending voice packets.

probe packet-interval interval

The default setting is 20 milliseconds.

¡ Specify how long the NQA client waits for a response from the server before it regards the response times out.

probe packet-timeout timeout

The default setting is 5000 milliseconds.

10. Configure the payload parameters.

a. Set the payload size.

data-size size

For the G.711A-law and G.711 µ-law codec types, the default payload size is 172 bytes.

For the G.729 A-law codec type, the default payload size is 32 bytes.

b. (Optional.) Specify the payload fill string for voice packets.

data-fill string

The default payload fill string is the hexadecimal string 00010203040506070809.

Configuring the DLSw operation

About this task

The DLSw operation measures the response time of a DLSw device.

It sets up a DLSw connection to the DLSw device per probe.

Restrictions and guidelines

For the successful DLSw operation, configure the nqa server tcp-connect command on the NQA server and make sure the port number for the TCP listening service is 2065.

Procedure

1. Enter system view.

system-view

2. Create an NQA operation and enter NQA operation view.

nqa entry admin-name operation-tag

3. Specify the DLSw type and enter its view.

type dlsw

4. Specify the destination IP address for the probe packets.

destination ip ip-address

By default, no destination IP address is specified.

5. Specify the source IP address for the probe packets.

source ip ip-address

By default, the source IP address of the probe packets is the primary IP address of their output interface.

The source IP address must be the IP address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

Configuring the path jitter operation

About this task

The path jitter operation measures the jitter, negative jitters, and positive jitters from the NQA client to each hop on the path to the destination.

The path jitter operation performs the following steps per probe:

1. Obtains the path from the NQA client to the destination through tracert. A maximum of 64 hops can be detected.

2. Sends a number of ICMP echo requests to each hop along the path. The number of ICMP echo requests to send is set by using the probe packet-number command.

Prerequisites

Before you configure the path jitter operation, you must perform the following tasks:

· Enable sending ICMP destination unreachable messages on the destination device. If the destination device is an H3C device, use the ip unreachables enable command.

For more information about the ip ttl-expires enable and ip unreachables enable commands, see Network Connectivity Command Reference.

Procedure

1. Enter system view.

system-view

2. Create an NQA operation and enter NQA operation view.

nqa entry admin-name operation-tag

3. Specify the path jitter type and enter its view.

type path-jitter

4. Specify the destination IP address for ICMP echo requests.

destination ip ip-address

By default, no destination IP address is specified.

5. Specify the source IP address for ICMP echo requests.

source ip ip-address

By default, the source IP address of ICMP echo requests is the primary IP address of their output interface.

The source IP address must be the IP address of a local interface, and the interface must be up. Otherwise, no ICMP echo requests can be sent out.

6. Configure the probe parameters for the path jitter operation.

a. Set the number of ICMP echo requests to be sent per probe.

probe packet-number number

The default setting is 10.

b. Set the interval for sending ICMP echo requests.

probe packet-interval interval

The default setting is 20 milliseconds.

c. Specify how long the NQA client waits for a response from the server before it regards the response times out.

probe packet-timeout timeout

The default setting is 3000 milliseconds.

7. (Optional.) Specify an LSR path.

lsr-path ip-address&<1-8>

By default, no LSR path is specified.

The path jitter operation uses tracert to detect the LSR path to the destination, and sends ICMP echo requests to each hop on the LSR path.

8. Configure the NQA client to perform the path jitter operation only on the destination address.

target-only

By default, the path jitter operation is performed on each hop on the path to the destination.

9. (Optional.) Set the payload size for each ICMP echo request.

data-size size

The default setting is 100 bytes.

10. (Optional.) Specify the payload fill string for ICMP echo requests.

data-fill string

The default payload fill string is the hexadecimal string 00010203040506070809.

Configuring optional parameters for the NQA operation

Restrictions and guidelines

The parameter settings take effect only on the current operation.

The supported parameters vary by NQA operation type. For information about supported parameters, see NQA commands in Network Management and Monitoring Command Reference.

Network Connectivity

Procedure

1. Enter system view.

system-view

2. Enter the view of an existing NQA operation.

nqa entry admin-name operation-tag

3. Specify an NQA operation type and enter its view.

type { arp | dhcp | dlsw | dns | | ftp | http | icmp-echo | icmp-jitter | path-jitter | tcp | udp-echo | udp-jitter | udp-tracert | voice }

4. Configure a description for the operation.

description text

By default, no description is configured.

5. Set the interval at which the NQA operation repeats.

frequency interval

For a voice or path jitter operation, the default setting is 60000 milliseconds.

For other types of operations, the default setting is 0 milliseconds, and only one operation is performed.

When the interval expires, but the operation is not completed or is not timed out, the next operation does not start.

6. Specify the probe times.

probe count times

In an UDP tracert operation, the NQA client performs three probes to each hop to the destination by default.

In other types of operations, the NQA client performs one probe to the destination per operation by default.

This command is not available for the voice and path jitter operations. Each of these operations performs only one probe.

7. Set the probe timeout time.

probe timeout timeout

The default setting is 3000 milliseconds.

8. Set the maximum number of hops that the probe packets can traverse.

ttl value

The default setting is 30 for probe packets of the UDP tracert operation, and is 20 for probe packets of other types of operations.

9. Set the ToS value in the IP header of the probe packets.

tos value

The default setting is 0.

10. Enable the routing table bypass feature.

route-option bypass-route

By default, the routing table bypass feature is disabled.

This command does not take effect if the destination address of the NQA operation is an IPv6 address.

Configuring threshold monitoring

About this task

This feature allows you to monitor the NQA operation running status.

An NQA operation supports the following threshold types:

· average—If the average value for the monitored performance metric either exceeds the upper threshold or goes below the lower threshold, a threshold violation occurs.

· accumulate—If the total number of times that the monitored performance metric is out of the specified value range reaches or exceeds the specified threshold, a threshold violation occurs.

· consecutive—If the number of consecutive times that the monitored performance metric is out of the specified value range reaches or exceeds the specified threshold, a threshold violation occurs.

Threshold violations for the average or accumulate threshold type are determined on a per NQA operation basis. The threshold violations for the consecutive type are determined from the time the NQA operation starts.

The following actions might be triggered:

· none—NQA displays results only on the terminal screen. It does not send traps to the NMS.

· trap-only—NQA displays results on the terminal screen, and meanwhile it sends traps to the NMS.

· trigger-only—NQA displays results on the terminal screen, and meanwhile triggers other modules for collaboration.

In a reaction entry, configure a monitored element, a threshold type, and an action to be triggered to implement threshold monitoring.

The state of a reaction entry can be invalid, over-threshold, or below-threshold.

· Before an NQA operation starts, the reaction entry is in invalid state.

· If the threshold is violated, the state of the entry is set to over-threshold. Otherwise, the state of the entry is set to below-threshold.

Restrictions and guidelines

The threshold monitoring feature is not available for the path jitter operation.

Procedure

1. Enter system view.

system-view

2. Enter the view of an existing NQA operation.

nqa entry admin-name operation-tag

3. Enable sending traps to the NMS when specific conditions are met.

reaction trap { path-change | probe-failure consecutive-probe-failures | test-complete | test-failure [ accumulate-probe-failures ] }

By default, no traps are sent to the NMS.

The ICMP jitter, UDP jitter, and voice operations support only the test-complete keyword.

The following parameters are not available for the UDP tracert operation:

¡ The probe-failure consecutive-probe-failures option.

¡ The accumulate-probe-failures argument.

4. Configure threshold monitoring. Choose the options to configure as needed:

¡ Monitor the operation duration.

reaction item-number checked-element probe-duration threshold-type { accumulate accumulate-occurrences | average | consecutive consecutive-occurrences } threshold-value upper-threshold lower-threshold [ action-type { none | trap-only } ]

This reaction entry is not supported in the ICMP jitter, UDP jitter, UDP tracert, or voice operations.

¡ Monitor failure times.

reaction item-number checked-element probe-fail threshold-type { accumulate accumulate-occurrences | consecutive consecutive-occurrences } [ action-type { none | trap-only } ]

This reaction entry is not supported in the ICMP jitter, UDP jitter, UDP tracert, or voice operations.

¡ Monitor the round-trip time.

reaction item-number checked-element rtt threshold-type { accumulate accumulate-occurrences | average } threshold-value upper-threshold lower-threshold [ action-type { none | trap-only } ]

Only the ICMP jitter, UDP jitter, and voice operations support this reaction entry.

¡ Monitor packet loss.

reaction item-number checked-element packet-loss threshold-type accumulate accumulate-occurrences [ action-type { none | trap-only } ]

Only the ICMP jitter, UDP jitter, and voice operations support this reaction entry.

¡ Monitor the one-way jitter.

reaction item-number checked-element { jitter-ds | jitter-sd } threshold-type { accumulate accumulate-occurrences | average } threshold-value upper-threshold lower-threshold [ action-type { none | trap-only } ]

Only the ICMP jitter, UDP jitter, and voice operations support this reaction entry.

¡ Monitor the one-way delay.

reaction item-number checked-element { owd-ds | owd-sd } threshold-value upper-threshold lower-threshold

Only the ICMP jitter, UDP jitter, and voice operations support this reaction entry.

¡ Monitor the ICPIF value.

reaction item-number checked-element icpif threshold-value upper-threshold lower-threshold [ action-type { none | trap-only } ]

Only the voice operation supports this reaction entry.

¡ Monitor the MOS value.

reaction item-number checked-element mos threshold-value upper-threshold lower-threshold [ action-type { none | trap-only } ]

Only the voice operation supports this reaction entry.

The DNS operation does not support the action of sending trap messages. For the DNS operation, the action type can only be none.

Configuring the NQA statistics collection feature

About this task

NQA forms statistics within the same collection interval as a statistics group. To display information about the statistics groups, use the display nqa statistics command.

When the maximum number of statistics groups is reached, the NQA client deletes the oldest statistics group to save a new one.

A statistics group is automatically deleted when its hold time expires.

Restrictions and guidelines

The NQA statistics collection feature is not available for the UDP tracert operation.

If you use the frequency command to set the interval to 0 milliseconds for an NQA operation, NQA does not generate any statistics group for the operation.

Procedure

1. Enter system view.

system-view

2. Enter the view of an existing NQA operation.

nqa entry admin-name operation-tag

3. Set the statistics collection interval.

statistics interval interval

The default setting is 60 minutes.

4. Set the maximum number of statistics groups that can be saved.

statistics max-group number

By default, the NQA client can save a maximum of two statistics groups for an operation.

To disable the NQA statistics collection feature, set the number argument to 0.

5. Set the hold time of statistics groups.

statistics hold-time hold-time

The default setting is 120 minutes.

Configuring the saving of NQA history records

About this task

This task enables the NQA client to save NQA history records. You can use the display nqa history command to display the NQA history records.

Restrictions and guidelines

The NQA history record saving feature is not available for the following types of operations:

· ICMP jitter operation.

· UDP jitter operation.

· Voice operation.

· Path jitter operation.

Procedure

1. Enter system view.

system-view

2. Enter the view of an existing NQA operation.

nqa entry admin-name operation-tag

3. Enable the saving of history records for the NQA operation.

history-record enable

By default, this feature is enabled only for the UDP tracert operation.

4. Set the lifetime of history records.

history-record keep-time keep-time

The default setting is 120 minutes.

A record is deleted when its lifetime is reached.

5. Set the maximum number of history records that can be saved.

history-record number number

The default setting is 50.

When the maximum number of history records is reached, the system will delete the oldest record to save a new one.

Scheduling the NQA operation on the NQA client

About this task

The NQA operation runs between the specified start time and end time (the start time plus operation duration). If the specified start time is ahead of the system time, the operation starts immediately. If both the specified start and end time are ahead of the system time, the operation does not start. To display the current system time, use the display clock command.

Restrictions and guidelines

You cannot enter the operation type view or the operation view of a scheduled NQA operation.

A system time adjustment does not affect started or completed NQA operations. It affects only the NQA operations that have not started.

Procedure

1. Enter system view.

system-view

2. Specify the scheduling parameters for an NQA operation.

nqa schedule admin-name operation-tag start-time { hh:mm:ss [ yyyy/mm/dd | mm/dd/yyyy ] | now } lifetime { lifetime | forever } [ recurring ]

Configuring NQA templates on the NQA client

Restrictions and guidelines

Some operation parameters for an NQA template can be specified by the template configuration or the feature that uses the template. When both are specified, the parameters in the template configuration take effect.

NQA template tasks at a glance

To configure NQA templates, perform the following tasks:

1. Perform at least one of the following tasks:

¡ Configuring the ARP template

¡ Configuring the ICMP template

¡ Configuring the IMAP template

¡ Configuring the DNS template

¡ Configuring the POP3 template

¡ Configuring the SMTP template

¡ Configuring the TCP template

¡ Configuring the TCP half open template

¡ Configuring the UDP template

¡ Configuring the HTTP template

¡ Configuring the HTTPS template

¡ Configuring the FTP template

¡ Configuring the RADIUS authentication template

¡ Configuring the RTSP template

¡ Configuring the SIP template

¡ Configuring the SSL template

¡ Configuring the WAP template

2. (Optional.) Configuring optional parameters for the NQA template

Configuring the ARP template

About this task

A feature that uses the ARP template performs the ARP operation to test whether the ARP service is available on the destination device.

In the ARP operation, the NQA client sends an ARP request to the destination device. If the client receives an ARP reply, it determines that the ARP service is available on the destination device.

Procedure

1. Enter system view.

system-view

2. Create an ARP template and enter its view.

nqa template arp name

3. (Optional.) Specify the destination IP address for the probe packets.

destination ip ip-address

By default, no destination IP address is specified.

4. (Optional.) Specify the source IP address for the probe packets.

source ip ip-address

By default, the source IP address of the probe packets is the primary IP address of their output interface.

The source IP address must be the IP address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

Configuring the ICMP template

About this task

A feature that uses the ICMP template performs the ICMP operation to measure the reachability of a destination device. The ICMP template is supported on both IPv4 and IPv6 networks.

Procedure

1. Enter system view.

system-view

2. Create an ICMP template and enter its view.

nqa template icmp name

3. Specify the destination host by IP address or URL for the operation.

¡ Specify the destination host by IP address.

IPv4:

destination ip ip-address

IPv6:

destination ipv6 ipv6-address

By default, no destination IP address is configured.

¡ Specify the destination host by URL.

url url

By default, no URL is configured.

The URL can contain a protocol name, host name, and port number, such as http://host:port. The host name is required. The protocol name and port number are optional.

4. Specify the source IP address for ICMP echo requests. Choose one option as needed:

¡ Use the IP address of the specified interface as the source IP address.

source interface interface-type interface-number

By default, the primary IP address of the output interface is used as the source IP address of ICMP echo requests.

The specified source interface must be up.

¡ Specify the source IPv4 address.

source ip ip-address

By default, the primary IPv4 address of the output interface is used as the source IPv4 address of ICMP echo requests.

The specified source IPv4 address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

¡ Specify the source IPv6 address.

source ipv6 ipv6-address

By default, the IPv6 address of the output interface is used as the source IPv6 address of ICMP echo requests.

The specified source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

5. Specify the next hop IP address for ICMP echo requests.

IPv4:

next-hop ip ip-address

IPv6:

next-hop ipv6 ipv6-address

By default, no IP address of the next hop is configured.

6. Configure the probe result sending on a per-probe basis.

reaction trigger per-probe

By default, the probe result is sent to the feature that uses the template after three consecutive failed or successful probes.

If you execute the reaction trigger per-probe and reaction trigger probe-pass commands multiple times, the most recent configuration takes effect.

If you execute the reaction trigger per-probe and reaction trigger probe-fail commands multiple times, the most recent configuration takes effect.

7. (Optional.) Set the payload size for each ICMP request.

data-size size

The default setting is 100 bytes.

8. (Optional.) Specify the payload fill string for ICMP echo requests.

data-fill string

The default payload fill string is the hexadecimal string 00010203040506070809.

Configuring the IMAP template

About this task

A feature that uses the IMAP template performs the IMAP operation to determine the availability of the IMAP service on the IMAP server.

Before you perform an IMAP operation, enable the IMAP Server service on the IMAP server and configure related settings, including the login username, password, and mailbox name.

Procedure

1. Enter system view.

system-view

2. Create an IMAP template and enter IMAP template view.

nqa template imap name

3. (Optional.) Specify the destination address for the probe packets.

IPv4:

destination ip ip-address

IPv6:

destination ipv6 ipv6-address

By default, no destination address is specified.

4. (Optional.) Specify the destination port number for the probe packets.

destination port port-number

The default destination port number is 143.

5. (Optional.) Specify the source address for the probe packets.

IPv4:

source ip ip-address

By default, the primary IPv4 address of the output interface is used as the source IPv4 address of the probe packets.

The source IPv4 address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

IPv6:

source ipv6 ipv6-address

By default, the source IPv6 address of the probe packets is the IPv6 address of their output interface.

The source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

6. (Optional.) Specify the login username.

username username

By default, no login username is specified.

7. (Optional.) Specify the login password.

password { cipher | simple } string

By default, no login password is specified.

8. (Optional.) Specify the mailbox name.

mailbox mailbox-name

By default, mailbox INBOX is used.

Configuring the DNS template

About this task

A feature that uses the DNS template performs the DNS operation to determine the status of the server. The DNS template is supported on both IPv4 and IPv6 networks.

In DNS template view, you can specify the address expected to be returned. If the returned IP addresses include the expected address, the DNS server is valid and the operation succeeds. Otherwise, the operation fails.

Prerequisites

Create a mapping between the domain name and an address before you perform the DNS operation. For information about configuring the DNS server, see documents about the DNS server configuration.

Procedure

1. Enter system view.

system-view

2. Create a DNS template and enter DNS template view.

nqa template dns name

3. Specify the destination IP address for the probe packets.

IPv4:

destination ip ip-address

IPv6:

destination ipv6 ipv6-address

By default, no destination address is specified.

4. Specify the destination port number for the probe packets.

destination port port-number

By default, the destination port number is 53.

5. Specify the source IP address for the probe packets.

IPv4:

source ip ip-address

By default, the source IPv4 address of the probe packets is the primary IPv4 address of their output interface.

The source IPv4 address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

IPv6:

source ipv6 ipv6-address

By default, the source IPv6 address of the probe packets is the IPv6 address of their output interface.

The source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

6. Specify the source port number for the probe packets.

source port port-number

By default, the NQA client randomly picks an unused port as the source port when the operation starts.

For the operation to succeed, make sure the specified port number is not used by any services on the device. As a best practice, use the default value.

7. Specify the domain name to be translated.

resolve-target domain-name

By default, no domain name is specified.

8. Specify the domain name resolution type.

resolve-type { A | AAAA }

By default, the type is type A.

A type A query resolves a domain name to a mapped IPv4 address, and a type AAAA query to a mapped IPv6 address.

9. (Optional.) Specify the IP address that is expected to be returned.

IPv4:

expect ip ip-address

IPv6:

expect ipv6 ipv6-address

By default, no expected IP address is specified.

10. Configure the probe result sending on a per-probe basis.

reaction trigger per-probe

By default, the probe result is sent to the feature that uses the template after three consecutive failed or successful probes.

If you execute the reaction trigger per-probe and reaction trigger probe-pass commands multiple times, the most recent configuration takes effect.

If you execute the reaction trigger per-probe and reaction trigger probe-fail commands multiple times, the most recent configuration takes effect.

Configuring the POP3 template

About this task

A feature that uses the POP3 template performs the POP3 operation to determine the availability of the POP3 service on the POP3 server.

Before you perform a POP3 operation, enable the POP3 Server service on the POP3 server and configure related settings, including the login username and password.

Procedure

1. Enter system view.

system-view

2. Create a POP3 template and enter POP3 template view.

nqa template pop3 name

3. (Optional.) Specify the destination address for the probe packets.

IPv4:

destination ip ip-address

IPv6:

destination ipv6 ipv6-address

By default, no destination address is specified.

4. (Optional.) Specify the destination port number for the probe packets.

destination port port-number

The default destination port number is 110.

5. (Optional.) Specify the source address for the probe packets.

IPv4:

source ip ip-address

By default, the primary IPv4 address of the output interface is used as the source IPv4 address of the probe packets.

The source IPv4 address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

IPv6:

source ipv6 ipv6-address

By default, the source IPv6 address of the probe packets is the IPv6 address of their output interface.

The source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

6. Specify the login username.

username username

By default, no login username is specified.

7. Specify the login password.

password { cipher | simple } string

By default, no login password is specified.

Configuring the SMTP template

About the SMTP template

A feature that uses the SMTP template performs the SMTP operation to determine the availability of the SMTP service on the SMTP server.

Procedure

1. Enter system view.

system-view

2. Create a SMTP template and enter SMTP template view.

nqa template smtp name

3. (Optional.) Specify the destination address for the probe packets.

IPv4:

destination ip ip-address

IPv6:

destination ipv6 ipv6-address

By default, no destination address is specified.

4. (Optional.) Specify the destination port number for the probe packets.

destination port port-number

The default destination port number is 25.

5. (Optional.) Specify the source address for the probe packets.

IPv4:

source ip ip-address

By default, the primary IPv4 address of the output interface is used as the source IPv4 address of the probe packets.

The source IPv4 address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

IPv6:

source ipv6 ipv6-address

By default, the source IPv6 address of the probe packets is the IPv6 address of their output interface.

The source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

Configuring the TCP template

About this task

A feature that uses the TCP template performs the TCP operation to test whether the NQA client can establish a TCP connection to a specific port on the server.

In TCP template view, you can specify the expected string to be returned. If you do not specify the expected string, the TCP operation tests only whether the client can establish a TCP connection to the server.

Procedure

1. Enter system view.

system-view

2. Create a TCP template and enter its view.

nqa template tcp name

3. Specify the server by IP address and destination port number or URL and destination port number for the operation.

¡ Specify the server by IP address and destination port number.

IPv4:

destination ip ip-address

IPv6:

destination ipv6 ipv6-address

By default, no destination IP address is specified.

The destination address must be the same as the IP address of the TCP listening service configured on the NQA server.

destination port port-number

By default, no destination port number is specified.

The destination port number must be the same as the port number of the TCP listening service on the NQA server.

¡ Specify the server by URL and destination port number.

url url

By default, no URL is specified.

The URL can contain a protocol name, host name, and port number, such as http://host:port. The host name and port number are required. The protocol name is optional.

4. Specify the source IP address for the probe packets.

IPv4:

source ip ip-address

By default, the primary IPv4 address of the output interface is used as the source IPv4 address of the probe packets.

The source IP address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

IPv6:

source ipv6 ipv6-address

By default, the IPv6 address of the output interface is used as the source IPv6 address of the probe packets.

The source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

5. (Optional.) Specify the payload fill string for the probe packets. Choose one option as needed:

¡ Specify the payload fill string.

data-fill string

¡ Specify the hexadecimal payload fill string.

hex-data-fill hex [ raw ]

The default payload fill string is the hexadecimal string 00010203040506070809.

6. (Optional.) Configure the expected response string.

¡ Configure the expected response string to determine a successful NQA operation:

expect { data | hex-data } string [ { offset | strict-offset } number ]

¡ Configure the expected response string to determine a failed NQA operation:

expect { failed-data | hex-failed-data } string [ { offset | strict-offset } number ]

By default, no expected response string is configured.

The expected response string check takes effect only if the data-fill or hex-data-fill command is also configured.

If you configure both commands, the expect { failed-data | hex-failed-data } command takes effect.

7. (Optional.) Enable the NQA client to send resource release notifications to the NQA server when the operation is complete.

resource-release { data-fill | hex-data-fill } string

By default, the NQA client does not send resource release notifications to the NQA server when an NQA operation is complete.

8. Set a TCP connection termination mode.

disconnect-mode { fin | rst }

By default, the TCP operation uses the RST mode to terminate TCP connections.

Configuring the TCP half open template

About this task

A feature that uses the TCP half open template performs the TCP half open operation to test whether the TCP service is available on the server. The TCP half open operation is used when the feature cannot get a response from the TCP server through an existing TCP connection.

The TCP half open operation works as follows:

· If port detection is disabled, the NQA client sends a TCP ACK packet to the server. If the client receives an RST packet, it considers that the TCP service is available on the server.

· If port detection is enabled, the NQA client sends a TCP SYN packet to the server. If the client receives a SYN-ACK packet, it considers that the destination TCP port is operating correctly on the server.

Procedure

1. Enter system view.

system-view

2. Create a TCP half open template and enter its view.

nqa template tcphalfopen name

3. (Optional.) Enable port detection.

port-detect enable

By default, port detection is disabled.

To use the port detection feature, you must specify a destination port number for the TCP half open template.

4. Specify the destination IP address of the operation.

IPv4:

destination ip ip-address

IPv6:

destination ipv6 ipv6-address

By default, no destination IP address is specified.

The destination address must be the same as the IP address of the listening service configured on the NQA server.

5. Specify the destination port number.

destination port port-number

By default, no destination port number is specified.

The destination port number must be the same as the port number of the listening service on the NQA server.

For the port detection feature to take effect, the destination port number must be specified.

6. Specify the source IP address for the probe packets.

IPv4:

source ip ip-address

By default, the primary IPv4 address of the output interface is used as the source IPv4 address of the probe packets.

The source IPv4 address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

IPv6:

source ipv6 ipv6-address

By default, the IPv6 address of the output interface is used as the source IPv6 address of the probe packets.

The source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

7. Specify the output interface for the probe packets.

out interface interface-type interface-number

By default, the NQA client determines the output interface based on the routing table lookup.

8. Specify the next hop IP address for the probe packets.

IPv4:

next-hop ip ip-address

IPv6:

next-hop ipv6 ipv6-address

By default, the IP address of the next hop is configured.

9. Configure the probe result sending on a per-probe basis.

reaction trigger per-probe

By default, the probe result is sent to the feature that uses the template after three consecutive failed or successful probes.

If you execute the reaction trigger per-probe and reaction trigger probe-pass commands multiple times, the most recent configuration takes effect.

If you execute the reaction trigger per-probe and reaction trigger probe-fail commands multiple times, the most recent configuration takes effect.

Configuring the UDP template

About this task

A feature that uses the UDP template performs the UDP operation to test the following items:

· Reachability of a specific port on the NQA server.

· Availability of the requested service on the NQA server.

The UDP operation requires both the NQA server and the NQA client. Before you perform a UDP operation, configure a UDP listening service on the NQA server. For more information about the UDP listening service configuration, see "Configuring the NQA server."

(For devices that do not support UDP port detection.) A UDP operation result varies by the configuration of the expected string:

· If the expected string that determines a failed UDP operation is configured, the UDP operation fails when either of the conditions is met:

¡ The UDP response string contains the expected string.

¡ The UDP response string is shorter than the expected string.

If none conditions are met, the operation is successful.

· If the expected string that determines a successful UDP operation is configured, the UDP operation is successful when the UDP response packet matches the expected string. Otherwise, the operation fails.

· If no expected string is configured, the UDP operation is successful when the client receives the response packet from the server.

(For devices that support UDP port detection.) The UDP port detection tests the availability of the requested UDP service on the peer port. A UDP operation result varies by the configuration of the expected string and the status of the port detection:

· With port detection enabled for the UDP operation, the operation succeeds if the NQA client does not receive any ICMP port unreachable messages within the probe timeout time. If the client receives an ICMP port unreachable message, the UDP operation fails.

· With port detection disabled for the UDP operation, the following rules apply:

· If the expected string that determines a failed UDP operation is configured, the UDP operation fails when either of the conditions is met:

¡ The UDP response string contains the expected string.

¡ The UDP response string is shorter than the expected string.

If none conditions are met, the operation is successful.

¡ If the expected string that determines a successful UDP operation is configured, the UDP operation is successful when the UDP response packet matches the configured expected string. Otherwise, the operation fails.

¡ If no expected string is configured, the UDP operation is successful when the client receives the response packet from the server.

Restrictions and guidelines

If the destination device is an H3C device, you must also perform the following tasks for the UDP operation:

· Execute the ip unreachables enable command on the destination device to enable sending ICMP destination unreachable messages. For more information about the ip unreachables enable command, see IP performance optimization commands in Network Connectivity Command Reference.

· Execute the data-fill or hex-data-fill command on the NQA client with the raw keyword specified. The specified payload fill string can be any value in the value range.

Procedure

1. Enter system view.

system-view

2. Create a UDP template and enter its view.

nqa template udp name

3. (Optional.) Enable port detection for the UDP operation.

port-detect enable

By default, port detection is disabled.

4. Specify the destination IP address of the operation.

IPv4:

destination ip ip-address

IPv6:

destination ipv6 ipv6-address

By default, no destination IP address is specified.

The destination address must be the same as the IP address of the listening service configured on the NQA server.

5. Specify the destination port number for the probe packets.

destination port port-number

By default, no destination port number is specified.

The destination port number must be the same as the port number of the listening service on the NQA server.

6. Specify the source IP address for the probe packets.

IPv4:

source ip ip-address

By default, the primary IPv4 address of the output interface is used as the source IPv4 address of the probe packets.

The source IP address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

IPv6:

source ipv6 ipv6-address

By default, the IPv6 address of the output interface is used as the source IPv6 address of the probe packets.

The source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

7. Specify the payload fill string for the probe packets. Choose one option as needed:

¡ Specify the payload fill string.

data-fill string [ raw ]

The default payload fill string is the hexadecimal string 00010203040506070809.

¡ Specify the hexadecimal payload fill string.

hex-data-fill hex [ raw ]

The default payload fill string is the hexadecimal string 00010203040506070809.

For port detection to take effect for the UDP operation, specify the raw keyword in the data-fill or hex-data-fill command, and the string is not required to be format compliant.

8. (Optional.) Set the payload size for the probe packets.

data-size size

The default setting is 100 bytes.

9. (Optional.) Configure the expected response string.

¡ Configure the expected response string to determine a successful NQA operation:

expect { data | hex-data } string [ { offset | strict-offset } number ]

¡ Configure the expected response string to determine a failed NQA operation:

expect { failed-data | hex-failed-data } string [ { offset | strict-offset } number ]

By default, no expected response string is configured.

The expected response string check takes effect only if the data-fill or hex-data-fill command is also configured.

If you configure both commands, the expect { failed-data | hex-failed-data } command takes effect.

10. (Optional.) Enable the NQA client to send resource release notifications to the NQA server when the operation is complete.

resource-release { data-fill | hex-data-fill } string

By default, the NQA client does not send resource release notifications to the NQA server when an NQA operation is complete.

Configuring the tracert template

About this task

A feature that uses the tracert template performs the UDP tracert operation to determine the routing path from the source device to the destination device. The UDP tracert operation uses the same test principle as the ordinary tracert operation. For more information about tracert, see "Using ping, tracert, and system debugging."

The UDP tracert operation sends a UDP packet to a hop along the path per probe.

Procedure

1. Enter system view.

system-view

2. Create a tracert template and enter its view.

nqa template tracert name

3. Specify the destination IP address for the UDP packets.

destination ip ip-address

By default, no destination IP address is specified.

4. Specify the destination port number for the UDP packets.

destination port port-number

By default, the destination port number is 33434.

The specified port number must be an unused port number on the destination device, so the destination device can reply with an ICMP port unreachable message.

5. Specify an output interface for UDP packets.

out interface interface-type interface-number

By default, the NQA client determines the output interface based on the routing table lookup.

6. Specify the source IP address for UDP packets.

¡ Specify the IP address of the specified interface as the source IP address.

source interface interface-type interface-number

By default, the source IP address of UDP packets is the primary IP address of their output interface.

¡ Specify the source IP address.

source ip ip-address

The specified source interface must be up. The source IP address must be the IP address of a local interface, and the local interface must be up. Otherwise, no probe packets can be sent out.

7. Specify the source port number for UDP packets.

source port port-number

By default, the NQA client randomly picks an unused port as the source port when the operation starts.

For the operation to succeed, make sure the specified port number is not used by any services on the device. As a best practice, use the default value.

8. Set the maximum number of consecutive probe failures.

max-failure times

The default setting is 5.

9. Set the initial TTL value for UDP packets.

init-ttl value

The default setting is 1.

10. (Optional.) Set the payload size for each UDP packet.

data-size size

The default setting is 100 bytes.

11. (Optional.) Enable the no-fragmentation feature.

no-fragment enable

By default, the no-fragmentation feature is disabled.

12. Configure the probe result sending on a per-probe basis.

reaction trigger per-probe

By default, the probe result is sent to the feature that uses the template after three consecutive failed or successful probes.

If you execute the reaction trigger per-probe and reaction trigger probe-pass commands multiple times, the most recent configuration takes effect.

If you execute the reaction trigger per-probe and reaction trigger probe-fail commands multiple times, the most recent configuration takes effect.

Configuring the HTTP template

About this task

A feature that uses the HTTP template performs the HTTP operation to measure the time it takes the NQA client to obtain data from an HTTP server.

The configured expected string is checked only when the HTTP response body type is content or chunk.

The status code of the HTTP packet is a three-digit field in decimal notation, and it includes the status information for the HTTP server. The first digit defines the class of response.

Prerequisites

Before you perform the HTTP operation, you must configure the HTTP server.

Procedure

1. Enter system view.

system-view

2. Create an HTTP template and enter its view.

nqa template http name

3. Specify the URL of the HTTP proxy server.

proxy-url url

By default, the URL of the HTTP proxy server is not specified.

The URL of the HTTP proxy server is in the format of http://host or http://host:port.

This command is required if an HTTP proxy server is required for Internet access.

After the HTTP proxy server URL is specified, the NQA client will send probe packets to the HTTP proxy server, which acts on behalf of the HTTP server.

4. Specify the URL of the destination HTTP server for the HTTP template.

url url

By default, the URL of the destination HTTP server is not specified for an HTTP template.

The URL can be in one of the following formats:

¡ http://host/resource

¡ http://host:port/resource

5. Specify an HTTP login username.

username username

By default, no HTTP login username is specified.

6. Specify an HTTP login password.

password { cipher | simple } string

By default, no HTTP login password is specified.

7. Specify the HTTP version.

version { v1.0 | v1.1 }

By default, HTTP 1.0 is used.

8. Specify the HTTP operation type.

operation { get | post | raw }

By default, the HTTP operation type is get.

If you set the operation type to raw, the client pads the content configured in raw request view to the HTTP request to send to the HTTP server.

9. Configure the content of the HTTP raw request.

a. Enter raw request view.

raw-request

Every time you enter raw request view, the previously configured raw request content is cleared.

b. Enter or paste the request content.

By default, no request content is configured.

c. Return to HTTP template view.

quit

The system automatically saves the configuration in raw request view before it returns to HTTP template view.

This step is required only when the operation type is set to raw.

10. Specify the source IP address for the probe packets.

IPv4:

source ip ip-address

By default, the primary IPv4 address of the output interface is used as the source IPv4 address of the probe packets.

The source IPv4 address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

IPv6:

source ipv6 ipv6-address

By default, the IPv6 address of the output interface is used as the source IPv6 address of the probe packets.

The source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

11. Specify an output interface for HTTP packets.

out interface interface-type interface-number

By default, the NQA client determines the output interface based on the routing table lookup.

12. (Optional.) Configure the expected status codes to determine a successful NQA operation.

expect status status-list

By default, no expected status code is configured to determine a successful NQA operation.

Do not configure both this command and the expect failed-status command.

13. (Optional.) Configure the expected status codes to determine a failed NQA operation.

expect failed-status status-list

By default, no expected status code is configured to determine a failed NQA operation.

Do not configure both this command and the expect status command.

14. (Optional.) Configure the expected response string to determine a successful NQA operation.

expect data string [ { offset | strict-offset } number ]

By default, no expected response string is configured to determine a successful NQA operation.

Do not configure both this command and the expect failed-data command.

15. (Optional.) Configure the expected response string to determine a failed NQA operation.

expect failed-data string [ { offset | strict-offset } number ]

By default, no expected response string is configured to determine a failed NQA operation..

Do not configure both this command and the expect data command.

Configuring the HTTPS template

About this task

A feature that uses the HTTPS template performs the HTTPS operation to measure the time it takes for the NQA client to obtain data from an HTTPS server.

The configured expected string is checked only when the HTTP response body type is content or chunk.

The status code of the HTTPS packet is a three-digit field in decimal notation, and it includes the status information for the HTTPS server. The first digit defines the class of response.

Prerequisites

Before you perform the HTTPS operation, configure the HTTPS server and the SSL client policy for the SSL client. For information about configuring SSL client policies, see Security Configuration Guide.

Procedure

1. Enter system view.

system-view

2. Create an HTTPS template and enter its view.

nqa template https name

3. Specify the URL of the HTTPS proxy server.

proxy-url url

By default, the URL of the HTTPS proxy server is not specified.

The URL of the HTTPS proxy server is in the format of https://host or https://host:port.

This command is required if an HTTPS proxy server is required for Internet access.

After the HTTPS proxy server URL is specified, the NQA client will send probe packets to the HTTPS proxy server, which acts on behalf of the HTTPS server.

4. Specify the URL of the destination HTTPS server for the HTTPS template.

url url

By default, the URL of the destination HTTPS server is not specified for an HTTPS template.

Enter the URL in one of the following formats:

¡ https://host/resource

¡ https://host:port/resource

5. Specify an HTTPS login username.

username username

By default, no HTTPS login username is specified.

6. Specify an HTTPS login password.

password { cipher | simple } string

By default, no HTTPS login password is specified.

7. Specify an SSL client policy.

ssl-client-policy policy-name

By default, no SSL client policy is specified.

8. Specify the HTTPS version.

version { v1.0 | v1.1 }

By default, HTTPS 1.0 is used.

9. Specify the HTTPS operation type.

operation { get | post | raw }

By default, the HTTPS operation type is get.

If you set the operation type to raw, the client pads the content configured in raw request view to the HTTPS request to send to the HTTPS server.

10. Configure the content of the HTTPS raw request.

a. Enter raw request view.

raw-request

Every time you enter raw request view, the previously configured raw request content is cleared.

b. Enter or paste the request content.

By default, no request content is configured.

c. Return to HTTPS template view.

quit

The system automatically saves the configuration in raw request view before it returns to HTTPS template view.

This step is required only when the operation type is set to raw.

11. Specify the source IP address for the probe packets.

IPv4:

source ip ip-address

By default, the primary IPv4 address of the output interface is used as the source IPv4 address of the probe packets.

The source IP address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

IPv6:

source ipv6 ipv6-address

By default, the IPv6 address of the output interface is used as the source IPv6 address of the probe packets.

The source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

12. (Optional.) Configure the expected status codes to determine a successful NQA operation.

expect status status-list

By default, no expected status code is configured to determine a successful NQA operation.

Do not configure both this command and the expect failed-status command.

13. (Optional.) Configure the expected status codes to determine a failed NQA operation.

expect failed-status status-list

By default, no expected status code is configured to determine a failed NQA operation.

Do not configure both this command and the expect status command.

14. (Optional.) Configure the expected response string to determine a successful NQA operation.

expect data string [ { offset | strict-offset } number ]

By default, no expected response string is configured to determine a successful NQA operation.

Do not configure both this command and the expect failed-data command.

15. (Optional.) Configure the expected response string to determine a failed NQA operation.

expect failed-data string [ { offset | strict-offset } number ]

By default, no expected response string is configured to determine a failed NQA operation..

Do not configure both this command and the expect data command.

Configuring the FTP template

About this task

A feature that uses the FTP template performs the FTP operation. The operation measures the time it takes the NQA client to transfer a file to or download a file from an FTP server.

Configure the username and password for the FTP client to log in to the FTP server before you perform an FTP operation. For information about configuring the FTP server, see Fundamentals Configuration Guide.

Procedure

1. Enter system view.

system-view

2. Create an FTP template and enter its view.

nqa template ftp name

3. Specify an FTP login username.

username username

By default, no FTP login username is specified.

4. Specify an FTP login password.

password { cipher | simple } sting

By default, no FTP login password is specified.

5. Specify the source IP address for the probe packets.

IPv4:

source ip ip-address

By default, the primary IPv4 address of the output interface is used as the source IPv4 address of the probe packets.

The source IP address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

IPv6:

source ipv6 ipv6-address

By default, the IPv6 address of the output interface is used as the source IPv6 address of the probe packets.

The source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

6. Set the data transmission mode.

mode { active | passive }

The default mode is active.

7. Specify the FTP operation type.

operation { get | put }

By default, the FTP operation type is get, which means obtaining files from the FTP server.

8. Specify the destination URL for the FTP template.

url url

By default, no destination URL is specified for an FTP template.

Enter the URL in one of the following formats:

¡ ftp://host/filename.

¡ ftp://host:port/filename.

When you perform the get operation, the file name is required.

When you perform the put operation, the filename argument does not take effect, even if it is specified. The file name for the put operation is determined by using the filename command.

9. Specify the name of a file to be transferred.

filename filename

By default, no file is specified.

This task is required only for the put operation.

The configuration does not take effect for the get operation.

Configuring the RADIUS authentication template

About this task

A feature that uses the RADIUS authentication template performs the RADIUS authentication operation to check the availability of the authentication service on the RADIUS server.

The RADIUS authentication operation workflow is as follows:

1. The NQA client sends an authentication request (Access-Request) to the RADIUS server. The request includes the username and the password. The password is encrypted by using the MD5 algorithm and the shared key.

2. The RADIUS server authenticates the username and password.

¡ If the authentication succeeds, the server sends an Access-Accept packet to the NQA client.

¡ If the authentication fails, the server sends an Access-Reject packet to the NQA client.

3. The NQA client determines the availability of the authentication service on the RADIUS server based on the response packet it received:

¡ If an Access-Accept packet is received, the authentication service is available on the RADIUS server.

¡ If an Access-Reject packet is received, the authentication service is not available on the RADIUS server.

Prerequisites

Before you configure the RADIUS authentication template, specify a username, password, and shared key on the RADIUS server. For more information about configuring the RADIUS server, see AAA in User Access and Authentication Configuration Guide.

Procedure

1. Enter system view.

system-view

2. Create a RADIUS authentication template and enter its view.

nqa template radius name

3. Specify the destination IP address of the operation.

IPv4:

destination ip ip-address

IPv6:

destination ipv6 ipv6-address

By default, no destination IP address is specified.

4. Specify the destination port number for the operation.

destination port port-number

By default, the destination port number is 1812.

5. Specify a username.

username username

By default, no username is specified.

6. Specify a password.

password { cipher | simple } string

By default, no password is specified.

7. Specify a shared key for secure RADIUS authentication.

key { cipher | simple } string

By default, no shared key is specified for RADIUS authentication.

8. Specify the source IP address for the probe packets.

IPv4:

source ip ip-address

By default, the primary IPv4 address of the output interface is used as the source IPv4 address of the probe packets.

The source IP address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

IPv6:

source ipv6 ipv6-address

By default, the IPv6 address of the output interface is used as the source IPv6 address of the probe packets.

The source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

Configuring the RADIUS accounting template

About this task

A feature that uses the RADIUS accounting template performs the RADIUS accounting operation to check the availability of the accounting service on the RADIUS server.

The RADIUS accounting operation workflow is as follows:

1. The NQA client sends a stop-accounting request (Accounting-Request) to the RADIUS server.

2. The RADIUS server returns an acknowledgment (Accounting-Response) to the NQA client.

3. The NQA client determines the availability of the accounting service on the RADIUS server based on whether it can receive the accounting response packet from the RADIUS server.

¡ If the accounting response packet is received, the accounting service is available on the RADIUS server.

¡ If no accounting response packet is received, the accounting service is not available on the RADIUS server.

Prerequisites

Before you configure the RADIUS accounting template, specify a username and the shared key on the RADIUS server. For more information about configuring the RADIUS server, see AAA in User Access and Authentication Configuration Guide.

Procedure

1. Enter system view.

system-view

2. Create a RADIUS accounting template and enter its view.

nqa template radius-account name

3. Specify the destination IP address of the operation.

IPv4:

destination ip ip-address

IPv6:

destination ipv6 ipv6-address

By default, no destination IP address is configured.

4. Specify the destination port number for the operation.

destination port port-number

By default, the destination port number is 1813.

5. Specify a username.

username username

By default, no username is specified.

6. Specify a shared key for secure RADIUS accounting.

key { cipher | simple } string

By default, no shared key is specified for RADIUS accounting.

7. Specify the source IP address for the probe packets.

IPv4:

source ip ip-address

By default, the primary IPv4 address of the output interface is used as the source IPv4 address of the probe packets.

The source IP address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

IPv6:

source ipv6 ipv6-address

By default, the IPv6 address of the output interface is used as the source IPv6 address of the probe packets.

The source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

Configuring the RTSP template

About this task

The Real Time Streaming Protocol (RTSP) is a network control protocol designed for real-time control (such as play/pause and forward/playback) of media streaming on the Internet.

A feature that uses the RTSP template performs the RTSP operation to test the availability of the RTSP server.

Procedure

1. Enter system view.

system-view

2. Create an RTSP template and enter RTSP template view.

nqa template rtsp name

3. (Optional.) Specify the source address for the probe packets.

IPv4:

source ip ip-address

By default, the primary IPv4 address of the output interface is used as the source IPv4 address of the probe packets.

The source IPv4 address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

IPv6:

source ipv6 ipv6-address

By default, the source IPv6 address of the probe packets is the IPv6 address of their output interface.

The source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

4. (Optional.) Specify the request method.

¡ Specify the OPTIONS method.

request-method options

¡ Specify the DESCRIBE method.

request-method describe

By default, the OPTIONS method is used.

5. (Optional.) Configure the expected status codes to determine a successful NQA operation.

expect status status-list

By default, no expected status code is configured to determine a successful NQA operation.

6. (Optional.) Specify the destination URL.

url url

By default, no destination URL is specified.

Valid formats for the destination URL are:

¡ rtsp://host/resource

¡ rtsp: //host:port/resource

Configuring the SIP template

About this task

The Session Initiation Protocol (SIP) is a communications protocol for signaling that controls multimedia communication sessions over IP networks. SIP messages can be transported over UDP or TCP.

A feature that uses the SIP template performs the SIP operation to test the availability of the SIP service on the SIP server.

Procedure

1. Enter system view.

system-view

2. Create a SIP template and enter SIP template view.

nqa template sip name

3. Specify the transport protocol.

transport-protocol { tcp | udp }

By default, the UDP transport protocol is used.

4. (Optional.) Specify the destination address for the probe packets.

IPv4:

destination ip ip-address

IPv6:

destination ipv6 ipv6-address

By default, no destination address is specified.

5. (Optional.) Specify the destination port number for the probe packets.

destination port port-number

The default destination port number is 5060.

6. (Optional.) Specify the source address for the probe packets.

IPv4:

source ip ip-address

By default, the primary IPv4 address of the output interface is used as the source IPv4 address of the probe packets.

The source IPv4 address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

IPv6:

source ipv6 ipv6-address

By default, the source IPv6 address of the probe packets is the IPv6 address of their output interface.

The source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

7. (Optional.) Configure the expected status codes to determine a successful NQA operation.

expect status status-list

By default, no expected status code is configured to determine a successful NQA operation.

Configuring the SSL template

About this task

A feature that uses the SSL template performs the SSL operation to measure the time required to establish an SSL connection to an SSL server.

Prerequisites

Before you configure the SSL template, you must configure the SSL client policy. For information about configuring SSL client policies, see Security Configuration Guide.

Procedure

1. Enter system view.

system-view

2. Create an SSL template and enter its view.

nqa template ssl name

3. Specify the destination IP address of the operation.

IPv4:

destination ip ip-address

IPv6:

destination ipv6 ipv6-address

By default, no destination IP address is specified.

4. Specify the destination port number for the operation.

destination port port-number

By default, the destination port number is not specified.

5. Specify an SSL client policy.

ssl-client-policy policy-name

By default, no SSL client policy is specified.

6. Specify the source IP address for the probe packets.

IPv4:

source ip ip-address

By default, the primary IPv4 address of the output interface is used as the source IPv4 address of the probe packets.

The source IP address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

IPv6:

source ipv6 ipv6-address

By default, the IPv6 address of the output interface is used as the source IPv6 address of the probe packets.

The source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

Configuring the WAP template

About this task

Wireless Application Protocol (WAP) is a technical standard for accessing information over a mobile wireless network. It describes a protocol suite allowing the interoperability of WAP equipment, and software with different network technologies.

A feature that uses the WAP template performs the WAP operation to determine the availability of the WAP gateway.

Before you start the WAP operation, you must configure the WAP gateway.

Procedure

1. Enter system view.

system-view

2. Create an WAP template and enter its view.

nqa template wap name

3. (Optional.) Specify the destination address for the probe packets.

IPv4:

destination ip ip-address

IPv6:

destination ipv6 ipv6-address

By default, no destination address is specified.

4. (Optional.) Specify the destination port number for the probe packets.

destination port port-number

The default destination port number is 161.

5. (Optional.) Specify the source address for the probe packets.

IPv4:

source ip ip-address

By default, the primary IPv4 address of the output interface is used as the source IPv4 address of the probe packets.

The source IPv4 address must be the IPv4 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

IPv6:

source ipv6 ipv6-address

By default, the source IPv6 address of the probe packets is the IPv6 address of their output interface.

The source IPv6 address must be the IPv6 address of a local interface, and the interface must be up. Otherwise, no probe packets can be sent out.

6. (Optional.) Specify the destination URL.

url url

By default, no destination URL is specified.

Valid formats for the destination URL are:

¡ http://host/resource

¡ http://host:port/resource

¡ https://host/resource

¡ https://host:port/resource

7. (Optional.) Configure the expected response string to determine a successful NQA operation.

expect { data | hex-data } string [ { offset | strict-offset } number ]

By default, no expected response string is configured to determine a successful NQA operation.

This step is required if the url command is configured.

Configuring optional parameters for the NQA template

Restrictions and guidelines

Unless otherwise specified, the following optional parameters apply to all types of NQA templates.

The parameter settings take effect only on the current NQA template.

Procedure

1. Enter system view.

system-view

2. Enter the view of an existing NQA template.

nqa template { arp | dns | ftp | http | https | icmp | imap | pop3 | radius | radius-account | rtsp | sip | smtp | ssl | tcp | tcphalfopen | udp | wap | tracert} name

3. Configure a description.

description text

By default, no description is configured.

4. Set the interval at which the NQA operation repeats.

frequency interval

The default setting is 5000 milliseconds.

When the interval expires, but the operation is not completed or is not timed out, the next operation does not start.

5. Specify the adjusted interval for NQA to start two consecutive NQA operations after a failed operation.

frequency-adjustment adj-interval

By default, no adjusted interval is specified.

6. Set the probe timeout time.

probe timeout timeout

The default setting is 3000 milliseconds.

7. Set the TTL for the probe packets.

ttl value

The default setting is 20.

This command is not available for the ARP template.

8. Set the ToS value in the IP header of the probe packets.

tos value

The default setting is 0.

This command is not available for the ARP template.

By default, the operation is performed on the public network.

9. Set the number of consecutive successful probes to determine a successful operation event.

reaction trigger probe-pass count

The default setting is 3.

If the number of consecutive successful probes for an NQA operation is reached, the NQA client notifies the feature that uses the template of the successful operation event.

10. Set the number of consecutive probe failures to determine an operation failure.

reaction trigger probe-fail count

The default setting is 3.

If the number of consecutive probe failures for an NQA operation is reached, the NQA client notifies the feature that uses the NQA template of the operation failure.

Display and maintenance commands for NQA

Execute display commands in any view.

Task	Command
Display history records of NQA operations.	display nqa history [ admin-name operation-tag ]
Display the current monitoring results of reaction entries.	display nqa reaction counters [ admin-name operation-tag [ item-number ] ]
Display the most recent result of the NQA operation.	display nqa result [ admin-name operation-tag ]
Display NQA server status.	display nqa server status
Display NQA statistics.	display nqa statistics [ admin-name operation-tag ]

‌

NQA configuration examples

Example: Configuring the ARP operation

Network configuration

As shown in Figure 2, configure an ARP operation on the NQA client (the AP) to test the round-trip time to the device.

Figure 2 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 2. (Details not shown.)

2. Configure the AP:

# Create an ARP operation.

<AP> system-view

[AP] nqa entry admin test1

[AP-nqa-admin-test1] type arp

# Specify 10.1.1.2 as the destination IP address of ARP requests.

[AP-nqa-admin-test1-arp] destination ip 10.1.1.2

# Configure the ARP operation to perform 10 probes.

[AP-nqa-admin-test1-arp] probe count 10

# Set the probe timeout time to 500 milliseconds for the ARP operation.

[AP-nqa-admin-test1-arp] probe timeout 500

# Configure the ARP operation to repeat every 5000 milliseconds.

[AP-nqa-admin-test1-arp] frequency 5000

# Enable saving history records.

[AP-nqa-admin-test1-arp] history-record enable

# Set the maximum number of history records to 10.

[AP-nqa-admin-test1-arp] history-record number 10

[AP-nqa-admin-test1-arp] quit

# Start the ARP operation.

[AP] nqa schedule admin test1 start-time now lifetime forever

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

[AP] undo nqa schedule admin test1

Verifying the configuration

# Display the most recent result of the ARP operation.

[AP] display nqa result admin test1

NQA entry (admin admin, tag test1) 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: 2019-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 ARP operation.

[AP] display nqa history admin test1

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

Index Response Status Time

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

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

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

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

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

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

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

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

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

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

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

Example: Configuring the ICMP echo operation

Network configuration

As shown in Figure 3, configure an ICMP echo operation on the NQA client (the AP) to test the round-trip time to Device A. The next hop of the AP is Device B.

Figure 3 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 3. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the AP:

# Create an ICMP echo operation.

<AP> system-view

[AP] nqa entry admin test1

[AP-nqa-admin-test1] type icmp-echo

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

[AP-nqa-admin-test1-icmp-echo] destination ip 10.2.2.2

# Specify 10.1.1.2 as the next hop so the ICMP echo requests are sent through Device B to Device A.

[AP-nqa-admin-test1-icmp-echo] next-hop ip 10.1.1.2

# Configure the ICMP echo operation to perform 10 probes.

[AP-nqa-admin-test1-icmp-echo] probe count 10

# Set the probe timeout time to 500 milliseconds for the ICMP echo operation.

[AP-nqa-admin-test1-icmp-echo] probe timeout 500

# Configure the ICMP echo operation to repeat every 5000 milliseconds.

[AP-nqa-admin-test1-icmp-echo] frequency 5000

# Enable saving history records.

[AP-nqa-admin-test1-icmp-echo] history-record enable

# Set the maximum number of history records to 10.

[AP-nqa-admin-test1-icmp-echo] history-record number 10

[AP-nqa-admin-test1-icmp-echo] quit

# Start the ICMP echo operation.

[AP] nqa schedule admin test1 start-time now lifetime forever

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

[AP] undo nqa schedule admin test1

Verifying the configuration

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

[AP] display nqa result admin test1

NQA entry (admin admin, tag test1) 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: 2011-08-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.

[AP] display nqa history admin test1

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

Index Response Status Time

370 3 Succeeded 2011-08-23 15:00:01.2

369 3 Succeeded 2011-08-23 15:00:01.2

368 3 Succeeded 2011-08-23 15:00:01.2

367 5 Succeeded 2011-08-23 15:00:01.2

366 3 Succeeded 2011-08-23 15:00:01.2

365 3 Succeeded 2011-08-23 15:00:01.2

364 3 Succeeded 2011-08-23 15:00:01.1

363 2 Succeeded 2011-08-23 15:00:01.1

362 3 Succeeded 2011-08-23 15:00:01.1

361 2 Succeeded 2011-08-23 15:00:01.1

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

Example: Configuring the ICMP jitter operation

Network configuration

As shown in Figure 4, configure an ICMP jitter operation to test the jitter between the AP and the device.

Figure 4 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 4. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the AP:

# Create an ICMP jitter operation.

<AP> system-view

[AP] nqa entry admin test1

[AP-nqa-admin-test1] type icmp-jitter

# Specify 10.2.2.2 as the destination address for the operation.

[AP-nqa-admin-test1-icmp-jitter] destination ip 10.2.2.2

# Configure the operation to repeat every 1000 milliseconds.

[AP-nqa-admin-test1-icmp-jitter] frequency 1000

[AP-nqa-admin-test1-icmp-jitter] quit

# Start the ICMP jitter operation.

[AP] nqa schedule admin test1 start-time now lifetime forever

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

[AP] undo nqa schedule admin test1

Verifying the configuration

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

[AP] display nqa result admin test1

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

Send operation times: 10 Receive response times: 10

Min/Max/Average round trip time: 15/32/17

Square-Sum of round trip time: 3235

Last packet received time: 2011-05-29 13:56:17.6

Extended results:

Packet loss ratio: 0.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

ICMP-jitter results:

RTT number: 10

Min positive SD: 4 Min positive DS: 1

Max positive SD: 21 Max positive DS: 28

Positive SD number: 5 Positive DS number: 4

Positive SD sum: 52 Positive DS sum: 38

Positive SD average: 10 Positive DS average: 10

Positive SD square-sum: 754 Positive DS square-sum: 460

Min negative SD: 1 Min negative DS: 6

Max negative SD: 13 Max negative DS: 22

Negative SD number: 4 Negative DS number: 5

Negative SD sum: 38 Negative DS sum: 52

Negative SD average: 10 Negative DS average: 10

Negative SD square-sum: 460 Negative DS square-sum: 754

One way results:

Max SD delay: 15 Max DS delay: 16

Min SD delay: 7 Min DS delay: 7

Number of SD delay: 10 Number of DS delay: 10

Sum of SD delay: 78 Sum of DS delay: 85

Square-Sum of SD delay: 666 Square-Sum of DS delay: 787

Lost packets for unknown reason: 0

# Display the statistics of the ICMP jitter operation.

[AP] display nqa statistics admin test1

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

NO. : 1

Start time: 2015-07-10 13:56:14.0

Life time: 47 seconds

Send operation times: 410 Receive response times: 410

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

Square-Sum of round trip time: 206176

Extended results:

Packet loss ratio: 0.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

ICMP-jitter results:

RTT number: 410

Min positive SD: 3 Min positive DS: 1

Max positive SD: 30 Max positive DS: 79

Positive SD number: 186 Positive DS number: 158

Positive SD sum: 2602 Positive DS sum: 1928

Positive SD average: 13 Positive DS average: 12

Positive SD square-sum: 45304 Positive DS square-sum: 31682

Min negative SD: 1 Min negative DS: 1

Max negative SD: 30 Max negative DS: 78

Negative SD number: 181 Negative DS number: 209

Negative SD sum: 181 Negative DS sum: 209

Negative SD average: 13 Negative DS average: 14

Negative SD square-sum: 46994 Negative DS square-sum: 3030

One way results:

Max SD delay: 46 Max DS delay: 46

Min SD delay: 7 Min DS delay: 7

Number of SD delay: 410 Number of DS delay: 410

Sum of SD delay: 3705 Sum of DS delay: 3891

Square-Sum of SD delay: 45987 Square-Sum of DS delay: 49393

Lost packets for unknown reason: 0

Example: Configuring the DHCP operation

Network configuration

As shown in Figure 5, configure a DHCP operation to test the time required for the AP to obtain an IP address from the DHCP server.

Figure 5 Network diagram

‌

Procedure

# Create a DHCP operation.

<AP> system-view

[AP] nqa entry admin test1

[AP-nqa-admin-test1] type dhcp

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

[AP-nqa-admin-test1-dhcp] destination ip 10.1.1.2

# Enable the saving of history records.

[AP-nqa-admin-test1-dhcp] history-record enable

[AP-nqa-admin-test1-dhcp] quit

# Start the DHCP operation.

[AP] nqa schedule admin test1 start-time now lifetime forever

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

[AP] undo nqa schedule admin test1

Verifying the configuration

# Display the most recent result of the DHCP operation.

[AP] display nqa result admin test1

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

Send operation times: 1 Receive response times: 1

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

Square-Sum of round trip time: 262144

Last succeeded probe time: 2011-11-22 09:56:03.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 DHCP operation.

[AP] display nqa history admin test1

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

Index Response Status Time

1 512 Succeeded 2011-11-22 09:56:03.2

The output shows that it took the AP 512 milliseconds to obtain an IP address from the DHCP server.

Example: Configuring the DNS operation

Network configuration

As shown in Figure 6, configure a DNS operation to test whether the AP can perform address resolution through the DNS server and test the resolution time.

Figure 6 Network diagram

‌

Procedure

# Assign IP addresses to interfaces, as shown in Figure 6. (Details not shown.)

# Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

# Create a DNS operation.

<AP> system-view

[AP] nqa entry admin test1

[AP-nqa-admin-test1] type dns

# Specify the IP address of the DNS server (10.2.2.2) as the destination address.

[AP-nqa-admin-test1-dns] destination ip 10.2.2.2

# Specify host.com as the domain name to be translated.

[AP-nqa-admin-test1-dns] resolve-target host.com

# Enable the saving of history records.

[AP-nqa-admin-test1-dns] history-record enable

[AP-nqa-admin-test1-dns] quit

# Start the DNS operation.

[AP] nqa schedule admin test1 start-time now lifetime forever

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

[AP] undo nqa schedule admin test1

Verifying the configuration

# Display the most recent result of the DNS operation.

[AP] display nqa result admin test1

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

Send operation times: 1 Receive response times: 1

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

Square-Sum of round trip time: 3844

Last succeeded probe time: 2011-11-10 10:49:37.3

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 DNS operation.

[AP] display nqa history admin test1

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

Index Response Status Time

1 62 Succeeded 2011-11-10 10:49:37.3

The output shows that it took the AP 62 milliseconds to translate domain name host.com into an IP address.

Example: Configuring the FTP operation

Network configuration

As shown in Figure 7, configure an FTP operation to test the time required for the AP to upload a file to the FTP server. The login username and password are admin and systemtest, respectively. The file to be transferred to the FTP server is config.txt.

Figure 7 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 7. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the AP:

# Create an FTP operation.

<AP> system-view

[AP] nqa entry admin test1

[AP-nqa-admin-test1] type ftp

# Specify the URL of the FTP server.

[AP-nqa-admin-test1-ftp] url ftp://10.2.2.2

# Specify 10.1.1.1 as the source IP address.

[AP-nqa-admin-test1-ftp] source ip 10.1.1.1

# Configure the device to upload file config.txt to the FTP server.

[AP-nqa-admin-test1-ftp] operation put

[AP-nqa-admin-test1-ftp] filename config.txt

# Set the username to admin for the FTP operation.

[AP-nqa-admin-test1-ftp] username admin

# Set the password to systemtest for the FTP operation.

[AP-nqa-admin-test1-ftp] password simple systemtest

# Enable the saving of history records.

[AP-nqa-admin-test1-ftp] history-record enable

[AP-nqa-admin-test1-ftp] quit

# Start the FTP operation.

[AP] nqa schedule admin test1 start-time now lifetime forever

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

[AP] undo nqa schedule admin test1

Verifying the configuration

# Display the most recent result of the FTP operation.

[AP] display nqa result admin test1

NQA entry (admin admin, tag test1) 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: 2011-11-22 10:07:28.6

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 FTP operation.

[AP] display nqa history admin test1

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

Index Response Status Time

1 173 Succeeded 2011-11-22 10:07:28.6

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

Example: Configuring the HTTP operation

Network configuration

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

Figure 8 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 8. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the AP:

# Create an HTTP operation.

<AP> system-view

[AP] nqa entry admin test1

[AP-nqa-admin-test1] type http

# Specify the URL of the HTTP server.

[AP-nqa-admin-test1-http] url http://10.2.2.2/index.htm

# Set the HTTP operation type to get (the default HTTP operation type).

[AP-nqa-admin-test1-http] operation get

# Configure the operation to use HTTP version 1.0 (the default HTTP version).

[AP-nqa-admin-test1-http] version v1.0

# Enable the saving of history records.

[AP-nqa-admin-test1-http] history-record enable

[AP-nqa-admin-test1-http] quit

# Start the HTTP operation.

[AP] nqa schedule admin test1 start-time now lifetime forever

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

[AP] undo nqa schedule admin test1

Verifying the configuration

# Display the most recent result of the HTTP operation.

[AP] display nqa result admin test1

NQA entry (admin admin, tag test1) 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: 2011-11-22 10:12:47.9

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 HTTP operation.

[AP] display nqa history admin test1

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

Index Response Status Time

1 64 Succeeded 2011-11-22 10:12:47.9

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

Example: Configuring the UDP jitter operation

Network configuration

As shown in Figure 9, configure a UDP jitter operation to test the jitter, delay, and round-trip time between the AP and the device.

Figure 9 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 9. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the device:

# Enable the NQA server.

<Device> system-view

[Device] nqa server enable

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

[Device] nqa server udp-echo 10.2.2.2 9000

4. Configure the AP:

# Create a UDP jitter operation.

<AP> system-view

[AP] nqa entry admin test1

[AP-nqa-admin-test1] type udp-jitter

# Specify 10.2.2.2 as the destination address of the operation.

[AP-nqa-admin-test1-udp-jitter] destination ip 10.2.2.2

# Set the destination port number to 9000.

[AP-nqa-admin-test1-udp-jitter] destination port 9000

# Configure the operation to repeat every 1000 milliseconds.

[AP-nqa-admin-test1-udp-jitter] frequency 1000

[AP-nqa-admin-test1-udp-jitter] quit

# Start the UDP jitter operation.

[AP] nqa schedule admin test1 start-time now lifetime forever

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

[AP] undo nqa schedule admin test1

Verifying the configuration

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

[AP] display nqa result admin test1

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

Send operation times: 10 Receive response times: 10

Min/Max/Average round trip time: 15/32/17

Square-Sum of round trip time: 3235

Last packet received time: 2011-05-29 13:56:17.6

Extended results:

Packet loss ratio: 0.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: 4 Min positive DS: 1

Max positive SD: 21 Max positive DS: 28

Positive SD number: 5 Positive DS number: 4

Positive SD sum: 52 Positive DS sum: 38

Positive SD average: 10 Positive DS average: 10

Positive SD square-sum: 754 Positive DS square-sum: 460

Min negative SD: 1 Min negative DS: 6

Max negative SD: 13 Max negative DS: 22

Negative SD number: 4 Negative DS number: 5

Negative SD sum: 38 Negative DS sum: 52

Negative SD average: 10 Negative DS average: 10

Negative SD square-sum: 460 Negative DS square-sum: 754

One way results:

Max SD delay: 15 Max DS delay: 16

Min SD delay: 7 Min DS delay: 7

Number of SD delay: 10 Number of DS delay: 10

Sum of SD delay: 78 Sum of DS delay: 85

Square-Sum of SD delay: 666 Square-Sum of DS delay: 787

SD lost packets: 0 DS lost packets: 0

Lost packets for unknown reason: 0

# Display the statistics of the UDP jitter operation.

[AP] display nqa statistics admin test1

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

NO. : 1

Start time: 2011-05-29 13:56:14.0

Life time: 47 seconds

Send operation times: 410 Receive response times: 410

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

Square-Sum of round trip time: 206176

Extended results:

Packet loss ratio: 0.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: 410

Min positive SD: 3 Min positive DS: 1

Max positive SD: 30 Max positive DS: 79

Positive SD number: 186 Positive DS number: 158

Positive SD sum: 2602 Positive DS sum: 1928

Positive SD average: 13 Positive DS average: 12

Positive SD square-sum: 45304 Positive DS square-sum: 31682

Min negative SD: 1 Min negative DS: 1

Max negative SD: 30 Max negative DS: 78

Negative SD number: 181 Negative DS number: 209

Negative SD sum: 181 Negative DS sum: 209

Negative SD average: 13 Negative DS average: 14

Negative SD square-sum: 46994 Negative DS square-sum: 3030

One way results:

Max SD delay: 46 Max DS delay: 46

Min SD delay: 7 Min DS delay: 7

Number of SD delay: 410 Number of DS delay: 410

Sum of SD delay: 3705 Sum of DS delay: 3891

Square-Sum of SD delay: 45987 Square-Sum of DS delay: 49393

SD lost packets: 0 DS lost packets: 0

Lost packets for unknown reason: 0

Example: Configuring the TCP operation

Network configuration

As shown in Figure 10, configure a TCP operation to test the time required for the AP to establish a TCP connection with the device.

Figure 10 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 10. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the device:

# Enable the NQA server.

<Device> system-view

[Device] nqa server enable

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

[Device] nqa server tcp-connect 10.2.2.2 9000

4. Configure the AP:

# Create a TCP operation.

<AP> system-view

[AP] nqa entry admin test1

[AP-nqa-admin-test1] type tcp

# Specify 10.2.2.2 as the destination IP address.

[AP-nqa-admin-test1-tcp] destination ip 10.2.2.2

# Set the destination port number to 9000.

[AP-nqa-admin-test1-tcp] destination port 9000

# Enable the saving of history records.

[AP-nqa-admin-test1-tcp] history-record enable

[AP-nqa-admin-test1-tcp] quit

# Start the TCP operation.

[AP] nqa schedule admin test1 start-time now lifetime forever

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

[AP] undo nqa schedule admin test1

Verifying the configuration

# Display the most recent result of the TCP operation.

[AP] display nqa result admin test1

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

Send operation times: 1 Receive response times: 1

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

Square-Sum of round trip time: 169

Last succeeded probe time: 2011-11-22 10:27:25.1

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.

[AP] display nqa history admin test1

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

Index Response Status Time

1 13 Succeeded 2011-11-22 10:27:25.1

The output shows that it took the AP 13 milliseconds to establish a TCP connection to port 9000 on the NQA server.

Example: Configuring the UDP echo operation

Network configuration

As shown in Figure 11, configure a UDP echo operation on the NQA client to test the round-trip time to the device. The destination port number is 8000.

Figure 11 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 11. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the device:

# Enable the NQA server.

<Device> system-view

[Device] nqa server enable

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

[Device] nqa server udp-echo 10.2.2.2 8000

4. Configure the AP:

# Create a UDP echo operation.

<AP> system-view

[AP] nqa entry admin test1

[AP-nqa-admin-test1] type udp-echo

# Specify 10.2.2.2 as the destination IP address.

[AP-nqa-admin-test1-udp-echo] destination ip 10.2.2.2

# Set the destination port number to 8000.

[AP-nqa-admin-test1-udp-echo] destination port 8000

# Enable the saving of history records.

[AP-nqa-admin-test1-udp-echo] history-record enable

[AP-nqa-admin-test1-udp-echo] quit

# Start the UDP echo operation.

[AP] nqa schedule admin test1 start-time now lifetime forever

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

[AP] undo nqa schedule admin test1

Verifying the configuration

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

[AP] display nqa result admin test1

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

Send operation times: 1 Receive response times: 1

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

Square-Sum of round trip time: 625

Last succeeded probe time: 2011-11-22 10:36:17.9

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.

[AP] display nqa history admin test1

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

Index Response Status Time

1 25 Succeeded 2011-11-22 10:36:17.9

The output shows that the round-trip time between the AP and port 8000 on the device is 25 milliseconds.

Example: Configuring the UDP tracert operation

Network configuration

As shown in Figure 12, configure a UDP tracert operation to determine the routing path from the AP to the device.

Figure 12 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 12. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the AP and the device can reach each other. (Details not shown.)

3. Execute the ip ttl-expires enable command on the intermediate devices and execute the ip unreachables enable command on the device.

4. Configure the AP:

# Create a UDP tracert operation.

<AP> system-view

[AP] nqa entry admin test1

[AP-nqa-admin-test1] type udp-tracert

# Specify 10.2.2.2 as the destination IP address.

[AP-nqa-admin-test1-udp-tracert] destination ip 10.2.2.2

# Set the destination port number to 33434.

[AP-nqa-admin-test1-udp-tracert] destination port 33434

# Configure the AP to perform three probes to each hop.

[AP-nqa-admin-test1-udp-tracert] probe count 3

# Set the probe timeout time to 500 milliseconds.

[AP-nqa-admin-test1-udp-tracert] probe timeout 500

# Configure the UDP tracert operation to repeat every 5000 milliseconds.

[AP-nqa-admin-test1-udp-tracert] frequency 5000

# Specify VLAN-interface 100 as the output interface for UDP packets.

[AP-nqa-admin-test1-udp-tracert] out interface vlan-interface 100

# Enable the no-fragmentation feature.

[AP-nqa-admin-test1-udp-tracert] no-fragment enable

# Set the maximum number of consecutive probe failures to 6.

[AP-nqa-admin-test1-udp-tracert] max-failure 6

# Set the TTL value to 1 for UDP packets in the start round of the UDP tracert operation.

[AP-nqa-admin-test1-udp-tracert] init-ttl 1

# Start the UDP tracert operation.

[AP] nqa schedule admin test1 start-time now lifetime forever

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

[AP] undo nqa schedule admin test1

Verifying the configuration

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

[AP] display nqa result admin test1

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

Send operation times: 6 Receive response times: 6

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

Square-Sum of round trip time: 1

Last succeeded probe time: 2013-09-09 14:46:06.2

Extended results:

Packet loss in test: 0%

Failures due to timeout: 0

Failures due to internal error: 0

Failures due to other errors: 0

UDP-tracert results:

TTL Hop IP Time

1 3.1.1.1 2016-09-09 14:46:03.2

2 10.2.2.2 2016-09-09 14:46:06.2

# Display the history records of the UDP tracert operation.

[AP] display nqa history admin test1

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

Index TTL Response Hop IP Status Time

1 2 2 10.2.2.2 Succeeded 2013-09-09 14:46:06.2

1 2 1 10.2.2.2 Succeeded 2013-09-09 14:46:05.2

1 2 2 10.2.2.2 Succeeded 2013-09-09 14:46:04.2

1 1 1 3.1.1.1 Succeeded 2013-09-09 14:46:03.2

1 1 2 3.1.1.1 Succeeded 2013-09-09 14:46:02.2

1 1 1 3.1.1.1 Succeeded 2013-09-09 14:46:01.2

Example: Configuring the voice operation

Network configuration

As shown in Figure 13, configure a voice operation to test jitters, delay, MOS, and ICPIF between the AP and the device.

Figure 13 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 13. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the AP and the device can reach each other. (Details not shown.)

3. Configure the device:

# Enable the NQA server.

<Device> system-view

[Device] nqa server enable

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

[Device] nqa server udp-echo 10.2.2.2 9000

4. Configure the AP:

# Create a voice operation.

<AP> system-view

[AP] nqa entry admin test1

[AP-nqa-admin-test1] type voice

# Specify 10.2.2.2 as the destination IP address.

[AP-nqa-admin-test1-voice] destination ip 10.2.2.2

# Set the destination port number to 9000.

[AP-nqa-admin-test1-voice] destination port 9000

[AP-nqa-admin-test1-voice] quit

# Start the voice operation.

[AP] nqa schedule admin test1 start-time now lifetime forever

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

[AP] undo nqa schedule admin test1

Verifying the configuration

# Display the most recent result of the voice operation.

[AP] display nqa result admin test1

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

Send operation times: 1000 Receive response times: 1000

Min/Max/Average round trip time: 31/1328/33

Square-Sum of round trip time: 2844813

Last packet received time: 2011-06-13 09:49:31.1

Extended results:

Packet loss ratio: 0.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

Voice results:

RTT number: 1000

Min positive SD: 1 Min positive DS: 1

Max positive SD: 204 Max positive DS: 1297

Positive SD number: 257 Positive DS number: 259

Positive SD sum: 759 Positive DS sum: 1797

Positive SD average: 2 Positive DS average: 6

Positive SD square-sum: 54127 Positive DS square-sum: 1691967

Min negative SD: 1 Min negative DS: 1

Max negative SD: 203 Max negative DS: 1297

Negative SD number: 255 Negative DS number: 259

Negative SD sum: 759 Negative DS sum: 1796

Negative SD average: 2 Negative DS average: 6

Negative SD square-sum: 53655 Negative DS square-sum: 1691776

One way results:

Max SD delay: 343 Max DS delay: 985

Min SD delay: 343 Min DS delay: 985

Number of SD delay: 1 Number of DS delay: 1

Sum of SD delay: 343 Sum of DS delay: 985

Square-Sum of SD delay: 117649 Square-Sum of DS delay: 970225

SD lost packets: 0 DS lost packets: 0

Lost packets for unknown reason: 0

Voice scores:

MOS value: 4.38 ICPIF value: 0

# Display the statistics of the voice operation.

[AP] display nqa statistics admin test1

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

NO. : 1

Start time: 2011-06-13 09:45:37.8

Life time: 331 seconds

Send operation times: 4000 Receive response times: 4000

Min/Max/Average round trip time: 15/1328/32

Square-Sum of round trip time: 7160528

Extended results:

Packet loss ratio: 0.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

Voice results:

RTT number: 4000

Min positive SD: 1 Min positive DS: 1

Max positive SD: 360 Max positive DS: 1297

Positive SD number: 1030 Positive DS number: 1024

Positive SD sum: 4363 Positive DS sum: 5423

Positive SD average: 4 Positive DS average: 5

Positive SD square-sum: 497725 Positive DS square-sum: 2254957

Min negative SD: 1 Min negative DS: 1

Max negative SD: 360 Max negative DS: 1297

Negative SD number: 1028 Negative DS number: 1022

Negative SD sum: 1028 Negative DS sum: 1022

Negative SD average: 4 Negative DS average: 5

Negative SD square-sum: 495901 Negative DS square-sum: 5419

One way results:

Max SD delay: 359 Max DS delay: 985

Min SD delay: 0 Min DS delay: 0

Number of SD delay: 4 Number of DS delay: 4

Sum of SD delay: 1390 Sum of DS delay: 1079

Square-Sum of SD delay: 483202 Square-Sum of DS delay: 973651

SD lost packets: 0 DS lost packets: 0

Lost packets for unknown reason: 0

Voice scores:

Max MOS value: 4.38 Min MOS value: 4.38

Max ICPIF value: 0 Min ICPIF value: 0

Example: Configuring the DLSw operation

Network configuration

As shown in Figure 14, configure a DLSw operation to test the response time of the DLSw device.

Figure 14 Network diagram

‌

Procedure

# Assign IP addresses to interfaces, as shown in Figure 14. (Details not shown.)

# Configure static routes or a routing protocol to make sure the AP and the device can reach each other. (Details not shown.)

# Create a DLSw operation.

<AP> system-view

[AP] nqa entry admin test1

[AP-nqa-admin-test1] type dlsw

# Specify 10.2.2.2 as the destination IP address.

[AP-nqa-admin-test1-dlsw] destination ip 10.2.2.2

# Enable the saving of history records.

[AP-nqa-admin-test1-dlsw] history-record enable

[AP-nqa-admin-test1-dlsw] quit

# Start the DLSw operation.

[AP] nqa schedule admin test1 start-time now lifetime forever

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

[AP] undo nqa schedule admin test1

Verifying the configuration

# Display the most recent result of the DLSw operation.

[AP] display nqa result admin test1

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

Send operation times: 1 Receive response times: 1

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

Square-Sum of round trip time: 361

Last succeeded probe time: 2016-11-22 10:40:27.7

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 DLSw operation.

[AP] display nqa history admin test1

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

Index Response Status Time

1 19 Succeeded 2011-11-22 10:40:27.7

The output shows that the response time of the DLSw device is 19 milliseconds.

Example: Configuring the path jitter operation

Network configuration

As shown in Figure 15, configure a path jitter operation to test the round trip time and jitters from the AP to Device B.

Figure 15 Network diagram

‌

Procedure

# Assign IP addresses to interfaces, as shown in Figure 15. (Details not shown.)

# Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

# Execute the ip ttl-expires enable command on Device B and execute the ip unreachables enable command on Device C.

# Create a path jitter operation.

<AP> system-view

[AP] nqa entry admin test1

[AP-nqa-admin-test1] type path-jitter

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

[AP-nqa-admin-test1-path-jitter] destination ip 10.2.2.2

# Configure the path jitter operation to repeat every 10000 milliseconds.

[AP-nqa-admin-test1-path-jitter] frequency 10000

[AP-nqa-admin-test1-path-jitter] quit

# Start the path jitter operation.

[AP] nqa schedule admin test1 start-time now lifetime forever

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

[AP] undo nqa schedule admin test1

Verifying the configuration

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

[AP] display nqa result admin test1

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

Hop IP 10.1.1.2

Basic Results

Send operation times: 10 Receive response times: 10

Min/Max/Average round trip time: 9/21/14

Square-Sum of round trip time: 2419

Extended Results

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

Path-Jitter Results

Jitter number: 9

Min/Max/Average jitter: 1/10/4

Positive jitter number: 6

Min/Max/Average positive jitter: 1/9/4

Sum/Square-Sum positive jitter: 25/173

Negative jitter number: 3

Min/Max/Average negative jitter: 2/10/6

Sum/Square-Sum positive jitter: 19/153

Hop IP 10.2.2.2

Basic Results

Send operation times: 10 Receive response times: 10

Min/Max/Average round trip time: 15/40/28

Square-Sum of round trip time: 4493

Extended Results

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

Path-Jitter Results

Jitter number: 9

Min/Max/Average jitter: 1/10/4

Positive jitter number: 6

Min/Max/Average positive jitter: 1/9/4

Sum/Square-Sum positive jitter: 25/173

Negative jitter number: 3

Min/Max/Average negative jitter: 2/10/6

Sum/Square-Sum positive jitter: 19/153

Example: Configuring the ARP template

Network configuration

As shown in Figure 16, configure an ARP template on the AP for a feature to perform the ARP operation to determine the availability of the ARP service on the device.

Figure 16 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 16. (Details not shown.)

2. Configure the AP:

# Create an ARP template named arp.

<AP> system-view

[AP] nqa template arp arp

# Specify 10.1.1.2 as the destination IP address for the probe packets.

[AP-nqatplt-arp-arp] destination ip 10.1.1.2

# Configure the NQA client to notify the feature of the successful operation event if the number of consecutive successful probes reaches 2.

[AP-nqatplt-arp-arp] reaction trigger probe-pass 2

# Configure the NQA client to notify the feature of the operation failure if the number of consecutive failed probes reaches 2.

[AP-nqatplt-arp-arp] reaction trigger probe-fail 2

Example: Configuring the ICMP template

Network configuration

As shown in Figure 17, configure an ICMP template for a feature to perform the ICMP echo operation from the AP to Device A.

Figure 17 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 17. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the AP:

# Create ICMP template icmp.

<AP> system-view

[AP] nqa template icmp icmp

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

[AP-nqatplt-icmp-icmp] destination ip 10.2.2.2

# Set the probe timeout time to 500 milliseconds for the ICMP echo operation.

[AP-nqatplt-icmp-icmp] probe timeout 500

# Configure the ICMP echo operation to repeat every 3000 milliseconds.

[AP-nqatplt-icmp-icmp] frequency 3000

# Set the adjusted interval to 2000 milliseconds.

[AP-nqatplt-icmp-icmp] frequency-adjustment 2000

# Configure the NQA client to notify the feature of the successful operation event if the number of consecutive successful probes reaches 2.

[AP-nqatplt-icmp-icmp] reaction trigger probe-pass 2

# Configure the NQA client to notify the feature of the operation failure if the number of consecutive failed probes reaches 2.

[AP-nqatplt-icmp-icmp] reaction trigger probe-fail 2

Example: Configuring the IMAP template

Network configuration

As shown in Figure 18, configure an IMAP template for a feature to perform the IMAP operation to determine the availability of the IMAP service on the device.

In the IMAP operation, the NQA client will try to log in to mailbox test on the IMAP server by using username admin and password 123456.

Figure 18 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 18. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the AP:

# Create an IMAP template named imap.

<AP> system-view

[AP] nqa template imap imap

# Specify 10.2.2.2 as the destination IP address.

[AP-nqatplt-imap-imap] destination ip 10.2.2.2

# Specify the login username and password.

[AP-nqatplt-imap-imap] username admin

[AP-nqatplt-imap-imap] password simple 123456

# Specify test as the mailbox name used for the IMAP operation.

[AP-nqatplt-imap-imap] mailbox test

# Configure the NQA client to notify the feature of the successful operation event if the number of consecutive successful probes reaches 2.

[AP-nqatplt-imap-imap] reaction trigger probe-pass 2

# Configure the NQA client to notify the feature of the operation failure if the number of consecutive failed probes reaches 2.

[AP-nqatplt-imap-imap] reaction trigger probe-fail 2

Example: Configuring the DNS template

Network configuration

As shown in Figure 19, configure a DNS template for a feature to perform the DNS operation. The operation tests whether the AP can perform the address resolution through the DNS server.

Figure 19 Network diagram

‌

Procedure

# Assign IP addresses to interfaces, as shown in Figure 19. (Details not shown.)

# Configure static routes or a routing protocol to make sure the AP and the DNS server can reach each other. (Details not shown.)

# Create DNS template dns.

<AP> system-view

[AP] nqa template dns dns

# Specify the IP address of the DNS server (10.2.2.2) as the destination IP address.

[AP-nqatplt-dns-dns] destination ip 10.2.2.2

# Specify host.com as the domain name to be translated.

[AP-nqatplt-dns-dns] resolve-target host.com

# Set the domain name resolution type to type A.

[AP-nqatplt-dns-dns] resolve-type A

# Specify 3.3.3.3 as the expected IP address.

[AP-nqatplt-dns-dns] expect ip 3.3.3.3

# Configure the NQA client to notify the feature of the successful operation event if the number of consecutive successful probes reaches 2.

[AP-nqatplt-dns-dns] reaction trigger probe-pass 2

# Configure the NQA client to notify the feature of the operation failure if the number of consecutive failed probes reaches 2.

[AP-nqatplt-dns-dns] reaction trigger probe-fail 2

Example: Configuring the POP3 template

Network configuration

As shown in Figure 20, configure a POP3 template for a feature to perform the POP3 operation to determine the availability of the POP3 service on the device.

In the POP3 operation, the NQA client will try to log in to the POP3 server by using username admin and password 123456.

Figure 20 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 20. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the AP:

# Create a POP3 template named pop3.

<AP> system-view

[AP] nqa template pop3 pop3

# Specify 10.2.2.2 as the destination IP address.

[AP-nqatplt-pop3-pop3] destination ip 10.2.2.2

# Specify the login username and password.

[AP-nqatplt-pop3-pop3] username admin

[AP-nqatplt-pop3-pop3] password simple 123456

# Configure the NQA client to notify the feature of the successful operation event if the number of consecutive successful probes reaches 2.

[AP-nqatplt-pop3-pop3] reaction trigger probe-pass 2

# Configure the NQA client to notify the feature of the operation failure if the number of consecutive failed probes reaches 2.

[AP-nqatplt-pop3-pop3] reaction trigger probe-fail 2

Example: Configuring RTSP template

Network configuration

As shown in Figure 21, configure an RTSP template for a feature to perform the RTSP operation to test the availability of the RTSP server.

Figure 21 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 21. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the RTSP server on the device. (Details not shown.)

4. Configure the AP:

# Create an RTSP template named rstp.

<AP> system-view

[AP] nqa template rtsp rtsp

# Specify rtsp://10.2.2.2/index.htm as the destination URL.

[AP-nqatplt-RTSP-RTSP] url rtsp://10.2.2.2/index.htm

# Set the RTSP request method to options.

[AP-nqatplt-rtsp-rtsp] request-method options

# Configure the expected status codes.

[AP-nqatplt-rtsp-rtsp] expect status 200 to 400

# Configure the NQA client to notify the feature of the successful operation event if the number of consecutive successful probes reaches 2.

[AP-nqatplt-rtsp-rtsp] reaction trigger probe-pass 2

# Configure the NQA client to notify the feature of the operation failure if the number of consecutive failed probes reaches 2.

[AP-nqatplt-rtsp-rtsp] reaction trigger probe-fail 2

Example: Configuring SMTP template

Network configuration

As shown in Figure 22, configure an SMTP template for a feature to perform the SMTP operation to test whether the NQA client can log in to the mailbox on the SMTP server.

Figure 22 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 22. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the AP:

# Create an SMTP template named smtp.

<AP>system-view

[AP] nqa template smtp smtp

# Specify 10.2.2.2 as the destination IP address.

[AP-nqatplt-smtp-smtp] destination ip 10.2.2.2

# Configure the NQA client to notify the feature of the successful operation event if the number of consecutive successful probes reaches 2.

[AP-nqatplt-smtp-smtp] reaction trigger probe-pass 2

# Configure the NQA client to notify the feature of the operation failure if the number of consecutive failed probes reaches 2.

[AP-nqatplt-smtp-smtp] reaction trigger probe-fail 2

Example: Configuring the TCP template

Network configuration

As shown in Figure 23, configure a TCP template for a feature to perform the TCP operation. The operation tests whether the AP can establish a TCP connection to the device.

Figure 23 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 23. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the device:

# Enable the NQA server.

<Device> system-view

[Device] nqa server enable

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

[Device] nqa server tcp-connect 10.2.2.2 9000

4. Configure the AP:

# Create a TCP template named tcp.

<AP> system-view

[AP] nqa template tcp tcp

# Specify 10.2.2.2 as the destination IP address.

[AP-nqatplt-tcp-tcp] destination ip 10.2.2.2

# Set the destination port number to 9000.

[AP-nqatplt-tcp-tcp] destination port 9000

# Configure the NQA client to notify the feature of the successful operation event if the number of consecutive successful probes reaches 2.

[AP-nqatplt-tcp-tcp] reaction trigger probe-pass 2

# Configure the NQA client to notify the feature of the operation failure if the number of consecutive failed probes reaches 2.

[AP-nqatplt-tcp-tcp] reaction trigger probe-fail 2

Example: Configuring the TCP half open template

Network configuration

As shown in Figure 24, configure a TCP half open template for a feature to test whether the device can provide the TCP service for the AP.

Figure 24 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 24. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the AP:

# Create a TCP half open template named test.

<AP> system-view

[AP] nqa template tcphalfopen test

# Specify 10.2.2.2 as the destination IP address.

[AP-nqatplt-tcphalfopen-test] destination ip 10.2.2.2

# Configure the NQA client to notify the feature of the successful operation event if the number of consecutive successful probes reaches 2.

[AP-nqatplt-tcphalfopen-test] reaction trigger probe-pass 2

# Configure the NQA client to notify the feature of the operation failure if the number of consecutive failed probes reaches 2.

[AP-nqatplt-tcphalfopen-test] reaction trigger probe-fail 2

Example: Configuring the UDP template

Network configuration

As shown in Figure 25, configure a UDP template for a feature to perform the UDP operation. The operation tests whether the AP can receive a response from device.

Figure 25 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 25. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the device:

# Enable the NQA server.

<Device> system-view

[Device] nqa server enable

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

[Device] nqa server udp-echo 10.2.2.2 9000

4. Configure the AP:

# Create a UDP template named udp.

<AP> system-view

[AP] nqa template udp udp

# Specify 10.2.2.2 as the destination IP address.

[AP-nqatplt-udp-udp] destination ip 10.2.2.2

# Set the destination port number to 9000.

[AP-nqatplt-udp-udp] destination port 9000

# Configure the NQA client to notify the feature of the successful operation event if the number of consecutive successful probes reaches 2.

[AP-nqatplt-udp-udp] reaction trigger probe-pass 2

# Configure the NQA client to notify the feature of the operation failure if the number of consecutive failed probes reaches 2.

[AP-nqatplt-udp-udp] reaction trigger probe-fail 2

Example: Configuring the HTTP template

Network configuration

As shown in Figure 26, configure an HTTP template for a feature to perform the HTTP operation. The operation tests whether the NQA client can get data from the HTTP server.

Figure 26 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 26. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the AP:

# Create an HTTP template named http.

<AP> system-view

[AP] nqa template http http

# Specify http://10.2.2.2/index.htm as the URL of the HTTP server.

[AP-nqatplt-http-http] url http://10.2.2.2/index.htm

# Set the HTTP operation type to get (the default HTTPS operation type).

[AP-nqatplt-http-http] operation get

# Configure the NQA client to notify the feature of the successful operation event if the number of consecutive successful probes reaches 2.

[AP-nqatplt-http-http] reaction trigger probe-pass 2

# Configure the NQA client to notify the feature of the operation failure if the number of consecutive failed probes reaches 2.

[AP-nqatplt-http-http] reaction trigger probe-fail 2

Example: Configuring the HTTPS template

Network configuration

As shown in Figure 27, configure an HTTPS template for a feature to test whether the NQA client can get data from the HTTPS server (the device).

Figure 27 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 27. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the AP:

# Configure an SSL client policy named abc, and make sure the AP can use the policy to connect to the HTTPS server. (Details not shown.)

# Create an HTTPS template named test.

<AP> system-view

[AP] nqa template https https

# Specify http://10.2.2.2/index.htm as the URL of the HTTPS server.

[AP-nqatplt-https-https] url https://10.2.2.2/index.htm

# Specify SSL client policy abc for the HTTPS template.

[AP-nqatplt-https-https] ssl-client-policy abc

# Set the HTTPS operation type to get (the default HTTPS operation type).

[AP-nqatplt-https-https] operation get

# Set the HTTPS version to 1.0 (the default HTTPS version).

[AP-nqatplt-https-https] version v1.0

# Configure the NQA client to notify the feature of the successful operation event if the number of consecutive successful probes reaches 2.

[AP-nqatplt-https-https] reaction trigger probe-pass 2

# Configure the NQA client to notify the feature of the operation failure if the number of consecutive failed probes reaches 2.

[AP-nqatplt-https-https] reaction trigger probe-fail 2

Example: Configuring the FTP template

Network configuration

As shown in Figure 28, configure an FTP template for a feature to perform the FTP operation. The operation tests whether the AP can upload a file to the FTP server. The login username and password are admin and systemtest, respectively. The file to be uploaded to the FTP server is config.txt.

Figure 28 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 28. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the AP:

# Create an FTP template named ftp.

<AP> system-view

[AP] nqa template ftp ftp

# Specify the URL of the FTP server.

[AP-nqatplt-ftp-ftp] url ftp://10.2.2.2

# Specify 10.1.1.1 as the source IP address.

[AP-nqatplt-ftp-ftp] source ip 10.1.1.1

# Configure the device to upload file config.txt to the FTP server.

[AP-nqatplt-ftp-ftp] operation put

[AP-nqatplt-ftp-ftp] filename config.txt

# Set the username to admin for the FTP server login.

[AP-nqatplt-ftp-ftp] username admin

# Set the password to systemtest for the FTP server login.

[AP-nqatplt-ftp-ftp] password simple systemtest

# Configure the NQA client to notify the feature of the successful operation event if the number of consecutive successful probes reaches 2.

[AP-nqatplt-ftp-ftp] reaction trigger probe-pass 2

# Configure the NQA client to notify the feature of the operation failure if the number of consecutive failed probes reaches 2.

[AP-nqatplt-ftp-ftp] reaction trigger probe-fail 2

Example: Configuring the RADIUS authentication template

Network configuration

As shown in Figure 29, configure a RADIUS authentication template for a feature to test whether the RADIUS server (the device) can provide authentication service for the AP. The username and password are admin and systemtest, respectively. The shared key is 123456 for secure RADIUS authentication.

Figure 29 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 29. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the RADIUS server on the device. (Details not shown.)

4. Configure the AP:

# Create a RADIUS authentication template named radius.

<AP> system-view

[AP] nqa template radius radius

# Specify 10.2.2.2 as the destination IP address of the operation.

[AP-nqatplt-radius-radius] destination ip 10.2.2.2

# Set the username to admin.

[AP-nqatplt-radius-radius] username admin

# Set the password to systemtest.

[AP-nqatplt-radius-radius] password simple systemtest

# Set the shared key to 123456 in plain text for secure RADIUS authentication.

[AP-nqatplt-radius-radius] key simple 123456

# Configure the NQA client to notify the feature of the successful operation event if the number of consecutive successful probes reaches 2.

[AP-nqatplt-radius-radius] reaction trigger probe-pass 2

# Configure the NQA client to notify the feature of the operation failure if the number of consecutive failed probes reaches 2.

[AP-nqatplt-radius-radius] reaction trigger probe-fail

Example: Configuring the SSL template

Network configuration

As shown in Figure 30, configure an SSL template for a feature to test whether the AP can establish an SSL connection to the SSL server on the device.

Figure 30 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 30. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the AP:

Configure an SSL client policy named abc, and make sure the AP can use the policy to connect to the SSL server on the device. (Details not shown.)

# Create an SSL template named ssl.

<AP> system-view

[AP] nqa template ssl ssl

# Set the destination IP address and port number to 10.2.2.2 and 9000, respectively.

[AP-nqatplt-ssl-ssl] destination ip 10.2.2.2

[AP-nqatplt-ssl-ssl] destination port 9000

# Specify SSL client policy abc for the SSL template.

[AP-nqatplt-ssl-ssl] ssl-client-policy abc

# Configure the NQA client to notify the feature of the successful operation event if the number of consecutive successful probes reaches 2.

[AP-nqatplt-ssl-ssl] reaction trigger probe-pass 2

# Configure the NQA client to notify the feature of the operation failure if the number of consecutive failed probes reaches 2.

[AP-nqatplt-ssl-ssl] reaction trigger probe-fail 2

Example: Configuring the WAP template

Network configuration

As shown in Figure 31, configure an WAP template for a feature to perform the WAP operation. The WAP operation tests whether the NQA client can connect to the WAP gateway and access a particular URL through the gateway.

Figure 31 Network diagram

‌

Procedure

1. Assign IP addresses to interfaces, as shown in Figure 31. (Details not shown.)

2. Configure static routes or a routing protocol to make sure the devices can reach each other. (Details not shown.)

3. Configure the WAP gateway on the device. (Details not shown.)

4. Configure the AP:

# Create a WAP template named wap.

<AP> system-view

[AP] nqa template wap wap

# Specify the destination IP address and port number for the WAP operation

[AP-nqatplt-wap-wap] destination ip 10.2.2.2

[AP-nqatplt-wap-wap] destination port 9201

# Specify the data expected in the response packet to determine a successful NQA operation.

[AP-nqatplt-wap-wap] expect hex-data a11a offset 10

# Specify the destination URL.

[AP-nqatplt-wap-wap] url http://wap.h3c.com

# Configure the NQA client to notify the feature of the successful operation event if the number of consecutive successful probes reaches 2.

[AP-nqatplt-wap-wap] reaction trigger probe-pass 2

# Configure the NQA client to notify the feature of the operation failure if the number of consecutive failed probes reaches 2.

[AP-nqatplt-wap-wap] reaction trigger probe-fail 2

16-Network Management and Monitoring Configuration Guide

Restrictions and guidelines

Procedure

About this task

Procedure

About this task

Procedure

About this task

Restrictions and guidelines

Procedure

About this task

Procedure

About this task

Procedure

About this task

Restrictions and guidelines

Procedure

About this task

Procedure

About this task

Restrictions and guidelines

Procedure

Configuring the TCP operation

About this task

Procedure

Configuring the UDP echo operation

About this task

Procedure

Configuring the UDP tracert operation

About this task

Restrictions and guidelines

Prerequisites

Procedure

About this task

Restrictions and guidelines

Procedure

About this task

Restrictions and guidelines

Procedure

About this task

Prerequisites

Procedure

Restrictions and guidelines

Procedure

About this task

Restrictions and guidelines

Procedure

About this task

Restrictions and guidelines

Procedure

About this task

Restrictions and guidelines

Procedure

Scheduling the NQA operation on the NQA client

About this task

Restrictions and guidelines

Procedure

About this task

Procedure

About this task

Procedure

About this task

Procedure

About this task

Prerequisites

Procedure

About this task

Procedure

About the SMTP template

Procedure

About this task

Procedure

About this task

Procedure

About this task

Restrictions and guidelines

Procedure

About this task

Procedure

About this task