From 78b8af75bee64836bad2f7cea2ed47b3ff2ae5e0 Mon Sep 17 00:00:00 2001 From: Dominik Csapak Date: Fri, 4 Apr 2025 14:53:45 +0200 Subject: [PATCH] qm: pve machine version: add section to explain +pveX versions and clarify what windows guests will be pinned to. Signed-off-by: Dominik Csapak Reviewed-by: Stoiko Ivanov Tested-By: Stoiko Ivanov Link: https://lore.proxmox.com/20250404125345.3244659-10-d.csapak@proxmox.com --- qm.adoc | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/qm.adoc b/qm.adoc index 4cf6472..c91ae29 100644 --- a/qm.adoc +++ b/qm.adoc @@ -173,6 +173,21 @@ This means that after a fresh start, the newest machine version supported by the QEMU binary is used (e.g. the newest machine version QEMU 8.1 supports is version 8.1 for each machine type). +PVE Machine Version ++++++++++++++++++++ + +Sometimes it's necessary to introduce new defaults or change the existing +hardware layout for new guests. For this, we have introduces an additional 'pve +machine version'. This version begins with 0 with every new QEMU machine +version, for example 'pc-q35-9.2+pve0'. When we want to change the hardware +layout or a default option, we bump it to the next one (e.g. +'pc-q35-9.2+pve1'), so older running guests are not impacted. When pinning a +guest to a specific machine, this can be omitted. In that case it defaults to +0. + +Windows guests get pinned to the most current version that is available for the +specific machine version during guest creation. + QEMU Machine Version Deprecation ++++++++++++++++++++++++++++++++