Skip to content

Commit f425907

Browse files
Strongly recommend setting vddk.lib.dir explicitly instead of relying on auto-detection
Auto-detection of the VDDK directory can pick up the wrong libraries on real hosts - leftovers from container images, a second VDDK installation, or a partially extracted tree - and the resulting conversion failures are hard to trace to the wrong library path. The text presented the property as an option for non-standard locations; it is now the recommended default, with auto-detection described as a fallback only. This also completes a sentence that was previously cut off mid-reference.
1 parent 9534364 commit f425907

1 file changed

Lines changed: 7 additions & 4 deletions

File tree

source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -250,10 +250,13 @@ stable choice for most deployments. Do not use VDDK 9.x unless the source enviro
250250
``virt-v2v`` and ``nbdkit`` package combination has been explicitly validated, because VDDK 9.x is targeted at
251251
vSphere 9 and is not the expected default for vSphere 7 or vSphere 8 environments.
252252

253-
Extract the tarball under a consistent location such as the example below. The CloudStack agent auto-detects a valid
254-
``vmware-vix-disklib-distrib`` directory when it can find one on the host. If VDDK is extracted elsewhere, or if the
255-
host has more than one VDDK installation and a specific one should be used, configure the directory explicitly with the
256-
``vddk.lib.dir`` property in ``/etc/cloudstack/agent/agent.properties`` - as explained in the
253+
Extract the tarball under a consistent location such as the example below, and **always configure that directory
254+
explicitly** with the ``vddk.lib.dir`` property in ``/etc/cloudstack/agent/agent.properties`` (see the configuration
255+
reference further down). The agent does attempt to auto-detect a ``vmware-vix-disklib-distrib`` directory when the
256+
property is not set, but relying on auto-detection is strongly discouraged: on a real host the search can pick up the
257+
wrong VDDK libraries - leftovers from container images, a second VDDK installation, or a partially extracted tree -
258+
and the resulting conversion failures are hard to trace back to the wrong library path. Treat auto-detection as a
259+
fallback only; set ``vddk.lib.dir`` on every conversion host.
257260

258261
::
259262

0 commit comments

Comments
 (0)