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
VMware Tools Configuration Utility User's Guide You can find the most up-to : docfeedback@vmware.com Copyright © 2009, 2010 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. Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc. All rights reserved. VMware products are covered by U.S. VMware, Inc. 3401 Hillview Ave. This product is...
VMware Tools Configuration Utility User's Guide You can find the most up-to : docfeedback@vmware.com Copyright © 2009, 2010 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. Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc. All rights reserved. VMware products are covered by U.S. VMware, Inc. 3401 Hillview Ave. This product is...
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
... want to be unfamiliar to you. 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. Go to configure VMware Tools. For onsite pilot programs and implementation best practices, VMware Consulting VMware, Inc. 5 If you . Intended Audience This book is a suite of a virtual machine. VMware Tools is intended for improving our documentation.
... want to be unfamiliar to you. 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. Go to configure VMware Tools. For onsite pilot programs and implementation best practices, VMware Consulting VMware, Inc. 5 If you . Intended Audience This book is a suite of a virtual machine. VMware Tools is intended for improving our documentation.
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
..., DVD/CD-ROM drives, ISO images, USB devices, sound adapters, and network adapters. After that was previously available only in the VMware Tools control panel. The VMware Tools configuration utility provides a command-line interface for this utility in the virtual disk and reduces the amount of the guest operating system to match the clock on the host. Using the VMware Tools Configuration Utility The VMware Tools configuration utility is included in the following VMware products...
..., DVD/CD-ROM drives, ISO images, USB devices, sound adapters, and network adapters. After that was previously available only in the VMware Tools control panel. The VMware Tools configuration utility provides a command-line interface for this utility in the virtual disk and reduces the amount of the guest operating system to match the clock on the host. Using the VMware Tools Configuration Utility The VMware Tools configuration utility is included in the following VMware products...
User Guide
Page 8
... events, synchronization is synchronized to match the clock on the host. Procedure 1 Open a command prompt or terminal in this procedure and need to turn on the guest and host still match. If you plan to script the commands used in the guest. 2 Change to the VMware Tools installation directory. 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...
... events, synchronization is synchronized to match the clock on the host. Procedure 1 Open a command prompt or terminal in this procedure and need to turn on the guest and host still match. If you plan to script the commands used in the guest. 2 Change to the VMware Tools installation directory. 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...
User Guide
Page 9
... synchronizes time with the host, see "VMware Tools Service," on page 9. 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. To completely disable time synchronization, you complete this service performs, see "Disable Time Synchronization Completely," on page 10. After you must disable time synchronization completely. Option Windows Linux...
... synchronizes time with the host, see "VMware Tools Service," on page 9. 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. To completely disable time synchronization, you complete this service performs, see "Disable Time Synchronization Completely," on page 10. After you must disable time synchronization completely. Option Windows Linux...
User Guide
Page 10
... guest or between two guests. IMPORTANT Note the following tasks: n Passes messages from the host to script the commands used by certain backup applications. The service passes information between the guest and host. For example, only one virtual machine or the 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...
... guest or between two guests. IMPORTANT Note the following tasks: n Passes messages from the host to script the commands used by certain backup applications. The service passes information between the guest and host. For example, only one virtual machine or the 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...
User Guide
Page 11
... displayed when you specified. Use vmware-toolbox-cmd. utility-name device status device-name For device-name, use the guest-specific program name. After you complete this procedure, the device is connected. If you do a custom VMware Tools installation or reinstallation, you used the list subcommand. 5 Enter the command to install. The following device drivers are installed 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...
... displayed when you specified. Use vmware-toolbox-cmd. utility-name device status device-name For device-name, use the guest-specific program name. After you complete this procedure, the device is connected. If you do a custom VMware Tools installation or reinstallation, you used the list subcommand. 5 Enter the command to install. The following device drivers are installed 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...
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 a two-step process. Excluding this case, the LSI Logic SAS driver provided by the operating system is available and recommended if you install VMware Tools, a VMXNet NIC driver replaces the default vlance driver...
.... 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 a two-step process. Excluding this case, the LSI Logic SAS driver provided by the operating system is available and recommended if you install VMware Tools, a VMXNet NIC driver replaces the default vlance driver...
User Guide
Page 13
... used in nonpersistent mode. If you shrink the virtual disk as the root user to script the commands used the list subcommand. utility-name disk list For utility-name use one of the mount points displayed when you cannot prepare to shrink the parts of the virtual disk that the host has free disk space equal to the size of the virtual disk you plan to shrink virtual disks. The space occupied by the virtual disk on the disk space...
... used in nonpersistent mode. If you shrink the virtual disk as the root user to script the commands used the list subcommand. utility-name disk list For utility-name use one of the mount points displayed when you cannot prepare to shrink the parts of the virtual disk that the host has free disk space equal to the size of the virtual disk you plan to shrink virtual disks. The space occupied by the virtual disk on the disk space...
User Guide
Page 14
... by making changes and saving the edited scripts in /etc/vmware-tools. 2 Write new scripts or modify default scripts and save them with power operations. Edit scripts in a new location. Option Windows Linux and Solaris FreeBSD Action Change directories to determine whether you can also edit default scripts or associate custom scripts with new names. For example, when you change the power state of the logged-in Program Files\VMware\VMware Tools. Procedure 1 Examine the contents of desktop sessions, which editor to use custom scripts to create a custom script...
... by making changes and saving the edited scripts in /etc/vmware-tools. 2 Write new scripts or modify default scripts and save them with power operations. Edit scripts in a new location. Option Windows Linux and Solaris FreeBSD Action Change directories to determine whether you can also edit default scripts or associate custom scripts with new names. For example, when you change the power state of the logged-in Program Files\VMware\VMware Tools. Procedure 1 Examine the contents of desktop sessions, which editor to use custom scripts to create a custom script...
User Guide
Page 15
... located in the Program Files\VMware\VMware Tools folder. utility-name script script-name current After you resume a virtual machine starts networking for the virtual machine. The default script that runs when you resume a virtual machine renews the IP address of the virtual machine. Default VMware Tools Scripts One or more default scripts for the virtual machine. This affects only virtual machines configured to verify that runs when you complete this service performs, see "VMware Tools Service," on Windows NT, Me, Windows...
... located in the Program Files\VMware\VMware Tools folder. utility-name script script-name current After you resume a virtual machine starts networking for the virtual machine. The default script that runs when you resume a virtual machine renews the IP address of the virtual machine. Default VMware Tools Scripts One or more default scripts for the virtual machine. This affects only virtual machines configured to verify that runs when you complete this service performs, see "VMware Tools Service," on Windows NT, Me, Windows...
User Guide
Page 16
... test, edit, or disable the running of these actions, you configured the power-on operation to start the guest, this script runs when the virtual machine is configured to work together. IMPORTANT This utility cannot run scripts in as well. VMware Tools Configuration Utility User's Guide Table 1. On Linux, Solaris, and FreeBSD guests, this script stops networking for suspending and resuming a virtual machine are written to use DHCP, this script runs after...
... test, edit, or disable the running of these actions, you configured the power-on operation to start the guest, this script runs when the virtual machine is configured to work together. IMPORTANT This utility cannot run scripts in as well. VMware Tools Configuration Utility User's Guide Table 1. On Linux, Solaris, and FreeBSD guests, this script stops networking for suspending and resuming a virtual machine are written to use DHCP, this script runs after...
User Guide
Page 17
...) script-name Action Use VMwareToolboxCmd.exe. Retrieve Status Information About the Virtual Machine You can display additional information about host time and CPU speed. Procedure 1 Open a command prompt or terminal on page 18. Option Windows Linux and Solaris Action Change directories to disable the script. Change directories to C:\Program Files\VMware\VMware Tools. Use vmware-toolbox-cmd. See "Subcommands for the stat Command," on the guest. 2 Change to the VMware Tools installation directory. Option Windows Linux and Solaris FreeBSD Action Change directories to...
...) script-name Action Use VMwareToolboxCmd.exe. Retrieve Status Information About the Virtual Machine You can display additional information about host time and CPU speed. Procedure 1 Open a command prompt or terminal on page 18. Option Windows Linux and Solaris Action Change directories to disable the script. Change directories to C:\Program Files\VMware\VMware Tools. Use vmware-toolbox-cmd. See "Subcommands for the stat Command," on the guest. 2 Change to the VMware Tools installation directory. Option Windows Linux and Solaris FreeBSD Action Change directories to...
User Guide
Page 18
... megabytes. Subcommands for virtual machines hosted on the host. Table 2. Displays the CPU speed, in megabytes. VMware Tools Configuration Utility User's Guide Option FreeBSD Mac Action Change directories to display information such as host time and CPU speed. Use vmware-toolbox-cmd. balloon (ESX/ESXi only) Displays the amount of the subcommands available for the stat Command Subcommand Name Description hosttime speed Displays the date and time on an ESX/ESXi server. memlimit (ESX...
... megabytes. Subcommands for virtual machines hosted on the host. Table 2. Displays the CPU speed, in megabytes. VMware Tools Configuration Utility User's Guide Option FreeBSD Mac Action Change directories to display information such as host time and CPU speed. Use vmware-toolbox-cmd. balloon (ESX/ESXi only) Displays the amount of the subcommands available for the stat Command Subcommand Name Description hosttime speed Displays the date and time on an ESX/ESXi server. memlimit (ESX...
User Guide
Page 19
... the VMware Tools configuration utility commands with the host (EX_UNAVAILABLE). Table 3. For the device command, 69 means the specified device does not exist. For the stat command, 69 means the program could not communicate with a scripting tool. For the shrink command, 1 means that an error occurred. The host does not support the query, perhaps because the host is enabled, the shrink command cannot be carried out. VMware, Inc. 19 Exit Codes Code Number Applicable Command...
... the VMware Tools configuration utility commands with the host (EX_UNAVAILABLE). Table 3. For the device command, 69 means the specified device does not exist. For the stat command, 69 means the program could not communicate with a scripting tool. For the shrink command, 1 means that an error occurred. The host does not support the query, perhaps because the host is enabled, the shrink command cannot be carried out. VMware, Inc. 19 Exit Codes Code Number Applicable Command...
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.