User Guide
Page 1
EN-000275-01 To check for more recent editions of each product listed and supports all subsequent versions until the document is replaced by a new edition. 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.
EN-000275-01 To check for more recent editions of each product listed and supports all subsequent versions until the document is replaced by a new edition. 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
...find the most up-to : docfeedback@vmware.com Copyright © 2009, 2010 VMware, Inc. All other jurisdictions. in the United States and/or other marks and names mentioned herein may be trademarks of VMware, Inc. Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc. If you have comments ...about this documentation, submit your feedback to -date technical documentation on the VMware Web site at http://www.vmware.com/go/patents. This product is a...
...find the most up-to : docfeedback@vmware.com Copyright © 2009, 2010 VMware, Inc. All other jurisdictions. in the United States and/or other marks and names mentioned herein may be trademarks of VMware, Inc. Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc. If you have comments ...about this documentation, submit your feedback to -date technical documentation on the VMware Web site at http://www.vmware.com/go/patents. This product is a...
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
...on -the-job reference tools. To find out how VMware support offerings can help meet your products, go to http://www.vmware.com/support. For onsite pilot programs and implementation best practices, VMware Consulting VMware, Inc. 5 Customers with appropriate support contracts should ...definitions of a virtual machine. Users typically include administrators and others who configures VMware Tools. If you . To access the current version of VMware Tools by writing their own scripts. VMware Education Services courses offer extensive hands-on labs, case study examples, and...
...on -the-job reference tools. To find out how VMware support offerings can help meet your products, go to http://www.vmware.com/support. For onsite pilot programs and implementation best practices, VMware Consulting VMware, Inc. 5 Customers with appropriate support contracts should ...definitions of a virtual machine. Users typically include administrators and others who configures VMware Tools. If you . To access the current version of VMware Tools by writing their own scripts. VMware Education Services courses offer extensive hands-on labs, case study examples, and...
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
... ESX, ESXi servers, you can display additional information about host time and CPU speed. After that was previously available only in the VMware Tools control panel. This program is synchronized to match the clock on page 17 You can display information about memory and CPU reservations...with power operations. n Connect or Disconnect a Virtual Device on the guest is called VMwareToolboxCmd.exe in Windows guests, vmware-tools-cli in Mac guests, and vmware-toolbox-cmd in the virtual disk and reduces the amount of the host. You can connect and disconnect removable devices such...
... ESX, ESXi servers, you can display additional information about host time and CPU speed. After that was previously available only in the VMware Tools control panel. This program is synchronized to match the clock on page 17 You can display information about memory and CPU reservations...with power operations. n Connect or Disconnect a Virtual Device on the guest is called VMwareToolboxCmd.exe in Windows guests, vmware-tools-cli in Mac guests, and vmware-toolbox-cmd in the virtual disk and reduces the amount of the host. You can connect and disconnect removable devices such...
User Guide
Page 8
... not, the clock on the guest is therefore preferred. To disable time synchronization completely, you turn on VMware Tools periodic time synchronization, time synchronization occurs when the VMware Tools daemon is forward in time. Prerequisites Disable other events, synchronization is started (such as during a ... Use only one form of sync with the host. NOTE Mac guests use NTP and do not disable VMware Tools time synchronization completely. Change directories to the VMware Tools installation directory. If the clock on the guest is typically more slowly until the clocks are , ...
... not, the clock on the guest is therefore preferred. To disable time synchronization completely, you turn on VMware Tools periodic time synchronization, time synchronization occurs when the VMware Tools daemon is forward in time. Prerequisites Disable other events, synchronization is started (such as during a ... Use only one form of sync with the host. NOTE Mac guests use NTP and do not disable VMware Tools time synchronization completely. Change directories to the VMware Tools installation directory. If the clock on the guest is typically more slowly until the clocks are , ...
User Guide
Page 9
... see "Disable Time Synchronization Completely," on page 9. For information about the additional functionality this procedure, the VMware Tools service enables or disables periodic time synchronization, as you specified. To completely disable time synchronization, you must... disable time synchronization completely. utility-name timesync subcommand For subcommand, use the guest-specific program name. VMware, Inc. 9 tools.syncTime = "FALSE" time.synchronize.continue = "FALSE" time.synchronize.restore = "FALSE" time.synchronize.resume.disk...
... see "Disable Time Synchronization Completely," on page 9. For information about the additional functionality this procedure, the VMware Tools service enables or disables periodic time synchronization, as you specified. To completely disable time synchronization, you must... disable time synchronization completely. utility-name timesync subcommand For subcommand, use the guest-specific program name. VMware, Inc. 9 tools.syncTime = "FALSE" time.synchronize.continue = "FALSE" time.synchronize.restore = "FALSE" time.synchronize.resume.disk...
User Guide
Page 10
...The service passes information between the guest and host. n Provides support for guest-bound calls created with the time on page 19. 10 VMware, Inc. IMPORTANT Note the following tasks: n Passes messages from the host to the screen resolution of the guest to the guest operating system...the time in Linux, FreeBSD, Solaris guests. n In Windows guests, fits the screen resolution of the processes that sends a heartbeat to the VMware product to move freely between host and guest. n The controls for this procedure and need to script the commands used by certain backup applications....
...The service passes information between the guest and host. n Provides support for guest-bound calls created with the time on page 19. 10 VMware, Inc. IMPORTANT Note the following tasks: n Passes messages from the host to the screen resolution of the guest to the guest operating system...the time in Linux, FreeBSD, Solaris guests. n In Windows guests, fits the screen resolution of the processes that sends a heartbeat to the VMware product to move freely between host and guest. n The controls for this procedure and need to script the commands used by certain backup applications....
User Guide
Page 11
...drivers to determine whether a device is connected or disconnected, as folder sharing available, and improve sound, graphics, and networking performance. Use vmware-tools-cli. 4 (Optional) Enter the command to install. Use enable or disable. The following device drivers are installed when you ...complete this procedure, the device is connected. Option Windows Linux, Solaris, and FreeBSD Mac Action Use VMwareToolboxCmd.exe. Use vmware-toolbox-cmd. utility-name device device-name subcommand Variable device-name subcommand Valid Value Use one of the names displayed when...
...drivers to determine whether a device is connected or disconnected, as folder sharing available, and improve sound, graphics, and networking performance. Use vmware-tools-cli. 4 (Optional) Enter the command to install. Use enable or disable. The following device drivers are installed when you ...complete this procedure, the device is connected. Option Windows Linux, Solaris, and FreeBSD Mac Action Use VMwareToolboxCmd.exe. Use vmware-toolbox-cmd. utility-name device device-name subcommand Variable device-name subcommand Valid Value Use one of the names displayed when...
User Guide
Page 12
..., if you specify that you use of disk partitions (such as the SVGA driver, and it adds Windows Aero support. VMware Tools Configuration Utility User's Guide SCSI driver Paravirtual SCSI driver VMXNet NIC drivers Mouse driver Audio driver Kernel module for sharing folders... Memory control driver Modules and drivers that VMware Tools provides. For example, Windows Server 2008 defaults to create application-consistent snapshots. The Virtual Machine Communication Interface driver allows...
..., if you specify that you use of disk partitions (such as the SVGA driver, and it adds Windows Aero support. VMware Tools Configuration Utility User's Guide SCSI driver Paravirtual SCSI driver VMXNet NIC drivers Mouse driver Audio driver Kernel module for sharing folders... Memory control driver Modules and drivers that VMware Tools provides. For example, Windows Server 2008 defaults to create application-consistent snapshots. The Virtual Machine Communication Interface driver allows...
User Guide
Page 13
... virtual machine is exported. n The virtual disk is not allowed under the following tasks: n On Linux, Solaris, and FreeBSD guests, run VMware Tools as a user with Administrator privileges to know what the exit codes are, see "Exit Codes," on the disk space reclaimed during the ...preparation step. Change directories to /usr/local/sbin. 3 Enter the command to the VMware Tools installation directory. n You preallocated all the disk space to shrink. Procedure 1 Open a command prompt or terminal in as the root user...
... virtual machine is exported. n The virtual disk is not allowed under the following tasks: n On Linux, Solaris, and FreeBSD guests, run VMware Tools as a user with Administrator privileges to know what the exit codes are, see "Exit Codes," on the disk space reclaimed during the ...preparation step. Change directories to /usr/local/sbin. 3 Enter the command to the VMware Tools installation directory. n You preallocated all the disk space to shrink. Procedure 1 Open a command prompt or terminal in as the root user...
User Guide
Page 14
...used in this procedure and need to know what the exit codes are run as root on Mac guests. Scripts are , see "Default VMware Tools Scripts," on page 15. Do not attempt to use by setting the EDITOR environment variable. Prerequisites Perform one or more of the ... and FreeBSD and as a shell or Perl script. 3 Open a command prompt or terminal in the guest. 4 Change to the VMware Tools installation directory. Edit scripts in /etc/vmware-tools. 2 Write new scripts or modify default scripts and save them with power operations. Option Windows guests Linux, Solaris, and FreeBSD...
...used in this procedure and need to know what the exit codes are run as root on Mac guests. Scripts are , see "Default VMware Tools Scripts," on page 15. Do not attempt to use by setting the EDITOR environment variable. Prerequisites Perform one or more of the ... and FreeBSD and as a shell or Perl script. 3 Open a command prompt or terminal in the guest. 4 Change to the VMware Tools installation directory. Edit scripts in /etc/vmware-tools. 2 Write new scripts or modify default scripts and save them with power operations. Option Windows guests Linux, Solaris, and FreeBSD...
User Guide
Page 15
...utility-name script script-name set script-path For script-path, use DHCP. For information about the additional functionality this procedure, the VMware Tools service runs the script whenever the specified power operation occurs. On Linux, Solaris, and FreeBSD guests, the default scripts are ...default script that runs when you suspend a virtual machine stops networking for each power state are included in the /etc/vmware-tools directory. Using the VMware Tools Configuration Utility 5 Enter the command to verify that runs when you suspend a virtual machine releases the IP address of...
...utility-name script script-name set script-path For script-path, use DHCP. For information about the additional functionality this procedure, the VMware Tools service runs the script whenever the specified power operation occurs. On Linux, Solaris, and FreeBSD guests, the default scripts are ...default script that runs when you suspend a virtual machine stops networking for each power state are included in the /etc/vmware-tools directory. Using the VMware Tools Configuration Utility 5 Enter the command to verify that runs when you suspend a virtual machine releases the IP address of...
User Guide
Page 16
... to shut down the guest, this script runs when the virtual machine is being powered on networking for the other action as root. 16 VMware, Inc. If you configured the power-on operation to use DHCP, this script runs when the virtual machine is being suspended. On Windows ...guests, if the virtual machine is configured to suspend the guest, this script runs after it was suspended. Disable a VMware Tools Script Default scripts for one of the virtual machine. If you configured the power-on networking for the virtual machine. On Linux, Solaris, ...
... to shut down the guest, this script runs when the virtual machine is being powered on networking for the other action as root. 16 VMware, Inc. If you configured the power-on operation to use DHCP, this script runs when the virtual machine is being suspended. On Windows ...guests, if the virtual machine is configured to suspend the guest, this script runs after it was suspended. Disable a VMware Tools Script Default scripts for one of the virtual machine. If you configured the power-on networking for the virtual machine. On Linux, Solaris, ...
User Guide
Page 17
... "Subcommands for suspending. Change directories to /usr/sbin. Change directories to /usr/local/sbin. 3 Enter the command to C:\Program Files\VMware\VMware Tools. utility-name script script-name disable Option utility-name (On Windows guests) utility-name (On Linux, Solaris, and FreeBSD guests) ...want to display. Prerequisites n Determine what the exit codes are, see "Exit Codes," on the guest. 2 Change to the VMware Tools installation directory. Option Windows Linux and Solaris Action Change directories to disable the script. For virtual machines hosted on page 18....
... "Subcommands for suspending. Change directories to /usr/sbin. Change directories to /usr/local/sbin. 3 Enter the command to C:\Program Files\VMware\VMware Tools. utility-name script script-name disable Option utility-name (On Windows guests) utility-name (On Linux, Solaris, and FreeBSD guests) ...want to display. Prerequisites n Determine what the exit codes are, see "Exit Codes," on the guest. 2 Change to the VMware Tools installation directory. Option Windows Linux and Solaris Action Change directories to disable the script. For virtual machines hosted on page 18....
User Guide
Page 18
...cpures (ESX/ESXi only) Displays memory reservation information, in megabytes. (ESX/ESXi only) Displays CPU reservation information, in MHz. Use vmware-tools-cli. utility-name stat subcommand Option utility-name (On Windows guests) utility-name (On Linux, Solaris, and FreeBSD guests) ...(ESX/ESXi only) Displays the current session ID. 18 VMware, Inc. Change directories to '/Library/Application Support/VMware Tools'. 3 Enter the command to display information such as host time and CPU speed. VMware Tools Configuration Utility User's Guide Option FreeBSD Mac Action Change...
...cpures (ESX/ESXi only) Displays memory reservation information, in megabytes. (ESX/ESXi only) Displays CPU reservation information, in MHz. Use vmware-tools-cli. utility-name stat subcommand Option utility-name (On Windows guests) utility-name (On Linux, Solaris, and FreeBSD guests) ...(ESX/ESXi only) Displays the current session ID. 18 VMware, Inc. Change directories to '/Library/Application Support/VMware Tools'. 3 Enter the command to display information such as host time and CPU speed. VMware Tools Configuration Utility User's Guide Option FreeBSD Mac Action Change...
User Guide
Page 19
... host (EX_TEMPFAIL). Always indicates that although shrinking is enabled, the shrink command cannot be carried out. 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. Using the... Configuration Utility Exit Codes You might use exits codes if you want to display valid names of devices. VMware, Inc. 19 For the shrink command, 1 means that an error occurred. For the device command, 69 means the specified device does not exist. ...
... host (EX_TEMPFAIL). Always indicates that although shrinking is enabled, the shrink command cannot be carried out. 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. Using the... Configuration Utility Exit Codes You might use exits codes if you want to display valid names of devices. VMware, Inc. 19 For the shrink command, 1 means that an error occurred. For the device command, 69 means the specified device does not exist. ...