If the payload length is smaller than the string length, only the first part of the string is filled. For example, if you configure the string as abcd and the payload size as 3 bytes, abc is filled.

If the payload length is greater than the string length, the system fills the payload with the string cyclically until the payload is full. For example, if you configure the string as abcd and the payload size as 6 bytes, abcdab is filled.

How the string is filled varies with operation types:

· For an ICMP echo operation, the string fills the whole payload of ICMP echo requests.

· For a UDP echo operation, the first 5 bytes of the payload of a UDP packet are for special purpose, so the string fills the remaining part of payload.

· For a UDP jitter operation, the first 68 bytes of the payload of a UDP packet are for special purpose, so the string fills the remaining part of the payload.

Examples

# Configure string abcd to be filled in the payload of an ICMP echo request.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] data-fill abcd

data-size

Use data-size to configure the size of the payload in each ICMP echo request of the ICMP echo operation or in each UDP packet of the UDP echo, or UDP jitter operation.

Use undo data-size to restore the default.

Syntax

data-size size

undo data-size

Views

ICMP echo operation view, UDP echo operation view, UDP jitter operation view

Default command level

2: System level

Parameters

size: Specifies the size of the payload in each probe packet in bytes. The value is in the range of 20 to 8100 for probe packets of the ICMP echo or UDP echo operation, and 68 to 8100 for probe packets of the UDP jitter operation.

Usage guidelines

Table 1 Default payload size of a probe packet

Test type	Codec type	Default value (in bytes)
ICMP echo	N/A	100
UDP echo	N/A	100
UDP jitter	N/A	100

Configure the size of the payload in each probe packet correctly. If the traffic amount is large in the network, configure a smaller payload size to reduce network burden. If runt packets are required to be transmitted in the network, configure a bigger payload size to avoid packet loss.

Examples

# Configure the size of the payload in each ICMP echo request as 80 bytes.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] data-size 80

description (any NQA operation view)

Use description to configure a description for an NQA operation, such as the operation type or purpose.

Use undo description to remove the description.

Syntax

description text

undo description

Default

No description is configured for an NQA operation.

Views

Any NQA operation view

Default command level

2: System level

Parameters

text: Specifies a case-sensitive string of 1 to 200 characters.

Examples

# Configure the description for an NQA operation as icmp-probe.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] description icmp-probe

destination ip

Use destination ip to configure the destination IP address for the operation.

Use undo destination ip to remove the destination IP address.

Syntax

destination ip ip-address

undo destination ip

Default

No destination IP address is configured for the operation.

Views

FTP operation view, HTTP operation view, ICMP echo operation view, SNMP operation view, TCP operation view, UDP echo operation view, UDP jitter operation view

Default command level

2: System level

Parameters

ip-address: Specifies the destination IP address of the operation.

Examples

# Configure the destination IP address of the ICMP echo operation as 10.1.1.1.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] destination ip 10.1.1.1

destination port

Use destination port to configure the destination port number for the operation.

Use undo destination port to remove the destination port number.

Syntax

destination port port-number

undo destination port

Default

No destination port number is configured for the operation.

Views

TCP operation view, UDP echo operation view, UDP jitter operation view

Default command level

2: System level

Parameters

port-number: Specifies the destination port number of the operation, in the range of 1 to 65535.

Usage guidelines

Do not perform the UDP jitter operation on any well-known port from 1 to 1023. Otherwise, the operation fails or the service on that port becomes unavailable.

Examples

# Configure the destination port number of the UDP echo operation as 9000.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-udp-echo] destination port 9000

display nqa history

Use display nqa history to display the history records of the specified or all NQA operations.

Syntax

