Migrating a virtual machine fails when entering the maintenance mode with the error: Tools installation in progress
search cancel

Migrating a virtual machine fails when entering the maintenance mode with the error: Tools installation in progress


Article ID: 310528


Updated On:


VMware vCenter Server


  • When entering the maintenance mode, some virtual machines fail to migrate from the ESX/ESXi host
  • Other virtual machines migrate successfully
  • You see that VMware Tools Installation appears to be in progress within the ESX/ESXi host settings
  • When migrating the virtual machine, you see the error:

    The virtual machine is installing VMware Tools and cannot initiate a migration operation

    Note: However, you are unable to end the VMware Tools installation.


VMware vCenter Server 4.1.x
VMware vCenter Server 5.0.x
VMware vCenter Server 5.1.x
VMware vCenter Server 5.5.x
VMware vCenter Server 4.0.x


This issue may occur if the VMware Tools .iso image is not unmounted from the guest operating system after VMware Tools is installed or upgraded.


To resolve this issue, you must disconnect the .iso image from the virtual machine, so that DRS can complete the migration.
To unmount the .iso image:
  1. From the guest operating system, Right-click the CD drive and click Eject.

  2. Right-click the virtual machine and click Guest > End VMware Tools Install.
  • If DRS is set to fully automated, the virtual machine begins to migrate automatically. If DRS is set to manual, you must migrate the virtual machine manually.
  • On Linux guest operating system these steps may not resolve the issue. The virtual machine must be powered off to resolve the issue.

Additional Information

Note: If the preceding steps does not resolve the issue, shut down the virtual machine and then power it on after ensuring that the ISO is disconnected.

If the virtual machine is running on an ESXi host and if the VMware Tools installation has not completed successfully and/or cannot be canceled using the procedure specified in the resolution section:
  1. Run this command to identify the virtual machine ID:

    # vim-cmd vmsvc/getallvms

    You see output similar to:

    2256 testvm [datastore] testvm/testvm.vmx winNetStandardGuest vmx-07

  2. Note the ID of the virtual machine with the ongoing VMware Tools installation. In this example, the virtual machine ID is 2256.
  3. Run this command to stop the VMware Tools installation:

    # vim-cmd vmsvc/tools.cancelinstall vm_ID

    Where vm_ID is the ID of the virtual machine noted in Step 2.
Installing VMware Tools in a Linux virtual machine using a Compiler
メンテナンス モードに入っている場合、仮想マシンの移行が次のエラーで失敗する:Tools のインストールが進行中です
进入维护模式后迁移虚拟机失败并显示错误:正在安装 Tools