actuateUtil (Actuate Agent Only)

actuateUtil Tool (Actuate Agent Only)

The actuateUtil tool 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 such as namespaces and 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)