From fd4689ae283d16d81b773ecde42ed8df94d00f4d Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Wed, 7 Jan 2026 17:02:40 +0530 Subject: [PATCH 1/3] vm: note on skip forced disk controllers uefi secure boot Related https://github.com/apache/cloudstack/pull/11750 Signed-off-by: Abhishek Kumar --- source/adminguide/virtual_machines.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/source/adminguide/virtual_machines.rst b/source/adminguide/virtual_machines.rst index 49ab2b6fbc..1b59d4cb1e 100644 --- a/source/adminguide/virtual_machines.rst +++ b/source/adminguide/virtual_machines.rst @@ -175,6 +175,18 @@ To create an Instance from a Template: specified at the Instance or Template level. For an existing Instance its settings can be updated while it is in stopped state by admin. + **KVM** + + Instances running on the KVM hypervisor with UEFI Secure Boot have disk controllers automatically enforced: + + - Windows OS instances use SATA + - Non-Windows OS instances use VirtIO + + Starting with 4.20.3 and later, this behavior can be overridden by setting the following template or instance detail: + + ``skip.force.disk.controller = true`` + + When set, disk controller enforcement is skipped and the controllers defined by template/instance details are used. Install Required Tools and Drivers ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ From e12b0393c0917904ac50f0625ef4320140b12ead Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Mon, 16 Feb 2026 18:16:45 +0530 Subject: [PATCH 2/3] Apply suggestion from @shwstppr --- source/adminguide/virtual_machines.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/adminguide/virtual_machines.rst b/source/adminguide/virtual_machines.rst index 1b59d4cb1e..bd65ddb068 100644 --- a/source/adminguide/virtual_machines.rst +++ b/source/adminguide/virtual_machines.rst @@ -186,7 +186,7 @@ To create an Instance from a Template: ``skip.force.disk.controller = true`` - When set, disk controller enforcement is skipped and the controllers defined by template/instance details are used. + When set to true, disk controller enforcement is skipped, and the controllers defined by template/instance details are used. If the detail is added at both template and instance level, the instance detail takes precedence. Install Required Tools and Drivers ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ From 36decf43a2b0da30102b92f7a164681ca373e90e Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Mon, 16 Feb 2026 18:18:06 +0530 Subject: [PATCH 3/3] Apply suggestions from code review Co-authored-by: Suresh Kumar Anaparti --- 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 bd65ddb068..3e67dd8279 100644 --- a/source/adminguide/virtual_machines.rst +++ b/source/adminguide/virtual_machines.rst @@ -177,12 +177,12 @@ To create an Instance from a Template: **KVM** - Instances running on the KVM hypervisor with UEFI Secure Boot have disk controllers automatically enforced: + Instances running on the KVM hypervisor with UEFI Secure Boot have disk controllers automatically enforced as following: - Windows OS instances use SATA - Non-Windows OS instances use VirtIO - Starting with 4.20.3 and later, this behavior can be overridden by setting the following template or instance detail: + Starting with 4.20.3 and later, this behavior can be overridden by setting the following template or instance detail to true: ``skip.force.disk.controller = true``