CloudPortal Services Manager Version 11.0
CU1 Deployment Guide
Contents
Install ... 3
Recommended deploy process ... 3
Impacted Servers ... 3
Prerequisites ... 3
Upgrade the database ... 4
Upgrade the platform Components ... 5
Update the services ... 5
Import Service packages ... 6
Repair ... 7
Install
Recommended deploy process
To apply CloudPortal Services Manager 11.0 CU1 to version11.0.1, please 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
o Provisioning Engine Server o Web Server
o Database Server
o Hosted Exchange server
Prerequisites
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.
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. Launch a web browser and navigate to the CloudPortal Services Manager 11 CU1 download page on the Citrix web site
(http://support.citrix.com/article/CTX139461)
5. Click Download
6. Right-click on the zip file of CPSM 11.0 Cumulative 1 and select Properties to check whether or not the file is blocked. If so, click Unblock
7. Extract CPSM Cumulative Update 1.zip and copy the contents to C:\CPSMCU1. The folder layout will look like the picture below:
8. Copy the CPSMCU1 folder to the impacted servers
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
2. Use C:\CPSMCU1\Database\Upgrade-All.ps1 as a user with sysadmin permission on the database to run the SQL files.
Example:
.\Upgrade-Allps1 –server localhost –user sa –password citrix .\Upgrade-Allps1 –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 step below on both Provisioning Engine server and Web server: Double-click C:\CPSMCU1\MSIs\CortexConfig\CortexConfig.msi.
Note: The install may complete very quickly. To ensure the install was complete, go to Control Panel ->Programs and Features and check the version of Citrix CloudPortal Configuration
Tool is changed to 11.0.2.85.
Provisioning Engine
On the server hosting the Provisioning Engine, double-click C:\CPSMCU1\MSIs\CortexProvisioning\CortexProvisioning.msi .
Web
On the server hosting the Web server role, double-click C:\CPSMCU1\MSIs\CortexWeb\CortexWeb.msi.
Update the services
Hosted Exchange
On the server hosting the Hosted Exchange service, run the following steps:
Note: Steps1&2 are only applicable to an environment which was initially upgraded from
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:\CPSMCU1\MSIs\Hosted Exchange\CortexExchangeWS.msi.
Note: The install may complete very quickly. To ensure the install was complete, go to Control Panel ->Programs and Features and check the version of Citrix CloudPortal
Services Manager Web Service is changed to 11.0.2.40.
Import Service packages
1. Start the Citrix Queue Monitor Service on Provisioning Engine server and start the
Cortex Management Site in IIS.
2. Log into CloudPortal Services Manager as an administrator that has the Service Schema Administrator Role.
3. Go to Configuration > System Manager > Service Schema, click Import a service , and click Browse.
4. Select C:\CPSMCU1\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 to import C:\CPSMCU1\MSIs\SQL Hosting\SQL Hosting package.
Repair
The following procedure can be used to repair the installed MSI packages if
it is damaged. 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 Repair
4. Start Citrix Queue Monitor Service and start the Cortex Management Site in IIS.
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.
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
