Summary
XenServer 6.1.0 is supplied with two versions of the XenServer Tools (sometimes known as the Windows PV drivers). The standard version (as installed using the installwizard.msi wizard), and the legacy version (installed using the xenlegacy.exe wizard).
The standard XenServer Tools do not include support for Volume Shadow Copy Service (VSS) or Citrix Provisioning Services (PVS). For customers who wish to use VSS or PVS, the legacy XenServer Tools must be used.
This document contains procedures on how to install the legacy XenServer Tools and procedures for switching between the standard and legacy XenServer Tools. This includes the following scenarios:
- Installing the legacy XenServer Tools on a new VM.
- Installing the legacy XenServer Tools on a VM which already has the standard XenServer Tools installed.
This document also describes how to reinstall the standard XenServer Tools having previously uninstalled them.
WARNING: Customers should take great care when carrying out these instructions. Failure to do so may result in unbootable VMs.
Requirements
Administrative access to a XenServer host console either directly, through SSH, or by using the Console tab in XenCenter and administrative console access to the VM.
Note: During this procedure, network access to the VM may be lost temporarily.
Background
The standard XenServer Tools do not support VSS which is used for quiesced snapshots. Additionally, these Tools contain a known issue, where PVS delivered VMs are unable to identify their resident host. This means that customers using XenServer Platinum Licensing are unable to license their PVS VMs.
Installing legacy XenServer Tools
Before installing the legacy XenServer Tools, customers who have already installed the standard XenServer Tools must remove them:
Removing the standard XenServer Tools
- In the VM, click the Start button, point to Control Panel, select Programs and then Programs and Features.
- Select each of the following programs, and then click Uninstall:
- Windows Driver Package – Citrix Systems Inc. (xenbus) System
- Windows Driver Package – Citrix Systems Inc. (xennet) Net
- Windows Driver Package – Citrix Systems Inc. (xenvif) System
- Windows Driver Package – Citrix Systems Inc. (xeniface) System
- Windows Driver Package – Citrix Systems Inc. (xenvbd) SCSIAdapter
- Citrix XenServer Tools Installer
- Citrix XenServer Windows Guest Agent
Note: When uninstalling the Windows driver packages, a Remove Driver warning dialog box will be displayed. Click Yes to this dialog.
Installing legacy XenServer Tools
Before the legacy Tools can be installed, the VM metadata must be switched to a state that is compatible with them. To do this, execute the following commands on the XenServer host console:
- Run the following command to find the VM UUID:
xe vm-list
This returns a list of all VMs, note the UUID of the VM.
- Set the state of the VM to be compatible with the legacy tools by running the following command:
xe vm-param-set uuid=<vm_uuid> platform:device_id=0001
- Reboot the VM.
The VM is now in a state compatible for use with the legacy XenServer Tools.
- Ensure xs-tools.iso is mounted in the VM’s virtual CD/DVD drive.
- In Windows Explorer, navigate to the XenServer Tools CD. Select it, right-click and from the shortcut menu, select Open. This displays the contents of the CD.
- Double click xenlegacy.exe.
- Follow the on-screen instructions, rebooting the VM when prompted.
To reinstall the standard XenServer Tools
Customers who wish to return to using the standard tools should carry out the steps in the procedure below.
WARNING: This procedure should only be used after following the uninstall procedure above. Carrying out the procedure below before manually removing the standard tools may result in the VM becoming unbootable.
Note: Failure to follow the procedure below may result in the XenServer Tools installer hanging, this can be resolved by cancelling the installation and following the procedure.
- Ensure that the xs-tools.iso is mounted in the VM’s virtual CD/DVD drive.
- In Windows Explorer, navigate to the XenServer Tools CD. Select it, right-click and from the shortcut menu, select Open.This displays the contents of the CD.
- Depending on your operating system type, right-click on citrixxendriversx86.msi or citrixxendriversx64.msi and from the shortcut menu, click Uninstall.
- Double click on installwizard.msi, and follow the on-screen instructions, allowing the VM to reboot automatically.
If the XenServer Tools Installation Wizard hangs, customers should carry out the following steps:
- Cancel the XenServer Tools Installation wizard.
- Open the Windows Device Manager, and find the devices under Other devices. For each device:
- Right click on the device, and from the short-cut menu, select Update Driver Softwareâ¦. This displays the Update Driver Software Window.
- Select Search automatically for updated driver software.
- At the next prompt, select Don’t search online.
- This installs the Citrix driver. When the installation has completed, click Close, and if prompted restart the VM. Repeat this procedure for the other devices in the Other Devices list.
- When the VM restartrs, in Windows Explorer, navigate to the XenServer Tools CD. Select it, right-click and from the shortcut menu, selectOpen. This displays the contents of the CD.
- Double-click on installwizard.msi. This displays the XenServer Tools Installation Wizard, click Remove.
- When the uninstallation has completed, click Install tools.
The XenServer Tools should now display as Optimized in the VM’s General tab in XenCenter.
Thomas Poppelgaard
| #
Hi Steve normal I install the GRID driver to device and when its workin, I disable the default VGA device.
Have you applied latest hotfix to the XS6.1 there are some crucial hotfixes to the GPU pass-through, that could crash the GRID’s, when you power on a VM with GPU pass-through.
Steve
| #
Just a quick question on your setup. We just got a system similar to yours (R720, 2xGrid K2 cards, XenServer 6.1, XenApp 6.5). The GRID K2 driver installs (320.00), but the device shows up as stopped in device manager. Did you use any special options when installing the nVidia driver? Or somehow remove the default VGA device?
Dan
| #
Hi Thomas,
Some features in your screenshots (eg create appointments and contacts) seem to be missing from the iOS version of @WorkMail that got released in April, do you know if these features are still coming in a future release? The Android client is far more functional by comparison.
Regards
Dan
Christian Eilskov
| #
You can see the DHCP options here:
http://www.wyse.com/kb and search for 21501
You can transfer a image using Wyse Device Manager(WDM), the same goes for smaller updates like new ICA client and so.
Thomas Poppelgaard
| #
Thank you Barry =)
The deep compression codec for Citrix XenDesktop HDX 3D Pro will be intergrated for Citrix XenApp in Excalibur so there is a big difference with bandwidth consumption. This means that XenApp in Excalibur will be the best platform for user density and works great over WAN with high latency as HDX 3D Pro have been known to deliver for several years. Yes i know of cases with WAN optimization, I will gather these and share them.
Best regards
Thomas