The VIX API allows you to automate virtual machine operations on most current VMware hosted products such as: vmware workstation, player, fusion and server.
vSphere API, starting from 5.0, merged VIX API in the so-called GuestOperationsManager managed object. So, we encourage you to use https://github.com/vmware/govmomi for vSphere instead.
Google groups: https://groups.google.com/group/govix
This API supports:
- Adding, removing and listing virtual networks adapters attached to a VM
- Adding and removing virtual CPUs and memory from a VM
- Managing virtual machines life cycle: power on, power off, reset, pause and resume.
- Adding and removing shared folders
- Taking screenshots from a running VM
- Cloning VMs
- Creating and removing Snapshots as well as restoring a VM from a Snapshot
- Upgrading virtual hardware
- Guest management: login, logout, install vmware tools, etc.
- Attaching and detaching CD/DVD drives on SATA, SCSI or IDE controllers
For a more detailed information about the API, please refer to the API documentation.
In order for Go to find libvix when running your compiled binary, a govix path has to be added to the LD_LIBRARY_PATH environment variable. Example:
- OSX:
export DYLD_LIBRARY_PATH=${GOPATH}/src/github.com/hooklift/govix/vendor/libvix - Linux:
export LD_LIBRARY_PATH=${GOPATH}/src/github.com/hooklift/govix/vendor/libvix - Windows: append the path to the PATH environment variable
Be aware that the previous example assumes $GOPATH only has one path set.
echo "vix.debugLevel = \"9\"" >> ~/Library/Preferences/VMware\ Fusion/config
- OSX:
~/Library/Logs/VMware/*.log - Linux:
/tmp/vmware-<username>/vix-<pid>.log - Windows:
%TEMP%\vmware-<username>\vix-<pid>.log
The Vix library is intended for use by multi-threaded clients. Vix shared objects are managed by the Vix library to avoid conflicts between threads. Clients need only be responsible for protecting user-defined shared data.
As noted in the End User License Agreement, the VIX API allows you to build and distribute your own applications. To facilitate this, the following files are designated as redistributable for the purpose of that agreement:
- VixAllProducts.lib
- VixAllProductsd.lib
- VixAllProductsDyn.lib
- vix.lib and vix.dll
- vixCOM.dll
- gvmomi-vix-1.13.1.dll
- libvixAllProducts.so
- libvix.so
- libgvmomi-vix-1.13.1.so.0
- vixwrapper-config.txt
- manifest.txt
- compiled perl modules resulting from building the contents of vix-perl.tar.gz or vix-perl.zip
Redistribution of the open source libraries included with the VIX API is governed by their respective open source license agreements.
Source: http://blogs.vmware.com/vix/2010/05/redistibutable-vix-api-client-libraries.html
- Configuration Maximums: http://www.vmware.com/pdf/vsphere5/r50/vsphere-50-configuration-maximums.pdf
- VMX Parameters: http://faq.sanbarrow.com/index.php?sid=1504158&lang=en&action=show&cat=2