X-Git-Url: https://git.proxmox.com/?a=blobdiff_plain;f=qm-cloud-init.adoc;h=b275d7a79083181e61c9927cfdcc3b7ad3abf2ee;hb=eec6319859ef62472be50f9ec5d3280cf237a852;hp=8fb69a07989bd611b3fac09e938853a589954cfb;hpb=88cb121433308247bc3e8a23eef3ab8d8588a79e;p=pve-docs.git

diff --git a/qm-cloud-init.adoc b/qm-cloud-init.adoc
index 8fb69a0..b275d7a 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
@@ -60,14 +62,11 @@ image provided by Ubuntu at https://cloud-images.ubuntu.com.
 # download the image
 wget https://cloud-images.ubuntu.com/bionic/current/bionic-server-cloudimg-amd64.img
 
-# create a new VM
-qm create 9000 --memory 2048 --net0 virtio,bridge=vmbr0
+# create a new VM with VirtIO SCSI controller
+qm create 9000 --memory 2048 --net0 virtio,bridge=vmbr0 --scsihw virtio-scsi-pci
 
-# import the downloaded disk to local-lvm storage
-qm importdisk 9000 bionic-server-cloudimg-amd64.img local-lvm
-
-# finally attach the new disk to the VM as scsi drive
-qm set 9000 --scsihw virtio-scsi-pci --scsi0 local-lvm:vm-9000-disk-1
+# import the downloaded disk to the local-lvm storage, attaching it as a SCSI drive
+qm set 9000 --scsi0 local-lvm:0,import-from=/path/to/bionic-server-cloudimg-amd64.img
 ----
 
 NOTE: Ubuntu Cloud-Init images require the `virtio-scsi-pci`
@@ -84,17 +83,17 @@ the Cloud-Init data to the VM.
 qm set 9000 --ide2 local-lvm:cloudinit
 ----
 
-To be able to boot directly from the Cloud-Init image, set the
-`bootdisk` parameter to `scsi0`, and restrict BIOS to boot from disk
-only. This will speed up booting, because VM BIOS skips the testing for
-a bootable CD-ROM.
+To be able to boot directly from the Cloud-Init image, set the `boot` parameter
+to `order=scsi0` to restrict BIOS to boot from this disk only. This will speed
+up booting, because VM BIOS skips the testing for a bootable CD-ROM.
 
 ----
-qm set 9000 --boot c --bootdisk scsi0
+qm set 9000 --boot order=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