Skip to content

How to Install XenServer Tools

Attention

As of 8/22/21, I'm no longer using XCP-NG. This information is being left as reference material, but should be considered outdated and/or inaccurate.

Summary

This article will list the steps involved in installing XenServer Tools on supported and unsupported distros.

Install the Linux Guest Tools on a supported distro

Here's the procedure for supported distros (Debian, Ubuntu, CentOS, RHEL, SLES...).

  • Attach the guest tools ISO to the guest from Xen Orchestra, XCP-ng Center or using xe.
  • Then inside the VM, as root:
mount /dev/cdrom /mnt
bash /mnt/Linux/install.sh
umount /dev/cdrom

Eject the guest tools ISO

If a message asks you to reboot the VM, ignore it. That's an old message from back when it was needed to install a kernel module in addition to the management agent.

Install the Linux Guest Tools on an "unsupported" distro

If you have an "unsupported" distro based on Debian or Ubuntu (like TurnKey Linux for example) the install script will fail to detect it and refuse to install. On these "unsupported" .deb based distros you can override the detection and force the tools to install by using:

bash /mnt/Linux/install.sh -d debian -m 9

If you have an "unsupported" distro based on Fedora or RHEL/CentOS (like FreePBX for example) the install script will fail to detect it and refuse to install. On .rpm based distros you can override the detection and force the tools to install by using:

bash /mnt/Linux/install.sh -d rhel -m 7

The likeliness for the installation to work correctly will depend on how much those distros differ from their "parent".

Reference