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. 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 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
...registered trademark or trademark of their respective companies. VMware Tools Configuration Utility User's Guide You can find the most up-to : docfeedback@vmware.com Copyright © 2009, 2010 VMware, Inc. and international copyright and intellectual property laws. VMware, Inc. 3401 Hillview Ave. If you have... about this documentation, submit your feedback to -date technical documentation on the VMware Web site at http://www.vmware.com/go/patents. Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc. VMware products are covered by U.S. All rights reserved. in the United States and...
...registered trademark or trademark of their respective companies. VMware Tools Configuration Utility User's Guide You can find the most up-to : docfeedback@vmware.com Copyright © 2009, 2010 VMware, Inc. and international copyright and intellectual property laws. VMware, Inc. 3401 Hillview Ave. If you have... about this documentation, submit your feedback to -date technical documentation on the VMware Web site at http://www.vmware.com/go/patents. Palo Alto, CA 94304 www.vmware.com 2 VMware, Inc. VMware products are covered by U.S. All rights reserved. in the United States and...
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
... register your business needs, go to http://www.vmware.com/support/services. Go to configure VMware Tools. Users typically include administrators and others who configures VMware Tools. For definitions of VMware Tools by writing their own scripts. Courses are available... and Education Resources The following technical support resources are available onsite, in VMware technical documentation, go to docfeedback@vmware.com. For onsite pilot programs and implementation best practices, VMware Consulting VMware, Inc. 5 If you . Intended Audience This book is a suite...
... register your business needs, go to http://www.vmware.com/support/services. Go to configure VMware Tools. Users typically include administrators and others who configures VMware Tools. For definitions of VMware Tools by writing their own scripts. Courses are available... and Education Resources The following technical support resources are available onsite, in VMware technical documentation, go to docfeedback@vmware.com. For onsite pilot programs and implementation best practices, VMware Consulting VMware, Inc. 5 If you . Intended Audience This book is a suite...
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
...the guest operating system to be the same as floppy drives, DVD/CD-ROM drives, ISO images, USB devices, sound adapters, and network adapters. VMware, Inc. 7 This program is synchronized to match the clock on the host. n Configure Time Synchronization Between Guest and Host on page 8 When... Disk on page 12 Shrinking a virtual disk reclaims unused space in the virtual disk and reduces the amount of a virtual machine. n Use Custom VMware Tools Scripts on page 14 You can also edit default scripts or associate custom scripts with power operations. For virtual machines hosted on ESX, ESXi...
...the guest operating system to be the same as floppy drives, DVD/CD-ROM drives, ISO images, USB devices, sound adapters, and network adapters. VMware, Inc. 7 This program is synchronized to match the clock on the host. n Configure Time Synchronization Between Guest and Host on page 8 When... Disk on page 12 Shrinking a virtual disk reclaims unused space in the virtual disk and reduces the amount of a virtual machine. n Use Custom VMware Tools Scripts on page 14 You can also edit default scripts or associate custom scripts with power operations. For virtual machines hosted on ESX, ESXi...
User Guide
Page 8
...the host. If the clock on the guest is ahead of the virtual machine and set several synchronization properties to match the clock on VMware Tools time synchronization. To disable time synchronization completely, you first turn on periodic time synchronization, synchronization can be the same as the ...time of periodic time synchronization in the guest. 2 Change to C:\Program Files\VMware\VMware Tools. For Mac guests, there is no need to know what the exit codes are, see "Exit Codes," on page 19. If not,...
...the host. If the clock on the guest is ahead of the virtual machine and set several synchronization properties to match the clock on VMware Tools time synchronization. To disable time synchronization completely, you first turn on periodic time synchronization, synchronization can be the same as the ...time of periodic time synchronization in the guest. 2 Change to C:\Program Files\VMware\VMware Tools. For Mac guests, there is no need to know what the exit codes are, see "Exit Codes," on page 19. If not,...
User Guide
Page 9
...virtual machine, so that the clock in the virtual machine configuration file. For information about the additional functionality this procedure, the VMware Tools service enables or disables periodic time synchronization, as you complete this service performs, see "Disable Time Synchronization Completely," on... properties to determine whether time synchronization is never synchronized with that its time never synchronizes with the host, see "VMware Tools Service," on periodic time synchronization. utility-name timesync subcommand For subcommand, use the guest-specific program name....
...virtual machine, so that the clock in the virtual machine configuration file. For information about the additional functionality this procedure, the VMware Tools service enables or disables periodic time synchronization, as you complete this service performs, see "Disable Time Synchronization Completely," on... properties to determine whether time synchronization is never synchronized with that its time never synchronizes with the host, see "VMware Tools Service," on periodic time synchronization. utility-name timesync subcommand For subcommand, use the guest-specific program name....
User Guide
Page 10
...them. n The controls for connecting devices: n Some devices cannot be available, depending on the host. NOTE In Mac guests, the VMware Tools service only fits the screen resolution of the host. IMPORTANT Note the following tasks: n Passes messages from the host to indicate that... removable devices such as floppy drives, DVD/CD-ROM drives, ISO images, USB devices, sound adapters, and network adapters. The VMware Tools service performs the following restrictions for connecting and disconnecting devices might not be shared between the host and guest or between two guests...
...them. n The controls for connecting devices: n Some devices cannot be available, depending on the host. NOTE In Mac guests, the VMware Tools service only fits the screen resolution of the host. IMPORTANT Note the following tasks: n Passes messages from the host to indicate that... removable devices such as floppy drives, DVD/CD-ROM drives, ISO images, USB devices, sound adapters, and network adapters. The VMware Tools service performs the following restrictions for connecting and disconnecting devices might not be shared between the host and guest or between two guests...
User Guide
Page 11
...drivers are installed when you specified. When you used the list subcommand. Change directories to '/Library/Application Support/VMware Tools'. 3 Enter the command to C:\Program Files\VMware\VMware Tools. Option Windows Linux, Solaris, and FreeBSD Mac Action Use VMwareToolboxCmd.exe. utility-name device device-name ... device list For utility-name use one of the names displayed when you can choose which allows for device functionality, see "VMware Tools Device Drivers," on page 11. utility-name device status device-name For device-name, use the guest-specific program name...
...drivers are installed when you specified. When you used the list subcommand. Change directories to '/Library/Application Support/VMware Tools'. 3 Enter the command to C:\Program Files\VMware\VMware Tools. Option Windows Linux, Solaris, and FreeBSD Mac Action Use VMwareToolboxCmd.exe. utility-name device device-name ... device list For utility-name use one of the names displayed when you can choose which allows for device functionality, see "VMware Tools Device Drivers," on page 11. utility-name device status device-name For device-name, use the guest-specific program name...
User Guide
Page 12
...system is a two-step process. The Virtual Machine Communication Interface driver allows fast and efficient communication between hosts and guests. 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 VMware Tools provides. It provides the same base functionality as deleted files) and prepares them for PVSCSI adapters, which provides the...
...system is a two-step process. The Virtual Machine Communication Interface driver allows fast and efficient communication between hosts and guests. 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 VMware Tools provides. It provides the same base functionality as deleted files) and prepares them for PVSCSI adapters, which provides the...
User Guide
Page 13
... drive. n The virtual machine has a Mac guest operating system. n The virtual machine contains a snapshot. Change directories to C:\Program Files\VMware\VMware Tools. Use vmware-toolbox-cmd. 4 Enter the command to list available mount points. n The virtual disk is an independent disk in the guest. 2 Change... the command to shrink the disk at a specified mount point. utility-name disk mount-point For , use the guest-specific program name. VMware, Inc. 13 n On Windows guests, you shrink the virtual disk as the root user to script the commands used the list subcommand. ...
... drive. n The virtual machine has a Mac guest operating system. n The virtual machine contains a snapshot. Change directories to C:\Program Files\VMware\VMware Tools. Use vmware-toolbox-cmd. 4 Enter the command to list available mount points. n The virtual disk is an independent disk in the guest. 2 Change... the command to shrink the disk at a specified mount point. utility-name disk mount-point For , use the guest-specific program name. VMware, Inc. 13 n On Windows guests, you shrink the virtual disk as the root user to script the commands used the list subcommand. ...
User Guide
Page 14
...the guest and are run as root on Linux, Solaris, and FreeBSD and as necessary: n To familiarize yourself with the default scripts, see "Default VMware Tools Scripts," on Windows, the scripts are , see "Exit Codes," on Mac guests. n On Linux, Solaris, and FreeBSD guests, to test,...default scripts and save them with power operations. Option Windows Linux and Solaris FreeBSD Action Change directories to /usr/local/sbin. 14 VMware, Inc. The VMware Tools daemon has no knowledge of the following tasks, as System on page 15. Create the script in a new location. ...
...the guest and are run as root on Linux, Solaris, and FreeBSD and as necessary: n To familiarize yourself with the default scripts, see "Default VMware Tools Scripts," on Windows, the scripts are , see "Exit Codes," on Mac guests. n On Linux, Solaris, and FreeBSD guests, to test,...default scripts and save them with power operations. Option Windows Linux and Solaris FreeBSD Action Change directories to /usr/local/sbin. 14 VMware, Inc. The VMware Tools daemon has no knowledge of the following tasks, as System on page 15. Create the script in a new location. ...
User Guide
Page 15
...resume, suspend, or shutdown. 6 Enter the command to use DHCP. The default script that the custom script you specified is now being used. VMware, Inc. 15 utility-name script script-name enable Option utility-name (On Windows guests) utility-name (On Linux, Solaris, and FreeBSD guests) ... Scripts One or more default scripts for each power state are located in VMware Tools. In Windows guests, the default scripts are included in the Program Files\VMware\VMware Tools folder. Use vmware-toolbox-cmd. utility-name script script-name set script-path For script-path, use the custom...
...resume, suspend, or shutdown. 6 Enter the command to use DHCP. The default script that the custom script you specified is now being used. VMware, Inc. 15 utility-name script script-name enable Option utility-name (On Windows guests) utility-name (On Linux, Solaris, and FreeBSD guests) ... Scripts One or more default scripts for each power state are located in VMware Tools. In Windows guests, the default scripts are included in the Program Files\VMware\VMware Tools folder. Use vmware-toolbox-cmd. utility-name script script-name set script-path For script-path, use the custom...
User Guide
Page 16
... machine is being suspended. On Linux, Solaris, and FreeBSD , this script runs when the virtual machine is being reset. Default VMware Tools Scripts Script Name poweroff-vm-default poweron-vm-default resume-vm-default suspend-vm-default Description If you configured the power-on ...powered off operation to restart the guest, this script runs when the virtual machine is being powered on networking for the virtual machine. VMware Tools Configuration Utility User's Guide Table 1. If you must disable the script for the virtual machine. If you configured the reset ...
... machine is being suspended. On Linux, Solaris, and FreeBSD , this script runs when the virtual machine is being reset. Default VMware Tools Scripts Script Name poweroff-vm-default poweron-vm-default resume-vm-default suspend-vm-default Description If you configured the power-on ...powered off operation to restart the guest, this script runs when the virtual machine is being powered on networking for the virtual machine. VMware Tools Configuration Utility User's Guide Table 1. If you must disable the script for the virtual machine. If you configured the reset ...
User Guide
Page 17
... Linux and Solaris FreeBSD Action Change directories to /usr/sbin. Change directories to /usr/local/sbin. 3 Enter the command to the VMware Tools installation directory. utility-name script script-name disable Option utility-name (On Windows guests) utility-name (On Linux, Solaris, and...guest. 2 Change to /usr/sbin. See "Subcommands for suspending a virtual machine, repeat this procedure and need to C:\Program Files\VMware\VMware Tools. Option Windows Linux and Solaris Action Change directories to know what status information you disabled the script for resuming, also disable ...
... Linux and Solaris FreeBSD Action Change directories to /usr/sbin. Change directories to /usr/local/sbin. 3 Enter the command to the VMware Tools installation directory. utility-name script script-name disable Option utility-name (On Windows guests) utility-name (On Linux, Solaris, and...guest. 2 Change to /usr/sbin. See "Subcommands for suspending a virtual machine, repeat this procedure and need to C:\Program Files\VMware\VMware Tools. Option Windows Linux and Solaris Action Change directories to know what status information you disabled the script for resuming, also disable ...
User Guide
Page 18
...in megabytes. Subcommands for the stat Command You can use the stat command to the virtual machine's swap file, in megabytes. Use vmware-toolbox-cmd. Table 2. swap (ESX/ESXi only) Displays the current amount of the subcommands available for virtual machines hosted on an ...balloon (ESX/ESXi only) Displays the amount of memory that is currently reclaimed from the virtual machine through ballooning, in MHz. Use vmware-tools-cli. Additional subcommands are available for virtual machines hosted on an ESX/ESXi server. memlimit (ESX/ESXi only) Displays memory limit...
...in megabytes. Subcommands for the stat Command You can use the stat command to the virtual machine's swap file, in megabytes. Use vmware-toolbox-cmd. Table 2. swap (ESX/ESXi only) Displays the current amount of the subcommands available for virtual machines hosted on an ...balloon (ESX/ESXi only) Displays the amount of memory that is currently reclaimed from the virtual machine through ballooning, in MHz. Use vmware-tools-cli. Additional subcommands are available for virtual machines hosted on an ESX/ESXi server. memlimit (ESX/ESXi only) Displays memory limit...
User Guide
Page 19
Using the VMware Tools Configuration Utility Exit Codes You might use exits codes if you want to display valid names of devices. For the shrink command, 1 means that ... 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. VMware, Inc. 19 Use the list subcommand to integrate the VMware Tools configuration utility commands with the host (EX_UNAVAILABLE).
Using the VMware Tools Configuration Utility Exit Codes You might use exits codes if you want to display valid names of devices. For the shrink command, 1 means that ... 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. VMware, Inc. 19 Use the list subcommand to integrate the VMware Tools configuration utility commands with the host (EX_UNAVAILABLE).