Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Configure TWAMP on ACX, MX, M, T, and PTX Series Routers, EX Series and QFX10000 Series Switches

SUMMARY 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 as none. Starting in Junos OS Evolved 22.4R1 for ACX routers, you can configure the inline-timestamping option of the offload-type statement to enable timestamps set inline by the hardware. Starting in Junos OS Evolved 23.4R1 for servers, the default for the offload-type statement is now pfe-timestamp instead of inline-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

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.

Table 1: TWAMP Light Support
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
  • IPv4 client: Junos OS Release 21.1R1
  • IPv4 server: Junos OS Release 22.2R1
  • IPv6 client and server: Junos OS Release 22.3R1

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
  • client: Junos OS Release 21.1R1 (IPv4)
  • server: Junos OS Release 22.2R1 (IPv4)
PTX10001-36MR
  • Junos OS Evolved Release 21.1R1 (IPv4)

  • Junos OS Evolved Release 21.4R1 (IPv6)

PTX10003
  • Junos OS Evolved Release 20.3R1 (IPv4)

  • Junos OS Evolved Release 21.4R1 (IPv6)

PTX10004
  • Junos OS Evolved Release 21.2R1 (IPv4)

  • Junos OS Evolved Release 21.4R1 (IPv6)

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.

Table 2: STAMP Support

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.

Table 3: TWAMP Managed Support
Device Supported In
ACX710 Junos OS Release 22.3R1 (IPv4)
ACX5448 Series Junos OS Release 22.3R1 (IPv4)
ACX7100 Series
  • Junos OS Evolved Release 21.2R1 (IPv4)

  • Junos OS Evolved Release 21.4R1 (IPv6)

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
  • Junos OS Evolved Release 21.1R1 (IPv4)

  • Junos OS Evolved Release 22.4R1 (IPv6)

PTX10003
  • Junos OS Evolved Release 20.3R1 (IPv4)

  • Junos OS Evolved Release 22.4R1 (IPv6)

PTX10004
  • Junos OS Evolved Release 21.2R1 (IPv4)

  • Junos OS Evolved Release 22.4R1 (IPv6)

PTX10008 (with the JNP10008-SF3 and either the JNP10K-LC1201 or JNP10K-LC1202-36MR line card)
  • Junos OS Evolved Release 21.1R1 (IPv4)

  • Junos OS Evolved Release 22.4R1 (IPv6)

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.

Table 4: TWAMP Feature Support and Hardware for Junos OS, MX Series

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 (si- interface)

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

Note:

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:

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

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

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

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:

Note:

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:

Note:

You cannot configure the TWAMP client on unit 0 of a service interface. If you try, you will receive a configuration error.

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.

