Skip to content

Add VDDK support in VMware to KVM migration#640

Open
harikrishna-patnala wants to merge 4 commits into
apache:4.22from
shapeblue:vddksupport
Open

Add VDDK support in VMware to KVM migration#640
harikrishna-patnala wants to merge 4 commits into
apache:4.22from
shapeblue:vddksupport

Conversation

@harikrishna-patnala
Copy link
Copy Markdown
Member

@harikrishna-patnala harikrishna-patnala commented Apr 9, 2026

CloudStack supports an optimized VMware-to-KVM migration path using virt-v2v in vpx input mode combined with
VMware's Virtual Disk Development Kit (VDDK). This method eliminates the OVF export phase entirely and streams
disk blocks directly from the source hypervisor into the conversion pipeline, resulting in significantly faster
migration times.

Related PR apache/cloudstack#12970


📚 Documentation preview 📚: https://cloudstack-documentation--640.org.readthedocs.build/en/640/

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds administrator documentation for an optimized VMware-to-KVM migration path using virt-v2v “vpx” mode with VMware VDDK, explaining prerequisites and host/agent configuration needed to enable block-streaming conversions (avoiding OVF export).

Changes:

  • Document VDDK-based streaming workflow vs. the existing OVF-based conversion flow.
  • Add KVM host preparation steps (packages, libguestfs backend, VDDK install, EL9 symlink).
  • Document relevant CloudStack agent properties for VDDK-based conversion and operational recommendations.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst Outdated
Comment thread source/adminguide/virtual_machines/importing_vmware_vms_into_kvm.rst Outdated
| Property | Description | Default / Example |
+========================+======================================================================+=======================================================+
| ``libguestfs.backend`` | The libguestfs backend for VDDK-based conversion. | ``direct`` |
| | Must be set to ``direct`` for VDDK to work correctly. | |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

if "direct" is must for VDDK to work, should we avoid this config?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

remove this property as per the updated code.


::

mkdir -p /opt/vmware-vddk
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is this default path for vddk (expected by nbdkit)?

@kiranchavala
Copy link
Copy Markdown
Member

@blueorangutan docbuild

@blueorangutan
Copy link
Copy Markdown

@kiranchavala a Jenkins job has been kicked to build the document. I'll keep you posted as I make progress.

@blueorangutan
Copy link
Copy Markdown

QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/640. (QA-JID 515)

Copy link
Copy Markdown
Contributor

@rajujith rajujith left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Copy link
Copy Markdown
Member

@kiranchavala kiranchavala left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add installation steps for Ubuntu 24

@andrijapanicsb andrijapanicsb marked this pull request as ready for review May 15, 2026 01:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants