summaryrefslogtreecommitdiff
path: root/doc/rtd/topics/datasources/ovf.rst
blob: d6eb75da962afe67a9befeac68c18fdb3d999f5f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
.. _datasource_ovf:

OVF
===

The OVF Datasource provides a datasource for reading data from
on an `Open Virtualization Format
<https://en.wikipedia.org/wiki/Open_Virtualization_Format>`_ ISO
transport.

For further information see a full working example in cloud-init's
source code tree in doc/sources/ovf

Configuration
-------------
The following configuration can be set for the datasource in system
configuration (in `/etc/cloud/cloud.cfg` or `/etc/cloud/cloud.cfg.d/`).

The settings that may be configured are:

 * disable_vmware_customization: disable or enable the vmware customization
   based on vmware customization files. (default: True)
 * allow_raw_data: enable or disable the vmware customization based on raw
   cloud-init data including metadata and userdata. (default: True)
 * vmware_cust_file_max_wait: the maximum amount of clock time in seconds that
   should be spent waiting for vmware customization files. (default: 15)


On VMware platforms, VMTools use is required for OVF datasource configuration
settings as well as vCloud and vSphere admin configuration. User could change
the VMTools configuration options with command::

    vmware-toolbox-cmd config set <section> <key> <value>

The following VMTools configuration options affect cloud-init's behavior on a booted VM:
 * a: [deploypkg] enable-custom-scripts
      If this option is absent in VMTools configuration, the custom script is
      disabled by default for security reasons. Some VMware products could
      change this default behavior (for example: enabled by default) via
      customization specification settings.

VMWare admin can refer to (https://github.com/canonical/cloud-init/blob/main/cloudinit/sources/helpers/vmware/imc/config.py) and set the customization specification settings.

For more information, see `VMware vSphere Product Documentation <https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.vm_admin.doc/GUID-9A5093A5-C54F-4502-941B-3F9C0F573A39.html>`_ and specific VMTools parameters consumed.

.. vi: textwidth=79