factor: Advantage factor, used to count Mean Opinion Scores (MOS) and Calculated Planning Impairment Factor (ICPIF) values. It is in the range of 0 to 20.

Description

Use the advantage-factor command to configure the advantage factor that is used to count MOS and ICPIF values.

Use the undo advantage-factor command to restore the default.

By default, the advantage factor is 0.

The evaluation of voice quality depends on users’ tolerance for voice quality, and this factor should be taken into consideration. For users with higher tolerance for voice quality, use the advantage-factor command to configure the advantage factor. When the system calculates the ICPIF value, this advantage factor is subtracted to modify ICPIF and MOS values and both the objective and subjective factors are considered when you evaluate the voice quality.

Examples

# Configure the advantage factor for a voice test as 10.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type voice

[Sysname-nqa-admin-test-voice] advantage-factor 10

codec-type

Syntax

codec-type { g711a | g711u | g729a }

undo codec-type

View

Voice test type view

Default level

2: System level

Parameters

g711a: G.711 A-law codec type.

g711u: G.711 µ-law codec type

g729a: G.729 A-law codec type.

Description

Use the codec-type command to configure the codec type for a voice test.

Use the undo codec-type command to restore the default.

By default, the codec type for a voice test is G.711 A-law.

Examples

# Configure the codec type for a voice test as g729a.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type voice

[Sysname-nqa-admin-test-voice] codec-type g729a

data-fill

Syntax

data-fill string

undo data-fill

View

ICMP echo, UDP echo, UDP jitter, voice test type view

Default level

2: System level

Parameters

string: A case-sensitive string of 1 to 200 characters.

Description

Use the data-fill command to configure the string to be filled in the data field of a probe packet.

Use the undo data-fill command to restore the default.

By default, the string is the hexadecimal number 00010203040506070809.

· If the data field 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 data field size as 3 bytes, abc is filled.

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

How the string is filled varies with test types:

· For ICMP echo tests, the string fills the whole data field of ICMP echo requests.

· For UDP echo tests, the first five bytes of the data field of a UDP packet are for special purpose, so the string fills the remaining part of data field.

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

· For voice tests, the first 16 bytes of the data field of a UDP packet are for special purpose, so the string fills the remaining part of the data field.

Examples

# Configure string abcd to be filled in the data field 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

Syntax

data-size size

undo data-size

View

ICMP echo, UDP echo, UDP jitter, voice test type view

Default level

2: System level

Parameters

size: Size of the data field in a probe packet in bytes. It is in the range of 20 to 8100 for probe packets of ICMP echo or UDP echo tests, 68 to 8100 for probe packets of UDP jitter tests, and 16 to 1500 for probe packets of voice tests.

Description

Use the data-size command to configure the size of the data field in each ICMP echo request of the ICMP echo tests or in each UDP packet of UDP echo, UDP jitter, or voice tests.

Use the undo data-size command to restore the default.

Table 1 Default values of the 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
Voice	G.711 A-law	172
Voice	G.711 µ-law	172
Voice	G.729 A-law	32

Examples

# Configure the size of the data field in an 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 test type view)

Syntax

description text

undo description

View

Any NQA test type view

Default level

2: System level

Parameters

text: A case-sensitive string of 1 to 200 characters, used to describe a test group.

Description

Use the description command to give a brief description of a test group, usually, the test type or test purpose of a test group.

Use the undo description command to remove the configured description information.

By default, no descriptive string is available for a test group.

Examples

# Configure the descriptive string for a test group 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

Syntax

destination ip ip-address

undo destination ip

View

DLSw, FTP, DNS, HTTP, ICMP echo, SNMP, TCP, UDP echo, UDP jitter, voice test type view

Default level

2: System level

Parameters

ip-address: Destination IP address of a test operation.

Description

Use the destination ip command to configure a destination IP address for a test operation.

Use the undo destination ip command to remove the configured destination IP address.

By default, no destination IP address is configured for a test operation.

Examples

# Configure the destination IP address of an ICMP echo test 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

Syntax

destination port port-number

undo destination port

View

TCP, UDP echo, UDP jitter, voice test type view

Default level

2: System level

Parameters

port-number: Destination port number of a test operation, in the range of 1 to 65535.

Description

Use the destination port command to configure a destination port number for a test operation.

Use the undo destination port command to remove the configured destination port number.

By default, no destination port number is configured for a test operation.

Do not perform a UDP jitter test and a voice test on ports from 1 to 1023 (known ports). Otherwise, the NQA test fails or the corresponding services of this port are unavailable.

Examples

# Configure the destination port number of a test 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

Syntax

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

View

Any view

Default level

1: Monitor level

Parameters

admin-name operation-tag: Displays history records of an NQA test group. If these two arguments are not specified, history records of all test groups are displayed. admin-name represents the name of the NQA test group administrator who creates the NQA operation. It is a case-insensitive string of 1 to 32 characters. operation-tag represents the test operation tag. It 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.

Description

Use the display nqa history command to display history records of the specified or all NQA test groups.

The display nqa history command cannot show you the results of voice tests and UDP jitter tests. To know the result of a voice test or a UDP jitter test, use the display nqa result command to view the probe results of the latest NQA test, or use the display nqa statistics command to view the statistics of NQA tests.

Examples

# Display the history records of the NQA test group in which the administrator name is administrator, and the operation tag is 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 Output description

Field	Description
Index	History record number
Response	Round-trip delay of a test packet in the case of a successful test, timeout time in the case of timeout, or 0 in the case that a test cannot be completed (in milliseconds)
Status	Status value of test results, which can be one of the following values: · Succeeded · Unknown error · Internal error · Timeout
Time	Time when the test is completed

display nqa reaction counters

Syntax

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

View

Any view

Default level

1: Monitor level

Parameters

admin-name operation-tag: Displays current monitoring results of reaction entries in a test group. If these two arguments are not specified, monitoring results of all reaction entries of all test groups are displayed. admin-name represents the name of the NQA test group administrator who creates the NQA operation. It is a case-insensitive string of 1 to 32 characters. operation-tag represents the test operation tag. It is a case-insensitive string of 1 to 32 characters.

item-number: Displays current monitoring results of a specific reaction entry. If this argument is not provided, results of all reaction entries are displayed. item-number represents the ID of the reaction entry, 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.

