[an error occurred while processing this directive] [an error occurred while processing this directive]
VMware

VMware Workstation 3.2

Features | Documentation | Knowledge Base | Discussion Forums

previous Prev   Contents   Last   Next next

Installing VMware Tools

Installing VMware Tools

The following sections describe how to install VMware Tools:

Don't Forget VMware Tools

Don't Forget VMware Tools

It is very important that you install VMware Tools in the guest operating system. If you do not install VMware Tools, the graphics environment within the virtual machine is limited to VGA mode graphics (640x480, 16 color).

With the VMware Tools SVGA driver installed, VMware Workstation supports up to 32-bit displays and high display resolution, with significantly faster overall graphics performance.

Other tools in the package support time synchronization between host and guest, automatic grab and release of the mouse cursor, copying and pasting between guest and host, and improved mouse performance in some guest operating systems.

The installers for VMware Tools for Windows, Linux and FreeBSD guest operating systems are built into VMware Workstation as ISO image files. (An ISO image file looks like a CD-ROM to your guest operating system and even appears as a CD-ROM in Windows Explorer. You do not use an actual CD-ROM to install VMware Tools, nor do you need to download the CD-ROM image or burn a physical CD-ROM of this image file.)

VMware Tools for Windows supports Windows 95, Windows 98, Windows Me, Windows NT 4.0, Windows 2000, Windows XP and Windows .NET Server guest operating systems.

When you choose Settings > VMware Tools Install from the VMware Workstation menu bar, VMware Workstation temporarily connects the virtual machine's first virtual CD-ROM drive to the ISO image file that contains the VMware Tools installer for your guest operating system and begins the installation process. (If you decide not to proceed with the installation, choose Settings > Cancel VMware Tools Install to return your virtual machine's CD-ROM drive to its original configuration.)

VMware Tools for Windows Guests

VMware Tools for Windows Guests

The details of how you install VMware Tools depend on the version of Windows you are running. The steps that follow show how to install VMware Tools in a Windows Me guest. Some steps that are automated in newer versions of Windows must be performed manually in Windows 9x and Windows NT.

Note: If you are running VMware Workstation for Windows, and your virtual machine has only one CD-ROM drive, the CD-ROM drive must be configured as an IDE or SCSI CD-ROM drive. It cannot be configured as a generic SCSI device.

To add an IDE or SCSI CD-ROM drive, see Adding, Configuring and Removing Devices in a Virtual Machine. For information about generic SCSI, see Connecting to a Generic SCSI Device.

Installing VMware Tools in a Windows Guest Operating System

Installing VMware Tools in a Windows Guest Operating System

  1. Power on the virtual machine.

  2. When the guest operating system starts, prepare your virtual machine to install VMware Tools.

    Choose Settings > VMware Tools Install.

The remaining steps take place inside the virtual machine.

  1. If you have auto-run enabled in your guest operating system (the default setting for Windows operating systems), a dialog box appears after a few seconds. It asks if you want to install VMware Tools. Click Yes to launch the InstallShield wizard.

    If autorun is not enabled, the dialog box does not appear automatically. If it doesn't appear, run the VMware Tools installer. Click Start > Run and enter D:\setup\setup.exe where D: is your first virtual CD-ROM drive.

    Note: You do not use an actual CD-ROM to install VMware Tools, nor do you need to download the CD-ROM image or burn a physical CD-ROM of this image file. The VMware Workstation software contains an ISO image that looks like a CD-ROM to your guest operating system and even appears as a CD-ROM in Windows Explorer. This image contains all the files needed to install VMware Tools in your guest operating system. When you finish installing VMware Tools, this image file no longer appears in your CD-ROM drive.

  2. Follow the on-screen instructions.

  3. On Windows .NET Server , Windows Me, Windows 98 SE and Windows 98 guests, the SVGA driver is installed automatically and the guest operating system uses it after it reboots. With Windows 2000 and Windows XP guests, you do not have to reboot before you can use the new driver.

Additional Steps for Some Versions of Windows When Migrating from Old Disk Versions

Additional Steps for Some Versions of Windows When Migrating from Old Disk Versions

If you are migrating a VMware Workstation 2.0 disk to VMware Workstation 3.2 and your guest operating system is Windows NT, Windows Me, Windows 98 or Windows 95, you need to configure the video driver by hand. Instructions open automatically in Notepad at the end of the installation process. If the Notepad window is hidden, bring it to the front by clicking the Notepad button on the Windows taskbar.

