Ubuntu Server Guide

Upgrading the machine type
If you are unsure what this is, you might consider this as buying (virtual) Hardware of the same spec but
a newer release date. You are encouraged in general and might want to update your machine type of an
existing defined guests in particular to:
• to pick up latest security fixes and features
• continue using a guest created on a now unsupported release
In general it is recommended to update machine types when upgrading qemu/kvm to a new major version.
But this can likely never be an automated task as this change is guest visible. The guest devices might
change in appearance, new features will be announced to the guest and so on. Linux is usually very good
at tolerating such changes, but it depends so much on the setup and workload of the guest that this has to
be evaluated by the owner/admin of the system. Other operating systems where known to often have severe
impacts by changing the hardware. Consider a machine type change similar to replacing all devices and
firmware of a physical machine to the latest revision - all considerations that apply there apply to evaluating
a machine type upgrade as well.
99

---

As usual with major configuration changes it is wise to back up your guest definition and disk state to be
able to do a rollback just in case. There is no integrated single command to update the machine type via
virsh or similar tools. It is a normal part of your machine definition. And therefore updated the same way
as most others.
First shutdown your machine and wait until it has reached that state.
v i r s h shutdown 
# w a i t
v i r s h l i s t −−i n a c t i v e
# s h o u l d now l i s t your machine a s ” s h u t o f f ”
Then edit the machine definition and find the type in the type tag at the machine attribute.
v i r s h e d i t 
hvm
Change this to the value you want. If you need to check what types are available via “-M ?” Note that while
providing upstream types as convenience only Ubuntu types are supported. There you can also see what the
current default would be. In general it is strongly recommended that you change to newer types if possible
to exploit newer features, but also to benefit of bugfixes that only apply to the newer device virtualization.
kvm −M ?
# l i s t s machine types , e . g .
pc−i 4 4 0 f x −x e n i a l
Ubuntu 1 6 . 0 4 PC ( i440FX + PIIX , 1 9 9 6 ) ( d e f a u l t )
. . .
pc−i 4 4 0 f x −b i o n i c
Ubuntu 1 8 . 0 4 PC ( i440FX + PIIX , 1 9 9 6 ) ( d e f a u l t )
. . .
After this you can start your guest again. You can check the current machine type from guest and host
depending on your needs.
v i r s h s t a r t 
# check from host , v i a dumping t h e a c t i v e xml d e f i n i t i o n
v i r s h dumpxml  | x m l l i n t −−xpath ” s t r i n g ( / / domain / o s / type /
@machine ) ” −
# o r from t h e g u e s t v i a dmidecode ( i f s u p p o r t e d )
sudo dmidecode | g r e p Product −A 1
Product Name : Standard PC ( i440FX + PIIX , 1 9 9 6 )
V e r s i o n : pc−i 4 4 0 f x −b i o n i c
If you keep non-live definitions around - like xml files - remember to update those as well.