In dit document wordt beschreven hoe u iPerf kunt gebruiken op switches uit de Catalyst 9000-reeks om bandbreedtetests uit te voeren.
Cisco raadt kennis van de volgende onderwerpen aan:
De informatie in dit document is gebaseerd op de volgende software- en hardware-versies:
Opmerking: raadpleeg de toepasselijke configuratiehandleiding voor de opdrachten die worden gebruikt om deze functies op andere Cisco-platforms in te schakelen.
De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.
Dit document kan ook worden gebruikt voor de volgende hardware- en softwareversies:
iPerf3 is een tool voor actieve metingen van de maximaal haalbare bandbreedte op IP-netwerken. iPerf gebruikt de verschillende capaciteiten van TCP en UDP om statistieken over bandbreedte te verstrekken.
Opmerking: Raadpleeg de officiële documentatie van iPerf voor meer informatie over deze tool.
C9300-AC1#dir usbflash1:/
Directory of usbflash1:/
12 -rw- 6043136 Jan 26 2023 21:55:35 +00:00 iPerf.tar
2. Kies een VLAN of configureer een nieuw voor iPerf-connectiviteit:
C9300-AC1(config)#interface vlan 10
C9300-AC1(config-if)#ip add 192.168.10.11 255.255.255.0
3. Configureer de AppGigabitEthernet-interface:
C9300-AC1(config)#int Ap1/0/1
C9300-AC1(config-if)#switchport mode trunk
4. iPerf-docker configureren en koppelen aan een VLAN:
C9300-AC1(config)#app-hosting appid iPerf
C9300-AC1(config-app-hosting)#app-vnic AppGigabitEthernet trunk
C9300-AC1(config-config-app-hosting-trunk)#vlan 10 guest-interface 0
C9300-AC1(config-config-app-hosting-vlan-access-ip)#guest-ipaddress 192.168.10.21 netmask 255.255.255.0
5. Configureer als een standaard gateway voor de toepassing het IP van de SVI die u hebt gekozen voor iPerf-connectiviteit:
C9300-AC1(config)#app-hosting appid iPerf
C9300-AC1(config-app-hosting)#app-default-gateway 192.168.10.11 guest-int
6. Start de IOX-service en controleer of deze zich in de staat bevindt running met de opdracht show iox-service privileged EXEC:
C9300-AC1(config)#iox
C9300-AC1(config)#do show iox-service
IOx Infrastructure Summary:
---------------------------
IOx service (CAF) : Running
IOx service (HA) : Running
IOx service (IOxman) : Not Ready
IOx service (Sec storage) : Not Running
Libvirtd 5.5.0 : Running
Dockerd 18.03.0 : Running
Sync Status : Disabled
7. Installeer de iPerf-toepassing vanaf de SSD en controleer of deze is geïmplementeerd:
C9300-AC1#app-hosting install appid iPerf package usbflash1:iPerf.tar
Installing package 'usbflash1:iPerf.tar' for 'iPerf'. Use 'show app-hosting list' for progress.
C9300-AC1#show app-hosting list
App id State
---------------------------------------------------------
iPerf DEPLOYED
8. Activeer en start de iPerf-toepassing:
C9300-AC1#app-hosting activate appid iPerf
iPerf activated successfully
Current state is: ACTIVATED
C9300-AC1#show app-hosting list
App id State
---------------------------------------------------------
iPerf ACTIVATED
C9300-AC1#app-hosting start appid iPerf
iPerf started successfully
Current state is: RUNNING
C9300-AC1#
C9300-AC1#show app-hosting list
App id State
---------------------------------------------------------
iPerf RUNNING
Opmerking: Als iPerf eenmaal in runningstaat is, wordt het standaard als server uitgevoerd.
Om de toepassingsdetails te verifiëren, kunt u de opdracht show app-hosting utilization appid [app-name] privileged EXEC gebruiken:
C9300-AC1#show app-hosting detail appid iPerf
App id : iPerf
Owner : iox
State : RUNNING
Application
Type : docker
Name : mlabbe/iperf3
Version : latest
Description :
Author :
Path : usbflash1:iPerf.tar
URL Path :
Activated profile name : default
Resource reservation
Memory : 409 MB
Disk : 10 MB
CPU : 1480 units
CPU-percent : 20 %
VCPU : 1
Platform resource profiles
Profile Name CPU(unit) Memory(MB) Disk(MB)
--------------------------------------------------------------
Attached devices
Type Name Alias
---------------------------------------------
serial/shell iox_console_shell serial0
serial/aux iox_console_aux serial1
serial/syslog iox_syslog serial2
serial/trace iox_trace serial3
Network interfaces
---------------------------------------
eth0:
MAC address : 52:54:dd:d2:df:af
IPv4 address : 192.168.10.21
IPv6 address : ::
Network name : mgmt-bridge-v10
Docker
------
Run-time information
Command :
Entry-point : iperf3 -s
Run options in use :
Package run options :
Application health information
Status : 0
Last probe error :
Last probe output :
Om het gebruik van de toepassing te controleren, kunt u de opdracht show app-hosting utilization appid [app-name]privileged EXEC gebruiken:
C9300-AC1# show app-hosting utilization appid iPerf
Application: iPerf
CPU Utilization:
CPU Allocation: 1480 units
CPU Used: 0.00 %
CPU Cores:
Memory Utilization:
Memory Allocation: 409 MB
Memory Used: 1064 KB
Disk Utilization:
Disk Allocation: 10 MB
Disk Used: 0.00 MB
Om details in de toepassingscontainer te verifiëren, kunt u de opdracht app-hosting connect appid [app-name] sessionprivileged EXEC gebruiken:
C9300-AC1#app-hosting connect appid iPerf session
/ $
/ $ #Verify IP address assigned
/ $
/ $ ifconfig
eth0
inet addr:192.168.10.21 Bcast:0.0.0.0 Mask:255.255.255.0
/ $
/ $ #Verify iPerf is running as server
/ $
/ $ ps
PID USER TIME COMMAND
1 iperf 0:00 iperf3 -s
390 iperf 0:00 /bin/sh
398 iperf 0:00 ps
/ $
De methoden voor het uitvoeren van bandbreedtetests die in dit document worden uitgelegd, zijn gebaseerd op het onderstaande netwerkdiagram:

