A list containing the majority of Citrix Hypervisor (formerly XenServer) support articles collated to make this page a one stop place for you to search for and find information regarding any issues you have with the product and its related dependencies.
The page is updated daily with new support articles and information. Articles will change from time and if information here is outdated or incorrect please let me know using the comments. Links may also expire or change so if you find broken links, please again let me know. For each issue, known product versions affected are recorded however that does not mean product versions that aren’t listed are not affected.
There is a search box that you can use if looking for a specific fault. For example if you have an error code or error message, use that to perform a search. You can also use your browsers search feature which will perform a search against the whole page based on the words you enter.
XenServer / Citrix Hypervisor
| wdt_ID | Brief Description of Issue | Brief Description of Fix | Applicable Product Versions Affected (if known) | Link to supplemental Support Article(s) |
|---|---|---|---|---|
| 1 | A XenServer 6.2 to 7.1 upgrade fails with "[Errno 28] No space left on device:'/tmp/backup-rORnXu/.xen-backup-partition'". | Find the folders with high inode usage, check which folders have a high number of files e.g. temporary files, and then delete the files from each folder. | https://support.citrix.com/article/CTX227290 | |
| 2 | When attempting to install XenTools you receive error "Your Tools ISO is on a broken SR, XenServer will attempt to fix it before proceeding. Do you wish to continue?". Within "xensource.log" is error "Storage_interface.Sr_not_attached". | Search for stale/duplicate XenServer Tools Storage Repository by running command "xe sr-list name-label="XenServer Tools". If there are multiple entries, find each one with state "currently-attached (RO): false" and forget them. | https://support.citrix.com/article/CTX220219 | |
| 3 | XenServer time is incorrect after changing the BIOS time. | Make sure all XenServer hosts in the pool have identical NTP servrs specified. You may have to manually restart the "ntpd" service and then run a manual sync as explained in the CTX article. | https://support.citrix.com/article/CTX226572 | |
| 4 | Virtual Machine cannot start with error "VDI is being used by another operation". | Look for instances where the VBD is attached to other VMs as described in the CTX article. | https://support.citrix.com/article/CTX214407 | |
| 5 | On some high resolution monitors, the XenServer console does not display. | Use an alternative monitor or connect remotely via SSH for example and edit the grub config file to edit the VGA section, as outlined in the CTX article. | https://support.citrix.com/article/CTX226191 | |
| 6 | You receive error "Internal error: Connection failed: no host resolved" when adding a new server to the pool. | Reconnect XenCenter with the IP address of the pool master and then try again. | https://support.citrix.com/article/CTX224728 | |
| 7 | Applying a patch through XenCenter results in error "invalid_file". Trying to patch via CLI hangs. | This is caused by no SR being elected as the default SR. Right-click on an SR and set it as default. | Citrix XenServer 7.1. | https://support.citrix.com/article/CTX224142 |
| 8 | After upgrading an HPSA driver XenServer can no longer boot. You see error "Kernel panic" on the XenServer console. | Before upgrading the HPSA driver, add options "hpsa hpsa_allow_any=1" to "/etc/modprob.conf". | https://support.citrix.com/article/CTX223518 | |
| 9 | When importing a VHD into XenCenter you receive error "No local storage and no default storage: cannot import Transfer VM" on the XenServer console. | Set a default SR for the pool in XenServer and then reinstall the Transfer VM using the steps provided in CTX article. | https://support.citrix.com/article/CTX215142 | |
| 10 | The Management Interface shows blank in the Nteworking tab on XenCenter and the pool Management Network bond shows as "unknown" after adding a host to the pool. | Find and forget all NICs that are disconnected on both the master host and the host you just added. | Citrix XenServer 7.1. | https://support.citrix.com/article/CTX223314 |
| 11 | When selecting a Master Image during Machine Catalog creation you receive error "You must select a disk image with at least one network card", | This can happen if you have a VM imported from a previous version of XenServer into a higher version. Create a diskless VM but do not start it. Detach the disk associated to the problematic VM and attach it to the newly created diskless VM. Create a Machine Catalog using this VM as the template. | https://support.citrix.com/article/CTX222490 | |
| 12 | XenCenter shows dom0 memory as 4GB after changing it to 32GB, even after a reboot. | During reboot the XenServer was booting to "Trusted Boot" mode rather than "XenServer" mode. The Trusted Mode memory setting was set to 4GB. You configure the default XenServer boot mode to boot into "XenServer" mode as explained in the CTX article. | Citrix XenServer 7.1. | https://support.citrix.com/article/CTX221790 |
| 13 | On a host that has been removed from the pool, a red X displays beside the host name in XenCenter. When you issue a "xe host-forget" against the removed host you receive error "This host cannot be forgotten because there are some user VMs still running host". | You need to determne which VMs are still running on the host and shut them down. This is done via CLI, following the CTX article steps. | https://support.citrix.com/article/CTX126382 | |
| 14 | When starting a virtual machine you receive error "Internal error: xenopsd internal error: Device.Ioemu_failed('vgpu exited unexpectedly')". | If the ECC feature is enabled on a GRID K2 card (disabled by default), virtual GPU fails to start. vGPU is currently not supported with ECC active. Use "nvidia-smi" to list the status of all GPUs and then issue another nvidia-smi command to disable ECC on the culprit GPU as explained in the CTX article. | NVIDIA GRID. | https://support.citrix.com/article/CTX219835 |
| 15 | When using older NVIDIA drivers, XenServer experiences hanging or crashing. | Update drivers to latest version from NVIDIA. | Citrix XenServer 7.0. | https://support.citrix.com/article/CTX223092 |
| 16 | When pointing XenServer to your license server you receive error "A license for XenServer could not be checked-out because the license server could not be reached at the given address and port. Please check the connection details and verify that the license server is running". | Restart the XenServer toolstack, verify the time and date on affected XenServer host, make sure DNS settings are configured correctly so that the license server is resolvable, make sure the firewall is allowing connections. | https://support.citrix.com/article/CTX200015 | |
| 17 | Virtual Machines fail to boot with error "No bootable device found". | Check the position of the OS disk. The disk should be at position 0. This could also be an issue with the RAM on the physical XenServer host. The "mcelog" will contain any RAM related errors. | https://support.citrix.com/article/CTX216911 | |
| 18 | When starting multiple vGPU enabled Virtual Machines, the XenServer host crashes. | This is caused by a feature (PML) introduced with Broadwell CPUs that has been adopted in Xen 4.6 and XenServer 7. As a workaround, disable PML via CLI on each host in the pool. | Citrix XenServer 7.0. | https://support.citrix.com/article/CTX220674 |
| 19 | When upgrading to XenServer Tools 7.0 you receive error "Windows Management Agent failed to install". | Remove "XENBUS" and "XENVIF" keys from the registry using "psexec". Reoot and install the tools again. | https://support.citrix.com/article/CTX215427 | |
| 20 | Window Server 2016 VM template is missing from XenServer 7.1. | Create the template manually by running command "/usr/bin/create-guest-templates". | Citrix XenServer 7.1. | https://support.citrix.com/article/CTX221332 |
| 21 | After upgrading to XenServer 7.1, creating new or reattaching existing NFS storage repositories can fail. | Install Hotfix "XS71E003". | Citrix XenServer 7.1. | https://support.citrix.com/article/CTX223285 |
| 22 | You may experience a system leak in "systemd" when using SSH. | This is a known issue, due to a defect in systemd. Citrix have published a hotfix for XenServer 7.0 and the fix is part of 7.1 CU1. | Citrix XenServer 7.0 and 7.1. | https://support.citrix.com/article/CTX228129 |
| 23 | After an upgrade to XenServer 7.1, the hosts do not reconnect to storage. | The PDB(s) are likely damaged and need recreated, by following steps from the CTX article. | https://support.citrix.com/article/CTX229625 | |
| 24 | When you try and remove a host from the pool you receive error "the SR.shared flag cannot be set to false while the SR remains connected to multple servers". | The CTX article explains how destroying a PBD (Physical Block Device) will get around this issue. | https://support.citrix.com/article/CTX230692 | |
| 25 | The uploaded update package is invalid. | This issue happens when the date on XenServer is older than the date of the "gpg" key. Synchronise the time by running "ntpdate -U 'NTP server IP'" as described in the CTX article. | Citrix XenServer 7.1. | https://support.citrix.com/article/CTX231197 |
| 26 | When adding Hardware HBA Storage through XenCenter you receive error "The SCSlid parameter is missing or incorrect". | Upgrade XenCenter from 7.1.1.4743 to 7.12.5459. | Citrix XenServer 7.1 LTSR CU1. | https://support.citrix.com/article/CTX231200 |
| 27 | XenServer 6.5 upgrade to 7.1 becomes stuck at 72%. | The upgrade isn't actually stuck, it is trying to restore all your previous performance related information. Manually archive the files under "/var/xapi/blobs" and then proceed with the upgrade. | Citrix XenServer 6.5. | https://support.citrix.com/article/CTX224419 |
| 28 | XenServer unexpectedly reboots due to multipath failovers on a Storage Repository. | Download and apply patch "XS71ECU1007". | Citrix XenServer 7.0, 7.1, 7.1 CU1. | https://support.citrix.com/article/CTX232746 |
| 29 | When using the "Rolling Pool Upgrade" feature to upgrade to XenServer 7.1 LTSR, 7.3 or 7.4, XenServer attempts to migrate a VM to the pool master once the master has been upgraded but fails with error "The host does not have some of the CPU features that the VM is currently using". | If you have installed any of the hotfixes listed in the CTX article on your hosts, they introduced virtualisation support for new microprocessor features which can cause issues with migrating VMs to upgraded hosts that do not have the hotfixes. Follow the CTX article for steps to resolve. | Citrix XenServer 7.1, 7.3, 7.4. | https://support.citrix.com/article/CTX235673 |
| 30 | Windows 10 1803 randomly reboots when running on XenServer 7.x | Citrix are aware of this issue and are working initially on an OS-side workaround. | Citrix XenServer 7.x and Microsoft Windows 10 1803. | |
| 31 | You can not start a virtual machine hosted on Dell PowerEdge R730 with AMD S7150X2 GPU cards for vGPU. When starting a vCPU enabled virtual machine you receive error "No free virtual function found". | In the system BIOS enable "SR-IOV" with the AMD GPU set as the secondary adapter. | https://support.citrix.com/article/CTX236465 | |
| 32 | If you are running Citrix Hypervisor (formerly XenServer) on an AMD 62xx/42xx processor with microcode version "0x600063e", live migration can fail with error "VM_INCOMPATIBLE_WITH_THIS_HOST" due to a CPU feature incompatibility issue. | Avoid installing any of the affected hotfixes as outlined in the CTX article. | https://support.citrix.com/article/CTX237585 | |
| 33 | xsconsole may not display any system information after an upgrade to Citrix Hypervisor 7.1 LTSR CU1. | As a workaround, from within xsconsole on an affected host, select "Local Command Shell" and type "xsconsole". After that, you will be able to see the system information. | Citrix Hypervisor 7.1 LTSR CU1. | https://support.citrix.com/article/CTX238781 |
| 34 | The time on a XenServer host is wrong even though NTP is configured. | Follow the steps from the CTX article to fix. This includes stopping the "ntpd" service, running "ntpdate", updating the "hwclock" time and optionally applying a hotfix to NTPD depending on your XenServer version. | https://support.citrix.com/article/CTX227100 | |
| 35 | You cannot create new PVS Target Devices with the XenDesktop Setup Wizard when XenServer is configured with PVS Accelerator. You receive error "There is no Cache Configuration available on the XenServer host". | Editing the "Host" connection within PVS for XenServer fixes the problem, by changing the address to begin with "http://". | https://support.citrix.com/article/CTX239679 | |
| 36 | Some virtual machines fail to start with error "FAILED_TO_START_EMULATOR". In the logs, one M10 core shows error "Initialization: error setting vGPU configuration information from RM error 1". | Upgrading the NVIDIA Tesla M10 driver resolved the issue. | NVIDIA Tesla M10. | https://support.citrix.com/article/CTX231907 |
| 37 | All storage repositories fill up with duplicate MCS base disks. | Use the CTX article steps to identify the base disks and delete them. | https://support.citrix.com/article/CTX234139 | |
| 38 | When installing an update on Citrix Hypervisor you receive error "tools ISO must be unplugged". | Use the CTX article to run commands that force ejection of the tools ISO from virtual machines and deletes any snapshot or VM template that is using the ISO. | https://support.citrix.com/article/CTX230630 | |
| 39 | You cannot enable high availability on a pool. | In this case, time synchronisation was not working and one host had been pointing to an NTP server that did nto exist. Correcting this solved the issue. | https://support.citrix.com/article/CTX240027 | |
| 40 | After installing hotfix "XS71ECU1011" you cannot connect to Citrix Hypervisor from XenCenter, | This issue is caused by a Pure Storage firmware bug. Increase the Dom0 memory and install the patch. If the patch is already installed, uninstall it first then increase Dom0 memory. | Citrix XenServer 7.1 CU1. | https://support.citrix.com/article/CTX232974 |
| 41 | VDAs running on Citrix Hypervisor experience short 1-2 second freezes/hangs. | The latest XenTools update appears to resolve this. | https://discussions.citrix.com/topic/400137-short-session-freeze-and-packet-loss-towards-vda-with-new-golden-image/ | |
| 42 | When starting multiple vGPU enabled VMs, some fail with error "An emulator required to run this VM failed to start". | When using NVIDIA vGPU with XenServer hosts that have more than 768GB of RAM, add the parameter "iommu=dom0-passthrough" to the Xen command line using command "opt/xensource/libexec/xen-cmdline –-set-xen iommu=dom0-passthrough" in the control domain (Dom0). Restart the host afterwards. | Citrix XenServer 7.4. | https://support.citrix.com/article/CTX233509 |
| 43 | Enabling SR-IOV on a Citrix Hypervisor host may result in VFs not being enabled on the requested NICs after system restart. | There may not be enough PCI resources allocated for SR-IOV VFs (Virtual Functions) on the system to start. You can work around this by modifying the Dom0 kernel command arguments as explained in the CTX article. | Citrix XenServer 7.5 & 7.6. | https://support.citrix.com/article/CTX250121 |
| 44 | When using vGPUs, performance is worse than when not using them. | Contact Citrix for a private fix, which will be included in Citrix Hypervisor 8.0. | Citrix XenServer 7.5 & 7.6. | https://support.citrix.com/article/CTX250164 |
| 45 | You receive error "Internal error: Connection failed: no host resolved" when adding a new server to the pool. | This can happen then "resolv.conf" under "/etc/" is empty. | ||
| 46 | On the performance tab in XenCenter, all guests show as consuming 100% of memory. | There is a known issue with the host data collector daemon. Also if the Xen Guest Agent is not running on the guest, it will not pass memory data to the host. Make sure process "XenGuestAgent.exe" is running on the guest. You could also try restarting the performance data collector daemon using command "systemctl restart xcp-rrdd". | https://support.citrix.com/article/CTX256663 | |
| 47 | A machine catalog fails to create using Citrix Hypervisor with error "MC_CreateMachineCatalogInitialzation". | IntelliCache was enabled on the Citrix Hypervisor Hosting connection but the underlying shared storage (SR) was GFS2 which does not support IntelliCache. |