Hotfix XS82ECU1040 - For Citrix Hypervisor 8.2 Cumulative Update 1

Hotfix XS82ECU1040 - For Citrix Hypervisor 8.2 Cumulative Update 1

book

Article ID: CTX564360

calendar_today

Updated On:

Description

Who Should Install This Hotfix?

This is a hotfix for customers running Citrix Hypervisor 8.2 Cumulative Update 1. This hotfix is required as a prerequisite for Hotfix XS82ECU1045.

Note: This hotfix is available only to customers on the Customer Success Services program.

Where To Get This Hotfix

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

Information About this Hotfix

ComponentDetails
PrerequisiteNone
Post-update tasksRestart the XAPI Toolstack
Content live patchable**No
Baselines for Live PatchN/A
Revision History

Published on Aug 8, 2023

** Available to Enterprise Customers.

Improvements In This Hotfix

This hotfix includes the following improvement:

  • Enables hotfix XS82ECU1045 to expose additional Intel CPU features to the VMs.

    This set of CPU features (listed in MSR_ARCH_CAPS) enable significant performance improvements for VMs hosts on pools of servers with Cascade Lake or later Intel CPUs.

    To benefit from this change:

    1. All hosts in your pool must have Cascade Lake or later CPUs.
    2. Install this hotfix.
    3. Install Hotfix XS82ECU1045.
    4. Restart all hosts in the pool.
    5. Restart the VMs in the pool to enable them to see the new CPU features.

     

 

This hotfix also includes the following previously released hotfixes:

Installing the Hotfix

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 the Applying Automated Updates in the Citrix Hypervisor documentation.

For information about installing a hotfix using the Download update from Citrix option, see Applying 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:

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 server.

  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 XS82ECU1040.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 hotfix file to a known location.
  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>/XS82ECU1040.iso
    Citrix Hypervisor assigns the update file a UUID which this command prints. Note the UUID.
    4881af5e-4259-47d7-ac7f-92e5532ef5cb
  4. Apply the update to all servers in the pool, specifying the UUID of the update:
    xe update-pool-apply uuid=4881af5e-4259-47d7-ac7f-92e5532ef5cb

    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=4881af5e-4259-47d7-ac7f-92e5532ef5cb

     

  5. Verify that the update was applied by using the update-list command.
    xe update-list -s <server> -u root -pw <password> name-label=XS82ECU1040
    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=4881af5e-4259-47d7-ac7f-92e5532ef5cb

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: XS82ECU1040-sources.iso.

Files

Hotfix File

ComponentDetails
Hotfix FilenameXS82ECU1040.iso
Hotfix File sha2563ad3fbeb3bdde1fc0e76e1763a1205606a6e2c72462fc33d3bd74d46bdaee4cf
Hotfix Source FilenameXS82ECU1040-sources.iso
Hotfix Source File sha2561b2d59b45ef6c621c712a61440bf69d4fcb9914ee11701b8fba52584685ccb08
Hotfix Zip FilenameXS82ECU1040.zip
Hotfix Zip File sha256fdca98555cd9b03ad068a683c407037fa6eaf71f4fca9a113ca422d75cdfc734
Size of the Zip file64.42 MB

Files Updated

forkexecd-1.18.3-2.xs8~2_1.x86_64.rpm
gpumon-0.18.0-10.xs8~2_1.x86_64.rpm
message-switch-1.23.2-9.xs8~2_1.x86_64.rpm
rrd2csv-1.2.6-7.xs8~2_1.x86_64.rpm
rrdd-plugins-1.10.9-4.xs8~2_1.x86_64.rpm
sm-cli-0.23.0-53.xs8~2_1.x86_64.rpm
squeezed-0.27.0-10.xs8~2_1.x86_64.rpm
v6d-citrix-10.53.2-4.xs8~2_1.x86_64.rpm
varstored-guard-0.6.2-7.xs8~2_1.x86_64.rpm
vhd-tool-0.43.0-10.xs8~2_1.x86_64.rpm
wsproxy-1.12.0-11.xs8~2_1.x86_64.rpm
xapi-clusterd-0.50.3-5.xs8~2_1.x86_64.rpm
xapi-core-1.249.32-1.xs8~2_1.x86_64.rpm
xapi-nbd-1.11.0-9.xs8~2_1.x86_64.rpm
xapi-storage-script-0.34.1-8.xs8~2_1.x86_64.rpm
xapi-xe-1.249.32-1.xs8~2_1.x86_64.rpm
xcp-networkd-0.56.2-7.xs8~2_1.x86_64.rpm
xcp-rrdd-1.33.2-6.xs8~2_1.x86_64.rpm
xenopsd-0.150.17-1.xs8~2_1.x86_64.rpm
xenopsd-cli-0.150.17-1.xs8~2_1.x86_64.rpm
xenopsd-xc-0.150.17-1.xs8~2_1.x86_64.rpm

More Information

For more information, see Citrix Hypervisor Documentation.

If you experience any difficulties, contact Citrix Technical Support.

Issue/Introduction

This hotfix enables hotfix XS82ECU1045 to expose additional Intel CPU features to the VMs.