VMware Tools are specialized drivers for virtual hardware that is installed in the UC applications when they are running virtualized. ''It is very important that the VMware tools version running in the UC application be in sync with the version of ESXi being used''.

+

-

+

-

If VMware tools status does not show "OK" from the viClient, the VMware Tools must be upgraded.

+

-

+

-

It is important to understand that the UC application is ''not ''tied to the version of ESXi it is running on. For example, initial deployment of the OVA and UC application may have been done on ESXi 4.0 update 1. Then at a later time, you may upgrade the ESXi software to version 4.1 or migrate the vm to a host running ESXi 4.1 - once running on the different ESXi version, you will need to upgrade the VMware Tools running in your UC application to match the host it is running on. Software upgrades of the UC application will preserve the version of VMware Tools currently running.<br>

+

-

+

-

<br>

+

-

+

-

= Which method to use =

+

-

+

-

Early versions of the UC&nbsp;applications required a COP file in order to upgrade the VMware Tools. Later, a CLI command was created to make the upgrades easier. Finally once the application was running on a RHEL 5 base, it was possible to support automatic tools upgrades.

+

-

+

-

For a given application/release ONLY the supported method(s) to upgrade the tools. The use of the wrong method almost certainly will fail and at worst may corrupt your virtual machine

'''Step 1'''&nbsp;&nbsp;&nbsp; Download the VMware Tools Upgrade COP file located at the following location and and copy it to your SFTP/FTP server:&nbsp;&nbsp;<br>[http://www.cisco.com/cisco/software/release.html?mdfid=282827095&flowid=5329&softwareid=282204704&release=COP-Files&relind=AVAILABLE&rellifecycle=&reltype=latest http://www.cisco.com/cisco/software/release.html?mdfid=282827095&amp;flowid=5329&amp;softwareid=282204704&amp;release=COP-Files&amp;relind=AVAILABLE&amp;rellifecycle=&amp;reltype=latest],&nbsp;

+

-

+

-

'''Step 2'''&nbsp;&nbsp;&nbsp; From the vSphere Client log in to vCenter, or your ESXi host, and go to the '''Hosts and Clusters''' view ('''Ctrl+Shift+H''').

+

-

+

-

'''Step 3&nbsp;&nbsp;&nbsp;'''To mount the correct version of the VMware Tools software in the Guest virtual CD/DVD drive, perform the following sub-steps.

+

-

+

-

:'''a. '''&nbsp;Right-click the virtual machine that you are upgrading, and choose '''Guest &gt; Install/Upgrade VMware Tools'''.

<br>'''Step 4'''&nbsp;&nbsp;&nbsp; Log in to the Unified CM Operating System Administration GUI, and choose '''Software Installation/Upgrade'''.

+

-

+

-

:'''a. &nbsp;'''To install the VMware Tools Upgrade COP file that you downloaded in Step 1, enter the required information in the first page of the install/upgrade wizard.

+

-

+

-

:'''b.&nbsp;&nbsp;'''To install the COP file, continue with the install/upgrade wizard. Installation of the COP file installs the VMware Tools software that you mounted in the virtual CD/DVD drive in Step 3 above.

+

-

+

-

<br>'''Step 5'''&nbsp;&nbsp;&nbsp; To unmount the VMware Tools software from the virtual CD/DVD drive, after the COP file installation is complete, from the vSphere Client right-click the virtual machine that&nbsp;you upgraded, and choose '''VM &gt; Guest &gt; End VMware Tools Install'''.

+

-

+

-

<br>'''Step 6'''&nbsp;&nbsp;&nbsp; From the Unified CM CLI, enter the CLI command '''utils system restart''', or choose '''Settings''' '''&gt; Version &gt; Restart'''&nbsp; from the Unified CM Operating System Administration GUI. <br>The system restart completes the installation of the new version of VMware Tools. The virtual machine reboots twice. Monitor the virtual machine console from the vSphere&nbsp;Client to see the system status.

+

-

+

-

'''Step 7'''&nbsp;&nbsp;&nbsp; When the system is back up, the tools status is updated to '''OK '''from the vCenter Summary tab for the virtual machine that you upgraded. <br><br>

+

-

+

-

----

+

-

+

-

= Method 2: CLI command =

+

-

+

-

----

+

-

+

-

'''Step 1''' From the vSphere Client log in to vCenter, or your ESXi host, and go to the '''Hosts and Clusters''' view ('''Ctrl+Shift+H'''). <br>

+

-

+

-

'''Step 2'''<span style="font-weight: bold">&nbsp;&nbsp;&nbsp;</span>To mount the correct version of the VMware Tools software in the Guest virtual CD/DVD drive, perform the following sub-steps.

+

-

+

-

:'''a.''' Right-click the virtual machine that you are upgrading, and choose '''Guest &gt; Install/Upgrade VMware Tools'''.

The system reboots twice. Monitor the virtual machine console from the vSphere Client to see the system status.

+

-

+

-

'''Step 4'''When the system is back up, the tools status is updated to '''OK '''from the vCenter Summary tab for the virtual machine that you upgraded.

+

-

+

-

'''Step 5''' After installation of the new version of VMware Tools is complete, remove the VMware Tools tar file from the virtual CD/DVD drive. (Usually, the VMware Tools tar file is called linux.iso). To remove the VMware Tools tar file, perform the following substeps.

<br>'''Step 1'''&nbsp;&nbsp;&nbsp; From the viClient, Initiate the tools upgrade by clicking on '''VM &gt; Guest &gt; Install / Upgrade VMware Tools '''(this can also be done by right-clicking on the VM).

If the software release you are running supports Method 3 above (Automatic Upgrade),&nbsp; then you can configure your virtual machine to automatically check the tools version during each VM power-on and automatically upgrade the tools if they are not up-to-date. Use the following procedure to perform this upgrade.

+

-

+

-

<br>'''Step 1''' Edit the VM settings by clicking on the Options tab, and select '''VMware tools'''. Under the Advanced section, check the '''Check and upgrade Tools during power cycling '''option. <br>

+

-

+

-

<br>

+

-

+

-

::A check will now be performed each time the VM powers on to determine if the tools need to be updated. Updates are performed automatically.

+

-

+

-

<br>{{note| Note, if the tools do need to be updated the VM may go through an additional boot cycle to update the tools (which will be done automatically).}}