This is an automated email from the ASF dual-hosted git repository.
harikrishna-patnala pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/cloudstack-documentation.git
The following commit(s) were added to refs/heads/main by this push:
new 7ea83a3f Documentation for Multiple CD-ROM / ISO Support Per VM
feature (#648)
7ea83a3f is described below
commit 7ea83a3f30d05573aff5261d443928546fd9588b
Author: Daman Arora <[email protected]>
AuthorDate: Wed Jun 24 07:08:39 2026 -0400
Documentation for Multiple CD-ROM / ISO Support Per VM feature (#648)
* Add support for multiple attached ISOs per Instance in templates
documentation
* Clarify multi-ISO attachment limits and behavior in Instance documentation
* Clarify terminology for ISO attachment limits in Templates documentation
* Add images and update documentation for multi-ISO attachment in Instances
* Update documentation to correct ISO attachment configuration setting for
Instances
---
source/_static/images/attach-iso-multi.png | Bin 0 -> 132123 bytes
source/_static/images/detach-iso-multi.png | Bin 0 -> 157835 bytes
source/_static/images/instance-iso-tab-multi.png | Bin 0 -> 160969 bytes
source/adminguide/templates.rst | 41 ++++++++++++++++++++++-
4 files changed, 40 insertions(+), 1 deletion(-)
diff --git a/source/_static/images/attach-iso-multi.png
b/source/_static/images/attach-iso-multi.png
new file mode 100644
index 00000000..ef343d4c
Binary files /dev/null and b/source/_static/images/attach-iso-multi.png differ
diff --git a/source/_static/images/detach-iso-multi.png
b/source/_static/images/detach-iso-multi.png
new file mode 100644
index 00000000..cb4b2407
Binary files /dev/null and b/source/_static/images/detach-iso-multi.png differ
diff --git a/source/_static/images/instance-iso-tab-multi.png
b/source/_static/images/instance-iso-tab-multi.png
new file mode 100644
index 00000000..88f18aa3
Binary files /dev/null and b/source/_static/images/instance-iso-tab-multi.png
differ
diff --git a/source/adminguide/templates.rst b/source/adminguide/templates.rst
index 2373fea1..cd2a64fd 100644
--- a/source/adminguide/templates.rst
+++ b/source/adminguide/templates.rst
@@ -447,6 +447,14 @@ can also attach ISO images to Guest Instances. For
example, this enables
installing PV drivers into Windows. ISO images are not
hypervisor-specific.
+A single Instance can hold more than one attached ISO simultaneously, with
+each ISO appearing as its own CD-ROM drive inside the guest. This is useful,
+for example, when installing Windows on a KVM Instance that uses VirtIO disks
+- the Windows installer ISO and the VirtIO drivers ISO can both be attached
+at the same time so the installer can load the drivers without an ISO swap.
+
+|instance-iso-tab-multi.png|
+
.. _adding-an-iso:
Adding an ISO
-------------
@@ -571,10 +579,35 @@ Attaching an ISO to a Instance
#. Click the Attach ISO button. |iso.png|
-#. In the Attach ISO dialog box, select the desired ISO.
+#. In the Attach ISO dialog box, select one or more ISOs.
#. Click OK.
+|attach-iso-multi.png|
+
+The maximum number of ISOs that may be attached to an Instance is controlled
+by the configuration setting ``vm.iso.max.count`` (default ``1``); on KVM,
+the hypervisor caps it at ``2``. The first ISO attached is the bootable one;
+the Attach ISO action is hidden once the Instance reaches its limit.
+
+Detaching an ISO
+----------------
+
+#. In the left navigation, click Instances.
+
+#. Choose the Instance you want to work with.
+
+#. Click the Detach ISO button.
+
+#. In the Detach ISO dialog box, select one or more ISOs to detach.
+
+#. Click OK.
+
+|detach-iso-multi.png|
+
+When more than one ISO is attached, each entry in the dialog shows its
+CD-ROM slot label so the right one can be picked.
+
.. |sysmanager.png| image:: /_static/images/sysmanager.png
@@ -604,3 +637,9 @@ Attaching an ISO to a Instance
:alt: Resetting (removing all) permissions
.. |iso.png| image:: /_static/images/iso-icon.png
:alt: depicts adding an iso image
+.. |instance-iso-tab-multi.png| image::
/_static/images/instance-iso-tab-multi.png
+ :alt: Instance detail ISO tab listing two attached ISOs with their slot
labels
+.. |attach-iso-multi.png| image:: /_static/images/attach-iso-multi.png
+ :alt: Attach ISO dialog with multi-select dropdown and slot counter
+.. |detach-iso-multi.png| image:: /_static/images/detach-iso-multi.png
+ :alt: Detach ISO dialog showing two attached ISOs with slot labels
