Troubleshooting checklist for VMware Converter
search cancel

Troubleshooting checklist for VMware Converter

book

Article ID: 344457

calendar_today

Updated On:

Products

VMware

Issue/Introduction

This article provides troubleshooting information for issues experienced in VMware Converter.


Environment

VMware vCenter Converter Standalone 5.5.x
VMware vCenter Converter Standalone 6.x
VMware vCenter Converter Standalone 6.0.x
VMware vCenter Converter 4.0.x
VMware vCenter Converter Standalone 4.3.x
VMware vCenter Converter Standalone 5.1.x
VMware vCenter Converter 4.1.x
VMware vCenter Converter 4.2.x
VMware Converter 3.0.x
VMware vCenter Converter Standalone 5.0.x
VMware vCenter Converter Standalone 4.0.x

Resolution

This article includes these sections:

Troubleshooting checklist

Follow this troubleshooting checklist if you encounter issues while using VMware Converter:

Note: Each environment is unique, so this checklist is just a guideline.

  1. To eliminate permission issues, always use the local administrator account instead of a domain account.

    Note: Disable UAC for Windows Vista, Windows 7, or Windows 8 before converting. For more information, see Turn user Account Control on and off from Microsoft Support.

    Note: The preceding link was correct as of March 4, 2014. If you find the link is broken, provide feedback and a VMware employee will update the link.
     
  2. To eliminate DNS issues, use IP addresses instead of host names.
  3. Ensure that you do not choose partitions that contain any vendor specific Diagnostic Partitions before proceeding with a conversion.
  4. To reduce network obstructions, convert directly to an ESX host instead of vCenter Server as the destination.

    Note s:
  5. VMware vCenter Converter Standalone has many more options available to customize your conversion. If you are having issues using the Converter Plug-in inside vCenter Server, consider trying the Standalone version. This is a free download from the VMware Download Center .
  6. If a conversion fails using the exact size of hard disks, decrease the size of the disks by at least 1MB. This forces VMware Converter to do a file level copy instead of a block level copy, which can be more successful if there are errors with the volume or if there are file-locking issues.
  7. Ensure there is at least 500MB of free space on the machine being converted. VMware Converter requires this space to copy data.
  8. Shut down any unnecessary services, such as SQL, antivirus programs, and firewalls. These services can cause issues during conversion.
  9. Run a check disk on the volume before running a conversion as errors on disk volumes can cause VMware Converter to fail.
  10. Do not install VMware Tools during the conversion. Install VMware Tools after you confirm that the conversion was successful.
  11. Do not customize the new virtual machine before conversion.
  12. Ensure that these services are enabled:
     
    • Workstation Service
    • Server Service
    • TCP/IP NetBIOS Helper Service
    • Volume Shadow Copy Service
       
  13. Check that the appropriate firewall ports are opened. For more information, see TCP and UDP Ports required to access vCenter Server, ESX hosts, and other network components (1012382).
  14. Check that boot.ini is not looking for a Diagnostic/Utility Partition that no longer exists.
  15. If you are unable to see some or all of the data disks on the source system, ensure that you are not using GPT on the disk partitions. For more information, see VMware vCenter Converter is unable to see the disks when converting Windows operating systems (1016992).
  16. In Windows XP, disable Windows Simple File Sharing. This service has been known to cause issues during conversion.
  17. Unplug any USB, serial/parallel port devices from the source system. VMware Converter may interpret these as additional devices, such as external hard drives which may cause the conversion to fail.
  18. If the source machine contains multiple drives or partitions and you are having issues failing on certain drives, consider converting one drive or partition at a time.
  19. Verify that there are no host NICs or network devices in the environment that have been statically configured to be at a different speed or duplex. This includes settings on the source operating system, switches and networking devices between the source and destination server. If this is the case, Converter checks the C: drive but not the D: drive.
  20. If you are using a security firewall or Stateful Packet Inspecting (SPI) firewall, check firewall alerts and logs to ensure the connection is not being blocked as malicious traffic.
  21. If you have static IP addresses assigned, assign the interfaces DHCP addresses prior to conversion.
  22. If the source server contains a hard drive or partition larger than 256GB, ensure that the destination datastores block size is 2MB, 4MB, or 8MB, and not the default 1MB size. The 1MB default block size cannot accommodate a file larger than 256GB.
  23. Clear any third-party software from the physical machine that could be using the Volume Shadow Copy Service (VSS). VMware Converter relies on VSS, and other programs can cause contention.
  24. Disable mirrored or striped volumes. Mirrored or striped volumes cannot be converted.
  25. Verify that the VMware Converter agent is installed on the source machine. It may not be if the conversion fails right away.
  26. Verify that DNS and reverse DNS lookups are working. It may be necessary to make entries into the local hosts file on source machine. Use IP addresses, if possible.
  27. Run msconfig on the source server to reduce the number of services and applications running at startup. Only Microsoft services and the VMware Converter Service should be running.
  28. Install VMware SCSI drivers into the machine before conversion. Windows tries to Plug-n-Play the new SCSI Controller, and Windows may fail if the proper drivers are not installed.
  29. If you customized permissions in your environment, ensure that local administrator has rights to all files, directories, or registry permissions before conversion.
  30. Uninstall any UPS software. This has been known to cause issues after Conversion.
  31. Ensure that you do not have any virtual mounted media through an ILO- or DRAC-type connection. Converter can misinterpret these as convertible drives, and fails upon detecting them. As a precaution, disconnect your ILO or DRAC to prevent this issue.