display nqa history [ admin-name operation-tag ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

admin-name operation-tag: Displays the history records of an NQA operation. The admin-name argument represents the name of the administrator who creates the NQA operation, and is a case-insensitive string of 1 to 32 characters. The operation-tag argument represents the operation tag, and is a case-insensitive string of 1 to 32 characters.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

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

Examples

# Display the history records of the NQA operation with the administrator name administrator and the operation tag test.

<Sysname> display nqa history administrator test

NQA entry (admin administrator, tag test) history record(s):

Index Response Status Time

10 329 Succeeded 2007-04-29 20:54:26.5

9 344 Succeeded 2007-04-29 20:54:26.2

8 328 Succeeded 2007-04-29 20:54:25.8

7 328 Succeeded 2007-04-29 20:54:25.5

6 328 Succeeded 2007-04-29 20:54:25.1

5 328 Succeeded 2007-04-29 20:54:24.8

4 328 Succeeded 2007-04-29 20:54:24.5

3 328 Succeeded 2007-04-29 20:54:24.1

2 328 Succeeded 2007-04-29 20:54:23.8

1 328 Succeeded 2007-04-29 20:54:23.4

Table 2 Command output

Field	Description
Index	History record number.
Response	Round-trip time if the operation succeeds, timeout time upon timeout, or 0 if the operation cannot be completed (in milliseconds).
Status	Status value of operation results: · Succeeded. · Unknown error. · Internal error. · Timeout.
Time	Time when the operation was completed.

display nqa reaction counters

Use display nqa reaction counters to display the current monitoring results of reaction entries.

Syntax

display nqa reaction counters [ admin-name operation-tag [ item-number ] ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

admin-name operation-tag: Displays the current monitoring results of reaction entries in an NQA operation. If no operation is specified, the monitoring results of all reaction entries of all NQA operations are displayed. The admin-name argument represents the name of the administrator who creates the NQA operation, and is a case-insensitive string of 1 to 32 characters. The operation-tag argument represents the operation tag, and is a case-insensitive string of 1 to 32 characters.

item-number: Displays the current monitoring results of a specific reaction entry. If no reaction entry is provided, the results of all reaction entries are displayed. The item-number argument represents the reaction entry ID in the range of 1 to 10.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

If the threshold type is average value, the monitoring results are invalid.

The monitoring results are accumulated after the NQA operation starts and are not cleared after the operation completes.

Examples

# Display the monitoring results of all reaction entries of the ICMP echo operation with the administrator name admin and the operation tag test.

<Sysname> display nqa reaction counters admin test

NQA entry (admin admin, tag test) reaction counters:

Index Checked Element Threshold Type Checked Num Over-threshold Num

1 probe-duration accumulate 12 4

2 probe-duration average - -

3 probe-duration consecutive 160 56

4 probe-fail accumulate 12 0

5 probe-fail consecutive 162 2

Table 3 Command output

Field	Description
Index	ID of a reaction entry.
Checked Element	Monitored performance metric.
Threshold Type	Threshold type.
Checked Num	Number of targets that have been monitored for data collection.
Over-threshold Num	Number of threshold violations.

Table 4 Description of the threshold monitoring fields

Monitored performance metric	Threshold type	Collect data in	Checked Num	Over-threshold Num
probe-duration	accumulate	Probes after the group starts.	Number of finished probes after the operation starts.	Number of probes of which the duration exceeds the threshold after the operation starts.
	average	N/A	N/A	N/A
	consecutive	Probes after the operation starts.	Number of finished probes after the operation starts.	Number of probes of which the duration exceeds the threshold after the operation starts.
probe-fail	accumulate	Probes after the operation starts.	Number of finished probes after the operation starts.	Number of probe failures after the operation starts.
probe-fail	consecutive	Probes after the operation starts.	Number of finished probes after the operation starts.	Number of probe failures after the operation starts.
RTT	accumulate	Packets sent after the operation starts.	Number of packets sent after the operation starts.	Number of packets of which the round-trip time exceeds the threshold after the operation starts.
RTT	average	N/A	N/A	N/A
jitter-DS/jitter-SD	accumulate	Packets sent after the operation starts.	Number of packets sent after the operation starts.	Number of packets of which the one-way jitter exceeds the threshold after the operation starts.
jitter-DS/jitter-SD	average	N/A	N/A	N/A
OWD-DS/OWD-SD	N/A	Packets sent after the operation starts.	Number of packets sent after the operation starts.	Number of packets of which the one-way delay exceeds the threshold after the operation starts.
packet-loss	accumulate	Packets sent after the operation starts.	Number of packets sent after the operation starts.	Total packet loss after the operation starts.

display nqa result

Use display nqa result to display the result of the specified NQA operation.

Syntax

display nqa result [ admin-name operation-tag ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

admin-name operation-tag: Displays the results of the specified NQA operation. If no operation is specified, the results of all operations are displayed. The admin-name argument represents the name of the administrator who creates the NQA operation, and is a case-insensitive string of 1 to 32 characters. The operation-tag argument represents the operation tag, and is a case-insensitive string of 1 to 32 characters.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display the results of the UDP jitter operation.

<Sysname> display nqa result admin test

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

Destination IP address: 192.168.1.42

Send operation times: 10 Receive response times: 10

Min/Max/Average round trip time: 15/46/26

Square-Sum of round trip time: 8103

Last succeeded probe time: 2008-05-29 10:56:38.7

Extended results:

Packet loss in test: 0%

Failures due to timeout: 0

Failures due to disconnect: 0

Failures due to no connection: 0

Failures due to sequence error: 0

Failures due to internal error: 0

Failures due to other errors: 0

Packet(s) arrived late: 0

UDP-jitter results:

RTT number: 10

Min positive SD: 8 Min positive DS: 8

Max positive SD: 18 Max positive DS: 8

Positive SD number: 5 Positive DS number: 2

Positive SD sum: 75 Positive DS sum: 32

Positive SD average: 15 Positive DS average: 16

Positive SD square sum: 1189 Positive DS square sum: 640

Min negative SD: 8 Min negative DS: 1

Max negative SD: 24 Max negative DS: 30

Negative SD number: 4 Negative DS number: 7

Negative SD sum: 56 Negative DS sum: 99

Negative SD average: 14 Negative DS average: 14

Negative SD square sum: 946 Negative DS square sum: 1495

One way results:

Max SD delay: 22 Max DS delay: 23

Min SD delay: 7 Min DS delay: 7

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

Sum of SD delay: 125 Sum of DS delay: 132

Square sum of SD delay: 1805 Square sum of DS delay: 1988

SD lost packet(s): 0 DS lost packet(s): 0

Lost packet(s) for unknown reason: 0

Table 5 Command output

Field	Description
Destination IP address	IP address of the destination.
Send operation times	Number of operations.
Receive response times	Number of response times.
Min/Max/Average round trip time	Minimum/maximum/average round-trip time in milliseconds.
Square-Sum of round trip time	Square sum of round-trip time.
Last succeeded probe time	Time when the last successful operation was finished.
Packet loss in test	Average packet loss ratio.
Min positive SD	Minimum positive jitter from source to destination.
Min positive DS	Minimum positive jitter from destination to source.
Max positive SD	Maximum positive jitter from source to destination.
Max positive DS	Maximum positive jitter from destination to source.
Positive SD number	Number of positive jitters from source to destination.
Positive DS number	Number of positive jitters from destination to source.
Positive SD sum	Sum of positive jitters from source to destination.
Positive DS sum	Sum of positive jitters from destination to source.
Positive SD average	Average positive jitter from source to destination.
Positive DS average	Average positive jitter from destination to source.
Positive SD square sum	Square sum of positive jitters from source to destination.
Positive DS square sum	Square sum of positive jitters from destination to source.
Min negative SD	Minimum absolute value among negative jitters from source to destination.
Min negative DS	Minimum absolute value among negative jitters from destination to source.
Max negative SD	Maximum absolute value among negative jitters from source to destination.
Max negative DS	Maximum absolute value among negative jitters from destination to source.
Negative SD number	Number of negative jitters from source to destination.
Negative DS number	Number of negative jitters from destination to source.
Negative SD sum	Sum of absolute values of negative jitters from source to destination.
Negative DS sum	Sum of absolute values of negative jitters from destination to source.
Negative SD average	Average absolute value of negative jitters from source to destination.
Negative DS average	Average absolute value of negative jitters from destination to source.
Negative SD square sum	Square sum of negative jitters from source to destination.
Negative DS square sum	Square sum of negative jitters from destination to source.
One way results	Unidirectional delay operation result. It is displayed for a UDP jitter operation.
Max SD delay	Maximum delay from source to destination.
Max DS delay	Maximum delay from destination to source.
Min SD delay	Minimum delay from source to destination.
Min DS delay	Minimum delay from destination to source.
Number of SD delay	Number of delays from source to destination.
Number of DS delay	Number of delays from destination to source.
Sum of SD delay	Sum of delays from source to destination.
Sum of DS delay	Sum of delays from destination to source.
Square sum of SD delay	Square sum of delays from source to destination.
Square sum of DS delay	Square sum of delays from destination to source.
SD lost packet(s)	Number of lost packets from the source to the destination.
DS lost packet(s)	Number of lost packets from the destination to the source.
Lost packet(s) for unknown reason	Number of lost packets for unknown reasons.

display nqa statistics

Use display nqa statistics to display statistics for the specified or all operations.

Syntax

display nqa statistics [ admin-name operation-tag ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

admin-name operation-tag: Displays the statistics of the specified NQA operation. If no operation is specified, the statistics of all operations are displayed. The admin-name argument represents the name of the administrator who creates the NQA operation, and is a case-insensitive string of 1 to 32 characters. The operation-tag argument represents the operation tag, and is a case-insensitive string of 1 to 32 characters.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Usage guidelines

The statistics are generated after the NQA operation completes. If you issue the display nqa statistics command before the operation completes, the statistics are displayed as all 0s.

If a reaction entry is configured, the command displays the monitoring results of the reaction entry in the period specified by the statistics internal command. If the threshold type is average value, the monitoring results are invalid.

Examples

# Display the statistics of the UDP jitter operation.

<Sysname> display nqa statistics admin test

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

NO. : 1

Destination IP address: 1.1.1.2

Start time: 2007-01-01 09:33:22.3

Life time: 23 seconds

Send operation times: 100 Receive response times: 100

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

Square-Sum of round trip time: 24360

Extended results:

Packet loss in test: 0%

Failures due to timeout: 0

Failures due to disconnect: 0

Failures due to no connection: 0

Failures due to sequence error: 0

Failures due to internal error: 0

Failures due to other errors: 0

Packet(s) arrived late: 0

UDP-jitter results:

RTT number: 550

Min positive SD: 1 Min positive DS: 1

Max positive SD: 7 Max positive DS: 1

Positive SD number: 220 Positive DS number: 97

Positive SD sum: 283 Positive DS sum: 287

Positive SD average: 1 Positive DS average: 2

Positive SD square sum: 709 Positive DS square sum: 1937

Min negative SD: 2 Min negative DS: 1

Max negative SD: 10 Max negative DS: 1

Negative SD number: 81 Negative DS number: 94

Negative SD sum: 556 Negative DS sum: 191

Negative SD average: 6 Negative DS average: 2

Negative SD square sum: 4292 Negative DS square sum: 967

One way results:

Max SD delay: 5 Max DS delay: 5

Min SD delay: 1 Min DS delay: 1

Number of SD delay: 550 Number of DS delay: 550

Sum of SD delay: 1475 Sum of DS delay: 1201

Square sum of SD delay: 5407 Square sum of DS delay: 3959

SD lost packet(s): 0 DS lost packet(s): 0

Lost packet(s) for unknown reason: 0

Reaction statistics:

Index Checked Element Threshold Type Checked Num Over-threshold Num

1 jitter-DS accumulate 90 25

2 jitter-SD average - -

3 OWD-DS - 100 24

4 OWD-SD - 100 13

5 packet-loss accumulate 0 0

6 RTT accumulate 100 52

Table 6 Command output

Field	Description
No.	Statistics group number.
Destination IP address	IP address of the destination.
Start time	Time when the operation started.
Life time	Operation duration in seconds.
Send operation times	Number of probe packets sent.
Receive response times	Number of response packets received.
Min/Max/Average round trip time	Minimum/maximum/average round-trip time in milliseconds.
Square-Sum of round trip time	Square sum of round-trip time.
Packet loss in test	Average packet loss ratio.
Failures due to timeout	Number of timeout occurrences in a test.
Failures due to disconnect	Number of disconnections by the peer.
Failures due to no connection	Number of failures to connect with the peer.
Failures due to sequence error	Number of failures due to out-of-sequence packets.
Failures due to internal error	Number of failures due to internal errors.
Failures due to other errors	Failures due to other errors.
Packet(s) arrived late	Number of response packets received after a probe times out.
UDP-jitter results	UDP jitter operation results. It is available only for UDP jitter operation.
RTT number	Number of response packets received.
Min positive SD	Minimum positive jitter from source to destination.
Min positive DS	Minimum positive jitter from destination to source.
Max positive SD	Maximum positive jitter from source to destination.
Max positive DS	Maximum positive jitter from destination to source.
Positive SD number	Number of positive jitters from source to destination.
Positive DS number	Number of positive jitters from destination to source.
Positive SD sum	Sum of positive jitters from source to destination.
Positive DS sum	Sum of positive jitters from destination to source.
Positive SD average	Average of positive jitters from source to destination.
Positive DS average	Average of positive jitters from destination to source.
Positive SD square sum	Square sum of positive jitters from source to destination.
Positive DS square sum	Square sum of positive jitters from destination to source.
Min negative SD	Minimum absolute value among negative jitters from source to destination.
Min negative DS	Minimum absolute value among negative jitters from destination to source.
Max negative SD	Maximum absolute value among negative jitters from source to destination.
Max negative DS	Maximum absolute value among negative jitters from destination to source.
Negative SD number	Number of negative jitters from source to destination.
Negative DS number	Number of negative jitters from destination to source.
Negative SD sum	Sum of absolute values of negative jitters from source to destination.
Negative DS sum	Sum of absolute values of negative jitters from destination to source.
Negative SD average	Average absolute value of negative jitters from source to destination.
Negative DS average	Average absolute value of negative jitters from destination to source.
Negative SD square sum	Square sum of negative jitters from source to destination.
Negative DS square sum	Square sum of negative jitters from destination to source.
One way results	Unidirectional delay operation result. It is displayed on for a UDP Jitter operation.
Max SD delay	Maximum delay from source to destination.
Max DS delay	Maximum delay from destination to source.
Min SD delay	Minimum delay from source to destination.
Min DS delay	Minimum delay from destination to source.
Number of SD delay	Number of delays from source to destination.
Number of DS delay	Number of delays from destination to source.
Sum of SD delay	Sum of delays from source to destination.
Sum of DS delay	Sum of delays from destination to source.
Square sum of SD delay	Square sum of delays from source to destination.
Square sum of DS delay	Square sum of delays from destination to source.
SD lost packet(s)	Number of lost packets from the source to the destination.
DS lost packet(s)	Number of lost packets from the destination to the source.
Reaction statistics	Statistics about the reaction entry in the counting interval.
Index	ID of a reaction entry.
Checked Element	Monitored element.
Threshold Type	Threshold type.
Checked Num	Number of targets that have been monitored for data collection.
Over-threshold Num	Number of threshold violations.

Table 7 Description of the threshold monitoring fields

Monitored performance metric	Threshold type	Collect data in	Checked Num	Over-threshold Num
probe-duration	accumulate	Probes in the counting interval.	Number of finished probes in the counting interval.	Number of probes of which the duration exceeds the threshold in the counting interval.
	average	N/A	N/A	N/A
	consecutive	Probes in the counting interval.	Number of finished probes in the counting interval.	Number of probes of which the duration exceeds the threshold in the counting interval.
probe-fail	accumulate	Probes in the counting interval.	Number of finished probes in the counting interval.	Number of probe failures in the counting interval.
probe-fail	consecutive	Probes in the counting interval.	Number of finished probes in the counting interval.	Number of probe failures in the counting interval.
RTT	accumulate	Packets sent in the counting interval.	Number of packets sent in the counting interval.	Number of packets of which the round-trip time exceeds the threshold in the counting interval.
RTT	average	N/A	N/A	N/A
jitter-DS/jitter-SD	accumulate	Packets sent in the counting interval.	Number of packets sent in the counting interval.	Number of packets of which the one-way jitter exceeds the threshold in the counting interval.
jitter-DS/jitter-SD	average	N/A	N/A	N/A
OWD-DS/OWD-SD	N/A	Packets sent in the counting interval.	Number of packets sent in the counting interval.	Number of packets of which the one-way delay exceeds the threshold in the counting interval.
packet-loss	accumulate	Packets sent in the counting interval.	Number of packets sent in the counting interval.	Number of packet loss in the counting interval.

Related commands

statistics interval

filename

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

Use undo filename to restore the default.

Syntax

filename filename

undo filename

Default

No file is specified.

Views

FTP operation view

Default command level

2: System level

Parameters

filename: Specifies the name of a file, a case-sensitive string of 1 to 200 characters.

Examples

# Specify the file to be transferred between the FTP server and the FTP client as config.txt.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type ftp

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

frequency

Use frequency to specify the interval at which the NQA operation repeats. If the operation is not completed when the interval is reached, the next operation does not start.

Use undo frequency to restore the default.

Syntax

frequency interval

undo frequency

Default

The interval between two consecutive operations is 0 milliseconds.

Views

Any NQA operation view

Default command level

2: System level

Parameters

interval: Specifies the interval in milliseconds between two consecutive operations, in the range of 0 to 604800000. An interval of 0 sets the operation to be performed only once, and to not collect any statistics.

Examples

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

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] frequency 1000

history-record enable

Use history-record enable to enable the saving of history records of an NQA operation.

Use undo history-record enable to disable the history records saving function.

Syntax

history-record enable

undo history-record enable

Default

The history records of an NQA operation are not saved.

Views

Any NQA operation view

Default command level

2: System level

Usage guidelines

To view the history records of the NQA operation, use the display nqa history command.

If the history records saving function is disabled, the system does not save the history records of the NQA operation and the existing history records are also removed.

Examples

# Enable the history records saving function of an NQA operation.

<Sysname> system-view

[Sysname] nqa entry admin test

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

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

Related commands

display nqa history

history-record keep-time

Use history-record keep-time to set the lifetime of history records in the NQA operation.

Use undo history-record keep-time to restore the default.

Syntax

history-record keep-time keep-time

undo history-record keep-time

Default

The history records in an NQA operation are kept for 120 minutes.

Views

Any NQA operation view

Default command level

2: System level

Parameters

keep-time: Specifies how long the history records can be saved. The time is in the range of 1 to 1440 minutes.

Usage guidelines

When an NQA operation completes, the timer starts. All the records are removed when the lifetime is reached.

Examples

# Configure the lifetime of the history records in an NQA operation as 100 minutes.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] history-record keep-time 100

history-record number

Use history-record number to configure the maximum number of history records that can be saved in an NQA operation.

Use undo history-record number to restore the default.

Syntax

history-record number number

undo history-record number

Default

The maximum number of records that can be saved in an NQA operation is 50.

Views

Any NQA operation view

Default command level

2: System level

Parameters

number: Specifies the maximum number of history records that can be saved in an NQA operation. The value is in the range of 0 to 50.

Usage guidelines

If the number of history records in an NQA operation exceeds the maximum number, the earliest history record is removed.

Examples

# Configure the maximum number of history records that can be saved in an NQA operation as 10.

<Sysname> system-view

[Sysname] nqa entry admin test

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

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

http-version

Use http-version to specify the HTTP version used in the HTTP operation.

Use undo http-version to restore the default.

Syntax

http-version v1.0

undo http-version

Default

HTTP 1.0 is used in the HTTP operation.

Views

HTTP operation view

Default command level

2: System level

Parameters

v1.0: Uses HTTP version 1.0.

Examples

# Configure the HTTP operation to use the HTTP version 1.0.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type http

[Sysname-nqa-admin-test-http] http-version v1.0

mode

Use mode to set the data transmission mode for the FTP operation.

Use undo mode to restore the default.

Syntax

mode { active | passive }

undo mode

Default

The data transmission mode use by the FTP operation is active.

Views

FTP operation view

Default command level

2: System level

Parameters

active: Sets the data transmission mode to active for the FTP operation. In this mode, the FTP server initiates a connection request.

passive: Sets the data transmission mode to passive for the FTP operation. In this mode, the FTP client initiates a connection request.

Examples

# Set the data transmission mode to passive for the FTP operation.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type ftp

[Sysname-nqa-admin-test-ftp] mode passive

next-hop

Use next-hop to specify the next hop for the ICMP echo operation.

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

Syntax

next-hop ip-address

undo next-hop

Default

No next hop IP address is configured for the ICMP echo operation.

Views

ICMP echo operation view

Default command level

2: System level

Parameters

ip-address: Specifies the IP address of the next hop.

Usage guidelines

If multiple paths exist between the source and destination devices, you can specify the device directly connected to the source device on one of the paths as the next hop for the ICMP echo operation.

Examples

# Configure the next hop IP address as 10.1.1.1 for the ICMP echo operation.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] next-hop 10.1.1.1

nqa

Use nqa to create an NQA operation and enter its view.

Use undo nqa to remove the operation.

Syntax

nqa entry admin-name operation-tag

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

Default

No NQA operation is created.

Views

System view

Default command level

2: System level

Parameters

admin-name: Specifies the name of the administrator creating the NQA operation, a case-insensitive string of 1 to 32 characters excluding hyphens (-).

operation-tag: Specifies the tag of the operation, a case-insensitive string of 1 to 32 characters excluding hyphens (-).

all: Removes all NQA operations.

Usage guidelines

If the operation type has been configured for the operation, this command directly places you to NQA operation view.

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

Examples

# Create an NQA operation with administrator name admin and operation tag test, and enter NQA operation view.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test]

nqa agent enable

Use nqa agent enable to enable the NQA client.

Use undo nqa agent enable to disable the NQA client and stop all the operations being performed.

Syntax

nqa agent enable

undo nqa agent enable

Default

The NQA client is enabled.

Views

System view

Default command level

2: System level

Examples

# Enable the NQA client.

<Sysname> system-view

[Sysname] nqa agent enable

Related commands

nqa server enable

nqa agent max-concurrent

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

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

Syntax

nqa agent max-concurrent number

undo nqa agent max-concurrent

Default

The NQA client can simultaneously perform a maximum of two operations.

Views

System view

Default command level

2: System level

Parameters

number: Specifies the maximum number of operations that the NQA client can simultaneously perform. The value range is 1 to 3.

Examples

# Configure the maximum number of operations that the NQA client can simultaneously perform as 3.

<Sysname> system-view

[Sysname] nqa agent max-concurrent 3

nqa schedule

Use nqa schedule to configure the scheduling parameters for an NQA operation.

Use undo nqa schedule to stop the operation.

Syntax

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

undo nqa schedule admin-name operation-tag

Views

System view

Default command level

2: System level

Parameters

admin-name: Specifies the administrator name, a case-insensitive string of 1 to 32 characters.

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

start-time: Specifies the start time and date of the NQA operation.

hh:mm:ss: Specifies the start time of an NQA operation.

yyyy/mm/dd: Specifies the start date of an NQA operation. The default value is the current system time, and yyyy is in the range of 2000 to 2035.

now: Starts the operation immediately.

lifetime: Specifies the duration of the operation.

lifetime: Specifies the duration of the operation in seconds, in the range of 1 to 2147483647.

forever: Performs the operation until you stop it with the undo nqa schedule command.

Usage guidelines

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

To view the current system time, use the display clock command.

Examples

# Configure the scheduling parameters for the operation with the administrator name admin and operation tag test. The start time and duration of the operation are 08:08:08 2008/08/08 and 1000 seconds.

<Sysname> system-view

[Sysname] nqa schedule admin test start-time 08:08:08 2008/08/08 lifetime 1000

Related commands

display clock (Fundamentals Command Reference)

operation (FTP operation view)

Use operation to specify the operation type for the FTP operation.

Use undo operation to restore the default.

Syntax

operation { get | put }

undo operation

Default

The operation type is get.

Views

FTP operation view

Default command level

2: System level

Parameters

get: Gets a file from the FTP server.

put: Transfers a file to the FTP server.

Usage guidelines

When you execute the put command, the NQA client creates a file named file-name of fixed size on the FTP server. The file-name argument does not represent any file on the NQA client. When you execute the get command, the client does not save the file obtained from the FTP server.

Examples

# Specify the operation type for the FTP operation as put.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type ftp

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

operation (HTTP operation view)

Use operation to specify the operation type for the HTTP operation.

Use undo operation to restore the default.

Syntax

operation { get | post }

undo operation

Default

The operation type is get.

Views

HTTP operation view

Default command level

2: System level

Parameters

get: Gets data from the HTTP server.

post: Transfers data to the HTTP server.

Examples

# Specify the operation type for the HTTP operation as post.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type http

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

operation interface

Use operation interface to specify the interface to perform the DHCP operation. The specified interface must be up. Otherwise, no probe packets can be sent out.

Use undo operation interface to restore the default.

Syntax

operation interface interface-type interface-number

undo operation interface

Default

No interface is specified to perform the DHCP operation.

Views

DHCP operation view

Default command level

2: System level

Parameters

interface-type interface-number: Specifies an interface by its type and number.

Usage guidelines

The specified interface simulates the DHCP client to acquire an IP address and it does not change its IP address. When the DHCP operation completes, the NQA client sends a packet to release the obtained IP address.

Examples

# Specify the interface VLAN-interface 2 to perform the DHCP operation.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type dhcp

[Sysname-nqa-admin-test-dhcp] operation interface vlan-interface 2

password (FTP operation view)

Use password to configure a password used to log in to the FTP server.

Use undo password to remove the configured password.

Syntax

password [ cipher | simple ] password

undo password

Default

No password is configured for logging in to the FTP server.

Views

FTP operation view

Default command level

2: System level

Parameters

cipher: Sets a ciphertext password.

simple: Sets a plaintext password.

password: Specifies the password used to log in to the FTP server. This argument is case sensitive. If simple is specified, it must be a plaintext string of 1 to 32 characters. If cipher is specified, it must be a ciphertext string of 1 to 73 characters. If neither cipher nor simple is specified, you set a plaintext password.

Usage guidelines

For secrecy, all keys, including keys configured in plain text, are saved in cipher text.

Examples

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

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type ftp

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

Related commands

· username

· operation

probe count

Use probe count to specify the probe times.

Use undo probe count to restore the default.

Syntax

probe count times

undo probe count

Default

An operation performs one probe.

Views

DHCP operation view, FTP operation view, HTTP operation view, ICMP echo operation view, SNMP operation view, TCP operation view, UDP echo operation view, UDP jitter operation view

Default command level

2: System level

Parameters

times: Specifies the probe times in the range of 1 to 15.

Usage guidelines

The following describes how different NQA operation types operate:

· A TCP operation sets up a connection.

· A UDP jitter operation sends a specific number of probe packets. The number of probe packets is configurable with the probe packet-number command.

· An FTP operation uploads or downloads a file.

· An HTTP operation gets a Web page.

· A DHCP operation gets an IP address through DHCP.

· An ICMP echo operation sends an ICMP echo request.

· A UDP echo operation sends a UDP packet.

· An SNMP operation sends one SNMPv1 packet, one SNMPv2c packet, and one SNMPv3 packet.

If an operation is to perform multiple probes, the system starts the next probe when it receives responses to packets sent in the first probe, or when the probe timeout time expires.

Examples

# Configure the ICMP echo operation to perform 10 probes.

<Sysname> system-view

[Sysname] nqa entry admin test

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

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

probe packet-interval

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

Use undo probe packet-interval to restore the default.

Syntax

probe packet-interval packet-interval

undo probe packet-interval

Default

The interval is 20 milliseconds.

Views

UDP jitter operation view

Default command level

2: System level

Parameters

packet-interval: Specifies the interval for sending packets, in the range of 10 to 60000 milliseconds.

Examples

# Configure the UDP jitter operation to send packets at an interval of 100 milliseconds.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-udp-jitter] probe packet-interval 100

probe packet-number

Use probe packet-number to configure the number of packets to be sent in one UDP jitter probe.

Use undo probe packet-number to restore the default.

Syntax

probe packet-number packet-number

undo probe packet-number

Default

An UDP jitter probe sends 10 packets.

Views

UDP jitter operation view

Default command level

2: System level

Parameters

packet-number: Specifies the number of packets to be sent per probe, in the range of 10 to 1000.

Examples

# Configure the UDP jitter probe to send 100 packets.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-udp-jitter] probe packet-number 100

probe packet-timeout

Use probe packet-timeout to configure the timeout time for waiting for a response in the UDP jitter operation.

Use undo probe packet-timeout to restore the default.

Syntax

probe packet-timeout packet-timeout

undo probe packet-timeout

Default

The response timeout time in the UDP jitter operation is 3000 milliseconds.

Views

UDP jitter

Default command level

2: System level

Parameters

packet-timeout: Specifies the timeout time in milliseconds for waiting for a response in the UDP jitter operation. The value is in the range of 10 to 3600000.

Examples

# Configure the timeout time for waiting for a response in the UDP jitter operation as 100 milliseconds.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-udp-jitter] probe packet-timeout 100

probe timeout

Use probe timeout to specify the probe timeout time. If a probe does not complete within the period, the probe is timed out.

Use undo probe timeout to restore the default.

Syntax

probe timeout timeout

undo probe timeout

Default

The timeout time of a probe is 3000 milliseconds.

Views

DHCP operation view, FTP operation view, HTTP operation view, ICMP echo operation view, SNMP operation view, TCP operation view, UDP echo operation view

Default command level

2: System level

Parameters

timeout: Specifies the probe timeout time in milliseconds. The value is in the range of 10 to 86400000 for the FTP or HTTP operation, and 10 to 3600000 for the DHCP, ICMP echo, SNMP, TCP, or UDP echo operation.

Usage guidelines

This command is not available for the UDP jitter operation.

Examples

# Configure the probe timeout time for the DHCP operation as 10000 milliseconds.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type dhcp

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

reaction checked-element { jitter-ds | jitter-sd }

Use reaction checked-element { jitter-ds | jitter-sd } to configure a reaction entry for monitoring one-way jitter in the NQA operation. You cannot edit a reaction entry. To change the attributes in a reaction entry, use undo reaction to delete the entry first and then configure a new one.

Use undo reaction to delete the specified reaction entry.

Syntax

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 } ]

undo reaction item-number

Default

No reaction entry for monitoring one-way jitter is configured.

Views

UDP jitter operation view

Default command level

2: System level

Parameters

item-number: Specifies a reaction entry ID in the range of 1 to 10.

jitter-ds: Specifies the destination-to-source jitter of each probe packet as the monitored element (or performance metric).

jitter-sd: Specifies source-to-destination jitter of each probe packet as the monitored element.

threshold-type: Specifies a threshold type.

accumulate accumulate-occurrences: Specifies the total number of threshold violations in the operation, in the range of 1 to 14999.

average: Specifies to check the average one-way jitter.

threshold-value: Specifies threshold values in milliseconds.

upper-threshold: Specifies the upper threshold in the range of 0 to 3600000.

lower-threshold: Specifies the lower threshold in the range of 0 to 3600000. It must not be greater than the upper threshold.

action-type: Specifies an action to be triggered. The default action is none.

none: Specifies the action of only displaying results on the terminal display.

trap-only: Specifies the action of displaying results on the terminal display and meanwhile sending SNMP trap messages to the NMS.

Usage guidelines

Only successful probe packets are monitored. Failed probe packets are not counted.

Examples

# Create reaction entry 1 for monitoring the average destination-to-source jitter of UDP jitter packets. Set the upper threshold to 50 milliseconds, and the lower threshold to 5 milliseconds. Before the NQA operation starts, the initial state of the reaction entry is invalid. After the operation, the average destination-to-source jitter is checked. If it exceeds the upper threshold, the state of the reaction entry is set to over-threshold. If it is below the lower threshold, the state is set to below-threshold. Once the state of the reaction entry changes, a trap message is generated and sent to the NMS.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-udp-jitter] reaction 1 checked-element jitter-ds threshold-type average threshold-value 50 5 action-type trap-only

# Create reaction entry 2 for monitoring the destination-to-source jitter of UDP jitter probe packets. Set the upper threshold to 50 milliseconds, and the lower threshold to 5 milliseconds. Before the NQA operation starts, the initial state of the reaction entry is invalid. After the operation, the destination-to-source jitter is checked against the threshold range. If the total number of threshold violations exceeds 100 (included), the state of the entry is set to over-threshold. Otherwise, the state of the entry is set to below-threshold. Once the state of the reaction entry changes, a trap message is generated and sent to the NMS.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-udp-jitter] reaction 2 checked-element jitter-ds threshold-type accumulate 100 threshold-value 50 5 action-type trap-only

reaction checked-element { owd-ds | owd-sd }

Use reaction checked-element { owd-ds | owd-sd } to configure a reaction entry for monitoring the one-way delay. You cannot edit a reaction entry. To change the attributes in a reaction entry, use undo reaction to delete the entry first and then configure a new one.

Use undo reaction to delete the specified reaction entry.

Syntax

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

undo reaction item-number

Default

No reaction entry for monitoring the one-way delay is configured.

Views

UDP jitter operation view

Default command level

2: System level

Parameters

item-number: Specifies a reaction entry ID in the range of 1 to 10.

owd-ds: Specifies the destination-to-source delay of each probe packet as the monitored element.

owd-sd: Specifies the source-to-destination delay of each probe packet as the monitored element.

threshold-value: Specifies threshold values in milliseconds.

upper-threshold: Specifies the upper threshold in the range of 0 to 3600000.

lower-threshold: Specifies the lower threshold in the range of 0 to 3600000. It must not be greater than the upper threshold.

Usage guidelines

Only successful probe packets are monitored. Failed probe packets are not counted.

No actions can be configured for a reaction entry of monitoring one-way delays. The monitoring results and statistics can be displayed with the display nqa reaction counters and display nqa statistics commands.

Examples

# Create reaction entry 1 for monitoring the destination-to-source delay of every UDP jitter packet. Set the upper threshold to 50 milliseconds and lower threshold to 5 milliseconds. Before the NQA operation starts, the initial state of the reaction entry is invalid. The destination-to-source delay is calculated after the response to the probe packet arrives. If the delay exceeds the upper threshold, the state of the reaction entry is set to over-threshold. If it is below the lower threshold, the state is set to below-threshold. Once the state of the reaction entry changes, a trap message is generated and sent to the NMS.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-udp-jitter] reaction 1 checked-element owd-ds threshold-value 50 5

reaction checked-element packet-loss

Use reaction checked-element packet-loss to configure a reaction entry for monitoring packet loss in the NQA operation. You cannot edit a reaction entry. To change the attributes in a reaction entry, use undo reaction to delete the entry first and then configure a new one.

Use undo reaction to delete the specified reaction entry.

Syntax

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

undo reaction item-number

Default

No reaction entry for monitoring packet loss is configured.

Views

UDP jitter operation view

Default command level

2: System level

Parameters

item-number: Specifies a reaction entry ID in the range of 1 to 10.

threshold-type: Specifies a threshold type.

accumulate accumulate-occurrences: Specifies the total number of lost packets in the operation, in the range of 1 to 15000.

action-type: Specifies an action to be triggered. The default action is none.

none: Specifies the action of only displaying results on the terminal display.

trap-only: Specifies the action of displaying results on the terminal display and meanwhile sending SNMP trap messages to the NMS.

Examples

# Create reaction entry 1 for monitoring packet loss in the UDP jitter operation. Before the NQA operation starts, the initial state of the reaction entry is invalid. After the operation, lost packets are checked. If the total number of lost packets exceeds 100 (included), the state of the reaction entry is set to over-threshold. Otherwise, the state is set to below-threshold. Once the state of the reaction entry changes, a trap message is generated and sent to the NMS.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-udp-jitter] reaction 1 checked-element packet-loss threshold-type accumulate 100 action-type trap-only

reaction checked-element probe-duration

Use reaction checked-element probe-duration to configure a reaction entry for monitoring the operation duration. You cannot edit a reaction entry. To change the attributes in a reaction entry, use undo reaction to delete the entry first and then configure a new one.

Use undo reaction to delete the specified reaction entry.

Syntax

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 } ]

