The device supports Y.1564 operations, service quality operations, and TWAMP Light operations. For Y.1564 operations, you can configure the device as only the reflector.

NQA client commands

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

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.

Usage guidelines

In TWAMP Light tests, the payload size cannot be larger than the MTU size of any interface on the test link.

Examples

# In TWAMP Light client-session view, set the payload size to 80 bytes for each probe packet.

<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

Any NQA 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

# In TWAMP Light client-session view, configure the description as twamp-light 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

destination ip

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

Use undo destination ip to restore the default.

Syntax

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

destination ipv6 ipv6-address

undo destination ipv6

Default

No destination IPv6 address is configured for an operation.

Views

Frame loss/latency/throughput 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 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

Default

For the frame loss, latency, or throughput 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 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

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.

The destination port numbers for the operations that use the following NQA templates are:

No destination port number is configured for other types of operations.

Views

Frame loss/latency/throughput 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 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	Results of the NQA operation.
Extended results	Results of extended items.
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 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 1.1.1.1/2001 2.2.2.2/2010

2 Active 2001::1/2001 2001::2/2010

# Display detailed information about all test sessions.

<Sysname> display nqa twamp-light client verbose

Session ID : 1

Status : Active

Session type : Permanent

Source interface : Ten-GigabitEthernet2/0/0

Service instance : -

Source IP : 1.1.1.1

Source IPv6 : -

Destination IP : 2.2.2.2

Destination IPv6 : -

Source port : 2001

Destination port : 2010

Source MAC address : -

Destination MAC address : -

VLAN ID : -

Service VLAN ID : -

Customer VLAN ID : -

ToS : 0

Padding length : 128

Timestamp format : NTP

VPN instance : -

Priority 802.1p : 0

Last start time : 2018-08-05 16:41:05

Last stop time : Never

Packet sending interval(ms) : 100

Timeout(sec) : 5

Duration(sec) : -

Packets sent : -

Statistics interval(ms) : 3

Monitor time(ms) : 3

Delay monitor time(ms) : 3

Jitter monitor time(ms) : 3

Loss monitor time(ms) : 3

Session ID : 2

Status : Inactive

Session type : On-demand

Source interface : Ten-GigabitEthernet2/0/0

Service instance : -

Source IP : 1.1.1.1

Source IPv6 : -

Destination IP : 3.3.3.3

Destination IPv6 : -

Source port : 2001

Destination port : 2020

Source MAC address : -

Destination MAC address : -

VLAN ID : -

Service VLAN ID : -

Customer VLAN ID : -

ToS : 0

Padding length : 128

Timestamp format : PTP

VPN instance : -

Priority 802.1p : 0

Last start time : Never

Last stop time : Never

Packet sending interval(ms) : 100

Timeout(sec) : 8

Duration(sec) : 300

Packets sent : -

Statistics interval(ms) : 3

Monitor time(ms) : 3

Delay monitor time(ms) : 3

Jitter monitor time(ms) : 3

Loss monitor time(ms) : 3

Table 3 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	This field is not supported in the current software version. 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. If the test does not start, this field displays Never.
Last stop time	Stop time of the most recent TWAMP Light test. If the test does not complete, this field 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(μs):

Index Delay(avg) Jitter(avg) SD jitter(avg) DS jitter(avg)

11027 0 0 0 0

11028 0 0 0 0

11029 4 4 4 4

11030 1 1 1 1

11031 1 1 1 1

11032 1 1 1 1

11033 0 0 0 0

11034 1 1 1 1

11035 2 2 2 2

11036 2 2 2 2

11037 0 0 0 0

11038 2 2 2 2

11039 1 1 1 1

11040 0 0 0 0

11041 0 0 0 0

11042 0 0 0 0

11043 0 0 0 0

11044 1 1 1 1

11045 3 3 3 3

11046 0 0 0 0

11047 1 1 1 1

11048 0 0 0 0

11049 0 0 0 0

11050 0 0 0 0

11051 1 1 1 1

11052 0 0 0 0

11053 5 5 5 5

11054 7 7 7 7

11055 0 0 0 0

11056 1 1 1 1

--------------------------------------------------------------------------------

Average delay : 1 Average jitter : 1

Maximum delay : 7 Maximum jitter : 7

Minimum Delay : 0 Minimum jitter : 0

Average SD jitter : 1 Average DS jitter : 1

Maximum SD jitter : 7 Maximum DS jitter : 7

Minimum SD jitter : 0 Minimum DS jitter : 0

Table 4 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 5 Command output

Field	Description
Latest two-way loss statistics	Most recent statistics of two-way packet loss.
Index	ID of a statistics entry.
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.

‌

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

Upper threshold: 200

Action type: None

Checked objects: 12

Threshold violations: 4

Index:2

Checked element: Two-way jitter

