Who Should Install This Hotfix?

This is a hotfix for customers running Citrix XenServer 5.6 Feature Pack 1. This hotfix includes and supersedes CTX128652 – Hotfix XS56EFP1005 - For XenServer 5.6 Feature Pack 1.

Issue Resolved In This Hotfix

If Virtual Machine (VM) snapshots are taken or deleted when a XenServer Pool is configured without enabling High Availability (HA) support, and one or more slaves lose connectivity to the master node, corruption may occur in the pool.

Customers can identify a corrupted state if the following occurs:

1. A Storage Repository (SR) scan fails, and space is not freed after deleting snapshots.
2. Virtual Disk content is inconsistent causing file system error messages within a VM, application failure or worst case, a VM might crash.
3. Attempting to revert to a VM snapshot fails.

This is due to a bug in the XAPI handling of an HA reset code. This hotfix resolves the issue.

Installing the Hotfix

Customers should use either XenCenter or the XenServer Command Line Interface (CLI) to install this update. Once the update 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. Upgrading of hosts should be scheduled to minimize the amount of time the pool runs in a “mixed state” where some hosts have been upgraded and some have not. Running a mixed pool of updated and non-updated hosts for general operation is not supported.

Installing the update using XenCenter

1. Download the update to a known location on a computer that has XenCenter installed.
2. In XenCenter, on the Tools menu, select Install New Update. This displays the Install Update wizard.
3. Click Next to start the Wizard.
4. Click Add to upload a new update.
5. Browse to the location where you downloaded the hotfix, select it, and then click Open.
6. From the list of updates select XS56EFP1006.xsupdate and then click Next.
7. Select the hosts you wish to apply the hotfix to, and then click Next.
8. Follow the recommendations to resolve any upgrade prechecks.
9. Click Install to start the installation.

Note: 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. When the Pool Master is being rebooted, XenCenter will be unable to monitor the pool.

Installing the update 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 pool or host you wish to apply it to:
   

   xe -s <server> -u root -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:

   2ded311a-03ce-4b2f-8070-35bb10fbf919

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 root -pw <password> patch-pool-apply \
   uuid=2ded311a-03ce-4b2f-8070-35bb10fbf919

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
XS56EFP1006.xsupdate	e3e206439fea4c891f74a58f2d1c9abe

Files Updated

xapi-core-0.2-unknown.i686.rpm