User Guide
Page 1
To check for more recent editions of each product listed and supports all subsequent versions until the document is replaced by a new edition. EN-000275-01 VMware Tools Configuration Utility User's Guide VMware Fusion 3.0 vSphere 4.1 VMware Workstation 7.0 VMware Player 3.0 This document supports the version of this document, see http://www.vmware.com/support/pubs.
To check for more recent editions of each product listed and supports all subsequent versions until the document is replaced by a new edition. EN-000275-01 VMware Tools Configuration Utility User's Guide VMware Fusion 3.0 vSphere 4.1 VMware Workstation 7.0 VMware Player 3.0 This document supports the version of this document, see http://www.vmware.com/support/pubs.
User Guide
Page 2
... and names mentioned herein may be trademarks of VMware, Inc. Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc. and international copyright and intellectual property laws. VMware Tools Configuration Utility User's Guide You can find the most up-to : docfeedback@vmware.com Copyright © 2009, 2010 VMware, Inc. VMware, Inc. 3401 Hillview Ave. If you have comments...
... and names mentioned herein may be trademarks of VMware, Inc. Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc. and international copyright and intellectual property laws. VMware Tools Configuration Utility User's Guide You can find the most up-to : docfeedback@vmware.com Copyright © 2009, 2010 VMware, Inc. VMware, Inc. 3401 Hillview Ave. If you have comments...
User Guide
Page 3
Contents About This Book 5 Using the VMware Tools Configuration Utility 7 Configure Time Synchronization Between Guest and Host 8 Disable Time Synchronization Completely 9 VMware Tools Service 10 Connect or Disconnect a Virtual Device 10 VMware Tools Device Drivers 11 Shrink a Virtual Disk 12 Use Custom VMware Tools Scripts 14 Default VMware Tools Scripts 15 Disable a VMware Tools Script 16 Retrieve Status Information About the Virtual Machine 17 Subcommands for the stat Command 18 Exit Codes 19 Index 21 VMware, Inc. 3
Contents About This Book 5 Using the VMware Tools Configuration Utility 7 Configure Time Synchronization Between Guest and Host 8 Disable Time Synchronization Completely 9 VMware Tools Service 10 Connect or Disconnect a Virtual Device 10 VMware Tools Device Drivers 11 Shrink a Virtual Disk 12 Use Custom VMware Tools Scripts 14 Default VMware Tools Scripts 15 Disable a VMware Tools Script 16 Retrieve Status Information About the Virtual Machine 17 Subcommands for the stat Command 18 Exit Codes 19 Index 21 VMware, Inc. 3
User Guide
Page 5
...view your product and contract information, and register your feedback to http://www.vmware.com/support. VMware Education Services courses offer extensive hands-on -the-job reference tools. VMware Technical Publications Glossary VMware Technical Publications provides a glossary of terms that enhances the performance of a ...Audience This book is a suite of this book and other books, go to docfeedback@vmware.com. For definitions of VMware Tools by writing their own scripts. Document Feedback VMware welcomes your business needs, go to automate configuration of terms as on labs, case ...
...view your product and contract information, and register your feedback to http://www.vmware.com/support. VMware Education Services courses offer extensive hands-on -the-job reference tools. VMware Technical Publications Glossary VMware Technical Publications provides a glossary of terms that enhances the performance of a ...Audience This book is a suite of this book and other books, go to docfeedback@vmware.com. For definitions of VMware Tools by writing their own scripts. Document Feedback VMware welcomes your business needs, go to automate configuration of terms as on labs, case ...
User Guide
Page 6
VMware Tools Configuration Utility User's Guide Services provides offerings to http://www.vmware.com/services. 6 VMware, Inc. To access information about education classes, certification programs, and consulting services, go to help you assess, plan, build, and manage your virtual environment.
VMware Tools Configuration Utility User's Guide Services provides offerings to http://www.vmware.com/services. 6 VMware, Inc. To access information about education classes, certification programs, and consulting services, go to help you assess, plan, build, and manage your virtual environment.
User Guide
Page 7
... scripts with power operations. After that was previously available only in the VMware Tools control panel. The VMware Tools configuration utility provides a command-line interface for this release: n VMware ESX/ESXi 4.1 and later n VMware Workstation 7.0 and later n VMware Fusion 3.0 and later n VMware Player 3.0 and later n VMware ACE 2.6 and later You can use this utility in the guest operating...
... scripts with power operations. After that was previously available only in the VMware Tools control panel. The VMware Tools configuration utility provides a command-line interface for this release: n VMware ESX/ESXi 4.1 and later n VMware Workstation 7.0 and later n VMware Fusion 3.0 and later n VMware Player 3.0 and later n VMware ACE 2.6 and later You can use this utility in the guest operating...
User Guide
Page 8
... match. For other periodic time synchronization mechanisms. For example, some guests might have NTP or Win32Time clock synchronization turned on VMware Tools time synchronization. Option Windows Linux and Solaris FreeBSD Default Path Change directories to determine whether the clocks on the guest to... a snapshot, and after reverting to run more accurate than VMware Tools periodic time synchronization and is started (such as during a reboot or power on operation), when resuming a virtual machine from a...
... match. For other periodic time synchronization mechanisms. For example, some guests might have NTP or Win32Time clock synchronization turned on VMware Tools time synchronization. Option Windows Linux and Solaris FreeBSD Default Path Change directories to determine whether the clocks on the guest to... a snapshot, and after reverting to run more accurate than VMware Tools periodic time synchronization and is started (such as during a reboot or power on operation), when resuming a virtual machine from a...
User Guide
Page 9
... the host even if you must disable time synchronization completely. utility-name timesync status For utility-name use enable or disable. Use vmware-toolbox-cmd. 4 Enter the command to FALSE. Disable Time Synchronization Completely If you want to keep a fictitious time in a virtual... that on the host, you must set the properties to enable or disable periodic time synchronization. Prerequisites Power off the virtual machine. VMware, Inc. 9 utility-name timesync subcommand For subcommand, use the guest-specific program name. To completely disable time synchronization, you do...
... the host even if you must disable time synchronization completely. utility-name timesync status For utility-name use enable or disable. Use vmware-toolbox-cmd. 4 Enter the command to FALSE. Disable Time Synchronization Completely If you want to keep a fictitious time in a virtual... that on the host, you must set the properties to enable or disable periodic time synchronization. Prerequisites Power off the virtual machine. VMware, Inc. 9 utility-name timesync subcommand For subcommand, use the guest-specific program name. To completely disable time synchronization, you do...
User Guide
Page 10
... between two guests. n In Linux, Solaris, and FreeBSD guests, executes commands in the management interface. NOTE In Mac guests, the VMware Tools service only fits the screen resolution of the guest to the screen resolution of the host. The service passes information between the guest... such as floppy drives, DVD/CD-ROM drives, ISO images, USB devices, sound adapters, and network adapters. VMware Tools Configuration Utility User's Guide VMware Tools Service The VMware Tools service starts when the guest operating system boots. n Provides support for guest-bound calls created with the time...
... between two guests. n In Linux, Solaris, and FreeBSD guests, executes commands in the management interface. NOTE In Mac guests, the VMware Tools service only fits the screen resolution of the guest to the screen resolution of the host. The service passes information between the guest... such as floppy drives, DVD/CD-ROM drives, ISO images, USB devices, sound adapters, and network adapters. VMware Tools Configuration Utility User's Guide VMware Tools Service The VMware Tools service starts when the guest operating system boots. n Provides support for guest-bound calls created with the time...
User Guide
Page 11
... whether a device is connected or disconnected, as folder sharing available, and improve sound, graphics, and networking performance. VMware, Inc. 11 Use vmware-tools-cli. 4 (Optional) Enter the command to connect or disconnect the device. utility-name device status device-name... significantly faster graphics performance. The following device drivers are installed when you can choose which allows for device functionality, see "VMware Tools Device Drivers," on the guest. 2 Change to install. Change directories to /usr/sbin. After you complete this ...
... whether a device is connected or disconnected, as folder sharing available, and improve sound, graphics, and networking performance. VMware, Inc. 11 Use vmware-tools-cli. 4 (Optional) Enter the command to connect or disconnect the device. utility-name device status device-name... significantly faster graphics performance. The following device drivers are installed when you can choose which allows for device functionality, see "VMware Tools Device Drivers," on the guest. 2 Change to install. Change directories to /usr/sbin. After you complete this ...
User Guide
Page 12
... machine on the host. Which driver is used . Search the VMware Knowledge Base for information on how you use the virtual machine with VMware Server, Workstation, or Fusion. When you want the virtual machine to use VMware ESX/ESXi. This sound driver is required to use of space ...Windows Server 2008, and Windows Vista guests if you use the virtual machine with Workstation or Fusion and share folders between virtual machines. When you create a virtual machine, if you specify that you install VMware Tools, a VMXNet NIC driver replaces the default vlance driver. The virtual mouse ...
... machine on the host. Which driver is used . Search the VMware Knowledge Base for information on how you use the virtual machine with VMware Server, Workstation, or Fusion. When you want the virtual machine to use VMware ESX/ESXi. This sound driver is required to use of space ...Windows Server 2008, and Windows Vista guests if you use the virtual machine with Workstation or Fusion and share folders between virtual machines. When you create a virtual machine, if you specify that you install VMware Tools, a VMXNet NIC driver replaces the default vlance driver. The virtual mouse ...
User Guide
Page 13
...Linux, Solaris, and FreeBSD Action Use VMwareToolboxCmd.exe. n The virtual machine has a Mac guest operating system. If you plan to the VMware Tools installation directory. Change directories to list available mount points. The shrink step takes place outside the virtual machine. n You preallocated all ... machine is a linked clone or the parent of space the virtual disk occupies on page 19. Use vmware-toolbox-cmd. 4 Enter the command to C:\Program Files\VMware\VMware Tools. The space occupied by the virtual disk on an ESX/ESXi server. utility-name disk list For...
...Linux, Solaris, and FreeBSD Action Use VMwareToolboxCmd.exe. n The virtual machine has a Mac guest operating system. If you plan to the VMware Tools installation directory. Change directories to list available mount points. The shrink step takes place outside the virtual machine. n You preallocated all ... machine is a linked clone or the parent of space the virtual disk occupies on page 19. Use vmware-toolbox-cmd. 4 Enter the command to C:\Program Files\VMware\VMware Tools. The space occupied by the virtual disk on an ESX/ESXi server. utility-name disk list For...
User Guide
Page 14
... Option Windows Linux and Solaris FreeBSD Action Change directories to /usr/sbin. n On Linux, Solaris, and FreeBSD guests, to the VMware Tools installation directory. IMPORTANT This utility cannot run scripts on Windows NT, Me, Windows 98, or Windows 95 guest operating systems. Scripts... are run in a separate session from the session of the logged-in Program Files\VMware\VMware Tools. VMware Tools Configuration Utility User's Guide Use Custom VMware Tools Scripts You can configure settings so that it cannot display graphical applications. You can also edit default...
... Option Windows Linux and Solaris FreeBSD Action Change directories to /usr/sbin. n On Linux, Solaris, and FreeBSD guests, to the VMware Tools installation directory. IMPORTANT This utility cannot run scripts on Windows NT, Me, Windows 98, or Windows 95 guest operating systems. Scripts... are run in a separate session from the session of the logged-in Program Files\VMware\VMware Tools. VMware Tools Configuration Utility User's Guide Use Custom VMware Tools Scripts You can configure settings so that it cannot display graphical applications. You can also edit default...
User Guide
Page 15
... virtual machine releases the IP address of the virtual machine. utility-name script script-name current After you complete this service performs, see "VMware Tools Service," on the guest operating system: n On most Linux, Solaris, and FreeBSD guests, the default script that the custom script you... suspend a virtual machine stops networking for the virtual machine. What the default scripts do depends in VMware Tools. The default script that runs when you resume a virtual machine renews the IP address of the virtual machine. The default ...
... virtual machine releases the IP address of the virtual machine. utility-name script script-name current After you complete this service performs, see "VMware Tools Service," on the guest operating system: n On most Linux, Solaris, and FreeBSD guests, the default script that the custom script you... suspend a virtual machine stops networking for the virtual machine. What the default scripts do depends in VMware Tools. The default script that runs when you resume a virtual machine renews the IP address of the virtual machine. The default ...
User Guide
Page 16
... Utility User's Guide Table 1. Default VMware Tools Scripts Script Name poweroff-vm-default poweron-vm-default resume-vm-default suspend-vm-default Description If you configured the power-on networking for ... machine is being suspended. If you configured the reset operation to work together. If you configured the power-on networking for the virtual machine. Disable a VMware Tools Script Default scripts for the other action as root. 16 VMware, Inc. IMPORTANT This utility cannot run scripts in as well.
... Utility User's Guide Table 1. Default VMware Tools Scripts Script Name poweroff-vm-default poweron-vm-default resume-vm-default suspend-vm-default Description If you configured the power-on networking for ... machine is being suspended. If you configured the reset operation to work together. If you configured the power-on networking for the virtual machine. Disable a VMware Tools Script Default scripts for the other action as root. 16 VMware, Inc. IMPORTANT This utility cannot run scripts in as well.
User Guide
Page 17
...for the stat Command," on page 19. Change directories to /usr/local/sbin. 3 Enter the command to C:\Program Files\VMware\VMware Tools. Option Windows Linux and Solaris FreeBSD Action Change directories to disable the script. Option Windows Linux and Solaris Action Change ...directories to /usr/sbin. See "Subcommands for suspending. Change directories to C:\Program Files\VMware\VMware Tools. VMware, Inc. 17 For virtual machines hosted on the guest. 2 Change to display. Change directories to know what status information ...
...for the stat Command," on page 19. Change directories to /usr/local/sbin. 3 Enter the command to C:\Program Files\VMware\VMware Tools. Option Windows Linux and Solaris FreeBSD Action Change directories to disable the script. Option Windows Linux and Solaris Action Change ...directories to /usr/sbin. See "Subcommands for suspending. Change directories to C:\Program Files\VMware\VMware Tools. VMware, Inc. 17 For virtual machines hosted on the guest. 2 Change to display. Change directories to know what status information ...
User Guide
Page 18
... is currently reclaimed from the virtual machine through ballooning, in megabytes. sessionid (ESX/ESXi only) Displays the current session ID. 18 VMware, Inc. utility-name stat subcommand Option utility-name (On Windows guests) utility-name (On Linux, Solaris, and FreeBSD guests) utility...-name (On Mac guests) subcommand Action Use VMwareToolboxCmd.exe. Use vmware-toolbox-cmd. Subcommands for virtual machines hosted on an ESX/ESXi server. memlimit (ESX/ESXi only) Displays memory limit information, in MHz...
... is currently reclaimed from the virtual machine through ballooning, in megabytes. sessionid (ESX/ESXi only) Displays the current session ID. 18 VMware, Inc. utility-name stat subcommand Option utility-name (On Windows guests) utility-name (On Linux, Solaris, and FreeBSD guests) utility...-name (On Mac guests) subcommand Action Use VMwareToolboxCmd.exe. Use vmware-toolbox-cmd. Subcommands for virtual machines hosted on an ESX/ESXi server. memlimit (ESX/ESXi only) Displays memory limit information, in MHz...
User Guide
Page 19
...The file name does not exist. For the device command, 69 means the specified device does not exist. Use the list subcommand to integrate the VMware Tools configuration utility commands with the host (EX_UNAVAILABLE). The host does not support the query, perhaps because the host is not valid. Always indicates... means the program could not communicate with a scripting tool. Permission errors. Table 3. For the shrink command, 1 means that an error occurred. Using the VMware Tools Configuration Utility Exit Codes You might use exits codes if you want to display valid names of devices...
...The file name does not exist. For the device command, 69 means the specified device does not exist. Use the list subcommand to integrate the VMware Tools configuration utility commands with the host (EX_UNAVAILABLE). The host does not support the query, perhaps because the host is not valid. Always indicates... means the program could not communicate with a scripting tool. Permission errors. Table 3. For the shrink command, 1 means that an error occurred. Using the VMware Tools Configuration Utility Exit Codes You might use exits codes if you want to display valid names of devices...