Who Should Install This Hotfix?

This is a hotfix for customers running Citrix Hypervisor 8.2 Cumulative Update 1 and is only available to customers on the Customer Success Services program.

Note: Citrix Hypervisor 8.2 Cumulative Update 1 reaches end of life on Jun 25, 2025. Upgrade to XenServer 8 before this date.

Where To Get This Hotfix

Download Citrix Hypervisor 8.2 Cumulative Update 1 hotfixes from the product downloads pages.

Information About this Hotfix

Issues Resolved In This Hotfix

This hotfix resolves the following issues:

• When the number of hosts in a pool is large, sometimes high availability can't process heartbeats in time. As a result, the host whose heartbeats can't be processed is marked as offline and self-fences.
• If there are connectivity issues between the pool coordinator and a host in the pool, a VM on the host that is rebooted during or after the connectivity issue might become unresponsive or might fail to start with the error: "an emulator required to run this VM failed to start".
• Long running VDI migrations can fail with connection reset.
• Sometimes, VM operations that should be allowed are incorrectly blocked by XenCenter. This issue is caused by the list of allowed operations not being correctly recomputed after changes.
• The server status report does not include up-to-date RRD information.
• If you have a subset of hotfixes applied on your Citrix Hypervisor 8.2 Cumulative Update 1 host, license checks might fail for perpetual licenses.

Improvements Included In This Hotfix

This hotfix includes the following improvements:

• To enhance scalability and better support larger pool configurations, the default limit of TCP connections has been increased.

  This change might cause a small number of environments to experience issues with too many operations running in parallel. In this case, the logs show the error: "Raised Unix.Unix_error(Unix.EMFILE, "open", "/dev/urandom")".

  If you encounter this issue:

  • For pools with more than 16 hosts, we recommend that you upgrade to XenServer 8. By doing so, you also benefit from the many new features and improvements in XenServer 8. For more information, see What's New.
  • For pools with 16 or fewer hosts, contact Technical Support for advice about a workaround.
• Improvements to logging related to high availability.

This hotfix also includes the following previously released hotfixes:

• CTX341967 - Hotfix XS82ECU1004 - For Citrix Hypervisor 8.2 Cumulative Update 1
• CTX463430 - Hotfix XS82ECU1011 - For Citrix Hypervisor 8.2 Cumulative Update 1
• CTX466065 - Hotfix XS82ECU1019 - For Citrix Hypervisor 8.2 Cumulative Update 1
• CTX493666 - Hotfix XS82ECU1027 - For Citrix Hypervisor 8.2 Cumulative Update 1
• CTX564659 - Hotfix XS82ECU1033 - For Citrix Hypervisor 8.2 Cumulative Update 1
• CTX564360 - Hotfix XS82ECU1040 - For Citrix Hypervisor 8.2 Cumulative Update 1
• CTX579955 - Hotfix XS82ECU1049 - For Citrix Hypervisor 8.2 Cumulative Update 1
• CTX587615 - Hotfix XS82ECU1053 - For Citrix Hypervisor 8.2 Cumulative Update 1
• CTX633179 - Hotfix XS82ECU1064 - For Citrix Hypervisor 8.2 Cumulative Update 1
• CTX677991 - Hotfix XS82ECU1066 - For Citrix Hypervisor 8.2 Cumulative Update 1
• CTX691819 - Hotfix XS82ECU1074 - For Citrix Hypervisor 8.2 Cumulative Update 1

Installing the Hotfix

Before you apply a hotfix, ensure that you have reviewed the prerequisites listed in Prepare a pool for an update in the Citrix Hypervisor documentation.

Customers should use either XenCenter or the Citrix Hypervisor Command Line Interface (CLI) to apply this hotfix. As with any software update, back up your data before applying this update. Citrix recommends updating all servers within a pool sequentially. Upgrading of servers should be scheduled to minimize the amount of time the pool runs in a "mixed state" where some servers are upgraded and some are not. Running a mixed pool of updated and non-updated servers for general operation is not supported.

Installing the Hotfix by using XenCenter

Choose an Installation Mechanism

