SUPERSEDED: Hotfix XS56EFP1005 - For XenServer 5.6 Feature Pack 1

Who Should Install This Hotfix?

This hotfix is for customers running Citrix XenServer 5.6 Feature Pack 1.

Issue Resolved In This Hotfix

Attached CDROM devices will disappear after a Windows Virtual Machine (VM) migration, which may result in severe performance degradation in the affected Windows VMs due to excess CPU utilisation. Citrix recommends that customers apply this hotfix to resolve this issue.

Installing the Hotfix

Customers should use either XenCenter or the XenServer Command Line Interface (CLI) to install this hotfix. Once the hotfix has installed, the server must be restarted for it to take effect. As with any software update, please back up your data before applying this hotfix. Citrix recommends updating all hosts within a pool sequentially. Updating hosts should be scheduled to minimize the amount of time a pool runs in a "mixed state", that is where some hosts have been updated and some have not. Running a mixed pool of updated and non-updated hosts for general operation is not supported.

Installing the hotfix using XenCenter

1. Download the hotfix to a known location on a computer running XenCenter.
2. On the Tools menu, select Install New Update. This displays the Install Update wizard.
3. Click Next to start the Wizard.
4. Click Add... and then browse to, and select, the update file that you have downloaded. Click Open to add it.
5. From the list of updates select XS56EFP1005.update and then click Next.
6. Select the hosts you wish to apply the update to, and then click Next.
7. Follow the recommendations to resolve any update prechecks that may have failed.
8. If you would like XenCenter to automatically resolve all failed prechecks, click Resolve All.
9. Once all prechecks have been resolved, click Next to continue.
10. Choose to perform the post-update tasks automtically or manually.
    If you choose automatic, XenCenter will perform any post-update actions that may be required (such as rebooting the host).
    If you choose manual, you will be left to perform the actions manually. The post-update actions required are listed in the text box below. If you wish to save the listed actions to a text file for your reference, click Save to File.
11. Click Install update to start the installation.
12. Once the update is finished, click Finish to close the wizard.
13. If you chose to manually perform post-update actions, do so now.

The XenCenter controlled upgrade process reboots each host sequentially starting with the Pool Master. Where possible VMs will be migrated to other running hosts to avoid VM downtime.

Note: While the Pool Master is being rebooted, XenCenter will be unable to monitor the pool.

Installing the hotfix using the off-host CLI

1. Download the hotfix to a known location on a computer that has the XenServer CLI installed.
2. Upload the hotfix to the host you wish to update, or if updating a pool, upload the hotfix to the Pool Master:
   

   xe -s <server> -u <username> -pw <password> patch-upload file-name=<filename>

   Here, -s <server> refers to the hostname.
   XenServer assigns the update file a UUID, which this command prints. Note the UUID:

   6548ea15-2d71-4230-afaf-bf4f4936a893

3. Apply the hotfix to the pool, specifying the UUID of the hotfix, as given by the upload command in the previous step:

   xe -s <server> -u <username> -pw <password> patch-pool-apply
   uuid=6548ea15-2d71-4230-afaf-bf4f4936a893

4. Verify that the update was applied by using the patch-list command. If the update has been successful, the hosts field will contain the host UUID.
5. The hotfix is applied to all hosts in the pool, but it will not take effect until each host has been rebooted. For each host, migrate the VMs that you wish to keep running, and shutdown the remaining VMs before rebooting the host

Files

Hotfix File

Hotfix file name	File MD5 sum
XS56EFP1005.xsupdate	5b2b099fd5e726bc5a3dcd73d7bbfad6

Packages Updated

xapi-core-0.2-unknown.i686.rpm