Product Documentation

Upgrade

Sep 11, 2017

Important

Before you upgrade to XenMobile 10.7 (on-premises)

  1. If the virtual machine running the XenMobile Server to be upgraded has less than 4 GB of RAM, increase the RAM to at least 4 GB. Keep in mind that the recommended minimum RAM is 8 GB for production environments.
  2. For upgrades from XenMobile 10.4 or earlier: Make a note about your configurations for the Passcode and Restrictions device policies for Windows tablets. Those policies are no longer based on WMI. As a result, the upgrade removes the existing configurations. After the upgrade, reconfigure the Passcode and Restrictions device policies for Windows tablets.
  3. If you have the deprecated Enterprise Data Protection device policy configured, delete the policy before upgrading.
  4. Recommendation: Before you install a XenMobile update, use the functionality in your VM to take a snapshot of your system. Also, back up your system configuration database. If you experience issues during an upgrade, complete backups enable you to recover.

After you upgrade to XenMobile 10.7 (on-premises)

  • If functionality involving outgoing connections stop working, and you haven't changed your connections configuration, check the XenMobile Server log for errors such as the following: “Unable to connect to the VPP Server: Host name '192.0.2.0' does not match the certificate subject provided by the peer”

    The certificate validation error indicates that you need to disable hostname verification on XenMobile Server. By default, hostname verification is enabled on outgoing connections except for the Microsoft PKI server. If hostname verification breaks your deployment, change the server property disable.hostname.verification to true. The default value of this property is false.

Citrix publishes new versions or important updates of XenMobile to Citrix.com. At the same time, a notice is sent to the contact on record for each customer.

You have these options for upgrading XenMobile:

  • To upgrade from XenMobile 10.6 or 10.5 to XenMobile 10.7. Use the Release Management page in the XenMobile console. You do not use the Upgrade Tool to upgrade XenMobile 10 installations.
  • To upgrade from XenMobile 10.4 to XenMobile 10.7. Use the Release Management page in the XenMobile console to upgrade in the following sequence. You do not use the Upgrade Tool for these installations.
    • Upgrade from XenMobile 10.4 to XenMobile 10.6.
    • Upgrade from XenMobile 10.6 to XenMobile 10.7.
  • To upgrade from XenMobile 10.3.6 to XenMobile 10.7. Use the Release Management page in the XenMobile console to upgrade in the following sequence. You do not use the Upgrade Tool for these installations.
    • Upgrade from XenMobile 10.3.6 to XenMobile 10.5.
    • Upgrade from XenMobile 10.5 to XenMobile 10.7.
  • To upgrade from XenMobile 10 or 10.1 to XenMobile 10.7. Use the Release Management page in the XenMobile console to upgrade in the following sequence. You do not use the Upgrade Tool for these installations.
    • Upgrade from XenMobile 10 or 10.1 to XenMobile 10.3.5.
    • Upgrade from XenMobile 10.3.5 to XenMobile 10.4.
    • Upgrade from XenMobile 10.4 to XenMobile 10.6.
    • Upgrade from XenMobile 10.6 to XenMobile 10.7.
  • To upgrade from XenMobile 9.0 to the latest XenMobile release.
    Use the XenMobile Upgrade Tool that is built in to XenMobile 10.6. Verify that your XenMobile 10.6 environment is working and then upgrade from XenMobile 10.6 to XenMobile 10.7. See the articles in this section for details. The Upgrade Tool supports all XenMobile 9 editions: MDM, App, and Enterprise.

This article details the versions to use for upgrades, how to use the Release Management page, and how to upgrade clustered XenMobile deployments.

Upgrade path summary

Current XenMobile Server version Release number Upgrade to Release number Upgrade path Update location

XenMobile Server 9 with App Controller Rolling Patch 9 installed

9.0.0_97106

XenMobile Server 10.6

10.6.0

XenMobile Server 9 upgrade to XenMobile Server 10.6.
 

Then, XenMobile Server 10.6 upgrade to XenMobile 10.7

Download the App Controller rolling patch prerequisite.

  • The Upgrade Tool for XenMobile 10.6 is built into XenMobile Server 10.6.
  • After upgrading to XenMobile Server 10.6, test the XenMobile 10.6 environment. Then, upgrade from XenMobile Server 10.6 to XenMobile Server 10.7.
  • For more information, see Upgrade Tool prerequisites.

XenMobile Server 10 or XenMobile 10.1

10.1.0.63030

XenMobile Server 10.3.5

10.3.5

XenMobile 10 or XenMobile 10.1 upgrade to XenMobile 10.3.5

XenMobile Server 10.3.5

10.3.5

XenMobile Server 10.4

10.4.0.116

XenMobile 10.3.5 upgrade to XenMobile 10.4

XenMobile Server 10.4

10.4.0.116

XenMobile Server 10.6

10.6.0

XenMobile 10.4 upgrade to XenMobile 10.6

XenMobile Server 10.5

10.5.x

XenMobile Server 10.7

10.7.0

XenMobile 10.5 upgrade to XenMobile 10.7

XenMobile Server 10.6

10.6.x

XenMobile Server 10.7

10.7.0

XenMobile 10.6 upgrade to XenMobile 10.7

To upgrade using the Release Management page

Use the Release Management page to upgrade from supported XenMobile 10 versions (indicated in the preceding table) to the latest version of XenMobile Server.

Prerequisites:

If you have a clustered deployment, see the instructions at the end of this article.

1. Log on to your account on the Citrix website and download the XenMobile Upgrade (.bin) file to an appropriate location.

2. In the XenMobile console, click the gear icon in the upper-right corner of the console. The Settings page appears.

3. Click Release Management. The Release Management page appears.

localized image

4. Under Updates, click Update. The Update dialog box appears.

localized image

5. Select the XenMobile upgrade file you downloaded from Citrix.com by clicking Browse and navigating to the file location.

6. Click Update and then if prompted, restart XenMobile.

If for some reason the update cannot be completed successfully, an error message appears indicating the problem. The system is reverted to its state previous to the update attempt.

Note: After an upgrade, XenMobile requires a restart. Use the XenMobile CLI to restart XenMobile Server. It's important that you clear your browser cache after the system restarts.

To upgrade clustered XenMobile deployments

Important

Before you install a XenMobile update, use the functionality in your virtual machine (VM) to take a snapshot of your system. Also, back up your system configuration database. If you experience issues during an upgrade, complete backups enable you to recover.

If your system is configured in cluster mode, follow these steps to update each node from a XenMobile 10 release:

1. Upload the .bin file on all nodes from Settings > Release Management.

2. Shut down all the nodes from the System Menu in the CLI.

3. Bring up one node, from the System Menu in the CLI, and check that the service is running.

4. Bring up other nodes one after the other.

If XenMobile can't complete the update successfully, an error message appears indicating the problem. XenMobile then reverts the system to its state previous to the update attempt.