Article ID: 123120, created on Oct 10, 2014, last review on Jun 17, 2016

  • Applies to:
  • Virtuozzo 6.0
  • Virtuozzo hypervisor

Symptoms

Guest Tools failed to install / reinstall / update in Virtual Machine. Some or most of the features of Guest Tools do not function correctly in the Virtual Machine.

E.g. prlctl enter does not work:

 ~# prlctl enter MyVM 
 Unable to open new session in this virtual machine. Make sure the latest version of Parallels Tools is installed in this virtual machine and it has finished booting.

Resolution

Check Parallels Tools installation log for exact error

  • In Windows OS: C:\WINDOWS\Temp\parallels-tools-setup-xxx.log

  • In Linux OS: /var/log/parallels-tools-install.log

For Windows Guest OS parallels-tools-setup-xxx.log will be collected along with VM report:

# prlctl problem-report VM_NAME --send

In case you cannot locate the log in C:\Windows\Temp or this folder does not exist - > it is the root cause of the installation issue: check permissions for that folder or create it manually.

Reading Parallels Tools installation log

Go to the end of file. Make sure that the last string contains actual date & time from Windows:

    "=== Verbose logging stopped: 7/4/2011 14:13:04 ==="
  • Return code 3010 in one of the previous strings means OK. Guest Tools was installed successfully.

  • Return code 1603 means 'failed'.

error code 1603 (0x643) Fatal error during installation means only that something is wrong, so it should be ignored – most probably the log contains other more informative error message.

At this step search for “DIFXAPP: ERROR” or “HRESULT” entries, that would be the main error.

  • Rollback

Sometimes the Guest Tools installation stops in the middle of the process and then rolls back without an error message. Guest Tools installation wizard may just warn you that installation failed and reboot is needed.

If there is neither DIFXAPP: ERROR nor HRESULT error found in the log, search for the first "Rollback:" occurrence and look at error message some string above.

All error codes that could be found in Guest Tools installation log are regular Windows error codes, so they could be found at msdn.microsoft.com

Related Topics

121226 [How to] Install/upgrade Guset Tools in Linux VM

9388 Guest Tools installation rolls back

Windows System Error Codes - msdn.microsoft.com

Win32 Error Codes - msdn.microsoft.com

HRESULT Values - msdn.microsoft.com

Search Words

rollback

parallels-tools-setup

tools

Guest tool not installed

Unable to open new session

Unable to open new session in this virtual machine

Make sure the latest version of Parallels Tools is installed in this virtual machine and it has finished booting

error parallels tools and unknown pci devices

Unable to open new session in this virtual machine.

update

Return code 1603

c62e8726973f80975db0531f1ed5c6a2 2897d76d56d2010f4e3a28f864d69223 0dd5b9380c7d4884d77587f3eb0fa8ef a26b38f94253cdfbf1028d72cf3a498b

Email subscription for changes to this article
Save as PDF