Description

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

If the threshold type is average value, or the monitored element is ICPIF or MOS in a voice test, the monitoring results are invalid.

The monitoring results are accumulated since the test group starts and are not cleared after the test completes.

Examples

# Display the monitoring results of all reaction entries in an ICMP echo test group, in which the administrator name is admin, and the operation tag is 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 Output description

Field	Description
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 4 Description on the threshold monitoring fields of the display nqa reaction counters command

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

display nqa result

Syntax

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

View

Any view

Default level

1: Monitor level

Parameters

admin-name operation-tag: Displays results of the last test of a test group. If these two arguments are not specified, results of the last tests of all test groups are displayed. admin-name represents the name of the NQA test group administrator who creates the NQA operation. It is a case-insensitive string of 1 to 32 characters. operation-tag represents the test operation tag. It 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.

Description

Use the display nqa result command to display results of the last NQA test.

Examples

# Display the results of the last UDP jitter test.

<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

# Display the results of the last voice test.

<Sysname> display nqa result admin test

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

Destination IP address: 192.168.1.42

Send operation times: 1000 Receive response times: 0

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

Square-Sum of round trip time: 0

Last succeeded probe time: 0-00-00 00:00:00.0

Extended results:

Packet loss in test: 100%

Failures due to timeout: 1000

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

Voice results:

RTT number: 0

Min positive SD: 0 Min positive DS: 0

Max positive SD: 0 Max positive DS: 0

Positive SD number: 0 Positive DS number: 0

Positive SD sum: 0 Positive DS sum: 0

Positive SD average: 0 Positive DS average: 0

Positive SD square sum: 0 Positive DS square sum: 0

Min negative SD: 0 Min negative DS: 0

Max negative SD: 0 Max negative DS: 0

Negative SD number: 0 Negative DS number: 0

Negative SD sum: 0 Negative DS sum: 0

Negative SD average: 0 Negative DS average: 0

Negative SD square sum: 0 Negative DS square sum: 0

One way results:

Max SD delay: 0 Max DS delay: 0

Min SD delay: 0 Min DS delay: 0

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

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

Square sum of SD delay: 0 Square sum of DS delay: 0

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

Lost packet(s) for unknown reason: 1000

Voice scores:

MOS value: 0.99 ICPIF value: 87

Table 5 Output description

Field	Description
Destination IP address	IP address of the destination
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
Last succeeded probe time	Time when the last successful probe was finished
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 packets that arrived late
UDP-jitter results	UDP jitter test results, available only in UDP jitter tests
Voice results	Voice test results, available only in voice tests
RTT number	Number of response packets received
Min positive SD	Minimum positive delay jitters from source to destination
Min positive DS	Minimum positive delay jitters from destination to source
Max positive SD	Maximum positive delay jitters from source to destination
Max positive DS	Maximum positive delay jitters from destination to source
Positive SD number	Number of positive delay jitters from source to destination
Positive DS number	Number of positive delay jitters from destination to source
Positive SD sum	Sum of positive delay jitter from source to destination
Positive DS sum	Sum of positive delay jitters from destination to source
Positive SD average	Average of positive delay jitter from source to destination
Positive DS average	Average of positive delay jitter from destination to source
Positive SD square sum	Square sum of positive delay jitters from source to destination
Positive DS square sum	Square sum of positive delay jitters from destination to source
Min negative SD	Minimum absolute value among negative delay jitters from source to destination
Min negative DS	Minimum absolute value among negative delay jitters from destination to source
Max negative SD	Maximum absolute value among negative delay jitters from source to destination
Max negative DS	Maximum absolute value among negative delay jitters from destination to source
Negative SD number	Number of negative delay jitters from source to destination
Negative DS number	Number of negative delay jitters from destination to source
Negative SD sum	Sum of absolute values of negative delay jitters from source to destination
Negative DS sum	Sum of absolute values of negative delay jitters from destination to source
Negative SD average	Average absolute value of negative delay jitters from source to destination
Negative DS average	Average absolute value of negative delay jitters from destination to source
Negative SD square sum	Square sum of negative delay jitters from source to destination
Negative DS square sum	Square sum of negative delay jitters from destination to source
One way results	Uni-direction delay test result, displayed in a UDP jitter or voice test
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
Voice scores	Voice parameters, displayed only in a voice test
MOS value	MOS value calculated for a voice test
ICPIF value	ICPIF value calculated for a voice test

display nqa statistics

Syntax

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

View

Any view

Default level

1: Monitor level

Parameters

admin-name operation-tag: Displays statistics of the specified test group. If these two arguments are not specified, statistics of all test groups are displayed. admin-name represents the name of the NQA test group administrator who creates the NQA operation. It is a case-insensitive string of 1 to 32 characters. operation-tag represents the test operation tag. It 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.

Description

Use the display nqa statistics command to display statistics of test results for the specified or all test groups.

If the first test of a test group has not finished all probe operations, no statistics is generated. If you then display the statistics by using this command, the statistics is 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 or the monitored element is ICPIF or MOS for voice tests, the monitoring results are invalid.

Related commands: statistics interval.

Examples

# Display statistics of UDP jitter tests.

<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

# Display statistics of voice tests.

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

Life time: 120 seconds

Send operation times: 10 Receive response times: 10

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

Square-Sum of round trip time: 620

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

Voice results:

RTT number: 10

Min positive SD: 3 Min positive DS: 1

Max positive SD: 10 Max positive DS: 1

Positive SD number: 3 Positive DS number: 2

Positive SD sum: 18 Positive DS sum: 2

Positive SD average: 6 Positive DS average: 1

Positive SD square sum: 134 Positive DS square sum: 2

Min negative SD: 3 Min negative DS: 1

Max negative SD: 9 Max negative DS: 1

Negative SD number: 4 Negative DS number: 2

Negative SD sum: 25 Negative DS sum: 2

Negative SD average: 6 Negative DS average: 1

Negative SD square sum: 187 Negative DS square sum: 2

One way results:

Max SD delay: 0 Max DS delay: 0

Min SD delay: 0 Min DS delay: 0

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

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

Square sum of SD delay: 0 Square sum of DS delay: 0

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

Lost packet(s) for unknown reason: 0

Voice scores:

