Product Documentation

Upgrade web services using the graphical interface or command line

Jun 05, 2015
Updated: 2013-08-16
Use this task to upgrade Services Manager web services from Services Manager 10 to Services Manager 11. Perform this task on the servers hosting the following components:
  • Citrix
  • Hosted Exchange
  • Lync
  • Lync Hosted
  • MySQL
  • SharePoint 2010
  • Virtual Machine
  • Windows Web Hosting
Important: Services Manager 11 does not support several services that were supported by Services Manager 10. Before upgrading any web services, refer to Upgrade deprecated services for a list of deprecated services and additional upgrade information.
The upgrade process involves the following tasks:
  • Upgrade the web services installed on each server in your deployment
  • Reconfigure the web services to finalize the upgrade

To upgrade web services using the graphical interface

  1. From the installation media, double-click setup.exe and click Get Started.
  2. On the Select Deployment Task page, select Upgrade Existing Deployment.
  3. On the Upgrade Existing Deployment page, select Upgrade Roles and Services. The Setup Tool verifies the database version. If the correct database version is not detected, the Setup Tool prompts you to manually verify that the system databases have been upgraded and click Next.
  4. When prompted, accept the End User Licensing Agreement and then click Next.
  5. On the Select Components page, select the components you want to upgrade.
  6. On the Ready to upgrade page, click Upgrade. The Setup Tool installs the Configuration Tool, upgrades the selected roles or services, and displays progress.
  7. On the Upgrade Complete page, click Finish.
  8. From the Upgrade Existing Deployment page, select Re-configure Upgraded Roles and Services.
  9. On the Summary page, review the settings that will be reconfigured and click Next. The Configuration Tool restores and upgrades the IIS site for the web service, and displays progress.
  10. When the reconfiguration is complete, click Finish and then click Exit.

To upgrade web services using the command line

When running the Setup and Configuration Tools, use the following information to specify the web service you want to upgrade and the location of its configuration console:
Web service name Configuration console location
Citrix install-locationServicesCitrixWSConfigurationCitrixServiceConfigConsole.exe
Exchange install-locationServicesExchangeWSConfigurationExchangeConfigConsole.exe
LyncEnterprise install-locationServicesLyncWSConfigurationLyncConfigConsole.exe
LyncHosted install-locationServicesLyncHostedWSConfigurationLyncHostedConfigConsole.exe
MySQL install-locationServicesMySQLWSConfigurationMySQLConfigConsole.exe
SharePoint2010 install-locationServicesSharePoint2010WSConfigurationSharePointConfigConsole.exe
VirtualMachine install-locationServicesCitrixWSConfigurationVMConfigConsole.exe
WinWebHosting install-locationServicesCitrixWSConfigurationIISConfigConsole.exe

Install-location denotes the web service installation directory on the local computer. The default directory is C:Program Files (x86)CitrixCortex.

  1. On the server hosting the web service, log on as an administrator.
  2. Open a command line window and navigate to the CortexSetup directory on the Services Manager installation media.
  3. At the command prompt, enter CortexSetupConsole.exe /upgrade:web-service-name /Legacy. The Setup Tool upgrades the service and returns the command prompt.
  4. At the command prompt, enter path-to-service-configuration-console /Upgrade /Legacy. The Configuration Tool reconfigures the web service and returns the command prompt.


The following command upgrades the Citrix web service.
CortexSetupConsole.exe /Upgrade:Citrix /Legacy
The following command reconfigures the Citrix web service.
install-locationServicesCitrixWSConfigurationCitrixServiceConfigConsole.exe /Upgrade /Legacy

After upgrading all web services, continue the upgrade process by upgrading the Reporting service and data warehouse. For more information, refer to the topic Upgrade the Reporting service and data warehouse.