undo reaction item-number

Default

No reaction entry for monitoring the probe duration is configured.

Views

DHCP operation view, FTP operation view, HTTP operation view, ICMP echo operation view, SNMP operation view, TCP operation view, UDP echo operation view

Default command level

2: System level

Parameters

item-number: Specifies a reaction entry ID in the range of 1 to 10.

threshold-type: Specifies a threshold type.

accumulate accumulate-occurrences: Specifies the total number of threshold violations. The value is in the range of 1 to 15.

average: Specifies to check the average operation duration.

consecutive consecutive-occurrences: Specifies the number of consecutive threshold violations after the NQA operation starts. The value is in the range of 1 to 16.

threshold-value: Specifies threshold values in milliseconds.

upper-threshold: Specifies the upper threshold in the range of 0 to 3600000.

lower-threshold: Specifies the lower threshold in the range of 0 to 3600000. It must not be greater than the upper threshold.

action-type: Specifies an action to be triggered. The default action is none.

none: Specifies the action of only displaying results on the terminal display.

trap-only: Specifies the action of displaying results on the terminal display and meanwhile sending SNMP trap messages to the NMS.

Usage guidelines

Only successful operations are monitored. Failed operations are not counted.

Examples

# Create reaction entry 1 for monitoring the average duration of ICMP echo operation. Set the upper threshold to 50 milliseconds and lower threshold to 5 milliseconds. Before the NQA operation starts, the initial state of the reaction entry is invalid. After the operation, the average probe duration is checked. If it exceeds the upper threshold, the state is set to over-threshold. If it is below the lower threshold, the state of the reaction entry is set to below-threshold. Once the state of the reaction entry changes, a trap message is generated and sent to the NMS.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] reaction 1 checked-element probe-duration threshold-type average threshold-value 50 5 action-type trap-only

