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. 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. EN-000275-01
User Guide
Page 2
...VMware products are covered by U.S. VMware, Inc. 3401 Hillview Ave. VMware Tools Configuration Utility User's Guide You can find the most up-to : docfeedback@vmware.com Copyright © 2009, 2010 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. Palo Alto, CA 94304 www.vmware.com 2 VMware...of VMware, Inc. VMware is protected by one or more patents listed at : http://www.vmware.com/support/ The VMware Web site also provides the latest product updates. All...
...VMware products are covered by U.S. VMware, Inc. 3401 Hillview Ave. VMware Tools Configuration Utility User's Guide You can find the most up-to : docfeedback@vmware.com Copyright © 2009, 2010 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. Palo Alto, CA 94304 www.vmware.com 2 VMware...of VMware, Inc. VMware is protected by one or more patents listed at : http://www.vmware.com/support/ The VMware Web site also provides the latest product updates. All...
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
... configure VMware Tools. If you . Customers with appropriate support contracts should use online support to submit technical support requests, view your product and contract information, and register your business needs, go to http://www.vmware.com/support/pubs. Courses are used in the classroom, and live online. About This Book The VMware Tools Configuration Utility User's Guide provides an introduction to using the VMware® Tools command-line utility to http://www.vmware.com/support/services. VMware Tools...
... configure VMware Tools. If you . Customers with appropriate support contracts should use online support to submit technical support requests, view your product and contract information, and register your business needs, go to http://www.vmware.com/support/pubs. Courses are used in the classroom, and live online. About This Book The VMware Tools Configuration Utility User's Guide provides an introduction to using the VMware® Tools command-line utility to http://www.vmware.com/support/services. VMware Tools...
User Guide
Page 6
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. VMware Tools Configuration Utility User's Guide Services provides offerings to http://www.vmware.com/services. 6 VMware, Inc.
User Guide
Page 7
... edit default scripts or associate custom scripts with power operations. n Shrink a Virtual Disk on page 12 Shrinking a virtual disk reclaims unused space in the VMware Tools control panel. n Configure Time Synchronization Between Guest and Host on page 8 When you turn on ESX, ESXi servers, you can connect and disconnect removable devices such as the time of the guest operating system to display complete usage information and syntax. For virtual machines hosted on periodic time synchronization, VMware Tools sets the time...
... edit default scripts or associate custom scripts with power operations. n Shrink a Virtual Disk on page 12 Shrinking a virtual disk reclaims unused space in the VMware Tools control panel. n Configure Time Synchronization Between Guest and Host on page 8 When you turn on ESX, ESXi servers, you can connect and disconnect removable devices such as the time of the guest operating system to display complete usage information and syntax. For virtual machines hosted on periodic time synchronization, VMware Tools sets the time...
User Guide
Page 8
.... 8 VMware, Inc. To disable time synchronization completely, you plan to script the commands used in this procedure and need to know what the exit codes are using native time synchronization software, turn on periodic time synchronization, synchronization can be the same as the time of the virtual machine and set several synchronization properties to C:\Program Files\VMware\VMware Tools. Option Windows Linux and Solaris FreeBSD Default Path Change directories to FALSE. Native time synchronization software, such...
.... 8 VMware, Inc. To disable time synchronization completely, you plan to script the commands used in this procedure and need to know what the exit codes are using native time synchronization software, turn on periodic time synchronization, synchronization can be the same as the time of the virtual machine and set several synchronization properties to C:\Program Files\VMware\VMware Tools. Option Windows Linux and Solaris FreeBSD Default Path Change directories to FALSE. Native time synchronization software, such...
User Guide
Page 9
... "Disable Time Synchronization Completely," on page 10. To configure the virtual machine so that its time never synchronizes with the host, see "VMware Tools Service," on page 9. A virtual machine occasionally synchronizes time with the host even if you specified. Procedure 1 Open the configuration (.vmx) file of the virtual machine with a text editor. 2 Add lines for the time synchronization properties and set some properties in the guest is enabled. Using the VMware Tools Configuration Utility 3 Enter the command...
... "Disable Time Synchronization Completely," on page 10. To configure the virtual machine so that its time never synchronizes with the host, see "VMware Tools Service," on page 9. A virtual machine occasionally synchronizes time with the host even if you specified. Procedure 1 Open the configuration (.vmx) file of the virtual machine with a text editor. 2 Add lines for the time synchronization properties and set some properties in the guest is enabled. Using the VMware Tools Configuration Utility 3 Enter the command...
User Guide
Page 10
... VMware product to script the commands used by certain backup applications. n In Windows guests, helps create the quiesced snapshots used in the management interface. Prerequisites If you shut down or restart the guest operating system. The service passes information between host and guest. Connect or Disconnect a Virtual Device You can access the floppy drive at any one of the virtual machine changes. When the virtual machine runs under ESX/ESXi, or VMware Server...
... VMware product to script the commands used by certain backup applications. n In Windows guests, helps create the quiesced snapshots used in the management interface. Prerequisites If you shut down or restart the guest operating system. The service passes information between host and guest. Connect or Disconnect a Virtual Device You can access the floppy drive at any one of the virtual machine changes. When the virtual machine runs under ESX/ESXi, or VMware Server...
User Guide
Page 11
... networking performance. utility-name device device-name subcommand Variable device-name subcommand Valid Value Use one of the names displayed when you complete this procedure, the device is connected. After you used for only 640 X 480 resolution and 16-color graphics. If you do a custom VMware Tools installation or reinstallation, you install VMware Tools, a virtual SVGA driver replaces the default VGA driver, which drivers to /usr/sbin. Which drivers are included with VMware Tools: SVGA driver This virtual driver enables...
... networking performance. utility-name device device-name subcommand Variable device-name subcommand Valid Value Use one of the names displayed when you complete this procedure, the device is connected. After you used for only 640 X 480 resolution and 16-color graphics. If you do a custom VMware Tools installation or reinstallation, you install VMware Tools, a virtual SVGA driver replaces the default VGA driver, which drivers to /usr/sbin. Which drivers are included with VMware Tools: SVGA driver This virtual driver enables...
User Guide
Page 12
.... 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 support making automatic backups VMCI and VMCI Sockets drivers On Windows guests whose operating system is required to use VMware ESX/ESXi. Shrink a Virtual Disk Shrinking a virtual disk reclaims unused space in the guest operating system. 12 VMware, Inc. It provides the same base functionality as deleted files) and...
.... 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 support making automatic backups VMCI and VMCI Sockets drivers On Windows guests whose operating system is required to use VMware ESX/ESXi. Shrink a Virtual Disk Shrinking a virtual disk reclaims unused space in the guest operating system. 12 VMware, Inc. It provides the same base functionality as deleted files) and...
User Guide
Page 13
... exported. n On Windows guests, you created it. Option Windows Linux and Solaris FreeBSD Action Change directories to shrink the disk at a specified mount point. Option Windows Linux, Solaris, and FreeBSD Action Use VMwareToolboxCmd.exe. Use vmware-toolbox-cmd. 4 Enter the command to C:\Program Files\VMware\VMware Tools. If the disk has empty space, this procedure and need to shrink the parts of the virtual disk that the host has free disk space equal to the size of space the virtual disk...
... exported. n On Windows guests, you created it. Option Windows Linux and Solaris FreeBSD Action Change directories to shrink the disk at a specified mount point. Option Windows Linux, Solaris, and FreeBSD Action Use VMwareToolboxCmd.exe. Use vmware-toolbox-cmd. 4 Enter the command to C:\Program Files\VMware\VMware Tools. If the disk has empty space, this procedure and need to shrink the parts of the virtual disk that the host has free disk space equal to the size of space the virtual disk...
User Guide
Page 14
VMware Tools Configuration Utility User's Guide Use Custom VMware Tools Scripts You can use scripts to automate guest operating system operations when you change the power state of the default scripts to determine whether you want to create a custom script by making changes and saving the edited scripts in a new location. You can configure settings so that it cannot display graphical applications. n On Linux, Solaris, and FreeBSD guests, to edit a script, make sure xterm and vi are installed in the guest and are...
VMware Tools Configuration Utility User's Guide Use Custom VMware Tools Scripts You can use scripts to automate guest operating system operations when you change the power state of the default scripts to determine whether you want to create a custom script by making changes and saving the edited scripts in a new location. You can configure settings so that it cannot display graphical applications. n On Linux, Solaris, and FreeBSD guests, to edit a script, make sure xterm and vi are installed in the guest and are...
User Guide
Page 15
... starts networking for each power state are located in part on page 10. What the default scripts do depends in the Program Files\VMware\VMware Tools folder. Default VMware Tools Scripts One or more default scripts for the virtual machine. Scripts cannot be run scripts on NetWare guests. This affects only virtual machines configured to use the full path to the file, such as, "C:\Temp\poweron-my-vm.bat". 7 Enter the command to enable the script. Using the VMware Tools Configuration...
... starts networking for each power state are located in part on page 10. What the default scripts do depends in the Program Files\VMware\VMware Tools folder. Default VMware Tools Scripts One or more default scripts for the virtual machine. Scripts cannot be run scripts on NetWare guests. This affects only virtual machines configured to use the full path to the file, such as, "C:\Temp\poweron-my-vm.bat". 7 Enter the command to enable the script. Using the VMware Tools Configuration...
User Guide
Page 16
... virtual machine. Disable a VMware Tools Script Default scripts for the virtual machine. This script has no effect on networking for one of these actions, you configured the power-on operation to suspend the guest, this script renews the IP address of a script, log in as well. If you configured the suspend operation to start the guest, this script runs when the virtual machine is being reset. If you configured the reset operation to use...
... virtual machine. Disable a VMware Tools Script Default scripts for the virtual machine. This script has no effect on networking for one of these actions, you configured the power-on operation to suspend the guest, this script renews the IP address of a script, log in as well. If you configured the suspend operation to start the guest, this script runs when the virtual machine is being reset. If you configured the reset operation to use...
User Guide
Page 17
... Files\VMware\VMware Tools. Change directories to display. Use power, resume, suspend, or shutdown. Prerequisites n Determine what the exit codes are, see "Exit Codes," on page 18. VMware, Inc. 17 utility-name script script-name disable Option utility-name (On Windows guests) utility-name (On Linux, Solaris, and FreeBSD guests) script-name Action Use VMwareToolboxCmd.exe. Use vmware-toolbox-cmd. Retrieve Status Information About the Virtual Machine You can display additional information about host time...
... Files\VMware\VMware Tools. Change directories to display. Use power, resume, suspend, or shutdown. Prerequisites n Determine what the exit codes are, see "Exit Codes," on page 18. VMware, Inc. 17 utility-name script script-name disable Option utility-name (On Windows guests) utility-name (On Linux, Solaris, and FreeBSD guests) script-name Action Use VMwareToolboxCmd.exe. Use vmware-toolbox-cmd. Retrieve Status Information About the Virtual Machine You can display additional information about host time...
User Guide
Page 18
... only) Displays the current session ID. 18 VMware, Inc. Subcommands for virtual machines hosted on the host. VMware Tools Configuration Utility User's Guide Option FreeBSD Mac Action Change directories to display information such as host time and CPU speed. Displays the CPU speed, in MHz. Subcommands for virtual machines hosted on an ESX/ESXi server. Change directories to '/Library/Application Support/VMware Tools'. 3 Enter the command to the virtual machine's swap file, in megabytes. Use hosttime or speed, or, if applicable, one...
... only) Displays the current session ID. 18 VMware, Inc. Subcommands for virtual machines hosted on the host. VMware Tools Configuration Utility User's Guide Option FreeBSD Mac Action Change directories to display information such as host time and CPU speed. Displays the CPU speed, in MHz. Subcommands for virtual machines hosted on an ESX/ESXi server. Change directories to '/Library/Application Support/VMware Tools'. 3 Enter the command to the virtual machine's swap file, in megabytes. Use hosttime or speed, or, if applicable, one...
User Guide
Page 19
... device does not exist. Using the VMware Tools Configuration Utility Exit Codes You might use exits codes if you want to display valid names of devices. The host does not support the query, perhaps because the host is not valid. Table 3. The command-line argument is not an ESX host (EX_TEMPFAIL). The file name does not exist. For the stat command, 69 means the program could not communicate with a scripting tool...
... device does not exist. Using the VMware Tools Configuration Utility Exit Codes You might use exits codes if you want to display valid names of devices. The host does not support the query, perhaps because the host is not valid. Table 3. The command-line argument is not an ESX host (EX_TEMPFAIL). The file name does not exist. For the stat command, 69 means the program could not communicate with a scripting tool...
User Guide
Page 21
... 5 R removable devices 10 resume-vm-default script 15 S script command 14 scripts, VMware Tools 14, 15 SCSI drivers, virtual 11 service, VMware Tools 10 session ID 17 shared folders, kernel module for 11 shrinking a virtual disk 12 sound adapters, connecting 10 stat command 17, 18 suspend-vm-default script 15 SVGA drivers, virtual 11 T technical support 5 time synchronization 8, 9 timesync command 8 U USB devices, connecting 10 V virtual disks, shrinking 12 VMCI drivers 11 vmhgfs kernel module 11 vmtoolsd 10 VMware Tools scripts custom 14 default 15 disabling 16 VMware Tools service 10 vmware...
... 5 R removable devices 10 resume-vm-default script 15 S script command 14 scripts, VMware Tools 14, 15 SCSI drivers, virtual 11 service, VMware Tools 10 session ID 17 shared folders, kernel module for 11 shrinking a virtual disk 12 sound adapters, connecting 10 stat command 17, 18 suspend-vm-default script 15 SVGA drivers, virtual 11 T technical support 5 time synchronization 8, 9 timesync command 8 U USB devices, connecting 10 V virtual disks, shrinking 12 VMCI drivers 11 vmhgfs kernel module 11 vmtoolsd 10 VMware Tools scripts custom 14 default 15 disabling 16 VMware Tools service 10 vmware...
User Guide
Page 22
VMware Tools Configuration Utility User's Guide vmware-tools-cli utility for Mac guests with Fusion 7 VMwareToolboxCmd.exe utility for Windows guests 7 vmxnet networking drivers 11 Volume Shadow Copy Services drivers 11 22 VMware, Inc.
VMware Tools Configuration Utility User's Guide vmware-tools-cli utility for Mac guests with Fusion 7 VMwareToolboxCmd.exe utility for Windows guests 7 vmxnet networking drivers 11 Volume Shadow Copy Services drivers 11 22 VMware, Inc.