User Guide
Page 1
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. 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
User Guide
Page 2
.... Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc. VMware, Inc. 3401 Hillview Ave. VMware products are covered by U.S. 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. VMware Tools Configuration Utility User's Guide You can find the most up-to : docfeedback@vmware.com Copyright © 2009, 2010 VMware, Inc. All rights reserved. in...
.... Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc. VMware, Inc. 3401 Hillview Ave. VMware products are covered by U.S. 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. VMware Tools Configuration Utility User's Guide You can find the most up-to : docfeedback@vmware.com Copyright © 2009, 2010 VMware, Inc. All rights reserved. in...
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
.../support/phone_support.html. 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 you have comments, send your suggestions for anyone who want to http://www.vmware.com/pdf/master_glossary.pdf. Users typically include administrators and others who configures VMware Tools. Document Feedback VMware welcomes your feedback to http://www.vmware.com/support/services...
.../support/phone_support.html. 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 you have comments, send your suggestions for anyone who want to http://www.vmware.com/pdf/master_glossary.pdf. Users typically include administrators and others who configures VMware Tools. Document Feedback VMware welcomes your feedback to http://www.vmware.com/support/services...
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
... you turn on page 14 You can use in the virtual disk and reduces the amount of space the virtual disk occupies on the guest and host still match. n Use Custom VMware Tools Scripts 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, sound adapters, and network adapters. The VMware Tools configuration utility provides a command-line interface for...
... you turn on page 14 You can use in the virtual disk and reduces the amount of space the virtual disk occupies on the guest and host still match. n Use Custom VMware Tools Scripts 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, sound adapters, and network adapters. The VMware Tools configuration utility provides a command-line interface for...
User Guide
Page 8
... to match the clock on periodic time synchronization, synchronization can be the same as the time of whether you turn on operation), when resuming a virtual machine from a suspend operation, after reverting to script the commands used in time. Regardless of the host. NOTE Mac guests use NTP and do not disable VMware Tools time synchronization completely. If you plan to a snapshot, and after shrinking a disk. Change directories to C:\Program Files\VMware\VMware Tools. Change directories...
... to match the clock on periodic time synchronization, synchronization can be the same as the time of whether you turn on operation), when resuming a virtual machine from a suspend operation, after reverting to script the commands used in time. Regardless of the host. NOTE Mac guests use NTP and do not disable VMware Tools time synchronization completely. If you plan to a snapshot, and after shrinking a disk. Change directories to C:\Program Files\VMware\VMware Tools. Change directories...
User Guide
Page 9
... configuration file. VMware, Inc. 9 To configure the virtual machine so that on page 9. Prerequisites Power off the virtual machine. 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. Disabling periodic time synchronization does not disable all VMware Tools time synchronization. A virtual machine occasionally synchronizes time with the host, see "VMware Tools Service," on periodic time synchronization. To completely disable time...
... configuration file. VMware, Inc. 9 To configure the virtual machine so that on page 9. Prerequisites Power off the virtual machine. 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. Disabling periodic time synchronization does not disable all VMware Tools time synchronization. A virtual machine occasionally synchronizes time with the host, see "VMware Tools Service," on periodic time synchronization. To completely disable time...
User Guide
Page 10
... ESX/ESXi, or VMware Server, a gauge for virtual machines on whether your system administrator has enabled them. n Audio devices are not supported for this procedure and need to script the commands used by certain backup applications. n Synchronizes the time in the virtual machine when you plan to know what the exit codes are, see "Exit Codes," on the host. n In Windows guests, helps create the quiesced snapshots used in this heartbeat appears...
... ESX/ESXi, or VMware Server, a gauge for virtual machines on whether your system administrator has enabled them. n Audio devices are not supported for this procedure and need to script the commands used by certain backup applications. n Synchronizes the time in the virtual machine when you plan to know what the exit codes are, see "Exit Codes," on the host. n In Windows guests, helps create the quiesced snapshots used in this heartbeat appears...
User Guide
Page 11
...-specific program name. The following device drivers are installed when you install VMware Tools, a virtual SVGA driver replaces the default VGA driver, which drivers to determine whether a device is connected or disconnected, as folder sharing available, and improve sound, graphics, and networking performance. VMware, Inc. 11 Using the VMware Tools Configuration Utility Procedure 1 Open a command prompt or terminal on the guest operating system and the VMware product. Option Windows Linux and Solaris FreeBSD Mac Action Change directories to list available devices. Use...
...-specific program name. The following device drivers are installed when you install VMware Tools, a virtual SVGA driver replaces the default VGA driver, which drivers to determine whether a device is connected or disconnected, as folder sharing available, and improve sound, graphics, and networking performance. VMware, Inc. 11 Using the VMware Tools Configuration Utility Procedure 1 Open a command prompt or terminal on the guest operating system and the VMware product. Option Windows Linux and Solaris FreeBSD Mac Action Change directories to list available devices. Use...
User Guide
Page 12
... vmxnet3 networking drivers improve network performance. Search the VMware Knowledge Base for information on an ESX/ESXi host. These modules enable backup applications to use VMware ESX/ESXi. This driver is Windows Vista or later, the VMware SVGA 3D (Microsoft - In the preparation step, VMware Tools reclaims all 64-bit Windows guests and 32-bit Windows Server 2003, Windows Server 2008, and Windows Vista guests if you want the virtual machine to make use the virtual...
... vmxnet3 networking drivers improve network performance. Search the VMware Knowledge Base for information on an ESX/ESXi host. These modules enable backup applications to use VMware ESX/ESXi. This driver is Windows Vista or later, the VMware SVGA 3D (Microsoft - In the preparation step, VMware Tools reclaims all 64-bit Windows guests and 32-bit Windows Server 2003, Windows Server 2008, and Windows Vista guests if you want the virtual machine to make use the virtual...
User Guide
Page 13
... guest. 2 Change to script the commands used the list subcommand. n Verify that require root-level permissions. Using the VMware Tools Configuration Utility In the shrink step, the VMware application reduces the size of the disk based on an ESX/ESXi server. n The file system is a linked clone or the parent of the virtual disk you created it. Use vmware-toolbox-cmd. 4 Enter the command to list available mount points. n The virtual machine is a journaling file system...
... guest. 2 Change to script the commands used the list subcommand. n Verify that require root-level permissions. Using the VMware Tools Configuration Utility In the shrink step, the VMware application reduces the size of the disk based on an ESX/ESXi server. n The file system is a linked clone or the parent of the virtual disk you created it. Use vmware-toolbox-cmd. 4 Enter the command to list available mount points. n The virtual machine is a journaling file system...
User Guide
Page 14
... a script, log in user. VMware Tools Configuration Utility User's Guide Use Custom VMware Tools Scripts You can use scripts to /usr/local/sbin. 14 VMware, Inc. On most guest operating systems, if VMware Tools is installed, you write a new script, create the script as root. IMPORTANT This utility cannot run by setting the EDITOR environment variable. Create the script in any executable format, such as a shell or Perl script. 3 Open a command prompt or terminal in the guest. 4 Change to test, edit, or disable...
... a script, log in user. VMware Tools Configuration Utility User's Guide Use Custom VMware Tools Scripts You can use scripts to /usr/local/sbin. 14 VMware, Inc. On most guest operating systems, if VMware Tools is installed, you write a new script, create the script as root. IMPORTANT This utility cannot run by setting the EDITOR environment variable. Create the script in any executable format, such as a shell or Perl script. 3 Open a command prompt or terminal in the guest. 4 Change to test, edit, or disable...
User Guide
Page 15
... used. 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 created. This affects only virtual machines configured to enable the script. In Windows guests, the default scripts are located in the Program Files\VMware\VMware Tools folder. On Linux, Solaris, and FreeBSD guests, the default scripts are located in the /etc/vmware-tools directory. VMware...
... used. 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 created. This affects only virtual machines configured to enable the script. In Windows guests, the default scripts are located in the Program Files\VMware\VMware Tools folder. On Linux, Solaris, and FreeBSD guests, the default scripts are located in the /etc/vmware-tools directory. VMware...
User Guide
Page 16
... IP address of these actions, you must disable the script for the virtual machine. On Linux, Solaris, and FreeBSD , this script runs when the virtual machine is resumed after virtual machine restarts. VMware Tools Configuration Utility User's Guide Table 1. If you configured the power-on networking for the virtual machine. If you configured the reset operation to work together. If you configured the power-on rather than resumed. On Windows guests...
... IP address of these actions, you must disable the script for the virtual machine. On Linux, Solaris, and FreeBSD , this script runs when the virtual machine is resumed after virtual machine restarts. VMware Tools Configuration Utility User's Guide Table 1. If you configured the power-on networking for the virtual machine. If you configured the reset operation to work together. If you configured the power-on rather than resumed. On Windows guests...
User Guide
Page 17
... servers, you disabled the script for the stat Command," on the guest. 2 Change to C:\Program Files\VMware\VMware Tools. 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. Retrieve Status Information About the Virtual Machine You can display additional information about host time and CPU speed. For virtual machines hosted on page 19. Change directories to...
... servers, you disabled the script for the stat Command," on the guest. 2 Change to C:\Program Files\VMware\VMware Tools. 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. Retrieve Status Information About the Virtual Machine You can display additional information about host time and CPU speed. For virtual machines hosted on page 19. Change directories to...
User Guide
Page 18
Use vmware-tools-cli. Table 2. Displays the CPU speed, in MHz. Use vmware-toolbox-cmd. Additional subcommands are available for the stat Command You can use the stat command to the virtual machine's swap file, in megabytes. cpulimit (ESX/ESXi only) Displays CPU limit information, 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 /usr/local/sbin. swap (ESX...
Use vmware-tools-cli. Table 2. Displays the CPU speed, in MHz. Use vmware-toolbox-cmd. Additional subcommands are available for the stat Command You can use the stat command to the virtual machine's swap file, in megabytes. cpulimit (ESX/ESXi only) Displays CPU limit information, 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 /usr/local/sbin. swap (ESX...
User Guide
Page 19
... host is not valid. Table 3. Permission errors. Always indicates that although shrinking is enabled, the shrink command cannot be carried out. For the shrink command, 1 means that an error occurred. Exit Codes Code Number Applicable Command Description 0 All commands 1 All commands 64 All commands 66 script 69 device and stat 75 stat 77 All commands The command was successful. Using the VMware Tools Configuration Utility Exit Codes You might use exits codes if you want to display...
... host is not valid. Table 3. Permission errors. Always indicates that although shrinking is enabled, the shrink command cannot be carried out. For the shrink command, 1 means that an error occurred. Exit Codes Code Number Applicable Command Description 0 All commands 1 All commands 64 All commands 66 script 69 device and stat 75 stat 77 All commands The command was successful. Using the VMware Tools Configuration Utility Exit Codes You might use exits codes if you want to display...
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.