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
...trademarks of VMware, Inc. VMware, Inc. 3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc. All rights reserved. VMware products are covered by U.S. All other jurisdictions. VMware is protected by one or more patents listed at : http://www.vmware.com/support/ The VMware Web ... about this documentation, submit your feedback to -date technical documentation on the VMware Web site at http://www.vmware.com/go/patents. and international copyright and intellectual property laws. VMware Tools Configuration Utility User's Guide You can find the most up-to :...
...trademarks of VMware, Inc. VMware, Inc. 3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc. All rights reserved. VMware products are covered by U.S. All other jurisdictions. VMware is protected by one or more patents listed at : http://www.vmware.com/support/ The VMware Web ... about this documentation, submit your feedback to -date technical documentation on the VMware Web site at http://www.vmware.com/go/patents. and international copyright and intellectual property laws. VMware Tools Configuration Utility User's Guide You can find the most up-to :...
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
... terms as they are used as on priority 1 issues. For onsite pilot programs and implementation best practices, VMware Consulting VMware, Inc. 5 VMware Technical Publications Glossary VMware Technical Publications provides a glossary of terms that enhances the performance of utilities that might be used in the ...classroom, and live online. Online and Telephone Support Support Offerings VMware Professional Services To use telephone support for anyone who want to automate configuration of this book and other books, go...
... terms as they are used as on priority 1 issues. For onsite pilot programs and implementation best practices, VMware Consulting VMware, Inc. 5 VMware Technical Publications Glossary VMware Technical Publications provides a glossary of terms that enhances the performance of utilities that might be used in the ...classroom, and live online. Online and Telephone Support Support Offerings VMware Professional Services To use telephone support for anyone who want to automate configuration of this book and other books, go...
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
... Shrinking a virtual disk reclaims unused space in the virtual disk and reduces the amount of space the virtual disk occupies on periodic time synchronization, VMware Tools sets the time of the guest operating system to be the same as floppy drives, DVD/CD-ROM drives, ISO images, USB devices,... Use its help command to perform several tasks. If not, the clock on the guest is called VMwareToolboxCmd.exe in Windows guests, vmware-tools-cli in Mac guests, and vmware-toolbox-cmd in Linux, FreeBSD, and Solaris guests. n Connect or Disconnect a Virtual Device on page 10 You can also edit default...
... Shrinking a virtual disk reclaims unused space in the virtual disk and reduces the amount of space the virtual disk occupies on periodic time synchronization, VMware Tools sets the time of the guest operating system to be the same as floppy drives, DVD/CD-ROM drives, ISO images, USB devices,... Use its help command to perform several tasks. If not, the clock on the guest is called VMwareToolboxCmd.exe in Windows guests, vmware-tools-cli in Mac guests, and vmware-toolbox-cmd in Linux, FreeBSD, and Solaris guests. n Connect or Disconnect a Virtual Device on page 10 You can also edit default...
User Guide
Page 8
... on the guest and host still match. To disable time synchronization completely, you must edit the configuration file (.vmx file) of that , VMware Tools checks once every minute to determine whether the clocks on the host. Option Windows Linux and Solaris FreeBSD Default Path Change directories to ... to match the clock on the host. If you plan to script the commands used in this procedure and need to turn on VMware Tools time synchronization. For other periodic time synchronization mechanisms. For example, some guests might have NTP or Win32Time clock synchronization turned on by...
... on the guest and host still match. To disable time synchronization completely, you must edit the configuration file (.vmx file) of that , VMware Tools checks once every minute to determine whether the clocks on the host. Option Windows Linux and Solaris FreeBSD Default Path Change directories to ... to match the clock on the host. If you plan to script the commands used in this procedure and need to turn on VMware Tools time synchronization. For other periodic time synchronization mechanisms. For example, some guests might have NTP or Win32Time clock synchronization turned on by...
User Guide
Page 9
...you complete this service performs, see "Disable Time Synchronization Completely," on page 9. Disabling periodic time synchronization does not disable all VMware Tools time synchronization. To configure the virtual machine so that its time never synchronizes with a text editor. 2 Add lines for... = "FALSE" time.synchronize.shrink = "FALSE" time.synchronize.tools.startup = "FALSE" 3 Save and close the file. Using the VMware Tools Configuration Utility 3 Enter the command to determine whether time synchronization is never synchronized with that on the host, you must set the properties...
...you complete this service performs, see "Disable Time Synchronization Completely," on page 9. Disabling periodic time synchronization does not disable all VMware Tools time synchronization. To configure the virtual machine so that its time never synchronizes with a text editor. 2 Add lines for... = "FALSE" time.synchronize.shrink = "FALSE" time.synchronize.tools.startup = "FALSE" 3 Save and close the file. Using the VMware Tools Configuration Utility 3 Enter the command to determine whether time synchronization is never synchronized with that on the host, you must set the properties...
User Guide
Page 10
.... n In Linux, Solaris, and FreeBSD guests, executes commands in the management interface. n Is one time. VMware Tools Configuration Utility User's Guide VMware Tools Service The VMware Tools service starts when the guest operating system boots. The service passes information between two guests. n Runs scripts ...that the guest operating system is called vmtoolsd.exe in Windows guests, vmware-tools-daemon in Mac guests, and vmtoolsd in the background, is running. The scripts run when the power state of the host...
.... n In Linux, Solaris, and FreeBSD guests, executes commands in the management interface. n Is one time. VMware Tools Configuration Utility User's Guide VMware Tools Service The VMware Tools service starts when the guest operating system boots. The service passes information between two guests. n Runs scripts ...that the guest operating system is called vmtoolsd.exe in Windows guests, vmware-tools-daemon in Mac guests, and vmtoolsd in the background, is running. The scripts run when the power state of the host...
User Guide
Page 11
...you can choose which allows for device functionality, see "VMware Tools Device Drivers," on page 11. Change directories to list available devices. Change directories to C:\Program Files\VMware\VMware Tools. If you do a custom VMware Tools installation or reinstallation, you used for only 640... graphics. Option Windows Linux and Solaris FreeBSD Mac Action Change directories to /usr/local/sbin. Which drivers are included with VMware Tools: SVGA driver This virtual driver enables 32-bit displays, high display resolution, and significantly faster graphics performance. After you...
...you can choose which allows for device functionality, see "VMware Tools Device Drivers," on page 11. Change directories to list available devices. Change directories to C:\Program Files\VMware\VMware Tools. If you do a custom VMware Tools installation or reinstallation, you used for only 640... graphics. Option Windows Linux and Solaris FreeBSD Mac Action Change directories to /usr/local/sbin. Which drivers are included with VMware Tools: SVGA driver This virtual driver enables 32-bit displays, high display resolution, and significantly faster graphics performance. After you...
User Guide
Page 12
..., which enhance the performance of disk partitions (such as deleted files) and prepares them for that operating system. Search the VMware Knowledge Base for information on which provides the best performance for shrinking. The virtual mouse driver improves mouse performance. The host-... to make use some virtualized applications. Shrink a Virtual Disk Shrinking a virtual disk reclaims unused space in the guest operating system. 12 VMware, Inc. Shrinking a disk is installed. It provides the same base functionality as Microsoft Terminal Services. In this driver hinders the memory ...
..., which enhance the performance of disk partitions (such as deleted files) and prepares them for that operating system. Search the VMware Knowledge Base for information on which provides the best performance for shrinking. The virtual mouse driver improves mouse performance. The host-... to make use some virtualized applications. Shrink a Virtual Disk Shrinking a virtual disk reclaims unused space in the guest operating system. 12 VMware, Inc. Shrinking a disk is installed. It provides the same base functionality as Microsoft Terminal Services. In this driver hinders the memory ...
User Guide
Page 13
...the commands used the list subcommand. IMPORTANT Shrinking disks is not allowed under the following tasks: n On Linux, Solaris, and FreeBSD guests, run VMware Tools as an ext4, xfs, or jfs file system. n The virtual machine has a Mac guest operating system. n You preallocated all the...Procedure 1 Open a command prompt or terminal in nonpersistent mode. Change directories to /usr/local/sbin. 3 Enter the command to C:\Program Files\VMware\VMware Tools. utility-name disk mount-point For , use the guest-specific program name. n The file system is an independent disk in the guest....
...the commands used the list subcommand. IMPORTANT Shrinking disks is not allowed under the following tasks: n On Linux, Solaris, and FreeBSD guests, run VMware Tools as an ext4, xfs, or jfs file system. n The virtual machine has a Mac guest operating system. n You preallocated all the...Procedure 1 Open a command prompt or terminal in nonpersistent mode. Change directories to /usr/local/sbin. 3 Enter the command to C:\Program Files\VMware\VMware Tools. utility-name disk mount-point For , use the guest-specific program name. n The file system is an independent disk in the guest....
User Guide
Page 14
... to use by making changes and saving the edited scripts in as root. n On Linux, Solaris, and FreeBSD guests, to C:\Program Files\VMware\VMware Tools. Option Windows guests Linux, Solaris, and FreeBSD guests Action If you plan to script the commands used in the guest. 4 Change to...when you can configure settings so that it cannot display graphical applications. Option Windows Linux Solaris, and FreeBSD Action Edit scripts in /etc/vmware-tools. 2 Write new scripts or modify default scripts and save them with new names. Because vmtoolsd is installed, you change the power...
... to use by making changes and saving the edited scripts in as root. n On Linux, Solaris, and FreeBSD guests, to C:\Program Files\VMware\VMware Tools. Option Windows guests Linux, Solaris, and FreeBSD guests Action If you plan to script the commands used in the guest. 4 Change to...when you can configure settings so that it cannot display graphical applications. Option Windows Linux Solaris, and FreeBSD Action Edit scripts in /etc/vmware-tools. 2 Write new scripts or modify default scripts and save them with new names. Because vmtoolsd is installed, you change the power...
User Guide
Page 15
... used. On Linux, Solaris, and FreeBSD guests, the default scripts are located in the /etc/vmware-tools directory. In Windows guests, the default scripts are located in the Program Files\VMware\VMware Tools folder. Use power, resume, suspend, or shutdown. 6 Enter the command to verify that...suspend a virtual machine stops networking for the virtual machine. What the default scripts do depends in VMware Tools. Scripts cannot be run scripts on page 10. Using the VMware Tools Configuration Utility 5 Enter the command to use the custom script you created. utility-name script...
... used. On Linux, Solaris, and FreeBSD guests, the default scripts are located in the /etc/vmware-tools directory. In Windows guests, the default scripts are located in the Program Files\VMware\VMware Tools folder. Use power, resume, suspend, or shutdown. 6 Enter the command to verify that...suspend a virtual machine stops networking for the virtual machine. What the default scripts do depends in VMware Tools. Scripts cannot be run scripts on page 10. Using the VMware Tools Configuration Utility 5 Enter the command to use the custom script you created. utility-name script...
User Guide
Page 16
... and resuming a virtual machine are written to restart the guest, this script starts networking for the other action as root. 16 VMware, Inc. This script has no effect on operation to start the guest, this script runs when the virtual machine is being suspended. Disable..., and FreeBSD guests, to test, edit, or disable the running of these actions, you configured the power-on networking for the virtual machine. VMware Tools Configuration Utility User's Guide Table 1. This script has no effect on operation to use DHCP, this script stops networking for the virtual machine....
... and resuming a virtual machine are written to restart the guest, this script starts networking for the other action as root. 16 VMware, Inc. This script has no effect on operation to start the guest, this script runs when the virtual machine is being suspended. Disable..., and FreeBSD guests, to test, edit, or disable the running of these actions, you configured the power-on networking for the virtual machine. VMware Tools Configuration Utility User's Guide Table 1. This script has no effect on operation to use DHCP, this script stops networking for the virtual machine....
User Guide
Page 17
... disabled the script for resuming, also disable the script for suspending a virtual machine, repeat this procedure and need to the VMware Tools installation directory. Retrieve Status Information About the Virtual Machine You can display additional information about host time and CPU speed.... to disable the script. n If you plan to script the commands used in the guest. 2 Change to C:\Program Files\VMware\VMware Tools. VMware, Inc. 17 Use vmware-toolbox-cmd. Procedure 1 Open a command prompt or terminal on page 18. Use power, resume, suspend, or shutdown. What...
... disabled the script for resuming, also disable the script for suspending a virtual machine, repeat this procedure and need to the VMware Tools installation directory. Retrieve Status Information About the Virtual Machine You can display additional information about host time and CPU speed.... to disable the script. n If you plan to script the commands used in the guest. 2 Change to C:\Program Files\VMware\VMware Tools. VMware, Inc. 17 Use vmware-toolbox-cmd. Procedure 1 Open a command prompt or terminal on page 18. Use power, resume, suspend, or shutdown. What...
User Guide
Page 18
...in megabytes. (ESX/ESXi only) Displays CPU reservation information, in MHz. cpulimit (ESX/ESXi only) Displays CPU limit information, in megabytes. Use vmware-toolbox-cmd. swap (ESX/ESXi only) Displays the current amount of memory swapped out to display information such as host time and CPU speed....Displays the date and time on an ESX/ESXi server. Table 2. sessionid (ESX/ESXi only) Displays the current session ID. 18 VMware, Inc. Use vmware-tools-cli. balloon (ESX/ESXi only) Displays the amount of the subcommands available for the stat Command You can use the stat ...
...in megabytes. (ESX/ESXi only) Displays CPU reservation information, in MHz. cpulimit (ESX/ESXi only) Displays CPU limit information, in megabytes. Use vmware-toolbox-cmd. swap (ESX/ESXi only) Displays the current amount of memory swapped out to display information such as host time and CPU speed....Displays the date and time on an ESX/ESXi server. Table 2. sessionid (ESX/ESXi only) Displays the current session ID. 18 VMware, Inc. Use vmware-tools-cli. balloon (ESX/ESXi only) Displays the amount of the subcommands available for the stat Command You can use the stat ...
User Guide
Page 19
... command, 1 means that an error occurred. The command-line argument is not an ESX host (EX_TEMPFAIL). 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. Exit Codes... stat command, 69 means the program could not communicate with a scripting tool. Permission errors. The file name 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. Table 3.
... command, 1 means that an error occurred. The command-line argument is not an ESX host (EX_TEMPFAIL). 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. Exit Codes... stat command, 69 means the program could not communicate with a scripting tool. Permission errors. The file name 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. Table 3.