Previous page

Next page

Locate page in Contents

Print this page

Installing Parallels Tools in a Linux Guest OS

Before installing Parallels Tools in a Linux guest OS, perform the following actions:

  • Close all applications in the guest operating system.
  • Disable the 3D accelerated window manager if you use any.
  • Make sure that you have the gcc package and kernel sources installed. If these packages are not installed, the Parallels Tools installer will inform you about this you. The kernel sources package name depends on the type of Linux operating system you use: it can be kernel-devel , or kernel-headers , or something else. For more information about the kernel sources, refer to the Installing the GCC package and Kernel Sources in Linux section.

Note: To install Parallels Tools in your virtual machine, you must have the root privileges.

Installing Parallels Tools in the most recent versions of Linux guest OSs

If you have one of the most recent versions of Linux OSs (Ubuntu, Fedora) in your virtual machine, the prl-tools-lin.iso image file will be mounted automatically after you connect it to the CD/DVD drive. To install Parallels Tools, do the following:

  1. Start the virtual machine.
  2. When the guest OS boots up, click the Virtual Machine menu and choose Install Parallels Tools .

    Note: If the Install Parallels Tools option is grayed out, make sure that Parallels Tools can be installed in your guest operating system. To see the list of guest OSs supported by Parallels Tools, refer to the Parallels Tools Overview section in Parallels Workstation Extreme User's Guide .

  3. The prl-tools-lin.iso image file will be connected to the virtual machine's CD/DVD drive and mounted.

    You can connect and mount the Parallels Tools ISO image file manually. Right-click the CD/DVD-ROM icon in the virtual machine's window status bar and choose Connect Image . Open the following folder:

    • In 32-bit Windows: C:\Program Files\Parallels\ Parallels Workstation Extreme \Tools\
    • In 64-bit Windows: C:\Program Files (x86)\Parallels\ Parallels Workstation Extreme \Tools\
    • In Linux: /usr/share/ parallels-workstation /tools/

    Select the prl-tools-lin.iso file, and click Open to connect it to the virtual machine.

  4. Start a terminal in your Linux guest OS. Type the following command to gain the root privileges:

    su

  5. Change the directory to the CD/DVD drive directory using

    cd /media/cdrom/

    Note: In some of the Linux operating systems, the mount point for the virtual CD/DVD drive may appear as /media/Parallels\ Tools/ .

  6. In the CD/DVD drive directory, enter the following command to launch Parallels Tools installation:

    ./install

  7. Follow the Parallels Tools Installer instructions to complete the installation.
  8. When the installation of Parallels Tools is complete, restart your virtual machine.

Installing Parallels Tools in other versions of Linux guest OSs

To install Parallels Tools in the older versions of Linux OSs, you have to mount the prl-tools-lin.iso image file manually. Do the following:

  1. Start the virtual machine.
  2. When the guest OS boots up, click the Virtual Machine menu and choose Install Parallels Tools .

    Note: If the Install Parallels Tools option is grayed out, make sure that Parallels Tools can be installed in your guest operating system. To see the list of guest OSs supported by Parallels Tools, refer to the Parallels Tools Overview section in Parallels Workstation Extreme User's Guide .

    The prl-tools-lin.iso image file will be connected to the virtual machine's CD/DVD drive.

  3. Start a terminal in your Linux guest OS. Type the following command to gain the root privileges:

    su

  4. Check if the Parallels Tools CD image is mounted by entering

    mount | grep iso9660

    If this command does not return anything, proceed to the next step.

    If this command returns anything like

    /dev/cdrom on /media/cdrom type iso9660 (ro,exec,nosuid,nodev,uid=0),

    skip the next step and proceed to the following one.

    If this command returns anything like

    /dev/cdrom on /media/cdrom type iso9660 (ro,noexec,nosuid,nodev,uid=0)

    with the noexec option present in parentheses, you need to unmount the disc using the following command and then proceed to the next step:

    umount /dev/cdrom

  5. To mount the Parallels Tools installation disc image, enter the following:

    mount -o exec /dev/cdrom /media/cdrom

    Note: /dev/cdrom is the virtual machine's CD/DVD drive and /media/cdrom is the mount point for this device. In some of the Linux operating systems the virtual CD/DVD drive may appear as /dev/hdb and the mount point /mnt/cdrom . Some Linux OSs do not have the CD/DVD drive mount point. In this case, you should create the mount point directory manually.

  6. When the installation disc image is mounted, change the directory to the CD/DVD drive directory using

    cd /media/cdrom/

  7. In the CD/DVD drive directory, enter the following to launch Parallels Tools installation:

    ./install

    Note: You must have the root privileges to run this command.

  8. Follow the Parallels Tools Installer instructions to complete the installation.
  9. When the installation of Parallels Tools is complete, restart your virtual machine.

How to check if Parallels Tools are installed

If you are not sure whether Parallels Tools are installed, you can easily check this. Start your virtual machine and look at the status bar of its window: if the tip " Press Ctrl + Alt to release the mouse and keyboard " appears in the status bar of the virtual machine's window, this means that Parallels Tools are not installed. When Parallels Tools are installed, you do not need to press any key to release the mouse and keyboard - they are released automatically.

Top of page Feedback