Troubleshooting a converted virtual machine that fails to boot

To troubleshoot a converted virtual machine that fails to boot:

  1. Avoid load balancers between the source and destination.
  2. If a virtual machine experiences a blue screen error after conversion, run a repair.
  3. Toggle between using Bus Logic and LSI Logic as the Virtual SCSI controller.

For more information, see Troubleshooting a virtual machine converted with VMware Converter that fails to boot with the error: STOP 0x0000007B INACCESSIBLE_BOOT_DEVICE (1006295).

Troubleshooting a Conversion that fails at 2% or below

To troubleshoot a conversion that fails at less than 2%:

  1. Use a local administrator account.
  2. Use IP addresses and verify DNS entries.
  3. Check firewall settings.
  4. Ensure the Converter agent is installed on the source machine.
  5. Verify network adapter settings for speed and duplex.

Linux troubleshooting

To troubleshoot converting a Linux system:

  1. Use the VMware vCenter Converter Standalone. The vCenter Server plug-in does not include Linux support.

    Note: VMware vCenter Converter Standalone 4.3 Standalone and VMware vCenter Converter 4.2 for vCenter Server 4.1 now support certain versions of Linux.
     
  2. Ensure that you are using a supported version of Linux.

    For more information, see:
  3. Always use the root user account.
  4. Verify that DNS and reverse DNS lookups are working. You may need to add entries in the local Windows Host file for your Linux system.
  5. Verify that your Linux source machine can ping the ESX Console IP address. If the conversion fails at 2%, then you likely have a resolution/permission/firewall related issue.
  6. Ensure that your physical Linux machine allows SSH connections. You can verify this by using an SSH client and logging into your Linux system from the computer you are running the conversion from.
  7. Ensure that the helper virtual machine has a static IP address instead of using DHCP.
  8. Ensure your source and destination machines are on the same subnet. Different subnets can cause issues if the traffic is not route-able.
    Note: VMware Converter does not support Software Raid on Linux machines.

VMware Converter logs

There are also several ways to diagnose issues by viewing the VMware Converter logs. The logs can contain information that is not apparent from error messages. In newer versions of VMware Converter, you can use the Export Log Data button. Otherwise, logs are typically stored in these directories:

  • Windows NT, 2000, XP, and 2003:
     
    • C:\Documents and Settings\All Users\Application Data\VMware\VMware Converter Enterprise\Logs
    • C:\WINDOWS\Temp\vmware-converter
    • C:\WINDOWS\Temp\vmware-temp
       
  • Windows Vista, 7, and 2008:

    C:\Users\All Users\Application Data\VMware\VMware Converter Enterprise\Logs
     
  • Windows 8 and Windows 2012:

    C:\ProgramData\VMware\VMware vCenter Converter Standalone\logs

    Note: In order to access this location in Windows Vista, 7, or 2008, you may need to go to the folder options and ensure that Show Hidden Files is enabled and that Hide Protected Operating System Files is disabled.
     
    • C:\WINDOWS\Temp\vmware-converter
    • C:\WINDOWS\Temp\vmware-temp
       
  • Windows NT and 2000:
     
    • C:\WINNT\Temp\vmware-converter
    • C:\WINNT\Temp\vmware-temp
  • Linux:
     
    • $HOME/.vmware/VMware vCenter Converter Standalone/Logs
    • /var/log/vmware-vcenter-converter-standalone

For further troubleshooting information, you can enable verbose logging in vCenter Converter. For more information, see Increasing the logging levels to verbose for vCenter Converter application components (2008019).


Additional Information

For more VMware Converter resources, see:


Testing port connectivity with Telnet
Best practices for using and troubleshooting VMware Converter
Troubleshooting a virtual machine converted with VMware Converter that fails to boot with the error: STOP 0x0000007B INACCESSIBLE_BOOT_DEVICE
Required VMware vCenter Converter ports
Collecting diagnostic information for VMware Converter
TCP and UDP Ports required to access VMware vCenter Server, VMware ESXi and ESX hosts, and other network components
VMware vCenter Converter is unable to see the disks when converting Windows operating systems
vCenter Standalone Converter errors when an ESXi 5.x host is selected as a destination: The access to the host resource settings is restricted. Use the management server as a destination
VMware Converter のトラブルシューティング チェックリスト
对 VMware Converter 对照表进行故障排除