CloudPortal Services Manager Version 11.0 CU2 Deployment Guide

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 Uninstall... 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 Sharepoint2013 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: 8. Copy the CPSMCU2 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:\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. 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. CloudPortal Directory Web Service has changed to 11.0.3.x. Provisioning Engine On the server hosting the Provisioning Engine, double-click C:\CPSMCU2\MSIs\CortexProvisioning\CortexProvisioning.msi and follow the wizard. CloudPortal Provisioning Engine has changed to 11.0.3.x.

Web On the server hosting the Web server role, double-click C:\CPSMCU2\MSIs\CortexWeb\CortexWeb.msi and follow the wizard. 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. 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. 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. 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:\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 C:\CPSMCU2\MSIs\ Windows Web Hosting\Windows Web Hosting.package 9. Restart the Citrix Queue Monitor Service.

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 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 on Provisioning Engine server and start the Cortex Management Site in IIS on Web server.