Knowledge base
VMware Tools
Posted by Pomoc Oktawave on 16.04.2015 21:45

VMware Tools is a set of tools and drivers that enhance the performance and availability of instances running in Oktawave. If you modify the operating system on OCI instance (eg. recompiling the kernel), it is necessary to properly install VMware Tools. Below you will find update instructions for different operating systems available in Oktawave (Linux, Windows and FreeBSD).


1. We need to download vmware-tools in the current, recommended version:

wget -O /tmp/VmwareTools-current.tar.gz

2. Unpack package with vmware-tools to a temporary directory.

tar xfvz /tmp/VmwareTools-current.tar.gz -C /tmp/

3. Install the new version of the package. The old version is uninstalled during this procedure and replaced with a new one.


4. Part of the modules installed with vmware-tools package has its counterparts in the kernel, but to increase the performance, we suggest the use of the modules provided by VMware. --clobber-kernel-modules=vmci,vmmemctl,vmxnet3,pvscsi,vsock

5. There may be a situation in which modules build errors for the new kernel occur, you must then patch the source of the modules so that they are compatible with the kernel sources.

6. After a successful installation, you can delete the installer files

rm -rf /tmp/vmware-tools-distrib/
rm /tmp/VmwareTools-current.tar.gz


When you update VMware-Tools also virtual network cards drivers are updated, so we recommend to perform this operation using the remote console, so we wont lose the connection to the instance. It should also be remembered that the update process should be completed by restarting Windows.

  1. You need to download the recommended version of the package
  2. Unzip the downloaded file and run it.
  3. Follow the instructions of the installer.


Due to incomplete VMware support for FreeBSD, vmware-tools package can not be applied to instances in Oktawave. We will use its replacement - the open-vm-tools developed by VMware as an open-source project. Due to the lack of availability of the current version of BSD ports, we need to compile it from source.

For your convenience, corrected source code of the open-vm-tools package is present in /usr/local/src. On the template, there are also all the dependencies needed to recompile the package and the source code for vmxnet3 FreeBSD driver that is required on our infrastructure.

Basically, recompilation of vmware-tools should be made in two cases:

  1. you are using binary packages
  2. using ports

In case 1, recompiling should occur only after upgrading to a newer release (eg. With 9.1-RELEASE on a 9.2-RELEASE) and update the binary packages that are dependencies for the vmware-tools
In case 2, a recompilation may be necessary after the update of one of the open-vm-tools dependencies. Alternatively, you can link the new library to the names of the versions with which tools were compiled.

An example of the update procedure:

1. Download and unpack FreeBSD source kernel.

tar -C / -xvzf src.txz
rm src.txz

2. Compile open-vm-tools. If you do not have the open-vm-tools source package, it can be downloaded here.

cd /usr/local/src/open-vm-tools*
make uninstall
make clean
./configure --without-x --without-gtk2 --without-gtkmm

make install

3. Compile the vmxnet3 driver:

cd /usr/local/src/vmxnet3-only
make install
make clean

4. If you no longer need the FreeBSD kernel sources, you can delete them.

rm -rf /usr/src/

To learn more about the vmware-tools and how to install and update this package, we encourage you to read the documentation for VMware:

(1 vote(s))
This article was helpful
This article was not helpful

Comments (0)
Post a new comment
Full Name:
CAPTCHA Verification 
Please enter the text you see in the image into the textbox below. This is required to prevent automated registrations and form submissions.