diff --git a/source/adminguide/templates.rst b/source/adminguide/templates.rst index 2373fea198..92d6078d03 100644 --- a/source/adminguide/templates.rst +++ b/source/adminguide/templates.rst @@ -447,6 +447,16 @@ 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. + +.. + SCREENSHOT NEEDED: Instance detail page -> ISO tab showing two attached ISOs + each listed with its slot label tag (e.g. "hdc", "hdd"). + .. _adding-an-iso: Adding an ISO ------------- @@ -571,10 +581,39 @@ 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. +.. + SCREENSHOT NEEDED: Multi-select Attach ISO dialog with the "ISO name (X / N)" + counter visible and one or two ISOs selected from the dropdown. + +The maximum number of ISOs that may be attached to an Instance is controlled +by the configuration setting ``vm.cdrom.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. + +.. + SCREENSHOT NEEDED: Multi-select Detach ISO dialog showing two attached ISOs + with their slot labels (e.g. "Rocky 8.4 boot (hdc)", "dummy (hdd)"). + +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