@@ -147,6 +147,7 @@ This reduces disk I/O amplification, eliminates temporary staging storage, and s
147147 CloudStack does not distribute VDDK, operators must download it separately.
148148 Along with the new VDDK-based conversion method the traditional OVF-based method remains supported for environments.
149149 Operators can choose the conversion method on a per-migration basis in the UI import wizard.
150+
150151Host Prerequisites for VDDK-based Conversion
151152~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
152153
@@ -182,13 +183,26 @@ Ubuntu:
182183
183184**Step 2: Download and install VDDK **
184185
185- Download the VDDK tarball and extract it on the KVM host. The CloudStack agent will detect the VDDK library
186- directory from the extracted package layout or it can also be configured explicitly via the ``vddk.lib.dir ``
187- property in ``/etc/cloudstack/agent/agent.properties ``.
186+ Download the VDDK Linux tarball from Broadcom's VMware Virtual Disk Development Kit page:
187+ https://developer.broadcom.com/sdks/vmware-virtual-disk-development-kit-vddk/
188+
189+ For EL-based KVM hosts, use the latest available VDDK 8.x Linux tarball on EL8 hosts and the latest available
190+ VDDK 9.x Linux tarball on EL9 hosts. Ubuntu hosts should use the Linux tarball compatible with the installed
191+ ``virt-v2v `` and ``nbdkit `` packages; validate this combination before enabling VDDK-based migrations in production.
192+
193+ Extract the tarball under a consistent location such as the example below. The CloudStack agent auto-detects a valid
194+ ``vmware-vix-disklib-distrib `` directory when it can find one on the host. If VDDK is extracted elsewhere, or if the
195+ host has more than one VDDK installation and a specific one should be used, configure the directory explicitly with the
196+ ``vddk.lib.dir `` property in ``/etc/cloudstack/agent/agent.properties ``.
188197
189198::
190199
191200 mkdir -p /opt/vmware-vddk
201+
202+ # EL8 example
203+ tar -xf VMware-vix-disklib-8*.tar.gz -C /opt/vmware-vddk
204+
205+ # EL9 example
192206 tar -xf VMware-vix-disklib-9*.tar.gz -C /opt/vmware-vddk
193207
194208Expected layout after extraction::
0 commit comments