Who Should Install This Cumulative Update?

Citrix Hypervisor 8.2 Cumulative Update 1 (CH82ECU1) must be installed by customers running Citrix Hypervisor 8.2 LTSR. It includes all previously released Citrix Hypervisor 8.2 hotfixes. Installation of CH82ECU1 is required for all future functional hotfixes for Citrix Hypervisor 8.2 LTSR.

Citrix Hypervisor 8.2 Cumulative Update 1 and its subsequent hotfixes are available only to customers on the Customer Success Services program.

Citrix will continue to provide security updates to the base Citrix Hypervisor 8.2 product for a period of six months from the release date of the Citrix Hypervisor 8.2 Cumulative Update 1 (until Jun 12, 2022). These hotfixes are available only to customers on the Customer Success Services program.

For more information about Citrix Hypervisor 8.2 CU1, see the Citrix Citrix Hypervisor 8.2 Cumulative Update 1 Release Notes.

Information About this Cumulative Update

Included in this Cumulative Update

This cumulative update includes the following previously released hotfixes.

• XS82E001
• XS82E002
• XS82E003
• XS82E004
• XS82E005
• XS82E006
• XS82E007
• XS82E008
• XS82E009
• XS82E010
• XS82E011
• XS82E012
• XS82E013
• XS82E014
• XS82E015
• XS82E016
• XS82E017
• XS82E018 - Limited Availability
• XS82E019 - Limited Availability
• XS82E020
• XS82E021
• XS82E022
• XS82E023
• XS82E024
• XS82E025
• XS82E026
• XS82E028
• XS82E029
• XS82E030
• XS82E031
• XS82E032
• XS82E033
• XS82E034

This cumulative update also includes additional fixes. For a list of the issues resolved by Citrix Hypervisor 8.2 CU1, see the Citrix Citrix Hypervisor 8.2 Cumulative Update 1 Release Notes.

Installing the Cumulative Update

Customers should use either XenCenter or the Citrix Hypervisor Command Line Interface (CLI) to apply this cumulative update. When the installation is complete, see the Post-update tasks in the table Information About this Cumulative Update for information about any post-update tasks you should perform for the update to take effect. As with any software update, back up your data before applying this update. Citrix recommends updating all hosts within a pool sequentially. Upgrading of hosts should be scheduled to minimize the amount of time the pool runs in a "mixed state" where some hosts are upgraded and some are not. Running a mixed pool of updated and non-updated hosts for general operation is not supported.

Installing the Cumulative Update by using XenCenter

Before installing this cumulative update, it is recommended that you update your version of XenCenter to the latest available version for Citrix Hypervisor 8.2 CU1 (XenCenter 8.2.4 or later).

Choose an Installation Mechanism

There are three mechanisms to install a cumulative update:

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 Enterprise Edition customers, or to those who have access to Citrix Hypervisor through their Citrix Virtual Apps and Desktops entitlement. For information about installing a cumulative update using the Automated Updates feature, see Apply Automated Updates.

Note:To provide a more secure service for hotfix downloads, XenCenter now requires that you authenticate it with Citrix to automatically download and apply hotfixes. To receive these hotfixes through XenCenter, you must also install the latest version of XenCenter and obtain a client ID JSON file. For more information, see Authenticating your XenCenter to receive updates.

For information about installing a cumulative update using the Download update from Citrix option, see Apply an updates to a pool.

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

In addition, the Install Update wizard checks whether a live patch (this is an Enterprise Edition feature) is available for the cumulative update and if the live patch can be successfully applied to the hosts.

Follow the on-screen recommendations to resolve any update prechecks that have failed. If you want XenCenter to automatically resolve all failed prechecks, click Resolve All. When the prechecks have been resolved, click Next.

Note: If you click Cancel at this stage, the Install Update wizard reverts the changes and removes the update file from the host.

1. Download the cumulative update to a known location on a computer that has XenCenter installed.
2. Unzip the cumulative update 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 CH82ECU1.iso and then click Open.
6. Click Next.
7. Select the pool or hosts you wish to apply the cumulative update to, and then click Next.
8. The Install Update wizard performs a number of update prechecks, including the space available on the hosts, to ensure that the pool is in a valid configuration state. The wizard also checks whether the hosts 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. If the update contains a live patch that can be successfully applied to the hosts, it displays No action required on the Tasks to be performed screen.
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 host 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 Cumulative Update by using the xe Command Line Interface

1. Download the cumulative update file to a known location.
2. Extract the .iso file from the zip.
3. Upload the .iso file to the Pool Master by entering the following commands:
   (Where -s is the Pool Master's IP address or DNS name.)

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

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

   cd6e837a-04bc-4fd4-9d1f-3af233198a7f

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

   xe update-pool-apply uuid=cd6e837a-04bc-4fd4-9d1f-3af233198a7f

   Alternatively, if you want to update and restart hosts in a rolling manner, you can apply the update file to an individual host by running the following:

   xe upload-apply host-uuid=<UUID_of_host> uuid=cd6e837a-04bc-4fd4-9d1f-3af233198a7f

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

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

   If the update is successful, the hosts field contains the UUIDs of the hosts to which this cumulative update was successfully applied. This should be a complete list of all hosts in the pool.
6. If the cumulative update is applied successfully, carry out any specified post-update task on each host, starting with the master.

Update Source

This source code is not necessary for update installation: it is provided to fulfill licensing obligations.

Log in to verify download permissions

You must be logged in to your Citrix account to access the following link and to download the source code for any modified open source components CitrixHypervisor-8.2.1-update-sources.iso.

Files

Hotfix File

Files Updated

More Information

For more information, see the Citrix Hypervisor 8.2 Documentation.

If you experience any difficulties, contact Citrix Technical Support.