Search

7.2. Block I/O Tuning

download PDF
The virsh blkiotune command allows administrators to set or display a guest virtual machine's block I/O parameters manually in the <blkio> element in the guest XML configuration.
To display current <blkio> parameters for a virtual machine:
# virsh blkiotune virtual_machine
To set a virtual machine's <blkio> parameters, refer to the following command and replace values according to your environment:

# virsh blkiotune virtual_machine [--weight number] [--device-weights string] [--config] [--live] [--current]
Parameters include:
weight
The I/O weight, within the range 100 to 1000.
device-weights
A single string listing one or more device/weight pairs, in the format of /path/to/device,weight,/path/to/device,weight. Each weight must be within the range 100-1000, or the value 0 to remove that device from per-device listings. Only the devices listed in the string are modified; any existing per-device weights for other devices remain unchanged.
config
Add the --config option for changes to take effect at next boot.
live
Add the --live option to apply the changes to the running virtual machine.

Note

The --live option requires the hypervisor to support this action. Not all hypervisors allow live changes of the maximum memory limit.
current
Add the --current option to apply the changes to the current virtual machine.

Note

See # virsh help blkiotune for more information on using the virsh blkiotune command.
Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.