iPerf3 - Introduction
iPerf3 (iPerf v3) is docker app to actively measure network performance such as maximum achievable bandwidth on IP networks. It supports tuning of various parameters related to timing, buffers and protocols (TCP, UDP, with IPv4 and IPv6). For each test it reports the bandwidth, loss, and other parameters.
Download the Docker tar: https://hub.docker.com/r/mlabbe/iperf3
Following sections explains how to configure and deploy iPerf3 monitoring app on Catalyst 9000.
Configuration
The interface AppGigabitEthernet is configured in trunk mode, with allowed vlan 500. This configuration allows traffic in vlan 500 to send to App.
interface AppGigabitEthernet1/0/1
switchport trunk allowed vlan 500
switchport mode trunk
IP address for App container is configured as static IP address and default gateway configured to route the traffic from App. The runtime parameter required for docker container is configured under app-resource in run-opts.
app-hosting appid iperf
app-vnic AppGigabitEthernet trunk
vlan 500 guest-interface 0
guest-ipaddress 172.25.101.160 netmask 255.255.255.128
app-default-gateway 172.25.101.129 guest-interface 0
app-resource docker
run-opts 1 "--restart=unless-stopped -p 5201:5201/tcp -p 5201:5201/udp"
Deployment
a. Copy the downloaded docker tar to usbflash1
b. Install app from usbflash1
app-hosting install appid iperf package usbflash1:<path to tar file>
c. Activate the application with pre-configured resources
app-hosting activate appid iperf
d. Start the app
app-hosting start appid iperf