Upgrade Procedures
For detailed procedures on how to upgrade your system, refer to the Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1) at the following URL:
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
For detailed procedures on how to upgrade your system, refer to the Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1) at the following URL:
Use the following tables to determine whether you can upgrade or migrate from your currently installed version, and which of the supported upgrade methods are available to you:
Direct upgrades using either the Cisco Unified CM OS Admin interface or the Cisco Prime Collaboration Deployment (PCD) Upgrade task
Migrations using the PCD Migration task
If an upgrade or migration from your current release is not supported, see the instructions in the "Upgrading from Legacy Releases" chapter of the Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service.
You cannot install or run Cisco Unified Communications Manager and the IM and Presence Service directly on server hardware; you must run these applications on virtual machines. The tables below list the supported migration paths for deployments that are currently running on Cisco 7800 Series Media Convergence Server (MCS 7800) hardware. All of the supported migration paths listed below are physical-to-virtual (P2V) migrations.
![]() Note |
The tables below list the upgrade paths supported for MCS 7800 Series servers, with the following exceptions:
PCD migrations are not supported for BE3000 and BE5000 deployments. We recommend a fresh installation for upgrades from these products. |
From |
To |
Supported Method |
---|---|---|
6.1(5) |
11.5(x) |
PCD Migration |
7.1(3) and 7.1(5) |
11.5(x) |
PCD Migration |
8.x |
11.5(x) |
PCD Migration |
9.x |
11.5(x) |
PCD Migration |
From |
To |
Supported Method |
---|---|---|
CUP 8.5(4) |
11.5(x) |
PCD Migration |
CUP 8.6(3), 8.6(4), and 8.6(5) |
11.5(x) |
PCD Migration |
IM and Presence 9.x |
11.5(x) |
PCD Migration |
The tables below list the supported upgrade and migration paths for Cisco Unified Communications Manager and IM and Presence Service deployments that are currently running on virtual machines. All of the supported upgrade and migration paths listed below are virtual-to-virtual (V2V). Service Updates (SU) within each path are supported, unless otherwise indicated.
From |
To |
Supported Method |
||
---|---|---|---|---|
8.6(x) |
11.5(x) |
Cisco Unified OS Admin (Direct Refresh) PCD Migration PCD Upgrade (Direct Refresh) |
||
9.0(x) |
11.5(x) |
PCD Migration PCD Upgrade (Direct Refresh) |
||
9.1(x) |
11.5(x) |
PCD Migration PCD Upgrade (Direct Refresh) Cisco Unified OS Admin (Direct Refresh) |
||
10.0(x) |
11.5(x) |
PCD Migration PCD Upgrade (Direct Standard) |
||
10.5(x)
|
11.5(x) |
PCD Migration PCD Upgrade (Direct Standard) Cisco Unified OS Admin (Direct Standard) |
||
11.0(1) |
11.5(x) |
Cisco Unified OS Admin (Direct Standard) PCD Migration PCD Upgrade (Direct Standard) |
||
11.5(x) |
11.5(y) |
Cisco Unified OS Admin (Direct Standard) PCD Migration PCD Upgrade (Direct Standard) |
From |
To |
Supported Method |
---|---|---|
CUP 8.5(4) |
11.5(x) |
PCD Migration |
CUP 8.6(3), 8.6(4), and 8.6(5) |
11.5(x) |
PCD Migration PCD Upgrade (Direct Refresh) |
CUP 8.6(x) |
11.5(x) |
Cisco Unified OS Admin (Direct Refresh) |
IM and Presence 9.0(x) |
11.5(x) |
PCD Migration PCD Upgrade (Direct Refresh) |
IM and Presence 9.1(x) |
11.5(x) |
PCD Migration PCD Upgrade (Direct Refresh) Cisco Unified OS Admin (Direct Refresh) |
IM and Presence 10.0(x) |
11.5(x) |
PCD Migration PCD Upgrade (Direct Standard) PCD Upgrade (Direct Standard) |
IM and Presence 10.5(x) |
11.5(x) |
PCD Migration PCD Upgrade (Direct Standard) Cisco Unified OS Admin (Direct Standard) |
IM and Presence 11.0(1) |
11.5(x) |
Cisco Unified OS Admin (Direct Standard) PCD Migration PCD Upgrade (Direct Standard) |
IM and Presence 11.5(x) |
11.5(y) |
Cisco Unified OS Admin (Direct Standard) PCD Migration PCD Upgrade (Direct Standard) |
Upgrade and migration paths generally support the Service Updates (SU) within each path; however, there are some exceptions for specific SU releases. The table below lists the exceptions for upgrades and migrations to Cisco Unified Communications Manager Release 11.5(x).
From |
To |
Description |
---|---|---|
10.5(2)SU5 |
11.5(1.10000-6) through 11.5(1.120xx) |
Path is unsupported. For these releases, upgrade to 11.5(1)SU2 instead. |
The tables below lists the upgrade paths that require COP files. You must install COP files on each node before you begin an upgrade using the Cisco Unified OS Admin interface, or before you begin an upgrade or migration using the Prime Collaboration Deployment (PCD) tool. If you are using PCD, you can perform a bulk installation of the COP files before you begin the upgrade.
From | To | Upgrade Type |
---|---|---|
8.6(x) |
11.5(x) |
Refresh upgrade. Required COP files:
Optional COP files:
|
9.1(x) |
11.5(x) |
Refresh upgrade. Required COP files:
Optional COP files:
|
10.5(x) |
11.5(x) |
Standard upgrade; no COP file required. |
11.0(x) |
11.5(x) |
Standard upgrade; no COP file required. |
11.5(x) |
11.5((y) |
Standard upgrade; no COP file required. |
From Cisco Unified Presence Release | To IM and Presence Release | Upgrade Type |
---|---|---|
8.5(4) through 8.6(1) |
11.5(x) |
Refresh upgrade. Requires the following COP files:
|
From IM and Presence Release |
To IM and Presence Release |
Upgrade Type |
---|---|---|
9.1(x) |
11.5(x) |
Refresh upgrade. Requires the following COP file:
|
10.5(x) |
11.5(x) |
Standard upgrade; no COP file required. |
11.0(x) |
11.5(x) |
Standard upgrade; no COP file required. |
11.5(x) |
11.5(y) |
Standard upgrade; no COP file required. |
This section contains requirements and limitations to consider when upgrading your system.
Cisco Unified Communications Manager Release 11.5(1)SU3, SU4, SU5, and SU6 are compatible with Cisco Prime License Manager Release 11.5(1)SU2 or higher. If you are deploying a standalone Cisco Prime License Manager, make sure that your Prime License Manager version is a minimum release of 11.5(1)SU2. Otherwise, Cisco Unified Communications Manager cannot synchronize its license usage with the standalone Prime License Manager.
If you are upgrading to one of these Cisco Unified Communications Manager releases and you are running a standalone version of Prime License Manager, upgrade your Prime License Manager instance to 11.5(1)SU2 or higher before you upgrade Cisco Unified Communications Manager.
![]() Note |
With co-resident Prime License Manager deployments, Cisco Unified Communications Manager and Cisco Prime License Manager are compatible automatically. |
It is not essential requirement that all users must log out from Cisco Jabber, when upgrading the IM and Presence Service. However, it is always a best practice that users are log out from Cisco Jabber during the upgrade.
If you are using any of these phones on an earlier release and you want to upgrade to this release, do the following:
Confirm whether the phones in your network will be supported in Release 11.5.
Identify any non-supported phones.
For any non-supported phones, power down the phone and disconnect the phone from the network.
Provision a supported phone for the phone user. You can use the Migration FX tool to migrate from older model to newer model phones. For details, go to: http://refreshcollab.cisco.com/webportal/46/CUCM%20Readiness%20Assessment#endpoint_refresh_tool.
Once all the phones in your network are supported by Release 11.5, upgrade your system.
![]() Note |
Deprecated phones can also be removed after the upgrade. When the administrator logs in to Cisco Unified Communications Manager after completing the upgrade, the system displays a warning message notifying the administrator of the deprecated phones. |
You do not need to purchase a new device license to replace a deprecated phone with a supported phone. The device license becomes available for a new phone when you either remove the deprecated phone from the system, or when you switch to the new Cisco Unified Communications Manager version, and the deprecated phone fails to register.
If you are using the utils system upgrade CLI command to upgrade IM and Presence Service nodes, you must use the default OS admin account, as opposed to a user with administrator privileges. Otherwise, the upgrade will not have the required privilege level to install essential services, thereby causing the upgrade to fail. You can confirm the account’s privilege level by running the show myself CLI command. The account must have privilege level 4.
Please note that this limitation exists for CLI-initiated upgrades of IM and Presence Service only and does not apply to Unified Communications Manager. Also note that this limitation may be fixed for newer ISO files. Refer to your ISO Readme file for details on your specific ISO file. For up to date information on this limitation, see CSCvb14399 at https://bst.cloudapps.cisco.com/bugsearch/bug/CSCvb14399.
With Standard Deployments of the IM and Presence Service, if you run into any upgrade issues and you need to roll back to a previous version, you must roll back both the Cisco Unified Communications Manager and the IM and Presence Service installations to the previous version or you will have a non-supported version mismatch.
It's not supported with Standard Deployments to roll back the Cisco Unified Communications Manager version and leave the IM and Presence Service version at 11.5(1)SU4. Similarly, it's not supported to roll back the IM and Presence Service version and leave the Cisco Unified Communications Manager version at 11.5(1)SU4.
The exception to this rule is with the IM and Presence Centralized Deployment because IM and Presence and telephony are hanlded by different clusters. Within the IM and Presence central cluster, the Cisco Unified Communications Manager database instance must be running the same version as the IM and Presence Service. However, the separate telephony cluster to which the IM and Presence Service connects can be running a different version.
For Release 11.5(x), Cisco Unified Communications Manager and IM and Presence Service do not support RSA certificates with key-sizes that are less than 2048 bits when FIPS mode is enabled. This affects server certificates and LSCs.
If you are upgrading to Release 11.5(x) with FIPS mode enabled and you are using RSA key-sizes that are less than 2048 bits on your current version, then you can carry out one of the following items to resolve the problem.
Regenerate the effected certificates before you upgrade if your current version supports key-sizes of 2048 bits, or
Regenerate the effected certificates after you upgrade to Release 11.5(x).
![]() Note |
If you choose this option, then secure connections are not allowed to use the effected certificates until they have an RSA key-size of 2048 bits or greater. |
This release requires that you have an encryption license installed in order to run Cisco Unified Communications Manager in mixed mode. If you are upgrading from an earlier release of Cisco Unified Communications Manager, and cluster security is set to mixed-mode, you must obtain an encryption license and install it in Cisco Prime License Manager.
If you upgrade from an earlier release with mixed-mode enabled, but you do not have an encryption license installed, a warning message on the encryption license requirement displays on the user interface immediately followng the upgrade. You will also receive the CiscoSystemEncryptionNotAllowed alert. Your system will continue to operate in mixed-mode, but you will be unable to update the CTL file and will continue to receive this alert until you either install an encryption license or move the cluster security setting back to non-secure mode. Cisco recommends that you install the encryption license at the earliest to ensure that you can continue to run mixed mode without any disruption.
If you were not running mixed-mode prior to the upgrade, you will be unable to move the cluster into mixed-mode unless you have an encryption license applied against Cisco Unified Communications Manager, and a sync has been completed.
The following table describes how to update your system with an encryption license.
Step |
Task |
Description |
||
---|---|---|---|---|
Step 1 |
Obtain an ENC PAK license file. |
Use the CUCM-PLM-ENC-K9= part number to order encryption licenses via the Product Upgrade Tool at https://tools.cisco.com/gct/Upgrade/jsp/index.jsp. For further information on ordering licenses, refer to the Cisco Unified Communications Solutions Ordering Guide for your release at http://www.cisco.com/c/en/us/partners/tools/collaboration-ordering-guides.html.
|
||
Step 2 |
Install the encryption license file in Cisco Prime License Manager. |
Follow the "Upgrade Existing Licenses" procedure in the Cisco Prime License Manager User Guide, Release 11.5(1)SU2 at http://www.cisco.com/c/en/us/support/cloud-systems-management/prime-license-manager/products-user-guide-list.html. |
||
Step 3 |
Synchronize licenses. |
In Cisco Prime License Manager, select the Product Instances tab and click Synchronize licenses. For additional detail, see the Cisco Prime License Manager User Guide, Release 11.5(1)SU2. |
If you have Microsoft SQL Server deployed as an external database with the IM and Presence Service and you are upgrading from 11.5(1), 11.5(1)SU1, or 11.5(1)SU2, you must create a new SQL Server database and migrate to the new database. This is required due to enhanced data type support in this release. If you don't migrate your database, schema verification failure will occur on the existing SQL Server database and services that rely on the external database, such as persistent chat, will not start.
After you upgrade your IM and Presence Service, use this procedure to create a new SQL Server database and migrate data to the new database.
![]() Note |
This migration is not required for Oracle or PostgreSQL external databases. |
The database migration is dependent on the MSSQL_migrate_script.sql script. Contact Cisco TAC to obtain a copy.
Step |
Task |
||
---|---|---|---|
Step 1 |
Create a snapshot of your external Microsoft SQL Server database. |
||
Step 2 |
Create a new (empty) SQL Server database. For details, see the following chapters in the Database Setup Guide for the IM and Presence Service:
|
||
Step 3 |
Run the System Troubleshooter to confirm that there are no errors with the new database.
|
||
Step 4 |
Restart the Cisco XCP Router on all IM and Presence Service cluster nodes:
|
||
Step 5 |
Turn off services that depend on the external database:
|
||
Step 6 |
Run the following script to migrate data from the old database to the new database MSSQL_migrate_script.sql.
|
||
Step 7 |
Run the System Troubleshooter to confirm that there are no errors with the new database.
|
||
Step 8 |
Start the services that you stopped previously.
|
||
Step 9 |
Confirm that the external database is running and that all chat rooms are visible from a Cisco Jabber client. Delete the old database only after you're confident that the new database is working. |
If you are upgrading from the 11.5(1)SU2 release and you had Push Notifications enabled in the old release, you must disable Push Notifications in the current release and then follow the onboarding process to enable Push Notifications once again. This is required due to API changes in this release that were not a part of the 11.5(1)SU2 release. Your upgraded system will not be able to send troubleshooting logs to the Cisco Cloud unless you disable Push Notifications and then follow the onboarding process for this release.
After you upgrade your system, do the following:
Step 1 |
Disable Push Notifications Follow these steps:
|
Step 2 |
Enable Push Notifications for this release. For the full onboarding process, see the "Push Notifications Configuration Task Flow" in the Deploying Push Notifications for Cisco Jabber on iPhone and iPad document at http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cucm/im_presence/pushNotifications/11_5_1_su2/cucm_b_push-notification-deployment-iPhone-iPad.html. |