Max MOS value: 4.40 Min MOS value: 4.40

Max ICPIF value: 0 Min ICPIF value: 0

Reaction statistics:

Index Checked Element Threshold Type Checked Num Over-threshold Num

1 ICPIF - - -

2 MOS - - -

Table 6 Output description

Field	Description
No.	Statistics group number
Destination IP address	IP address of the destination
Start time	Time when the test group starts
Life time	Duration of the test, 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 test results, available only in UDP jitter tests
Voice results	Voice test results, available only in voice tests
RTT number	Number of response packets received
Min positive SD	Minimum positive delay jitter from source to destination
Min positive DS	Minimum positive delay jitter from destination to source
Max positive SD	Maximum positive delay jitter from source to destination
Max positive DS	Maximum positive delay jitter from destination to source
Positive SD number	Number of positive delay jitters from source to destination
Positive DS number	Number of positive delay jitters from destination to source
Positive SD sum	Sum of positive delay jitters from source to destination
Positive DS sum	Sum of positive delay jitters from destination to source
Positive SD average	Average of positive delay jitters from source to destination
Positive DS average	Average of positive delay jitters from destination to source
Positive SD square sum	Square sum of positive delay jitters from source to destination
Positive DS square sum	Square sum of positive delay jitters from destination to source
Min negative SD	Minimum absolute value among negative delay jitters from source to destination
Min negative DS	Minimum absolute value among negative delay jitters from destination to source
Max negative SD	Maximum absolute value among negative delay jitters from source to destination
Max negative DS	Maximum absolute value among negative delay jitters from destination to source
Negative SD number	Number of negative delay jitters from source to destination
Negative DS number	Number of negative delay jitters from destination to source
Negative SD sum	Sum of absolute values of negative delay jitters from source to destination
Negative DS sum	Sum of absolute values of negative delay jitters from destination to source
Negative SD average	Average absolute value of negative delay jitters from source to destination
Negative DS average	Average absolute value of negative delay jitters from destination to source
Negative SD square sum	Square sum of negative delay jitters from source to destination
Negative DS square sum	Square sum of negative delay jitters from destination to source
One way results	Uni-direction delay test result, displayed on in a UDP-Jitter or voice test
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
Voice scores	Voice parameters, displayed only in a voice test
Max MOS value	Maximum MOS value
Min MOS value	Minimum MOS value
Max ICPIF value	Maximum ICPIF value
Min ICPIF value	Minimum ICPIF value
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 on the threshold monitoring fields of the display nqa statistics command

Monitored element	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 delay 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
ICPIF	N/A	N/A	N/A	N/A
MOS	N/A	N/A	N/A	N/A

filename

Syntax

filename filename

undo filename

View

FTP test type view

Default level

2: System level

Parameters

filename: Name of the file transferred between the FTP server and the FTP client. The file name is a case-sensitive string of 1 to 200 characters.

Description

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

Use the undo filename command to restore the default.

By default, no file is specified.

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

Syntax

frequency interval

undo frequency

View

Any NQA test type view

Default level

2: System level

Parameters

interval: Interval between two consecutive tests, in the range of 0 to 604800000 milliseconds. The interval of 0 specifies the test group to perform only one test, and no statistics group information is collected.

Description

Use the frequency command to configure the interval between two consecutive tests for a test group. When a test group starts, it performs tests one by one at the specified interval. However, if a test is not completed when the interval is reached, no new test starts.

Use the undo frequency command to restore the default.

By default, the interval between two consecutive voice tests is 60000 milliseconds, and the interval between two consecutive tests of other types is 0 milliseconds.

Examples

# Configure the ICMP echo test group starts tests one by one 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

Syntax

history-record enable

undo history-record enable

View

Any NQA test type view

Default level

2: System level

Parameters

None

Description

Use the history-record enable command to enable the saving of history records of an NQA test group.

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

By default, history records of an NQA test group are not saved.

If the history records saving function is enabled, the system saves the history records. To view the history records of the NQA test group, 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 test group and the existing history records are also removed.

Related commands: display nqa history.

Examples

# Enable the history records saving function of an NQA test group.

<Sysname> system-view

[Sysname] nqa entry admin test

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

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

history-record keep-time

Syntax

history-record keep-time keep-time

undo history-record keep-time

View

Any NQA test type view

Default level

2: System level

Parameters

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

Description

Use the history-record keep-time command to set the lifetime of the history records in an NQA test group.

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

By default, the history records in an NQA test group are kept for 120 minutes.

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

Examples

# Configure the lifetime of the history records in an NQA test group 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

Syntax

history-record number number

undo history-record number

View

Any NQA test type view

Default level

2: System level

Parameters

number: Maximum number of history records that can be saved in a test group, in the range of 0 to 50.

Description

Use the history-record number command to configure the maximum number of history records that can be saved in a test group.

Use the undo history-record number command to restore the default.

By default, the maximum number of records that can be saved in a test group is 50.

If the number of history records in a test group exceeds the maximum number, the earliest history record is removed.

Examples

# Configure the maximum number of history records that can be saved in a test group 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

Syntax

http-version v1.0

undo http-version

View

HTTP test type view

Default level

2: System level

Parameters

v1.0: The HTTP version is 1.0 in an HTTP test.

Description

Use the http-version command to configure the HTTP version used in an HTTP test.

Use the undo http-version command to restore the default.

By default, HTTP 1.0 is used in an HTTP test.

Examples

# Configure the HTTP version as 1.0 in an HTTP test.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type http

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

mode

Syntax

mode { active | passive }

undo mode

View

FTP test type view

Default level

2: System level

Parameters

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

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

Description

Use the mode command to set the data transmission mode for FTP tests.

Use the undo mode command to restore the default.

By default, the data transmission mode is active.

Examples

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

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type ftp

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

next-hop

Syntax

next-hop ip-address

undo next-hop

View

ICMP echo test type view

Default level

2: System level

Parameters

ip-address: IP address of the next hop.

Description

Use the next-hop command to configure the next hop IP address for ICMP echo requests of a test group.

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

By default, no next hop IP address is configured.

Examples

# Configure the next hop IP address 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] next-hop 10.1.1.1

nqa

Syntax

nqa entry admin-name operation-tag

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

View

System view

Default level

2: System level

Parameters

