- Table of Contents
-
- 12-Network Management and Monitoring Command Reference
- 00-Preface
- 01-GOLD commands
- 02-iFIT commands
- 03-NETCONF commands
- 04-NQA commands
- 05-NTP commands
- 06-Packet capture commands
- 07-PTP commands
- 08-SNMP commands
- 09-TCP connection trace commands
- 10-Information center commands
- 11-Network synchronization commands
- 12-System maintenance and debugging commands
- 13-Process monitoring and maintenance commands
- 14-Mirroring commands
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 04-NQA commands | 533.17 KB |
Contents
NQA and TWAMP Light client commands
display nqa twamp-light client
display nqa twamp-light client statistics
display nqa twamp-light client test-session reaction counters
reaction checked-element two-way-delay
reaction checked-element two-way-jitter
reaction checked-element two-way-loss
reset nqa twamp-light statistics
start (TWAMP Light sender view)
stop (TWAMP Light sender view)
test-session (TWAMP Light client view)
display nqa twamp-light responder
test-session (TWAMP Light responder view)
NQA commands
NQA and TWAMP Light client commands
allowed-frame-loss
Use allowed-frame-loss to set the frame loss ratio (FLR) threshold.
Use undo allowed-frame-loss to restore the default.
Syntax
allowed-frame-loss count
undo allowed-frame-loss
Default
The FLR threshold is not set.
Views
Y.1564 operation view
Predefined user roles
network-admin
Parameters
count: Specifies the maximum number of frames lost over 100000 sent frames. The value range is 0 to 100000.
Usage guidelines
If the FLR during a test in the Y.1564 operation exceeds the FLR threshold, the test fails and the Y.1564 operation is terminated.
Examples
# Set the FLR threshold to 1/1000 for the Y.1564 operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type y1564
[Sysname-nqa-admin-test-y1564] allowed-frame-loss 100
allowed-jitter
Use allowed-jitter to set the frame delay variation (FDV) threshold.
Use undo allowed-jitter to restore the default.
Syntax
allowed-jitter jitter
undo allowed-jitter
Default
The FDV threshold is not set.
Views
Y.1564 operation view
Predefined user roles
network-admin
Parameters
jitter: Specifies the FDV threshold in microseconds. The value range is 1 to 10000000.
Usage guidelines
If the FDV calculated during a test in the Y.1564 operation exceeds the FDV threshold, the test fails and the Y.1564 operation is terminated.
Examples
# Set the FDV threshold to 10000 microseconds for the Y.1564 operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type y1564
[Sysname-nqa-admin-test-y1564] allowed-jitter 10000
allowed-loss-ratio
Use allowed-loss-ratio to set the maximum allowed frame loss ratio.
Use undo allowed-loss-ratio to restore the default.
Syntax
allowed-loss-ratio ratio
undo allowed-loss-ratio
Default
The maximum allowed frame loss ratio is 1/10000.
Views
Throughput operation view
Predefined user roles
network-admin
Parameters
ratio: Specifies the maximum allowed frame loss ratio, 1/10000 or 1/1000000000.
Usage guidelines
# Set the maximum allowed frame loss ratio to 1/1000000000 for the throughput operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type throughput
[Sysname-nqa-admin-test-throughput] allowed-loss-ratio 1/1000000000
allowed-transfer-delay
Use allowed-transfer-delay to set the frame transfer delay (FTD) threshold.
Use undo allowed-transfer-delay to restore the default.
Syntax
allowed-transfer-delay delay
undo allowed-transfer-delay
Default
The FTD threshold is not set.
Views
Y.1564 operation view
Predefined user roles
network-admin
Parameters
delay: Specifies the FTD threshold in microseconds. The value range is 1 to 10000000.
Usage guidelines
If the FTD calculated during a test in the Y.1564 operation exceeds the FTD threshold, the test fails and the Y.1564 operation is terminated.
Examples
# Set the FTD threshold to 10000 microseconds for the Y.1564 operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type y1564
[Sysname-nqa-admin-test-y1564] allowed-transfer-delay 10000
bandwidth
Use bandwidth to specify the committed information rate (CIR) and peak information rate (PIR).
Use undo bandwidth to restore the default.
Syntax
bandwidth cir cir-value [ pir pir-value ]
undo bandwidth
Default
The CIR and PIR are not specified.
Views
Y.1564 operation view
Predefined user roles
network-admin
Parameters
cir-value: Specifies the CIR in kbps. The value range for this argument is 8 to 32000000.
pir-value: Specifies the PIR in kbps. The value range for this argument is 8 to 32000000. If you do not specify the PIR, no PIR test will be performed.
Usage guidelines
For the CIR test to run correctly, the specified CIR must meet the following requirement:
(CIR*1000) / (frame-size + 20) / step count > 1.
The frame-size is the test frame size configured by using the frame-size command, and step count is the step count configured by using the cir-test enable step-count count command.
Examples
# Set the CIR to 2000 kbps and PIR to 3000 kbps for the Y.1564 operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type y1564
[Sysname-nqa-admin-test-y1564] bandwidth cir 2000 pir 3000
bind nqa-entry
Use bind nqa-entry to bind an operation to an operation group.
Use undo bind nqa-entry to remove an operation from an operation group.
Syntax
bind nqa-entry admin-name operation-tag
undo bind nqa-entry admin-name operation-tag
Default
An operation group does not contain any operations.
Views
Y.1564 operation view
RFC2544 operation group view
Predefined user roles
network-admin
Parameters
admin-name operation-tag: Specifies a Y.1564 operation by its administrator name and operation tag. The admin-name argument represents the name of the administrator who creates the operation. The operation-tag argument represents the operation tag. Each of the arguments is a case-insensitive string of 1 to 32 characters that cannot contain hyphens (-).
Usage guidelines
You cannot bind an operation to or remove an operation from an active operation group.
Examples
# Bind the Y.1564 operation with administrator name admin and operation tag test to Y.1564 operation group test.
<Sysname> system-view
[Sysname] nqa y1564 group test
[Sysname-nqa-y1564group-test] bind nqa-entry admin test
Related commands
nqa y1564 group
nqa rfc2544 group
cir-test enable
Use cir-test enable to enable the CIR test.
Use undo cir-test enable to disable the CIR test.
Syntax
cir-test enable [ step-count count ] [ step-duration duration ]
undo cir-test enable
Default
The CIR test is enabled.
Views
Y.1564 operation view
Predefined user roles
network-admin
Parameters
step-count count: Specify the number of steps in the CIR test. The value range is 1 to 1000, and the default is 1.
step-duration duration: Specify the duration of each step in seconds. The value range is 1 to 60, and the default is 3.
Usage guidelines
The CIR test uses a step load test method to gradually reach the CIR configured by using the bandwidth command. Test frames are transmitted at an initial rate of CIR/N, where N is the step count configured by using the step-count count option. The frame transmission rate is increased by CIR/N per step until the CIR is reached.
For a CIR test with a step count of 1, test frames are transmitted at once to the configured CIR.
For the CIR test to run correctly, the specified CIR must meet the following requirement:
(CIR*1000) / (frame-size + 20) / step count > 1.
The frame-size is the test frame size configured by using the frame-size command.
Examples
# Enable the CIR test in the Y.1564 operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type y1564
[Sysname-nqa-admin-test-y1564] cir-test enable
Related commands
bandwidth
color-aware-mode enable
Use color-aware-mode enable to enable the color-aware mode.
Use undo color-aware-mode enable to disable the color-aware mode.
Syntax
color-aware-mode enable [ { 8021p | dscp } green value1 [ to value2 ] yellow value1 [ to value2 ] ]
undo color-aware-mode enable
Default
The color-aware mode is disabled.
Views
Y.1564 operation view
Predefined user roles
network-admin
Parameters
8021p: Colors the probe frames according to the 802.1p priority value.
dscp: Colors the probe frames according to the DSCP precedence value.
green: Specifies the green color.
yellow: Specifies the yellow color.
value1 to value2: Specifies the priority value range. The value range is 0 to 7 for 802.1p priority, and 0 to 63 for the DSCP precedence. The value2 value must be higher than the value1 value.
Usage guidelines
To test the traffic service quality in a congested Layer 2 network, you can use this command to specify colors for probe frames of different priorities.
This command only takes effect for the PIR test and traffic policing test.
· If color-aware mode is disabled, the device sends probe frames at a fixed rate.
· If color-aware mode is enabled, the device sends probe packets at different rates according to the frame priorities.
For more information about the mapping between 802.1p or DSCP priorities and colors, see configuring priority mapping in ACL and QoS Configuration Guide.
Examples
# Enable the color-aware mode.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type y1564
[Sysname-nqa-admin-test-y1564] color-aware-mode enable 8021p green 1 to 4 yellow 5
Related commands
priority 8021p
data-size
Use data-size to set the payload size for each probe packet.
Use undo data-size to restore the default.
Syntax
data-size size
undo data-size
Default
The default payload size of a probe packet for different operations is described in Table 1.
Table 1 Default payload size of a probe packet
|
Operation type |
Codec type |
Default size (bytes) |
|
TWAMP Light |
N/A |
142 |
Views
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
size: Specifies the payload size in bytes. The value ranges vary by operation type and destination address type.
· 44 to 1518 for TWAMP Light tests.
In TWAMP Light tests, the payload size cannot be larger than the MTU size of any interface on the test link.
Examples
# Set the payload size to 80 bytes for each TWAMP Light test request.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client] test-session 1
[Sysname-nqa-twamp-light-client-session1] data-size 80
description
Use description to configure a description for an NQA operation, such as the operation type or purpose.
Use undo description to restore the default.
Syntax
description text
undo description
Default
No description is configured for an NQA operation.
Views
Frame loss/latency/throughput operation view
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
text: Specifies a description, a case-sensitive string of 1 to 200 characters.
Examples
# # Configure the description as twamp-light-probe for the TWAMP Light test.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client] test-session 1
[Sysname-nqa-twamp-light-client-session1] description twamp-light-probe
destination ip
Use destination ip to configure the destination IPv4 address for the operation.
Use undo destination ip to restore the default.
Syntax
Y.1564 operations:
destination ip ipv4-address1 [ to ipv4-address2 ]
undo destination ip
Other operations:
destination ip ipv4-address
undo destination ip
Default
For the frame loss, latency, or throughput operation, the destination IPv4 address is 198.18.65.1. For other types of operations, no destination IPv4 address is configured for an operation.
Views
Frame loss/latency/throughput/Y.1564 operation view
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
ipv4-address: Specifies the destination IPv4 address.
ipv4-address1 to ipv4-address2: Specifies a destination IPv4 address range. The ipv4-address2 must be higher than the ipv4-address1. Between the two destination IPv4 addresses, only one octet difference is allowed and the value difference cannot exceed 127.
Usage guidelines
For path quality analysis and Y.1564 operations to start successfully, configure the source and destination IP addresses as follows:
· In a Layer 3 Ethernet and L3VPN network, configure both source and destination IP addresses.
· In other networks, configure both of them or none of them. If they are configured, make sure the source and destination IP addresses are of the same IP version.
Examples
# In TWAMP Light client-session view, specify 10.1.1.2 as the destination IPv4 address for the TWAMP Light test.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client] test-session 1
[Sysname-nqa-twamp-light-client-session1] destination ip 10.1.1.2
destination ipv6
Use destination ipv6 to configure the destination IPv6 address for the operation.
Use undo destination ipv6 to restore the default.
Syntax
Y.1564 operations:
destination ipv6 ipv6-address1 [ to ipv6-address2 ]
undo destination ipv6
Other operations:
destination ipv6 ipv6-address
undo destination ipv6
Default
No destination IPv6 address is configured for an operation.
Views
Frame loss/latency/throughput/Y.1564 operation view
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
ipv6-address: Specifies the destination IPv6 address. IPv6 link-local addresses are not supported.
ipv6-address1 to ipv6-address2: Specifies a destination IPv6 address range. The ipv6-address2 must be higher than the ipv6-address1. Between the two destination IPv6 addresses, only one octet difference is allowed and the value difference cannot exceed 127.
Usage guidelines
For path quality analysis and Y.1564 operations to start successfully, configure the source and destination IP addresses as follows:
· In a Layer 3 Ethernet and L3VPN network, configure both source and destination IP addresses.
· In other networks, configure both of them or none of them. If they are configured, make sure the source and destination IP addresses are of the same IP version.
Examples
# In TWAMP Light client-session view, specify 1::2 as the destination IPv6 address for the TWAMP Light test.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client] test-session 1
[Sysname-nqa-twamp-light-client-session1] destination ipv6 1::2
destination mac
Use destination mac to specify the destination MAC address for the operation.
Use undo destination mac to restore the default.
Syntax
Frame loss/latency/throughput/TWAMP Light operations:
destination mac mac-address
undo destination mac
Y.1564 operations:
destination mac mac-address1 [ to mac-address2 ]
undo destination mac
Default
For the frame loss, latency, throughput, or Y.1564 operation, the destination MAC address is 0023-8900-0001.
For the TWAMP Light test, no destination MAC address is specified.
Views
Frame loss/latency/throughput/Y.1564 operation view
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
mac-address: Specifies the destination MAC address in the format H-H-H. For example, to use 000f-00e2-0001 as the destination MAC address, set this argument to f-e2-1.
mac-address1 to mac-address2: Specifies a destination MAC address range. The mac-address2 must be higher than the mac-address1. Between the two destination MAC addresses, only one octet difference is allowed and the value difference cannot exceed 127.
Examples
# Specify 0001-0001-0002 as the destination MAC address for the throughput operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type throughput
[Sysname-nqa-admin-test-throughput] destination mac 1-1-2
# In TWAMP Light client-session view, specify 0001-0001-0002 as the destination MAC address for the TWAMP Light test.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client] test-session 1
[Sysname-nqa-twamp-light-client-session1] destination mac 1-1-2
destination port
Use destination port to configure the destination port number for the operation.
Use undo destination port to restore the default.
Syntax
Y.1564 operations:
destination port port-number1 [ to port-number2 ]
undo destination port
Other operations:
destination port port-number
undo destination port
Default
The destination port numbers for the following operations are as follows:
· 7 for the frame loss, latency, and throughput operations.
· Not configured for TWAMP Light operations.
Views
Frame loss/latency/throughput/Y.1564 operation view
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
port-number: Specifies the destination port number, in the range of 1 to 65535.
port-number1 to port-number2: Specifies the destination port number range. The port-number2 must be greater than the port-number1. Between the two destination port numbers, only one octet difference is allowed and the value difference cannot exceed 127.
Examples
# In TWAMP Light client-session view, set the destination port number to 9000 for the TWAMP Light test.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client] test-session 1
[Sysname-nqa-twamp-light-client-session1] destination port 9000
display nqa result
Use display nqa result to display the most recent result of an NQA operation.
Syntax
display nqa result [ admin-name operation-tag ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
admin-name operation-tag: Specifies an NQA operation by its administrator name and operation tag. The admin-name argument represents the name of the administrator who creates the NQA operation. The operation-tag argument represents the operation tag. Each of the arguments is a case-insensitive string of 1 to 32 characters that cannot contain hyphens (-). If you do not specify an NQA operation, the command displays the most recent results of all NQA operations.
Examples
# Display the most recent result of the Y.1564 operation with administrator name admin and operation tag test.
<Sysname> display nqa result admin test
NQA entry (admin admin, tag test) test results:
Status : Succeeded
Last test : Service performance test
Estimated total time : 6
Actual test time used : 6
Detailed test results:
CIR test (with the step of 1):
Start time : 2016-11-15 21:00:02.1
End time : 2016-11-15 21:00:14.3
Status : Succeeded
Min/Max/Average IR(kbps) : 996/1003/1000
Min/Max/Average FTD(us) : 67/78/69
Min/Max/Average FDV(us) : 0/10/1
FL count/FLR : 0/0.000%
Packets out of order : 0
Severely Err Secs/AVAIL : 0/100.000%
PIR test (color green):
Start time : 2016-11-15 21:00:22.3
End time : 2016-11-15 21:00:34.5
Status : Succeeded
Min/Max/Average IR(kbps) : 997/1005/1000
Min/Max/Average FTD(us) : 68/69/68
Min/Max/Average FDV (us) : 35/39/37
FL count/FLR : 2/0.002%
Packets out of order : 0
Severely Err Secs/AVAIL : 0/100.000%
PIR test (color yellow):
Start time : 2016-11-15 21:00:22.5
End time : 2016-11-15 21:00:34.7
Status : --
Min/Max/Average IR(kbps) : 496/503/499
Min/Max/Average FTD(us) : 67/69/68
Min/Max/Average FDV (us) : 40/45/42
FL count/FLR : 2/0.002%
Packets out of order : 0
Severely Err Secs/AVAIL : 0/100.000%
PIR test (total):
Start time : 2016-11-15 21:00:22.5
End time : 2016-11-15 21:00:34.7
Status : --
Min/Max/Average IR(kbps) : 1493/1508/1499
Min/Max/Average FTD(us) : 68/69/68
Min/Max/Average FDV (us) : 35/45/40
FL count/FLR : 2/0.002%
Packets out of order : 0
Severely Err Secs/AVAIL : 0/--
Traffic policing test (color green)
Start time : 2016-11-15 21:00:42.7
End time : 2016-11-15 21:00:54.9
Status : Succeeded
Min/Max/Average IR(kbps) : 997/1005/1000
Min/Max/Average FTD(us) : 67/69/68
Min/Max/Average FDV (us) : 94/98/96
FL count/FLR : 4/0.004%
Packets out of order : 0
Severely Err Secs/AVAIL : 0/100.000%
Traffic policing test (color yellow):
Start time : 2016-11-15 21:00:42.1
End time : 2016-11-15 21:00:54.3
Status : --
Min/Max/Average IR(kbps) : 622/627/624
Min/Max/Average FTD(us) : 68/69/68
Min/Max/Average FDV (us) : 58/62/60
FL count/FLR : 10/0.01%
Packets out of order : 0
Severely Err Secs/AVAIL : 0/100.000%
Traffic policing test (total):
Start time : 2016-11-15 21:00:42.5
End time : 2016-11-15 21:00:54.7
Status : --
Min/Max/Average IR(kbps) : 1619/1632/1624
Min/Max/Average FTD(us) : 67/69/68
Min/Max/Average FDV (us) : 58/62/60
FL count/FLR : 10/0.01%
Packets out of order : 0
Severely Err Secs/AVAIL : 0/--
Service performance test:
Start time : 2016-11-15 21:16:06.7
End time : 2016-11-15 21:17:07.9
Status : Succeeded
Min/Max/Average IR(kbps) : 996/1003/999
Min/Max/Average FTD(us) : 67/69/68
Min/Max/Average FDV (us) : 47/51/49
FL count/FLR : 2/0.002%
Packets out of order : 0
Severely Err Secs/AVAIL : 0/100.000%
# Display the most recent result of the throughput operation with administrator name admin and operation tag test.
<Sysname> display nqa result admin test
NQA entry (admin admin, tag test) test results:
Basic results :
Initial speed(Kbps) : 100000
Speed granularity(Kbps): 1000
Probe duration(s) : 60
Probe interval(s) : 4
Allowed-loss-ratio : 1/10000
Throughput results:
Frame size(Byte): 64
Current speed(Kbps): -
Frame-loss(Loss/Tx): -
Status : Failed
Time : 2022-01-01 07:20:40.8
Frame size(Byte): 512
Current speed(Kbps): 4000
Frame-loss(Loss/Tx): 0/10000
Status : Succeeded
Time : 2022-01-01 07:21:40.8
Frame size(Byte): 1024
Current speed(Kbps): 8000
Frame-loss(Loss/Tx): 0/10000
Status : Succeeded
Time : 2022-01-01 07:22:52.8
Frame size(Byte): 1280
Current speed(Kbps): 10000
Frame-loss(Loss/Tx): 0/10000
Status : Succeeded
Time : 2022-01-01 07:23:45.8
Frame size(Byte): 1518
Current speed(Kbps): 10000
Frame-loss(Loss/Tx): 0/10000
Status : Succeeded
Time : 2022-01-01 07:24:45.8
Table 2 Command output
|
Field |
Description |
|
NQA entry (admin admin, tag test) test results |
NQA operation results. |
|
Data collecting in progress |
The operation is in progress. |
|
Send operation times |
Number of operations. |
|
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 most recent successful probe was completed. If no probes are successful in an operation, the field displays 0. |
|
Extended results |
Results of extended items. |
|
Packet loss ratio |
Average packet loss ratio. |
|
Failures due to timeout |
Number of timeout occurrences in an operation. |
|
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 internal error |
Number of failures due to internal errors. |
|
Failures due to other errors |
Failures due to other errors. |
|
Packets out of sequence |
Number of failures due to out-of-sequence packets. |
|
Packets arrived late |
Number of response packets received after a probe times out. |
|
RTT number |
Number of response packets received. |
|
Min positive SD |
Minimum positive jitter from source to destination, in milliseconds. |
|
Min positive DS |
Minimum positive jitter from destination to source, in milliseconds. |
|
Max positive SD |
Maximum positive jitter from source to destination, in milliseconds. |
|
Max positive DS |
Maximum positive jitter from destination to source, in milliseconds. |
|
Positive SD number |
Number of positive jitters from source to destination. |
|
Positive DS number |
Number of positive jitters from destination to source. |
|
Positive SD sum |
Sum of positive jitters from source to destination, in milliseconds. |
|
Positive DS sum |
Sum of positive jitters from destination to source, in milliseconds. |
|
Positive SD average |
Average positive jitters from source to destination, in milliseconds. |
|
Positive DS average |
Average positive jitters from destination to source, in milliseconds. |
|
Positive SD square-sum |
Square sum of positive jitters from source to destination. |
|
Positive DS square-sum |
Square sum of positive jitters from destination to source. |
|
Min negative SD |
Minimum absolute value among negative jitters from source to destination, in milliseconds. |
|
Min negative DS |
Minimum absolute value among negative jitters from destination to source, in milliseconds. |
|
Max negative SD |
Maximum absolute value among negative jitters from source to destination, in milliseconds. |
|
Max negative DS |
Maximum absolute value among negative jitters from destination to source, in milliseconds. |
|
Negative SD number |
Number of negative jitters from source to destination. |
|
Negative DS number |
Number of negative jitters from destination to source. |
|
SD average |
Average jitter from source to destination, in milliseconds. |
|
DS average |
Average jitter from destination to source, in milliseconds. |
|
Negative SD sum |
Sum of absolute values of negative jitters from source to destination, in milliseconds. |
|
Negative DS sum |
Sum of absolute values of negative jitters from destination to source, in milliseconds. |
|
Negative SD average |
Average absolute value of negative jitters from source to destination, in milliseconds. |
|
Negative DS average |
Average absolute value of negative jitters from destination to source, in milliseconds. |
|
Negative SD square-sum |
Square sum of negative jitters from source to destination. |
|
Negative DS square-sum |
Square sum of negative jitters from destination to source. |
|
Max SD delay |
Maximum delay from source to destination, in milliseconds. |
|
Max DS delay |
Maximum delay from destination to source, in milliseconds. |
|
Min SD delay |
Minimum delay from source to destination, in milliseconds. |
|
Min DS delay |
Minimum delay from destination to source, in milliseconds. |
|
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, in milliseconds. |
|
Sum of DS delay |
Sum of delays from destination to source, in milliseconds. |
|
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 packets |
Number of lost packets from the source to the destination. |
|
DS lost packets |
Number of lost packets from the destination to the source. |
|
Lost packets for unknown reason |
Number of lost packets for unknown reasons. |
|
MOS value |
MOS value calculated for the voice operation. |
|
ICPIF value |
ICPIF value calculated for the voice operation. |
|
TTL |
If the routing table bypass feature is not enabled in the operation, this field displays the TTL value in the probe packet. If the routing table bypass feature is enabled, the value of this field varies by the init-ttl command. However, the actual TTL value in the probe packet is fixed at 1. |
|
Hop IP |
IP address of the node that sent the reply packet. |
|
Time |
Time when the NQA client received the reply packet. |
|
Basic results |
Results of basic items. |
|
Throughput results |
Throughput operation results. |
|
Frame-loss results |
Frame loss operation results. |
|
Latency results |
Latency operation results. |
|
Initial speed(Kbps) |
Initial rate for sending probe packets, in kbps. |
|
Speed granularity(Kbps) |
Granularity of rate adjustment, in kbps. |
|
Probe duration(s) |
Duration of a probe, in seconds. |
|
Probe interval(s) |
Intervals at which probes are performed, in seconds. |
|
Allowed-loss-ratio |
Maximum packet loss rate supported. |
|
Frame size(Byte) |
Frame size in bytes. |
|
Current speed(Kbps) |
Current rate in kbps. |
|
Frame-loss(Loss/Tx) |
Frame loss rate. |
|
Min-latency(us) |
Minimum latency in microseconds. |
|
Max-latency(us) |
Maximum latency in microseconds. |
|
Avg-latency(us) |
Average latency in microseconds. |
|
Min-jitter(ns) |
Minimum jitter in nanoseconds. |
|
Max-jitter(ns) |
Maximum jitter in nanoseconds. |
|
Avg-jitter(ns) |
Average jitter in nanoseconds. |
|
Sent packets |
Number of packets sent. |
|
Received packets |
Number of packets received. |
|
Status |
Probe result: · Succeeded. · Failed. |
|
Time |
Time when the probe was completed. |
display nqa rfc2544 group
Use display nqa rfc2544 group to display information about path quality analysis operation groups.
Syntax
display nqa rfc2544 group [ brief | name group-name | result [ group-name ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
brief: Displays brief information about path quality analysis operation groups.
name group-name: Specifies a path quality analysis operation group by its name, a case-insensitive string of 1 to 32 characters. If you do not specify this option, the command displays detailed information about all path quality analysis operation groups.
result: Displays probe results of path quality analysis operation groups.
Usage guidelines
If you do not specify any parameters, this command displays detailed information about all path quality analysis operation groups.
Examples
# Display brief information about path quality analysis operation groups.
<Sysname> display nqa rfc2544 group brief
Group name Status
test1 Active
test2 Idle
# Display detailed information about path quality analysis operation group test.
<Sysname> display nqa rfc2544 group name test
Group name: test
Status: Idle
Bound NQA entry information:
Admin-name Operation-tag
admin 1
admin 2
# Display probe results of path quality analysis operation group test.
<Sysname> display nqa rfc2544 group result test
NQA entry (admin admin, tag 1) test results:
Basic results :
Initial speed(Kbps) : 100000
Probe duration(s) : 60
Probe interval(s) : 4
Frame-loss results:
Frame size(Byte): 64
Current speed(Kbps): 100000
Frame-loss : 0.0672002%
Status : Succeeded
Time : 2021-04-17 15:39:33.3
Frame size(Byte): 96
Current speed(Kbps): 100000
Frame-loss : 0.0928005%
Status : Succeeded
Time : 2021-04-17 15:39:35.3
NQA entry (admin admin, tag 2) test results:
Basic results :
Initial speed(Kbps): 100000
Probe duration(s) : 60
Probe interval(s) : 4
Latency results:
Frame size : 64
Min-latency(us) : 146
Max-latency(us) : 150
Avg-latency(us) : 148
Min-jitter(ns) : 0
Max-jitter(ns) : 0
Avg-jitter(ns) : 0
Sent packets : 10000
Received packets : 9998
Status : Succeeded
Time : 2021-04-17 15:39:37.3
Frame size : 128
Min-latency(us) : 82
Max-latency(us) : 86
Avg-latency(us) : 84
Min-jitter(ns) : 0
Max-jitter(ns) : 0
Avg-jitter(ns) : 0
Sent packets : 10000
Received packets : 9998
Status : Succeeded
Time : 2021-04-17 15:39:39.3
NQA entry (admin admin, tag 3) test results:
Basic results :
Initial speed(Kbps) : 100000
Speed granularity(Kbps): 1000
Probe duration(s) : 60
Probe interval(s) : 4
Allowed-loss-ratio : 1/10000
Throughput results:
Frame size(Byte): 64
Current speed(Kbps): -
Frame-loss(Loss/Tx): -
Status : Failed
Time : 2021-04-17 15:41:12.4
Table 3 Command output
|
Field |
Description |
|
Group name |
Name of the path quality analysis operation group |
|
Status |
Status of the operation: · Idle. · Active. |
|
Bound NQA entry information |
Information about the NQA operation bound to the path quality analysis operation group. |
|
Admin-name |
Administrator name of the NQA operation. |
|
Operation-tag |
Operation tag. |
|
Status |
Operation status: · Succeeded. · Failed. · In progress. · Aborted—the operation is stopped manually by the user. · Timeout. · Unknown error. · --—The operation status is invalid. |
display nqa twamp-light client
Use display nqa twamp-light client to display test session information on the TWAMP Light client.
Syntax
display nqa twamp-light client [ test-session session-id | verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
test-session session-id: Displays detailed information about a test session by its ID. The value range for the session-id argument is 1 to 512.
verbose: Displays detailed information about all TWAMP Light test sessions.
Usage guidelines
If you do not specify any keywords, this command displays brief information about all test sessions.
Examples
# Display brief information about all test sessions.
<Sysname> display nqa twamp-light client
Brief information about all test sessions:
Total sessions: 2
Active sessions: 1
------------------------------------------------------------------------------------
ID Status Source IP/Port Destination IP/Port
1 Active 10.1.1.1/10000 10.2.2.2/20000
2 Inactive 4.4.4.1/7777 4.4.4.2/8888
# Display detailed information about all test sessions.
<Sysname> display nqa twamp-light client verbose
Session ID : 1
Status : Active
Session type : Permanent
Source interface : -
Service instance : -
Source IP : 10.1.1.1
Source IPv6 : -
Destination IP : 10.2.2.2
Destination IPv6 : -
Source port : 10000
Destination port : 20000
Source MAC : -
Destination MAC : -
VLAN ID : -
Service VLAN ID : -
Customer VLAN ID : -
ToS : 0
Padding length : 142
Timestamp format : PTP
VPN instance : -
Priority 802.1p : 0
Last start time : Never
Last stop time : Never
Packet sending interval(ms) : 100
Timeout(sec) : 5
Duration(sec) : -
Packets sent : -
Statistics interval(ms) : 10000
Monitor time(ms) : 20000
Delay monitor time(ms) : 20000
Jitter monitor time(ms) : 20000
Loss monitor time(ms) : 20000
Session ID : 2
Status : Inactive
Session type : -
Source interface : Ten-GigabitEthernet2/0/1
Service instance : -
Source IP : 4.4.4.1
Source IPv6 : -
Destination IP : 4.4.4.2
Destination IPv6 : -
Source port : 7777
Destination port : 8888
Source MAC : 0001-0001-0001
Destination MAC : 0001-0001-0002
VLAN ID : -
Service VLAN ID : -
Customer VLAN ID : -
ToS : 0
Padding length : 142
Timestamp format : PTP
VPN instance : -
Priority 802.1p : 0
Last start time : Never
Last stop time : Never
Packet sending interval(ms) : -
Timeout(sec) : -
Duration(sec) : -
Packets sent : -
Statistics interval(ms) : -
Monitor time(ms) : -
Delay monitor time(ms) : -
Jitter monitor time(ms) : -
Loss monitor time(ms) : -
Table 4 Command output
|
Field |
Description |
|
Total sessions |
Total number of test sessions. |
|
Active sessions |
Number of active sessions. |
|
Session ID |
Session ID. |
|
Status |
Test status: · Active—The TWAMP Light test is active. · Inactive—The TWAMP Light test is not active. |
|
Session type |
Test session type: · On-demand. · Permanent. |
|
Source interface |
Source AC interface of the test session. |
|
Service instance |
Ethernet service instance bound to source interface. The Ethernet service instance on the client must be consistent with that on the server. |
|
Source IP |
Source IPv4 address of the test session. |
|
Source IPv6 |
Source IPv6 address of the test session. |
|
Destination IP |
Destination IPv4 address of the test session. |
|
Destination IPv6 |
Destination IPv6 address of the test session. |
|
Source port |
Source port number of the test session. |
|
Destination port |
Destination port number of the test session. |
|
Source MAC address |
Source MAC address of the test session. |
|
Destination MAC address |
Destination MAC address of the test session. |
|
VLAN ID |
VLAN ID of the test session. |
|
Service VLAN ID |
Outer VLAN ID of the test session. |
|
Customer VLAN ID |
Inner VLAN ID of the test session. |
|
ToS |
Type of Service of the test session. |
|
Padding length |
Padding length of the test session. |
|
Timestamp format |
Timestamp format: NTP or PTP. |
|
VPN instance |
MPLS L3VPN instance name. |
|
Priority 802.1p |
802.1p priority. |
|
Last start time |
Start time of the most recent TWAMP Light test, in the format of YYYY-MM-DD HH:MM:SS:MS. Without link bundle configured, if the test does not start, this field displays Never. With link bundle configured, this field always displays Never. |
|
Last stop time |
Stop time of the most recent TWAMP Light test, in the format of YYYY-MM-DD HH:MM:SS:MS. Without link bundle configured, if the test does not start, this field displays Never. With link bundle configured, this field always displays Never. |
|
Packet sending interval(ms) |
Packet sending interval of the TWAMP Light test, in milliseconds. |
|
Timeout(sec) |
Timeout time of the reflected packet within a TWAMP Light test, in seconds. |
|
Duration(sec) |
Duration of the TWAMP Light test, in seconds. This field is available only for the on-demand test that is configured with the duration. |
|
Packets sent |
Number of sent packets in the TWAMP Light test. This field is available only for the on-demand test that is configured with the number of packets sent in the test. |
|
Statistics interval(ms) |
Statistics collection interval of the TWAMP Light test, in milliseconds. |
|
Monitor time(ms) |
Packet monitoring time of the TWAMP Light test, in milliseconds. The value of this field is specified by the start command in TWAMP Light sender view. |
|
Delay monitor time(ms) |
Monitoring time for two-way delay of the TWAMP Light test, in milliseconds. This field displays a hyphen (-) when the test is not started. |
|
Jitter monitor time(ms) |
Monitoring time for two-way jitter of the TWAMP Light test, in milliseconds. This field displays a hyphen (-) when the test is not started. |
|
Loss monitor time(ms) |
Monitoring time for two-way packet loss of the TWAMP Light test, in milliseconds. This field displays a hyphen (-) when the test is not started. |
Related commands
test-session
display nqa twamp-light client statistics
Use display nqa twamp-light client statistics to display test session statistics on the TWAMP Light client, including two-way delay, two-way jitter, and two-way packet loss.
Syntax
display nqa twamp-light client statistics { two-way-delay | two-way-loss } test-session session-id
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
two-way-delay: Displays statistics about two-way delay and two-way jitter.
two-way-loss: Displays statistics about two-way packet loss.
session-id: Specifies a session ID. The value must be an integer. The value range for this argument is 1 to 512.
Examples
# Display statistics about two-way delay and two-way jitter for the specified TWAMP Light test session.
<Sysname> display nqa twamp-light client statistics two-way-delay test-session 1
Latest two-way-delay statistics(us):
Index Delay(Avg) Jitter(Avg) SD-jitter(Avg) DS-jitter(Avg)
1 734 240 81 159
2 658 24 12 12
3 580 91 31 60
4 667 40 42 2
5 8346 15226 15293 67
6 627 18 17 35
7 659 10 4 14
8 662 67 46 21
--------------------------------------------------------------------------------
Average delay : 1617 Average jitter : 1965
Maximum delay : 15959 Maximum jitter : 15226
Minimum delay : 534 Minimum jitter : 10
Average SD jitter: 1941 Average DS jitter: 46
Maximum SD jitter: 15293 Maximum DS jitter: 159
Minimum SD jitter: 4 Minimum DS jitter: 2
Table 5 Command output
|
Field |
Description |
|
Latest two-way delay statistics(μs) |
Most recent statistics of two-way delay in microseconds. |
|
Index |
Serial number of the statistics data. |
|
Delay(avg) |
Average delay. |
|
Jitter(avg) |
Average jitter. |
|
SD jitter(avg) |
Average jitter from source to destination. |
|
DS jitter(avg) |
Average jitter from destination to source. |
|
Average delay |
Average delay. |
|
Average jitter |
Average jitter. |
|
Maximum delay |
Maximum delay. |
|
Maximum jitter |
Maximum jitter. |
|
Minimum delay |
Minimum delay. |
|
Minimum jitter |
Minimum jitter. |
|
Average SD jitter |
Average jitter from source to destination. |
|
Average DS jitter |
Average jitter from destination to source. |
|
Maximum SD jitter |
Maximum jitter from source to destination. |
|
Maximum DS jitter |
Maximum jitter from destination to source. |
|
Minimum SD jitter |
Minimum jitter from source to destination. |
|
Minimum DS jitter |
Minimum jitter from destination to source. |
# Display the two-way packet loss statistics for the specified TWAMP Light test session.
<Sysname> display nqa twamp-light client statistics two-way-loss test-session 1
Latest two-way loss statistics:
Index Loss count Loss ratio Error count Error ratio
11006 5 50.0000% 0 0.0000%
11007 3 30.0000% 0 0.0000%
11008 4 40.0000% 0 0.0000%
11009 8 80.0000% 0 0.0000%
11010 10 100.0000% 0 0.0000%
11011 1 10.0000% 0 0.0000%
11012 10 100.0000% 0 0.0000%
11013 2 20.0000% 0 0.0000%
11014 10 100.0000% 0 0.0000%
11015 9 90.0000% 0 0.0000%
11016 6 60.0000% 0 0.0000%
11017 2 20.0000% 0 0.0000%
11018 8 80.0000% 0 0.0000%
11019 2 20.0000% 0 0.0000%
11020 8 80.0000% 0 0.0000%
11021 2 20.0000% 0 0.0000%
11022 2 20.0000% 0 0.0000%
11023 7 70.0000% 0 0.0000%
11024 4 40.0000% 0 0.0000%
11025 4 40.0000% 0 0.0000%
11026 7 70.0000% 0 0.0000%
11027 7 70.0000% 0 0.0000%
11028 8 80.0000% 0 0.0000%
11029 1 10.0000% 0 0.0000%
11030 2 20.0000% 0 0.0000%
11031 8 80.0000% 0 0.0000%
11032 7 70.0000% 0 0.0000%
11033 7 70.0000% 0 0.0000%
11034 8 80.0000% 0 0.0000%
11035 4 40.0000% 0 0.0000%
--------------------------------------------------------------------------------
Average loss count : 5 Average loss ratio : 55.3333%
Maximum loss count : 10 Maximum loss ratio : 100.0000%
Minimum loss count : 1 Minimum loss ratio : 10.0000%
Average error count: 0 Average error ratio: 0.0000%
Maximum error count: 0 Maximum error ratio: 0.0000%
Minimum error count: 0 Minimum error ratio: 0.0000%
Table 6 Command output
|
Field |
Description |
|
Latest two-way loss statistics |
Most recent statistics of two-way packet loss. |
|
Loss count |
Number of lost packets. |
|
Loss ratio |
Packet loss rate. |
|
Error count |
Number of error packets. |
|
Error ratio |
Packet error rate. |
|
Average loss count |
Average number of lost packets. |
|
Average loss ratio |
Average packet loss rate. |
|
Maximum loss count |
Maximum number of lost packets. |
|
Maximum loss ratio |
Maximum packet loss rate. |
|
Minimum loss count |
Minimum number of lost packets. |
|
Minimum loss ratio |
Minimum packet loss rate. |
|
Average error count |
Average number of error packets. |
|
Average error ratio |
Average packet error rate. |
|
Maximum error count |
Maximum number of error packets. |
|
Maximum error ratio |
Maximum packet error rate. |
|
Minimum error count |
Minimum number of error packets. |
|
Minimum error ratio |
Minimum packet error rate. |
|
Index |
ID of a reaction entry. |
Related commands
reset nqa twamp-light statistics
test-session (TWAMP Light client view)
display nqa twamp-light client test-session reaction counters
Use display nqa twamp-light client test-session reaction counters to display the current monitoring results of reaction entries for the TWAMP Light test sessions.
Syntax
display nqa twamp-light client test-session reaction counters [ session-id [ item-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
session-id: Specifies a session by its ID. The value range for this argument is 1 to 512. If you do not specify this option, the command displays all statistics information about the specified session.
item-number: Specifies a reaction entry ID in the range of 1 to 10. If you do not specify a reaction entry, the command displays the current monitoring results of all reaction entries.
Usage guidelines
If you do not specify any parameters, this command displays the monitoring results of reaction entries for all TWAMP Light test sessions.
Examples
# Display the current monitoring results of the reaction entries for TWAMP Light test session 1.
<Sysname> display nqa twamp-light client test-session reaction counters 1
Reaction counters for session 1:
Index: 1
Checked element: two-way-delay
Lower-threshold: 5
Upper-threshold: 50
Action type: trap-only
Check-objects: 0
Threshold violations: 0
Reaction counters for session 2:
Index: 1
Checked element: two-way-delay
Lower-threshold: 5
Upper-threshold: 50
Action type: trap-only
Check-objects: 1
Threshold violations: 0
Table 7 Command output
|
Field |
Description |
|
Reaction counters for session |
Monitoring results of the reaction entries for the TWAMP Light test session. |
|
Index |
ID of a reaction entry. |
|
Checked element |
Monitored performance metric. |
|
Lower threshold |
Lower limit of the threshold. |
|
Upper threshold |
Upper limit of the threshold. |
|
Action type |
Action for the threshold violation event. |
|
Checked objects |
Number of packets that have been monitored. |
|
Threshold violations |
Number of threshold violations. |
Related commands
reaction checked-element two-way-delay
reaction checked-element two-way-loss
reaction checked-element two-way-jitter
display nqa y1564 group
Use display nqa y1564 group to display information about Y.1564 operation groups.
Syntax
display nqa y1564 group [ brief | name group-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
brief: Displays brief information about all NQA Y.1564 operation groups.
name group-name: Displays detailed information about a Y.1564 operation group. The group-name argument specifies the group name, a case-insensitive string of 1 to 32 characters.
Usage guidelines
If you do not specify any parameters, this command displays detailed information about all Y.1564 operation groups.
Examples
# Display brief information about all Y.1564 operation groups.
<Sysname> display nqa y1564 group brief
Group name Status
test1 Active
test2 Idle
# Display detailed information about the Y.1564 operation group test.
<Sysname> display nqa y1564 group name test
Group name: test
Status: Idle
Bound NQA entry information:
Admin-name Operation-tag
y1564 1
y1564 2
Table 8 Command output
|
Field |
Description |
|
Group name |
Name of the Y.1564 operation group. |
|
Status |
Status of the Y.1564 operation group: · Idle. · Active. |
|
Admin-name |
Admin name of a Y.1564 operation bound to the Y.1564 operation group. |
|
Operation-tag |
Operation tag of the Y.1564 operation. |
Related commands
nqa y1564 group
exchange-port enable
Use exchange-port enable to enable port exchange between the source port and the destination port.
Use undo exchange-port enable to restore the default.
Syntax
exchange-port enable
undo exchange-port enable
Default
Exchange between the source port and the destination port is disabled.
Views
Frame loss/latency/throughput/Y.1564 operation view
Predefined user roles
network-admin
Usage guidelines
By default, the NQA server reflects the probe packets back to the client without changing the source or destination port in the frame loss, latency, throughput, and Y.1564 operations. The client can parse the probe packets directly because the ports are not changed.
If port exchange is enabled on the NQA server, enable port exchange on the client so that the client can correctly parse the port information in the reflected packets. To enable port exchange on the server, specify the exchange-port keyword in the nqa reflector command.
Examples
# Enable port exchange between the source and destination ports.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type throughput
[Sysname-nqa-admin-test-throughput] exchange-port enable
frame-size
Use frame-size to specify a list of probe packet sizes.
Use undo frame-size to restore the default.
Syntax
frame-size size&<1-7>
undo frame-size [ size&<1-7> ]
Default
The probe packet size is 512 bytes for the Y.1564 operation. For the frame loss, latency, or throughput operation, the probe packet size is 1518 bytes.
Views
Frame loss/latency/throughput/Y.1564 operation view
Predefined user roles
network-admin
Parameters
size&<1-7>: Specifies a space-separated list of up to 7 packet size items. Each item specifies a packet size. The size value range is 64 to 9600 bytes.
Usage guidelines
The frame loss, latency, or throughput operation uses the list of packet sizes to send probe packets. The packets in each probe are of the same size.
If the service packet size is larger than the smallest packet size in the specified list, the probe packets might not be sent. In this case, you can use this command to adjust the probe packet size.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Specify a probe packet size list of 64, 512, 1024, and 1280 bytes for the throughput operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type throughput
[Sysname-nqa-admin-test-throughput] frame-size 64 512 1024 1280
# Set the probe packet size to 1024 bytes for the Y.1564 operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type y1564
[Sysname-nqa-admin-test-y1564] frame-size 1024
hex-data-fill
Use hex-data-fill to configure a hexadecimal string to fill the probe packet payload.
Use undo hex-data-fill to restore the default.
Syntax
hex-data-fill { 00 | 55 | aa | ff }
undo hex-data-fill
Default
The hexadecimal payload fill string is all-zero.
Views
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
00: Specifies hexadecimal string 00.
55: Specifies hexadecimal string 55.
aa: Specifies hexadecimal string aa.
ff: Specifies hexadecimal string ff.
Usage guidelines
The hexadecimal string will be truncated at the end or cyclically repeated to fit the payload size of the probe packet.
For example, if you configure the hexadecimal payload fill string as aa:
· Probe packet with a payload size of 1 byte will be filled with aa.
· Probe packet with a payload size of 6 bytes will be filled with aaaaaaaaaaaa.
Examples
# In TWAMP Light client-session view, specify aa as the hexadecimal payload fill string.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client] test-session 1
[Sysname-nqa-twamp-light-client-session1] hex-data-fill aa
nqa
Use nqa to create an NQA operation and enter its view, or enter the view of an existing NQA operation.
Use undo nqa to remove the operation.
Syntax
nqa entry admin-name operation-tag
undo nqa { all | entry admin-name operation-tag }
Default
No NQA operations exist.
Views
System view
Predefined user roles
network-admin
Parameters
admin-name operation-tag: Specifies an NQA operation by its administrator name and operation tag. The admin-name argument represents the name of the administrator who creates the NQA operation. The operation-tag argument represents the operation tag. Each of the arguments is a case-insensitive string of 1 to 32 characters that cannot contain hyphens (-).
all: Removes all NQA operations.
Usage guidelines
After you create an NQA operation, use the type command to specify the operation type for it. Only one operation type can be specified for one operation. After that, you can use the nqa entry command to directly enter the NQA operation type view.
Examples
# Create an NQA operation with administrator name admin and operation tag test, and enter NQA operation view.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test]
nqa agent enable
Use nqa agent enable to enable the NQA client.
Use undo nqa agent enable to disable the NQA client and stop all operations being performed.
Syntax
nqa agent enable
undo nqa agent enable
Default
The NQA client is enabled.
Views
System view
Predefined user roles
network-admin
Examples
# Enable the NQA client.
<Sysname> system-view
[Sysname] nqa agent enable
Related commands
nqa server enable
nqa report-ftp
Use nqa report-ftp to configure the FTP server to which the NQA client uploads the operation results.
Use undo nqa report-ftp to restore the default.
Syntax
nqa report-ftp url url [ username username ] [ password { cipher | simple } string ]
undo nqa report-ftp
Default
No FTP server is configured for the NQA client to upload operation results.
Views
System view
Predefined user roles
network-admin
Parameters
url: Specifies the URL of the FTP server, a case-sensitive string of 1 to 255 characters. The following table describes the valid URL formats.
|
URL format |
Parameter description |
|
ftp://host |
The host parameter represents the host name of the FTP server. The host name is a dot-separated case-sensitive string including letters, digits, hyphens (-), and underscores (_). Host names are composed of series of labels, aabbcc.com for example. Each label consists of 1 to 63 characters. Consecutive dots (.) are not allowed. The port parameter specifies the port number in the range of 0 to 65535. |
|
ftp://host:port |
username username: Specifies the FTP login username, a case-sensitive string of 1 to 32 characters. Do not specify this option if no username is required for FTP login.
password: Specifies the FTP login password. Do not specify this keyword if no password is required for FTP login.
cipher: Specifies a password in encrypted form.
simple: Specifies a password in plaintext form. For security purposes, the password specified in plaintext form will be stored in encrypted form.
string: Specifies the FTP login password. Its plaintext form is a case-sensitive string of 1 to 32 characters. Its encrypted form is a case-sensitive string of 1 to 73 characters.
Usage guidelines
The path quality analysis and Y.1564 operations support uploading the operation results to the FTP server.
Examples
# Configure the NQA client to upload the operation results to the FTP server at ftp://19.23.1.25, and set the login username and password to test and 123456, respectively.
<Sysname> system-view
[Sysname] nqa report-ftp url ftp://19.23.1.25 username test password simple 123456
nqa rfc2544 group
Use nqa rfc2544 group to create a path quality analysis operation group and enter its view, or enter the view of an existing path quality analysis operation group.
Use undo nqa rfc2544 group to delete a path quality analysis operation group.
Syntax
nqa rfc2544 group group-name
undo nqa rfc2544 group group-name
Default
No path quality analysis operation groups exist.
Views
System view
Predefined user roles
network-admin
Parameters
group-name: Specifies a path quality analysis operation group by its name, a case-insensitive string of 1 to 32 characters.
Usage guidelines
A path quality analysis operation group is a set of path quality analysis operations. In path quality analysis operation group view, you can start or stop all the path quality analysis operations in the path quality analysis operation group.
To remove a path quality analysis operation group that contains path quality analysis operations, remove all the path quality analysis operations from the group first.
Examples
# Create a path quality analysis operation group named test, and enter its view.
<Sysname> system-view
[Sysname] nqa rfc2544 group test
[Sysname-nqa-rfc2544group-test]
nqa twamp-light client
Use nqa twamp-light client to enable the TWAMP Light client and enter its view, or enter the view of the enabled TWAMP Light client.
Use undo nqa twamp-light client to disable the TWAMP Light client.
Syntax
nqa twamp-light client
undo nqa twamp-light client
Default
The TWAMP Light client is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
The Two-Way Active Measurement Protocol (TWAMP) measures network performance in the complex networks. To create test sessions, you must first use the nqa twamp-light client command to enter TWAMP Light client view.
The undo nqa twamp-light client command disables the TWAMP Light client and deletes the test sessions on the TWAMP Light client.
Examples
# Enable the TWAMP Light client and enter its view.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client]
nqa twamp-light sender
Use nqa twamp-light sender to enable the TWAMP Light sender and enter its view, or enter the view of the enabled TWAMP Light sender.
Use undo nqa twamp-light sender to disable the TWAMP Light sender.
Syntax
nqa twamp-light sender
undo nqa twamp-light sender
Default
The TWAMP Light sender is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
In the TWAMP Light sender view, you can start or stop a TWAMP Light test.
Examples
# Enable the TWAMP Light sender and enter its view.
<Sysname> system-view
[Sysname] nqa twamp-light sender
[Sysname-nqa-twamp-light-sender]
nqa y1564 group
Use nqa y1564 group to create a Y.1564 operation group and enter its view, or enter the view of an existing Y.1564 operation group.
Use undo nqa y1564 group to delete a Y.1564 operation group and all configuration in its view.
Syntax
nqa y1564 group group-name
undo nqa y1564 group group-name
Default
No Y.1564 operation groups exist.
Views
System view
Predefined user roles
network-admin
Parameters
group-name: Specifies the group name, a case-insensitive string of 1 to 32 characters.
Usage guidelines
A Y.1564 operation group is a set of Y.1564 operations. By executing the start or stop command in Y.1564 operation group view, you can start or stop all the Y.1564 operations in the Y.1564 operation group.
To remove a Y.1564 operation group that contains Y.1564 operations, remove all the Y.1564 operations from the group first.
Examples
# Create a Y.1564 operation group named test and enter its view.
<Sysname> system-view
[Sysname] nqa y1564 group test
[Sysname-nqa-y1564group-test]
Related commands
bind nqa-entry
start
stop
performance-test enable
Use performance-test enable to enable the service performance test in a Y.1564 operation.
Use undo performance-test enable to disable the service performance test in a Y.1564 operation.
Syntax
performance-test enable [ duration duration ]
undo performance-test enable
Default
The service performance test is enabled in a Y.1564 operation.
Views
Y.1564 operation view
Predefined user roles
network-admin
Parameters
duration duration: Specifies the duration of the service performance test in minutes. The value range is 1 to 1440, and the default is 15.
Usage guidelines
By default, the service performance test is enabled and will run at the configured CIR for 15 minutes in a Y.1564 operation. You can use this command to change the test duration or disable the test in a Y.1564 operation.
Examples
# Enable the service performance test in a Y.1564 operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type y1564
[Sysname-nqa-admin-test-y1564] performance-test enable
Related commands
bandwidth
pir-test enable
Use pir-test enable to enable the PIR test in a Y.1564 operation.
Use undo pir-test enable to disable the PIR test in a Y.1564 operation.
Syntax
pir-test enable [ duration duration ]
undo pir-test enable
Default
The PIR test is enabled in a Y.1564 operation.
Views
Y.1564 operation view
Predefined user roles
network-admin
Parameters
duration duration: Specifies the duration of the PIR test in seconds. The value range is 1 to 60, and the default is 3.
Usage guidelines
The PIR test can operate in color-aware mode or non-color-aware mode.
· In color-aware mode, the PIR test transmits green frames at a rate equal to the CIR and yellow frames at a rate equal to the PIR.
· In non-color-aware mode, the PIR test transmits frames at a rate equal to CIR + PIR.
You can enable or disable the color-aware mode in a Y.1564 operation.
Examples
# Enable the PIR test in a Y.1564 operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type y1564
[Sysname-nqa-admin-test-y1564] pir-test enable
Related commands
bandwidth
color-aware-mode enable
priority 8021p
Use priority 8021p to set the 802.1p priority for the probe packets.
Use undo priority 8021p to restore the default.
Syntax
priority 8021p value
undo priority 8021p
Default
The 802.1p priority of the probe packets is 0.
Views
Frame loss/latency/throughput/Y.1564 operation view
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
value: Specifies the 802.1p priority value in the range of 0 to 7.
Usage guidelines
To test the service quality for specific packet priorities in a congested Layer 2 network, you can use this command to specify the priorities.
For more information about 802.1p priority, see QoS in ACL and QoS Configuration Guide.
Examples
# Set the 802.1p priority to 1 for probe packets in the latency operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type latency
[Sysname-nqa-admin-test-latency] priority 8021p 1
probe duration
Use probe duration to specify the probe duration.
Use undo probe duration to restore the default.
Syntax
probe duration time
undo probe duration
Default
The probe duration is 60 seconds.
Views
Frame loss/latency/throughput operation view
Predefined user roles
network-admin
Parameters
time: Specifies the probe duration in seconds. The value range is 10 to 172800.
Examples
# Set the probe duration to 90 seconds for the throughput operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type throughput
[Sysname-nqa-admin-test-throughput] probe duration 90
probe interval
Use probe interval to specify the interval between consecutive probes.
Use undo probe interval to restore the default.
Syntax
probe interval interval
undo probe interval
Default
The probe interval is 4 seconds.
Views
Frame loss/latency/throughput operation view
Predefined user roles
network-admin
Parameters
time: Specifies the probe interval in seconds. The value range is 1 to 60.
Usage guidelines
After a frame loss, latency, or throughput operation probe is complete, the NQA client waits the specified probe interval before starting another probe.
Examples
# Set the probe interval to 30 seconds for the throughput operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type throughput
[Sysname-nqa-admin-test-throughput] probe interval 30
probe timeout
Use probe timeout to set the probe timeout time.
Use undo probe timeout to restore the default.
Syntax
probe timeout timeout
undo probe timeout
Default
The timeout time of a probe is 3000 milliseconds.
Views
Frame loss/latency/throughput/Y.1564 operation view
Predefined user roles
network-admin
Parameters
timeout: Specifies the probe timeout time in milliseconds. For frame loss, latency, throughput, and Y.1564 operations, the value range is 1 to 60000.
Usage guidelines
If a probe does not complete within the period, the probe is timed out.
Examples
# Set the probe timeout time to 10000 milliseconds for the throughput operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type throughput
[Sysname-nqa-admin-test-throughput] probe timeout 10000
reaction checked-element two-way-delay
Use reaction checked-element two-way-delay to configure a reaction entry for monitoring the two-way delay in the TWAMP Light tests.
Use undo reaction trap to delete a reaction entry.
Syntax
reaction item-number checked-element two-way-delay threshold-value upper-threshold lower-threshold [ action-type { none | trap-only } ]
undo reaction item-number
Default
No reaction entries for monitoring two-way delay exist.
Views
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
item-number: Assigns an ID to the reaction entry, in the range of 1 to 10.
threshold-value: Specifies threshold range in microseconds.
upper-threshold: Specifies the upper limit in the range of 2 to 1000000.
lower-threshold: Specifies the lower limit in the range of 1 to 999999. It must not be greater than the upper limit.
action-type: Specifies the action to be triggered. The default action is none.
none: Specifies the action of displaying results on the terminal display.
trap-only: Specifies the action of displaying results on the terminal display and sending SNMP trap messages to the NMS.
Usage guidelines
You cannot edit a reaction entry after it is created. To change the attributes in a reaction entry, use the undo reaction command to delete the entry, and then configure a new one.
Only successful probe packets are monitored. Statistics about failed probe packets are not collected.
In a TWAMP test, the device monitors the test result, and starts the monitoring time when either of the following conditions is met:
· The monitoring result goes beyond the threshold upper limit.
· The monitoring result drops below the threshold lower limit from a monitoring result higher than the lower limit.
If either condition is always true during the monitoring time, a threshold violation occurs. To set the monitoring time, use the monitor-time keyword in the start command.
Examples
# Create reaction entry 1 for monitoring the two-way delay of probe packets, and set the upper limit to 50 microseconds and the lower limit to 5 microseconds.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client] test-session 1
[Sysname-nqa-twamp-light-client-session1] reaction 1 checked-element two-way-delay threshold-value 50 5 action-type trap-only
Related commands
start (TWAMP Light sender view)
reaction checked-element two-way-jitter
Use reaction checked-element two-way-jitter to configure a reaction entry for monitoring the two-way jitter in the TWAMP Light tests.
Use undo reaction to delete a reaction entry.
Syntax
reaction item-number checked-element two-way-jitter threshold-value upper-threshold lower-threshold [ action-type { none | trap-only } ]
undo reaction item-number
Default
No reaction entries for monitoring two-way jitter exist.
Views
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
item-number: Assigns an ID to the reaction entry, in the range of 1 to 10.
threshold-value: Specifies threshold range in microseconds.
upper-threshold: Specifies the upper limit in the range of 2 to 1000000.
lower-threshold: Specifies the lower limit in the range of 1 to 999999. It must not be greater than the upper limit.
action-type: Specifies the action to be triggered. The default action is none.
none: Specifies the action of displaying results on the terminal display.
trap-only: Specifies the action of displaying results on the terminal display and sending SNMP trap messages to the NMS.
Usage guidelines
You cannot edit a reaction entry after it is created. To change the attributes in a reaction entry, use the undo reaction command to delete the entry, and then configure a new one.
Only successful probe packets are monitored. Statistics about failed probe packets are not collected.
In a TWAMP test, the device monitors the test result, and starts the monitoring time when either of the following conditions is met:
· The monitoring result goes beyond the threshold upper limit.
· The monitoring result drops below the threshold lower limit from a monitoring result higher than the lower limit.
If either condition is always true during the monitoring time, a threshold violation occurs. To set the monitoring time, use the monitor-time keyword in the start command.
Examples
# Create reaction entry 1 for monitoring the two-way jitter of probe packets, and set the upper limit to 20 microseconds and the lower limit to 3 microseconds.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client] test-session 1
[Sysname-nqa-twamp-light-client-session1] reaction 1 checked-element two-way-jitter threshold-value 20 3 action-type trap-only
Related commands
start (TWAMP Light sender view)
reaction checked-element two-way-loss
Use reaction checked-element two-way-loss to configure a reaction entry for monitoring the two-way packet loss in the TWAMP Light tests.
Use undo reaction to delete a reaction entry.
Syntax
reaction item-number checked-element two-way-loss threshold-value upper-threshold lower-threshold [ action-type { none | trap-only } ]
undo reaction item-number
Default
No reaction entries for monitoring two-way packet loss exist.
Views
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
item-number: Assigns an ID to the reaction entry, in the range of 1 to 10.
threshold-value: Specifies threshold range.
upper-threshold: Specifies the upper limit in the range of 2 to 1000000.
lower-threshold: Specifies the lower limit in the range of 1 to 999999. It must not be greater than the upper limit.
action-type: Specifies the action to be triggered. The default action is none.
none: Specifies the action of displaying results on the terminal display.
trap-only: Specifies the action of displaying results on the terminal display and sending SNMP trap messages to the NMS.
Usage guidelines
You cannot edit a reaction entry after it is created. To change the attributes in a reaction entry, use the undo reaction command to delete the entry, and then configure a new one.
In a TWAMP test, the device monitors the test result, and starts the monitoring time when either of the following conditions is met:
· The monitoring result goes beyond the threshold upper limit.
· The monitoring result drops below the threshold lower limit from a monitoring result higher than the lower limit.
If either condition is always true during the monitoring time, a threshold violation occurs. To set the monitoring time, use the monitor-time keyword in the start command.
Examples
# Create reaction entry 1 for monitoring the two-way packet loss of probe packets, and set the upper limit to 1000 and the lower limit to 500.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client] test-session 1
[Sysname-nqa-twamp-light-client-session1] reaction 1 checked-element two-way-loss threshold-value 1000 500 action-type trap-only
Related commands
start (TWAMP Light sender view)
reset nqa twamp-light statistics
Use reset nqa twamp-light statistics to clear the TWAMP Light test sessions.
Syntax
reset nqa twamp-light statistics { all | test-session session-id }
Views
User view
Predefined user roles
network-admin
Parameters
all: Clears statistics about all TWAMP Light test sessions.
test-session session-id: Specifies a session by its ID. The value range for the session-id argument is 1 to 512.
Usage guidelines
Use the command with caution. Once being cleared, the test session cannot be recovered.
Examples
# Clear statistics about all TWAMP Light test sessions.
<Sysname> reset nqa twamp-light statistics all
Related commands
display nqa twamp-light client statistic
source interface
Use source interface to specify a source AC or source interface for probe packets.
Use undo source interface to restore the default.
Syntax
source interface interface-type interface-number [ service-instance instance-id ]
undo source interface
Default
No source AC or source interface is specified for probe packets.
Views
Frame loss/latency/throughput/Y.1564 operation view
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
interface-type interface-number: Specifies an interface by its type and number.
service-instance instance-id: Specifies an Ethernet service instance by its ID in the range of 1 to 4096. In Layer 2 networks, an Ethernet service instance and a source interface determine a source AC interface. For more information about the Ethernet service instance and AC interface, see VPLS in MPLS Configuration Guide.
Usage guidelines
On an L2VPN network, you can execute this command to bind an Ethernet service instance to the Layer 2 Ethernet interface to create a source AC interface for sending probe packets.
On a Layer 3 network, you can execute this command to use the Layer 3 Ethernet interface as the source interface for sending probe packets.
Follow these guidelines when you configure this command:
· The specified interface must be up.
· If the interface-type interface-number argument represents a Layer 2 interface, the service-instance instance-id option is required.
· If the interface-type interface-number argument represents a Layer 3 interface, the following rules apply:
¡ In an MPLS L3VPN network, do not specify the service-instance instance-id option.
¡ In an MPLS L2VPN network, the service-instance instance-id option is optional. This option takes effect if the Layer 3 interface switches to a Layer 2 interface. In this case, you do not have to stop the operation and reconfigure this command. The operation restarts automatically by using the new source AC after the MPLS L2VPN configuration is modified.
Examples
# Specify Ten-GigabitEthernet 2/0/0 as the source AC interface for the throughput operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type throughput
[Sysname-nqa-admin-test-throughput] source interface ten-gigabitethernet 2/0/0
Related commands
source ip
source ip
Use source ip to configure the source IPv4 address for probe packets.
Use undo source ip to restore the default.
Syntax
Y.1564 operations:
source ip ipv4-address1 [ to ipv4-address2 ]
undo source ip
Other operations:
source ip ipv4-address
undo source ip
Default
The source IPv4 address for probe packets is 198.19.65.1 for the frame loss, latency, throughput, or Y.1564 operation. For other types of NQA operations, the source IPv4 address is not configured for probe packets.
Views
Frame loss/latency/throughput/Y.1564 operation view
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
ipv4-address: Specifies the source IPv4 address for probe packets.
ipv4-address1 to ipv4-address2: Specifies a source IPv4 address range. The ipv4-address2 must be higher than the ipv4-address1. Between the two source IPv4 addresses, only one octet difference is allowed and the value difference cannot exceed 127.
Usage guidelines
The specified source IP address must be the IPv4 address of a local interface, and the local interface must be up. Otherwise, no probe packets can be sent out. This restriction does not apply to the frame loss, latency, or throughput operation.
For path quality analysis operations to start successfully, configure the source and destination IP addresses as follows:
· In a Layer 3 Ethernet and L3VPN network, configure both source and destination IP addresses.
· In other networks, configure both of them or none of them. If they are configured, make sure the source and destination IP addresses are of the same IP version.
Examples
# In TWAMP Light client-session view, specify 10.1.1.1 as the source IPv4 address for the TWAMP Light tests.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client] test-session 1
[Sysname-nqa-twamp-light-client-session1] source ip 10.1.1.1
Related commands
source interface
source ipv6
Use source ipv6 to configure the source IPv6 address for probe packets.
Use undo source ipv6 to restore the default.
Syntax
Y.1564 operations:
source ipv6 ipv6-address1 [ to ipv6-address2 ]
undo source ipv6
Other operations:
source ipv6 ipv6-address
undo source ipv6
Default
The source IPv6 address for probe packets is not specified for the frame loss, latency, throughput, Y.1564, or TWAMP Light test. For other types of NQA operations, the probe packets take the IPv6 address of their output interface as the source IPv6 address.
Views
Frame loss/latency/throughput/Y.1564 operation view
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
ipv6-address: Specifies the source IPv6 address for probe packets. IPv6 link-local addresses are not supported.
ipv6-address1 to ipv6-address2: Specifies a source IPv6 address range. The ipv6-address2 must be higher than ipv6-address1. Between the two source IPv6 addresses, only one octet difference is allowed and the value difference cannot exceed 127.
Usage guidelines
The specified source IPv6 address must be the IPv6 address of a local interface. The local interface must be up. Otherwise, no probe packets can be sent out.
For path quality analysis operations to start successfully, configure the source and destination IP addresses as follows:
· In a Layer 3 Ethernet and L3VPN network, configure both source and destination IP addresses.
· In other networks, configure both of them or none of them. If they are configured, make sure the source and destination IP addresses are of the same IP version.
Examples
# In TWAMP Light client-session view, specify 1::1 as the source IPv6 address for the TWAMP Light tests.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client] test-session 1
[Sysname-nqa-twamp-light-client-session1] source ipv6 1::1
Related commands
source interface
source mac
Use source mac to specify the source MAC address for probe packets.
Use undo source mac to restore the default.
Syntax
source mac mac-address [ to mac-address1 ]
undo source mac
Default
For the frame loss, latency, throughput, or Y.1564 operation, the probe packets take the MAC address of the egress interface as the source MAC address.
For the TWAMP Light test, no source MAC address is specified.
Views
Frame loss/latency/throughput/Y.1564 operation view
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
mac-address: Specifies the source MAC address in the format of H-H-H. For example, to use 000f-00e2-0001 as the source MAC address, set this argument to f-e2-1.
to mac-address1: Specifies a source MAC address range. The mac-address1 must be higher than the mac-address. Between the two source MAC addresses, only one octet difference is allowed and the value difference cannot exceed 127. Only the Y.1564 operations support this option.
Examples
# Set the source MAC address of probe packets to 0001-0001-0001 in a Y.1564 operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type y1564
[Sysname-nqa-admin-test-y1564] source mac 1-1-1
# In TWAMP Light client-session view, specify 0001-0001-0001 as the source MAC address for the TWAMP Light test.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client] test-session 1
[Sysname-nqa-twamp-light-client-session1] source mac 1-1-1
source port
Use source port to configure the source port number for probe packets.
Use undo source port to restore the default.
Syntax
Y.1564 operations:
source port port-number1 [ to port-number2 ]
Other operations:
source port port-number
undo source port
Default
The The source port number is 49184 for the frame loss, latency, throughput, or Y.1564 operation. For TWAMP Light tests, the source port number is not specified.
Views
Frame loss/latency/throughput/Y.1564 operation view
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
port-number: Specifies the source port number in the range of 1 to 65535.
port-number1 to port-number2: Specifies a source port number range. The port-number2 must be greater than port-number1. Between the two source port numbers, only one octet difference is allowed and the value difference cannot exceed 127.
Usage guidelines
For a TWAMP Light test, you must configure this command. For other operation types, as a best practice, use the default setting.
For the operation to succeed, make sure the specified port number is not used by any services on the device.
· To obtain the IPv4 addresses and the port numbers in use on this device, see the Local Addr:port field in the output from the display tcp and display udp commands.
· To obtain the IPv6 addresses and the port numbers in use on this device, see the LAddr->port field in the output from the display ipv6 tcp and display ipv6 udp commands.
Examples
# In TWAMP Light client-session view, set the source port number to 8000 for the TWAMP Light test.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client] test-session 1
[Sysname-nqa-twamp-light-client-session1] source port 8000
Related commands
display ipv6 tcp (Layer 3—IP Services Command Reference)
display ipv6 udp (Layer 3—IP Services Command Reference)
display tcp (Layer 3—IP Services Command Reference)
display udp (Layer 3—IP Services Command Reference)
speed granularity
Use speed granularity to set the granularity for adjusting the packet sending speed.
Use undo speed granularity to restore the default.
Syntax
speed granularity value
undo speed granularity
Default
The granularity for adjusting the packet sending speed is 1000 kbps.
Views
Throughput operation view
Predefined user roles
network-admin
Parameters
value: Specifies the granularity in kbps. The value range is 1 to 10000.
Usage guidelines
After a probe completes, the NQA client adjusts the packet sending speed by using the speed adjusting granularity for the next probe.
Examples
# Set the speed granularity to 2000 kbps for the throughput operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type throughput
[Sysname-nqa-admin-test-throughput] speed granularity 2000
speed init
Use speed init to set the initial packet sending speed.
Use undo speed init to restore the default.
Syntax
speed init init-speed
undo speed init
Default
The initial frame sending speed is 100000 kbps.
Views
Frame loss/latency/throughput operation view
Predefined user roles
network-admin
Parameters
init-speed: Specifies the initial packet sending speed in kbps. The value range is 1000 to 100000000.
Examples
# Set the initial packet sending speed to 10000 kbps for the throughput operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type throughput
[Sysname-nqa-admin-test-throughput] speed init 10000
start (frame loss/latency/throughput/Y.1564 operation view/Y.1564 operation group view/RFC2544 operation group view)
Use start to start the frame loss, throughput, latency, or Y.1564 operation.
Syntax
start
Default
The frame loss, throughput, latency, or Y.1564 operation is not started.
Views
Frame loss/latency/throughput/Y.1564 operation view
Y.1564 operation group view
RFC2544 operation group view
Predefined user roles
network-admin
Usage guidelines
The frame loss, latency, throughput, or Y.1564 operation requires all bandwidth of the link over which the operation is performed. Before such an operation starts, suspend all the services that are transmitting data over the link.
The frame loss, latency, throughput, or Y.1564 operation is mutually exclusive with other NQA operations. While a frame loss, latency, throughput, or Y.1564 operation is running on the NQA client, you cannot start another operation of the same type. To start multiple Y.1564 operations simultaneously, add the Y.1564 operations to a Y.1564 operation group, stop all other operations, and then start the Y.1564 operation group.
For frame loss, latency, throughput, or Y.1564 operations to start successfully, configure the source and destination IP addresses as follows:
· In a Layer 3 Ethernet and L3VPN network, configure both source and destination IP addresses.
· In other networks, you must configure both of them or none of them. If they are configured, make sure the source and destination IP addresses are of the same IP version.
Examples
# Start the throughput operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type throughput
[Sysname-nqa-admin-test-throughput] start
Related commands
nqa y1564 group
nqa rfc2544 group
stop (frame loss/latency/throughput/Y.1564 operation view/Y.1564 operation group view/RFC2544 operation group view)
start (TWAMP Light sender view)
Use start to start the TWAMP Light test.
Syntax
start test-session session-id { permanent | duration duration | packet-count count } [ tx-interval { 10 | 100 | 1000 | 10000 | 30000 } ] [ time-out timeout ] [ [ statistics-interval statistics-interval ] monitor-time time ]
Default
The TWAMP Light test is not started.
Views
TWAMP Light sender view
Predefined user roles
network-admin
Parameters
test-session session-id: Specifies a TWAMP Light test session by its ID. The value range for this argument is 1 to 512.
permanent: Runs a TWAMP Light test permanently.
duration duration: Specifies the duration for a TWAMP Light test in seconds. The value range for this argument is 60 to 300.
packet-count count: Specifies the number of packets to be sent, in the range of 100 to 30000.
tx-interval { 10 | 100 | 1000 | 10000 | 30000 }: Specifies a list of up to four packet sending intervals. Valid intervals are 10, 100, 1000, 10000, and 30000 milliseconds. The default packet sending interval is 100 milliseconds.
time-out timeout: Specifies the timeout time of the reflected packet within a TWAMP Light test, in seconds. The value range for this argument is 1 to 10.The default timeout time is 5 seconds.
statistics-interval interval: Specifies a statistics collection interval for the TWAMP Light test in milliseconds. The value must be an integer multiple of 10 milliseconds. The value range for this argument is 1000 to 6000000.The default statistics collection interval varies by packet sending interval. For more information, see Table 9.
monitor-time time: Specifies the packet monitoring time for the TWAMP Light test in milliseconds. The packet monitoring time must be an integer multiple of the statistics collection interval. The value range for this argument is 1000 to 86400000.
Usage guidelines
The TWAMP Light test includes on-demand test and permanent test.
· The on-demand test is manually scheduled. It allows a single performance measurement.
· A permanent test, once being started, does not stop unless you execute the stop command in the TWAMP Light sender view to stop it manually.
In a TWAMP test, the device monitors the test result, and starts the monitoring time when either of the following conditions is met:
· The monitoring result goes beyond the threshold upper limit.
· The monitoring result drops below the threshold lower limit from a monitoring result higher than the lower limit.
If either condition is always true during the monitoring time, a threshold violation occurs.
The monitoring time varies by the monitor-time time option in this command:
· If you specify this option, the monitoring time for packet loss, delay, and jitter uses the specified value.
· If you do not specify this option, the default monitoring time for packet loss, delay, and jitter is used. The default monitoring time varies by the packet sending interval. For more information, see Table 9.
To set the upper and lower limits, use the reaction entry threshold monitoring commands for the TWAMP Light test.
In the TWAMP Light test, a test session is identified by the combination of source IP address, source port number, destination IP address, and destination port number. To ensure the test result, do not specify the same combination for multiple test sessions.
With the timestamp-format ntp command configured, the packet sending interval cannot be 10 or 100 milliseconds.
To prevent empty reported test statistics, set the statistics collection interval no less than the packet sending interval.
Table 9 Default values for the statistics collection interval and monitoring time
|
Packet sending interval |
Default statistics collection interval (seconds) |
Default monitoring time for two-way packet loss (seconds) |
Default monitoring time for two-way delay and jitter (seconds) |
|
10 milliseconds |
2 |
60 |
2 |
|
100 milliseconds |
20 |
60 |
20 |
|
1 seconds |
200 |
200 |
200 |
|
10 seconds |
400 |
400 |
400 |
|
30 seconds |
600 |
600 |
600 |
Examples
# Start the TWAMP Light test and allow the device to send 3000 packets.
<Sysname> system-view
[Sysname] nqa twamp-light sender
[Sysname-nqa-twamp-light-sender] start test-session 1 packet-count 3000
Related commands
stop (TWAMP Light sender view)
reaction checked-element two-way-delay
reaction checked-element two-way-loss
reaction checked-element two-way-jitter
stop (frame loss/latency/throughput/Y.1564 operation view/Y.1564 operation group view/RFC2544 operation group view)
Use stop to stop the frame loss, throughput, latency, or Y.1564 operation.
Syntax
stop
Views
Frame loss/latency/throughput/Y.1564 operation view
Y.1564 operation group view
RFC2544 operation group view
Predefined user roles
network-admin
Usage guidelines
Use this command in operation view to stop unexecuted probes (not available for executed probes) in the operation. You can use this command in operation group view to stop all probes in the operation group.
Examples
# Stop the throughput operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type throughput
[Sysname-nqa-admin-test-throughput] stop
Related commands
nqa y1564 group
nqa rfc2544 group
start (frame-loss/latency/throughput/Y.1564 operation view/Y.1564 operation group view/RFC2544 operation group view)
stop (TWAMP Light sender view)
Use stop to stop the TWAMP Light test.
Syntax
stop { all | test-session session-id }
Views
TWAMP Light sender view
Predefined user roles
network-admin
Parameters
all: Stops the all TWAMP Light test sessions.
test-session session-id: Specifies the ID of a TWAMP Light test session. The value range for this argument is 1 to 512.
Examples
# Stop the TWAMP Light test of the session 1.
<Sysname> system-view
[Sysname] nqa twamp-light sender
[Sysname-nqa-twamp-light-sender] stop test-session 1
Related commands
start (TWAMP Light sender view)
test-session (TWAMP Light client view)
Use test-session to create a est session on TWAMP Light client and enter the client-session view, or enter the client-session view of an existing test session on the TWAMP Light client.
Use undo test-session to delete a test session on the TWAMP Light client.
Syntax
test-session session-id
undo test-session session-id
Default
No test sessions exist on the TWAMP Light client.
Views
TWAMP Light client view
Predefined user roles
network-admin
Parameters
session-id: Specifies a test session by its ID. The value range for this argument is 1 to 512.
Usage guidelines
To start a TWAMP Light test, perform the following tasks in sequence:
1. Create a test session on the TWAMP Light client and complete the settings.
2. Use the nqa twamp-light sender command to enter the TWAMP Light sender view, and start the test session.
Examples
# Specify a test session test-session 1 on the TWAMP Light client and enter the client-session view.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client] test-session 1
[Sysname-nqa-twamp-light-client-session1]
test-session bind interface
Use test-session bind interface to bind an interface as the output interface for a TWAMP Light test session.
Use undo test-session bind interface to unbind an interface from a TWAMP Light test session.
Syntax
test-session session-id bind interface interface-type interface-number
undo test-session session-id bind interface [ interface-type interface-number ]
Default
No interface is specified as the output interface for a TWAMP Light test session.
Views
TWAMP Light client view
Predefined user roles
network-admin
Parameters
session-id: Specifies a test session by its ID. The value range for this argument is 1 to 512.
interface-type interface-number: Specifies an interface by its type and number. If you do not specify this argument, the TWAMP Light test uses all interfaces as the output interfaces for test sessions.
Usage guidelines
With this command configured, the device sends TWAMP Light test packets out of the specified interface. Therefore, configure the interface as the output interface of the route to the TWAMP Light server.
This command also enables the collaboration between the TWAMP Light module and other service modules. After obtaining the valid statistics, the TWAMP Light module will send the delay information (including remote IP address, maximum delay, minimum delay, and average delay) to other service modules, such as the ISIS module, to complete related functions.
The TWAMP Light module sends the data to other service module when the following conditions are met:
· A continuous TWAMP Light test is configured.
· Valid delay data has been collected.
A TWAMP Light test session can be bound with only one interface. If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Bind Ten-GigabitEthernet 2/0/0 as the output interface for TWAMP Light test session 1.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client] test-session 1 bind interface ten-gigabitethernet 2/0/0
timestamp-format
Use timestamp-format to specify the timestamp format for probe packets in the TWAMP Light test or TWAMP test.
Use undo timestamp-format to restore the default.
Syntax
timestamp-format { ntp | ptp }
undo timestamp-format
Default
The timestamp format for probe packets in a TWAMP Light test is PTP.
Views
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
ntp: Specifies the NTP format.
ptp: Specifies the PTP format.
Usage guidelines
This command allows you to specify a timestamp format for probe packets in a TWAMP Light test. The time accuracy in the PTP format is higher than that in the NTP format.
If the time is not synchronized through NTP or PTP, or the TWAMP Light test sender and responder use different timestamp formats, the TWAMP Light test can still be performed, but the test result accuracy might be affected.
Examples
# Specify the timestamp format as NTP for the TWAMP Light test.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client] test-session 1
[Sysname-nqa-twamp-light-client-session1] timestamp-format ntp
tos
Use tos to set the ToS value in the IP header for probe packets.
Use undo tos to restore the default.
Syntax
tos value
undo tos
Default
The ToS value in the IP header of probe packets is 0.
Views
Frame loss/latency/throughput operation view
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
value: Specifies the ToS value in the range of 0 to 255.
Examples
# Set the ToS value to 1 in the IP header for TWAMP Light test packets.
<Sysname> system-view
[Sysname] nqa twamp client
[Sysname-nqa-twamp-client] test-session 1
[Sysname-nqa-twamp-light-client-session1] tos 1
traffic-policing-test enable
Use traffic-policing-test enable to enable the traffic policing test in a Y.1564 operation.
Use undo traffic-policing-test enable to disable the traffic policing test in a Y.1564 operation.
Syntax
traffic-policing-test enable [ duration duration ]
undo traffic-policing-test enable
Default
The traffic policing test is disabled in a Y.1564 operation.
Views
Y.1564 operation view
Predefined user roles
network-admin
Parameters
duration duration: Specifies the test duration in seconds. The value range is 1 to 60, and the default is 3.
Usage guidelines
The traffic policing test can operate in color-aware mode or non-color aware mode.
· In color-aware mode, the test transmits green frames at the CIR and yellow frames at 125% * PIR or 25% * CIR + PIR, if PIR < 20% * CIR.
· In non-color-aware mode, the test transmits frames at a rate equal to CIR + 125% * PIR or 125%*CIR + PIR, if PIR < 20% * CIR.
You can enable or disable the color-aware mode in a Y.1564 operation.
Examples
# Enable the traffic policing test in a Y.1564 operation.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type y1564
[Sysname-nqa-admin-test-y1564] traffic-policing-test enable
Related commands
bandwidth
color-aware-mode enable
type
Use type to specify an NQA operation type and enter its view.
Syntax
type { frame-loss | latency | throughput | y1564 }
Default
No operation type is specified.
Views
NQA operation view
Predefined user roles
network-admin
Parameters
frame-loss: Specifies the frame loss operation type.
latency: Specifies the latency operation type.
throughput: Specifies the throughput operation type.
y1564: Specifies the Y.1564 operation type.
Usage guidelines
You can specify only one type for an NQA operation. After that, you can configure the operation type-related settings for the NQA operation. To change the type of the NQA operation, remove the NQA operation in system view, and then re-create the NQA operation.
Examples
# Specify throughput as the NQA operation type and enter throughput operation view.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type throughput
[Sysname-nqa-admin-test-throughput]
vlan
Use vlan to specify a VLAN for probe packets.
Use undo vlan to restore the default.
Syntax
Frame loss/latency/throughput/TWAMP Light operations:
vlan vlan-id
undo vlan
Y.1564 operations:
vlan vlan-id1 [ to vlan-id2 ]
undo vlan
Default
No VLAN is specified for probe packets.
Views
Frame loss/latency/throughput/Y.1564 operation view
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
vlan-id: Specifies a VLAN for the probe packet by its ID in the range of 1 to 4094.
vlan-id1 to vlan-id2: Specifies a VLAN for the probe packet by its ID in the range of 1 to 4094. The vlan-id2 must be greater than the vlan-id1. The value difference between two VLAN IDs cannot exceed 127.
Usage guidelines
After you specify a VLAN, the operation sends probe packets in the specified VLAN.
Examples
# Configure the throughput operation to send probe packets in VLAN 3.
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type throughput
[Sysname-nqa-admin-test-throughput] vlan 3
# Configure the TWAMP Light test to send probe packets in VLAN 3.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client] test-session 1
[Sysname-nqa-twamp-light-client-session1] vlan 3
vpn-instance
Use vpn-instance to apply the operation to a VPN instance.
Use undo vpn-instance to restore the default.
Syntax
vpn-instance vpn-instance-name
undo vpn-instance
Default
The operation is performed on the public network.
Views
Frame loss/latency/throughput/Y.1564 operation view
TWAMP Light client-session view
Predefined user roles
network-admin
Parameters
vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters.
Usage guidelines
After you specify a VPN instance, the NQA operation is performed in the specified VPN instance.
Examples
# Apply the TWAMP Light test to vpn1.
<Sysname> system-view
[Sysname] nqa twamp-light client
[Sysname-nqa-twamp-light-client] test-session 1
[Sysname-nqa-twamp-light-client-session1] vpn-instance vpn1
NQA server command
display nqa reflector
Use display nqa reflector to display a reflector of a path quality analysis operation or Y.1564 operation.
Syntax
display nqa reflector [ reflector-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
reflector-id: Specifies the ID of a reflector. The value range is 1 to 32. If you do not specify this option, the command displays information about all reflectors.
Examples
# Display information about the specified reflector.
<Sysname> display nqa reflector 1
NQA server status:Enabled
Reflector ID : 1
Status : Active
Interface : XGE2/0/0
Service instance : -
Destination IP : 1.1.1.2
Destination IPv6 : -
Source IP : 1.1.1.1
Source IPv6 : -
Destination port : 2010
Source port : 2001
Destination MAC : -
Source MAC : -
VLAN ID : -
Service VLAN ID : -
Customer VLAN ID : -
VPN instance : -
Switch src/dst ports : Enabled
Table 10 Command output
|
Field |
Description |
|
NQA server status |
NQA server status: Disabled or Enabled. |
|
Reflector ID |
Reflector ID. |
|
Status |
Reflector status: · Active—The reflector is running. · Inactive—The reflector is not running. |
|
Interface |
Interface that reflects the test packets. |
|
Service instance |
Ethernet service instance bound to the interface. The Ethernet service instance on the reflector must be consistent with that on the client. |
|
Destination IP |
Destination IPv4 address in the reflected packets. |
|
Destination IPv6 |
Destination IPv6 address or IPv6 address range in the reflected packets. |
|
Source IP |
Source IPv4 address or IPv4 address range in the reflected packets. |
|
Source IPv6 |
Source IPv6 address or IPv6 address range in the reflected packets |
|
Destination port |
Destination UDP port number or port number range in the reflected packets. |
|
Source port |
Source UDP port number or port number range in the reflected packets. |
|
Destination MAC |
Destination MAC address or MAC address range in the reflected packets. |
|
Source MAC |
Source MAC address or MAC address range in the reflected packets. |
|
VLAN ID |
VLAN ID or VLAN ID range in the reflected packets. |
|
Service VLAN ID |
Outer VLAN ID or VLAN ID range in the reflected packets. |
|
Customer VLAN ID |
Inner VLAN ID or VLAN ID range in the reflected packets. |
|
VPN instance |
VPN instance name. |
|
Switch src/dst ports |
Port exchange status: · Enabled. · Disabled. |
display nqa server
Use display nqa server status to display NQA server status.
Syntax
display nqa server
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display NQA server status.
<Sysname> display nqa server
NQA server status: Enabled
TCP connect:
IP address:2.2.2.2
Port:2000
ToS:200
VPN instance:-
UDP echo:
IP address:3.3.3.3
Port:3000
ToS:255
VPN instance:-
High performance mode: Enabled
Table 11 Command output
|
Field |
Description |
|
NQA server status |
NQA server status: · Disabled. · Enabled. |
|
TCP connect |
Information about the TCP listening service on the NQA server. |
|
UDP echo |
Information about the UDP listening service on the NQA server. |
|
IP address |
IP address specified for the TCP/UDP listening service on the NQA server. |
|
Port |
Port number specified for the TCP/UDP listening service on the NQA server. |
|
ToS |
ToS value in the reply packets sent by the NQA server. The ToS value can be specified when you configure a TCP or UDP listening service on the NQA server. If no ToS value is specified, the following rules apply: · This field displays a hyphen (-). · The ToS value in the reply packets of a TCP listening service is 0. · The ToS value in the reply packets of a UDP listening service is obtained from the request packets sent by the client. |
|
VPN instance |
Name of the VPN instance to which the IP address that the NQA server listens on belongs. This field displays a hyphen (-) if the NQA server listens on a public IP address. |
|
High performance mode |
Whether or not the high performance mode is enabled on the NQA server. |
display nqa twamp-light responder
Use display nqa twamp-light responder to display test sessions on the TWAMP Light responder.
Syntax
display nqa twamp-light responder [ test-session session-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
test-session session-id: Specifies a test session by its ID. The value range for this argument is 1 to 512. If you do not specify this option, the command displays all test sessions on the TWAMP Light responder.
Examples
# Display all test sessions on the TWAMP Light responder.
<Sysname> display nqa twamp-light responder
NQA server status:Enabled
TWAMP-light:
Session ID : 1
Status : Active
Interface : -
Service instance : -
Destination IP : 1.1.1.1
Destination IPv6 : -
Source IP : 2.2.2.2
Source IPv6 : -
Destination port : 2001
Source port : 2010
VPN instance : -
Destination MAC : 0001-0001-0002
Source MAC : 0001-0001-0001
VLAN ID : -
Service VLAN ID : -
Customer VLAN ID : -
Timestamp format : PTP
Description : -
Extended-packet : Enabled
Session ID : 2
Status : Active
Interface : -
Service instance : -
Destination IP : 1.1.1.1
Destination IPv6 : -
Source IP : 3.3.3.3
Source IPv6 : -
Destination port : 2001
Source port : 2020
VPN instance : -
Destination MAC : 0001-0001-0002
Source MAC : 0001-0001-0001
VLAN ID : -
Service VLAN ID : -
Customer VLAN ID : -
Timestamp format : NTP
Description : -
Extended-packet : Disabled
Table 12 Command output
|
Field |
Description |
|
NQA server status |
NQA server status: · Disabled · Enabled |
|
TWAMP-light |
Information about the TWAMP Light feature on the NQA server. |
|
Session ID |
Test session ID. |
|
Status |
TWAMP Light responder status: · Active—The TWAMP Light responder is active. · Inactive—The TWAMP Light responder is not active. |
|
Interface |
Interface that reflects the test packets. |
|
Service instance |
Ethernet service instance bound to the interface. The Ethernet service instance on the responder must be consistent with that on the client. |
|
Destination IP |
Destination IP address in the reflected packet. |
|
Destination IPv6 |
Destination IPv6 address in the reflected packet. |
|
Source IP |
Source IP address in the reflected packet. |
|
Source IPv6 |
Source IPv6 address in the reflected packet. |
|
Destination port |
Destination port number in the reflected packet. |
|
Source port |
Source port number in the reflected packet. |
|
VPN instance |
MPLS L3VPN instance name. |
|
Destination MAC |
Destination MAC address in the reflected packet. |
|
Source MAC |
Source MAC address in the reflected packet. |
|
VLAN ID |
VLAN ID in the reflected packet. |
|
Service VLAN ID |
Outer VLAN ID or VLAN ID range in the reflected packet. |
|
Customer VLAN ID |
Inner VLAN ID or VLAN ID range in the reflected packet. |
|
Timestamp format |
Timestamp format: · AUTO—The TWAMP Light responder selects a timestamp format automatically if you do not set a timestamp format by using the test-session command. · NTP. · PTP. |
|
Description |
Description about the test session. |
|
Extended-packet |
Whether or not to extend the header of reflected packets. · Enabled—The device extends the TWAMP packet header in the reflected packets to the standard header length if the data size of received test packets is less than 41 bytes. · Disabled—The device directly constructs reflected packets based on the received test packets with a data size of less than 41 bytes, without extending the TWAMP packet header. The test result might be inaccurate because the header of reflected packets lacks necessary parameters. |
|
Member interface : Status : |
· Name of the member interface. · Session status: ¡ Active—The TWAMP Light test is active. ¡ Inactive—The TWAMP Light test is not active. |
Related commands
nqa reflector
test-session (TWAMP Light responder view)
nqa reflector
Use nqa reflector to configure a reflector for the path quality analysis operation.
Use undo nqa reflector to delete the reflector for the path quality analysis operation.
Syntax
nqa reflector reflector-id interface interface-type interface-number [ service-instance instance-id ] [ { ip | ipv6 } { destination address | source address } * | destination-port port-number | source-port port-number | destination-mac mac-address | source-mac mac-address | vlan { vlan-id1 [ to vlan-id2 ] | exchange-port | vpn-instance vpn-instance-name ] *
undo nqa reflector { all | reflector-id [ { ip | ipv6 } { destination | source } | destination-port | source-port | destination-mac | source-mac | vlan | exchange-port | vpn-instance ] * }
Default
No reflector is configured for the path quality analysis operation.
Views
System view
Predefined user roles
network-admin
Parameters
reflector-id: Specifies the ID of a reflector .The reflector ID must be unique and is locally significance. The value range is 1 to 32.
interface: Specifies an interface that reflects the packets.
interface-type interface-number: Specifies an interface by its type and number.
service-instance instance-id: Specifies an Ethernet service instance by its ID, in the range of 1 to 4096. For more information about the Ethernet service instance, see MPLS L2VPN in MPLS Configuration Guide.
ip: Specifies an IPv4 address.
ipv6: Specifies an IPv6 address.
destination: Specifies a destination address of the packets to be reflected.
source: Specifies a source address of the packets to be reflected.
address: Specifies an IP address.
destination-port: Specifies a destination UDP port number of the packets to be reflected. The default destination port number is 7.
source-port: Specifies a source UDP port number of the packets to be reflected. The default source port number is 49184.
port-number: Specifies a port number in the range of 1 to 65535.
destination-mac: Specifies a destination MAC address for the packet to be reflected. If you do not specify this keyword, the command uses the MAC address of the interface specified by the interface-type interface-number option. Broadcast, multicast, and all-zero MAC addresses are not supported.
source-mac: Specifies a source MAC address for the packets to be reflected. Broadcast, multicast, and all-zero MAC addresses are not supported.
mac-address: Specifies a MAC address.
vlan: Specifies a VLAN, inner VLAN ID, or outer VLAN ID for the packets to be reflected.
vlan-id1: Specifies a VLAN ID in the range of 1 to 4094.
to vlan-id2: Specifies a VLAN ID range, in the range of 1 to 4094. The vlan-id2 must be higher than the vlan-id1. Between the two VLAN IDs, the value difference cannot exceed 127.
exchange-port: Exchanges the port number between source and destination ports. If you specify this keyword, execute the exchange-port enable command on the client.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the operation is performed on the public network.
all: Disables all reflectors for the path quality analysis operation.
Usage guidelines
This command is required on the NQA server for the path quality analysis or Y.1564 operation. It enables the server to reflect matching probe packets directly to the NQA client.
You can specify only one value range for one of the following options when configuring this command:
· Source IP address.
· Destination IP address.
· Source MAC address.
· Destination MAC address.
· Source port.
· Destination port.
In the path quality analysis operations, you cannot specify value ranges for the above options.
You can specify the same interface or Ethernet service instance for different reflectors.
If you want to edit or delete the interface or Ethernet service instance in an existing reflector, you must delete the reflector and reconfigure it.
Except for the interface and Ethernet service instance, you can directly edit or delete other parameters.
If you do not specify any optional parameters in the undo command, the reflector will be deleted.
To ensure correct operations, do not configure both the nqa reflector command and the l2vpn reflector command. For more information about the l2vpn reflector command, see MPLS L2VPN in MPLS Command Reference.
Examples
# Configure a reflector on the NQA server for path quality analysis and Y.1564 operations.
<Sysname> system-view
[Sysname] nqa reflector 1 interface ten-gigabitethernet 2/0/0 ip destination 2.2.2.2 source 1.1.1.1
nqa server enable
Use nqa server enable to enable the NQA server.
Use undo nqa server enable to disable the NQA server.
Syntax
nqa server enable
undo nqa server enable
Default
The NQA server is disabled.
Views
System view
Predefined user roles
network-admin
Examples
# Enable the NQA server.
<Sysname> system-view
[Sysname] nqa server enable
nqa twamp-light responder
Use nqa twamp-light responder to enable the TWAMP Light responder and enter its view, or enter the view of the enabled TWAMP Light responder.
Use undo nqa twamp-light responder to disable the TWAMP Light responder.
Syntax
nqa twamp-light responder
undo nqa twamp-light responder
Default
The TWAMP Light responder is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
In TWAMP Light responder view, you can create a test session to interact with the test session on the TWAMP Light client.
The undo nqa twamp-light responder command disables the responder and deletes all test sessions on the responder.
Examples
# Enable the TWAMP Light responder and enter its view.
<Sysname> system-view
[Sysname] nqa twamp-light responder
[Sysname-nqa-twamp-light-responder]
test-session (TWAMP Light responder view)
Use test-session to create a test session on the TWAMP Light responder.
Use undo test-session to delete a test session on the TWAMP Light responder.
Syntax
test-session session-id [ interface interface-type interface-number [ service-instance instance-id ] ] { destination-mac mac-address source-mac mac-address | { ip | ipv6 } destination address source address destination-port port-number source-port port-number [ vpn-instance vpn-instance-name ] } * [ description text | timestamp-format { ntp | ptp } | vlan vlan-id } ] *
undo test-session session-id
Default
No test sessions exist on the TWAMP Light responder.
Views
TWAMP Light responder view
Predefined user roles
network-admin
Parameters
session-id: Specifies a test session by its ID. The value range for this argument is 1 to 512.
interface interface-type interface-number: Specifies a reflecting interface by its type and number.
service-instance instance-id: Specifies an Ethernet service instance by its ID, in the range of 1 to 4096.
destination-mac: Specifies a destination MAC address for the packets to be reflected.
source-mac: Specifies a source MAC address for the packets to be reflected.
mac-address: Specifies a MAC address in the format H-H-H. For example, to use 000f-00e2-0001 as the destination MAC address, set this argument to f-e2-1.
ip: Specifies an IPv4 address.
ipv6: Specifies an IPv6 address.
destination: Specifies a destination address for the packets to be reflected.
source: Specifies a source address for the packets to be reflected.
destination-port port-number: Specifies a destination UDP port number for the packets to be reflected, in the range of 1 to 65535.
source-port port-number: Specifies a source UDP port number for the packets to be reflected, in the range of 1 to 65535.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the operation is performed on the public network.
description text: Specifies a description for the test session, a case-sensitive string of 1 to 200 characters.
timestamp-format: Specifies the timestamp format for the TWAMP Light responder. If you do not specify a timestamp format, the default value AUTO is used and the TWAMP Light responder selects a timestamp format automatically.
· ntp: Specifies the NTP format.
· ptp: Specifies the PTP format.
vlan vlan-id: Specifies a VLAN ID for the packets to be reflected. The value range for the vlan-id argument is 1 to 4094.
Usage guidelines
The test session on the TWAMP Light responder interacts with the test session on the TWAMP Light client.
The following settings specified in this command must be consistent with those on the TWAMP Light client:
· Source IP address.
· Destination IP address.
· Source UDP port number.
· Destination UDP port number.
· VPN instance name.
If the specified test session ID does not exist, this command creates a new test session. If you specify an existing session ID, you are modifying the test session.
You can specify the same interface or Ethernet service instance for different test sessions.
If you want to edit or delete the interface or Ethernet service instance in an existing reflector, you must delete the reflector and reconfigure it.
Except for the interface and Ethernet service instance, you can edit or delete other parameters.
If you do not specify any optional parameters in the undo command, you are deleting the test session. If all configurations about the session are deleted, the test session will be deleted.
Examples
# Create a test session test-session 1 on the TWAMP Light responder. Specify source IPv4 address 1.1.1.1, destination IPv4 address 2.2.2.2, source port 3000, destination port 3001, and VPN instance vpn1 for the test session.
<Sysname> system-view
[Sysname] nqa twamp-light responder
[Sysname-nqa-twamp-light-responder] test-session 1 ip destination 2.2.2.2 source 1.1.1.1 destination-port 3001 source-port 3000 vpn-instance vpn1