Opmerking: configuratievoorbeelden uit sectie iPerf-installatie zijn afkomstig uit dezelfde laboratoriumomgeving.
Toewijzing van IP-adressen voor apparaten hierboven:
| C9300-AC1 |
C9300-AC2 |
| SVI 192 168 10 11 iPERF 192 168 10 21 |
SVI 192 168 10 12 iPERF 192 168 10 22 |
Opmerking: alle apparaten die in deze voorbeelden worden gebruikt, bevinden zich in hetzelfde VLAN-domein, VLAN 10.
In dit voorbeeld wordt de bandbreedte van C9300-AC1 naar C9300-AC2 gemeten. C9300-AC1 is de klant.
1. Voer de opdracht uit app-hosting connect appid iPerf sessionom de prompt van de toepassingscontainer in te voeren:
C9300-AC1#app-hosting connect appid iPerf session
/ $
2. Zodra u in de prompt van de toepassingscontainer bent, gebruikt u de opdracht iperf3 -c om de bandbreedtetest te starten:
/ $ iperf3 -c 192.168.10.22
Connecting to host 192.168.10.22, port 5201
[ 5] local 192.168.10.21 port 34906 connected to 192.168.10.22 port 5201
[ ID] Interval Transfer Bitrate Retr Cwnd
[ 5] 0.00-1.00 sec 114 MBytes 955 Mbits/sec 2 833 KBytes
[ 5] 1.00-2.00 sec 113 MBytes 947 Mbits/sec 3 923 KBytes
[ 5] 2.00-3.00 sec 111 MBytes 934 Mbits/sec 77 974 KBytes
[ 5] 3.00-4.00 sec 113 MBytes 945 Mbits/sec 1 1.03 MBytes
[ 5] 4.00-5.00 sec 112 MBytes 940 Mbits/sec 109 1.08 MBytes
[ 5] 5.00-6.00 sec 111 MBytes 931 Mbits/sec 395 820 KBytes
[ 5] 6.00-7.00 sec 111 MBytes 933 Mbits/sec 198 882 KBytes
[ 5] 7.00-8.00 sec 112 MBytes 944 Mbits/sec 2 970 KBytes
[ 5] 8.00-9.00 sec 111 MBytes 933 Mbits/sec 9 1.02 MBytes
[ 5] 9.00-10.00 sec 111 MBytes 933 Mbits/sec 524 1.04 MBytes
- - - - - - - - - - - - - - - - - - - - - - - - -
[ ID] Interval Transfer Bitrate Retr
[ 5] 0.00-10.00 sec 1.09 GBytes 940 Mbits/sec 1320 sender
[ 5] 0.00-10.01 sec 1.09 GBytes 937 Mbits/sec receiver
iperf Done.
/ $
3. Typ na afloop van de test om terug exitte keren naar switch CLI.
Opmerking: Aangezien iPerf standaard als server wordt uitgevoerd, is er geen verdere opdracht nodig aan de serverzijde.
In dit voorbeeld wordt de bandbreedte van Host-A naar C9300-AC2 (iPerf-server) gemeten.
C:\Users\user\Downloads\iperf-3.1.3-win64\iperf-3.1.3-win64>iperf3.exe
3. Gebruik vanaf uw pc de optie c-c. Dit geeft aan dat de pc de client is:
C:\Users\user\Downloads\iperf-3.1.3-win64\iperf-3.1.3-win64>iperf3.exe -c 192.168.10.22
Connecting to host 192.168.10.22, port 5201
[ 4] local 192.168.10.2 port 56009 connected to 192.168.10.22 port 5201
[ ID] Interval Transfer Bandwidth
[ 4] 0.00-1.00 sec 109 MBytes 916 Mbits/sec
[ 4] 1.00-2.00 sec 0.00 Bytes 0.00 bits/sec
[ 4] 2.00-3.00 sec 0.00 Bytes 0.00 bits/sec
[ 4] 3.00-4.00 sec 93.6 MBytes 786 Mbits/sec
[ 4] 4.00-5.00 sec 15.1 MBytes 127 Mbits/sec
[ 4] 5.00-6.02 sec 0.00 Bytes 0.00 bits/sec
[ 4] 6.02-7.00 sec 78.2 MBytes 666 Mbits/sec
[ 4] 7.00-8.00 sec 42.9 MBytes 360 Mbits/sec
[ 4] 8.00-9.00 sec 0.00 Bytes 0.00 bits/sec
[ 4] 9.00-10.00 sec 49.4 MBytes 414 Mbits/sec
- - - - - - - - - - - - - - - - - - - - - - - - -
[ ID] Interval Transfer Bandwidth
[ 4] 0.00-10.00 sec 388 MBytes 326 Mbits/sec sender
[ 4] 0.00-10.00 sec 388 MBytes 326 Mbits/sec receiver
iperf Done.
Tip: voor de traditionele methode moet u 2 pc's gebruiken, één als server en één als client. Voor de pc die als server fungeert, gebruikt u de opdracht iperf3.exe -s.
| Revisie | Publicatiedatum | Opmerkingen |
|---|---|---|
3.0 |
29-Jul-2026
|
Hercertificering - bijgewerkte opmaak. |
2.0 |
10-Mar-2023
|
Embedded video versie van dit |
1.0 |
02-Feb-2023
|
Eerste vrijgave |