admin-name: Specifies the name of the NQA test group administrator who creates the NQA test operation, a case-insensitive string of 1 to 32 characters, with “-” excluded.

operation-tag: Specifies the tag of a test operation, a case-insensitive string of 1 to 32 characters, with “-” excluded.

all: All NQA test groups.

Description

Use the nqa command to create an NQA test group and enter NQA test group view.

Use the undo nqa command to remove the test group.

If the test type has been configured for the test group, you directly enter NQA test type view when you execute the nqa command.

Examples

# Create an NQA test group whose administrator name is admin and whose operation tag is test and enter NQA test group view.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test]

nqa agent enable

Syntax

nqa agent enable

undo nqa agent enable

View

System view

Default level

2: System level

Parameters

None

Description

Use the nqa agent enable command to enable the NQA client.

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

By default, the NQA client is enabled.

Related commands: nqa server enable.

Examples

# Enable the NQA client.

<Sysname> system-view

[Sysname] nqa agent enable

nqa agent max-concurrent

Syntax

nqa agent max-concurrent number

undo nqa agent max-concurrent

View

System view

Default level

2: System level

Parameters

number: Maximum number of the tests that the NQA client can simultaneously perform. The value is in the range of 1 to 30.

Description

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

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

By default, the NQA client can simultaneously perform up to 10 tests.

From the beginning to the end of a test, the NQA test is in the test status; from the end of a test to the beginning of the next test, the NQA test is in the waiting status.

Examples

# Configure the maximum number of the tests that the NQA client can simultaneously perform as 5.

<Sysname> system-view

[Sysname] nqa agent max-concurrent 5

nqa schedule

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

View

System view

Default level

2: System level

Parameters

admin-name: Specifies the name of the NQA test group administrator who creates the NQA test operation, a case-insensitive string of 1 to 32 characters.

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

start-time: Specifies the start time and date of a test group.

hh:mm:ss: Start time of a test group.

yyyy/mm/dd: Start date of a test group. The default value is the current system time, and yyyy is in the range of 2000 to 2035.

now: Starts the tests for a test group immediately.

lifetime: Specifies the duration of the test operation.

lifetime: Duration of the test operation in seconds, in the range of 1 to 2147483647.

forever: Specifies that the tests are performed for a test group forever.

Description

Use the nqa schedule command to configure the test start time and test duration for a test group.

Use the undo nqa schedule command to stop the test for the test group.

You cannot enter test group view or test type view after a test group is scheduled.

A test group performs a test when the system time is between the start time and the end time (the start time plus test duration). If the system time is behind the start time when you execute the nqa schedule command, a test is started when the system time reaches the start time; if the system time is between the start time and the end time, a test is started at once; if the system time is ahead of the end time, no test is started. To view the current system time, use the display clock command.

Related commands: display clock (Fundamentals Command Reference).

Examples

# Start the tests for the test group with the administrator name admin and operation tag test. The start time and duration of the test group are 08:08:08 2008/08/08 and 1000 seconds respectively.

<Sysname> system-view

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

operation (FTP test type view)

Syntax

operation { get | put }

undo operation

View

FTP test type view

Default level

2: System level

Parameters

get: Obtains a file from the FTP server.

put: Transfers a file to the FTP server.

Description

Use the operation command to configure the FTP operation type.

Use the undo operation command to restore the default.

By default, the FTP operation type is get.

Examples

# Configure the FTP operation type 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 test type view)

Syntax

operation { get | post }

undo operation

View

HTTP test type view

Default level

2: System level

Parameters

get: Obtains data from the HTTP server.

post: Transfers data to the HTTP server.

Description

Use the operation command to configure the HTTP operation type.

Use the undo operation command to restore the default.

By default, the HTTP operation type is get.

Examples

# Configure the HTTP operation type 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

Syntax

operation interface interface-type interface-number

undo operation interface

View

DHCP test type view

Default level

2: System level

Parameters

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

Description

Use the operation interface command to specify the interface to perform a DHCP test. The specified interface must be up; otherwise, no probe packets can be sent out.

Use the undo operation interface command to restore the default.

By default, no interface is specified to perform a DHCP test.

Examples

# Specify the interface to perform a DHCP test as GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type dhcp

[Sysname-nqa-admin-test-dhcp] operation interface GigabitEthernet 3/1/1

password (FTP test type view)

Syntax

password password

undo password

View

FTP test type view

Default level

2: System level

Parameters

password: Password used to log in to the FTP server, a case-sensitive string of 1 to 32 characters.

Description

Use the password command to configure a password used to log onto the FTP server.

Use the undo password command to remove the configured password.

By default, no password is configured for logging onto the FTP server.

Related commands: username and operation.

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 ftpuser

probe count

Syntax

probe count times

undo probe count

View

DHCP, DNS, DLSw, FTP, HTTP, ICMP echo, SNMP, TCP, UDP echo, UDP jitter test type view

Default level

2: System level

Parameters

times: Number of probe operations per test, in the range of 1 to 15.

Description

Use the probe count command to configure the number of probe operations to be performed per test.

Use the undo probe count command to restore the default.

By default, one probe operation is performed in an NQA test.

Probe operations vary with NQA test types.

· During a TCP or DLSw test, one probe operation means setting up one connection.

· During a UDP jitter or a voice test, one probe operation means continuously sending a specific number of probe packets. The number of probe packets is configurable with the probe packet-number command.

· During an FTP, HTTP, DHCP or DNS test, one probe operation means uploading or downloading a file, obtaining a web page, obtaining an IP address through DHCP, or translating a domain name to an IP address.

· During an ICMP echo or UDP echo test, one probe operation means sending an ICMP echo request or a UDP packet.

· During an SNMP test, one probe operation means sending one SNMPv1 packet, one SNMPv2C packet, and one SNMPv3 packet.

If more than one probe operation is to be performed in a test, the system starts a second probe operation when it receives responses to packets sent in the first probe operation, or when the probe timeout time expires.

This command is not supported by voice tests. Only one probe operation is performed per voice test.

Examples

# Configure the ICMP test group to perform 10 probe operations per test.

<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

Syntax

probe packet-interval packet-interval

undo probe packet-interval

View

UDP jitter, voice test type view

Default level

2: System level

Parameters

