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
... trademark or trademark of their respective companies. VMware products are covered by U.S. All rights reserved. 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. If you have comments about...
... trademark or trademark of their respective companies. VMware products are covered by U.S. All rights reserved. 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. If you have comments about...
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 to submit technical support requests, view your product and contract information, and register your feedback to http://www.vmware.com/support. Go to configure VMware Tools. 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/phone_support.html. VMware Education Services courses offer extensive hands-on priority 1 issues. Users typically include administrators and others who configures VMware Tools. Document Feedback VMware...
... support to submit technical support requests, view your product and contract information, and register your feedback to http://www.vmware.com/support. Go to configure VMware Tools. 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/phone_support.html. VMware Education Services courses offer extensive hands-on priority 1 issues. Users typically include administrators and others who configures VMware Tools. Document Feedback VMware...
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
... connect and disconnect removable devices such as the time of the host. Using the VMware Tools Configuration Utility The VMware Tools configuration utility is a command-line interface you change the power state of a virtual machine. For virtual machines hosted on ESX, ESXi servers, you turn on the host. n Configure Time Synchronization Between Guest and Host on the guest and host still match. After that was previously available only in the virtual disk and reduces the amount of space the virtual disk...
... connect and disconnect removable devices such as the time of the host. Using the VMware Tools Configuration Utility The VMware Tools configuration utility is a command-line interface you change the power state of a virtual machine. For virtual machines hosted on ESX, ESXi servers, you turn on the host. n Configure Time Synchronization Between Guest and Host on the guest and host still match. After that was previously available only in the virtual disk and reduces the amount of space the virtual disk...
User Guide
Page 8
... sync with the host. For Mac guests, there is forward in this procedure and need to turn on by default. VMware Tools Configuration Utility User's Guide Configure Time Synchronization Between Guest and Host When you turn on periodic time synchronization, VMware Tools sets the time of the guest operating system to be either forward or backward in the guest. 2 Change to the VMware Tools installation directory. Option Windows Linux and Solaris FreeBSD Default Path Change directories to C:\Program Files\VMware\VMware Tools.
... sync with the host. For Mac guests, there is forward in this procedure and need to turn on by default. VMware Tools Configuration Utility User's Guide Configure Time Synchronization Between Guest and Host When you turn on periodic time synchronization, VMware Tools sets the time of the guest operating system to be either forward or backward in the guest. 2 Change to the VMware Tools installation directory. Option Windows Linux and Solaris FreeBSD Default Path Change directories to C:\Program Files\VMware\VMware Tools.
User Guide
Page 9
... synchronizes time with a text editor. 2 Add lines for the time synchronization properties and set some properties in the virtual machine configuration file. Procedure 1 Open the configuration (.vmx) file of the virtual machine with the host even if you do not turn on the host, you must disable time synchronization completely. Option Windows Linux, Solaris, and FreeBSD Action Use VMwareToolboxCmd.exe. utility-name timesync status For utility-name use enable or disable. Use vmware-toolbox-cmd. 4 Enter the command...
... synchronizes time with a text editor. 2 Add lines for the time synchronization properties and set some properties in the virtual machine configuration file. Procedure 1 Open the configuration (.vmx) file of the virtual machine with the host even if you do not turn on the host, you must disable time synchronization completely. Option Windows Linux, Solaris, and FreeBSD Action Use VMwareToolboxCmd.exe. utility-name timesync status For utility-name use enable or disable. Use vmware-toolbox-cmd. 4 Enter the command...
User Guide
Page 10
... host can connect and disconnect removable devices such as floppy drives, DVD/CD-ROM drives, ISO images, USB devices, sound adapters, and network adapters. This program, which runs in the background, is running. This feature applies to script the commands used by certain backup applications. When the virtual machine runs under ESX/ESXi, or VMware Server, a gauge for virtual machines on whether your system administrator has enabled them. n Synchronizes the time...
... host can connect and disconnect removable devices such as floppy drives, DVD/CD-ROM drives, ISO images, USB devices, sound adapters, and network adapters. This program, which runs in the background, is running. This feature applies to script the commands used by certain backup applications. When the virtual machine runs under ESX/ESXi, or VMware Server, a gauge for virtual machines on whether your system administrator has enabled them. n Synchronizes the time...
User Guide
Page 11
... the VMware Tools drivers used the list subcommand. Using the VMware Tools Configuration Utility Procedure 1 Open a command prompt or terminal on the guest. 2 Change to C:\Program Files\VMware\VMware Tools. Option Windows Linux and Solaris FreeBSD Mac Action Change directories to the VMware Tools installation directory. Option Windows Linux, Solaris, and FreeBSD Mac Action Use VMwareToolboxCmd.exe. VMware Tools Device Drivers Device drivers smooth mouse operations, make VMware features such as you install VMware Tools, a virtual SVGA driver replaces the default VGA driver...
... the VMware Tools drivers used the list subcommand. Using the VMware Tools Configuration Utility Procedure 1 Open a command prompt or terminal on the guest. 2 Change to C:\Program Files\VMware\VMware Tools. Option Windows Linux and Solaris FreeBSD Mac Action Change directories to the VMware Tools installation directory. Option Windows Linux, Solaris, and FreeBSD Mac Action Use VMwareToolboxCmd.exe. VMware Tools Device Drivers Device drivers smooth mouse operations, make VMware features such as you install VMware Tools, a virtual SVGA driver replaces the default VGA driver...
User Guide
Page 12
... driver replaces the default vlance driver. 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 configure device settings for that support making automatic backups VMCI and VMCI Sockets drivers On Windows guests whose operating system is required to make use some virtualized applications. This driver is for shrinking. The Virtual Machine Communication Interface driver allows fast and efficient communication between hosts...
... driver replaces the default vlance driver. 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 configure device settings for that support making automatic backups VMCI and VMCI Sockets drivers On Windows guests whose operating system is required to make use some virtualized applications. This driver is for shrinking. The Virtual Machine Communication Interface driver allows fast and efficient communication between hosts...
User Guide
Page 13
... the virtual disk that the host has free disk space equal to know what the exit codes are, see "Exit Codes," on an ESX/ESXi server. n The file system is exported. If you shrink the virtual disk as a user with Administrator privileges to shrink. utility-name disk mount-point For , use the guest-specific program name. Change directories to /usr/local/sbin. 3 Enter the command to shrink the disk at a specified mount point. Option Windows Linux...
... the virtual disk that the host has free disk space equal to know what the exit codes are, see "Exit Codes," on an ESX/ESXi server. n The file system is exported. If you shrink the virtual disk as a user with Administrator privileges to shrink. utility-name disk mount-point For , use the guest-specific program name. Change directories to /usr/local/sbin. 3 Enter the command to shrink the disk at a specified mount point. Option Windows Linux...
User Guide
Page 14
... VMware Tools service, or daemon (vmtoolsd). Option Windows Linux and Solaris FreeBSD Action Change directories to /usr/local/sbin. 14 VMware, Inc. VMware Tools Configuration Utility User's Guide Use Custom VMware Tools Scripts You can use scripts to automate guest operating system operations when you want to create a custom script by making changes and saving the edited scripts in a new location. For example, when you power off . n If you write a new script, create the script as System on Mac guests. Procedure 1 Examine the contents of the default scripts...
... VMware Tools service, or daemon (vmtoolsd). Option Windows Linux and Solaris FreeBSD Action Change directories to /usr/local/sbin. 14 VMware, Inc. VMware Tools Configuration Utility User's Guide Use Custom VMware Tools Scripts You can use scripts to automate guest operating system operations when you want to create a custom script by making changes and saving the edited scripts in a new location. For example, when you power off . n If you write a new script, create the script as System on Mac guests. Procedure 1 Examine the contents of the default scripts...
User Guide
Page 15
... a virtual machine stops networking for the virtual machine. This affects only virtual machines configured to enable the script. Default VMware Tools Scripts One or more default scripts for each power state are located in part on NetWare guests. On Linux, Solaris, and FreeBSD guests, the default scripts are included in the Program Files\VMware\VMware Tools folder. 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. In Windows guests, the default scripts...
... a virtual machine stops networking for the virtual machine. This affects only virtual machines configured to enable the script. Default VMware Tools Scripts One or more default scripts for each power state are located in part on NetWare guests. On Linux, Solaris, and FreeBSD guests, the default scripts are included in the Program Files\VMware\VMware Tools folder. 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. In Windows guests, the default scripts...
User Guide
Page 16
... script renews the IP address of the virtual machine. VMware Tools Configuration Utility User's Guide Table 1. On Windows guests, if the virtual machine is configured to use DHCP, this script runs when the virtual machine is being reset. On Windows guests, if the virtual machine is configured to use DHCP, this script runs when the virtual machine is being powered off operation to work together. This script has no effect on networking for suspending and resuming a virtual...
... script renews the IP address of the virtual machine. VMware Tools Configuration Utility User's Guide Table 1. On Windows guests, if the virtual machine is configured to use DHCP, this script runs when the virtual machine is being reset. On Windows guests, if the virtual machine is configured to use DHCP, this script runs when the virtual machine is being powered off operation to work together. This script has no effect on networking for suspending and resuming a virtual...
User Guide
Page 17
... you want to the VMware Tools installation directory. Prerequisites n Determine what the exit codes are, see "Exit Codes," on page 18. Change directories to disable the script. VMware, Inc. 17 Change directories to C:\Program Files\VMware\VMware Tools. For virtual machines hosted on the guest. 2 Change to display. Retrieve Status Information About the Virtual Machine You can display additional information about host time and CPU speed. Option Windows Linux and Solaris FreeBSD Action Change directories to /usr/sbin. Use vmware-toolbox-cmd.
... you want to the VMware Tools installation directory. Prerequisites n Determine what the exit codes are, see "Exit Codes," on page 18. Change directories to disable the script. VMware, Inc. 17 Change directories to C:\Program Files\VMware\VMware Tools. For virtual machines hosted on the guest. 2 Change to display. Retrieve Status Information About the Virtual Machine You can display additional information about host time and CPU speed. Option Windows Linux and Solaris FreeBSD Action Change directories to /usr/sbin. Use vmware-toolbox-cmd.
User Guide
Page 18
VMware Tools Configuration Utility User's Guide Option FreeBSD Mac Action Change directories to display the desired status information. Use hosttime or speed, or, if applicable, one of memory that is currently reclaimed from the virtual machine through ballooning, in MHz. Table 2. balloon (ESX/ESXi only) Displays the amount of the subcommands available for virtual machines hosted on an ESX/ESXi server. memlimit (ESX/ESXi only) Displays memory limit information, in MHz...
VMware Tools Configuration Utility User's Guide Option FreeBSD Mac Action Change directories to display the desired status information. Use hosttime or speed, or, if applicable, one of memory that is currently reclaimed from the virtual machine through ballooning, in MHz. Table 2. balloon (ESX/ESXi only) Displays the amount of the subcommands available for virtual machines hosted on an ESX/ESXi server. memlimit (ESX/ESXi only) Displays memory limit information, in MHz...
User Guide
Page 19
... host does not support the query, perhaps because the host is not valid. Table 3. 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. Permission errors. 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 command-line...
... host does not support the query, perhaps because the host is not valid. Table 3. 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. Permission errors. 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 command-line...
User Guide
Page 21
... 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-toolbox-cmd utility for 11 BusLogic SCSI adapters 11 C CD-ROM drives, connecting 10 clock, synchronization between host and guest 8, 9 CPU statistics 17, 18 custom scripts 14 custom VMware Tools scripts 14 D device command 10 device drivers, virtual 11 disk command 12 drivers, VMware Tools 11 DVD...
... 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-toolbox-cmd utility for 11 BusLogic SCSI adapters 11 C CD-ROM drives, connecting 10 clock, synchronization between host and guest 8, 9 CPU statistics 17, 18 custom scripts 14 custom VMware Tools scripts 14 D device command 10 device drivers, virtual 11 disk command 12 drivers, VMware Tools 11 DVD...
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.