actuateUtil (Actuate Agent Only)

actuateUtil Tool (Actuate Agent Only)

actuateUtil can generate a TWAMP-Light or ECHO session. It can be useful for debugging or validating network reachability of a TWAMP session.

It can be used before creating an actual session to validate that the reflector is reachable and responding.

The latest version supports various complex configuration like namespaces/VRFs.

actuateUtil Help

# actuateUtil

 Usage:
        actuateUtil <proto> [options]
 proto:
        twamp     : TWAMP light IPv4
        twamp6    : TWAMP light IPv6
        echo-udp  : Echo UDP IPv4
        echo6-udp : Echo UDP IPv6
        echo-icmp : Echo ICMP IPv4
        echo6-icmp: Echo ICMP IPv6
 options:
        -saddr <Source ipv4 or ipv6 address>
        -daddr <Destination ipv4 or ipv6 address>
        -sport <Source port, in the range 1 to 65535, default is 60000>
        -dport <Destination port, in the range 1 to 65535, default is twamp=862, echo-udp=7>
        -if    <Transmit ethernet interface, default is eth0>
        -ns    <Name of the namespace/VRF to use for packet transmission, e.g. aNameSpace>
        -rate  <Ethernet frame-rate in frame/s, default is 10>
        -tos   <IP-TOS settings, in the range 0 to 255, default is 0>
        -ttl   <IP-TTL settings, in the range 1 to 255, default is 255>
 Example (default values for other options!):
        actuateUtil twamp -daddr 192.168.0.100

Simple Example of a TWAMP Session

# sudo docker exec -it <CONTAINER ID> /bin/bash --login
# actuateUtil twamp -daddr 192.158.1.38 -dport 50862

# TWAMP-Light [udp/ipv4] 172.17.0.3:60000 ==> 192.158.1.38:50862

> 192.158.1.38 [eth0] seq-ul=1       seq-dl=1       ttl=255/47/255/234 tos=0/*/*/0 rtt=122429 us
> 192.158.1.38 [eth0] seq-ul=11      seq-dl=11      ttl=255/47/255/234 tos=0/*/*/0 rtt=137779 us
> 192.158.1.38 [eth0] seq-ul=21      seq-dl=21      ttl=255/47/255/234 tos=0/*/*/0 rtt=120895 us
> 192.158.1.38 [eth0] seq-ul=29      seq-dl=29      ttl=255/47/255/234 tos=0/*/*/0 rtt=124715 us
> 192.158.1.38 [eth0] seq-ul=39      seq-dl=39      ttl=255/47/255/234 tos=0/*/*/0 rtt=121818 us
> 192.158.1.38 [eth0] seq-ul=46      seq-dl=46      ttl=255/47/255/234 tos=0/*/*/0 rtt=120241 us
> 192.158.1.38 [eth0] seq-ul=47      seq-dl=47      ttl=255/47/255/234 tos=0/*/*/0 rtt=120272 us

 --- 172.17.0.3 ==> 192.158.1.38 (uplink) statistics ---
48 packets transmitted, 48 received, 0 (0.00%) packets lost, in 10.48 seconds
 PD: min=59312   avg=62607   max=77868   (us)
PDV: min=0       avg=3295    max=18556   (us)


 --- 192.158.1.38 ==> 172.17.0.3 (downlink) statistics ---
48 packets transmitted, 48 received, 0 (0.00%) packets lost, in 10.48 seconds
 PD: min=59312   avg=62607   max=77868   (us)
PDV: min=0       avg=3295    max=18556   (us)