Product Documentation

Upgrade

Nov 18, 2014

To upgrade existing StoreFront 2.0 through 2.5.x deployments to StoreFront 2.6, run the StoreFront 2.6 installation file. Releases before StoreFront 2.0 cannot be upgraded to StoreFront 2.6 directly. Instead, you must first upgrade StoreFront 1.2 to StoreFront 2.0 before upgrading to StoreFront 2.6. Similarly, you cannot upgrade Receiver Storefront 1.1 to StoreFront 2.6 directly. You must upgrade Receiver Storefront 1.1 to StoreFront 1.2 and then again to StoreFront 2.0 before finally upgrading to StoreFront 2.6. For more information on upgrading from previous releases, see the StoreFront legacacy product documentation.

Once the upgrade process is started, it cannot be rolled back. If the upgrade is interrupted or cannot be completed, the existing configuration is removed but StoreFront is not installed. Before starting to upgrade, you must disconnect users from the StoreFront deployment and prevent users from accessing the servers while the upgrade is in progress. This ensures that all StoreFront files are accessible by the installer during the upgrade. If any files cannot be accessed by the installer, they cannot be replaced and so the upgrade will fail, resulting in the removal of the existing StoreFront configuration. StoreFront does not support multiple server deployments containing different product versions, so all servers in a group must be updated to the upgraded version before granting access to the deployment. Concurrent upgrade is not supported for multiple server deployments, servers must be upgraded sequentially. Citrix recommends that you back up your data before upgrading.

Uninstalling StoreFront removes the authentication service, stores, users' application subscriptions, Receiver for Web sites, Desktop Appliance sites, and XenApp Services URLs. This means that if you decide to uninstall StoreFront, you must manually recreate your services, stores, and sites when you reinstall StoreFront. Upgrading also enables you to preserve your StoreFront configuration and leaves users' application subscription data intact so that users do not need to resubscribe to all of their applications.

Upgrading the operating system version on a server running StoreFront is not supported. Citrix recommends that you install StoreFront on a new installation of the operating system.

To upgrade from StoreFront 2.1 to StoreFront 2.6

  1. If you are upgrading a multiple server StoreFront deployment, disable access to the deployment through the load balancing environment.

    Disabling the load-balanced URL prevents users from connecting to the deployment during the upgrade. All servers in a multiple server deployment must be updated concurrently.

  2. Restart the StoreFront server.

    Restarting the server ensures that any file locks are cleared and that there are no Windows updates pending.

  3. Run the StoreFront installation file as an administrator.
    Important: Be sure that no other installations or updates are in effect while running the StoreFront upgrade.
  4. Restart the StoreFront server and check that all the StoreFront services are running.

    Restarting the server ensures that all caches are cleared and the StoreFront services are restarted.

  5. If you are upgrading a multiple server StoreFront deployment, repeat Steps 2 to 4 for each of the remaining servers in your deployment until you have upgraded them all.
    Important: Ensure you finish upgrading the current server before starting to upgrade the next. In multiple server StoreFront deployments, servers must be upgraded sequentially. Upgrading multiple servers in concurrently is not supported and can cause configuration mismatches that lead to stores, sites, and services becoming unusable.

    When the upgrade process is complete on the final server in your deployment, StoreFront automatically updates the configuration of the other servers in the deployment to match that of the final server.

  6. For multiple server StoreFront deployments, on each server in the deployment, open Event Viewer and, in the left pane, navigate to Applications and Services Logs > Citrix Delivery Services. Search for events logged by the Citrix Subscriptions Store Service with an Event ID of 3 and a Task Category of 2901. Ensure that an entry is logged for each store on every server in the deployment before continuing.
  7. If you are upgrading a multiple server StoreFront deployment, restore access to your deployment through the load-balanced URL.