Lower threshold: 20

Upper threshold: 200

Action type: None

Checked objects: 12

Threshold violations: 4

Index:3

Checked element: Two-way loss

Lower threshold: 20

Upper threshold: 200

Action type:None

Checked objects: 12

Threshold violations: 4

Table 6 Command output

Field	Description
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

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 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, and throughput 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 1518 bytes.

Views

Frame loss/latency/throughput 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 packet 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

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 hex

undo hex-data-fill

Default

The hexadecimal payload fill string is 00010203040506070809.

Views

TWAMP Light client-session view

Predefined user roles

network-admin

Parameters

hex: Specifies a hexadecimal string, which is case-insensitive and can contain any even number of characters in the range of 2 to 200.

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.

If you execute this command and the hex-data-fill command multiple times, the most recent configuration takes effect.

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

Related commands

data-fill

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

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

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

out interface

Use out interface to specify the output interface for probe packets.

Use undo out interface to restore the default.

Syntax

out interface interface-type interface-number

undo out interface

Default

The output interface for probe packets is not specified. The NQA client determines the output interface based on the routing table lookup.

Views

Frame loss/latency/throughput operation view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

For successful operation, the specified output interface must be up.

Examples

# Specify Ten-GigabitEthernet 2/0/0 as the output interface for probe packets in the throughput operation.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type throughput

[Sysname-nqa-admin-test-throughput] out interface ten-gigabitethernet 2/0/0

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

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 operation view

Predefined user roles

network-admin

Parameters

timeout: Specifies the probe timeout time in milliseconds. The value range for this argument varies as follows:

For frame loss, latency, and throughput 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

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

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

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 statistics

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

undo source interface

Default

No source AC or source interface is specified for probe packets.

Views

Frame loss/latency/throughput 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.

Usage guidelines

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.

When you configure this command, make sure the specified interface is up.

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

Use source ip to configure the source IPv4 address for probe packets.

Use undo source ip to restore the default.

Syntax

source ip ipv4-address

undo source ip

Default

For the frame loss, latency, or throughput operation, the source IPv4 address for probe packets is 198.19.65.1. For other types of operations, no source IPv4 address is specified for probe packets.

Views

Frame loss/latency/throughput 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

source ipv6 ipv6-address

undo source ipv6

Default

The source IPv6 address for probe packets is not specified for the frame loss, latency, and throughput operations.

Views

Frame loss/latency/throughput 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

undo source mac

Default

No source MAC address is specified.

Views

Frame loss/latency/throughput 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.

Examples

# 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

source port port-number

undo source port

Default

The source port number is 49184 for the frame loss, latency, or throughput operation. For TWAMP Light tests, the source port number is not specified.

Views

Frame loss/latency/throughput 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 TWAMP Light tests, 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 40000000.

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

Use start to start the frame loss, throughput, or latency operation.

Syntax

start

Default

The frame loss, throughput, or latency operation is not started.

Views

Frame loss/latency/throughput operation view

Predefined user roles

network-admin

Usage guidelines

The frame loss, latency, or throughput 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, or throughput operation cannot run simultaneously with other NQA operations over the same link.

While a frame loss, latency, or throughput operation is running on the NQA client, you cannot start another operation of the same type.

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

stop (frame loss/latency/throughput operation 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 the range of 60 to 300 in seconds.

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

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

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 test interval no less than the packet sending interval.

Table 7 Default values for the statistics collection interval and monitoring time

Packet sending interval	Default test 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 operation view)

Use stop to stop the frame loss, throughput, or latency operation.

Syntax

stop

Views

Frame loss/latency/throughput operation view

Predefined user roles

network-admin

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

start (frame-loss/latency/throughput operation 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 test 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.

Use undo timestamp-format to restore the default.

Syntax

timestamp-format { ntp | ptp }

undo timestamp-format

Default

The timestamp format for probe packets in the TWAMP Light test is PTP.

Views

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 the probe packet in the 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

Any 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

# In throughput operation view, set the ToS value to 1 in the IP header for probe packets.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type throughput

[Sysname-nqa-admin-test-throughput] tos 1

type

Use type to specify an NQA operation type and enter its view.

Syntax

type { frame-loss | latency | throughput }

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.

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 frame loss as the NQA operation type and enter frame loss operation view.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type frame-loss

[Sysname-nqa-admin-test-frame-loss]

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 | s-vid vlan-id c-vid vlan-id }

undo vlan

Default

No VLAN is specified for probe packets.

Views

Frame loss/latency/throughput 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.

s-vid: Specifies an inner VLAN ID.

c-vid: Specifies an outer VLAN ID.

Usage guidelines

After you specify a VLAN, the operation sends probe packets in the specified VLAN.

You can use this command to specify an inner VLAN ID or outer VLAN ID as needed.

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 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 throughput operation to vpn1.

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type throughput