There are three mechanisms to install a hotfix:

1. Automated Updates
2. Download update from Citrix
3. Select update or Supplemental pack from disk

The Automated Updates feature is available for Citrix Hypervisor Premium Edition customers, or to those who have access to XenServer through their Citrix Virtual Apps and Desktops entitlement. For information about installing a hotfix using the Automated Updates feature, see Apply Automated Updates in the Citrix Hypervisor documentation.

For information about installing a hotfix using the Download update from Citrix option, see Apply an Update to a Pool in the Citrix Hypervisor documentation.

The following section contains instructions on option (3) installing a hotfix that you have downloaded to disk:

1. Download the hotfix to a known location on a computer that has XenCenter installed.
2. Unzip the hotfix zip file and extract the .iso file
3. In XenCenter, on the Tools menu, select Install Update. This displays the Install Update wizard.
4. Read the information displayed on the Before You Start page and click Next to start the wizard.
5. Click Browse to locate the iso file, select XS82ECU1080.iso and then click Open.
6. Click Next.
7. Select the pool or servers you wish to apply the hotfix to, and then click Next.
8. The Install Update wizard performs a number of update prechecks, including the space available on the servers, to ensure that the pool is in a valid configuration state. The wizard also checks whether the servers need to be rebooted after the update is applied and displays the result.
9. Choose the Update Mode. Review the information displayed on the screen and select an appropriate mode.
10. Click Install update to proceed with the installation. The Install Update wizard shows the progress of the update, displaying the major operations that XenCenter performs while updating each server in the pool.
11. When the update is applied, click Finish to close the wizard.
12. If you chose to carry out the post-update tasks, do so now.

Installing the Hotfix by using the xe Command Line Interface

1. Download the update file to a known location on the computer running the xe CLI.
2. Extract the .iso file from the zip.
3. Upload the .iso file to the main server of the pool by entering the following commands:
   (Where -s is the main server's IP address or DNS name.)
   

   xe -s <server> -u <username> -pw <password> update-upload file-name=<filename>/XS82ECU1080.iso

   Citrix Hypervisor assigns the update file a UUID which this command prints. Note the UUID.

   d795dfd8-545f-4f82-8452-17c2dbeaa0c6

4. Apply the update to all servers in the pool, specifying the UUID of the update:

   xe update-pool-apply uuid=d795dfd8-545f-4f82-8452-17c2dbeaa0c6

   Alternatively, if you need to update and restart servers in a rolling manner, you can apply the update file to an individual server by running the following:

   xe update-apply host=<server> uuid=d795dfd8-545f-4f82-8452-17c2dbeaa0c6

    

   If the server is a member of a pool, ensure that you update the pool master for Citrix Hypervisor 8.2 CU1 before you update any other pool member.

5. Verify that the update was applied by using the update-list command.

   xe update-list -s <server> -u root -pw <password> name-label=XS82ECU1080

   If the update is successful, the hosts field contains the UUIDs of the servers to which this update was successfully applied. This should be a complete list of all servers in the pool.
6. The hotfix is applied to all servers in the pool, but it will not take effect until the XAPI service is restarted on all servers. On the console of each server in the pool beginning with the main server, enter the following command to restart the XAPI service:

   xe-toolstack-restart

   Note: When this command is run on the main server of the pool, XenCenter loses connection to the pool. Wait for 30 seconds after losing connection, and then reconnect manually.
7. Use the update-pool-clean command to remove the update files from all servers in the pool. This command frees up space on shared storage and does not uninstall the update.

   xe update-pool-clean uuid=d795dfd8-545f-4f82-8452-17c2dbeaa0c6

Hotfix Source

This source code is not necessary for hotfix installation. It is provided to fulfill licensing obligations.

Download the hotfix source from the following link: XS82ECU1080-sources.iso.

Files

Hotfix File

Files Updated

More Information

For a list of the minimum set of hotfixes you must apply to get your pool up to date, see Recommended Hotfixes for Citrix Hypervisor 8.2 Cumulative Update 1.

For more information, see Citrix Hypervisor Documentation.

If you experience any difficulties, contact Citrix Technical Support.