Product Documentation

Upgrade deprecated services

Jun 05, 2015
Updated: 2014-01-13
In-place upgrade of services that come with Services Manager 11 is supported by default. However, some services that were supported in CloudPortal Services Manager 10.0 have been deprecated or support for specific product versions has been removed in Version 11. The following table describes the affected services:
Service name Supported in Version 11.0 Upgrade path
BlackBerry 4 Not supported None. See the section "Upgrade overview."
BroadWorks
CRM 4
SharePoint 3 (WSS 3.0)
Hosted Exchange Multi-tenanted (for Exchange 2010 SP1 in /hosting mode) Not supported See the section "Upgrade process for Hosted Exchange Multi-tenanted."
Hosted Exchange Exchange 2003 not supported See the section "Upgrade process for Hosted Exchange."
Windows Web Hosting IIS 6 not supported See the section "Upgrade process for Windows Web Hosting."

Upgrade overview

The upgrade process for a Services Manager 10 deployment that includes deprecated services is similar to the overview described in Upgrade from CloudPortal Services Manager 10. However, when upgrading web components, the Configuration Tool detects whether or not a deprecated service is present in the deployment. If a deprecated service is detected, the Configuration Tool performs one of the following actions:
  • Informs you of any additional actions that are required before the upgrade process can be completed. This action applies to Hosted Exchange, Hosted Exchange Multi-tenanted, and Windows Web Hosting. Refer to the sections in this topic for information about upgrading these services.
  • Notifies you that the service and all service-related data will be removed from the Services Manager deployment. No Active Directory data is modified or removed. This action applies to BlackBerry 4, BroadWorks, CRM 4, Hosted Exchange Multi-tenanted, and SharePoint 3.
    Note: Removing all service-related data can take time, depending on the size of the deployment. During upgrading, the Configuration Tool displays the progress of data removal. Do not close the Configuration Tool during this process.

After all web components are upgraded successfully, you can upgrade the Reporting service and migrate the data warehouse, as described in Upgrade the Reporting service and data warehouse. Historic billing data is retained and no new billing data is processed for services that have been removed.

Upgrade process for Hosted Exchange

When upgrading the Hosted Exchange service, the Configuration Tool checks the version of Exchange deployed for the service. If Exchange 2003 is detected, the Configuration Tool checks for any existing server connections and user plans. If these items are detected, the Configuration Tool halts upgrading and advises you to remove these items.

If your Services Manager deployment uses Exchange 2003 with the Hosted Exchange service, you need to migrate the Exchange 2003 users to a version of Exchange that Services Manager 11 supports, prior to upgrading. You can do this using the service migration tool in Services Manager 10.

Afterward, you can run the Configuration Tool to upgrade web components, as described in Upgrade web components.

Upgrade process for Hosted Exchange Multi-tenanted

Note: In Services Manager 10, the Hosted Exchange Multi-tenanted service supports installations of Exchange 2010 SP1 in /hosting mode. Services Manager 11 does not include this service due to changes in Microsoft's recommendations for achieving multi-tenancy with Exchange 2010. For more information about these changes, see the article "Multi-Tenant Support" on the Microsoft TechNet web site.

When upgrading the web components in a Services Manager 10 deployment, the Configuration Tool checks for any deprecated services. If the Hosted Exchange Multi-tenanted service is detected, the Configuration Tool halts upgrading and advises you to migrate your users to a supported version of Exchange.

Because the Active Directory structure supporting the Hosted Exchange Multi-tenanted service is incompatible with Services Manager 11 (which supports only the Hosted Exchange service), the Active Directory structure must be transitioned to one that supports the Hosted Exchange service prior to upgrading. If your Services Manager deployment uses the Hosted Exchange Multi-tenanted service, Citrix recommends you contact Microsoft Support for assistance with this transition.

After the transition, you can run the Configuration Tool to upgrade the service. When launched, the Configuration Tool detects the presence of the Hosted Exchange Multi-tenanted service and removes it, along with all service-related data. However, no Active Directory data is modified or removed.

Upgrade process for Windows Web Hosting

When upgrading the Windows Web Hosting service, the Configuration Tool checks the version IIS deployed for the service. If IIS 6 is detected, the Configuration Tool checks for existing server connections and customer plans. If these items are detected, the Configuration Tool halts upgrading and advises you to migrate your customers.

If your Services Manager deployment uses IIS 6 with the Windows Web Hosting service, Citrix recommends you contact Citrix Support for assistance with migrating your customers to Windows Web Hosting using IIS 7.