Loading...

We've detected that your browser language is Chinese. Would you like to visit our Chinese website? [ Dismiss ]
By: Emma

XVA is XenServer’s native VM export format. If you’re moving to VMware, ESXi won’t recognize it — you’ll need to convert it to VMDK first. This guide walks through four ways to do that, plus how to fix the boot and driver issues that often come up after migration.

What Is XVA and Why Convert It to VMDK

An XVA file is the standard export format for Citrix XenServer and XCP-ng. It packages the VM’s VHD disks and an XML configuration file into a single tar archive.

VMDK is VMware’s virtual disk format. ESXi and vSphere require it to run virtual machines. The VMX file works alongside it as the configuration file that defines the VM’s hardware settings.

Because XVA is a packaged archive and VMDK is a flat disk image, VMware cannot mount or boot an XVA file directly. Converting the disk format is the only way to get a XenServer VM running on ESXi.

This conversion comes up most often during platform migrations, data center consolidations, and disaster recovery setups where the two sites run different hypervisors.

convert xva to vmdk

Before You Start: Pre-Conversion Checklist

Successful migrations depend more on how the source VM is prepared than on the conversion tool itself. Skipping these steps often results in non-bootable systems or “Inaccessible Boot Device” errors.

  • Remove Snapshots: Delete or commit all snapshots on the source VM before exporting. If you are unsure how to do this, refer to the steps for removing snapshots in VMware before proceeding.
  • Uninstall XenServer Tools: This is the most critical step. Citrix VM Tools and XenServer PV drivers are designed specifically for the Xen hypervisor. Leaving them installed will likely cause a BSOD or kernel panic when the VM first boots on VMware.
  • Verify Target Disk Space: XVA files are compressed, so the resulting VMDK will be larger once extracted. The final size depends on the provisioning type you choose during import — thin provisioning allocates space on demand, while thick provisioning reserves the full disk size upfront.
  • Check OS Compatibility: Confirm that your guest OS is supported on the target ESXi host. Older versions of Windows or Linux may require you to select a lower VM hardware compatibility version during VM creation in vSphere.

Convert XVA to VMDK Using xva-img + qemu-img on Linux

The manual method for Linux users involves breaking open the XVA archive and rebuilding the disk image from its component parts. This approach gives you the most control and works well for XCP-ng or standalone XenServer hosts.

Export and Convert

Start on the XenServer host and work through to a raw disk image before touching anything on the VMware side.

Step 1: Export the VM from XenServer: Run the following command directly on the XenServer or XCP-ng host to export the VM as an .xva file.

bash
sudo yum install qemu-img

Step 2: Extract the XVA archive: XVA files are tar archives containing 1MB disk chunks. Extract the contents into a working directory.

bash
mkdir xva_out && tar -xf vm.xva -C xva_out

Step 3: Rebuild the raw disk: Use xva-img to reassemble the extracted chunks into a single raw disk image. The chunks are stored in a subdirectory named after the disk reference, such as Ref:1.

bash
xva-img -p disk-export xva_out/Ref\:1/ vm.raw

Step 4: Verify the raw image: Confirm the output file was created correctly before proceeding.

bash
qemu-img info vm.raw

Step 5: Convert the raw disk to VMDK: Use qemu-img to produce a VMDK file from the raw image.

bash
qemu-img convert -f raw -O vmdk vm.raw output.vmdk

Import to VMware

VMDK ready, the remaining steps move to the VMware environment.

Step 6: Upload to VMware: Transfer the .vmdk file to your ESXi datastore using the vSphere Client or SCP. Then create a new VM and select Use an existing virtual disk to attach it.

Note: The VMDK produced by qemu-img is a monolithic flat file — a single, pre-allocated disk image that ESXi may not handle as efficiently as its native formats. If you experience performance issues, use vmkfstools on the ESXi host to convert it to thin or thick provisioned format.

Convert XVA to VMDK on Windows Using XenConvert

XenConvert is a legacy Citrix utility designed for moving virtual appliances between formats. While it is no longer actively updated, it remains an option for Windows-based admins who prefer a graphical interface over the command line.

XenConvert version 2.3.1 or 2.3.2 is required for this workflow. Versions 2.4 and newer removed XVA-to-OVF conversion support, making them unsuitable for this migration path.

xenconvert

Export and Convert

Begin by exporting the VM from XenServer and running it through XenConvert to produce a usable disk file.

  1. In XenCenter, right-click the VM you want to export and select Export. Choose XVA as the export format, specify a destination path, and click Export to start. Alternatively, run the following on the XenServer host:
    bash
    xe vm-export vm=<VM_NAME> filename=vm.xva
  2. Open XenConvert. Under Source, set the type to Xen Virtual Appliance and browse to the .xva file you exported. Under Destination, select OVF as the output format and choose a destination folder.
  3. Click Convert to start the process. XenConvert will produce a folder containing an OVF file and a .vhd disk image.

