CloudPortal Services Manager Version 11.0
CU2 Deployment Guide
Contents
Install ... 3
Requirements ... 3
Recommended deployment procedure ... 3
Impacted Servers ... 3
Prerequisites ... 4
Upgrade the database ... 5
Upgrade the platform Components ... 5
Update the services ... 6
Import Service packages ... 6
Repair ... 8
Figure 2 ... 10
Install
Requirements
The CloudPortal Services Manager version currently installed on the environment must be 11.0.1 or higher.
Recommended deployment procedure
To apply CloudPortal Services Manager 11.0 CU2 perform the following tasks: 1. Complete the prerequisites
2. Upgrade the database
3. Upgrade the platform components 4. Upgrade web services
5. Import service packages
Impacted Servers
Provisioning Engine Server
Web Server
Database Server
Hosted Exchange server
Prerequisites
1. On the server hosting the Cloud Portal Services Manager Web site, shut down the Services Manager web service. To do this, open IIS Manager and stop the Cortex
Management site.
2. On the server hosting the Provisioning server role, perform the following actions: a. Stop the Cortex Queue Monitor service.
b. Close any opened instance of the Provisioning Manager.
3. Log into SQL server and make a full backup of the OLM and OLMReports databases. 4. From any of the component servers, launch a web browser and navigate to the
CloudPortal Services Manager 11 CU2 download page on the Citrix web site
(http://support.citrix.com/article/CTX140650)
5. Click Download
6. Right-click on the CloudPortal Services Manager CU2 for 11.0.1. zip file and select Properties to check whether or not the file is blocked. If so, click Unblock
7. Extract CPSM Cumulative Update 2.zip and copy the contents to C:\CPSMCU2. The folder layout will look like the picture below:
Upgrade the database
Important: Before upgrading the database, back up the OLM and
OLMReports databases. The upgrade process makes irreversible
changes to these databases.
1. Open Powershell and execute the command: Set-ExecutionPolicy RemoteSigned
Process.
2. Use C:\CPSMCU2\Database\Upgrade-All.ps1 as a user with sysadmin permission on the database to run the SQL files.
Example:
.\Upgrade-All.ps1 –server localhost –user sa –password citrix .\Upgrade-All.ps1 –server localhost –TrustedConnection
Note: From a PowerShell command prompt, run “help .\Update-all.ps1 –Full” to view
additional information on the script.
Upgrade the platform Components
Configuration Tool
Complete the steps below on both Provisioning Engine server and Web server:
Double-click C:\CPSMCU2\MSIs\CortexConfig\CortexConfig.msi and follow the wizard. Go to Control Panel ->Programs and Features and check that the version of Citrix CloudPortal Configuration Tool has changed to 11.0.3.x.
Directory Web Service
On the server hosting the Provisioning Engine, double-click
C:\CPSMCU2\MSIs\CortexDirectoryWS\CortexDirectoryWS.msi and follow the wizard. Go to Control Panel ->Programs and Features and check that the version of Citrix CloudPortal Directory Web Service has changed to 11.0.3.x.
Provisioning Engine
On the server hosting the Provisioning Engine, double-click
Web
On the server hosting the Web server role, double-click
C:\CPSMCU2\MSIs\CortexWeb\CortexWeb.msi and follow the wizard.
Go to Control Panel ->Programs and Features and check that the version of Citrix CloudPortal Web has changed to 11.0.3.x.
Update the services
Hosted Exchange
On the server hosting the Hosted Exchange web service, run the following steps:
Note: Steps1&2 are only applicable to the environment which was initially upgraded from
CPSM 11.0.0 manually.
1. Backup the folder C:\inetpub\CortexServices\ExchangeWS\Scripts and C:\Program Files (x86)\Citrix\Cortex\Services\ExchangeWS\Scripts
2. Remove the folder C:\inetpub\CortexServices\ExchangeWS\Scripts and C:\Program Files (x86)\Citrix\Cortex\Services\ExchangeWS\Scripts.
3. Double-click C:\CPSMCU2\MSIs\Hosted Exchange\CortexExchangeWS.msi and follow the wizard.
Go to Control Panel ->Programs and Features and check that the version of Citrix CloudPortal Exchange Web Service has changed to 11.0.3.x.
Sharepoint2013
On the server hosting the Sharepoint2013 web service, double-click
C:\CPSMCU2\MSIs\SharePoint 2013\SharePoint2013.msi and follow the wizard. Go to Control Panel ->Programs and Features and check that the version of Citrix CloudPortal Sharepoint2013 Web Service has changed to 11.1.3.x.
Import Service packages
1. Start the Citrix Queue Monitor Service on Provisioning Engine server and start the
Cortex Management Site in IIS on Web server.
and click Browse.
4. Select C:\CPSMCU2\MSIs\Hosted Exchange\Hosted Exchange.package. 5. Click Preview.
6. Select only the following folders, including all items within each folder:
Provisioning Engine
Xml Api
Web Server 7. Click Import.
8. Log in again and follow step 3-7 to import other package files. Only need to import the packages for configured services in current system:.
C:\CPSMCU2\MSIs\SQL Hosting\SQL Hosting.package.
C:\CPSMCU2\MSIs\Citrix\Citrix.package
C:\CPSMCU2\MSIs\ Lync Enterprise\Lync Enterprise.package
C:\CPSMCU2\MSIs\ SharePoint 2010\SharePoint 2010.package
C:\CPSMCU2\MSIs\ SharePoint 2013 \SharePoint 2013.package
Repair
The following procedure can be used to repair the installed MSI packages.
Take the Hosted Exchange service for example
:1. On the server hosting the Services Manager Web server role, shut down the Services Manager web console. To do this, open IIS Manager and stop the Cortex Management site.
2. On the server hosting the Provisioning server role, perform the following actions: a. Stop the Cortex Queue Monitor service.
b. Close any opened instance of the Provisioning Manager.
3. Log into the server which hosts the Hosted Exchange web service and go to Control
Panel > Programs and Features > right-click the Citrix CloudPortal Services Manager Exchange Web Service and select Repair
4. Start Citrix Queue Monitor Service on Provisioning Engine server and start the
Cortex Management Site in IIS on Web server.
Note: During the repair of the Provisioning Engine the Citrix Queue Monitor Service may have
been changed to disabled. To correct this issue please follow these steps: 1. Open Services.msc
2. Right-click the Citrix Queue Monitor Service and select Properties
3. Change the Startup type to Automatic on General Tab(refer to Figure 1 below) 4. Click Log On tab and change the account to [domain]\cortex_qmon_svc and
Figure 2
Uninstall
The following procedure can be used to uninstall the installed MSI
packages. Take the Hosted Exchange service for example
:1. On the server hosting the Services Manager Web server role, shut down the Services Manager web console. To do this, open IIS Manager and stop the Cortex Management site.
2. On the server hosting the Provisioning server role, perform the following actions: a. Stop the Cortex Queue Monitor service.
b. Close any opened instance of the Provisioning Manager.
3. Log into the server which hosts the Hosted Exchange service and go to Control Panel
> Programs and Features > right-click the Citrix CloudPortal Services Manager Exchange Web Service and select Uninstall
4. Start Citrix Queue Monitor Service on Provisioning Engine server and start the