# Create reaction entry 2 for monitoring the duration of ICMP echo operation. Set the upper threshold to 50 milliseconds, and the lower threshold to 5 milliseconds. Before the NQA operation starts, the initial state of the reaction entry is invalid. After the operation, the probe duration is checked against the threshold range. If the total number of threshold violations exceeds 10 (included), the state of the entry is set to over-threshold. If it is below the lower threshold, the state of the entry is set to below-threshold. Once the state of the reaction entry changes, a trap message is generated and sent to the NMS.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] reaction 2 checked-element probe-duration threshold-type accumulate 10 threshold-value 50 5 action-type trap-only

# Create reaction entry 3 for monitoring the duration time of ICMP echo operation. Set the upper threshold to 50 milliseconds, and the lower threshold to 5 milliseconds. Before the NQA operation starts, the initial state of the reaction entry is invalid. After the operation, the probe duration is checked against the threshold range. If the consecutive threshold violations exceed 10, the state of the entry is set to over-threshold. If it is below the lower threshold, the state of the entry is set to below-threshold. Once the state of the reaction entry changes, a trap message is generated and sent to the NMS.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] reaction 3 checked-element probe-duration threshold-type consecutive 10 threshold-value 50 5 action-type trap-only

reaction checked-element probe-fail (for trap)

