Parallels

Resolution

Parallels Tools for Linux package is compatible with the following list of Linux guest operating systems

OS type:      Xorg version:
--------      ------------
Unbuntu 7.04  7.2.0
Ubuntu 6.10   7.1.1
Ubuntu 6.06   7.0.0
Debian 4.0    7.1.1
FC6           7.1.1
FC5           7.0.0
FC4           6.8.2
FC3           6.8.1
Suse 10.2     7.1.99.902
Suse 10.1     6.9.0
Suse 10.0     6.8.2
Suse 9.3      6.8.2
CentOS 5      7.1.1
RHEL 5        7.1.1
RHEL 4        6.8.1
Mandriva 2007 7.2.0
Mandriva 2006 6.8.99.900
Mandrake 10.1 6.7
Xandros 4.0   6.9.0

Parallels Tools package for Linux guest operating systems includes the following components:

    * Mouse synchronization component. Mouse synchronization is available for all guest operating systems from the list above
    * Dynamic screen resolution change component. This option is provided for guest OSes with Xorg version 6.9 or newer.
    * Time synchronization component. This option is available for all guest operating systems from the list above


Parallels Tools for Linux Installation:

   1.Start Parallels Desktop for Mac, load the Guest OS, proceed to the "Actions" menu on the Mac menubar and choose "Install Parallels Tools…" in order to connect the CD image with Parallels Tools to the Virtual Machine.

   2.In Guest OS mount the Parallels Tools disk, for example: execute “mount /dev/cdrom /mnt/cdrom” command in the console. Then run the installation script from the mounted drive, for example: execute “sh /mnt/cdrom/parallels-tools-install.run” command in the console. NOTE: these commands require root privileges

   3. Reboot the Virtual Machine.


Parallels Tools for Linux Settings:

Dynamic screen resolution change allows guest OS screen to adjust guest OS screen resolution according to the size of the PD window. For Xorg 6.7 and 6.8 `xrandr` tool should be used in the console. This is an example of the list of the different available sizes after executing "xrandr":

To change the screen size to the value from the list please use the following command: `xrandr -s ModeNumber` [please type this command without quotation marks in the console and hit Enter key], for instance:



Time synchronization works with all guests by default. Time is synchronized according to the different time zones. This component has two options:

  -T - to disable time synchronization;
  -d value - to specify time difference from the host (seconds). To specify a negative value 'n' prefix should be used.

Options should be added to /usr/lib/parallels/prluserd script into this section if required:

                    start)
                              prluserd
                      ;;


To disable time sync this section should be like this:

                     start)
                         prluserd -T
                      ;;

or for time in Guest OS to be 1 hour less than in host:

                    start)
                         prluserd -d n3600
                      ;;


After adding or removing options prluserd should be restarted. Prluserd can be stopped with `killall -9 prluserd` and started with `prluserd`commands. Both commands require root privileges.

How to uninstall Parallels Tools in Linux guest operating system:

   1. Start Parallels Desktop for Mac, load the Guest OS, proceed to the "Actions" menu on the Mac menubar and choose "Install Parallels Tools…" in order to connect the CD image with Parallels Tools to the Virtual Machine.

   2.  In Guest OS mount the Parallels Tools disk, for example: execute “mount /dev/cdrom /mnt/cdrom” command in the console. Then run uninstalltion script from the mounted drive, for example: execute “sh /mnt/cdrom/prl-tools-uninstall.sh” command in the console. NOTE: these commands require root privileges.

   3. Please reboot the virtual machine or restart X-server.


Troubleshooting:


    *      X-server is restarted during tools update - functions as designed;
    *      If start-up scripts are bsd-like ( e.g. slackware, zenwalk) then please run prluserd manually (each time after boot) or add the prluserd service to the init script;
    *      On SuSe 10.1 (and probably other Suse 10.x guests) gnome-setting-daemon couldn't start. Seems to be gnome-control-center bug. Please read the following thread for more information: http://bugzilla.gnome.org/show_bug.cgi?id=323724

If Parallels Tools for Linux guest operating systems cannot be installed at all please prepare the following info to provide for investigation:

   1. Exact guest OS name and version;
   2. X-server version (X –server version can be checked by means of `X -version` command);
   3. Error message

If dynamic screen resolution change and/or mouse synchronization components do not work:

   1. Please verify Xorg version. It should be 6.9 or 7.x for dynamic resolution change;
   2. Please verify if prluserd is running. (Prluserd can be checked by means of `ps aux | grep -i prl`). if it isn't running, please launch it with root privileges;
   3. If dynamic screen resolution change and/or mouse synchronization components still do not work please prepare the following info to provide for investigation:

         1. exact guest OS name and version;
         2. X-server version (could be obtained with `X --version` command);
         3. output for `ps aux | grep -i prl`
         4. /etc/X11/xorg.conf and /etc/X11/xorg.conf.prl-backup files
         5. /var/log/Xorg.0.log file

In case of unknown errors during the installation of Parallels Tools for Linux guest operating systems please provide the information listed above to the Support via the website:  http://www.parallels.com/en/support