Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

twamp

date_range 20-Dec-24

Syntax (Junos OS)

content_copy zoom_out_map
twamp {
    client {
        control-connection  name {
            authentication-mode none;
            control-type (managed | light); 
            destination-interface  destination-interface;
            destination-port   destination-port;
            history-size   history-size;
            moving-average-size  moving-average-size;
            persistent-results;
            routing-instance  routing-instance;
            target-address target-address;
            tcp-keepcnt   count;
            tcp-keepidle  seconds;
            tcp-keepintvl  seconds;
            test-count test-count;
            test-interval   seconds;
            traps { 
                control-connection-closed;
                test-iteration-done;
            }
            test-session name {                      
                data-fill-with zeros;
                data-size  data-size;
                destination-port   destination-port;
                dscp-code-points (RPM) dscp-code-points;
                probe-count probe-count;
                probe-interval seconds; 
                source-address source-address;  
                target-address target-address local-link IPv6-link-local-interface-name; 
                thresholds {
                    egress-time microseconds;
                    ingress-time microseconds;
                    jitter-egress microseconds;
                    jitter-ingress microseconds;
                    jitter-rtt microseconds;
                    max-rtt microseconds;
                    rtt microseconds;
                    std-dev-egress microseconds;
                    std-dev-ingress microseconds;
                    std-dev-rtt microseconds;
                    successive-loss successive-loss;
                    total-loss total-loss;
                }
                traps {
                    egress-jitter-exceeded;
                    egress-std-dev-exceeded;
                    egress-time-exceeded;
                    ingress-jitter-exceeded;
                    ingress-std-dev-exceeded;
                    ingress-time-exceeded;
                    jitter-exceeded;
                    max-rtt-exceeded;
                    probe-failure;
                    rtt-exceeded;
                    std-dev-exceeded;
                    test-completion;
                    test-failure;
                }
                ttl hop-count;
            }
        }
    }
    post-cli-implicit-firewall;
    server {
        authentication-key-chain name {
            key-id name {                      
                secret secret;                      
            }
        }
        authentication-mode <authenticated > <control-only-encrypted> <encrypted > <none>;                
        client-list <list-name>  {
            address address <routing-instance [instance-name...]>;
        }
        light { 
            port port-number;
        }
        max-connection-duration  hours;
        maximum-connections  maximum-connections;
        maximum-connections-per-client  maximum-connections-per-client;
        maximum-sessions  maximum-sessions;
        maximum-sessions-per-connection  maximum-sessions-per-connection;
        port  port;
        routing-instance-list  name {
            port port;                   
        }
        server-inactivity-timeout  minutes;
        tcp-keepcnt  count;
        tcp-keepidle  seconds;
        tcp-keepintvl seconds;
    }
}

Syntax (Junos OS Evolved)

content_copy zoom_out_map
twamp {
    client {
        control-connection  name {
            control-type (managed | light);
            destination-port  destination-port;
            routing-instance routing-instance;
            source-address source-address;
            target target-address;
            test-start (auto | manual);
            test-interval seconds;
            traps { 
                control-connection-closed;
                test-iteration-done;
            }
            test-session name {                      
                data-size data-size;
                destination-port destination-port;
                dscp-code-points dscp-code-points;
                history-size history-size;
                moving-average-size moving-average-size;
                offload-type (none | inline-timestamping | pfe-timestamp); 
                probe-count  probe-count;
                probe-interval  seconds;
                source-address source-address;
                source-routing {
                    forward (srmpls-nodes <label hop1...n> | srv6-nodes <IPv6 SID hop1...n>);
                    return (srmpls-nodes <label hop1...n> | srv6-nodes <IPv6 SID hop1...n>);
                }                
                target target-address local-link IPv6-link-local-interface-name ;                      
                thresholds {
                    control-failure (on | off);
                    successive-loss number;
                    total-loss number;
                    threshold-type (microseconds | average);
                }
                traps { 
                    egress-jitter-exceeded
                    egress-time-exceeded;
                    ingress-jitter-exceeded;
                    ingress-time-exceeded;
                    jitter-exceeded;
                    probe-failure;
                    rtt-exceeded;
                    test-completion;
                    test-failure;
                }
                ttl hop-count;
            }
        }
    }
    server {
        managed {
            client-limit limit;
            client-list list-name {
                address address <routing-instance [instance-name...]>;
            }
            control-inactivity-timeout seconds;
            control-per-client-limit limit;
            control-maximum-duration seconds;
            offload-type (none | inline-timestamp | pfe-timestamp); 
            port  port;
            stateful-sequence; 
            test-per-client-limit limit;
        }
        light {
            offload-type (none | inline-timestamp | pfe-timestamp); 
            port  port;
            stateful-sequence cache-size size; 
        }
    }
}

Hierarchy Level (Junos OS)

content_copy zoom_out_map
[edit services rpm]

Hierarchy Level (Junos OS Evolved)

content_copy zoom_out_map
[edit services monitoring]

Description

Configure the Two-Way Active Measurement Protocol (TWAMP) client or server settings on all M Series and T Series routers that support Multiservices PICs (running in either Layer 2 or Layer 3 mode), MX Series routers, ACX routers, EX4300 Switches, PTX Series routers, EX9200 Series switches, and QFX10000 Series switches.

TWAMP is an open protocol for measurement of two-way metrics. The host that initiates the TCP connection takes the roles of the control-client and (in the two-host implementation) the session-sender. Such a device is also called the TWAMP client. The host that acknowledges the TCP connection accepts the roles of a server and (in the two-host implementation) and the session-reflector. Such a device is also called the TWAMP server. The TWAMP-Test messages are exchanged between the session-sender and the session-reflector, and the TWAMP-Control messages are exchanged between the control-client and the server.

The following addresses cannot be used 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)

The remaining statements are explained separately. Search for a statement in CLI Explorer or click a linked statement in the Syntax section for details.

Required Privilege Level

system—To view this statement in the configuration.

system-control—To add this statement to the configuration.

Release Information

Statement introduced in Junos OS Release 9.3.

Junos OS Evolved syntax and hierarchy level introduced in Junos OS Evolved 20.3R1 for PTX10003 routers.

Support for the rest of the PTX10000 Series routers added in Junos OS Evolved Release 21.1R1.

control-type and light options added in Junos OS Release 21.1R1.

traps option added in Junos OS Evolved Release 21.3R1.

source-address option and the local-link sub-option of the target-address option for TWAMP Light test sessions introduced in Junos OS Release 21.4R1.

The local-link sub-option of the target option for TWAMP Light test sessions introduced in Junos OS Evolved Release 22.3R1.

The inline-timestamping suboption of the offload-type option introduced in Junos OS Evolved Release 22.4R1.

offload-type and stateful-sequence options for light and managed servers introduced in Junos OS Evolved Release 23.4R1.

source-routing option introduced in Junos OS Evolved Release 24.4R1.

external-footer-nav