Who Should Install This Hotfix?
This is a hotfix for customers running XenServer 7.0.
Note: Customers MUST install Hotfix XS70E004 before attempting to apply this hotfix.
Note: This hotfix is available only to customers on the Customer Success Services program.
Issues Resolved In This Hotfix
This hotfix resolves the following issues:
- A VM taking more than 30 seconds to shut down can lead to the error “Domain stuck in dying state after 30s”.
- Automated guest agent update stops working after a host reboot, due to its dependency on entries in xenstore that were not properly recreated after the reboot.
- Windows VMs with XenIface driver version 188.8.131.52 or later installed that are hosted on a XenServer 7.0 host cannot be clean shutdown by using XenCenter. The option is disabled in the XenCenter interface. This issue only occurs if the Management Agent is not running on the VM.
- In high-load situations, XenServer sometimes fails to detect a VM having the latest PV Tools installed and reports them as out of date.
This hotfix also includes the following previously released hotfixes:
- CTX215415 – Hotfix XS70E006 – For XenServer 7.0
- CTX215899 – Hotfix XS70E010 – For XenServer 7.0
- CTX218673 – Hotfix XS70E017 – For XenServer 7.0
- CTX218902 – Hotfix XS70E021 – For XenServer 7.0
- CTX220244 – Hotfix XS70E025 – For XenServer 7.0
- CTX224481 – Hotfix XS70E033 – For XenServer 7.0
- CTX229290 – Hotfix XS70E045 – For XenServer 7.0
- CTX234341 – Hotfix XS70E053 – For XenServer 7.0
- CTX238219 – Hotfix XS70E063 – For XenServer 7.0
- CTX255899 – SUPERSEDED – Hotfix XS70E067 – For XenServer 7.0
This hotfix addresses the following issues that are present in the now superseded hotfix (XS70E067):
- XenCenter 8.0 does not connect to XenServer 7.0 hosts that have XS70E067 applied and reports the following error: “This pool contains servers earlier than Citrix Hypervisor 7.0. Please use an earlier version of XenCenter to manage this pool.” To work around this issue, use XenCenter 7.6 or earlier to connect to these hosts.
Important: If you have already installed XS70E067 on your XenServer 7.0 hosts, you must apply this hotfix before you can upgrade these hosts to a later version of XenServer.
Installing the Hotfix
Customers should use either XenCenter or the XenServer Command Line Interface (CLI) to install this update. When the installation is complete, restart the server for the update to take effect. As with any software update, 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 are upgraded and some are 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 the hotfix update package only. Click the following link to download the source code XS70E070-src-pkgs.tar.bz2 The source code is not necessary for hotfix installation: it is provided to fulfill licensing obligations.
Installing the update by using XenCenter
- Download the update to a known location on a computer that has XenCenter installed.
- In XenCenter, on the Tools menu, select Install Update. This displays the Install Update wizard.
- Click Next to start the wizard.
- Click Add to upload a new update.
- Browse to the location where you downloaded the hotfix, select it, and then click Open.
- From the list of updates select XS70E070.xsupdate and then click Next.
- Select the hosts you wish to apply the Service Pack to, and then click Next.
- The Install Update wizard performs checks to ensure there is sufficient space to upload the update. If there is enough space, the wizard successfully completes the upload. If there is insufficient space to upload the update, an error will be displayed:
- To free up required space, if there are any residual hotfix update files remaining on the host that can be deleted, the wizard offers to clean up these files. Click Clean up to review your options and remove the files. Note that this action does not uninstall hotfixes.
- If the Install Update wizard cannot free up the space required for the upload, you must manually delete files on your host. Click More Info for information about space required and take necessary action to free up the required space.
- The Install Update wizard performs a number of update prechecks, including the space available on the hosts, to verify that the update can be applied on the selected servers and displays the result. 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 and click Next.
- Choose the Update Mode. Review the information displayed on the screen and select an appropriate mode and then click Install update.
- 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
- When the update has been applied, click Finish to close the wizard.
- If you chose to carry out the post-update tasks, do so now.
Note: If you click Cancel at this stage, the Install Update wizard reverts the changes and removes the update file from the host.
Installing the update by using the xe Command Line Interface
- Download the update file to a known location.
- Extract the xsupdate file from the zip.
- Upload the xsupdate file to the Pool Master by entering the following commands:
(Where hostname is the Pool Master’s IP address or DNS name.)
xe patch-upload -s <hostname> -u root -pw <password> file-name= <path_to_update_file>XS70E070.xsupdate
XenServer assigns the update file a UUID which this command prints. Note the UUID.
- Apply the hotfix to all hosts in the pool, specifying the UUID of the hotfix:
xe -s <hostname> -u root -pw <password> patch-pool-apply uuid=80783cdc-8938-11e9-9be0-8b6f74d088d0
- Verify that the update was applied by using the patch-list command.
xe patch-list -s <hostname> -u root -pw <password> name-label=XS70E070
If the update is successful, the hosts field contains the UUIDs of the hosts to which this patch was successfully applied. This should be a complete list of all hosts in the pool.
- To verify in XenCenter that the update is 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.
- The hotfix is applied to all hosts in the pool, but does not take effect until each host restarts. For each host, migrate the VMs that you wish to keep running, and shut down the remaining VMs before restarting the host.
- Use the patch-pool-clean command to remove the update files from all hosts in the pool. This command frees up space in the control domain and does not uninstall the update.
xe patch-pool-clean uuid=80783cdc-8938-11e9-9be0-8b6f74d088d0
|Hotfix File sha256||de5f20b189f149ed489720b89f4e27ebdf92ce9c4633259e0edab6ef1a0e9d9c|
|Hotfix Source Filename||XS70E070-src-pkgs.tar.bz2|
|Hotfix Source File sha256||77e1a300bce2729cac2a97a1884ac403b1fcf7790a1695f6ff2742e2860f8111|
|Hotfix Zip Filename||XS70E070.zip|
|Hotfix Zip File sha256||f315b3494e162cccbab8b9480fb788d1a0e8f9292429a27c79e8f827c2bce914|
For more information, see XenServer 7.0 Documentation.
If you experience any difficulties, contact Citrix Technical Support.