Use reaction checked-element probe-fail to configure a reaction entry for monitoring the probe results of the operation. If the number of consecutive probe failures reaches the threshold, collaboration with other modules is triggered. You cannot edit a reaction entry. To change the attributes in a reaction entry, use undo reaction to delete the entry first and then configure a new one.

Use undo reaction to delete the specified reaction entry.

Syntax

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

undo reaction item-number

Default

No reaction entry for monitoring probe failures is configured.

Views

DHCP operation view, FTP operation view, HTTP operation view, ICMP echo operation view, SNMP operation view, TCP operation view, UDP echo operation view

Default command level

2: System level

Parameters

item-number: Specifies a reaction entry ID in the range of 1 to 10.

threshold-type: Specifies a threshold type.

accumulate accumulate-occurrences: Specifies the total number of probe failures. The value is in the range of 1 to 15.

consecutive consecutive-occurrences: Specifies the maximum number of consecutive probe failures. The value is in the range of 1 to 16.

action-type: Specifies an action to be triggered. The default action is none.

none: Specifies the action of only displaying results on the terminal display.

trap-only: Specifies the action of displaying results on the terminal display and meanwhile sending SNMP trap messages to the NMS.

Examples

# Create reaction entry 1 for monitoring the probe failures in ICMP echo operation. Before the NQA operation starts, the initial state of the reaction entry is invalid. If the total number of probe failures exceeds 10 (included), the state of the entry is set to over-threshold. If it is below the lower threshold, the state of the entry is set to below-threshold. Once the state of the reaction entry changes, a trap message is generated and sent to the NMS.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] reaction 1 checked-element probe-fail threshold-type accumulate 10 action-type trap-only