packet-interval: Interval for sending packets per probe operation, in the range of 10 to 60000 milliseconds.

Description

Use the probe packet-interval command to configure the interval for sending packets per probe operation.

Use the undo probe-interval command to restore the default.

By default, the interval is 20 milliseconds.

Examples

# Configure the UDP jitter test group sends packets at an interval of 100 milliseconds during each probe operation.

<Sysname> system-view

[Sysname] nqa entry admin test

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

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

probe packet-number

Syntax

probe packet-number packet-number

undo probe packet-number

View

UDP jitter, voice test type view

Default level

2: System level

Parameters

packet-number: Number of packets to be sent per probe operation. It is in the range of 10 to 1000 for each probe operation in one UDP jitter test, and 10 to 60000 for each probe operation in one voice test.

Description

Use the probe packet-number command to configure the number of packets to be sent per probe during one UDP jitter or voice test.

Use the undo probe packet-number command to restore the default.

By default, the number of packets to be sent per probe is 10 in one UDP jitter test and 1000 in one voice test.

Examples

# Configure the UDP jitter test group to send 100 packets per probe.

<Sysname> system-view

[Sysname] nqa entry admin test

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

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

probe packet-timeout

Syntax

probe packet-timeout packet-timeout

undo probe packet-timeout

View

UDP jitter, voice test type view

Default level

2: System level

Parameters

packet-timeout: Timeout time for waiting for responses in a UDP jitter or voice test, in the range of 10 to 3600000 milliseconds.

Description

Use the probe packet-timeout command to configure the timeout time for waiting for a response in a UDP jitter or voice test.

Use the undo probe packet-timeout command to restore the default.

By default, the timeout time in a UDP jitter and a voice test is 3000 and 5000 milliseconds respectively.

Examples

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

<Sysname> system-view

[Sysname] nqa entry admin test

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

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

probe timeout

Syntax

probe timeout timeout

undo probe timeout

View

DHCP, DNS, DLSw, FTP, HTTP, ICMP echo, SNMP, TCP, UDP echo test type view

Default level

2: System level

Parameters

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

Description

Use the probe timeout command to configure the timeout time for a probe operation. When a probe operation does not complete within the period, the probe operation is timed out.

Use the undo probe timeout command to restore the default.

By default, the timeout time is 3000 milliseconds for a probe operation.

This command is not supported by UDP jitter or voice tests.

Examples

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

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type dhcp

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

reaction checked-element icpif

Syntax

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

undo reaction item-number

View

Voice test type view

Default level

2: System level

Parameters

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

threshold-value: Specifies threshold values.

upper-threshold: Upper threshold, in the range of 1 to 100.

lower-threshold: Lower threshold, in the range of 1 to 100. It must not be greater than the upper threshold.

action-type: Specifies what action to be triggered to react to certain measurement conditions and it defaults to none.

none: Specifies to only record events for terminal display, and not to send any trap messages.

trap-only: Specifies to record events and send SNMP trap messages.

Description

Use the reaction checked-element icpif command to configure a reaction entry for monitoring the ICPIF value in a voice test of an NQA operation. You cannot edit a reaction entry. To change the attributes in a reaction entry, use the undo reaction command to delete this entire entry and start over.

Use the undo reaction command to delete the specified reaction entry.

By default, no reaction entry for monitoring ICPIF values is configured.

Examples

# Create reaction entry 1 for monitoring the ICPIF value in each voice test. Set the upper threshold to 50 and lower threshold to 5. Before the NQA test group starts, the initial state of the reaction entry is invalid. After each test, the ICPIF value is checked. If it is out of the threshold range, 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 network management server.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type voice

[Sysname-nqa-admin-test-voice] reaction 1 checked-element icpif threshold-value 50 5 action-type trap-only

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

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

View

UDP jitter, voice test type view

Default level

2: System level

Parameters

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

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

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

threshold-type: Specifies a threshold type.

accumulate accumulate-occurrences: Total number of threshold violations in a test. It is in the range of 1 to 14999 for UDP jitter tests, and 1 to 59999 for voice tests.

average: Average one-way delay jitter in each test.

threshold-value: Specifies threshold values in milliseconds.

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

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

action-type: Specifies what action to be triggered to react to certain measurement conditions and it defaults to none.

none: Specifies to only record events for terminal display, and not to send any trap messages.

trap-only: Specifies to record events and send SNMP trap messages.

Description

Use the reaction checked-element { jitter-ds | jitter-sd } command to configure a reaction entry for monitoring one-way delay jitter in each test of an NQA operation. You cannot edit a reaction entry. To change the attributes in a reaction entry, use the undo reaction command to delete this entire entry and start over.

Use the undo reaction command to delete the specified reaction entry.

By default, no reaction entry for monitoring one-way delay jitter is configured.

Only successful probe packets are monitored. The data of a failed probe packet is not counted.

Examples

# Create reaction entry 1 for monitoring the average destination-to-source delay jitter of UDP jitter probe packets. Set the upper threshold to 50 milliseconds, and the lower threshold to 5 milliseconds. Before the NQA test group starts, the initial state of the reaction entry is invalid. After each test, the average destination-to-source delay jitter is checked. If it is out of the threshold range, the state of the reaction entry is set to over-threshold; otherwise, the state is set to below-threshold. Once state of the reaction entry changes, a trap message is generated and sent to the network management server.

<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 delay jitter of UDP jitter probe packets. Set the upper threshold to 50 milliseconds, and the lower threshold to 5 milliseconds. Before the NQA test group starts, the initial state of the reaction entry is invalid. After each test, the destination-to-source delay 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 network management server.

<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 mos

Syntax

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

undo reaction item-number

View

Voice test type view

Default level

2: System level

Parameters

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

threshold-value: Specifies threshold values.

upper-threshold: Upper threshold, in the range of 1 to 500.

lower-threshold: Lower threshold, in the range of 1 to 500. It must not be greater than the upper threshold.

action-type: Specifies what action to be triggered to react to certain measurement conditions and it defaults to none.

none: Specifies to only record events for terminal display, and not to send any trap messages.

trap-only: Specifies to record events and send SNMP trap messages.

Description

Use the reaction checked-element mos command to configure a reaction entry for monitoring the MOS value in each voice test of an NQA operation. You cannot edit a reaction entry. To change the attributes in a reaction entry, use the undo reaction command to delete this entire entry and start over.

