Configure TWAMP on ACX, MX, M, T, and PTX Series Routers, EX Series and QFX10000 Series Switches
The Two-Way Active Measurement Protocol (TWAMP) defines a standard for measuring IP performance between two devices in a network. For more information on TWAMP, see RFC 5357, A Two-Way Active Measurement Protocol (TWAMP). For more background information on TWAMP, see Understand Two-Way Active Measurement Protocol.
Understand TWAMP Configuration
Two-Way Active Measurement Protocol (TWAMP) support and configuration varies for hardware platform, physical interfaces, or virtual physical (services) interfaces. Support for RPM is not always an indicator of TWAMP support on a particular combination of platform and line card for Junos OS. The time stamps used in RPM and TWAMP are added in different places, depending on the hardware configuration. For example, different hardware components perform timestamping, either inline in the lookup (LU) chip, Routing Engine (Junos OS Evolved), the microkernel-based timestamping at the host Packet Forwarding Engine, or the line card such as a Multiservices Physical Interface Card (MS-PIC), Multiservices Modular Interface Card (MS-MIC), Multiservices Modular PIC Concentrator (MS-MPC), or Multiservices Dense Port Concentrator (MS-DPC).
The ACX710 and ACX5448 Series routers, which run Junos OS, support both reflection and generation. Other ACX Series routers running Junos OS support only reflection. ACX Series routers running Junos OS Evolved support both reflection and generation.
PTX Series routers running Junos OS do not support the destination interface
si-x/y/z
attribute, which is meant for enabling inline
services, for TWAMP client configurations.
For Junos OS Evolved, TWAMP, including TWAMP Light and Simple Two-Way Active Measurement Protocol (STAMP), is supported, and is limited to the following:
-
IPv4 and IPv6 traffic for control sessions and test sessions; IPv6 traffic support (except for link-local addresses) starting in Junos OS Evolved Release 21.4R1. Support for IPv6 link-local addresses for TWAMP Light test sessions only starting in Junos OS Evolved 22.3R1.
-
Probe statistics and history
-
Control and test session status
-
Test session probe generation and reception, as well as reflection
-
Timestamps set by the Routing Engine or the Packet Forwarding Engine for IPv4 traffic. For IPv6 traffic, timestamps set by the Routing Engine only. For IPv6 traffic, starting in Junos OS Evolved 22.3R1, we support Packet Forwarding Engine timestamps. Prior to Junos OS Evolved Release 22.3R1, for IPv6 traffic, the
offload-type
statement at the[edit services monitoring twamp client control-connection name test-session name]
hierarchy level should be configured asnone
. Starting in Junos OS Evolved 22.4R1 for ACX routers, you can configure theinline-timestamping
option of theoffload-type
statement to enable timestamps set inline by the hardware. Starting in Junos OS Evolved 23.4R1 for servers, the default for theoffload-type
statement is nowpfe-timestamp
instead ofinline-timestamp
. -
Starting in Junos OS Evolved Release 23.4R1, we support RFC 8762, Simple Two-Way Active Measurement Protocol (STAMP). RFC 8762 standardizes and expands upon the TWAMP Light operational mode, which was defined in Appendix I of RFC 5357, Two-Way Active Measurement Protocol (TWAMP). A STAMP-compliant reflector ensures symmetric payload size (in accordance with RFC 6038) and operates in either stateless or stateful mode, depending on whether the sequence number in the reflected payload is copied from the client frame or generated independently. A stateful reflector can detect in which direction drops have occurred. In previous releases, we supported symmetric payloads and stateless reflection. With this release, we support stateful reflection, full compliance with the STAMP standard, and unidirectional drop values for clients. We support unidirectional drop values not only for STAMP clients, but also for TWAMP-Managed-mode clients.
-
Error reporting through system log messages and SNMP traps only
-
Unauthenticated mode only
See TWAMP on ACX Series routers for information about IPv6 support for the ACX Series routers.
- TWAMP Light Support
- Simple Two-Way Active Measurement Protocol (STAMP) Support
- TWAMP Managed Support
TWAMP Light Support
Table 1 provides information about support for TWAMP Light, as defined in Appendix I of RFC 5357, which defines a light version of the TWAMP protocol, a stateless version of TWAMP where test parameters are predefined instead of negotiated. All test packets received by the server on a test port are reflected back and forgotten right away.
Support for IPv6 target addresses for TWAMP Light test sessions is introduced in
Junos OS Release 21.3R1 for MX Series and the PTX1000, PTX3000, and PTX5000
routers. For the Junos OS IPv6 TWAMP Light client, you must configure both the
target-address
and the destination-port
statements at the [edit services rpm twamp client control-connection
control-client-name test-session
test-session-name]
hierarchy level. Support
for link-local target addresses for IPv6 TWAMP Light test sessions is introduced
in Junos OS Release 21.4R1 for MX Series and the PTX1000, PTX3000, and PTX5000
routers and in Junos OS Evolved Release 22.3R1, for the ACX7100, ACX7509,
PTX10001-36MR, PTX10003, PTX10004, PTX10008, and PTX10016 routers.
Device | Supported In |
---|---|
ACX710 | Junos OS Release 22.3R1 |
ACX5448 Series | Junos OS Release 22.3R1 |
ACX7100 Series | Junos OS Evolved Release 21.2R1 |
ACX7332 and ACX7348 | Junos OS Evolved Release 23.4R1 |
ACX7509 | Junos OS Evolved Release 22.3R1 |
EX4100 |
Junos OS Release 24.2R1 |
EX4300 | Junos OS Release 17.3R1 |
EX4400 and EX4650 |
Junos OS Release 24.2R1 |
EX9200 | Junos OS Release 21.4R1 |
MX Series, with LC480, LC2101, LC2103, and MPCs up to and including the MPC9E | Junos OS Release 21.1R1 (IPv4), Junos OS Release 21.3R1 (IPv6) |
MX Series with the following line cards: LMIC16-BASE, LC9600, MPC10E, and MPC11E |
|
PTX Series running Junos OS, with MPCs up to and including the MPC9E | Junos OS Release 21.1R1 (IPv4), Junos OS Release 21.3R1 (IPv6) |
PTX Series running Junos OS, with MPC10E and MPC11E line cards |
|
PTX10001-36MR |
|
PTX10003 |
|
PTX10004 |
|
PTX10008 and PTX10016 (with the JNP10008-SF3 and either the JNP10K-LC1201 or JNP10K-LC1202-36MR line card) | Junos OS Evolved Release 21.1R1 |
QFX5130-32CD, QFX5220, QFX5700 | Junos OS Evolved Release 22.4R1 |
QFX10002, QFX10008, QFX10016 | Junos OS Release 21.3R1 (IPv4) |
Simple Two-Way Active Measurement Protocol (STAMP) Support
Table 2 provides
information about support for TWAMP Light, as defined in RFC 8762, Simple
Two-Way Active Measurement Protocol (STAMP). RFC 8762 standardizes
and expands upon the TWAMP Light operational mode, which was defined in Appendix
I of RFC 5357, Two-Way Active Measurement Protocol (TWAMP). A
STAMP-compliant reflector ensures symmetric payload size (in accordance with RFC
6038) and operates in either stateless or stateful mode, depending on whether
the sequence number in the reflected payload is copied from the client frame or
generated independently. A stateful reflector can detect in which direction
drops have occurred. In previous releases, we supported symmetric payloads and
stateless reflection. We now support stateful reflection, full compliance with
the STAMP standard, and unidirectional drop values for clients. We support
unidirectional drop values not only for STAMP clients, but also for
TWAMP-Managed-mode clients. For Junos OS Evolved, STAMP is configured at the
[edit services monitoring twamp server light] hierarchy level. Stateful
reflection is configured with the stateful-sequence
statement.
For servers, the new default for offload-type
is now
pfe-timestamp
instead of
inline-timestamp
.
Device |
Supported In |
---|---|
ACX7024, ACX7024X, ACX7100-32C, ACX7100-48L, ACX7509 |
Junos OS Evolved Release 23.4R1 |
PTX10001-36MR, PTX10003, PTX10004, and PTX10008 and PTX10016 (with the JNP10008-SF3 and either the JNP10K-LC1201 or JNP10K-LC1202-36MR line card) |
Junos OS Evolved Release 23.4R1 |
TWAMP Managed Support
For Junos OS, TWAMP is configured at the [edit services rpm
twamp]
hierarchy level. For Junos OS Evolved, TWAMP is configured
at the [edit services monitoring twamp]
hierarchy level. Table 3 provides
information about support for TWAMP.
Device | Supported In |
---|---|
ACX710 | Junos OS Release 22.3R1 (IPv4) |
ACX5448 Series | Junos OS Release 22.3R1 (IPv4) |
ACX7100 Series |
|
ACX7332 and ACX7348 | Junos OS Evolved 23.4R1 |
ACX7509 | Junos OS Evolved Release 22.3R1 |
EX4100 |
Junos OS Release 24.2R1 |
EX4300 | Junos OS Release 17.3R1 |
EX4400 and EX4650 |
Junos OS Release 24.2R1 |
EX9200 | Junos OS Release 21.4R1 |
MX Series | Junos OS Release 19.2R1 |
PTX Series running Junos OS | Junos OS Release 19.2R1 |
PTX10001-36MR |
|
PTX10003 |
|
PTX10004 |
|
PTX10008 (with the JNP10008-SF3 and either the JNP10K-LC1201 or JNP10K-LC1202-36MR line card) |
|
PTX10016 (with the JNP10008-SF3 and either the JNP10K-LC1201 or JNP10K-LC1202-36MR line card) | Junos OS Evolved Release 22.4R1 |
QFX5130-32CD, QFX5220, QFX5700 | Junos OS Evolved Release 22.4R1 |
QFX10002, QFX10008, QFX10016 | Junos OS Release 21.3R1 |
Table 4 shows the relationship between RPM client and server support, TWAMP client (with the control component) and TWAMP server (with the responder component) support, and the hardware that performs timestamping.
TWAMP Feature Support |
Routing Engine Timestamp |
MS-PIC/MS-DPC Timestamp |
MS-MIC/MS-MPC Timestamp |
Packet Forwarding Engine (microkernel) Timestamp |
Packet Forwarding Engine (LU) Timestamp ( |
RPM Client |
Yes |
Yes |
Yes |
Yes |
No |
RPM Server |
Yes |
Yes |
Yes |
Yes |
No |
TWAMP Client |
No |
No |
No |
Yes |
Yes |
TWAMP Server |
No |
Yes |
No |
Yes (No responder configuration needed) |
Yes |
Support for the services interfaces (sp-
, ms-
,
and si-
interfaces) are all slightly different.
Configure a TWAMP Server
With the exception of physical interfaces, TWAMP server configuration for Junos
OS requires the following minimum configuration at the [edit services
rpm twamp
] hierarchy level:
server { authentication-mode mode; client-list list-name { address ip-address; } port 862; }
Starting in Junos OS Release 21.3R1, you no longer need to configure the
authentication-mode
statement. The default mode is now
none
, which means that communications with the server are
not authenticated.
-
To specify the list of allowed control client hosts that can connect to this server, include the
client-list
statement at the[edit services rpm twamp server]
hierarchy level. Each value you include must be a Classless Interdomain Routing (CIDR) address (IP address plus mask) that represents a network of allowed hosts. You can include multiple client lists, each of which can contain a maximum of 64 entries. You must configure at least one client address to enable TWAMP. -
ACX Series routers do not support authentication and encryption modes. The value for
authentication-mode
statement at the[edit services rpm twamp server]
hierarchy level must be set tonone
. -
TWAMP control connection traffic always arrives on ACX routers with the listening port set as 862. Because this port number for traffic probes can be modified, probes that arrive with a different port number are not recognized and processed by ACX routers correctly. As a result, TWAMP traffic and host-bound packets are dropped in such a scenario.
Configure TWAMP on ACX, MX, M, T, and PTX Series Routers, EX Series and QFX10000 Series Switches provides information about support for light control of the server.
For Junos OS, you can configure light control for the server (managed control is
the default). The Junos OS TWAMP server configuration for light control requires
the following minimum configuration at the [edit services rpm
twamp]
hierarchy level:
server { authentication-mode none; light; port (862 | 878 | 51000); }
For Junos OS, for a list of restrictions on source addresses, see source-address (TWAMP).
For Junos OS Evolved, you can configure
either managed or light control for the server. TWAMP server configuration for
managed or light control requires the following minimum configuration at the
[edit services monitoring twamp]
hierarchy level, assuming
you use the default port for TWAMP (862):
server { (managed | light); }
For Junos OS Evolved, you cannot use the following addresses for the client-list source IP address used for probes:
-
0.0.0.0
-
127.0.0.0/8 (loopback)
-
224.0.0.0/4 (multicast)
-
255.255.255.255 (broadcast)
You can configure more than one client, and you can change the TWAMP listening port as long as the change is coordinated with the TWAMP client.
For microkernel-based timestamping in Junos OS, you don’t need to configure an
si-
interface. In this case, the TWAMP connection and
sessions are established based on the target address and route.
For inline timestamping in Junos OS, you need to configure si-
or sp-
services interfaces and theTWAMP server configuration
requires the following statements at the [edit interfaces
service-interface-name]
hierarchy level:
user@router# show interfaces si-0/0/0 unit 10 { rpm twamp-server; family inet { address 10.10.10.1/24; } }
user@router# show interfaces sp-0/0/0 unit 10 { rpm twamp-server; family inet { address 10.20.20.1/24; } }
You cannot configure the TWAMP server on unit 0 of a services interface. If you try, you will receive a configuration error.
(Junos OS only) To configure a TWAMP server on an inline services
(si-
) interface, configure the amount of bandwidth reserved
on each Packet Forwarding Engine for tunnel traffic using inline services by
including the bandwidth (1g | 10g)
statement at the
[edit chassis fpc slot-number pic number inline-services]
hierarchy level. Specify the service PIC (sp-
) logical
interface that provides the TWAMP service by including the
twamp-server
statement at the [edit interfaces
sp-fpc/pic/port unit
logical-unit-number family inet]
hierarchy
level.
The twamp-server
statement is not required for physical
interface TWAMP server configuration.
Many other TWAMP server parameters are optional. See the TWAMP
server
configuration statements for details.
Configure a TWAMP Client
For Junos OS, to configure the TWAMP client service, include the
client
statement and related parameters at the [edit services rpm
twamp]
hierarchy level. For Junos OS Evolved, include the
client
statement and related options at the [edit services monitoring
twamp
] hierarchy level.
There are many options available for TWAMP client configuration. See the configuration statement topics and examples for details.
For microkernel-based timestamping in Junos OS, you don’t need to configure an
si-
interface. In this case, the TWAMP connection and
sessions are established based on the target address and route.
For inline timestamping in Junos OS, the si-
interfaces are
virtual physical interfaces that respond as a TWAMP server. However, you can
also configure services interfaces to act as the TWAMP client, which performs
the TWAMP controller role.
(Junos OS only) To configure a services interface as a TWAMP client, you configure the service parameters and the service interface as a TWAMP client.
To configure the TWAMP client services interface, include the rpm
twamp-client
statement at the [edit interfaces
si-interface-name]
hierarchy level:
user@router# show interfaces si-0/0/0 unit 0 { family inet; } unit 10 { rpm twamp-client; family inet { address 10.30.30.1/24 } }
You cannot configure the TWAMP client on unit 0 of a service interface. If you try, you will receive a configuration error.
See Also
Change History Table
Feature support is determined by the platform and release you are using. Use Feature Explorer to determine if a feature is supported on your platform.
offload-type
statement is now
pfe-timestamp
instead of inline-timestamp
.
authentication-mode
statement for the TWAMP server. The
default mode is none
.