Skip to content

Commit ee33b7b

Browse files
committed
Add note for userdata limits for systemvm
1 parent a06d06d commit ee33b7b

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed

source/adminguide/systemvm.rst

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -984,6 +984,22 @@ To enable and configure User Data for System VMs:
984984
Only the default root administrator can set the global settings for System VM User Data.
985985
The associated User Data entries must also be created under the default root administrator account.
986986
987+
.. note::
988+
The size of the User Data that can be sent is dependent on the
989+
hypervisor. This is because of the way it is provided to the system VM.
990+
The user data is compressed and encoded in base64 format when it is
991+
provided to the system VM along with other system VM configurations.
992+
993+
- KVM: Uses QEMU Guest Agent to write configuration directly to
994+
``/var/cache/cloud/cmdline`` inside the VM
995+
996+
- XenServer (HVM): Stores in XenStore key ``vm-data/cloudstack/init``
997+
998+
- VMware: Sets as ``machine.id`` extraConfig parameter
999+
1000+
The operator needs to ensure that the user data is within the limits
1001+
of the hypervisor.
1002+
9871003
Troubleshoot networks from System VMs
9881004
-------------------------------------
9891005
.. |run-diagnostics-icon.png| image:: /_static/images/run-diagnostics-icon.png

0 commit comments

Comments
 (0)