Use the undo reaction command to delete the specified reaction entry.

By default, no reaction entry for monitoring the MOS value is configured.

For the MOS threshold, the number is expressed in three digits representing ones, tenths, and hundredths. For example, to express a MOS threshold of 1, enter 100.

Examples

# Create reaction entry 1 for monitoring the MOS value of each voice test. Set the upper threshold to 2, and lower threshold to 1. Before the NQA test group starts, the initial state of the reaction entry is invalid. After each test, the MOS value is checked. If it is out of the threshold range, 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 network management server.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type voice

[Sysname-nqa-admin-test-voice] reaction 1 checked-element mos threshold-value 200 100 action-type trap-only

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

Syntax

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

undo reaction item-number

View

UDP jitter, voice test type view

Default level

2: System level

Parameters

item-number: ID for a reaction entry, 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: Upper threshold, in the range of 0 to 3600000.

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

Description

Use the reaction checked-element { owd-ds | owd-sd } command 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 the undo reaction command to delete this entire entry and start over.

Use the undo reaction command to delete the specified reaction entry.

By default, no reaction entry for monitoring the one-way delay is configured.

Only successful probe packets are monitored. The data of a failed probe packet is not counted.

No actions can be configured for a reaction entry of monitoring one-way delays. The monitoring results and statistics, however, can be displayed by 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 probe packet. Set the upper threshold to 50 milliseconds and lower threshold to 5 milliseconds. Before the NQA test group 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 is out of the threshold range, 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 network management server.

<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

Syntax

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

undo reaction item-number

View

UDP jitter, voice test type view

Default level

2: System level

Parameters

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

threshold-type: Specifies a threshold type.

accumulate accumulate-occurrences: Total number of lost packets in a test. It is in the range of 1 to 15000 for UDP jitter tests and 1 to 60000 for voice tests.

action-type: Specifies what action to be triggered to react to certain measurement conditions and it defaults to none.

none: Specifies to only record events for terminal display, and not to send any trap messages.

trap-only: Specifies to record events and send SNMP trap messages.

Description

Use the reaction checked-element packet-loss command to configure a reaction entry for monitoring the packet loss in each test of an NQA operation. You cannot edit a reaction entry. To change the attributes in a reaction entry, use the undo reaction command to delete this entire entry and start over.

Use the undo reaction command to delete the specified reaction entry.

By default, no reaction entry for monitoring the packet loss is configured.

Examples

# Create reaction entry 1 for monitoring the packet loss in each UDP jitter test. Before the NQA test group starts, the initial state of the reaction entry is invalid. After each test, the packet loss is 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 network management server.

<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

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

View

DHCP, DLSw, DNS, FTP, HTTP, ICMP echo, SNMP, TCP, UDP echo test type view

Default level

2: System level

Parameters

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

threshold-type: Specifies a threshold type.

accumulate accumulate-occurrences: Total number of threshold violations in a test. It is in the range of 1 to 15.

average: Average probe duration in each test.

consecutive consecutive-occurrences: Number of consecutive threshold violations since the NQA test group starts. It is in the range of 1 to 16.

threshold-value: Specifies threshold values in milliseconds.

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

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

action-type: Specifies what action to be triggered to react to certain measurement conditions and it defaults to none.

none: Specifies to only record events for terminal display, and not to send any trap messages.

trap-only: Specifies to record events and send SNMP trap messages. This keyword is not supported in DNS test view.

Description

Use the reaction checked-element probe-duration command to configure a reaction entry for monitoring the probe duration. You cannot edit a reaction entry. To change the attributes in a reaction entry, use the undo reaction command to delete this entire entry and start over.

Use the undo reaction command to delete the specified reaction entry.

By default, no reaction entry for monitoring the probe duration is configured.

Only successful probes are monitored. The duration of a failed probe is not counted.

Examples

# Create reaction entry 1 for monitoring the average duration of ICMP echo probes in a test. Set the upper threshold to 50 milliseconds and lower threshold to 5 milliseconds. Before the NQA test group starts, the initial state of the reaction entry is invalid. After each test, the average probe duration is checked. If it is out of the threshold range, the state is set to over-threshold; otherwise, 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 network management server.

<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 probes in a test. Set the upper threshold to 50 milliseconds, and the lower threshold to 5 milliseconds. Before the NQA test group starts, the initial state of the reaction entry is invalid. After each test, 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; 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 network management server.

<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 probes. Set the upper threshold to 50 milliseconds, and the lower threshold to 5 milliseconds. Before the NQA test group starts, the initial state of the reaction entry is invalid. The probe duration is checked against the threshold range for each probe. If a threshold violation occurs consecutively for 10 times or more since the test group starts, 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 network management server.

<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)

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

View

DHCP, DLSw, DNS, FTP, HTTP, ICMP echo, SNMP, TCP, UDP echo test type view

Default level

2: System level

Parameters

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

threshold-type: Specifies a threshold type.

accumulate accumulate-occurrences: Total number of probe failures in a test, in the range of 1 to 15.

consecutive consecutive-occurrences: Number of consecutive probe failures since the NQA test group starts. It is in the range of 1 to 16.

action-type: Specifies what action to be triggered to react to certain measurement conditions and it defaults to none.

none: Specifies to only record events for terminal display, and not to send any trap messages.

trap-only: Specifies to record events and send SNMP trap messages. This keyword is not supported in DNS test view.

Description

Use the reaction checked-element probe-fail command to configure a reaction entry for monitoring the probe failures. You cannot edit a reaction entry. To change the attributes in a reaction entry, use the undo reaction command to delete this entire entry and start over.

Use the undo reaction command to delete the specified reaction entry.

By default, no reaction entry for monitoring probe failures is configured.

Examples

# Create reaction entry 1 for monitoring the probe failures in ICMP echo tests. Before the NQA test group starts, the initial state of the reaction entry is invalid. After each test, if the total number of probe failures exceeds 10 (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 network management server.

<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 tests. Before the NQA test group starts, the initial state of the reaction entry is invalid. If probe failure occurs consecutively for 10 times or more since the test group starts, 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 network management server.

<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)

Syntax

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

undo reaction item-number

View