xenconvert export files

Fix the Disk Adapter Type

Before importing the disk, the descriptor file needs one manual edit to prevent a boot failure on VMware.

  1. Open the .vhd file in WinImage, select File > Save As, and change the output format to VMDK.
    Note: The VMDK produced by WinImage may not be fully compatible with ESXi. If the disk fails to attach or boot, use qemu-img to re-convert the .vhd directly: qemu-img convert -f vpc -O vmdk input.vhd output.vmdk
  2. Download the .vmdk descriptor file — the smaller of the two .vmdk files — open it in a text editor, and set the adapter type to:
    ddb.adapterType = "lsilogic"
  3. Upload the modified descriptor back to the datastore and overwrite the original.

Import to VMware

With the descriptor corrected, the disk is ready to be uploaded and attached to a new VM.

  1. Copy the .vmdk file to your ESXi datastore using the vSphere Client datastore browser, WinSCP, or SCP.
  2. Create a new VM in vCenter, remove the default virtual disk, and attach your uploaded .vmdk as an existing disk.

Migrate XenServer VM to VMware via OVA

Using the OVA (Open Virtualization Appliance) format is often the most efficient way to move a VM between hypervisors. Since both Citrix and VMware support the OVF standard, this method requires no separate V2V conversion tooling.

Export from XenServer

The first step is generating the OVA file from your existing XenServer or XCP-ng environment.

  1. Export from XenCenter: In XenCenter or Xen Orchestra, right-click your VM and select Export. Change the output format from the default XVA to OVA.

Import to VMware

Once the OVA file is ready, the rest of the process is handled entirely within vSphere.

  1. Access vSphere: Log in to your VMware vSphere Client or vCenter Server.vSphere host client
  2. Initiate Import: Right-click your target cluster or host and select Deploy OVF Template.deploy a new ovf template
  3. Upload the File: Select the OVA file exported from XenServer. The vSphere import wizard extracts the packaged VMDK and deploys it to your target datastore automatically.choose and upload a file
  4. Finalize Hardware: Once the import completes, review the VM settings. VMware may assign a generic network adapter, so confirm it is mapped to the correct port group.
  5. First Boot: Power on the VM and install VMware Tools immediately. This replaces any remaining Xen drivers and ensures the guest OS has the correct drivers for VMware virtual hardware.

Live Migration Using VMware vCenter Converter Standalone

This method differs from manual exports because it converts a running VM directly over the network, with no XVA export or disk file handling required. It follows a similar approach to VMware P2V migration, where Converter manages the transfer and format translation automatically.

vmware vcenter convertor standalone

Prerequisites

Before starting the conversion job, confirm that both of the following conditions are met.

This method requires stable network connectivity between the XenServer host and the target ESXi host or vCenter. VMware vCenter Converter Standalone also needs to be installed on a Windows machine that can reach both environments.

Run the Conversion

With the prerequisites in place, open Converter and follow these steps to start the migration.

  1. Download and install VMware vCenter Converter Standalone.
  2. Click Convert a machine on the main screen.
  3. Set the source type to Remote machine and select Citrix XenServer as the platform.
  4. Enter the login credentials for your XenServer host to view the available VMs.
  5. Specify the target ESXi host or vCenter and configure the VM settings, including disk provisioning type and network mapping.
  6. Start the conversion job. Converter handles disk format translation to VMDK internally during the transfer.

Post-Migration Steps

Once the migration completes, install VMware Tools on the guest OS. If XenServer Tools were not removed beforehand, uninstall them first before installing VMware Tools.

How to Fix Common Issues After XVA to VMDK Conversion

Even with a clean conversion, a migrated VM may fail to boot or perform poorly. Most issues stem from differences in how XenServer and VMware handle storage controllers and device drivers.

VM Won’t Boot or Shows a BSOD

This is typically caused by a SCSI controller mismatch. Start by checking the .vmdk descriptor file — open the smaller of the two .vmdk files in a text editor and confirm the adapter type is set correctly:

text
ddb.adapterType = "lsilogic"

If the descriptor is correct but the VM still fails to boot, change the disk controller type in the VM settings to LSI Logic SAS or LSI Logic Parallel and retry.

Missing Network Adapters

The guest OS may not detect a network adapter after the first boot because VMware uses a different virtual NIC (VMXNET3) than XenServer. Install VMware Tools to provide the correct network drivers.

Poor Performance or High CPU Usage