For details, see the steps that correspond to your guest operating system.

Windows NT

Windows NT

  1. After installing VMware Tools, click Finish. The Display Properties dialog box appears.

  2. Click the Display Type button. The Display Type dialog box appears.

  3. Click the Change button. The Change Display dialog box appears.

  4. Select VMware, Inc. from the Manufacturer list.

  5. Select VMware SVGA as the display adapter and click OK.

  6. Click Yes in response to the on-screen question about third-party drivers to install the driver, then click OK to confirm the drivers were installed.

  7. Click Close from the Display Type dialog box, then click Close from the Display Properties dialog box.

  8. Click Yes to restart Windows NT and start using the new video driver.

  9. The VMware Tools background application is launched automatically when you reboot your virtual machine.

Windows Me

Windows Me

  1. After installing VMware Tools, click Finish. The Display Settings dialog box appears.

  2. Click the Advanced button.

  3. Click the Adapter tab.

  4. Click the Change button. This starts the Update Device Driver Wizard.

  5. The Wizard now presents two options. Choose the second option to Specify the location of the driver.

    Click Next.

  6. Check the Specify a location checkbox. Enter the following path:

    D:\video\win9x

    D: is the drive letter for the first virtual CD-ROM drive in your virtual machine.

    Click OK.

  7. Windows Me automatically locates your driver.

  8. Select the VMware SVGA II display adapter and click Next.

  9. Click Next to install the driver.

    If you are upgrading a virtual machine created under VMware Workstation 2.0, you may see a dialog box that warns, "The driver you are installing is not specifically designed for the hardware you have. Do you wish to continue?" Click Yes.

    After the driver is installed, click Finish.

  10. Click Yes to restart Windows Me and start using the new video driver.

  11. The VMware Tools background application starts automatically when you reboot your virtual machine.

Windows 98

Windows 98

  1. After installing VMware Tools, click Finish. The Display Settings dialog box appears.

  2. Click the Advanced button. The Standard Display Adapter (VGA) Properties dialog box appears. If you are upgrading from a previous version of the VMware drivers, this dialog box is titled VMware SVGA Properties.

  3. Click the Adapter tab.

  4. Click the Change button. This starts the Update Device Driver Wizard. Click Next.

  5. The Wizard presents two options. Choose the option to Display a list of all drivers in a specific location. Click Next.

  6. Select Have Disk. The Install From Disk dialog box appears.

  7. Enter the following path:

    D:\video\win9x

    D: is the drive letter for the first virtual CD-ROM drive in your virtual machine.

    Click OK.

  8. Select VMware SVGA display adapter and click OK.

  9. Answer Yes to the on-screen question, then click Next to install the driver. After the driver is installed, click Finish.

  10. Click Close in the SVGA Properties dialog box, then click Close in the Display Settings dialog box.

  11. Click Yes to restart Windows 98 and start using the new video driver.

  12. The VMware Tools background application starts automatically when you reboot your virtual machine.

Windows 95

Windows 95

  1. After installing VMware Tools, click Finish. The Display Settings dialog box appears.

  2. Click the Advanced Properties button. The Advanced Display Properties dialog box appears.

  3. Click the Change button. This brings up the Select Device dialog box.

  4. Select Have Disk.

  5. Enter the following path:

    D:\video\win9x

    D: is the drive letter for the first virtual CD-ROM drive in your virtual machine.

    Click OK.

  6. Click OK again to install the driver.

  7. Click Close from the Advanced Display Properties dialog box, then click Close from the Display Setting dialog box.

  8. Click Yes to restart Windows 95 and start using the new video driver.

  9. The VMware Tools background application starts automatically when you reboot your virtual machine.

VMware Tools for Linux Guests

VMware Tools for Linux Guests

  1. Power on the virtual machine.

  2. After the guest operating system has started, prepare your virtual machine to install VMware Tools.

    Choose Settings > VMware Tools Install.

