Description

This article describes how to manually update the VMware Tools on a Windows or Linux server.

Content / Solution:

CloudControl supports updating VMware Tools for a Cloud Server directly from the Admin UI or API. See:

This articles describes how to perform these actions manually outside the system.

When you install VMware Tools, you install:

  • The VMware Tools service (VMwareService.exe on Windows guests or vmware-guestd on Linux and Solaris guests). This service synchronizes the time in the guest operating system with the time in the host operating system. On Windows guests, it also controls grabbing and releasing the mouse cursor.
  • A set of VMware device drivers, including an SVGA display driver, the vmxnet networking driver for some guest operating systems, the BusLogic SCSI driver for some guest operating systems, the memory control driver for efficient memory allocation between virtual machines, the sync driver to quiesce I/O for Consolidated Backup, and the VMware mouse driver.
  • The VMware Tools control panel, which lets you modify settings, shrink virtual disks, and connect and disconnect virtual devices.
  • A set of scripts that helps you to automate guest operating system operations. The scripts run when the virtual machine's power state changes if you configure them to do so.
  • The VMware user process (VMwareUser.exe on Windows guests or vmware-user on Linux guests), which enables you to copy and paste text between the guest and managed host operating systems.) On Linux guests, this process controls grabbing and releasing the mouse cursor when the SVGA driver is not installed.

Limitations

VMware Tools has the following limitations:

  • Shrink disk is not supported.
  • For Microsoft Windows NT, the default scripts for suspend and resume do not work.
  • The mouse driver installation fails in X windows versions earlier than 4.2.0.
    • Note: If you do not have VMware Tools installed in your virtual machine, you cannot use the shutdown or restart options. You can use only the Power options. If you want to shut down the guest operating system, shut it down from within the virtual machine console before you power off the virtual machine.

Upgrading VMware Tools

Upgrading VMware Tools is a simple process requiring the administrator (Windows) or root (Linux) account and rebooting the vm.

Windows

  • While logged in as Administrator, right-click the VMware Tools icon in the System Tray, select "Open VMware Tools"
  • On the Options tab, make sure the "Notify if upgrade is available" checkbox is checked
  • If the Upgrade button is enabled, click it and follow the on screen prompts

Linux

  • For Redhat and CentOS Linux servers, run this command as root (Ubuntu Linux users can skip this step): 
    • rpm -qa | grep -i vmware
  • If it produces any output, you must log a support case to have someone upgrade VMware Tool for you.
  • Assuming the previous command returned no output, you can use the following command to upgrade VMware Tools:
    • /usr/sbin/vmware-tools-upgrader
    • Accept all default options when prompted.
  • The output will look similar to the following (output for Ubuntu Linux may differ slightly):

# vmware-tools-upgrader 
Starting Tools Upgrader
Registering callback 'reset'
Registering callback 'ping'
Registering callback 'Capabilities_Register'
Registering callback 'upgrader.run'
Registering callback 'upgrader.cancel'
Registering callback 'f'
Rpci: Sending request='tools.capability.hgfs_server tools-upgrader 1'
Rpci: Sent request='tools.capability.hgfs_server tools-upgrader 1', reply='', len=0, status=1
Rpci: Sending request='upgrader.setGuestFileRoot /tmp/0f61b83e/'
Rpci: Sent request='upgrader.setGuestFileRoot /tmp/0f61b83e/', reply='', len=0, status=1
Received reset from VMX
Received Capabilities_Register from VMX
Rpci: Sending request='tools.capability.upgrader_parameters 1'
Rpci: Sent request='tools.capability.upgrader_parameters 1', reply='', len=0, status=1
Rpci: Sending request='tools.capability.hgfs_server tools-upgrader 1'
Rpci: Sent request='tools.capability.hgfs_server tools-upgrader 1', reply='', len=0, status=1
Received upgrader.run from vmware
Upgrader: Beginning installation.
Extracting /tmp/0f61b83e/linux.iso to /tmp/0f61b83e
Unlinking ISO at /tmp/0f61b83e/linux.iso
ISO contains only tarball.
Running "tar -zxf /tmp/0f61b83e/VMWARETO.TGZ -C /tmp/0f61b83e"
Executing async command: tar -zxf /tmp/0f61b83e/VMWARETO.TGZ -C /tmp/0f61b83e
Done waiting for process: 5520 (success)
Writing the command was a success to fd a
Child w/ fd 9 exited with code=0
Waiting on pid 5519 to de-zombify it
Unlinking tar at /tmp/0f61b83e/VMWARETO.TGZ
Unlinking rpm at /tmp/0f61b83e/VMWARETO.RPM
Running "./vmware-install.pl"
Executing async command: ./vmware-install.pl
A previous installation of VMware Tools has been detected.

The previous installation was made by the tar installer (version 4).

Keeping the tar4 installer database format.

You have a version of VMware Tools installed.  Continuing this install will 
first uninstall the currently installed version.  Do you wish to continue? 
(yes/no) [yes] 

Uninstalling the tar installation of VMware Tools.

Stopping services for VMware Tools

Stopping VMware Tools services in the virtual machine:
   Guest operating system daemon:                          [  OK  ]
   Virtual Printing daemon:                                [  OK  ]
   Unmounting HGFS shares:                                 [  OK  ]
   Guest filesystem driver:                                [  OK  ]
   Guest memory manager:                                   [  OK  ]
   VM communication interface socket family:               [  OK  ]
   VM communication interface:                             [  OK  ]