If the VM boots but runs slowly, check whether XenServer PV drivers or Citrix components are still installed. These drivers attempt to communicate with the Xen hypervisor, which no longer exists in the new environment, causing unnecessary system overhead. Uninstall all Xen and Citrix components and reboot.

Skip the Manual Steps: Migrate XenServer VMs to VMware with i2Migration

The methods covered in this guide work well for one-off migrations, but they require significant manual effort — exporting XVA files, handling disk chunks, editing descriptor files, and troubleshooting boot failures along the way. For teams moving multiple VMs or running migrations in production environments where downtime is not an option, a dedicated migration platform is a more practical approach.

i2Migration is a unified migration platform built for cross-platform workload transfers across physical, virtual, and cloud environments. It handles the kind of heterogeneous virtualization migrations covered in this article — including V2V scenarios between different hypervisor platforms — without requiring manual disk conversion or file handling.

Key Features of i2Migration

  • Zero-Downtime Migration: i2Migration uses hybrid block-level and file-level replication to migrate running systems without shutting down production workloads. There is no need to export a static XVA snapshot and hope nothing changes during the transfer.
  • Cross-Environment Coverage: Supports P2V, V2V, physical-to-cloud, and virtual-to-cloud migrations, covering the full range of scenarios where XenServer VMs typically need to land.
  • Hardware-Agnostic OS Migration: Handles BIOS/UEFI conversion and driver injection automatically, which directly addresses the boot failures and adapter type issues that manual XVA-to-VMDK conversions commonly produce.
  • Built-in Validation: Performs end-to-end dataset validation with automatic correction, so you are not left manually verifying whether the migrated disk is intact.
  • Secure Transfer: Combines AES/SM4 encryption, bandwidth control, and resume-from-breakpoint to keep migrations stable and secure over long distances or unreliable networks.

For teams that also need ongoing data protection after the migration, i2Availability provides real-time replication and automated failover between environments, making it a natural complement once your VMs are running on VMware.

FREE Trial for 60-Day

FQA

Q1: Can I convert XVA to VMDK without Linux?

Yes. The Windows-based XenConvert tool (version 2.3.1 or 2.3.2) handles the conversion without any command-line work. Alternatively, exporting the VM from XenCenter as an OVA file is generally the simpler option — it imports directly into vSphere without requiring any disk manipulation.

 

Q2: Does XVA contain multiple disks? How to handle them?

An XVA file can contain multiple virtual disks. When you extract the archive with tar, each disk is stored in its own subdirectory — Ref:1, Ref:2, and so on. Run xva-img on each directory separately to produce individual raw images, then convert each one to VMDK before attaching them to the new VM in vSphere.

 

Q3: Can I convert back from VMDK to XVA?

Yes, though the process is not a single-step reverse. Export the VMware VM as an OVF or OVA, then use the Import wizard in XenCenter to bring it back into XenServer. The import handles the disk format conversion, but plan to remove VMware Tools and reinstall XenServer Tools on the guest OS afterward.

 

Q4: Can I just use OVA instead of converting XVA manually?

Yes, and for most environments it is the recommended approach. OVA is an industry-standard format supported by both XenServer and VMware, so it eliminates the need for manual disk rebuilding or descriptor file editing. The main limitation is that older XenServer versions may not support OVA export — in those cases, the manual xva-img method is the fallback.

Conclusion

Converting XVA to VMDK is rarely a single-step process. Depending on your environment and available tools, the right method varies — the Linux command-line approach gives you the most control, XenConvert and the OVA method work well for Windows-based workflows, and vCenter Converter is the best option when you need to migrate a running VM without any downtime.

Whichever method you use, the preparation steps matter as much as the conversion itself. Removing XenServer Tools before export and correcting the disk adapter type afterward are the two steps most likely to determine whether your VM boots cleanly on the first try.

For teams handling larger-scale or production migrations, Info2soft’s i2Migration removes most of this manual overhead — handling cross-platform V2V transfers, driver injection, and validation automatically so you can focus on the migration outcome rather than the tooling.

Emma is the bridge between complex engineering and the people who need it. As a content creator at Info2Soft, she spends her days translating "tech-speak" into clear, actionable stories about data resilience. She’s not just documenting software; she's uncovering how data replication and recovery actually change the way businesses run.

More Related Articles

Table of Contents:
Stay Updated on Latest Tips
Subscribe to our newsletter for the latest insights, news, exclusive content. You can unsubscribe at any time.
Subscribe
Ready to Enhance Business Data Security?
Start a 60-day free trial or view demo to see how Info2soft protects enterprise data.
{{ country.name }}
Please fill out the form and submit it, our customer service representative will contact you soon.
By submitting this form, I confirm that I have read and agree to the Privacy Notice.
{{ isSubmitting ? 'Submitting...' : 'Submit' }}