DHCP, DNS, DLSw, FTP, HTTP, ICMP echo, SNMP, TCP, UDP echo test type view

Default level

2: System level

Parameters

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

threshold-type: Specifies a threshold type.

consecutive consecutive-occurrences: Number of consecutive probe failures since the test group starts. It is in the range of 1 to 16.

action-type: Specifies what actions to be triggered to react to certain measurement conditions.

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

Description

Use the reaction checked-element probe-fail command to configure a reaction entry for monitoring the probe results of the current test group. 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 the undo reaction command to delete this entire entry and start over.

Use the undo reaction command to remove the specified reaction entry.

By default, no reaction entries are configured.

The collaboration function is not supported by UDP jitter or voice tests.

Related commands: track (High Availability Command Reference).

Examples

# Create reaction entry 1. If probe failure occurs consecutively for 3 times, collaboration with other modules 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

reaction checked-element rtt

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

View

UDP jitter, voice test type view

Default level

2: System level

Parameters

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

threshold-type: Specifies a threshold type.

accumulate accumulate-occurrences: Total number of threshold violations in a test. It is in the range of 1 to 15000 for UDP jitter tests and 1 to 60000 for voice tests.

average: Packet average round-trip time in a test.

threshold-value: Specifies threshold values in milliseconds.

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

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

action-type: Specifies what action to be triggered to react to certain measurement conditions and it defaults to none.

none: Specifies to only record events for terminal display, and not to send any trap messages.

trap-only: Specifies to record events and send SNMP trap messages.

Description

Use the reaction checked-element rtt command 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 the undo reaction command to delete this entire entry and start over.

Use the undo reaction command to delete the specified reaction entry.

By default, no reaction entry for monitoring packet round-trip time is configured.

Only successful probe packets are monitored. The data of a failed probe packet is 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 test group starts, the initial state of the reaction entry is invalid. After each test, the average packet round-rip time is checked. If it is out of the threshold range, the state is set to over-threshold; otherwise, the state is set to below-threshold. Once the reaction entry state changes, a trap message is generated and sent to the network management server.

<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 test group starts, the initial state of the reaction entry is invalid. After each test, the packet round-trip time 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 network management server.

<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

Syntax

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

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

View

Any NQA test type view

Default level

2: System level

Parameters

probe-failure consecutive-probe-failures: Sends a trap to the network management server if the number of consecutive probe failures in one test is greater than or equal to consecutive-probe-failures, in the range of 1 to 15. During the test, the system counts the number of consecutive probe failures after each probe operation, so multiple traps might be sent.

test-complete: Specifies to send a trap to indicate that the test is completed.

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

Description

Use the reaction trap command to configure to send traps to network management server under specified conditions.

Use the undo reaction trap command to restore the default.

By default, no traps are sent to the network management server.

Only the reaction trap test-complete command is supported by voice tests.

Examples

# Configure the system to send a trap if consecutive probe failures in an ICMP echo test 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

resolve-target

Syntax

resolve-target domain-name

undo resolve-target

View

DNS test type view

Default level

2: System level

Parameters

domain-name: Specifies the domain name to be resolved. It is a case-insensitive string separated by dots (.), each part consisting of 1 to 63 characters. The total length must be within 255 characters, Valid characters in a part include letters, digits, hyphens (-), and underscores (_).

Description

Use the resolve-target command to set the domain name for a DNS test.

Use the undo resolve-target command to restore the default.

By default, no domain name is configured.

Examples

# Set the domain name for DNS resolution to domain1.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type dns

[Syaname-nqa-admin-test-dns] resolve-target domain1

route-option bypass-route

Syntax

route-option bypass-route

undo route-option bypass-route

View

DLSw, DNS, FTP, HTTP, ICMP echo, SNMP, TCP, UDP echo, UDP jitter, voice test type view

Default level

2: System level

Parameters

None

Description

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

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

By default, the routing table bypass function is disabled.

When the routing table bypass function enabled, the routing table is not searched, and the packet is directly sent 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

Syntax

source interface interface-type interface-number

undo source interface

View

ICMP echo test type view

Default level

2: System level

Parameters

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

Description

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

Use the undo source interface command to restore the default.

By default, no source interface is configured for ICMP echo request packets.

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

Related commands: source ip.

Examples

# Specify the IP address of interface GigabitEthernet 3/1/1 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 GigabitEthernet 3/1/1

source ip

Syntax

source ip ip-address

undo source ip

View

DLSw, FTP, HTTP, ICMP echo, SNMP, TCP, UDP echo, UDP jitter, voice test type view

Default level

2: System level

Parameters

ip-address: Source IP address of a test operation.

Description

Use the source ip command 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 the undo source ip command to remove the configured source address. The IP address of the interface that sends a probe packet serves as the source IP address of the probe packet.

By default, no source IP address is configured for probe packets.

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

Related commands: source interface.

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

source port

Syntax

source port port-number

undo source port

View

SNMP, UDP echo, UDP jitter, voice test type view

Default level

2: System level

Parameters

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

Description

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

Use the undo source port command to remove the configured port number.

By default, no source port number is configured.

Examples

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

<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

Syntax

statistics hold-time hold-time

undo statistics hold-time

View

DLSw, DNS, FTP, HTTP, ICMP echo, SNMP, TCP, UDP echo, UDP jitter, voice test type view

Default level

2: System level

Parameters

hold-time: Hold time of a statistics group in minutes, in the range of 1 to 1440.

Description

Use the statistics hold-time command to configure the hold time of statistics groups for a test group. A statistics group is deleted when its hold time expires.

Use the undo statistics hold-time command to restore the default.

By default, the hold time of a statistics group is 120 minutes.

This command is not supported by DHCP tests.

Examples

# Configure the hold time of a statistics group 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

Syntax

statistics max-group number

undo statistics max-group

View

DLSw, DNS, FTP, HTTP, ICMP echo, SNMP, TCP, UDP echo, UDP jitter, voice test type view

Default level

2: System level

Parameters

number: Maximum number of statistics groups that can be kept, in the range of 0 to 100. To disable collecting statistics, specify number 0.

Description

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

Use the undo statistics max-group command to restore the default.

By default, 2 statistics groups at most can be kept.

When the number of statistics groups kept 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 tests.

Examples

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

<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

