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, EX4300 Series, EX9200 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 in the Routing Engine, the 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.

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.

Table 1: TWAMP Light Support
Device Supported In
ACX710 Junos OS Release 22.3R1 (no IPv6 link-local address support)
ACX5448 Series Junos OS Release 22.3R1 (no IPv6 link-local address support)
ACX7100 Series Junos OS Evolved Release 21.2R1
ACX7509 Junos OS Evolved Release 22.3R1
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
PTX10003 Junos OS Evolved Release 20.3R1
PTX10004 Junos OS Evolved Release 21.2R1
PTX10008 and PTX10016 (with the JNP10008-SF3 and either the JNP10K-LC1201 or JNP10K-LC1202-36MR line card) Junos OS Evolved Release 21.1R1
QFX10002, QFX10008, QFX10016 Junos OS Release 21.3R1 (IPv4)
EX9200 Junos OS Release 21.4R1

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 2 provides information about support for TWAMP.

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

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

  • Junos OS Evolved Release 21.4R1 (IPv6)

QFX10002, QFX10008, QFX10016 Junos OS Release 21.3R1
EX9200 Junos OS Release 21.4R1

For Junos OS Evolved, TWAMP, including TWAMP Light, is supported, and is limited to the following:

  • IPv4 traffic only 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.

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

Table 3 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 3: 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 (ukernel) 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, EX4300 Series, EX9200 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 si- or sp- services interfaces, TWAMP 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.

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.

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.

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.

Release History Table
Release
Description
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, 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 20.3R1, the Two-Way Active Measurement Protocol (TWAMP) is supported on the PTX10004 router.
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.