Application Hosting on Cisco Catalyst Switches

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.

Code Snippet
Copyinterface 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.

Code Snippet
Copyapp-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

Code Snippet
Copyapp-hosting install appid iperf package usbflash1:<path to tar file>

c. Activate the application with pre-configured resources

Code Snippet
Copyapp-hosting activate appid iperf

d. Start the app

Code Snippet
Copyapp-hosting start appid iperf
Next