# Create reaction entry 2 for monitoring the probe failures in ICMP echo operation. Before the NQA operation starts, the initial state of the reaction entry is invalid. If the number of consecutive probe failures exceeds 10, the state of the entry is set to over-threshold. If it is below the lower threshold, the state of the entry is set to below-threshold. Once the state of the reaction entry changes, a trap message is generated and sent to the NMS.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] reaction 2 checked-element probe-fail threshold-type consecutive 10 action-type trap-only

reaction checked-element probe-fail (for trigger)

Use reaction checked-element probe-fail to configure a reaction entry for monitoring the probe failures. This command is applicable to trap messages only. You cannot edit a reaction entry. To change the attributes in a reaction entry, use undo reaction to delete the entry first and then configure a new one.

Use undo reaction to remove the specified reaction entry.

Syntax

reaction item-number checked-element probe-fail threshold-type consecutive consecutive-occurrences action-type trigger-only

undo reaction item-number

Default

No reaction entries are configured.

Views

DHCP operation view, FTP operation view, HTTP operation view, ICMP echo operation view, SNMP operation view, TCP operation view, UDP echo operation view

Default command level

2: System level

Parameters

item-number: Specifies a reaction entry ID in the range of 1 to 10.

threshold-type: Specifies a threshold type.

consecutive consecutive-occurrences: Specifies the maximum number of consecutive probe failures, in the range of 1 to 16.

