Chapter 5. Converting virtual machines to the Q35 machine type
In RHEL 10, the i440fx machine type is deprecated, and will be removed in a future major version of RHEL. Therefore, Red Hat recommends converting your virtual machines (VMs) that use i440fx to use the q35 machine type instead.
In addition, using q35 provides additional benefits in comparison to i440fx, such as Advanced Host Controller Interface (AHCI) and virtual Input-output memory management unit (vIOMMU) emulation.
Note that you can also convert VM configurations that you have not defined yet.
Changing a machine type of a VM is similar to changing the motherboard on a physical machine. As a consequence, converting the machine type of a VM from i440fx to q35 might, in some cases, cause problems with the functionality of the guest operating system.
Prerequisites
A VM on your RHEL 10 host is using the
i440fxmachine type. To confirm this, use the following command:virsh dumpxml <vm-name> | grep machine
# virsh dumpxml <vm-name> | grep machineCopy to Clipboard Copied! Toggle word wrap Toggle overflow Example output for an
i440fxVM:<type arch='x86_64' *machine='pc-i440fx-10.0.0'*>hvm</type>
<type arch='x86_64' *machine='pc-i440fx-10.0.0'*>hvm</type>Copy to Clipboard Copied! Toggle word wrap Toggle overflow You have backed up the original configuration of the VM, so you can use it for conversion and disaster recovery, if necessary.
virsh dumpxml <vm-name> > <vm-name>-backup.xml
# virsh dumpxml <vm-name> > <vm-name>-backup.xmlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Procedure
For undefined VMs, do the following:
Adjust the configuration of the VM to use Q35. As the source configuration, use the backup file that you created previously.
cat <vm-name>-backup.xml | virt-xml --edit --convert-to-q35 > <vm-name-q35>.xml
# cat <vm-name>-backup.xml | virt-xml --edit --convert-to-q35 > <vm-name-q35>.xmlCopy to Clipboard Copied! Toggle word wrap Toggle overflow Define the VM.
virsh define <vm-name-q35>.xml
# virsh define <vm-name-q35>.xmlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
For defined VMs, do the following:
Adjust the configuration of the VM to use Q35.
virt-xml <vm-name> --edit --convert-to-q35
# virt-xml <vm-name> --edit --convert-to-q35Copy to Clipboard Copied! Toggle word wrap Toggle overflow If the VM is running, shut it down.
virsh shutdown <vm-name>
# virsh shutdown <vm-name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Verification
Display the machine type of the VM.
virsh dumpxml <vm-name> | grep machine <type arch='x86_64' machine='q35'>hvm</type># virsh dumpxml <vm-name> | grep machine <type arch='x86_64' machine='q35'>hvm</type>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Start the VM and check that you can log in to the guest operating system.
Troubleshooting
If changing the machine type has made the VM not functional, define a new VM based on the backed-up configuration.
virsh define <vm-name>-backup.xml
# virsh define <vm-name>-backup.xmlCopy to Clipboard Copied! Toggle word wrap Toggle overflow