Release
Description
24.2R1
Starting in Junos OS Release 24.2R1 for the EX4100, EX4400, and EX4650 switches, we support the Two-Way Active Measurement Protocol (TWAMP) managed client and server for IPv4 and IPv6 addresses and the TWAMP Light client and server, as defined in Appendix I of RFC 5357, for IPv4 and IPv6 addresses (including IPv6 link-local addresses). We support both Routing Engine and Packet Forwarding Engine timestamps for TWAMP probes. We also support error reporting through SNMP traps as well as through system log messages.
23.4R1-EVO
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. For servers, the default for the offload-type statement is now pfe-timestamp instead of inline-timestamp.
23.4-EVO
Starting in Junos OS Evolved Release 23.4R1 for the ACX7332 and ACX7348 routers, we support the Two-Way Active Measurement Protocol (TWAMP) managed client and server for IPv4 and IPv6 addresses and the TWAMP Light client and server, as defined in Appendix I of RFC 5357, for IPv4 and IPv6 addresses (including IPv6 link-local addresses). We support Routing Engine and Packet Forwarding Engine timestamps for TWAMP probes, as well as inline timestamping, where the timestamping is done in hardware at the generator or the reflector. We also support error reporting through SNMP traps as well as through system log messages.
22.4R1-EVO
Starting in Junos OS Evolved Release 22.4R1 for the PTX10001-36MR, PTX10003, PTX10004, PTX10008, and PTX10016 routers, IPv6 source and target addresses (except for link-local addresses) are supported for client lists, control connections, and test sessions.
22.4R1-EVO
Starting in Junos OS Evolved Release 22.4R1 on the PTX10016 router, you can configure SNMP traps for TWAMP.
22.4R1-EVO
Starting in Junos OS Evolved Release 22.4R1 for the QFX5130-32CD, QFX5220, and QFX5700 switches, we support the Two-Way Active Measurement Protocol (TWAMP) managed client and server for IPv4 and IPv6 addresses and the TWAMP Light client and server, as defined in Appendix I of RFC 5357, for IPv4 and IPv6 addresses (including IPv6 link-local addresses). We support both Routing Engine and Packet Forwarding Engine timestamps for TWAMP probes. We also support error reporting through SNMP traps as well as through system log messages.
22.4R1-EVO
Starting in Junos OS Evolved Release 22.4R1 for the ACX7100, ACX7509, and ACX7024 routers, we support inline timestamping, where the timestamping is done in hardware at the generator or the reflector.
22.3R1-EVO
Starting in Junos OS Evolved Release 22.3R1, for TWAMP Light test sessions, you can specify IPv6 link-local addresses for target addresses.
22.3R1
Starting in Junos OS Release 22.3R1 for the MX Series routers with line cards MPC10E, MPC11E, LMIC16-BASE, and LC9600, we support the Two-Way Active Measurement Protocol (TWAMP) Light client and server, as defined in Appendix I of RFC 5357, for IPv6 addresses.
22.3R1
Starting in Junos OS Release 22.3R1 for the ACX710 and ACX5448 Series routers, we support the Two-Way Active Measurement Protocol (TWAMP) managed client and server for IPv4 addresses and the TWAMP Light client and server, as defined in Appendix I of RFC 5357, for IPv4 and IPv6 addresses (except for IPv6 link-local addresses). We also support Packet Forwarding Engine timestamps for TWAMP probes.
22.2R1
Starting in Junos OS Release 22.2R1 for the MX Series and PTX1000, PTX3000, and PTX5000 routers, with line cards MPC10E, MPC11E, LMIC16-BASE, and LC9600, we support the Two-Way Active Measurement Protocol (TWAMP) Light server, as defined in Appendix I of RFC 5357, for IPv4 addresses.
21.4R1-EVO
Starting in Junos OS Evolved Release 21.4R1 for ACX7100 routers, IPv6 source and target addresses (except for link-local addresses) are supported for client lists, control connections, and test sessions.
21.4R1
Starting in Junos OS Release 21.4R1, the Two-Way Active Measurement Protocol (TWAMP) is supported on the EX9200 Series switches.
21.4R1
Starting in Junos OS Release 21.4R1, for TWAMP Light test sessions, you can specify IPv6 link-local addresses for target addresses, and can configure IPv6 addresses for source addresses that correspond to target addresses configured with IPv6 link-local addresses.
21.3R1-EVO
Starting in Junos OS Evolved Release 21.3R1 on PTX Series routers, you can configure SNMP traps for TWAMP.
21.3R1
Starting in Junos OS Release 21.3R1, the Two-Way Active Measurement Protocol (TWAMP) is supported on QFX10000 Series switches.
21.3R1
Starting in Junos OS Release 21.3R1 for the MX Series and PTX1000, PTX3000, and PTX5000 routers, IPv6 target addresses for TWAMP Light test sessions are supported.
21.3R1
Starting in Junos OS Release 21.3R1, you no longer have to configure the authentication-mode statement for the TWAMP server. The default mode is none.
21.2R1-EVO
Starting in Junos OS Evolved 21.2R1, the Two-Way Active Measurement Protocol (TWAMP) is supported on the PTX10004 and ACX7100 routers.
21.1R1-EVO
Starting in Junos OS Evolved 21.1R1, the Two-Way Active Measurement Protocol (TWAMP) is supported on the PTX10001-36MR and the PTX10008 (with the JNP10008-SF3 and either the JNP10K-LC1201 or JNP10K-LC1202-36MR line card) routers.
21.1R1
Starting in Junos OS Release 21.1R1 for the MX Series and PTX1000, PTX3000, and PTX5000 routers, with MPCs up to and including the MPC9E, we support the Two-Way Active Measurement Protocol (TWAMP) Light client and server, as defined in Appendix I of RFC 5357. for IPv4 target addresses. TWAMP Light is 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. For the MPC10E, MPC11E, LC9600, and LMIC16-BASE line cards, we only support the TWAMP Light client for IPv4 target addresses.
20.3R1-EVO
Starting in Junos OS Evolved 20.3R1, the Two-Way Active Measurement Protocol (TWAMP) is supported on the PTX10003 router.
19.2R1
Starting in Junos OS Release 19.2R1, the Two-Way Active Measurement Protocol (TWAMP) is supported on PTX Series routers.