action-type: Specifies an action to be triggered.

trigger-only: Triggers other modules to react to certain conditions.

Usage guidelines

The collaboration function is not supported by the UDP jitter operation.

Examples

# Create reaction entry 1. If the number of consecutive probe failures reaches 3, collaboration is triggered.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type tcp

[Sysname-nqa-admin-test-tcp] reaction 1 checked-element probe-fail threshold-type consecutive 3 action-type trigger-only

Related commands

track (High Availability Command Reference)

reaction checked-element rtt

Use reaction checked-element rtt to configure a reaction entry for monitoring packet round-trip time. You cannot edit a reaction entry. To change the attributes in a reaction entry, use undo reaction to delete the entry first and then configure a new one.

Use undo reaction to delete the specified reaction entry.

Syntax

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

undo reaction item-number

Default

No reaction entry for monitoring packet round-trip time is configured.

Views

UDP jitter operation view

Default command level

2: System level

Parameters

item-number: Specifies a reaction entry ID in the range of 1 to 10.

threshold-type: Specifies a threshold type.

accumulate accumulate-occurrences: Specifies the total number of threshold violations, in the range of 1 to 15000.

average: Specifies to check the packet average round-trip time.

threshold-value: Specifies threshold values in milliseconds.

upper-threshold: Specifies the upper threshold in the range of 0 to 3600000.

lower-threshold: Specifies the lower threshold in the range of 0 to 3600000. It must not be greater than the upper threshold.

action-type: Specifies an action to be triggered. The default action is none.

none: Specifies the action of only displaying results on the terminal display.

trap-only: Specifies the action of displaying results on the terminal display and meanwhile sending SNMP trap messages to the NMS.

Usage guidelines

Only successful probe packets are monitored. Failed probe packets are not counted.

Examples

# Create reaction entry 1 for monitoring the average round-trip time of UDP jitter probe packets. Set the upper threshold to 50 milliseconds and lower threshold to 5 milliseconds. Before the NQA operation starts, the initial state of the reaction entry is invalid. After the operation, the average packet round-trip time is checked. If it exceeds the upper threshold, the state is set to over-threshold. If it is below the lower threshold, the state is set to below-threshold. Once the reaction entry state changes, a trap message is generated and sent to the NMS.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-udp-jitter] reaction 1 checked-element rtt threshold-type average threshold-value 50 5 action-type trap-only

# Create reaction entry 2 for monitoring the round-trip time of UDP jitter probe packets. Set the upper threshold to 50 milliseconds, and lower threshold to 5 milliseconds. Before the NQA operation starts, the initial state of the reaction entry is invalid. After the operation, the packet round-trip time is checked. If the total number of threshold violations exceeds 100 (included), the state of the entry is set to over-threshold. Otherwise, the state of the entry is set to below-threshold. Once the state of the reaction entry changes, a trap message is generated and sent to the NMS.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-udp-jitter] reaction 1 checked-element rtt threshold-type accumulate 100 threshold-value 50 5 action-type trap-only

reaction trap

Use reaction trap to configure the sending of traps to the NMS under specified conditions.

Use undo reaction trap to restore the default.

Syntax

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

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

Default

No traps are sent to the NMS.

Views

Any NQA operation view

Default command level

2: System level

Parameters

probe-failure consecutive-probe-failures: Sends a trap to the NMS if the number of consecutive probe failures in an operation is greater than or equal to consecutive-probe-failures. The value for consecutive-probe-failures is in the range of 1 to 15. The system counts the number of consecutive probe failures for each operation, so multiple traps might be sent.

test-complete: Sends a trap to indicate that the operation is completed.

test-failure cumulate-probe-failures: Sends a trap if the total number of probe failures in an operation is greater than or equal to cumulate-probe-failures. The value for cumulate-probe-failures is in the range of 1 to 15. The system counts the total probe failures after the last operation completes, so one trap at most is sent.

Examples

# Configure the system to send a trap if the number of consecutive probe failures in an ICMP echo operation is greater than or equal to 5.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] reaction trap probe-failure 5

route-option bypass-route

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

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

Syntax

route-option bypass-route

undo route-option bypass-route

Default

The routing table bypass function is disabled.

Views

FTP operation view, HTTP operation view, ICMP echo operation view, SNMP operation view, TCP operation view, UDP echo operation view, UDP jitter operation view

Default command level

2: System level

Usage guidelines

When the routing table bypass function is enabled, the routing table is not searched, and the packet is sent directly to the destination in a directly connected network.

Examples

# Enable the routing table bypass function.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] route-option bypass-route

source interface

Use source interface to configure the source interface for ICMP echo request packets. The ICMP echo request packets take the primary IP address of the source interface as their source IP address when no source IP address is specified. The specified source interface must be up. Otherwise, no ICMP echo requests can be sent out.

Use undo source interface to restore the default.

Syntax

source interface interface-type interface-number

undo source interface

Default

No source interface is configured for ICMP echo request packets.

Views

ICMP echo operation view

Default command level

2: System level

Parameters

interface-type interface-number: Specifies an interface by its type and number.

Usage guidelines

If you configure both the source interface command and the source ip command, the source ip command takes effect.

Examples

# Specify the primary IP address of interface VLAN-interface 2 as the source IP address of ICMP echo request packets.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] source interface vlan-interface 2

Related commands

source ip

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

Use undo source ip to remove the configured source address. The primary IP address of the interface that sends a probe packet serves as the source IP address of the probe packet.

Syntax

source ip ip-address

undo source ip

Default

No source IP address is configured for probe packets.

Views

FTP operation view, HTTP operation view, ICMP echo operation view, SNMP operation view, TCP operation view, UDP echo operation view, UDP jitter operation view

Default command level

2: System level

Parameters

ip-address: Specifies the source IP address of the operation.

Usage guidelines

If you configure both the source interface command and the source ip command, the source ip command takes effect.

If you configure the source interface command but not the source ip command for the ICMP echo operation, the IP address of source interface is used as the source IP address of the ICMP echo request packet.

Examples

# Configure the source IP address of the ICMP echo packets as 10.1.1.1.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] source ip 10.1.1.1

Related commands

source interface

source port

Use source port to configure the source port of probe packets.

Use undo source port to remove the configured port number.

Syntax

source port port-number

undo source port

Default

No source port number is configured.

Views

SNMP operation view, UDP echo operation view, UDP jitter operation view

Default command level

2: System level

Parameters

port-number: Specifies the source port number of probe packets, in the range of 1 to 50000.

Examples

# Configure port 8000 as the source port of probe packets in the UDP echo operation.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-udp-echo] source port 8000

statistics hold-time

Use statistics hold-time to configure the hold time of statistics groups for an NQA operation. A statistics group is deleted when its hold time expires.

Use undo statistics hold-time to restore the default.

Syntax

statistics hold-time hold-time

undo statistics hold-time

Default

The hold time of statistics groups is 120 minutes.

Views

FTP operation view, HTTP operation view, ICMP echo operation view, SNMP operation view, TCP operation view, UDP echo operation view, UDP jitter operation view