File /usr/lib/vmware-tools/lib32/libconf/etc/gtk-2.0/gdk-pixbuf.loaders is 
backed up to 
/usr/lib/vmware-tools/lib32/libconf/etc/gtk-2.0/gdk-pixbuf.loaders.old.1.

File /usr/lib/vmware-tools/lib32/libconf/etc/pango/pangorc is backed up to 
/usr/lib/vmware-tools/lib32/libconf/etc/pango/pangorc.old.1.

This program previously created the file 
/usr/lib/vmware-tools/libconf/etc/pango/pangorc, and was about to remove it.  
Somebody else apparently did it already.

File /etc/vmware-tools/vmware-user.desktop is backed up to 
/etc/vmware-tools/vmware-user.desktop.old.1.

File /usr/lib/vmware-tools/lib32/libconf/etc/fonts/fonts.conf is backed up to 
/usr/lib/vmware-tools/lib32/libconf/etc/fonts/fonts.conf.old.1.

This program previously created the file 
/usr/lib/vmware-tools/lib32/libconf/etc/pango/pango.modules, and was about to 
remove it.  Somebody else apparently did it already.

This program previously created the file 
/usr/lib/vmware-tools/libconf/etc/gtk-2.0/gdk-pixbuf.loaders, and was about to 
remove it.  Somebody else apparently did it already.

File /usr/lib/vmware-tools/lib32/libconf/etc/gtk-2.0/gtk.immodules is backed up
to /usr/lib/vmware-tools/lib32/libconf/etc/gtk-2.0/gtk.immodules.old.1.

This program previously created the file 
/usr/lib/vmware-tools/libconf/etc/gtk-2.0/gtk.immodules, and was about to 
remove it.  Somebody else apparently did it already.

This program previously created the file 
/usr/lib/vmware-tools/lib32/libconf/etc/pango/pangox.aliases, and was about to 
remove it.  Somebody else apparently did it already.

File /etc/updatedb.conf is backed up to /etc/updatedb.conf.old.3.

File /etc/modprobe.conf is backed up to /etc/modprobe.conf.old.3.

Restoring the kernel initrd image.:
The removal of VMware Tools 8.3.2 build-257589 for Linux completed 
successfully.

Installing VMware Tools.

In which directory do you want to install the binary files? 
[/usr/bin] 

What is the directory that contains the init directories (rc0.d/ to rc6.d/)? 
[/etc/rc.d] 

What is the directory that contains the init scripts? 
[/etc/rc.d/init.d] 

In which directory do you want to install the daemon files? 
[/usr/sbin] 

In which directory do you want to install the library files? 
[/usr/lib/vmware-tools] 

In which directory do you want to install the documentation files? 
[/usr/share/doc/vmware-tools] 

The path "/usr/share/doc/vmware-tools" does not exist currently. This program 
is going to create it, including needed parent directories. Is this what you 
want? [yes] 

The installation of VMware Tools 8.3.7 build-381511 for Linux completed 
successfully. You can decide to remove this software from your system at any 
time by invoking the following command: "/usr/bin/vmware-uninstall-tools.pl".

Before running VMware Tools for the first time, you need to configure it by 
invoking the following command: "/usr/bin/vmware-config-tools.pl". Do you want 
this program to invoke the command for you now? [yes] 

Initializing...


Stopping VMware Tools services in the virtual machine:
   Guest operating system daemon:                          [  OK  ]
   Virtual Printing daemon:                                [  OK  ]
   Unmounting HGFS shares:                                 [  OK  ]
   Guest filesystem driver:                                [  OK  ]
   Guest memory manager:                                   [  OK  ]
   VM communication interface socket family:               [  OK  ]
   VM communication interface:                             [  OK  ]


Found a compatible pre-built module for vmmemctl.  Installing it...


Found a compatible pre-built module for vmhgfs.  Installing it...


Found a compatible pre-built module for vmxnet.  Installing it...


Found a compatible pre-built module for vmblock.  Installing it...


Found a compatible pre-built module for vmci.  Installing it...


Found a compatible pre-built module for vsock.  Installing it...


Found a compatible pre-built module for vmxnet3.  Installing it...


Found a compatible pre-built module for pvscsi.  Installing it...


No X install found.

Creating a new initrd boot image for the kernel.
Starting VMware Tools services in the virtual machine:
   Switching to guest configuration:                       [  OK  ]
   Paravirtual SCSI module:                                [  OK  ]
   Guest memory manager:                                   [  OK  ]
   VM communication interface:                             [  OK  ]
   VM communication interface socket family:               [  OK  ]
   Guest operating system daemon:                          [  OK  ]
   Virtual Printing daemon:                                [  OK  ]

The configuration of VMware Tools 8.3.7 build-381511 for Linux for this running
kernel completed successfully.

You must restart your X session before any mouse or graphics changes take 
effect.

You can now run VMware Tools by invoking the following command: 
"/usr/bin/vmware-toolbox" during an X server session.

To enable advanced X features (e.g., guest resolution fit, drag and drop, and 
file and text copy/paste), you will need to do one (or more) of the following:
1. Manually start /usr/bin/vmware-user
2. Log out and log back into your desktop session; and,
3. Restart your X session.

Enjoy,

--the VMware team

Done waiting for process: 5523 (success)
Writing the command was a success to fd a
Child w/ fd 9 exited with code=0
Waiting on pid 5522 to de-zombify it
Cleaning up /tmp/0f61b83e... done.
Rpci: Sending request='tools.capability.hgfs_server tools-upgrader 0'
Rpci: Sent request='tools.capability.hgfs_server tools-upgrader 0', reply='', len=0, status=1
Unregistering callback 'f'