Page History

...

CloudStack users wish to have the ability functionality to add “extra configuration” metadata to a user VM during deployment in a manner that is similar across the 3 major supported hypervisors. This data could be anything ranging from instructions to install hypervisor specific required tools and drivers in each VM that is deployed from a template which does not have these tools installed. To simplify the implementation, the user will pass this additional configuration as URL encoded string that will be decoded and parsed for each hypervisor type. These additional metadata must be included in the VM instance definition.

...

Example: the following metadata can be passed to enable hugepages on KVM hosts specify guest VM NUMA topology using the <numa> element in the domain XML.

<memoryBacking>
       <hugepages/>
</memoryBacking>

...

e.g. <name>my vm </name> or <memory unit="KiB">262144</memory> or <currentMemory unit="KiB">262144</currentMemory> will throw an exception by default because this type of XML tags have been blacklisted.

• XenServer

Similar for this hypervisor, the primary configuration file of the guest VM is built by CloudStack, therefor, the additional metadata will also be parsed and append to the builder.xe vm-param-set manual page

Support for XenServer has only been added for the XAPI's 'vm-param-set' configuration using its arguments/keys as strings.  Below is a full list of all supported operations with this feature;

Simple key=value pair configurations, e.g PV-args=hvc0, is-a-template=true. Any of this these settings will override an existing setting with the new value from the use, behaviour can be prevented by blacklisting the key in the global config with the list of disallowed keysuser.

• • is-a-template, 

  • memory-static-max, 

  • memory-dynamic-max, 

  • memory-dynamic-min, 

  • memory-static-min, 

  • VCPUs-max, 

  • VCPUs-at-startup, 

  • HVM-boot-policy, 

  • order,

  • shutdown-delay, Long

  • start-delay, Long

  • ha-restart-priority, 

  • PV-bootloader-args, 

  • PV-bootloader, 

  • PV-legacy-args, 

  • PV-args, 

  • PV-ramdisk, 

  • PV-kernel, 

  • HVM-shadow-multiplier,

...