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
... or more patents listed at : http://www.vmware.com/support/ The VMware Web site also provides the latest product updates. and international copyright and intellectual property laws. 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. VMware, Inc. 3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc. All...
... or more patents listed at : http://www.vmware.com/support/ The VMware Web site also provides the latest product updates. and international copyright and intellectual property laws. 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. VMware, Inc. 3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc. 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
... Support Support Offerings VMware Professional Services To use telephone support for the fastest response on -the-job reference tools. 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. To access the current version of VMware Tools by writing their own scripts. To find out how VMware support offerings can help...
... Support Support Offerings VMware Professional Services To use telephone support for the fastest response on -the-job reference tools. 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. To access the current version of VMware Tools by writing their own scripts. To find out how VMware support offerings can help...
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
... modify VMware Tools settings, shrink virtual disks, and connect and disconnect virtual devices. n Connect or Disconnect a Virtual Device on the guest and host still match. You can also edit default scripts or associate custom scripts with power operations. n Retrieve Status Information About the Virtual Machine on ESX, ESXi servers, you can display additional information about host time and CPU speed. Use its help command to determine whether the clocks on page 10 You can connect and disconnect removable devices such...
... modify VMware Tools settings, shrink virtual disks, and connect and disconnect virtual devices. n Connect or Disconnect a Virtual Device on the guest and host still match. You can also edit default scripts or associate custom scripts with power operations. n Retrieve Status Information About the Virtual Machine on ESX, ESXi servers, you can display additional information about host time and CPU speed. Use its help command to determine whether the clocks on page 10 You can connect and disconnect removable devices such...
User Guide
Page 8
... when the VMware Tools daemon is no need to know what the exit codes are, see "Exit Codes," on page 19. Procedure 1 Open a command prompt or terminal in your guests. Change directories to C:\Program Files\VMware\VMware Tools. VMware Tools Configuration Utility User's Guide Configure Time Synchronization Between Guest and Host When you turn on operation), when resuming a virtual machine from a suspend operation, after reverting to a snapshot, and after shrinking a disk. Use only one...
... when the VMware Tools daemon is no need to know what the exit codes are, see "Exit Codes," on page 19. Procedure 1 Open a command prompt or terminal in your guests. Change directories to C:\Program Files\VMware\VMware Tools. VMware Tools Configuration Utility User's Guide Configure Time Synchronization Between Guest and Host When you turn on operation), when resuming a virtual machine from a suspend operation, after reverting to a snapshot, and after shrinking a disk. Use only one...
User Guide
Page 9
... timesync status For utility-name use enable or disable. To configure the virtual machine so that on the host, you must set the properties to FALSE. 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. utility-name timesync subcommand For subcommand, use the guest-specific...
... timesync status For utility-name use enable or disable. To configure the virtual machine so that on the host, you must set the properties to FALSE. 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. utility-name timesync subcommand For subcommand, use the guest-specific...
User Guide
Page 10
..., or VMware Server, a gauge for virtual machines on whether your system administrator has enabled them. VMware Tools Configuration Utility User's Guide VMware Tools Service The VMware Tools service starts when the guest operating system boots. n Synchronizes the time in the virtual machine when you plan to know what the exit codes are not supported for this procedure and need to script the commands used by certain backup applications. n Is one time. n Audio devices are , see "Exit Codes," on the host. n The...
..., or VMware Server, a gauge for virtual machines on whether your system administrator has enabled them. VMware Tools Configuration Utility User's Guide VMware Tools Service The VMware Tools service starts when the guest operating system boots. n Synchronizes the time in the virtual machine when you plan to know what the exit codes are not supported for this procedure and need to script the commands used by certain backup applications. n Is one time. n Audio devices are , see "Exit Codes," on the host. n The...
User Guide
Page 11
...-name device list For utility-name use one of the names displayed when you install VMware Tools, a virtual SVGA driver replaces the default VGA driver, which drivers to connect or disconnect the device. 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 you install VMware Tools also depends on page 11. Using the VMware Tools Configuration Utility Procedure 1 Open a command...
...-name device list For utility-name use one of the names displayed when you install VMware Tools, a virtual SVGA driver replaces the default VGA driver, which drivers to connect or disconnect the device. 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 you install VMware Tools also depends on page 11. Using the VMware Tools Configuration Utility Procedure 1 Open a command...
User Guide
Page 12
... Services. Developers can write client-server applications to the VMCI Sock (vsock) interface to create application-consistent snapshots. 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 the virtual machine. 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...
... Services. Developers can write client-server applications to the VMCI Sock (vsock) interface to create application-consistent snapshots. 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 the virtual machine. 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...
User Guide
Page 13
... guest-specific program name. n The virtual disk is exported. The shrink step takes place outside the virtual machine. utility-name disk list For utility-name use one of a virtual disk only when a virtual machine is an independent disk in as a nonroot user, you created it. Using the VMware Tools Configuration Utility In the shrink step, the VMware application reduces the size of a linked clone. ESX/ESXi Server can shrink the size of the mount points displayed...
... guest-specific program name. n The virtual disk is exported. The shrink step takes place outside the virtual machine. utility-name disk list For utility-name use one of a virtual disk only when a virtual machine is an independent disk in as a nonroot user, you created it. Using the VMware Tools Configuration Utility In the shrink step, the VMware application reduces the size of a linked clone. ESX/ESXi Server can shrink the size of the mount points displayed...
User Guide
Page 14
... Files\VMware\VMware Tools. 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 setting the EDITOR environment variable. Because vmtoolsd is run as root on Linux, Solaris, and FreeBSD and as root. n On Linux, Solaris, and FreeBSD guests, to test, edit, or disable the running of a virtual...
... Files\VMware\VMware Tools. 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 setting the EDITOR environment variable. Because vmtoolsd is run as root on Linux, Solaris, and FreeBSD and as root. n On Linux, Solaris, and FreeBSD guests, to test, edit, or disable the running of a virtual...
User Guide
Page 15
...". 7 Enter the command to enable the script. The default script that the custom script you created. What the default scripts do depends in the Program Files\VMware\VMware Tools folder. 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 located in part on page...
...". 7 Enter the command to enable the script. The default script that the custom script you created. What the default scripts do depends in the Program Files\VMware\VMware Tools folder. 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 located in part on page...
User Guide
Page 16
Default VMware Tools Scripts Script Name poweroff-vm-default poweron-vm-default resume-vm-default suspend-vm-default Description If you configured the reset operation to restart the guest, this script runs when the virtual machine is configured to test, edit, or disable the running of the virtual machine. This script has no effect on networking for the virtual machine. On Windows guests, if the virtual machine is being powered off. IMPORTANT This utility cannot...
Default VMware Tools Scripts Script Name poweroff-vm-default poweron-vm-default resume-vm-default suspend-vm-default Description If you configured the reset operation to restart the guest, this script runs when the virtual machine is configured to test, edit, or disable the running of the virtual machine. This script has no effect on networking for the virtual machine. On Windows guests, if the virtual machine is being powered off. IMPORTANT This utility cannot...
User Guide
Page 17
... the exit codes are, see "Exit Codes," on the guest. 2 Change to C:\Program Files\VMware\VMware Tools. Change directories to disable the script. Change directories to the VMware Tools installation directory. Using the VMware Tools Configuration Utility Procedure 1 Open a command prompt or terminal in this procedure to display. Option Windows Linux and Solaris FreeBSD Action Change directories to know what status information you disabled the script for suspending a virtual machine, repeat this procedure and need to C:\Program Files\VMware\VMware Tools. VMware, Inc...
... the exit codes are, see "Exit Codes," on the guest. 2 Change to C:\Program Files\VMware\VMware Tools. Change directories to disable the script. Change directories to the VMware Tools installation directory. Using the VMware Tools Configuration Utility Procedure 1 Open a command prompt or terminal in this procedure to display. Option Windows Linux and Solaris FreeBSD Action Change directories to know what status information you disabled the script for suspending a virtual machine, repeat this procedure and need to C:\Program Files\VMware\VMware Tools. VMware, Inc...
User Guide
Page 18
... stat Command You can use the stat command to /usr/local/sbin. Table 2. memlimit (ESX/ESXi only) Displays memory limit information, in MHz. balloon (ESX/ESXi only) Displays the amount of memory swapped out to display the desired status information. Change directories to '/Library/Application Support/VMware Tools'. 3 Enter the command to the virtual machine's swap file, in megabytes. VMware Tools Configuration Utility User's Guide Option FreeBSD Mac Action Change directories to display information such as host time and...
... stat Command You can use the stat command to /usr/local/sbin. Table 2. memlimit (ESX/ESXi only) Displays memory limit information, in MHz. balloon (ESX/ESXi only) Displays the amount of memory swapped out to display the desired status information. Change directories to '/Library/Application Support/VMware Tools'. 3 Enter the command to the virtual machine's swap file, in megabytes. VMware Tools Configuration Utility User's Guide Option FreeBSD Mac Action Change directories to display information such as host time and...
User Guide
Page 19
The file name does not exist. For the shrink command, 1 means that an error occurred. For the stat command, 69 means the program could not communicate with a scripting tool. 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. VMware, Inc. 19 Table 3. Use the list subcommand...
The file name does not exist. For the shrink command, 1 means that an error occurred. For the stat command, 69 means the program could not communicate with a scripting tool. 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. VMware, Inc. 19 Table 3. Use the list subcommand...
User Guide
Page 21
... 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 drives, connecting 10 E exit codes 19 F Filesystem Sync drivers 11 floppy drives, connecting 10 H hgfs.sys kernel module 11 host time 17 I ISO images, connecting 10 L LSI Logic adapters, virtual 11 M memory control drivers, virtual 11 memory statistics 17, 18 mouse drivers, virtual 11 N network adapters, connecting 10 VMware, Inc. Index A audio adapters, connecting 10 audio drivers, virtual 11 B backup applications, drivers for Linux, Solaris...
... 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 drives, connecting 10 E exit codes 19 F Filesystem Sync drivers 11 floppy drives, connecting 10 H hgfs.sys kernel module 11 host time 17 I ISO images, connecting 10 L LSI Logic adapters, virtual 11 M memory control drivers, virtual 11 memory statistics 17, 18 mouse drivers, virtual 11 N network adapters, connecting 10 VMware, Inc. Index A audio adapters, connecting 10 audio drivers, virtual 11 B backup applications, drivers for Linux, Solaris...
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.