Default command level

2: System level

Parameters

hold-time: Specifies the hold time of statistics groups in minutes, in the range of 1 to 1440.

Usage guidelines

This command is not available for the DHCP operation.

Examples

# Configure the hold time of statistics groups as 3 minutes.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] statistics hold-time 3

statistics max-group

Use statistics max-group to configure the maximum number of statistics groups that can be saved.

Use undo statistics max-group to restore the default.

Syntax

statistics max-group number

undo statistics max-group

Default

A maximum of two statistics groups can be saved.

Views

FTP operation view, HTTP operation view, ICMP echo operation view, SNMP operation view, TCP operation view, UDP echo operation view, UDP jitter operation view

Default command level

2: System level

Parameters

number: Specifies the maximum number of statistics groups that can be saved, in the range of 0 to 100. To disable collecting statistics, set the value to 0.

Usage guidelines

When the number of statistics groups saved reaches the upper limit and a new statistics group is to be saved, the earliest statistics group is deleted.

This command is not supported by DHCP operation.

Examples

# Configure the NQA to save up to 5 statistics groups for the ICMP operation.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] statistics max-group 5

statistics interval

Use statistics interval to configure the interval for collecting result statistics for an NQA operation.

Use undo statistics interval to restore the default.

Syntax

statistics interval interval

undo statistics interval

Default

The interval is 60 minutes.

Views

FTP operation view, HTTP operation view, ICMP echo operation view, SNMP operation view, TCP operation view, UDP echo operation view, UDP jitter operation view

Default command level

2: System level

Parameters

interval: Specifies the interval in minutes for collecting statistics for an NQA operation, in the range of 1 to 35791394.

Usage guidelines

NQA collects the result statistics within the specified interval in a statistics group. The statistics form a statistics group. To view information about the statistics groups, use the display nqa statistics command.

This command is not available for the DHCP operation.

Examples

# Configure the interval for collecting the test result statistics of the ICMP echo operation as 2 minutes.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] statistics interval 2

tos

Use tos to specify the ToS value in the IP packet header of probe packets.

Use undo tos to restore the default.

Syntax

tos value

undo tos

Default

The ToS value in the IP packet header of probe packets is 0.

Views

FTP operation view, HTTP operation view, ICMP echo operation view, SNMP operation view, TCP operation view, UDP echo operation view, UDP jitter operation view

Default command level

2: System level

Parameters

value: Specifies the ToS value in the IP packet header of probe packets, in the range of 0 to 255.

Examples

# Configure the ToS value in an IP packet header of probe packets as 1.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] tos 1

ttl

Use ttl to specify the TTL for probe packets.

Use undo ttl to restore the default.

Syntax

ttl value

undo ttl

Default

The TTL for probe packets is 20.

Views

FTP operation view, HTTP operation view, ICMP echo operation view, SNMP operation view, TCP operation view, UDP echo operation view, UDP jitter operation view

Default command level

2: System level

Parameters

value: Specifies the TTL for probe packets, in the range of 1 to 255.

Usage guidelines

After you configure the route-option bypass-route command, the TTL for probe packets is 1, and the ttl command does not take effect.

Examples

# Configure the TTL for probe packets as 16.

<Sysname> system-view

[Sysname] nqa entry admin test

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

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

type

Use type to specify the operation type of the NQA operation and enter operation view.

Syntax

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

Default

No operation type is specified.

Views

NQA operation view

Default command level

2: System level

Parameters

dhcp: Specifies the DHCP operation type.

ftp: Specifies the FTP operation type.

http: Specifies the HTTP operation type.

icmp-echo: Specifies the ICMP echo operation type.

snmp: Specifies the SNMP operation type.

tcp: Specifies the TCP operation type.

udp-echo: Specifies the UDP echo operation type.

udp-jitter: Specifies the UDP jitter operation type.

Examples

# Specify the type of the NQA operation as FTP and enter FTP operation view.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type ftp

[Sysname-nqa-admin-test-ftp]

url

Use url to specify the website URL for the HTTP operation to visit.

Use undo url to remove the specified website URL.

Syntax

url url

undo url

Views

HTTP operation view

Default command level

2: System level

Parameters

url: Specifies the website URL for the operation to visit, a case-sensitive string of 1 to 185 characters.

Usage guidelines

The character string of the configured URL cannot contain spaces.

Examples

# Configure the website URL that the HTTP operation visits as /index.htm.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type http

[Sysname-nqa-admin-test-http] url /index.htm

username (FTP operation view)

Use username to configure a username used to log in to the FTP server.

Use undo username to remove the username.

Syntax

username username

undo username

Default

No username is configured for logging in to the FTP server.

Views

FTP operation view

Default command level

2: System level

Parameters

username: Specifies the username used to log in to the FTP server. The username is a case-sensitive string of 1 to 32 characters.

Examples

# Configure the login username as administrator.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type ftp

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

Related commands

· password

· operation

NQA server configuration commands

NOTE:

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

display nqa server status

Use display nqa server status to display NQA server status.

Syntax

display nqa server status [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Examples

# Display NQA server status.

<Sysname> display nqa server status

nqa server is: enabled

tcp-connect:

IP Address Port Status

2.2.2.2 2000 active

udp-echo:

IP Address Port Status

3.3.3.3 3000 inactive

Table 8 Command output

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

nqa server enable

Use nqa server enable to enable the NQA server.

Use undo nqa server enable to disable the NQA server.

Syntax

nqa server enable

undo nqa server enable

Default

The NQA server is disabled.

Views

System view

Default command level

2: System level

Examples

# Enable the NQA server.

<Sysname> system-view

[Sysname] nqa server enable

Related commands

· nqa server tcp-connect

· nqa server udp-echo

· display nqa server status

nqa server tcp-connect

Use nqa server tcp-connect to configure a listening service to enable the NQA server to listen and respond on the specified IP address and port.

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

Syntax

nqa server tcp-connect ip-address port-number

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

Views

System view

Default command level

2: System level

Parameters

ip-address: Specifies the IP address for the TCP connect listening service.

port-number: Specifies the port number for the TCP connect listening service, in the range of 1 to 50000.

Usage guidelines

Configure the command on the NQA server for the TCP operation only.

The IP address and port number must be consistent with those on the NQA client and must be different from those of an existing TCP listening service.

The IP address must be that of an interface on the NQA server. Otherwise, the configuration is invalid.

Examples

# Configure a TCP listening service to enable the NQA server to listen and respond on the IP address 169.254.10.2 and port 9000.

<Sysname> system-view

[Sysname] nqa server tcp-connect 169.254.10.2 9000

Related commands

· nqa server enable

· display nqa server status

nqa server udp-echo

Use nqa server udp-echo to configure a UDP echo listening service to enable the NQA server to listen and respond on the specified IP address and port.

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

Syntax

nqa server udp-echo ip-address port-number

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

Views

System view

Default command level

2: System level

Parameters

ip-address: Specifies the IP address for the UDP echo listening service.

port-number: Specifies the port number for the UDP listening service, in the range of 1 to 50000.

Usage guidelines

Configure the command on the NQA server for the UDP jitter and UDP echo operations only.

The IP address and port number must be consistent with those configured on the NQA client and must be different from those of an existing UDP listening service.

The IP address must be that of an interface on the NQA server. Otherwise, the configuration becomes invalid.

Examples

# Configure a UDP listening service to enable the NQA server to listen and respond on the IP address 169.254.10.2 and port 9000.

<Sysname> system-view

[Sysname] nqa server udp-echo 169.254.10.2 9000

Related commands

· nqa server enable

· display nqa server status

09-Network Management Configuration Guide

statistics max-group

statistics interval

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us