[Sysname-nqa-admin-test-throughput] 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 : GE0/0/1

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 8 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	This field is not supported in the current software version. 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 9 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

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 : 1-1-2

Source MAC : 1-1-1

VLAN ID : -

Service VLAN ID : -

Customer VLAN ID : -

Timestamp format : PTP

Description : -

Adjust-udp-checksum : Enabled

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 : 1-1-2

Source MAC : 1-1-1

VLAN ID : -

Service VLAN ID : -

Customer VLAN ID : -

Timestamp format : NTP

Description : -

Adjust-udp-checksum : Disabled

Extended-packet : Disabled

Table 10 Command output

Field	Description
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	This field is not supported in the current software version. 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.
Adjust-udp-checksum	Whether or not to adjust the checksum value in test packets. · Enabled—Adjust the checksum value in test packets. · Disabled—Do not adjust the checksum value in test packets. The checksum value is 0.
Adjust-udp-checksum	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.

‌

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 or Y.1564 operation.

Use undo nqa reflector to delete the reflector for the path quality analysis operation or Y.1564 operation.

Syntax

nqa reflector reflector-id interface interface-type interface-number [ { ip | ipv6 } { destination address1 [ to address2 ] | source address1 [ to address2 ] } * | destination-port port-number1 [ to port-number2 ] | source-port port-number1 [ to port-number2 ] | destination-mac mac-address1 [ to mac-address2 ] | source-mac mac-address1 [ to mac-address2 ] | vlan { vlan-id1 [ to vlan-id2 ] | s-vid vlan-id1 [ to vlan-id2 ] c-vid 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 or Y.1564 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.

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.

address1 to address2: Specifies an IP address range. The address2 must be higher than the address1. Between the two IP addresses, only one octet difference is allowed and the value difference cannot exceed 127.

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

port-number1 to port-number2: Specifies a port range, in the range of 1 to 65535. The port-number2 must be greater than the port-number1. Between the two port numbers, only one octet difference is allowed and the value difference cannot exceed 127.

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-address1 to mac-address2: Specifies a MAC address range. The mac-address2 must be higher than the mac-address1. Between the two MAC addresses, only one octet difference is allowed and the value difference cannot exceed 127.

vlan: Specifies a VLAN, inner VLAN ID, or outer VLAN ID for the packets to be reflected.

vlan-id1 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, only one octet difference is allowed and the value difference cannot exceed 127.

s-vid: Specifies an inner VLAN ID.

c-vid: Specifies an outer VLAN ID.

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 or Y.1564 operation.

Usage guidelines

This command is required on the NQA server for the path quality analysis operation and 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.

· Service VLAN ID.

· Customer VLAN ID.

In the path quality analysis operations, you cannot specify value ranges for the above options.

You can specify the same interface for different reflectors.

If you want to edit or delete the interface in an existing reflector, you must delete the reflector and reconfigure it.

Except for the interface, 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 operations 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 ] { 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 ] } * [ adjust-udp-checksum | description text | extended-packet | timestamp-format { ntp | ptp } | vlan { vlan-id | s-vid vlan-id c-vid 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.

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.

adjust-udp-checksum: Adjusts the checksum value in TWAMP Light test packets. By default, the checksum value in TWAMP Light test packets is 0. Support for the checksum value varies by TWAMP Light client. Specify the checksum value as required by the TWAMP Light client connected to the device. If the TWAMP Light client is an H3C device, this keyword is not required. This keyword applies only to IPv6 packets.

description text: Specifies a description for the test session, a case-sensitive string of 1 to 200 characters.

extended-packet: Extends the TWAMP Light packet header in the reflected packets to the standard header length if the data size of received test packets is less than 41 bytes. If this keyword is not specified, the device directly constructs reflected packets based on the received test packets, without extending the TWAMP Light packet header. The test result might be inaccurate because the header of reflected packets lacks necessary parameters.

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: Specifies a VLAN, service VLAN ID, or customer VLAN ID for the packets to be reflected.

· vlan-id: Specifies a VLAN ID, in the range of 1 to 4094.

· s-vid: Specifies a service VLAN ID.

· c-vid: Specifies a customer VLAN ID.

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 only one interface for a test session.

You can specify the same interface for different test sessions.

If you want to edit or delete the interface in an existing reflector, you must delete the reflector and reconfigure it.

Except for the interface, 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

11-Network Management and Monitoring Command Reference

NQA commands

NQA client commands

display nqa result

frame-size

nqa twamp-light client

out interface

reset nqa twamp-light statistics

start (frame loss/latency/throughput operation view)

stop (frame loss/latency/throughput operation view)

test-session (TWAMP Light client view)

tos

vpn-instance

nqa twamp-light responder

test-session (TWAMP Light responder view)

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us