---
title: "How to run I/O workloads on OpenShift Virtualization VMs"
description: "Testing I/O performance at scale across multiple OpenShift Virtualization VMs is challenging due to scattered SSH sessions and ad hoc scripts. The fio-container harness turns multi-VM FIO into a single, repeatable container run using a Python orchestration script. It supports both pre-created VMs and on-demand provisioning (CREATE_VMS=true) for Linux guests based on Fedora or RHEL. The harness handles storage preparation, FIO installation, data pre-write, and cleanup, and collects per-VM JSON results into a single mounted directory. Results can be analyzed with provided Python scripts to generate IOPS and bandwidth graphs for comparing StorageClass configurations or cluster changes."
---

# How to run I/O workloads on OpenShift Virtualization VMs

[Red Hat](https://yomu.fyi/company/red-hat) · Elvir Kuric · Nov 3, 2026

**Type:** Tutorial

## Summary

Testing I/O performance at scale across multiple OpenShift Virtualization VMs is challenging due to scattered SSH sessions and ad hoc scripts. The fio-container harness turns multi-VM FIO into a single, repeatable container run using a Python orchestration script. It supports both pre-created VMs and on-demand provisioning (CREATE\_VMS=true) for Linux guests based on Fedora or RHEL. The harness handles storage preparation, FIO installation, data pre-write, and cleanup, and collects per-VM JSON results into a single mounted directory. Results can be analyzed with provided Python scripts to generate IOPS and bandwidth graphs for comparing StorageClass configurations or cluster changes.

## Context

Testing I/O performance at scale across multiple VMs on OpenShift Virtualization is challenging because of scattered SSH sessions, ad hoc scripts, and difficulty coordinating start times and collecting results. The fio-container harness solves this by turning multi-VM FIO into a single, repeatable container run.

## Approach / What changed

The harness uses a containerized Python orchestration script (fio-tests.py) that accepts a YAML configuration file or environment variables, connects to VMs via virtctl ssh, optionally provisions VMs (CREATE\_VMS=true), prepares storage, installs FIO, pre-writes data, runs the FIO matrix in parallel, and collects per-VM JSON results into a single mounted directory.

## Takeaways

- The fio-container harness runs the same FIO matrix across many OpenShift Virtualization guests in parallel with coordinated start, wait, and result collection, replacing hand-driven SSH sessions and ad hoc scripts.
- On-demand VM provisioning (CREATE\_VMS=true) generates ephemeral SSH keys, creates DataVolumes and VMs, waits for SSH access, and runs the full FIO workflow in a single command without requiring pre-created VMs.
- The harness supports both OS disk (–testdir) and dedicated data disk modes, and can benchmark non-OpenShift hosts (bare-metal, KVM, VMware) using SSH\_ONLY mode with a hosts.txt file.

## FAQ

### How do I provision VMs automatically for a FIO run?

Set CREATE\_VMS=true and leave HOST\_PATTERN and HOSTS empty. The container generates an ephemeral SSH key, creates DataVolumes and VMs, waits for SSH access, prepares storage, installs FIO, pre-writes data, runs the benchmark, and optionally cleans up with CLEANUP=true.

### Can I benchmark non-OpenShift hosts like bare-metal or VMware?

Use SSH\_ONLY=true and provide a hosts.txt file with hostnames or IPs, plus a fio-ssh-hosts.yaml that maps each host to its data disk device (e.g., sdb or vdb). Mount the bastion's SSH private key into the container. The namespace is ignored in SSH\_ONLY mode.

### How are FIO results collected and analyzed?

Results are per-VM JSON files collected into a single mounted directory on the bastion. The ioscale repository provides analyzer scripts (e.g., analyze\_bw\_mean\_with\_graphs.py) that generate IOPS and bandwidth graphs for single runs or comparisons across multiple runs.

**Tags:** [FIO](https://yomu.fyi/topic/fio), [OpenShift Virtualization](https://yomu.fyi/topic/openshift-virtualization), [Performance](https://yomu.fyi/topic/performance), [Red Hat OpenShift](https://yomu.fyi/topic/red-hat-openshift), [Storage](https://yomu.fyi/topic/storage)

- Source: [Red Hat](https://developers.redhat.com/articles/2026/11/03/how-run-io-workloads-openshift-virtualization-vms)
- Source URL: https://developers.redhat.com/articles/2026/11/03/how-run-io-workloads-openshift-virtualization-vms
- Ingested by Yomu: 2026-11-03T15:00:16.581Z

[Read original post](https://developers.redhat.com/articles/2026/11/03/how-run-io-workloads-openshift-virtualization-vms)
