harikrishna-patnala commented on code in PR #648: URL: https://github.com/apache/cloudstack-documentation/pull/648#discussion_r3186115128
########## source/adminguide/templates.rst: ########## @@ -571,10 +581,60 @@ 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 number of CD-ROM drives a single Instance may have is bounded by the +global setting ``vm.cdrom.max.count`` (default ``1``) and by the hypervisor's +own limit. The effective maximum for an Instance is the smaller of the two. + +On KVM with the default ``i440fx`` machine type, the IDE bus has four device +slots in total - the root disk takes one, and the remaining usable slots map +to ``hdc`` and ``hdd``, giving a practical maximum of **2** CD-ROMs per +Instance regardless of how high ``vm.cdrom.max.count`` is set. + +When multiple ISOs are attached, the first one occupies the bootable +``hdc`` slot and is the one the firmware will try to boot from first. +Subsequent attachments are placed in the next free slots (``hdd``, etc.). +The Attach ISO action is hidden from the Instance's action menu once the +Instance has reached its effective maximum. + +The same multi-ISO behavior is available via the ``attachIso`` API. Each +call attaches one ISO into the next free slot; attempting to attach the +same ISO twice, or to attach beyond the effective maximum, returns an +error. + +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 Review Comment: please add all relevant screenshots ########## source/adminguide/templates.rst: ########## @@ -571,10 +581,60 @@ 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 number of CD-ROM drives a single Instance may have is bounded by the Review Comment: I feel this is too much information for an admin at this stage in the UI. We can simplify this overall content without having to explain all details, for example no need of API details and how it actually works in the API flow here and even we can simplify the explanation of maximum supported level details. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
