New hotfix for Citrix XenServer 6.0

This is a hotfix for customers running Citrix XenServer 6.0.

IMPORTANT: Any issued driver disk and the Driver Development Kit (DDK) for XenServer 6.0 must be updated to be compatible with this hotfix. See CTX133960 – Driver Disks for XenServer Hotfix XS60E016 for a list of the affected driver disks that must be updated.

Issues Resolved In This Hotfix

This hotfix resolves the following issues:

  1. Enabling Generic Receive Offload (GRO) on Physical Network Interfaces (PIF) can flood the log file with the following messages: WARNING: at net/core/dev.c:1594 skb_gso_segment+0x1a1/0x250(). This is due to a bug that incorrectly clears the feature flags in the netback driver.
  2. Timer overflow may occur after 208.5 days resulting in Timer inaccuracies in dom0.
  3. Interaction between a block device, balloon driver and Xen can result in a kernel oops with the following message: BUG: unable to handle kernel NULL pointer dereference at 00000010 / IP: [] mempool_alloc+0x2e/0x110.
  4. VLANs may not work correctly on certain NICs, as the macro definitions are not applied to the dom0 kernel network stack. This is due to an issue in the dom0 kernel build.
  5. Virtual Machine (VM) storage performance is slower than expected, even when the storage is not shared.
  6. If one or more VMs on the same host, attempt to access storage provided by a virtual NFS storage appliance, running inside another VM on the same host, all the VMs involved will deadlock indefinitely.
  7. Virtual Interface (VIF) transmit (TX) counters do not increment when Receive-Side Copy (RSC) is turned on.
  8. Attempts to simultaneously start a significant number of VMs may cause them to become unresponsive during boot, and generate the following error message: kernel BUG at drivers/xen/netback/tx.c:776!.
  9. Crash dump files may not be generated during a hypervisor crash. This is due to a combination of errors in the dom0 kernel and the kdump utility.

In addition, this hotfix also includes fixes released in CTX131745 – Hotfix XS60E003 – For XenServer 6.0.

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.

NOTE: The attachment to this article is a zip file. It contains both the hotfix update package, and the source code for any modified open source components. The source code is not necessary for hotfix installation: it is provided to fulfil licensing obligations.

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 Nextto 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 XS60E016.update 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

Download the update to a known location on a computer that has the XenServer CLI or XenCenter installed.

  1. Extract the xsupdate file from the zip.
  2. If using Windows, start a Command Prompt and navigate to the XenCenter directory, for example:

    cd C:Program filesCitrixXenCenter

  3. Upload the xsupdate file to the Pool Master by entering the following commands: (Where hostnameis the Pool Master’s IP address or DNS name.)

    xe patch-upload -s <hostname> -u root -pw <password> file-name=<path_to_update_file> XS60E016.xsupdate

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

    46BC6C41-3889-41BE-B394-A4D8455A58E2

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

    xe patch-pool-apply uuid=<46BC6C41-3889-41BE-B394-A4D8455A58E2>

  5. Verify that the update was applied by using the patch-listcommand.

    xe patch-list -s <hostname> -u root -pw <password> name-label=XS60E016

    If the update has been successful, the hostsfield will contain the UUIDs of the hosts this patch was successfully applied to. This should be a complete list of all hosts in the pool.

  6. 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.
  7. To verify in XenCenter that the update has been applied correctly, select the Pool, and then click the General tab. This displays the Pool properties. In the Updates section, ensure that the update is listed as Fully applied.

You can download the hotfix here.

One thought on “New hotfix for Citrix XenServer 6.0”

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.