Known Issues

First and foremost, you must understand that vmrunGUI is 100% dependent on the VMware VIX API (the API used within the vmrun.exe utility).

If you are experiencing vmrun.exe errors whilst managing guests using vmrunGUI, please copy the command line generated by vmrunGUI into a Command Prompt to see if you experience the same behaviour. If you receive different results after executing the same command in a Command Prompt, or you feel there is an error in vmrunGUI, please let me know.

The VMware VIX API may need a bit of love and attention before it will work correctly in some instances. Hopefully you will find an answer to your problem below, but if you can't find a resolution here or in the FAQ, please feel free to contact me.

Cannot manage guests on VMware Workstation 7 VMware VIX API 1.8.1
If you are using VMware Workstation 7 and have installed the latest version of the VMware VIX API (1.8.1 ATOW), you may find that vmrun.exe no longer works for guests on VMware Workstation 7. This seems to be a bug in VMware VIX API 1.8.1, although I have devised a simple workaround (replace "Program Files (x86)" with "Program Files" on 32bit versions of Windows).

1. Close any VMware related applications including vmrunGUI.
2. Rename the "C:\Program Files (x86)\VMware\VMware VIX" directory to "C:\Program Files (x86)\VMware\VMware VIX.bak1".
3. Repair the "VMware Workstation" application by running the original installer, and selecting "Repair".
4. If successful, the VMware Workstation installer should have reinstalled the VMware VIX API. Rename the "C:\Program Files (x86)\VMware\VMware VIX" directory to "C:\Program Files (x86)\VMware\VMware VIX.bak2".
5. Download and install the latest non-BETA release of the VMware VIX API (
6. Copy the "C:\Program Files (x86)\VMware\VMware VIX.bak2\Workstation-7.1.0" directory into "C:\Program Files (x86)\VMware\VMware VIX", overwriting the version already in there.
7. Delete "C:\Program Files (x86)\VMware\VMware VIX.bak1" and "C:\Program Files (x86)\VMware\VMware VIX.bak2"
You should now be able to manage guests on both VMware Workstation 7 and other VMware platforms.

The VMware VIX API supplied with VMware Workstation 7 is a cut down version that will only allow you to manage guests on VMware Workstation 7. If you want to use vmrunGUI to manage guests on any other VMware platforms, you will have to follow the workaround steps above.

"Unable to connect to host" errors
I have experienced issues where suddenly a remote host (in this case VMware Server 2.0) suddenly gives me "Unable to connect to host" errors from vmrun.exe, even though it was working fine previously and responds to ping just fine. No amount of reboots, firewall modifications or reinstalls seems to fix the problem.

If I then change the Host object in vmrunGUI to use the IP address instead of the hostname, it works again! Not sure why this makes a difference to vmrun.exe, but I have seen this a couple of times now.

Guests not showing as powered on after VIX API 1.10 upgrade
Since upgrading to VIX API 1.10 the Guest status doesn't appear to update correctly for powered on Guests.

This issue only affects Guests that were added with a previous version of the VIX API. Curiously it does not affect the manageability of the Guests.

vmrunGUI uses the "list" command to query which Guests are running on a Host. The new version of vmrun.exe released with the VIX API 1.10 may return a list of running Guests that does not match what was previously added, therefore it is unable to determine if a Guest is running.

Before VIX API 1.10 installation:

[standard] VMNTWKS001/VMNTWKS001.vmx

After VIX API 1.10 installation:

[ha-datacenter/standard] VMNTWKS001/VMNTWKS001.vmx

To resolve this issue, remove and re-add the affected Guests in vmrunGUI.

Last edited Jul 30, 2010 at 9:13 AM by sw3103, version 25


No comments yet.