Installation and Upgrade Guide : Upgrading Virtual Machines : Upgrading to VMware Tools 3 : Upgrading Hardware and VMware Tools in Multiple Virtual Machines

Upgrading Hardware and VMware Tools in Multiple Virtual Machines
This feature allows you to upgrade VMware Tools and virtual hardware for one or more virtual machines from earlier releases. Using an ESX Server version 3 host, VMware Tools and virtual hardware can be upgraded for multiple virtual machines simultaneously without needing to interact with each virtual machine from the console. The user performing the upgrade must have appropriate permissions.
Requirements
To upgrade VMware Tools and virtual hardware on multiple virtual machines
1
For example, on a Windows 2000 Professional machine, choose:
Start > Programs > Accessories > Command Prompt
2
3
Use the following command syntax:
vmware-vmupgrade.exe -u user [-p password] [-n vmname] [-h host]
[-m maxpowerons] [-o port] [-t maxpowerontime] [-s] [-q]
 
Specifies a user with sufficient privileges on the target virtual machine, including VirtualMachine.Config.*, VirtualMa­chine.Interact.*, and VirtualMachine.Provisioning.*
Specifies a password on the command line. If this is omitted, the tool immediately prompts for a password.
The name of the virtual machine to upgrade. This name cor­responds to the display name of a virtual machine. Specify multiple virtual machines using multiple -n parameters. The -n option is ignored if -h is specified.
See Specifying Host or Virtual Machine Names for more information on this parameter.
Attempts to upgrade all the virtual machines on a particular host. Fails if the specified host is not version ESX Server 3.0 or greater.
See Specifying Host or Virtual Machine Names for more information on this parameter.
-t maxpoweron ­ time
After the tools upgrade is scheduled on a virtual machine, the virtual machine is powered on and allowed to run through the tools installation process. In most cases, the guest powers down the machine automatically when the process com­pletes. This parameter allows a user to set the maximum amount of time for a virtual machine to be powered on in case the guest is unable to power off the machine itself.
-s
-q
Specifying Host or Virtual Machine Names
To specify a host or a virtual machine name for the vmware-vmupgrade.exe command, you must specify a path to the host or virtual machine. The path corresponds to the location of the host or virtual machine displayed in the VI Client inventory. To determine host paths, display the Hosts and Clusters view in the inventory panel. To determine virtual machine paths, display the Virtual Machines and Templates view in the inventory panel.
For the case illustrated in Figure 10-1, the path for the host testserver3.eng.vmware.com is /Datacenter1/Folder1/testserver3.eng.vmware.com.
Figure 10-1. Example Hosts and Clusters Inventory View, Showing the Path for a Host
For the case illustrated in Figure 10-2, the path for the virtual machine vm1 is /Datacenter1/MyVMs/vm1.
Figure 10-2. Example Virtual Machines and Templates Inventory View, Showing the Path for a Virtual Machine
Usage Examples
The following are some usage examples for the vmware-vmupgrade command:
vmware-vmupgrade -u user -n /DC/myvm
vmware-vmupgrade -u user -n /dcFolder/DC/MyVMs/vm1
To upgrade two virtual machines, vm1 and vm2, both in datacenter DC, and to force all virtual machines to power off after 5 five minutes. One virtual machine is a Linux virtual machine that does not have Advanced Power Management configured, so that when the guest is shutdown, the virtual machine doesn't power off.
vmware-vmupgrade -u user -n /DC/vm1 -n /DC/vm2 -t 5
To upgrade all (powered-off) virtual machines on host myhost.vmware.com in the root host folder of datacenter DC, while powering-on at most two virtual machines at a time on the host:
vmware-vmupgrade -u user -h /DC/myhost.vmware.com -m 2
vmware-vmupgrade -u user -h /DC/folder1/myCluster/host1.vmware.com