[pve-devel] [PATCH docs] cloud init: mention that serial display might not work for all images

[Fiona Ebner]

Example from the community forum:
https://forum.proxmox.com/threads/112225/

Signed-off-by: Fiona Ebner <f.ebner at proxmox.com>
---
 qm-cloud-init.adoc | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/qm-cloud-init.adoc b/qm-cloud-init.adoc
index 8fb69a0..8363f10 100644
--- a/qm-cloud-init.adoc
+++ b/qm-cloud-init.adoc
@@ -33,8 +33,10 @@ Cloud-Init data.
 
 {pve} generates an ISO image to pass the Cloud-Init data to the VM. For
 that purpose, all Cloud-Init VMs need to have an assigned CD-ROM drive.
-Also many Cloud-Init images assume to have a serial console, so it is
-recommended to add a serial console and use it as display for those VMs.
+Usually, a serial console should be added and used as a display. Many Cloud-Init
+images rely on this, it is a requirement for OpenStack. However, other images
+might have problems with this configuration. Switch back to the default display
+configuration if using a serial console doesn't work.
 
 
 Preparing Cloud-Init Templates
@@ -93,8 +95,9 @@ a bootable CD-ROM.
 qm set 9000 --boot c --bootdisk scsi0
 ----
 
-Also configure a serial console and use it as a display. Many Cloud-Init
-images rely on this, as it is an requirement for OpenStack images.
+For many Cloud-Init images, it is required to configure a serial console and use
+it as a display. If the configuration doesn't work for a given image however,
+switch back to the default display instead.
 
 ----
 qm set 9000 --serial0 socket --vga serial0
-- 
2.30.2