Troubleshoot Conversion Manager
Important:
Citrix Hypervisor 8.2 Cumulative Update 1 becomes End of Life on June 25, 2025. Plan your upgrade to XenServer 8 now to ensure a smooth transition and continued support. For more information, see Upgrade.
If you are using your Citrix Virtual Apps and Desktops license files to license your Citrix Hypervisor 8.2 Cumulative Update 1 hosts, these license files are not compatible with XenServer 8. Before upgrading you must acquire XenServer Premium Edition socket license files to use with XenServer 8. These socket license files are available as an entitlement of the Citrix for Private Cloud, Citrix Universal Hybrid Multi-Cloud, Citrix Universal MSP, and Citrix Platform License subscriptions for running your Citrix workloads. Citrix customers who have not yet transitioned to these new subscriptions can request to participate in a no-cost promotion for 10,000 XenServer Premium Edition socket licenses. For more information, see XenServer.
If you do not get a compatible license for XenServer 8 before upgrading, when you upgrade your hosts they revert to the 90-day Trial Edition. Trial Edition provides the same features as Premium Edition with some limitations. For more information, see XenServer 8 Licensing Overview.
This section provides information about troubleshooting the conversion process and converted VMs.
Problems starting a converted VM
In general, conversion runs smoothly and the Conversion Manager virtual appliance converts VMs without any issues. However, in some rare cases, you might receive errors when attempting to open converted VMs. The following sections provide some guidance on resolving errors and other issues.
Blue screen with Windows STOP code 0x0000007B
This stop code indicates that Conversion Manager virtual appliance was unable to configure a Windows device that is critical to boot in Citrix Hypervisor for the first time. Save the logs and send them to Citrix Support for further guidance.
Windows product activation
Depending on your licensing model, an error message on system activation might appear when you attempt to start a Windows VM.
Lost network settings in a Windows VM
If you import a Windows VM from an ESXi server to Citrix Hypervisor, the IPv4/IPv6 network settings can be lost. To retain the network settings, reconfigure the IPv4/IPv6 settings after completing the conversion.
Unable to start VMware SCSI disk
If a VMware VM boots from a SCSI disk but also has IDE hard disks configured, the VM might not boot when you convert it to Citrix Hypervisor. This issue occurs because the migration process assigns the IDE hard disks lower device numbers than SCSI disks. However, Citrix Hypervisor boots from the hard disk assigned to device 0. To resolve this issue, rearrange the virtual disk position in XenCenter so that the VM reboots from the virtual disk that contains the operating system.
To change the position of the virtual disk containing the operating system:
-
In the XenCenter Resources pane, select the powered off guest VM.
-
Select the Storage tab.
-
From the Virtual Disks list, select the virtual disk containing the operating system and then click Properties.
-
In the virtual disk’s Properties dialog, click the vm_name tab to display device options.
-
From the Device Position list, select 0 and Click OK.
Problems during conversion
If you experience problems or errors when converting VMs, try exporting the VMware VM as an OVF package. If you cannot export the VMware VM as an OVF package, Conversion Manager cannot convert this VM. Use the error messages you receive when attempting to export the VM as an OVF package to troubleshoot and fix the issues with your VMware VM. For example, you might have to configure a network or a storage controller before the VM can be exported as an OVF package or converted. For more information about troubleshooting your VMware ESXi/vCenter VMs, see the VMware documentation.
If you see any errors when converting Linux VMs, remove the converted VM, restart the Conversion Manager virtual appliance and retry.
Logs of failed conversions are stored in the Conversion Manager virtual appliance and can be retrieved by clicking Fetch All Logs on the Conversion Manager window. When you contact Citrix support to raise any issues, we recommend that you provide the conversion log file and, also, a full server status report for troubleshooting. For more information, see Creating a Server Status Report.