The remaining steps take place inside the virtual machine.

  1. As root, open a terminal, mount the VMware Tools virtual CD-ROM image, copy its contents to /tmp, then unmount it.

    Note: You do not use an actual CD-ROM to install VMware Tools, nor do you need to download the CD-ROM image or burn a physical CD-ROM of this image file. The VMware Workstation software contains an ISO image that looks like a CD-ROM to your guest operating system. This image contains all the files needed to install VMware Tools in your guest operating system.

    Note: Some Linux distributions use different device names or organize the /dev directory differently. If your CD-ROM drive is not /dev/cdrom, modify the following commands to reflect the conventions used by your distribution.

    mount -t iso9660 /dev/cdrom /mnt
    cp /mnt/vmware-linux-tools.tar.gz /tmp
    umount /dev/cdrom

  2. Untar the VMware Tools tar file in /tmp, and install it.

    cd /tmp
    tar zxf vmware-linux-tools.tar.gz
    cd vmware-linux-tools
    ./install.pl

  3. Start X and your graphical environment if they are not started yet.

  4. In an X terminal, launch the VMware Tools background application.

    vmware-toolbox &

    You may run VMware Tools as root or as a normal user. To shrink virtual disks, you must run VMware Tools as root (su).

Starting VMware Tools Automatically

Starting VMware Tools Automatically

You may find it helpful to configure your guest operating system so VMware Tools starts when you start your X server. The steps for doing so vary depending on your Linux distribution and the desktop environment you are running. Check your operating system documentation for the appropriate steps to take.

For example, in a Red Hat Linux 7.1 guest using GNOME, follow these steps.

  1. Open the Startup Programs panel in the GNOME Control Center.

    Main Menu (the foot icon in the lower left corner of the screen) > Programs > Settings > Session > Startup Programs

  2. Click Add.

  3. In the Startup Command field, enter vmware-toolbox.

  4. Click OK, click OK again, then close the GNOME Control Center.

The next time you start X, VMware Tools starts automatically.

VMware Tools for FreeBSD Guests

VMware Tools for FreeBSD Guests

  1. Power on the virtual machine.

  2. Prepare your virtual machine to install VMware Tools.

    Choose Settings > VMware Tools Install.

The remaining steps take place inside the virtual machine, not on the host computer.

  1. As root, open a terminal, mount the VMware Tools virtual CD-ROM image, copy its contents to /tmp, then unmount it.

    Note: You do not use an actual CD-ROM to install VMware Tools, nor do you need to download the CD-ROM image or burn a physical CD-ROM of this image file. The VMware Workstation software contains an ISO image that looks like a CD-ROM to your guest operating system. This image contains all the files needed to install VMware Tools in your guest operating system.

    mount /cdrom
    cp /cdrom/vmware-freebsd-tools.tar.gz /tmp
    umount /cdrom

  2. Untar the VMware Tools tar file in /tmp, and install it.

    cd /tmp
    tar zxf vmware-freebsd-tools.tar.gz
    cd vmware-freebsd-tools
    ./install.pl

  3. Start X and your graphical environment if they are not started yet.

  4. In an X terminal, launch the VMware Tools background application.

    vmware-toolbox &

You may run VMware Tools as root or as a normal user. To shrink virtual disks, you must run VMware Tools as root (su).

Note: In a FreeBSD 4.5 guest operating system, sometimes VMware Tools does not start after you install VMware Tools, reboot the guest operating system or start VMware Tools on the command line in the guest. An error message appears:

Shared object 'libc.so.3' not found.

The required library was not installed. This does not happen with full installations of FreeBSD 4.5, but does occur for minimal installations. To fix the problem of the missing library, complete the following steps:

  1. Insert and mount the FreeBSD 4.5 installation CD or access the ISO image file.

  2. Change directories and run the install script.

    cd /cdrom/compat3x
    ./install.sh

Installing VMware Tools in a NetWare Virtual Machine

Installing VMware Tools in a NetWare Virtual Machine

  1. Power on the virtual machine.

  2. Prepare your virtual machine to install VMware Tools.

    Choose Settings > VMware Tools Install.

    The remaining steps take place inside the virtual machine.

  3. Load the CD9660.NSS driver so the CD-ROM device mounts the ISO image as a volume. In the system console, type

    LOAD CD9660.NSS

  4. When the driver finishes loading you can begin installing VMware Tools. In the system console, type

    vmwtools:\setup.ncf

  5. Restart the guest operating system. In the system console, type

    restart server

previous Prev   Contents   Last   Next next