CloudPortal Services Manager Version 11.0 CU1 Deployment Guide

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 Uninstall... 9

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. 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. 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 Process.

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 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:\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. 9. Restart the Citrix Queue Monitor Service.

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 enter the password for this account. (refer to Figure 2 below)

Figure 1

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 and start the Cortex Management Site in IIS.