From a31b237a74a9145fe1f24221def56e8ec095ce24 Mon Sep 17 00:00:00 2001 From: nvazquez Date: Wed, 10 Sep 2025 22:43:55 -0300 Subject: [PATCH 1/2] Add documentation for Instance setting for machine type on KVM --- source/adminguide/virtual_machines.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/source/adminguide/virtual_machines.rst b/source/adminguide/virtual_machines.rst index 545e44d20a..eff00ba0e9 100644 --- a/source/adminguide/virtual_machines.rst +++ b/source/adminguide/virtual_machines.rst @@ -1169,6 +1169,11 @@ An example list of settings as well as their possible values are shown on the im |vm-settings-kvm-guest-cpu-model.png| (KVM guest CPU model, available for root admin since 4.20.1.0) +CloudStack supports setting the guest machine type for KVM instances since 4.22.0 by the Instance setting 'kvm.guest.os.machine.type'. The list of supported machine types will depend on the QEMU version on the Instance KVM host. + +.. note:: + For Ubuntu 24 KVM hosts (and other distros containing QEMU 8.x versions) setting the machine type for Windows VMs to 'pc-i440fx-8.0' mitigates an issue in which the instance UUID could not be obtained from within the guest VM through the command: `wmic path win32_computersystemproduct get uuid`. + Instance Settings for Virtual Trusted Platform Module (vTPM) ----------------------------- From fa649b98de5fc6499cb6e8932345c2612aed82b5 Mon Sep 17 00:00:00 2001 From: Nicolas Vazquez Date: Tue, 16 Sep 2025 07:21:39 -0300 Subject: [PATCH 2/2] Apply suggestions from code review Co-authored-by: Pearl Dsilva --- source/adminguide/virtual_machines.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/adminguide/virtual_machines.rst b/source/adminguide/virtual_machines.rst index eff00ba0e9..63b5a57de6 100644 --- a/source/adminguide/virtual_machines.rst +++ b/source/adminguide/virtual_machines.rst @@ -1169,10 +1169,10 @@ An example list of settings as well as their possible values are shown on the im |vm-settings-kvm-guest-cpu-model.png| (KVM guest CPU model, available for root admin since 4.20.1.0) -CloudStack supports setting the guest machine type for KVM instances since 4.22.0 by the Instance setting 'kvm.guest.os.machine.type'. The list of supported machine types will depend on the QEMU version on the Instance KVM host. +CloudStack supports setting the guest machine type for KVM instances since 4.22.0 by using the instance setting 'kvm.guest.os.machine.type'. The list of supported machine types will depend on the QEMU version on the KVM host. .. note:: - For Ubuntu 24 KVM hosts (and other distros containing QEMU 8.x versions) setting the machine type for Windows VMs to 'pc-i440fx-8.0' mitigates an issue in which the instance UUID could not be obtained from within the guest VM through the command: `wmic path win32_computersystemproduct get uuid`. + For Ubuntu 24 KVM hosts (and other distros containing QEMU 8.x versions) setting the machine type for Windows VMs to 'pc-i440fx-8.0' mitigates the issue which prevents retrieving the instance UUID from within the guest VM via: `wmic path win32_computersystemproduct get uuid`. Instance Settings for Virtual Trusted Platform Module (vTPM) -----------------------------