Skip to content

Commit ea5d826

Browse files
committed
Clarify VDDK download and version guidance
1 parent 13fe21f commit ea5d826

1 file changed

Lines changed: 17 additions & 3 deletions

File tree

source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -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+
150151
Host 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

194208
Expected layout after extraction::

0 commit comments

Comments
 (0)