This topic describes the upgrade process of web components from Services Manager 10 to Services Manager 11. For upgrades, the term web components refers to the control panel web site, the API service, and all supported web services.
In addition to this section, review the topic Upgrade deprecated services
, which contains information about services that are not supported in Services Manager 11. If your Services Manager 10 deployment includes any deprecated services, you must prepare your deployment accordingly prior to upgrading any web components.
Prepare for the upgrade
During the upgrade process, the Services Manager Setup Tool updates all sites to run from the backup and puts all associated sites and application pools in a stopped state. Therefore, if the names of any of the sites or application pools in your deployment have been changed from the default, you must specify those changes in an XML file before you initiate the upgrade. To create this file, use the following format:
<Configuration> <Property Name="<service-id>.ApplicationPool" Value="MyAppPool" /> <Property Name="<service-id>.Application" Value="MyAppName" /> <Property Name="<service-id>.Site" Value="MySite" /> </Configuration>
The service-id property is the web service's deployment identifier used in the Configuration Tool.
After creating the XML file, you can initiate the upgrade using the following command:
CortexSetup.exe /ConfigFile:path-to-XML-file /Upgrade
In the event a conflict arises during the upgrade, the sites remain in a stopped state and reference the backup created earlier in the process. Site files in the %ProgramFiles% directory are updated and site content in C:Inetpubcomponent-name are reverted to the previous version. You can then review the configuration update file located in %ProgramFiles% and make any necessary changes to the deployed web.config file.