Syntax

statistics interval interval

undo statistics interval

View

DLSw, DNS, FTP, HTTP, ICMP echo, SNMP, TCP, UDP echo, UDP jitter, voice test type view

Default level

2: System level

Parameters

interval: Interval in minutes for collecting statistics of the test results for a test group, in the range of 1 to 35791394.

Description

Use the statistics interval command to configure the interval for collecting test result statistics for a test group.

Use the undo statistics interval command to restore the default.

By default, the interval is 60 minutes.

NQA groups tests completed in the specified interval, and calculates the test result statistics. The statistics form a statistics group. To view information about the statistics groups, use the display nqa statistics command.

This command is not supported by DHCP tests.

Examples

# Configure the interval for collecting the test result statistics of an ICMP test group 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

Syntax

tos value

undo tos

View

DLSw, DNS, FTP, HTTP, ICMP echo, SNMP, TCP, UDP echo, UDP jitter, voice test type view

Default level

2: System level

Parameters

value: Value of the ToS field in the IP header in an NQA probe packet, in the range of 0 to 255.

Description

Use the tos command to configure the value of the ToS field in the IP header in an NQA probe packet.

Use the undo tos command to restore the default.

By default, the ToS field in the IP header of an NQA probe packet is 0.

Examples

# Configure the ToS field in an IP packet header in an NQA probe packet 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

Syntax

ttl value

undo ttl

View

DLSw, DNS, FTP, HTTP, ICMP echo, SNMP, TCP, UDP echo, UDP jitter, voice test type view

Default level

2: System level

Parameters

value: Maximum number of hops a probe packet traverses in the network, in the range of 1 to 255.

Description

Use the ttl command to configure the maximum number of hops a probe packet traverses in the network.

Use the undo ttl command to restore the default.

By default, the maximum number of hops that a probe packet can traverse in a network is 20.

After you configure the route-option bypass-route command, the maximum number of hops a probe packet traverses in the network is 1, and the ttl command does not take effect.

Examples

# Configure the maximum number of hops that a probe packet can traverse in a network 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

Syntax

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

View

NQA test group view

Default level

2: System level

Parameters

dhcp: DHCP test.

dlsw: DLSw test.

dns: DNS test.

ftp: FTP test.

http: HTTP test.

icmp-echo: ICMP echo test.

snmp: SNMP test.

tcp: TCP test.

udp-echo: UDP echo test.

udp-jitter: UDP jitter test.

voice: Voice test.

Description

Use the type command to configure the test type of the current test group and enter test type view.

By default, no test type is configured.

Examples

# Configure the test type of a test group as FTP and enter test type view.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type ftp

[Sysname-nqa-admin-test-ftp]

url

Syntax

url url

undo url

View

HTTP test type view

Default level

2: System level

Parameters

url: Website that an HTTP test visits, a case-sensitive string of 1 to 185 characters.

Description

Use the url command to configure the website an HTTP test visits.

Use the undo url command to remove the configured website an HTTP test visits.

The character string of the configured URL cannot contain spaces.

Examples

# Configure the website that an HTTP test 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 test type view)

Syntax

username username

undo username

View

FTP test type view

Default level

2: System level

Parameters

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

Description

Use the username command to configure a username used to log onto the FTP server.

Use the undo username command to remove the configured username.

By default, no username is configured for logging onto the FTP server.

Related commands: password and operation.

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

vpn-instance (ICMP echo test type view)

Syntax

vpn-instance vpn-instance-name

undo vpn-instance

View

ICMP echo test type view

Default level

2: System level

Parameters

vpn-instance-name: Specifies the MPLS L3VPN, a case-sensitive string of 1 to 31 characters.

Description

Use the vpn-instance command to apply the ICMP echo test group to the specified VPN.

Use the undo vpn-instance command to restore the default.

By default, the ICMP echo test group applies to the public network.

Examples

# Specify vpn1 as the MPLS L3VPN.

<Sysname> system-view

[Sysname] nqa entry admin test

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

[Sysname-nqa-admin-test-icmp-echo] vpn-instance vpn1

NQA server configuration commands

NOTE:

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

display nqa server status

Syntax

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

View

Any view

Default 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.

Description

Use the display nqa server status command to display NQA server status.

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 Output description

Field	Description
tcp-connect	NQA server status in the NQA TCP test.
udp-echo	NQA server status in the NQA UDP test.
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

Syntax

nqa server enable

undo nqa server enable

View

System view

Default level

2: System level

Parameters

None

Description

Use the nqa server enable command to enable the NQA server.

Use the undo nqa server enable command to disable the NQA server.

By default, the NQA server is disabled.

Related commands: nqa server tcp-connect, nqa server udp-echo, and display nqa server status.

Examples

# Enable the NQA server.

<Sysname> system-view

[Sysname] nqa server enable

nqa server tcp-connect

Syntax

nqa server tcp-connect ip-address port-number

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

View

System view

Default level

2: System level

Parameters

ip-address: IP address specified for the TCP listening service on the NQA server.

port-number: Port number specified for the TCP listening service on the NQA server, in the range of 1 to 50000.

Description

Use the nqa server tcp-connect command to create a TCP listening service on the NQA server.

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

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

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

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

Related commands: nqa server enable and display nqa server status.

Examples

# Create a TCP listening service by using the IP address 169.254.10.2 and port 9000.

<Sysname> system-view

[Sysname] nqa server tcp-connect 169.254.10.2 9000

nqa server udp-echo

Syntax

nqa server udp-echo ip-address port-number

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

View

System view

Default level

2: System level

Parameters

ip-address: IP address specified for the UDP listening service on the NQA server.

port-number: Port number specified for the UDP listening service on the NQA server, in the range of 1 to 50000.

Description

Use the nqa server udp-echo command to create a UDP listening service on the NQA server.

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

Configure the command on the NQA server for UDP jitter, UDP echo and voice tests 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 listening service.

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

Related commands: nqa server enable and display nqa server status.

Examples

# Create a UDP listening service by using the IP address 169.254.10.2 and port 9000.

<Sysname> system-view

[Sysname] nqa server udp-echo 169.254.10.2 9000

12-Network Management and Monitoring Command Reference

statistics max-group

statistics interval

Cloud & AI

InterConnect

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Contact Us