Upgrade and Migration Guide for Cisco Unified Communications

Manager and IM and Presence Service, Release 11.5(1)

First Published: 2017-03-17
Last Modified: 2021-09-07

Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS,
INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH
THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY,
CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version of
the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS.
CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT
LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS
HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network
topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional
and coincidental.

All printed copies and duplicate soft copies of this document are considered uncontrolled. See the current online version for the latest version.

Cisco has more than 200 offices worldwide. Addresses and phone numbers are listed on the Cisco website at www.cisco.com/go/offices.

The documentation set for this product strives to use bias-free language. For 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 standards documentation, or language that is used by a referenced third-party product.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL:
https://www.cisco.com/c/en/us/about/legal/trademarks.html. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a
partnership relationship between Cisco and any other company. (1721R)
© 2020 Cisco Systems, Inc. All rights reserved.
 CONTENTS

PREFACE Preface xi
Preface xi
Audience xi
Related Documentation xi
Conventions xii
Cisco Product Security Overview xiii

CHAPTER 1 How to Use this Guide 1

How to Use this Guide 1

PART I Understanding Upgrades and Migrations 5

CHAPTER 2 Understanding Upgrades and Migrations 7

Revision History 7
Upgrade and Migration Overview 7
Upgrade Methods 7
Direct Upgrades 8
Standard upgrades 8
Refresh upgrades 8
Migrations 9
Upgrade and Migration Tools 9
Export Restricted and Export Unrestricted Software 10

PART II Plan the Upgrade or Migration 13

CHAPTER 3 Determine the Scope of Work 15

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
iii
 Contents

Determine the Scope of the Upgrade or Migration 15

CHAPTER 4 Requirements and Limitations 17

Requirements and Limitations 17
Hardware Requirements 17
Network Requirements 18
IP Address Requirements 18
DNS requirements 18
SFTP Server Support 19
Virtual Machine Configuration 19
Browser Requirements 20
Licensing Requirements 21
Unified Communications Manager License Requirements 21
IM and Presence Service License Requirements 21
Limitations 22
Subnet Limitations 22
Cluster Size 22
IP Subnet Mask 22
Support for Intercluster Peers 23
Device Name for Cisco Unified Mobile Communicator 23
Daylight Saving Time Settings Update 23
Spectre and Meltdown Vulnerabilities During Upgrade 23
OS Admin Account Required for CLI-Initiated IM and Presence Upgrades 23
Upgrade Requirements with Standalone Prime License Manager 24
Upgrades from 11.5(1)SU2 with Push Notifications Enabled 24
Duplicate ENUMS Break Upgrades and Migrations from 9.1(2) 25
Blue Screen Appears for Unified CM Refresh Upgrades 25

CHAPTER 5 Supported Upgrade and Migration Paths 27

Version Requirements 27
Supported Upgrade and Migration Paths 30
Pre-upgrade Deployment is Running on Cisco Media Convergence Server Hardware 30
Pre-upgrade Deployment is Running on a Virtual Machine 31
Upgrade Path Restrictions for Release 11.5(x) 32

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
iv
 Contents

Upgrade Restriction for 11.5(1)SU9 32

CHAPTER 6 Deployment Types and Recommendations 33

Type of Deployment 33
Business Edition 6000 and Business Edition 7000 Deployments 33
Virtualized Deployments of Cisco Unified Communications Manager and IM and Presence
Service 33

CHAPTER 7 Sequencing Rules and Time Requirements 35

Upgrade Sequence and Time Requirements 35

Recommended Sequence for the Least Time 35

Recommended Sequence for the Least Impact 37

Sequence Rules 40
Upgrade time requirements 41
Factors that Affect Upgrade Time Requirements 41
Factors that Affect Upgrade Time Requirements 43
Estimating the Minimum Time Requirements 44
Examples 46

CHAPTER 8 Find all Required Upgrade Documentation 47

Additional Upgrade Documentation 47

PART III Change the Virtualization Software 51

CHAPTER 9 Change the Virtualization Software 53

Virtual Machine Configuration Tasks 53

Install and Configure VMware vCenter 54
Upgrade vSphere ESXi 55
Download and Install OVA Templates 55
Change Virtual Machine Configuration Specifications 56
Migrate From Single to Multi-vDisk Virtual Machine 57

PART IV Upgrade the Applications 59

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
v
 Contents

CHAPTER 10 Pre-upgrade Tasks 61

Pre-Upgrade Task Flow 61

Generate a Database Status Report 67
Check Database Replication 67
Check Performance Reports 68
Run CLI Diagnostics 68
Delete a Trust Certificate 69
Regenerate a Certificate 69
Certificate Names and Descriptions 70
Take a Fresh Backup 71
Back Up Custom Ringtones and Background Images 72
Check Network Connectivity 72
Verify IPv6 Networking 73
Check Connectivity between IM and Presence and Cisco Unified Communications Manager 73
Collect Configuration and Login Information 74
Record the Registered Device Count 74
Record the Number of Assigned Users 75
Record TFTP Parameters 75
Record Enterprise Parameters 76
Export User Records 76
Upgrade IP Phone Firmware 77
Verify Critical Services 77
Deactivate Cisco Extension Mobility 78
Stop the IM and Presence Sync Agent 78
Check the Available Common Partition Space 79
Adjust High and Low Watermarks 79
Maximize Usable Disk Space 79
Obtain Upgrade Files 81
COP Files Required for Upgrades to Release 11.5 81

Increase the Database Replication Timeout 83

Disable High Availability on Presence Redundancy Groups 83
Add a Serial Port to the Virtual Machine 84
Database Migration Required for Upgrades with Microsoft SQL Server 84

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
vi
 Contents

CHAPTER 11 Upgrade Procedures 87

Upgrade Overview 87
Publisher Nodes and Subscriber Nodes 87
Understanding Version Switching 88
Before You Begin 89
Upgrade Task Flow 90
Upgrade the Applications 90
Upgrade from a Local Source 90
Upgrade from a Remote Source 92
Version Switching 93
Switch the Software Version 95
Switch to Previous Version 96
Switch Cluster to Previous Version 96
Switch Node to Previous Version 96
Reset Database Replication 97
Switch version back to Cisco Unified Presence 8.6(3) or earlier 97
Verify that Database Replication is Functioning 98
Verify that Database Replication is Complete 99

CHAPTER 12 Post-upgrade Tasks 101

Post-upgrade Task Flow 101

Switch the Software Version 103
Update CTL file 104
Remove the Serial Port 104
Restart Extension Mobility 105
Reset TFTP Parameters 105
Restore Enterprise Parameters 106
Reset High and Low Watermarks 106
Update VMWare Tools 107
Install Locales 107
Restore the Database Replication Timeout 108
Verify the Registered Device Count 109
Verify Assigned Users 109

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
vii
 Contents

Test Functionality 109

Upgrade RTMT 110
Manage TFTP Server Files 111
Set Up a Custom Log-On Message 112
Configure IPSec Policies 113
Assign New Manager Assistant Roles 113
Verify IM and Presence Service Data Migration 114
Enable High Availability on Presence Redundancy Groups 114
Restart the IM and Presence Sync Agent 115

PART V Troubleshooting 117

CHAPTER 13 Troubleshooting 119

Dump a Log File After an Upgrade Failure 119

Troubleshooting Unified Communications Manager Upgrades 120
Upgrade Failure 120
Reboot include on upgrade Success/Failed/Cancel case 120
Upgrade Fails with Insufficient Disk Space 121
Download Failure in Cluster-Wide Upgrade 121
Reduced Permissions for Access Control Groups 122

Loss of Phone Settings 122

Post-Upgrade Failure of Unified Communications Manager Publisher Node 122
Post-Upgrade Failure of Unified Communications Manager Subscriber Nodes 123
Troubleshooting IM and Presence Upgrades 123
Upgrade Failure of IM and Presence Database Publisher Node 123
Upgrade Failure of IM and Presence Subscriber Node 123
Upgrade From Pre Release 8.6(4) Fails 124
IM and Presence user phone presence problems 124
Presence User Experiences Issues Obtaining Availability 125
Real-Time Monitoring Tool alert for Cisco SIP proxy service 125
Cannot find upgrade file on remote server 125
Upgrade file checksum values do not match 125
Database replication did not complete 125
Cisco UP Presence Engine database does not restart 125

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
viii
 Contents

Version Errors 126

Failed refresh upgrade 127
Cancelled or failed upgrade 127
Directory Was Located and Searched but No Valid Options or Upgrades Were Available 127
Common Partition Full Upgrade Failure 127

PART VI Appendix 129

CHAPTER 14 Frequently Asked Questions 131

Frequently Asked Questions 131

CHAPTER 15 Upgrading from Legacy Releases 135

Upgrading and Migrating from Legacy Releases 135

CHAPTER 16 Additional Upgrade Resources 137

Additional Upgrade Resources 137

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
ix
Contents

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
x
 Preface
• Preface, on page xi
• Audience, on page xi
• Related Documentation, on page xi
• Conventions, on page xii
• Cisco Product Security Overview, on page xiii

Preface
This document provides information about upgrading software for the 10.x set of releases, including 10.0(1),
10.5(1), and 10.5(2).

Audience
This Upgrade Guide is intended for administrators who are responsible for upgrading the following software:
• Cisco Unified Communications Manager
• IM and Presence Service on Unified Communications Manager

Related Documentation
For additional installation and upgrade information, refer to the following documents:
• Cisco Prime Collaboration Deployment Administration Guide
This document describes how to use the Cisco Prime Collaboration Deployment application, which is
designed to assist in the management of Unified Communication applications. You can use this application
to perform tasks such as migrate existing clusters to new virtual machines, fresh installs, and upgrades
on existing clusters.
• Administration Guide for Cisco Unified Communications Manager
https://www.cisco.com/c/en/us/support/unified-communications/
unified-communications-manager-callmanager/products-maintenance-guides-list.html

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
xi
 Preface
Conventions

This document provides information about upgrading the Unified Communications Manager to a later
appliance-based release.
• Replacing a Single Server or Cluster for Unified Communications Manager
http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_installation_guides_list.html
This document describes how to replace a Unified Communications Manager server or a cluster of servers.
• Command Line Interface Reference Guide for Cisco Unified Communications Solutions
https://www.cisco.com/c/en/us/support/unified-communications/
unified-communications-manager-callmanager/products-maintenance-guides-list.html
This document describes the Command Line Interface for Unified Communications Manager. Some of
these commands perform upgrade and installation-related tasks.

For further information about related Cisco IP telephony applications and products, refer to the Unified
Communications Manager Documentation Guide for your release at
https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cucm/docguide/11_5_1/cucm_b_
documentation-guide-cucm-imp-1151.html

Conventions
This document uses the following conventions:

Convention Description

boldface font Commands and keywords are in boldface.

italic font Arguments for which you supply values are in italics.

[] Elements in square brackets are optional.

{x|y|z} Alternative keywords are grouped in braces and

separated by vertical bars.

[x | y | z] Optional alternative keywords are grouped in brackets

and separated by vertical bars.

string A nonquoted set of characters. Do not use quotation

marks around the string or the string will include the
quotation marks.

screen font Terminal sessions and information the system displays

are in screen font.

boldface screen font Information you must enter is in boldface screen

font.

italic screen font Arguments for which you supply values are in italic
screen font.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
xii
 Preface
Cisco Product Security Overview

Convention Description

^ The symbol ^ represents the key labeled Control—for

example, the key combination ^D in a screen display
means hold down the Control key while you press the
Dkey.

<> Nonprinting characters, such as passwords, are in

angle brackets.

Notes use the following conventions:

Note Means reader take note. Notes contain helpful suggestions or references to material not covered in the
publication.

Timesavers use the following conventions:

Timesaver Means the described action saves time. You can save time by performing the action described in the paragraph.

Tips use the following conventions:

Tip Means the information contains useful tips.

Cautions use the following conventions:

Caution Means reader be careful. In this situation, you might do something that could result in equipment damage or
loss of data.

Warnings use the following conventions:

Warning This warning symbol means danger. You are in a situation that could cause bodily injury. Before you work
on any equipment, you must be aware of the hazards involved with electrical circuitry and familiar with
standard practices for preventing accidents.

Cisco Product Security Overview

This product contains cryptographic features and is subject to United States and local country laws governing
import, export, transfer, and use. Delivery of Cisco cryptographic products does not imply third-party authority
to import, export, distribute, or use encryption. Importers, exporters, distributors, and users are responsible
for compliance with U.S. and local country laws. By using this product, you agree to comply with applicable
laws and regulations. If you are unable to comply with U.S. and local laws, return this product immediately.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
xiii
 Preface
Preface

Further information regarding U.S. export regulations may be found at

http://www.access.gpo.gov/bis/ear/ear_data.html

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
xiv
 CHAPTER 1
How to Use this Guide
• How to Use this Guide, on page 1

How to Use this Guide

This guide is the starting point for all upgrades and migrations to a new release of Unified Communications
Manager or IM and Presence Service. The table below outlines how to use this guide to plan and then perform
an upgrade or migration.

Procedure

Command or Action Purpose

Step 1 Understanding Upgrades and Migrations, on Use the information in this section to
page 5 understand:
• the differences between an upgrade and a
migration
• the upgrade methods that are available to
you
• the differences between export restricted
and unrestricted software

Step 2 Plan the Upgrade or Migration, on page 13 Use the information in this section to plan your
upgrade or migration:
• determine the scope of the upgrade; for
example, determine whether you need to
upgrade your hardware or your virtual
environment to meet the requirements of
the new release.
• understand the system requirements and
limitations.
• verify that your upgrade path is supported.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
1
 How to Use this Guide
How to Use this Guide

Command or Action Purpose

• review the deployment types and
recommendations to see which upgrade or
migration method we recommend for you.
• if we recommend that you perform a direct
upgrade, determine the sequence in which
you should perform upgrade procedures
in order to balance the time required for
the upgrade and the impact on your
network.
• gather the documentation that you need to
complete the upgrade or migration.

Step 3 Change the Virtualization Software, on page Use the information in this section to download
51 and install OVA templates and to upgrade your
virtual environment, if needed.

Step 4 Upgrade the Applications, on page 59 Use the information in this section when you
are ready to begin to upgrade or migrate the
Unified Communications Manager and the IM
and Presence Service applications.
• Complete the pre-upgrade tasks in this
section that are identified for the type or
upgrade or migration that you are doing.
• After you complete the pre-upgrade tasks,
perform the upgrade or migration using
the method and the documentation that you
identified during the planning stage. For
example, if you are performing a direct
upgrade using the Cisco Unified CM OS
Admin interface, follow the procedures in
this guide. If you are performing a direct
upgrade or a migration using Cisco Prime
Collaboration Deployment (PCD), follow
the procedures in the PCD documentation.
• Complete the post-upgrade tasks in this
section for all upgrade and migration
methods.

Step 5 Troubleshooting, on page 117 Use the information in this section to

troubleshoot problems that occur during the
upgrade process.

Step 6 Appendix, on page 129 Use the information in this section to:
• review frequently asked questions.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
2
How to Use this Guide
How to Use this Guide

Command or Action Purpose

• find out how to upgrade or migrate from
a legacy release.
• find additional resources to help with the
upgrade or migration process.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
3
 How to Use this Guide
How to Use this Guide

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
4
PA R T I
Understanding Upgrades and Migrations
• Understanding Upgrades and Migrations, on page 7
 CHAPTER 2
Understanding Upgrades and Migrations
• Revision History, on page 7
• Upgrade and Migration Overview, on page 7
• Upgrade Methods, on page 7
• Upgrade and Migration Tools, on page 9
• Export Restricted and Export Unrestricted Software, on page 10

Revision History
Table 1:

Date Revision

September 7, 2021 Removed the followings sections from respective

chapters as we need not perform them for upgrade
scenarios:
• Pre-upgrade Tasks—Deactivate TFTP services
• Post-upgrade Tasks—Restart TFTP Services

Upgrade and Migration Overview

Use this section as a starting-point for planning your Unified Communications Manager or IM and Presence
Service upgrade.
This document will guide you through the process of determining what you need to upgrade and where to
find the information that you need to complete the upgrade process.

Upgrade Methods
There are two main methods of upgrading Unified Communications Manager and IM and Presence Service:
• Direct Upgrades, on page 8

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
7
 Understanding Upgrades and Migrations
Direct Upgrades

• Migrations, on page 9

Direct Upgrades
A direct upgrade is when the new software will be installed on the same physical server and the same virtual
server where the currently installed version is running. Direct upgrades allow you to upgrade from your current
release to the latest release without the need to upgrade to an intermediate software version. It is a single
upgrade rather than a multi-hop upgrade.
There are two types of direct upgrade:
• standard upgrades
• refresh upgrades

Standard upgrades are upgrades that do not require upgrades to the embedded operating system. You can
install upgrade software on your server while the system continues to operate.
Refresh upgrades are required in situations where incompatibilities exist between the old and new software
releases. For example, a refresh upgrade is required when the major version of the embedded operating system
changes between the version you are upgrading from and the version that you are upgrading to.
The application automatically determines whether you need to perform a standard upgrade or a refresh upgrade.

Standard upgrades
Standard upgrades are upgrades that do not require upgrades to the operating system. You can install upgrade
software on your server while the system continues to operate.
For standard upgrades, you install the upgrade software as an inactive version. The system continues to function
normally while you are installing the software. When the upgrade is complete, you can choose to automatically
reboot the system to the upgraded software or you can manually switch to the new software at a later time.
When you reboot to the new software, the old software version remains on the system. This allows you to
revert to the old version in the unlikely event of issues with the new software. During an upgrade your
configuration information migrates automatically to the upgraded version.

Note You can only make any provisioning changes to the database on the active software. The database for the
inactive software is not updated. If you make changes to the database after an upgrade, you must repeat those
changes after switching to the new software.

Note See Resuming a Failed Upgrade section of the Troubleshooting chapter for more details.

Refresh upgrades
Refresh upgrades are required in situations where incompatibilities exist between the old and new software
releases. For example, a refresh upgrade is required when the major version of the embedded operating system
changes between the version you are upgrading from and the version that you are upgrading to. Refresh
upgrades require multiple reboots during installation to upgrade the underlying operating system, causing a

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
8
 Understanding Upgrades and Migrations
Migrations

temporary server outage while the software is installed. The duration of this outage will depend on your
configuration and the size of the database.

Note You must perform all refresh upgrades during a maintenance window because the system will not be available
during the upgrade.

For refresh upgrades, the upgrade wizard allows you to choose whether or not to automatically run the new
upgraded software when the upgrade completes. If you select not to run the new software, the system will
reboot to the old software version when the upgrade is complete and you can manually switch to the new
software at a later time.
If for any reason you decide to revert to the prior software version, you can switch versions to the older version
of the software. This switch version requires a reboot. Be aware that any configuration changes that you made
after upgrading the software will be lost.

Migrations
A migration is an upgrade where the new software will be installed on a different hardware system or virtual
machine than the currently installed version. For example, you need to use the migration method in the
following situations:
• your currently installed version is running on Cisco 7800 Series Media Convergence Server (MCS 7800)
hardware and you are upgrading to release that will run on a virtual machine.
• your currently installed version is running on a virtual machine and you need to move to a new virtual
machine.
• you are upgrading to Unified Communications Manager from another application, such as Unified
Communications 300 (UC300) Series, Unified Communications (UC500) Series, or certain Cisco Business
Edition products.

Note If you are planning network migration of Unified Communications Manager from Release 12.0(1) to any
higher release, perform any one of the following:
1. Task 1—Deregister the system from Cisco Smart Software Manager before network migration to higher
versions.
2. Task 2—After successful migration of the cluster, re-register the Unified Communications Manager to
Cisco Smart Software Manager smart account.

For detailed information on these procedures, see the System Configuration Guide for Cisco Unified
Communications Manager, Release 12.5(1).

Upgrade and Migration Tools

Following are tools available for upgrading or migrating Unified Communications Manager and IM and
Presence Service:

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
9
 Understanding Upgrades and Migrations
Export Restricted and Export Unrestricted Software

• Unified CM OS Administration: This interface is part of Unified Communications Manager and you
can use it to perform direct upgrades.
• Prime Collaboration Deployment (PCD): This is a management tool for Unified Communications
(UC) applications, which supports a range of tasks. You can perform direct upgrades using the PCD
Upgrade task, and you can perform migrations using the PCD Migration task.

Export Restricted and Export Unrestricted Software

This release of Unified Communications Manager and IM and Presence Service supports an export unrestricted
(XU) version, in addition to the export restricted (K9) version.

Note Unrestricted versions of software are intended only for a specific set of customers who do not want various
security capabilities; unrestricted versions are not intended for general deployments.

Export unrestricted versions differs from restricted versions as follows:

• Encryption of user payload (information exchange) is not supported.
• External SIP interdomain federation with Microsoft OCS/Lync or AOL is not supported.
• After you install an unrestricted release, you can never upgrade to a restricted version. A fresh install of
a restricted version on a system that contains an unrestricted version is also not supported.
• All nodes within a single cluster must be in the same mode. For example, Unified Communications
Manager and IM and Presence Service in the same cluster must either all be in unrestricted mode or all
be in restricted mode.
• IP Phone security configurations are modified to disable signaling and media encryption (including
encryption provided by the VPN phone feature).

Note Be aware that after you install an unrestricted release, you can never upgrade to a restricted version. You are
not allowed to perform a fresh installation of a restricted version on a system that contains an unrestricted
version.

For all Graphical User Interfaces (GUIs) and Command Line Interfaces (CLIs), the Administrator can view
the product version (restricted or export unrestricted).
The following table describes the GUI items that are not available for the export unrestricted version ofUnified
Communications Manager and IM and Presence Service.

GUI Item Location Description

Cisco Unified CM Administration

VPN Configuration Advanced Features > VPN This menu and its options are not
available.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
10
Understanding Upgrades and Migrations
Export Restricted and Export Unrestricted Software

GUI Item Location Description

Phone Security Profile System > Security > Phone The Device Security Mode is set
Configuration Security Profile to Non Secure and is not
configurable.

Cisco Unified CM IM and Presence Administration

Security Settings System > Security > Settings • You cannot check the Enable
XMPP Client to IM/P
Service Secure Mode setting.
• You cannot check the Enable
XMPP Router-to-Router
Secure Mode setting.
• You cannot check the Enable
Web Client to IM/P Service
Secure Mode setting.
• The option to set SIP
intra-cluster Proxy-to-Proxy
Transport Protocol to TLS
have been removed.

Service Parameter Configuration System > Service Parameters and • All TLS options have been
for Cisco SIP Proxy service choose Cisco SIP Proxy as the removed for the Transport
Service Preferred Order parameter.
• The TLS option have been
removed from the SIP Route
Header Transport Type
parameter.

SIP Federated Domains Presence > Inter-domain When you configure interdomain
Federation > SIP Federation federation to OCS/Lync, you will
receive warning popup to indicate
that it is only possible to directly
federate with another OCS/Lync
within the enterprise. Interdomain
federation to OCS/Lync outside the
enterprise is not supported in
unrestricted mode.

XMPP Federation Settings Presence > Inter-domain You cannot configure the security
Federation > XMPP Federation > mode. It is set to NO TLS.
Settings

Proxy Configuration Settings Presence > Routing > Settings You cannot set any TLS or HTTPS
listeners as the preferred proxy
listener.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
11
 Understanding Upgrades and Migrations
Export Restricted and Export Unrestricted Software

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
12
PA R T II
Plan the Upgrade or Migration
• Determine the Scope of Work, on page 15
• Requirements and Limitations, on page 17
• Supported Upgrade and Migration Paths, on page 27
• Deployment Types and Recommendations, on page 33
• Sequencing Rules and Time Requirements, on page 35
• Find all Required Upgrade Documentation, on page 47
 CHAPTER 3
Determine the Scope of Work
• Determine the Scope of the Upgrade or Migration, on page 15

Determine the Scope of the Upgrade or Migration

This section will help you determine:
• the scope of your upgrade or migration
• the best upgrade or migration method to use for your deployment
• where to find the information that you need to complete the upgrade or migration process

Procedure

Command or Action Purpose

Step 1 Determine whether you need to update the Ensure that your system meets the requirements
following components: of the new release.
• Hardware Requirements, on page 17
• Virtual Machine Configuration, on page
19

Step 2 Verify the Supported Upgrade and Migration Use the information in this chapter to determine
Paths, on page 27. whether you can upgrade or migrate directly
from your currently installed version, or
whether you need to upgrade or migrate to an
intermediate version before proceeding.

Step 3 Identify the Type of Deployment, on page 33 Identify the type of deployment you have and
use this information to find the upgrade or
migration method that Cisco recommends.

Step 4 Determine the Sequencing Rules and Time Direct upgrades only. The sequence in which
Requirements, on page 35 you perform upgrade procedures depends on
your deployment, and on how you want to
balance the level of user impact with the amount
of time required to complete the upgrade. You

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
15
 Plan the Upgrade or Migration
Determine the Scope of the Upgrade or Migration

Command or Action Purpose

must identify the sequence that you will follow
before you are ready to perform the upgrade
process.
The information in this section applies only if
you are performing a direct upgrade using either
the Unified CM OS Administration interface or
the PCD Upgrade task. PCD Migrations do not
require this step. If you are performing a PCD
migration, proceed to the next task in this list.

Step 5 Find Additional Upgrade Documentation, on Find the correct upgrade documentation to use
page 47. based on the needs of your deployment and the
recommended upgrade or migration method.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
16
 CHAPTER 4
Requirements and Limitations
• Requirements and Limitations, on page 17
• Hardware Requirements, on page 17
• Network Requirements, on page 18
• Virtual Machine Configuration, on page 19
• Browser Requirements, on page 20
• Licensing Requirements, on page 21
• Limitations, on page 22
• Daylight Saving Time Settings Update, on page 23
• Spectre and Meltdown Vulnerabilities During Upgrade, on page 23
• OS Admin Account Required for CLI-Initiated IM and Presence Upgrades, on page 23
• Upgrade Requirements with Standalone Prime License Manager, on page 24
• Upgrades from 11.5(1)SU2 with Push Notifications Enabled, on page 24
• Duplicate ENUMS Break Upgrades and Migrations from 9.1(2), on page 25
• Blue Screen Appears for Unified CM Refresh Upgrades, on page 25

Requirements and Limitations

The following sections provide information about the requirements that your system must meet, and limitations
that apply when you install or upgrade Unified Communications Manager or IM and Presence Service.

Note • By default, your system is in non-FIPS mode, you must enable it, if desired.

Hardware Requirements
You can install Unified Communications Manager and IM and Presence Service on a virtual server hosted
on the following types of hardware. If your current deployment does not use one of these servers, then you
must migrate to a supported hardware platform:
• Cisco Business Edition 6000 or 7000 appliance
• Virtualized Cisco hardware (such as Cisco UCS or Cisco HyperFlex) with VMware vSphere ESXi

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
17
 Plan the Upgrade or Migration
Network Requirements

• Virtualized Third-party hardware with VMware vSphere ESXi

The requirements and support policies are different for each of these options. Before you begin an upgrade,
verify that your current hardware meets the requirements of the new release. You can find detailed information
about the requirements by going to https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/uc_system/
virtualization/cisco-collaboration-virtualization.html and following the links for the Unified Communications
Manager and IM and Presence Service applications.

Network Requirements
This section lists the requirements that your network must meet before you can deploy Unified Communications
Manager and the IM and Presence Service.

IP Address Requirements
A complete collaboration solution relies on DNS in order to function correctly for a number of services and
thus requires a highly available DNS structure in place. If you have a basic IP telephony deployment and do
not want to use DNS, you can configure Unified Communications Manager and IM and Presence Service to
use IP addresses rather than hostnames to communicate with gateways and endpoint devices.
You must configure the server to use static IP addressing to ensure that the server obtains a fixed IP address.
Using a static IP address also ensures that Cisco Unified IP Phones can register with the application when
you plug the phones into the network.

DNS requirements
Note the following requirements:
• Mixed-mode DNS deployments not supported—Cisco does not support mixed-mode deployments. Both
Unified Communications Manager and IM and Presence Service must either use or not use DNS.
• If your deployment uses DNS—Unified Communications Manager and IM and Presence Service should
use the same DNS server. If you use different DNS servers between IM and Presence Service and Unified
Communications Manager, it is likely to cause abnormal system behavior.
• If your deployment does not use DNS, will need to edit the following Host Name/IP Address fields:
• Server—In the Cisco Unified CM Administration Server Configuration window, set IP addresses
for your cluster nodes.
• IM and Presence UC Service—In the Cisco Unified CM Administration UC Service Configuration
window, create an IM and Presence UC service that points to the IP address of the IM and Presence
database publisher node
• CCMCIP Profiles—In the Cisco Unified CM IM and Presence Administration CCMCIP Profile
Configuration window, point any CCMCIP profiles to the IP address of the host.

• Multinode considerations—If you are using the multinode feature in IM and Presence Service, see the
section regarding multinode deployments in the Configuration and Administration of IM and Presence
on Cisco Unified Communications Manager for DNS configuration options.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
18
 Plan the Upgrade or Migration
SFTP Server Support

SFTP Server Support

Cisco allows you to use any SFTP server product but recommends SFTP products that have been certified
with Cisco through the Cisco Solution Partner Program (CSPP). CSPP partners, such as GlobalSCAPE, certify
their products with specified versions of Unified Communications Manager. For information on which vendors
have certified their products with your version of Unified Communications Manager, go to the following URL
and select "Collaboration" from the Technology list in the navigation pane.
https://marketplace.cisco.com/catalog
For information on using GlobalSCAPE with supportedUnified Communications Manager versions, refer to
the following URL:
http://www.globalscape.com/gsftps/cisco.aspx
Cisco uses the following servers for internal testing. You may use one of the servers, but you must contact
the vendor for support:
• Open SSH (refer tohttp://sshwindows.sourceforge.net/)
• Cygwin (refer to http://www.cygwin.com/)
• Titan (refer to http://www.titanftp.com/)

Cisco does not support using the SFTP product free FTDP. This is because of the 1GB file size limit on this
SFTP product.
For issues with third-party products that have not been certified through the CSPP process, contact the
third-party vendor for support.

Virtual Machine Configuration

Before you begin an upgrade or migration, verify that your current virtual machine (VM) software meets the
requirements of the new release.

Table 2: Virtual Machine Requirements

Item Description

OVA templates OVA files provide a set of predefined templates for virtual machine
configuration. They cover items such as supported capacity levels and any
required OS/VM/SAN alignment. You must use a VM configuration from
the OVA file provided for the Unified Communications Manager and IM
and Presence Service applications.
The correct VM configuration to use from the OVA file is based on the
size of the deployment. For information about OVA files, search for the
topic "Unified Communications Virtualization Sizing Guidelines" at
https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/uc_system/
virtualization/collaboration-virtualization-sizing.html.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
19
 Plan the Upgrade or Migration
Browser Requirements

Item Description

VMware vSphere ESXi You must install a version of vSphere ESXi hypervisor that meets the
compatibility and support requirements for the release.
If you use Cisco Prime Collaboration Deployment (PCD) to perform an
upgrade or migration, you must also ensure that you install vSphere ESXi
with the correct license type. PCD is not compatible with all the license
types of vSphere ESXi because some of these licenses do not enable
required VMware APIs.

VMware vCenter VMware vCenter is optional when you deploy Unified Communications
Manager or IM and Presence Service on Business Edition 6000/7000
appliances, or on UC on UCS tested reference configuration hardware.
VMware vCenter is mandatory when you deploy on UC on UCS
specs-based and third-party server specs-based hardware.

VM configuration virtual Verify whether you need to change the virtual hardware specifications on
hardware specifications your VM in order to upgrade to a new release of Unified Communications
Manager or IM and Presence Service. For example, verify the requirements
for vCPU, vRAM, vNIC adaptor type, and vDisk size, as well as other
specifications.
Any changes to a VM must align with the OVA configuration. VM changes
that result in an unsupported OVA configuration are not allowed. For
information about VM requirements, see Readme file with the OVA
template that supports your release.
Note If Unified Communications Manager is upgraded to version
12.5 from version 11.5 or higher, using 80GB OVA it is expected
to have a higher active partition up to 98%. We can correct this
by a system rebuilt with HDD 90GB/110GB. Use a default
110GB OVA template and rebuilt the node. Or on current 80GB
OVA, prior to clean install, go to VM > Edit Settings, and
increase the HDD size from 80GB to 90GB/110GB. Other specs
remain the same. Adding HDD disk to the system already
installed only adds additional HDD space to common partition.

VMware Upgrade Requirements

If the upgrade requires you to update your VMware, go to Virtual Machine Configuration Tasks, on page 53.

Browser Requirements
Unified Communications Manager and the IM and Presence Service both provide interfaces that you can use
to configure and manage the system. You can access the interfaces by using the browsers and operating
systems listed in the following table. Cisco does not support or test other browsers.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
20
 Plan the Upgrade or Migration
Licensing Requirements

Table 3: Supported Browsers and Operating Systems

You can use this browser... ...with one of these operating systems

Google Chrome (latest browser version) Microsoft Windows 10 (64 bit)

Microsoft Internet Explorer 11 • Microsoft Windows 10 (64 bit)

• Microsoft Windows 8.1 (64 bit)
• Microsoft Windows 7 (64 bit)

Microsoft Edge Microsoft Windows 10 (32 bit/64 bit)

Mozilla Firefox (latest browser version) Microsoft Windows 10 (64 bit)

Safari Apple Mac OS 10.x (or newest OS release available)

Licensing Requirements
The following sections provide information about the licensing requirements for Unified Communications
Manager and the IM and Presence Service

Unified Communications Manager License Requirements

Use the Cisco Prime License Manager to allocate and monitor the licenses for Unified Communications
Manager, its applications, and endpoints. See the Cisco Prime License Manager User Guide for information
about generating and installing licenses.

Important Unused PAKs and/or licenses for versions before Release 9.0 cannot be installed once your system has been
upgraded to Release 9.0 or later. If you have uninstalled PAKs, install all licenses before upgrading.

IM and Presence Service License Requirements

The IM and Presence Service does not require a server license or software version license. However, you
must assign users and enable the IM and Presence Service for each assigned user.

Note With the Jabber for Everyone offer, no end user licenses are required to enable IM and Presence Service
functionality. For more information, see "Jabber for Everyone Quick Start Guide".

You can assign IM and Presence Service on a per user basis, regardless of the number of clients you associate
with each user. When you assign IM and Presence Service to a user, this enables the user to send and receive
IMs and availability updates. If users are not enabled for IM and Presence Service, they will not be able to
log in to the IM and Presence Service server to view the availability of other users, send or receive IMs, and
other users will not see their availability status.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
21
 Plan the Upgrade or Migration
Limitations

You can enable a user for IM and Presence Service using any of the following options:
• The End User Configuration window in Unified Communications Manager. For more information, see
the Administration Guide for Cisco Unified Communications Manager.
• The Bulk Administration Tool (BAT)
• Assign IM and Presence Service to a feature group template which you can reference from the Quick
User/Phone Add window in Unified Communications Manager.

For more information, see the System Configuration Guide for Cisco Unified Communications Manager.
IM and Presence Service capabilities are included within both User Connect Licensing (UCL) and Cisco
Unified Workspace Licensing (CUWL). IM and Presence Service capabilities can also be acquired for users
that are not Unified Communications Manager IP Telephony users through the Jabber for Everyone Offer.
For more information, see Jabber for Everyone Quick Start Guide.

Limitations
This section describes the limitations that apply when you install or upgrade Unified Communications Manager
or the IM and Presence Service Service.

Subnet Limitations
Do not install Unified Communications Manager in a large Class A or Class B subnet that contains a large
number of devices. For more information, see Cisco Collaboration System 12.x Solution Reference Network
Designs (SRND).

Cluster Size
The number of Unified Communications Manager subscriber nodes in a cluster cannot exceed 4 subscriber
nodes and 4 standby nodes, for a total of 8 subscribers. The total number of servers in a cluster, including the
Unified Communications Manager publisher node, TFTP server, and media servers, cannot exceed 21.
The maximum number of IM and Presence Service nodes in a cluster is 6.
For more information, see "Cisco Collaboration Solutions Design Guidance" at http://www.cisco.com/go/
ucsrnd

IP Subnet Mask
If you are using a 24-bit IP subnet mask, ensure that you use the following format:255.255.255.0. Do not use
the format 255.255.255.000. Although 255.255.255.000 is a valid format, it may cause problems during the
upgrade process. We recommend that you change the format before you begin an upgrade to avoid possible
problems. You can change the subnet mask by executing the set network ip eth0 <server_IP_address>
255.255.255.0 command.
Other formats are supported for subnet masks and this limitation applies to 24-bit subnet masks only.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
22
 Plan the Upgrade or Migration
Support for Intercluster Peers

Support for Intercluster Peers

The IM and Presence Service supports intercluster peers to clusters that are running different software versions.
To find the interdomain federations that are supported, see the "Supported Integrations" chapter in the
Compatibility Matrix for Cisco Unified Communications Manager and IM and Presence Service .

Device Name for Cisco Unified Mobile Communicator

Ensure that the device name for the Cisco Unified Mobile Communicator device contains 15 or fewer characters.
If the device name contains more than 15 characters for the Cisco Unified Mobile Communicator, the device
does not migrate during the upgrade.

Daylight Saving Time Settings Update

From Release 11.5(1)SU10 onwards, the time zone database (DST) is updated to 2021a. As part of this update,
the US/Pacific-New time zone has been removed. If the Unified Communication Manager or IM and Presence
Service server is currently configured with the US/Pacific-New time zone, it must be changed prior to upgrading
to avoid failures.

Spectre and Meltdown Vulnerabilities During Upgrade

This release of Unified Communications Manager, Cisco IM and Presence Service, Cisco Emergency
Responder, and Cisco Unity Connection Deployment contain OS and Kernal updates to address the Spectre
and Meltdown security vulnerabilities that might impact system performance.
The following actions might help mitigate the performance impact caused by the kernel update:
• If the VM version is not 13+, update the vmv version to 13 or later. This may require an ESXi version
upgrade to 6.5 and above (if you're running on an older ESXi release version).
• Before you upgrade or migrate to Release 11.5(1)SU10 or above, we recommend that you work with
your channel partner or account team to use the Cisco Collaboration Sizing Tool to identify whether
there are any system impact from the Spectre and Meltdown fixes. If required, compare the Cisco
Collaboration Sizing Tool output with your current cluster to check if any deployment changes are advised
so that the upgraded deployment provides the best performance.

OS Admin Account Required for CLI-Initiated IM and Presence

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

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
23
 Plan the Upgrade or Migration
Upgrade Requirements with Standalone Prime License Manager

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. See
your ISO Readme file for details on your specific ISO file. For-up-to date information on this limitation, see
CSCvb14399.

UpgradeRequirementswithStandalonePrimeLicenseManager
Cisco Unified Communications Manager Release 11.5(1)SU3, SU4, SU5, SU6, SU7, SU8, SU9, SU10, and
SU11 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, Unified Communications Manager cannot synchronize its license usage
with the standalone Prime License Manager.
If you are upgrading to one of these 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 Unified Communications Manager.

Note With co-resident Prime License Manager deployments, Unified Communications Manager and Cisco Prime
License Manager are compatible automatically.

Upgrades from 11.5(1)SU2 with Push Notifications Enabled

If you are upgrading from the 11.5(1)SU2 release and you had enabled Push Notifications in the previous
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 do not 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:

Procedure

Step 1 To disable Push Notifications, perform the following:

a) From Cisco Unified CM Administration, choose Advanced Features > Cisco Cloud Onboarding.
b) Uncheck the following check boxes:
• Enable Push Notifications
• Send Troubleshooting information to the Cisco Cloud
• Send encrypted PII to the Cisco Cloud for troubleshooting

c) Click Save
Step 2 Add a Cisco Unified Communications Manager product instance into Smart Licensing system. For more
information, see the “Smart Software Licensing” chapter of the System Configuration Guide for Cisco Unified

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
24
 Plan the Upgrade or Migration
Duplicate ENUMS Break Upgrades and Migrations from 9.1(2)

Communications Manager at http://www.cisco.com/c/en/us/support/unified-communications/

unified-communications-manager-callmanager/products-installation-and-configuration-guides-list.html
Step 3 Enable Push Notifications for this release. For the full onboarding process, see the “Configure Push Notifications
for Cisco Jabber on iPhone and iPad” chapter of the System Configuration Guide for Cisco Unified
Communications Manager at http://www.cisco.com/c/en/us/support/unified-communications/
unified-communications-manager-callmanager/products-installation-and-configuration-guides-list.html.

Duplicate ENUMS Break Upgrades and Migrations from 9.1(2)

If you are upgrading or migrating from Release 9.1(2) 10.5(2), or 11.0(1) to any later release, an issue exists
with older locale installations that causes upgrade and migration failures. This issue exists if any of the
following CUCM combined network locales have been installed:
• cm-locale-combined_network-9.1.2.1100-1
• cm-locale-combined_network-10.5.2.2200-1
• cm-locale-combined_network-11.0.1.1000-1

This issue can also occur if the following CUCM locales are installed together in the same cluster:
• cm-locale-en_GB-9.1.2.1100-1
• cm-locale-pt_BR-9.1.2.1100-1

• cm-locale-en_GB-10.5.2.2200-1
• cm-locale-pt_BR-10.5.2.2200-1

• cm-locale-en_GB-11.0.1.1000-1
• cm-locale-pt_BR-11.0.1.1000-1

To ensure that your upgrade does not fail, update your Unified Communications Manager and phone locale
installation to use a locale that is dated after August 31, 2017 as this issue does not exist for any locale file
issued after that date. After you update your locale installation, you can begin the upgrade or migration. For
details on the workaround, see https://bst.cloudapps.cisco.com/bugsearch/bug/CSCuz97687.

Blue Screen Appears for Unified CM Refresh Upgrades

An issue exists with refresh upgrades of Unified Communications Manager to specific destination releases.
After the timezone data populates, you may see a blue transition screen appear for 30 minutes or more.
If you see this blue screen, DO NOT stop the upgrade, or a kernel panic occurs. The upgrade will continue
to run even while the blue screen displays. The blue screen will clear itself after approximately 30 minutes

Affected 'To' Versions

This issue affects refresh upgrades of Unified Communications Manager where the destination version falls
within the range in the below table. This range includes SU and ES versions that lay within the range. This

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
25
 Plan the Upgrade or Migration
Blue Screen Appears for Unified CM Refresh Upgrades

issue does not occur for upgrades to older or newer versions that do not fall within the range, or for upgrades
of the IM and Presence Service.

Table 4: Affected 'To' Versions for Blue Screen Refresh Upgrade Issue

Release Category Affected Upgrade Destination Range

10.5(x) 10.5.2.21170-1—10.5.2.22188-1 (includes 10.5(2)SU9)

11.5(x) 11.5.1.16099—11.5.1.17118-1 (includes 11.5(1)SU6)

12.0(x) 12.0.1.23036-1 — 12.0.1.24053-1 (includes 12.0(1)SU3)

12.5(x) 12.5.1.11001-1 — 12.5.1.12018-1 (includes 12.5(1)SU1)

For additional details, see CSCvs28202.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
26
 CHAPTER 5
Supported Upgrade and Migration Paths
• Version Requirements, on page 27
• Supported Upgrade and Migration Paths, on page 30

Version Requirements
For 11.x Versions up to 11.5(1)SU1
If you are installing IM and Presence nodes, the software version of the first IM and Presence node (the IM
and Presence database publisher node) must match the first three numbers of the software version installed
on the Unified Communications Manager publisher node. For example, IM and Presence Service software
version 11.0.1.10000-1 is compatible with Unified Communications Manager software version 11.0.1.30000-2.
Refer to the following table for sample Unified Communications Manager versions and IM and Presence
Service versions that are compatible.. The bolded numbers must match.

Table 5: Examples of Compatible Unified Communications Manager and IM and Presence Service Versions

Sample Unified Communications Manager Version Example of Compatible IM and Presence Service
Version

11.0.1.30000-2 11.0.1.10000-1

11.5.1.10000-6 11.5.1.10000-4

After you install the first IM and Presence node, the software version of any IM and Presence subscriber nodes
that you install must match all five version numbers of the first IM and Presence node. For example, if the
IM and Presence database publisher node is at version 11.5.1.10000-1, then all IM and Presence subscriber
nodes must also be 11.5.1.10000-1.

Release 11.5(1)SU2
For Release 11.5(1)SU2, both Unified Communications Manager and IM and Presence Service must be
running official 11.5(1)SU2 versions. Running an 11.5(1)SU2 version of Unified Communications Manager
with an earlier version of IM and Presence Service is not supported. Similarly, running an 11.5(1)SU2 version
of IM and Presence Service with an earlier version of Unified Communications Manager is not supported.
The following software versions are supported with Release 11.5(1)SU2:
• Unified Communications Manager 11.5.1.12900-21

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
27
 Plan the Upgrade or Migration
Version Requirements

• IM and Presence Service 11.5.1.12900-25

Release 11.5(1)SU3
For Release 11.5(1)SU3, both Unified Communications Manager and IM and Presence Service must be
running official 11.5(1)SU3 versions. Running an 11.5(1)SU3 version of Unified Communications Manager
with an earlier version of IM and Presence Service is not supported. Similarly, running an 11.5(1)SU3 version
of IM and Presence Service with an earlier version of Unified Communications Manager is not supported.
The following software versions are supported with Release 11.5(1)SU3:
• Unified Communications Manager 11.5.1.13900-52
• Unified Communications Manager 11.5.1.13901-3
• Unified Communications Manager 11.5.1.13902-2
• IM and Presence Service 11.5.1.13900-57
• IM and Presence Service 11.5.1.13901-1

Release 11.5(1)SU4
The following versions are supported:
• Cisco Unified Communications Manager 11.5.1.14900-11
• IM and Presence Service 11.5.1.14900-32

This release offers two main deployment options for the IM and Presence Service:
• Standard Deployments (Decentralized)—In this deployment, both Cisco Unified Communications
Manager and the IM and Presence Service must be running an 11.5(1)SU4 version for your deployment
to be supported. A version mismatch is not supported.
• Centralized Deployments of the IM and Presence Service—Within the IM and Presence central cluster,
both the IM and Presence Service and the Cisco Unified Communications Manager instance (this is
primarily a database and provisioning instance, and does not handle telephony) must be running an
11.5(1)SU4 version. However, the remote telephony clusters to which the IM and Presence Service
connects do not have to be running an 11.5(1)SU4 version.

Release 11.5(1)SU5
The following versions are supported:
• Cisco Unified Communications Manager 11.5.1.15900-18
• IM and Presence Service 11.5.1.15900-33

This release offers two main deployment options for the IM and Presence Service:
• Standard Deployments (Decentralized)—In this deployment, both Cisco Unified Communications
Manager and the IM and Presence Service must be running an 11.5(1)SU5 version for your deployment
to be supported. A version mismatch is not supported.
• Centralized Deployments of the IM and Presence Service—Within the IM and Presence central cluster,
both the IM and Presence Service and the Cisco Unified Communications Manager instance (this is

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
28
Plan the Upgrade or Migration
Version Requirements

primarily a database and provisioning instance, and does not handle telephony) must be running an
11.5(1)SU5 version. However, the remote telephony clusters to which the IM and Presence Service
connects do not have to be running an 11.5(1)SU5 version.

Release 11.5(1)SU6
The following versions are supported:
• Cisco Unified Communications Manager 11.5.1.16900-16
• IM and Presence Service 11.5.1.16910-12

This release offers two main deployment options for the IM and Presence Service:
• Standard Deployments (Decentralized)—In this deployment, both Cisco Unified Communications
Manager and the IM and Presence Service must be running an 11.5(1)SU6 version for your deployment
to be supported. A version mismatch is not supported.
• Centralized Deployments of the IM and Presence Service—Within the IM and Presence central cluster,
both the IM and Presence Service and the Cisco Unified Communications Manager instance (this is
primarily a database and provisioning instance, and does not handle telephony) must be running an
11.5(1)SU6 version. However, the remote telephony clusters to which the IM and Presence Service
connects do not have to be running an 11.5(1)SU6 version.

Release 11.5(1)SU7
The following versions are supported:
• Cisco Unified Communications Manager 11.5.1.17900-52
• IM and Presence Service 11.5.1.17900-8

This release offers two main deployment options for the IM and Presence Service:
• Standard Deployments (Decentralized)—In this deployment, both Cisco Unified Communications
Manager and the IM and Presence Service must be running an 11.5(1)SU7 version for your deployment
to be supported. A version mismatch is not supported.
• Centralized Deployments of the IM and Presence Service—Within the IM and Presence central cluster,
both the IM and Presence Service and the Cisco Unified Communications Manager instance (this is
primarily a database and provisioning instance, and does not handle telephony) must be running an
11.5(1)SU7 version. However, the remote telephony clusters to which the IM and Presence Service
connects do not have to be running an 11.5(1)SU7 version.

Release 11.5(1)SU8
The following versions are supported:
• Cisco Unified Communications Manager 11.5.1.18900-97
• IM and Presence Service 11.5.1.18900-15

This release offers two main deployment options for the IM and Presence Service:

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
29
 Plan the Upgrade or Migration
Supported Upgrade and Migration Paths

• Standard Deployments (Decentralized)—In this deployment, both Cisco Unified Communications

Manager and the IM and Presence Service must be running an 11.5(1)SU8 version for your deployment
to be supported. A version mismatch is not supported.
• Centralized Deployments of the IM and Presence Service—Within the IM and Presence central cluster,
both the IM and Presence Service and the Cisco Unified Communications Manager instance (this is
primarily a database and provisioning instance, and does not handle telephony) must be running an
11.5(1)SU8 version. However, the remote telephony clusters to which the IM and Presence Service
connects do not have to be running an 11.5(1)SU8 version.

Supported Upgrade and Migration Paths

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

Pre-upgrade Deployment is Running on Cisco Media Convergence Server

Hardware
You cannot run Release 11.5(x) of Cisco Unified Communications Manager and the IM and Presence Service
on server hardware directly; you must run these applications on virtual machines. The tables below list the
supported migration paths for deployments where the pre-upgrade version is running on Cisco 7800 Series
Media Convergence Server (MCS 7800) hardware. You must migrate to a system that is running on a virtual
machine. All of the supported migration paths listed below are physical-to-virtual (P2V) migrations. Also
note that "11.5(x)" includes 11.5(1) and subsequent SU releases.

Note The tables below list the upgrade paths supported for MCS 7800 Series servers, with the following exceptions:
• MCS 7816-C1 for Business Edition 3000 (BE3000)
• MCS 7828 for Business Edition 5000 (BE5000)

PCD migrations are not supported for BE3000 and BE5000 deployments. We recommend a fresh installation
for upgrades from these products.

Table 6: Upgrade Paths when Pre-Upgrade Version is Running on Cisco MCS 7800 Series Hardware

From To Supported Methods

Unified Communications Manager Upgrades

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
30
 Plan the Upgrade or Migration
Pre-upgrade Deployment is Running on a Virtual Machine

From To Supported Methods

Unified CM (on MCS 11.5(x) PCD Migration

7800 Series HW)
6.1(5), 7.1(3), 7.1(5), 8.x,
9.x

IM and Presence Service Upgrades

Cisco Unified Presence IM and Presence Service PCD Migration

(on MCS 7800 Series 11.5(x)
HW)
8.5(4), 8.6(3), 8.6(4),
8.6(5)

IM and Presence Service 11.5(x) PCD Migration

(on MCS 7800 Series
HW)
9.0(x), 9.1(x)

Pre-upgrade Deployment is Running on a Virtual Machine

The table below lists the supported upgrade and migration paths where the pre-upgrade version is running on
a virtual machine. 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. Also note that "11.5(x)"
includes 11.5(1) and subsequent SU releases.

Table 7: Upgrade Paths when Pre-upgrade Version is Running on Virtual Machine

From To Supported Methods

Unified Communications Manager Upgrades

Unified CM 8.6(x) 11.5(x) Cisco Unified OS Admin (Direct Refresh)

PCD Migration
PCD Upgrade (Direct Refresh)

Unified CM 9.0(x) 11.5(x) PCD Migration

PCD Upgrade (Direct Refresh)

Unified CM 9.1(x) 11.5(x) Cisco Unified OS Admin (Direct Refresh)

PCD Migration
PCD Migration (Direct Refresh)

Unified CM 10.0(x) 11.5(x) PCD Migration

PCD Upgrade (Direct Standard)

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
31
 Plan the Upgrade or Migration
Upgrade Path Restrictions for Release 11.5(x)

From To Supported Methods

Unified CM 10.5(x), 11.5(x) Cisco Unified OC Admin (Direct Standard)

11.0(x), 11.5(x)
PCD Migration
PCD Migration (Direct Standard)

IM and Presence Service Upgrades

Cisco Unified Presence IM and Presence 11.5(x) PCD Migration

8.5(4)

Cisco Unified Presence IM and Presence 11.5(x) PCD Migration

8.6(3), 8.6(4), 8.6(5)
PCD Upgrade (Direct Refresh)

Cisco Unified Presence IM and Presence 11.5(x) Cisco Unified OS Admin

8.6(x)

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 Standard)
Cisco Unified OS Admin (Direct Refresh)

IM and Presence 10.0(x), 11.5(x) PCD Migration

10.5(x), 11.0(x), 11.5(x)
PCD Upgrade (Direct Standard)
Cisco Unified OS Admin (Direct Standard)

Upgrade Path Restrictions for Release 11.5(x)

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

Table 8: Restrictions to Supported Upgrade and Migration Paths, Cisco Unified Communications Manager Release 11.5(x)

From To Description

10.5(2)SU5 11.5(1.10000-6) through Path is unsupported. For these

11.5(1.120xx) releases, upgrade to 11.5(1)SU2
instead.

Upgrade Restriction for 11.5(1)SU9

If your pre-upgrade version is Release 11.5(1)SU9 of Cisco Unified Communications Manager and the IM
and Presence Service, you cannot upgrade to Releases 12.0(x), 12.5(1), 12.5(1)SU1, or 12.5(1)SU2. The
minimum Release that you can upgrade to is 12.5(1)SU3.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
32
 CHAPTER 6
Deployment Types and Recommendations
• Type of Deployment, on page 33

Type of Deployment
Use the information in this section after you have reviewed the tables in the Supported Upgrade and Migration
Paths, on page 27 chapter. If those tables indicate that you have a choice of which upgrade method to use,
refer to the recommendations in the following sections to help you choose the best option for your deployment.

Business Edition 6000 and Business Edition 7000 Deployments

If your hardware and VMware are current and do not need any changes to meet the compatibility and support
requirements of the release, use Unified CM OS Admin to perform the upgrade.
If you are running several applications in addition to Unified Communications Manager and IM and Presence
Service, such as Cisco Unity Connection and/or Cisco Unified Contact Center Express, you can use the PCD
upgrade task to automate the process.

Virtualized Deployments of Cisco Unified Communications Manager and IM

and Presence Service
If your current version is running in a virtualized environment, your upgrade path may allow you to choose
your upgrade method. Use the information in this section to help you choose your upgrade method.
Consider performing a PCD migration when:
• you need old and new systems up in parallel.
• you want to change virtual machine configurations in Release 11.5(1) but the change forces a reinstall.

Consider performing a PCD upgrade when:

• you have large number of virtual machines and a complex upgrade sequence or a need to forward-schedule.
• you need to upgrade other applications, such as Cisco Unity Connection or Cisco Unified Contact Center
Express.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
33
 Plan the Upgrade or Migration
Virtualized Deployments of Cisco Unified Communications Manager and IM and Presence Service

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
34
 CHAPTER 7
Sequencing Rules and Time Requirements
• Upgrade Sequence and Time Requirements, on page 35
• Upgrade time requirements, on page 41

Upgrade Sequence and Time Requirements

The sequence in which you perform upgrade procedures depends on your deployment, and on how you want
to balance the level of user impact with the amount of time required to complete the upgrade. You must
identify the sequence that you will follow before you are ready to perform the upgrade process.
The information in this section applies only if you are performing a direct upgrade using either the Unified
CM OS Administration interface or the PCD Upgrade task. PCD Migrations do not require this step.
We recommend that you follow the sequences that are outlined in this section when you plan your upgrade.
Choose one of the following options, based on your business needs:
• Recommended Sequence for the Least Time , on page 35
• Recommended Sequence for the Least Impact, on page 37

If you do not follow one of the recommended sequences, you must ensure that your upgrade plan meets the
requirements listed in Sequence Rules, on page 40

Recommended Sequence for the Least Time

Use the information in this section if you want to perform a direct upgrade that takes the least amount of time.
This approach will have the greatest service impact on your network.
To perform an upgrade in the least amount of time, you can upgrade all Unified Communications Manager
subscriber nodes in parallel; with this option, all phones will be out of service for the duration of the upgrade.
You can reduce the impact on phone service by organizing the subscriber nodes into subgroups. Upgrade the
subscriber nodes within each subgroup in parallel, but upgrade each subgroup sequentially. This will reduce
the impact to your phone service but will add time to the upgrade process.
The tables below list the sequence to follow for direct refresh upgrades and direct standard upgrades. Plan to
perform the tasks in the order shown in the appropriate table below. You must always begin an upgrade with
the Unified Communications Manager nodes. You can perform upgrade procedures on the IM and Presence
Service nodes in parallel with Unified Communications Manager nodes only as indicated in the table below.
Any tasks that are listed on the same row in the table are ones that you can perform in parallel.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
35
 Plan the Upgrade or Migration
Recommended Sequence for the Least Time

If you are upgrading Unified Communications Manager nodes to a Maintenance Release (MR) or an Engineering
Special (ES) Release and you are not upgradingIM and Presence Service nodes, you must reboot all IM and
Presence Service nodes after the Unified Communications Manager upgrade is complete.

Refresh Upgrades
Use the table below to plan a refresh upgrade when your priority is to perform the upgrade in the least amount
of time. If you are unsure whether you need to perform a refresh upgrade or a standard upgrade, review the
information in Direct Upgrades, on page 8.

Table 9: Recommended Sequence for Performing Refresh Upgrades in the Least Amount of Time

Sequence Unified Communications Manager Nodes IM and Presence Service Nodes

1 Upgrade the publisher node to the new software —

version. The new software is inactive.

2 Upgrade the subscriber nodes in parallel. The new Upgrade the IM and Presence Service
software is inactive. database publisher node in parallel with
the Unified Communications Manager
subscriber nodes.

3 — Upgrade the subscriber nodes. The new

software is inactive.

4 Switch the software version on the publisher node —

and reboot it. The new software is active.

5 Switch the software version on the subscriber —

nodes in parallel and reboot them.

6 Ensure that database replication is complete and —

functioning between the publisher node and all
subscriber nodes before proceeding.

7 — Switch the software version on the

database publisher node and reboot it. The
new software is active.

8 — Switch the software version on the

subscriber nodes in parallel and reboot
them. The new software is active.

9 — Ensure that database replication is

complete and functioning between the
publisher node and all subscriber nodes.

Standard Upgrades
Use the table below to plan a standard upgrade when your priority is to perform the upgrade in the least amount
of time.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
36
 Plan the Upgrade or Migration
Recommended Sequence for the Least Impact

Table 10: Recommended Sequence for Performing Standard Upgrades in the Least Amount of Time

Sequence Unified Communications Manager Nodes IM and Presence Service Nodes

1 Upgrade the publisher node to the new software —

version. The new software is inactive.

2 Upgrade the subscriber nodes. The new software Upgrade the IM and Presence Service
is inactive. database publisher node in parallel with
the Unified Communications Manager
subscriber nodes.

3 — Upgrade the subscriber nodes. The new

software is inactive.

4 Switch the software version on the publisher node —

and reboot it. The new software is active.

5 Switch the software version on the subscriber Switch the software version on the
nodes in parallel and reboot them. The new database publisher node and reboot it.
software is active.

6 Ensure that database replication is complete and Switch the software version on the
functioning between the publisher node and all subscriber nodes in parallel and reboot
subscriber nodes before proceeding. them.

7 — Ensure that database replication is

complete and functioning between the
publisher node and all subscriber nodes.

Recommended Sequence for the Least Impact

Use the information in this section if you want to perform a direct upgrade that has the least impact on your
network and you can accept the completion of the upgrade over a longer period.
The tables below list the sequence to follow for direct refresh upgrades and direct standard upgrades. Plan to
perform the tasks in the order shown in the appropriate table below. You must always begin an upgrade with
the Unified Communications Manager nodes. You can perform upgrade procedures on the IM and Presence
Service nodes in parallel with Unified Communications Manager nodes. Any tasks that are listed on the same
row in the table are ones that you can perform in parallel.
If you are upgrading Unified Communications Manager nodes to a Maintenance Release (MR) or an Engineering
Special (ES) Release and you are not upgradingIM and Presence Service nodes, you must reboot all IM and
Presence nodes after the Unified Communications Manager upgrade is complete.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
37
 Plan the Upgrade or Migration
Recommended Sequence for the Least Impact

Note In addition to following the recommended sequence, you must also verify that your phones and devices are
configured for redundancy through the use of Cisco Unified CM Groups (CMGs) with primary subscriber
nodes and backup subscriber nodes. As part of your upgrade planning, ensure that you have assigned nodes
and devices to CMGs so that when one of the nodes in the CMG is unavailable, the remaining nodes within
the CMG can support all of the devices that are assigned to the CMG. This configuration allows you to ensure
availability throughout the upgrade. For more information about CMGs, see the chapter "Configure Core
Settings for Device Pools" atSystem Configuration Guide for Cisco Unified Communications Manager.

Refresh Upgrades
Use the table below to plan a refresh upgrade when your priority is to perform the upgrade with the least
impact on phone services.

Table 11: Recommended Sequence for Performing Refresh Upgrades with the Least Impact

Sequence Unified Communications Manager Nodes IM and Presence Service Nodes

1 Upgrade the publisher node to the new software —

version. The new software is inactive.

2 Verify that phones are registered to primary Upgrade the IM and Presence Service
subscriber nodes in CMGs. Upgrade the database publisher node in parallel with
secondary subscriber nodes. The new software is the Unified Communications Manager
inactive. subscriber nodes.

3 Verify that phones are registered to secondary Upgrade the subscriber nodes. The new
subscriber nodes in CMGs. Upgrade the primary software is inactive.
subscriber nodes. The new software is inactive.
Verify that phones are registered to primary
subscriber nodes in CMGs.

4 Switch the software version on the publisher node —

and reboot it. The new software is active.

5 Switch the software version on the secondary —

subscriber nodes in parallel and reboot them. The
new software is active.

6 Ensure that database replication is complete and —

functioning between the publisher node and all
secondary subscriber nodes.

7 Verify that phones are registered to secondary —

subscriber nodes in CMGs. Switch the software
version on the primary subscriber nodes in parallel
and reboot them.

8 Ensure that database replication is complete and —

functioning between the publisher node and all
primary subscriber nodes.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
38
Plan the Upgrade or Migration
Recommended Sequence for the Least Impact

Sequence Unified Communications Manager Nodes IM and Presence Service Nodes

9 — Switch the software version on the

database publisher node and reboot it. The
new software is active.

10 — Switch the software version on the

subscriber nodes in parallel and reboot
them. The new software is active.

11 — Ensure that database replication is

complete and functioning between the
publisher node and all subscriber nodes.

Standard Upgrades
Use the table below to plan a standard upgrade when your priority is to perform the upgrade with the least
impact on phone services.

Table 12: Recommended Sequence for Performing Standard Upgrades with the Least Impact

Sequence Unified Communications Manager Nodes IM and Presence Service Nodes

1 Upgrade the publisher node to the new software —

version. The new software is inactive.

2 Upgrade the primary and secondary subscriber Upgrade the IM and Presence Service
nodes. The new software is inactive. database publisher node in parallel with
the Unified Communications Manager
subscriber nodes. The new software is
inactive.

3 — Upgrade the subscriber nodes. The new

software is inactive.

4 Switch the software version on the publisher node —

and reboot it.

5 Verify that phones are registered to primary Switch the software version on the
subscriber nodes in CMGs. Switch the software database publisher node and reboot it.
version on the secondary subscriber nodes in
parallel and reboot them. The new software is
active.

6 Ensure that database replication is complete and Switch the software version on the
functioning between the publisher node and all subscriber nodes in parallel and reboot
secondary subscriber nodes. them. The new software is active.

7 Verify that phones are registered to secondary Ensure that database replication is
subscriber nodes in CMGs. Switch the software complete and functioning between the
version on the primary subscriber nodes in parallel publisher node and all subscriber nodes.
and reboot them.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
39
 Plan the Upgrade or Migration
Sequence Rules

Sequence Unified Communications Manager Nodes IM and Presence Service Nodes

8 Ensure that database replication is complete and —

functioning between the publisher node and all
primary subscriber nodes. Verify that phones are
registered to primary subscriber nodes in CMGs.

Sequence Rules
When you are planning to perform an upgrade using either the Unified CM OS Admin interface or the PCD
upgrade task, you must ensure that your plan takes the following sequencing rules into account.
• The Unified Communications Manager publisher node must be the first node that you upgrade. The new
software is installed as an inactive version.
• You can begin upgrading Unified Communications Manager subscriber nodes as soon as the publisher
node has been upgraded with an inactive version of the new software.
• You must switch the Unified Communications Manager publisher node to the new software version and
reboot it before you switch the version on any subscriber nodes. The publisher node must be the first
node to switch to the new software version and reboot.
• If you upgrade a group of subscriber nodes, after you switch the software version and reboot, you must
wait for database replication to complete on all subscriber nodes before proceeding with any COP file
installs or configuration changes.
• If you are upgrading Unified Communications Manager nodes to a Maintenance Release (MR) or an
Engineering Special (ES) Release and you are not upgrading IM and Presence Service nodes, you must
reboot all IM and Presence nodes after the Unified Communications Manager upgrade is complete.
• If you are upgrading IM and Presence Service nodes in addition to Unified Communications Manager
nodes:
• The IM and Presence Service database publisher node must be the first IM and Presence Service
node that you upgrade. The new software is installed as an inactive version.
• You can begin upgrading IM and Presence Service subscriber nodes as soon as the publisher node
has been upgraded with an inactive version of the new software.
• You can wait until all of the Unified Communications Manager nodes are upgraded to an inactive
version before you upgrade the IM and Presence Service database publisher node, or you can choose
to upgrade in parallel. If you upgrade in parallel, start upgrading the IM and Presence Service
database publisher node at the same time that you upgrade the Unified Communications Manager
subscriber nodes.
• You must switch to the new software version and reboot all Unified Communications Manager
nodes, starting with the publisher node, before you can switch versions on the IM and Presence
Service nodes.
• You must switch the IM and Presence Service database publisher node to the new software version
and reboot it before you switch the software version on any IM and Presence Service subscriber
nodes.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
40
 Plan the Upgrade or Migration
Upgrade time requirements

• If you upgrade a group of IM and Presence Service subscriber nodes, after you switch the software
version and reboot, you must wait for database replication to complete on all subscriber nodes before
proceeding.

• If you are upgrading IM and Presence Service nodes to a Maintenance Release (MR) or an Engineering
Special (ES) Release and you are not upgrading Unified Communications Manager nodes, the following
additional sequencing rules apply:
• For upgrades using the Unified CM OS Admin interface, you must upgrade the Unified
Communications Manager publisher node and then upgrade the IM and Presence Service nodes to
the Maintenance Release (MR) or an Engineering Special (ES) Release.
• If you are using the Prime Collaboration Deployment migration task, you must select the Unified
Communications Manager publisher node in addition to the IM and Presence Service nodes.
• If you are using the Prime Collaboration Deployment upgrade task, you do not need to select the
Unified Communications Manager publisher node as long as the first 3 digits of new version of IM
and Presence Service match the first 3 digits of the currently installed version of Unified
Communications Manager.

Upgrade time requirements

The time required to upgrade the software is variable and depends on a number of factors. Use the information
in the following sections to understand the steps you can take to optimize the upgrade process. The following
sections also provide information and examples to help you to estimate the time requirements for an upgrade.

Factors that Affect Upgrade Time Requirements

The table below lists the factors that impact the amount of time that an upgrade requires. You can reduce the
amount of time needed for an upgrade by ensuring that your system meets these conditions.

Table 13: Factors that Affect Time Requirements

Item Description

External Services and Time requirements are reduced when external services and tools, such as NTP
Tools servers, DNS servers, LDAP directories, and other network services are reachable
with response times as short as possible with no dropped packets.
We recommend that you configure the ESXi server and the Unified
Communications Manager publisher node to point to the same NTP server.

Accessibility of upgrade Save time by ensuring that ISO images are on DVD, or are already downloaded
images and staged on the same LAN as the Unified Communications Manager and IM
and Presence Service virtual machines (VM).

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
41
 Plan the Upgrade or Migration
Factors that Affect Upgrade Time Requirements

Item Description

System health The virtual machine configuration impacts the time requirement for an upgrade.
Use the virtual machine specifications that are correct for your deployment size.
If your database exceeds the virtual machine's configuration limits, the upgrade
process will take longer to complete or fail. For example, having too many devices
for the VM configuration will impact the upgrade.

Low memory or memory leaks will impact the upgrade.

Round Trip Times (RTT) between nodes will extend the time required.

Ensure that there are no OutOfSynch (OOS) tables in the database.

Ensure that there are no SD link out-of -service events on the node. These events
typically indicate a network problem, which you must address before you begin
the upgrade process.

System errors can impact upgrade time. In the Real Time Monitoring Tool
(RTMT) interface, double-click Alert Central in the left navigation pane and
ensure that there are no errors.

Physical and virtual Upgrade time is reduced when your infrastructure is configured for high-capacity
hardware infrastructure and low-latency, and when there is low contention from other traffic. For example,
you can optimize the upgrade process by ensuring that:
• There are no infrastructure bottlenecks from VMs sharing same ESXi host,
the same Direct Attached Storage (DAS) volume, the same Logical Unit
Number (LUN), or the same congested network link.
• Storage latencies meet the requirements specified at .. www.cisco.com go
virtualized-collaboration.
• The physical CPU cores and the virtualization design comply with
virtualization requirements of Unified Communications Manager and IM
and Presence Service. Do not oversubscribe CPUs by having VMs share the
host resources; use logical cores or resource reservations
• Unified Communications Manager and IM and Presence Service virtual
machines are on same hosts, or on hosts wtih 1GbE LAN between them
with low contention from other traffic.
• If the cluster is over a WAN, ensure that you follow all bandwidth and
latency rules listed in the Cisco Collaboration Systems Solution Reference
Network Designs (SRND) for at http://www.cisco.com/c/en/us/support/
unified-communications/unified-communications-system/
products-implementation-design-guides-list.html.

System capacity Reduce the upgrade time by purging unnecessary files, such as:
• Call Detail Recording (CDR) records
• Outdated files, such as TFTP files, firmware, and log files

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
42
 Plan the Upgrade or Migration
Factors that Affect Upgrade Time Requirements

Item Description

Throttling On IM and Presence Service nodes, the system throttles the upgrade process to
preserve system stability during upgrades. Throttling may increase the time
required to complete the upgrade. Although you can disable throttling to decrease
the time it takes to perform the upgrade, doing so may degrade system
performance.

Factors that Affect Upgrade Time Requirements

The table below lists the factors that impact the amount of time that an upgrade requires. You can reduce the
amount of time needed for an upgrade by ensuring that your system meets these conditions.

Table 14: Factors that Affect Time Requirements

Item Description

External Services and Tools Time requirements are reduced when external services and tools, such as
NTP servers, DNS servers, LDAP directories, and other network services
are reachable with response times as short as possible with no dropped
packets.
We recommend that you configure the ESXi server and the Unified
Communications Manager publisher node to point to the same NTP server.

Accessibility of upgrade images Save time by ensuring that ISO images are on DVD, or are already
downloaded and staged on the same LAN as the Unified Communications
Manager and IM and Presence Service virtual machines (VM).

System health The virtual machine configuration impacts the time requirement for an
upgrade. Use the virtual machine specifications that are correct for your
deployment size. If your database exceeds the virtual machine's
configuration limits, the upgrade process will take longer to complete or
fail. For example, having too many devices for the VM configuration will
impact the upgrade.

Low memory or memory leaks will impact the upgrade.

Round Trip Times (RTT) between nodes will extend the time required.

Ensure that there are no OutOfSynch (OOS) tables in the database.

Ensure that there are no SD link out-of -service events on the Unified
Communications Manager node. These events typically indicate a network
problem, which you must address before you begin the upgrade process.

System errors can impact upgrade time. In the Real Time Monitoring Tool
(RTMT) interface, double-click Alert Central in the left navigation pane
and ensure that there are no errors.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
43
 Plan the Upgrade or Migration
Estimating the Minimum Time Requirements

Item Description

Physical and virtual hardware Upgrade time is reduced when your infrastructure is configured for
infrastructure high-capacity and low-latency, and when there is low contention from other
traffic. For example, you can optimize the upgrade process by ensuring
that:
• There are no infrastructure bottlenecks from VMs sharing same ESXi
host, the same Direct Attached Storage (DAS) volume, the same
Logical Unit Number (LUN), or the same congested network link.
• Storage latencies meet the requirements specified at .. www.cisco.com
go virtualized-collaboration.
• The physical CPU cores and the virtualization design comply with
virtualization requirements of Unified Communications Manager and
IM and Presence Service. Do not oversubscribe CPUs by having VMs
share the host resources; use logical cores or resource reservations
• Unified Communications Manager and IM and Presence Service virtual
machines are on same hosts, or on hosts wtih 1GbE LAN between
them with low contention from other traffic.
• If the cluster is over a WAN, ensure that you follow all bandwidth and
latency rules listed in the Cisco Collaboration Systems Solution
Reference Network Designs (SRND) for at http://www.cisco.com/c/
en/us/support/unified-communications/unified-communications-system/
products-implementation-design-guides-list.html.

System capacity Reduce the upgrade time by purging unnecessary files, such as:
• Call Detail Recording (CDR) records
• Outdated files, such as TFTP files, firmware, and log files

Throttling On IM and Presence Service nodes, the system throttles the upgrade process
to preserve system stability during upgrades. Throttling may increase the
time required to complete the upgrade. Although you can disable throttling
to decrease the time it takes to perform the upgrade, doing so may degrade
system performance.

Estimating the Minimum Time Requirements

The table below lists the minimum amount of elapsed time to expect for each task in the upgrade process
under ideal conditions. Your upgrade may take longer than the times listed in this table, depending on your
network conditions and on the upgrade sequence that you follow.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
44
Plan the Upgrade or Migration
Estimating the Minimum Time Requirements

Note Once you begin the upgrade process, you cannot make configuration changes until the upgrade is complete
and you have performed all of the post-upgrade tasks. Configuration changes include:
• changes made through any of the Unified Communications Manager or IM and Presence Service graphical
user interfaces (GUI), the command line interface (CLI), or the AXL API
• LDAP synchronizations, including incremental synchronizations that are pushed to Unified
Communications Manager from an Oracle LDAP
• automated jobs
• devices attempting to autoregister

Table 15: Minimum Time Required for Upgrade Tasks

Task Minimum Time Service Impact

Upgrade the Unified Communications Manager 2 to 4 hours Refresh upgrades: no

publisher node to an inactive version access to the UI
Add 1 hour if a refresh
upgrade

Upgrade the Unified Communications Manager 1 to 2 hours Refresh upgrades: phones

subscriber nodes to an inactive version are unavailable if no
backup subscribers are
configured

Switch the Unified Communications Manager 30 minutes —

publisher node to the new software version and reboot

Switch the Unified Communications Manager 30 minutes Standard upgrades: phones

subscriber nodes to the new software version and are unavailable if no
reboot backup subscribers are
configured

Unified Communications Manager database 30 minutes for Phones are available with
replication deployments with small dial tone but end-user
clusters or small databases features are unavailable
until upgrade is complete
2 hours for megaclusters
or large databases
Note WAN latency
of 80ms or
more can
significantly
lengthen these
times

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
45
 Plan the Upgrade or Migration
Examples

Task Minimum Time Service Impact

Upgrade the IM and Presence Service database 2 to 4 hours At the time of L2 upgrade
publisher node to an inactive version neither phone services nor
Add 1 hour if a refresh
IM and Presence should
upgrade
be impacted
IM and Presence should
be impacted only in the
case of Refresh Upgrade

Upgrade the IM and Presence Service subscriber 1 to 2 hours During the switch version
nodes to an inactive version , irrespective of L2 or
Refresh Upgrade phone
services should continue
to work while IM and
Presence is impacted

Switch the IM and Presence Service publisher node 30 minutes IM and Presence high
to the new software version and reboot availability is disabled
Jabber is unavailable

Switch the IM and Presence Service subscriber nodes 30 minutes IM and Presence high
to the new software version and reboot availability is disabled
Jabber is unavailable

IM and Presence Service database replication 30 minutes for IM and Presence high
deployments with small availability is disabled
clusters or small databases
Jabber is unavailable
2 hours for megaclusters
or large databases
Note WAN latency
of 80ms or
more can
significantly
lengthen these
times

Examples
The examples in this section are based on the following upgrade scenario:
• a megacluster that includes Unified Communications Manager nodes as well as Instant Messaging and
Presence nodes
• 75,000 users
• a system that is healthy and that has been optimized for the upgrade, as described in Factors that Affect
Upgrade Time Requirements, on page 43

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
46
 CHAPTER 8
Find all Required Upgrade Documentation
• Additional Upgrade Documentation, on page 47

Additional Upgrade Documentation

Find the correct upgrade documentation to use based on the scope of your upgrade and the recommended
upgrade method.

Task See . . .

Prepare the hardware platform

Install a Unified Communications (UC) Cisco Collaboration on Virtual Servers at http://www.cisco.com/

on Cisco Unified Computing System c/en/us/support/unified-communications/
(UCS) Tested Reference Configuration unified-communications-manager-callmanager/
(TRC) products-installation-guides-list.html

Install a Business Edition 6000 (BE 6000) Installation guides for your version of BE 6000 at
appliance http://www.cisco.com/c/en/us/support/unified-communications/
business-edition-6000/products-installation-guides-list.html

Install a Business Edition 7000 (BE 7000) Cisco Business Edition 7000 Installation Guide at
appliance http://www.cisco.com/c/en/us/support/unified-communications/
business-edition-7000/products-installation-guides-list.html

Install new virtualized 3rd-party See the documentation from the server vendor and from VMware.
specs-based server or Cisco UCS See application support information at www.cisco.com go
specs-based server virtualized-collaboration
Information about specs-based support is available by searching
on the topic "UC Virtualization Supported Hardware" at
www.cisco.com go virtualized-collaboration

Replace existing hardware and preserve Replacing a Single Server or Cluster for Cisco Unified
the server configuration Communications Manager at http://www.cisco.com/c/en/us/
support/unified-communications/
unified-communications-manager-callmanager/
products-installation-guides-list.html

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
47
 Plan the Upgrade or Migration
Additional Upgrade Documentation

Task See . . .

Change the IP address or hostname To automate the changes:

• Perform a PCD Upgrade or PCD Migration with network
migration to change the application version and the IP address
at the same time.
• Use the PCD Re-address task after the upgrade is complete.
This task changes the IP addresses only.

See Cisco Prime Collaboration Deployment Administration Guide

at http://www.cisco.com/c/en/us/support/unified-communications/
unified-communications-manager-callmanager/
products-maintenance-guides-list.html

To make the changes manually: See Changing IP Address and

Hostname for Cisco Unified Communications Manager or IM and
Presence Service at http://www.cisco.com/c/en/us/support/
unified-communications/
unified-communications-manager-callmanager/
products-maintenance-guides-list.html.

Prepare the virtual platform

Review requirements and best practices Unified Communications Manager and IM and Presence Service
information at http://www.cisco.com/go/uc-virtualized

Download the Cisco OVA file Follow the procedures contained in this document.See Download
and Install OVA Templates, on page 55

Edit the virtual machine configuration Vendor documentation at http://www.VMware.com

Follow the procedures contained in this document. See Change
the Virtualization Software, on page 53

Upgrade to a new release of Unified Communications Manager and IM and Presence Service

Upgrade and install new licenses Cisco Prime License Manager User Guide at
http://www.cisco.com/c/en/us/support/cloud-systems-management/
prime-license-manager/products-user-guide-list.html

Migrate from one hardware platform to Cisco Prime Collaboration Deployment Administration Guide at
another as part of the upgrade process http://www.cisco.com/c/en/us/support/unified-communications/
unified-communications-manager-callmanager/
products-maintenance-guides-list.html

Upgrade on the same hardware platform Cisco Prime Collaboration Deployment Administration Guide at
using Prime Collaboration Deployment http://www.cisco.com/c/en/us/support/unified-communications/
unified-communications-manager-callmanager/
products-maintenance-guides-list.html

Upgrade on the same hardware platform Follow the procedures contained in this document.
using Unified CM OS Administration

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
48
Plan the Upgrade or Migration
Additional Upgrade Documentation

Task See . . .

Read the Release Notes for the new Release Notes for Cisco Unified Communications Manager and
software version IM and Presence Service at http://www.cisco.com/c/en/us/support/
unified-communications/
unified-communications-manager-callmanager/
products-release-notes-list.html

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
49
 Plan the Upgrade or Migration
Additional Upgrade Documentation

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
50
PA R T III
Change the Virtualization Software
• Change the Virtualization Software, on page 53
 CHAPTER 9
Change the Virtualization Software
• Virtual Machine Configuration Tasks, on page 53

Virtual Machine Configuration Tasks

Use the procedures in this chapter if you need to change your virtual machine configuration to meet the
requirements of the software version that you are upgrading to.

Before you begin

Verify whether you need to upgrade your virtual machine to meet the requirements of the new release. You
can find the requirements by going to Cisco Collaboration Virtualization and following the links for the
Unified Communications Manager and IM and Presence Service applications.

Procedure

Command or Action Purpose

Step 1 Install and Configure VMware vCenter, on page VMware vCenter is required only when you are
54 migrating from Cisco Business Edition or
Tested Reference Configuration (TRC)
hardware to UC on UCS specs-based or
third-party server specs-based hardware. If you
require VMware vCenter, install and configure
it first.
Using VMware vCenter is optional when you
deploy Unified Communications Manager or
IM and Presence Service on UC on UCS tested
reference configuration hardware.

Step 2 Upgrade vSphere ESXi, on page 55 You must install a version of vSphere ESXi
hypervisor that meets the requirements of the
release.
We recommend that you upgrade the ESXi
hypervisor before you begin an upgrade of
Unified Communications Manager or IM and
Presence Service; however, if your currently

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
53
 Change the Virtualization Software
Install and Configure VMware vCenter

Command or Action Purpose

installed version of these applications is not
compatible with the ESXi version required for
the new release, you can upgrade the ESXi
version after you upgrade the Cisco
applications.

Step 3 Download and Install OVA Templates, on page OVA files provide a set of predefined templates
55 for virtual machine configuration. They cover
items such as supported capacity levels and any
required OS/VM/SAN alignment.
This procedure is optional. If you are already
running Unified Communications Manager or
IM and Presence Service on a virtual machine,
and your deployment size has not changed, you
do not need to download and install a new OVA
template. If you are changing the size of your
system, download and install an OVA template
for the new release that is sized for your
deployment.

Step 4 Change Virtual Machine Configuration Use this procedure when you need to change
Specifications, on page 56 the vCPU, vRAM, vDisk size, or vNIC type on
your virtual machine (VM) in order to upgrade
to a new release of Unified Communications
Manager or IM and Presence Service.
Do this step for only for direct upgrades, which
use either the Unified CM OS Admin interface
or the PCD Upgrade task to perform the
upgrade.

Step 5 Migrate From Single to Multi-vDisk Virtual Use this procedure if you are migrating to a
Machine, on page 57 larger virtual machine (VM) deployment that
requires multiple vDisks.

Install and Configure VMware vCenter

Using VMware vCenter is optional when you deploy Unified Communications Manager or IM and Presence
Service on UC on UCS tested reference configuration hardware. VMware vCenter is mandatory when you
deploy on UC on UCS specs-based and third-party server specs-based hardware.
VMware vCenter allows you to collect performance data. For information about how to install and configure
the application, see the VMWare documentation.

Procedure

Step 1 Install VMware vCenter.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
54
 Change the Virtualization Software
Upgrade vSphere ESXi

Step 2 Set the level of detail tracked by the performance statistics. The statistics levels range from 1 to 4, with level
4 containing the most data. On a UCS specs-based or HP/IBM specs-based deployment, you must set the
statistics level to 4.
Step 3 View the data size estimates to ensure there is enough space to keep all statistics.

Upgrade vSphere ESXi

Use the following procedure when you need to update your vSphere ESXi hypervisor in order to upgrade to
a new release of Unified Communications Manager.

Procedure

Step 1 Move the virtual machine that is running Unified Communications Manager off the host server using one of
the following methods:
• If you have a hot standby host, use vMotion to migrate the virtual machine from one physical server to
another.
• If you do not have a hot standby host, power down the virtual machine and copy it to a different location.

Step 2 Upgrade the vSphere ESXi using the upgrade procedures provided by VMware.
Step 3 Verify that the vSphere ESXi upgraded successfully.
Step 4 Move the virtual machine that is running Unified Communications Manager back to the host server using one
of the following methods:
• If you have a hot standby host, use vMotion to migrate the virtual machine from one physical server to
another.
• If you do not have a hot standby host, power down the virtual machine and copy it the host server.

Download and Install OVA Templates

OVA files provide a set of predefined templates for virtual machine configuration. They cover items such as
supported capacity levels and any required OS/VM/SAN alignment. For information about OVA files, search
for the topic "Unified Communications Virtualization Sizing Guidelines" at https://www.cisco.com/c/dam/
en/us/td/docs/voice_ip_comm/uc_system/virtualization/cisco-collaboration-virtualization.html.
This procedure is optional. If you are already running Unified Communications Manager or IM and Presence
Service on a virtual machine, and your deployment size has not changed, you do not need to download and
install a new OVA template. If you are changing the size of your system, download and install an OVA
template that is sized for your deployment.

Procedure

Step 1 Locate the OVA template for your release:

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
55
 Change the Virtualization Software
Change Virtual Machine Configuration Specifications

• For Unified Communications Manager, go to https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_

comm/uc_system/virtualization/cisco-collaboration-virtualization.html and search for the topic
"Virtualization for Cisco Unified Communications Manager."
• For IM and Presence Service, go to https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/uc_
system/virtualization/cisco-collaboration-virtualization.html and search for the topic "Virtualization for
Unified CM IM and Presence."

Step 2 To download a single OVA file, click the Download File button next to that file. To download multiple OVA
files, click the Add to Cart button next to each file that you want to download, then click on the Download
Cart link.
Step 3 Click the Proceed with Download button on the Download Cart page.
Step 4 Read the information on the Software License Agreement page and click the Agree button.
Step 5 Click on one of the following links:
• Download Manager (requires Java)
• Non Java Download Option
A new browser window appears.
Step 6 Save the file:
• If you selected Download Manager, a Select Location dialog box appears. Specify the location where
you want to save the file, and click Open to save the file to your local machine.
• If you selected Non Java Download Option, click the Download link on the new browser window.
Specify the location and save the file to your local machine

Change Virtual Machine Configuration Specifications

Use the following procedure when you need to change the vCPU, vRAM, vDisk, or vNIC on your virtual
machine (VM) in order to upgrade to a new release of Unified Communications Manager or IM and Presence
Service.
For information about VM requirements, see the Readme file with the OVA template that supports your
release. For details about OVA templates and requirements, go to www.cisco.com go virtualized-collaboration
and search on the topic "Implementing Virtualization Deployments."

Before you begin

If you need to increase the vDisk storage space, you must remove your Virtual Machine (VM) snapshots
before you being. Otherwise, the increase disk size option is greyed out. See Working with Snapshots.

Procedure

Step 1 Perform a Disaster Recovery System (DRS) backup.

Step 2 (Optional) For an upgrade from 9.x or earlier, if you need to increase the vDisk space to meet the space
requirements of a refresh upgrade, install the following COP file:
ciscocm.vmware-disk-size-reallocation-<latest_version>.cop.sgn

Step 3 Shut down the virtual machine.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
56
 Change the Virtualization Software
Migrate From Single to Multi-vDisk Virtual Machine

Step 4 Change the configuration of the virtual machine as needed:

a) Change the Guest OS version to match the requirements of the new release.
b) To change the vCPU, make the change in vSphere Client. Ensure that you change the reservation value
to match the specifications of the new release.
c) To change the vRAM, make the change in vSphere Client. Ensure that you change the reservation value
to match the specifications of the new release.
d) To increase the vDisk space, edit the storage size using vSphere Client. If the virtual machine has two
disks, expand the second one.
The new space is automatically added to the common partition when you restart the virtual machine.
Note You need to change the disk size changes only if you need additional space to complete the
upgrade. The disk space requirements are specified in the Readme file for the OVA template.
Expanding the disk size to add space to the common partition will not increase the user capacity
of your system. If you need to extend the user capacity of your system, you must migrate from
a single-disk to a multi-disk virtual machine.
If you need to shrink the vDisk or change the vDisk quantity, you must re-install the vDisk or
install a new vDisk.

e) In vSphere Client, verify that the Network Adapter is configured to use the VMXNET 3 Adapter type. If
the Network Adapter is set to a different type, modify it.
For more information about making configuration changes using vSphere Client, refer to the user manual for
the product.

Step 5 Proceed with the upgrade and then power on the virtual machine.

Migrate From Single to Multi-vDisk Virtual Machine

If you are migrating to a larger virtual machine (VM) deployment that requires multiple vDisks, perform the
following procedure. After you complete this procedure, you must Change Virtual Machine Configuration
Specifications, on page 56 to ensure that the specifications match the requirements of the release.

Procedure

Step 1 Use the Disaster Recovery System (DRS) to perform a backup of the existing virtual machine (VM).
Step 2 Power off the existing VM and remove it from the network.
Step 3 Deploy a new VM at the correct user count using the appropriate OVA template.
Step 4 Perform a fresh installation of the same software release of IM and Presence Service or Unified Communications
Manager on the new VM using the same hostname and IP address.
Step 5 Perform a DRS restore on the new VM.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
57
 Change the Virtualization Software
Migrate From Single to Multi-vDisk Virtual Machine

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
58
PA R T IV
Upgrade the Applications
• Pre-upgrade Tasks, on page 61
• Upgrade Procedures, on page 87
• Post-upgrade Tasks , on page 101
 CHAPTER 10
Pre-upgrade Tasks
• Pre-Upgrade Task Flow, on page 61

Pre-Upgrade Task Flow

Complete the following tasks before you begin an upgrade or migration.

Procedure

Command or Action Purpose

Step 1 Read the release notes for the new release: Ensure that you understand the new features
http://www.cisco.com/c/en/us/support/ and how the upgrade interacts with the other
unified-communications/ products that are associated with your system.
unified-communications-manager-callmanager/
Do this step for all upgrade and migration
products-release-notes-list.html
methods.

Step 2 Check that the software version you are You cannot install or run Unified
upgrading from is running on a virtual Communications Manager and the IM and
machine. If your current deployment is running Presence Service directly on server hardware;
on MCS hardware, see the Cisco Prime you must run these applications on virtual
Collaboration Deployment Administration machines.
Guide at http://www.cisco.com/c/en/us/
Do this step for all upgrade and migration
support/unified-communications/
methods.
unified-communications-manager-callmanager/
products-maintenance-guides-list.html for
information about how to migrate an existing
cluster to a virtualized cluster.
Step 3 Familiarize yourself with the requirements and Ensure that your system meets all
limitations of this release: Requirements and requirements, including network requirements,
Limitations, on page 17 platform requirements, and software
requirements.
Do this step for all upgrade and migration
methods.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
61
 Upgrade the Applications
Pre-Upgrade Task Flow

Command or Action Purpose

Step 4 Check the health of your network: The health of your system affects the amount
of time that an upgrade requires. You can
• Read Factors that Affect Upgrade Time
reduce the amount of time needed for an
Requirements, on page 41 and ensure
upgrade by ensuring that your system meets
that your system meets the conditions
the conditions described in these sections.
described in that section.
• Generate a Database Status Report, on Do this step for all upgrade and migration
page 67 methods.
• Check Database Replication, on page 67
• Check Performance Reports, on page 68
• Run CLI Diagnostics, on page 68

Step 5 Ensure that there are no expired certificates on Perform this step for refresh upgrades on
the partition, including any trust certificates in Unified Communications Manager and IM and
the certificate chain. If there are expired Presence Service nodes only. Expired
certificates, perform one or more of the certificates are not imported during a refresh
following procedures: upgrade. As a result, a new certificate is
generated during upgrade process and can
• Delete a Trust Certificate, on page 69
cause errors.
• Regenerate a Certificate, on page 69 if
an identify certificate is expired

Step 6 Take a Fresh Backup, on page 71 You must create a fresh backup file in case
you need to restore your existing system.
Do this step for all upgrade and migration
methods.
Caution You may lose data or you may be
unable to restore your system if
your backup is outdated.

Step 7 Back Up Custom Ringtones and Background If you have custom ringtones or background
Images, on page 72 images in the TFTP directory, you need to
create a separate backup for these files. They
are not included in the Disaster Recovery
System (DRS) backup file.

Step 8 Check Network Connectivity, on page 72 Use this procedure to verify connectivity
between Unified Communications Manager
nodes and services in your network, such as
NTP, SMTP, and DNS.

Step 9 Verify IPv6 Networking, on page 73 This procedure applies to Unified

Communications Manager nodes only. Verify
IPv6 networking on the first node (Unified
Communications Manager database publisher
node) and Unified Communications Manager
subscriber nodes. If IPv6 is configured
incorrectly on the Unified Communications

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
62
Upgrade the Applications
Pre-Upgrade Task Flow

Command or Action Purpose

Manager subscriber nodes, load detection may
take 20 minutes.
Do this step for all upgrade and migration
methods.

Step 10 Check Connectivity between IM and Presence Verify that the IM and Presence Service node
and Cisco Unified Communications Manager, has connectivity with Unified Communications
on page 73 Manager.
Do this step for only for direct upgrades, which
use either the Unified CM OS Admin interface
or the PCD Upgrade task to perform the
upgrade.

Step 11 Collect Configuration and Login Information, Record the current configuration and login
on page 74 information for your Unified Communications
Manager nodes in case any issues are
encountered during the upgrade process.

Step 12 Record the Registered Device Count, on page Use the Real Time Monitoring Tool (RTMT)
74 to capture the device count so that you can
verify your endpoints and resources after the
upgrade is complete. You can also use this
information to verify that you have not
exceeded the capacity of the virtual machine
(VM) that you are deploying.
Do this step for all upgrade and migration
methods.

Step 13 Record the Number of Assigned Users, on Record the number of assigned users on IM
page 75 and Presence Service so that you can verify
this information after the upgrade is complete.
Do this step for all upgrade and migration
methods.

Step 14 Record TFTP Parameters, on page 75 The upgrade process changes a TFTP
parameter. Record the current setting so that
you can reset the parameter after the upgrade
is complete.

Step 15 Record Enterprise Parameters, on page 76 Record the settings for Enterprise Parameters
on both Unified Communications Manager
nodes and IM and Presence Service nodes.
Some Enterprise Parameters exist on both
types of nodes and the settings that are
configured on Unified Communications
Manager nodes may overwrite the settings
configured on IM and Presence Service nodes
during an upgrade. Record the settings so that

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
63
 Upgrade the Applications
Pre-Upgrade Task Flow

Command or Action Purpose

you can restore them as needed after the
upgrade is complete.
Do this step for all upgrade and migration
methods.

Step 16 Export User Records, on page 76 Export user records using the Bulk
Administration Tool (BAT).
Do this step for all upgrade and migration
methods.

Step 17 Upgrade IP Phone Firmware, on page 77 You can upgrade your IP phones to the
firmware that corresponds to the new release
as a pre-upgrade task. Although IP phones
automatically download their new firmware
after an upgrade, you can choose to apply new
firmware files to the endpoints in a controlled
manner before the upgrade in order to
minimize phone downtime after an upgrade.
Do this step for only for direct upgrades, which
use either the Unified CM OS Admin interface
or the PCD Upgrade task to perform the
upgrade.

Step 18 Verify Critical Services, on page 77 Verify that all critical services are activated.

Step 19 Deactivate Cisco Extension Mobility, on page Perform this procedure only if you are
78 upgrading from Release 9.x or earlier. For
upgrades from Release 9.x or earlier, you must
stop Cisco extension mobility services on
Unified Communications Manager nodes
before you begin an upgrade.
Do this step for only for direct upgrades, which
use either the Unified CM OS Admin interface
or the PCD Upgrade task to perform the
upgrade.

Step 20 Stop the IM and Presence Sync Agent, on page If you need to upgrade Unified
78 Communications Manager as part of your IM
and Presence Service upgrade, you must stop
the IM and Presence Service Sync Agent
service before you begin the upgrade process.
Do this step for only for direct upgrades, which
use either the Unified CM OS Admin interface
or the PCD Upgrade task to perform the
upgrade.

Step 21 Check the Available Common Partition Space, Verify that you have enough common partition
on page 79 space for the upgrade. Typically, you need at

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
64
Upgrade the Applications
Pre-Upgrade Task Flow

Command or Action Purpose

least 25G of common partition space; however,
your deployment may require more space if
you have a lot of TFTP data (device firmware
loads), music-on-hold (MOH) files, or if you
have many locale files installed.
Do this step for only for direct upgrades, which
use either the Unified CM OS Admin interface
or the PCD Upgrade task to perform the
upgrade.

Step 22 If you do not have enough common partition Do this step for only for direct upgrades, which
space, perform one or more of the following use either the Unified CM OS Admin interface
procedures: or the PCD Upgrade task to perform the
upgrade.
• Adjust High and Low Watermarks, on
page 79 Caution Performing an upgrade without
• Maximize Usable Disk Space, on page sufficient disk space can cause the
79 upgrade to fail.

Step 23 Obtain Upgrade Files, on page 81 Download the upgrade files for the Unified
Communications Manager and the IM and
Presence Service. For refresh upgrades, you
must also download the upgrade COP files.
Do this step for only for direct upgrades, which
use either the Unified CM OS Admin interface
or the PCD Upgrade task to perform the
upgrade.

Step 24 Ensure that you have the necessary license files Use the Cisco Prime License Manager to
for the new release. allocate and monitor the licenses for Unified
Communications Manager, its applications and
endpoints. See the Cisco Prime License
Manager User Guide at http://www.cisco.com/
c/en/us/support/cloud-systems-management/
prime-license-manager/
products-user-guide-list.html for information
about generating and installing licenses.
Do this step for all upgrade and migration
methods.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
65
 Upgrade the Applications
Pre-Upgrade Task Flow

Command or Action Purpose

Note Apply all pre-9.0 licenses to
Unified Communications Manager
before you upgrade to Release 9.0
or later software. After you upgrade
to Release 9.0 or later software, you
cannot apply these licenses to
Unified Communications Manager
and you cannot apply them using
the Cisco Prime License Manager.
Ensure that you install all unused
licenses or Product Authorization
Keys (PAKs) before you upgrade
the system. The Unified
Communications Manager displays
a warning to prompt you to install
any unused licenses before
proceeding.

Step 25 Increase the Database Replication Timeout, Optional. This procedure applies to the Unified
on page 83 Communications Manager publisher node only.
Use this procedure when you upgrade large
clusters. If you increase the database
replication timeout, you must restore the
timeout to the default value after the entire
cluster upgrades and the Unified
Communications Manager subscriber nodes
have successfully set up replication.
Do this step for only for direct upgrades, which
use either the Unified CM OS Admin interface
or the PCD Upgrade task to perform the
upgrade.

Step 26 Disable High Availability on Presence This procedure applies to IM and Presence
Redundancy Groups, on page 83 Service nodes only. If you have configured
presence redundancy groups for high
availability, you must disable it during the
upgrade process.
Do this step for only for direct upgrades, which
use either the Unified CM OS Admin interface
or the PCD Upgrade task to perform the
upgrade.

Step 27 Add a Serial Port to the Virtual Machine, on Add a serial port to the virtual machine so that
page 84 you can dump logs if an upgrade fails. Perform
this procedure for all nodes.
Do this step for all upgrade and migration
methods.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
66
 Upgrade the Applications
Generate a Database Status Report

Command or Action Purpose

Step 28 Database Migration Required for Upgrades This procedure applies to IM and Presence
with Microsoft SQL Server, on page 84 Service nodes only. 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.

Generate a Database Status Report

Use Cisco Unified Reporting Tool (CURT) to generate a Database Status Report to verify that there are no
network issues between cluster nodes. For example, verify that there are no issues with reachability or latency
that affect database replication between nodes or that affect quality of service (QoS) for voice and video
signaling.

Procedure

Step 1 Log in to the reporting interface for the node:

• For Unified CM nodes, log in to the Cisco Unified Reporting interface.
• For IM and Presence nodes, log in to the Cisco Unified IM and Presence Reporting interface.

Step 2 Select System Reports.

Step 3 Check database replication on the node:
• For Unified CM, select Unified CM Database Status.
• For IM and Presence, select IM and Presence Database Status.

Step 4 Click the Generate Report (bar chart) icon in the Reports window.
Step 5 Click the View Details link to expose details for a section that does not automatically appear.
Step 6 If the report indicates that there are errors, select the Report Descriptions report and review the troubleshooting
information with possible remedies.

Check Database Replication

Use this procedure to verify that the database replication is functioning correctly before you begin an upgrade.

Procedure

Step 1 Start a CLI session using one of the following methods:

• From a remote system, use SSH to connect securely to the Cisco Unified Operating System. In your SSH
client, enter your ssh adminname@hostname and enter your password.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
67
 Upgrade the Applications
Check Performance Reports

• From a direct connection to the serial port, enter your credentials at the prompt that displays automatically.

Step 2 Execute the utils dbreplication status command to check for errors or mismatches in the database tables.
Step 3 Execute the utils dbreplication runtimestate command to check if the database replication is active on the
node.
The output lists all the nodes and if database replication is set up and in a good state, the replication setup
value for each node is 2.
If a value other than 2 is returned, you must resolve the errors before proceeding.

Check Performance Reports

Procedure

Step 1 From the Cisco Unified Serviceability interface, select Tools > Serviceability Reports Archive.
Step 2 Click on the link and choose the most recent report.
Step 3 Click the CallActivitiesRep to open the Call Activities Report in a new tab and verify that the number of
Calls Attempted is not too high for the capacity of the virtual machine. You can determine the threshold for
the number of Calls Attempted by checking the recommendations for your system in the Cisco Collaboration
Systems Solution Reference Network Designs (SRND) at https://www.cisco.com/c/en/us/support/
unified-communications/unified-communications-system/products-implementation-design-guides-list.html.
Step 4 Return to the Cisco Unified Serviceability interface and click the PerformanceRep link for each node to view
the Performance Protection Statistics Reports.
Step 5 In each Performance Protection Statistics Report, verify that your system does not exceed the cluster-wide or
per-node limits that are specified for your deployment size.
For information about deployment sizing, see:
• Cisco Collaboration Systems Solution Reference Network Designs (SRND) at https://www.cisco.com/c/
en/us/support/unified-communications/unified-communications-system/
products-implementation-design-guides-list.html.
• Collaboration Sizing Tool at http://tools.cisco.com/cucst. Partners can use this tool to evaluate a customer's
configuration.

Run CLI Diagnostics

Use the command line interface (CLI) diagnostic commands to diagnose and solve network problems before
you begin and upgrade.

Procedure

Step 1 Start a CLI session using one of the following methods:

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
68
 Upgrade the Applications
Delete a Trust Certificate

• From a remote system, use SSH to connect securely to the Cisco Unified Operating System. In your SSH
client, enter your ssh adminname@hostname and enter your password.
• From a direct connection to the serial port, enter your credentials at the prompt that displays automatically.

Step 2 Execute the utils diagnose test command.

This command runs all diagnostic commands but does not attempt to fix problems. You can view a list of all
the diagnostic commands by executing the utils diagnose list command.

Step 3 Execute the utils diagnose fix command to attempt to automatically fix system problems.

Delete a Trust Certificate

A trusted certificate is the only type of certificate that you can delete. You cannot delete a self-signed certificate
that is generated by your system.

Caution Deleting a certificate can affect your system operations. It can also break a certificate chain if the certificate
is part of an existing chain. Verify this relationship from the username and subject name of the relevant
certificates in the Certificate List window. You cannot undo this action.

Procedure

Step 1 From Cisco Unified OS Administration, choose Security > Certificate Management.
Step 2 Use the Find controls to filter the certificate list.
Step 3 Choose the filename of the certificate.
Step 4 Click Delete.
Step 5 Click OK.
Note • If you delete the , “tomcat-trust”, “CallManager-trust”, or “Phone-SAST-trust” certificate type,
the certificate is deleted across all servers in the cluster.

Regenerate a Certificate
Before you begin an upgrade, ensure that there are no expired certificates on the partition, including any trust
certificates in the certificate chain. Regenerate a certificate if it is expired. Follow this procedure after business
hours, because you must restart phones and reboot services. You can regenerate only a certificate that is listed
as type “cert” in Cisco Unified OS Administration.

Caution Regenerating a certificate can affect your system operations. Regenerating a certificate overwrites the existing
certificate, including a third-party signed certificate if one was uploaded.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
69
 Upgrade the Applications
Certificate Names and Descriptions

Procedure

Step 1 From Cisco Unified OS Administration, choose Security > Certificate Management.
Enter search parameters to find a certificate and view its configuration details. The system displays the records
that match all the criteria in the Certificate List window.
Click Regenerate button in certificate details page, a self-signed certificate with the same key length is
regenerated.
Note When regenerating a certificate, the Certificate Description field is not updated until you close
the Regeneration window and open the newly generated certificate.

Click Generate Self-Signed Certificate to regenerate a self-signed certificate with a new key length of 3072
or 4096.

Step 2 Configure the fields on the Generate New Self-Signed Certificate window. See online help for more
information about the fields and their configuration options.
Step 3 Click Generate.
Step 4 Restart all services that are affected by the regenerated certificate.
Step 5 Update the CTL file (if configured) after you regenerate the CAPF, ITLRecovery Certificates or CallManager
Certificates.
Note After you regenerate certificates, you must perform a system backup so that the latest backup contains
the regenerated certificates. If your backup does not contain the regenerated certificates and you
perform a system restoration task, you must manually unlock each phone in your system so that the
phone can register.

What to do next
After you regenerate certificates, you must perform a system backup so that the latest backup contains the
regenerated certificates.
Related Topics
Certificate Names and Descriptions, on page 70

Certificate Names and Descriptions

The following table describes the system security certificates that you can regenerate and the related services
that must be restarted. For information about regenerating the TFTP certificate, see the Cisco Unified

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
70
 Upgrade the Applications
Take a Fresh Backup

Communications Manager Security Guide at http://www.cisco.com/c/en/us/support/unified-communications/

unified-communications-manager-callmanager/products-maintenance-guides-list.html.

Table 16: Certificate Names and Descriptions

Name Description Related Services

tomcat This certificate is used by Cisco Tomcat Services, Cisco

WebServices, Cisco DRF Services, CallManager Service.
tomcat-ECDSA
and Cisco CallManager Services
when SIP Oauth mode is enabled.

CallManager This is used for SIP, SIP trunk, CallManager - NA

SCCP, TFTP etc.
CallManager-ECDSA CallManager-ECDSA - Cisco
CallManager Service

CAPF Used by the CAPF service running N/A

on the Unified Communications
Manager Publisher. This certificate
is used to issue LSC to the
endpoints (except online and offline
CAPF mode)

TVS This is used by Trust verification N/A

service, which acts as a secondary
trust verification mechanism for the
phones in case the server certificate
changes.

Note A new enterprise parameter Phone Interaction on Certificate Update under section Security Parameter is
introduced to reset phones either manually or automatically as applicable when one of the TVS, CAPF, or
TFTP certificates are updated. This parameter is by default set to reset the phones automatically.

Take a Fresh Backup

You must backup the system before you perform an upgrade to ensure that the backup file matches the
currently-installed software exactly. If you try to restore the system from a backup file that does not match
the current version, the restore will fail.
Perform this procedure for all upgrade and migration methods.

Caution You may lose data or you may be unable to restore your system if your backup is outdated.

Before you begin

• Ensure that you use a network device as the storage location for the backup files. Virtualized deployments
of Unified Communications Manager do not support the use of tape drives to store backup files.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
71
 Upgrade the Applications
Back Up Custom Ringtones and Background Images

• Ensure that your system meets the version requirements:

• All Unified Communications Manager cluster nodes must be running the same version of the Unified
Communications Manager application.
• All IM and Presence Service cluster nodes must be running the same version of the IM and Presence
Service application.

For each application, the entire version string must match. For example, if the IM and Presence database
publisher node is at version 11.5.1.10000-1, then all IM and Presence subscriber nodes must be
11.5.1.10000-1, and you must create a backup file for version 11.5.1.10000-1.
• The backup process can fail due to non availability of space on a remote server or due to interruptions
in the network connectivity. You need to start a fresh backup after addressing the issues that caused the
backup to fail.
• Make sure that you have a record of the cluster security password. If the cluster security password changes
after you complete this backup, you will need to know the password or you will not be able to use the
backup file to restore your system.

Procedure

Step 1 From the Disaster Recovery System, select Backup > Manual Backup.
Step 2 In the Manual Backup window, select a backup device from the Backup Device Name area.
Step 3 Choose a feature from the Select Features area.
Step 4 Click Start Backup.

Back Up Custom Ringtones and Background Images

If you have custom ringtones or background images in the TFTP directory, you need to create a separate
backup for these files. They are not included in the Disaster Recovery System (DRS) backup file.

Procedure

Step 1 Use a web browser or TFTP client to access the directories where the ringtones and background images are
stored.
Step 2 Backup the following files: Ringlist.xml and List.xml .
Step 3 Back up the custom ringtones. These are located in the TFTP directory.
Step 4 Back up the background images. These are located in the folder /Desktops (and its subfolders) in the TFTP
directory.

Check Network Connectivity

Use this procedure to verify connectivity between all nodes and services in your network.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
72
 Upgrade the Applications
Verify IPv6 Networking

Procedure

Step 1 Start a CLI session using one of the following methods:

• From a remote system, use SSH to connect securely to the Cisco Unified Operating System. In your SSH
client, enter your ssh adminname@hostname and enter your password.
• From a direct connection to the serial port, enter your credentials at the prompt that displays automatically.

Step 2 Execute the show network cluster command on each node in your network to verify communication between
Unified Communications Manager servers in the cluster.
Step 3 If you have an NTP server, execute the utils ntp status command to verify connectivity to the NTP server.
Step 4 If you have an SMTP server, ping the server to verify connectivity.
Step 5 If you are using DNS, execute the show network eth0 command on each node in your network to verify that
the DNS and domain are configured.
Step 6 Check that DNS name resolution is working correctly:
a) Ping the FQDN of each Unified Communications Manager node to ensure that it resolves to the IP address.
b) Ping the IP address of each Unified Communications Manager to ensure that it resolves to the FQDN.

Verify IPv6 Networking

This procedure applies to Unified Communications Manager nodes only.
Verify that IPv6 networking on the first node (Unified Communications Manager database publisher node)
and Unified Communications Manager subscriber nodes. If IPv6 is configured incorrectly on the Unified
Communications Manager subscriber nodes, load detection may take 20 minutes.

Procedure

Step 1 Start a CLI session using one of the following methods:

• From a remote system, use SSH to connect securely to the Cisco Unified Operating System. In your SSH
client, enter your ssh adminname@hostname and enter your password.
• From a direct connection to the serial port, enter your credentials at the prompt that displays automatically.

Step 2 Execute the following command:utils network ipv6 pingdestination [count]

• destination is a valid IPv6 address or host name that you want to ping
• count is the number of times to ping the external server. The default is 4.

Check Connectivity between IM and Presence and Cisco Unified

Communications Manager
Verify that the IM and Presence Service service node has connectivity with Unified Communications Manager.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
73
 Upgrade the Applications
Collect Configuration and Login Information

Procedure

Step 1 From the Cisco Unified CM IM and Presence Administration interface, select Diagnostics > System
Troubleshooter .
The system automatically runs a troubleshooting check.
Step 2 When the results of the troubleshooting check are loaded, verify that all of the Sync Agent Troubleshooter
tests have a green checkmark in the Outcome column to indicate that the test was passed.
Step 3 If any of the Sync Agent Troubleshooter tests are failed, use the information in the Problem and Solution
columns to resolve the issue before continuing with the upgrade process.

Collect Configuration and Login Information

Record the current configuration and login information for your Unified Communications Manager nodes in
case any issues are encountered during the upgrade process.

Procedure

Step 1 Record the following login and password information:

• all application users credentials, such as DRS, AXL, and accounts for other third-party integrations
• administrator, cluster security, and Certificate Trust List (CTL) security token passwords

Step 2 Record the following information about your network configuration:

• IP addresses, hostnames, gateways, domain names, DNS servers, NTP servers, the Call Detail Recording
(CDR) server, and SMTP information
• server versions and time zones
• services running on each server and the associated activation status
• LDAP information and access details
• SNMP information

Record the Registered Device Count

Use the Real Time Monitoring Tool (RTMT) to capture the device count before you begin an upgrade, so that
you can verify your endpoints and resources after the upgrade is complete. You can also use this information
to verify that you have not exceeded the capacity of the virtual machine (VM) that you are deploying.

Procedure

Step 1 From the Unified RTMT interface, select CallManager > Device > Device Summary.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
74
 Upgrade the Applications
Record the Number of Assigned Users

Step 2 Record the number of registered devices for each node:

Item Count
Registered Phones

FSX

FSO

T1 CAS

PRI

MOH

MTP

CFB

XCODE

Record the Number of Assigned Users

Record the number of assigned users on IM and Presence Service nodes so that you can verify this information
after the upgrade is complete.

Procedure

Step 1 From the Cisco Unified CM IM and Presence Administration interface, select System > Cluster Topology.
The Cluster Topology Details page displays information about nodes and subclusters.
Step 2 Record the number of users that are assigned to each node and cluster.

Record TFTP Parameters

During the upgrade process, the TFTP service parameter Maximum Serving Count is changed to allow for
an increased number of device registration requests. Record the existing settings so that you can reset the
parameter after the upgrade is complete.

Procedure

Step 1 From the Cisco Unified CM Administration interface, choose System > Service Parameters.
Step 2 From the Server drop-down list, select the node that is running the TFTP service.
Step 3 From the Service drop-down list, select Cisco TFTP service.
Step 4 Click Advanced.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
75
 Upgrade the Applications
Record Enterprise Parameters

Step 5 Click Save.

Step 6 Record the value that is configured for the Maximum Serving Count.

Record Enterprise Parameters

Record the settings for Enterprise Parameters on both Unified Communications Manager nodes and IM and
Presence Service Service nodes. Some Enterprise Parameters exist on both Unified Communications Manager
nodes and IM and Presence Service Service nodes. Where the same parameter exists, the settings that are
configured on Unified Communications Manager nodes overwrite the settings configured on IM and Presence
Service Service nodes during the upgrade process. Enterprise Parameters that are unique to IM and Presence
Service Service nodes are retained during an upgrade.
Record the settings so that you can restore them as needed after the upgrade is complete.

Procedure

Step 1 From the Cisco Unified CM Administration interface, choose System > Enterprise Parameters.
Step 2 Take screen captures to record the settings that you have configured, and save the information so that you can
restore the settings after the upgrade is complete.
Step 3 From the Cisco Unified CM IM and Presence Administration interface, choose System > Enterprise
Parameters.
Step 4 Take screen captures to record the settings that you have configured, and save the information so that you can
restore the settings after the upgrade is complete.

Export User Records

Export user records using the Bulk Administration Tool (BAT).

Procedure

Step 1 From Cisco Unified CM Administration, choose Bulk Administration > Users > Export Users.
Step 2 Click Find to display all user records.
Step 3 Click Next.
Step 4 Enter a filename in the in the File Name text box and choose file format from the File Format drop-down
list.
Step 5 In the Job Information area, enter the Job description.
Step 6 Click Run Immediately to export user records immediately
Step 7 Click Submit.
Step 8 To download the exported file, choose Bulk Administration > Upload/Download Files.
Step 9 Enter search criteria for the file that you generated and click Find.
Step 10 Select the check box that corresponds to the file that you want to download and click Download Selected.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
76
 Upgrade the Applications
Upgrade IP Phone Firmware

Step 11 In the File Download pop-up window, click Save.

Step 12 In the Save As pop-up window, choose the location where you want to save the file and click Save. Ensure
that you copy the file off of the server and save it to a remote PC or device.

Upgrade IP Phone Firmware

You can upgrade your IP phones to the firmware that corresponds to the new release as a pre-upgrade task.
Although phones automatically download their new firmware after an upgrade, you can choose to apply new
firmware files to the endpoints in a controlled manner prior to the upgrade in order to minimize phone downtime
after an upgrade.
When you apply new firmware to phones in groups, you can eliminate the load on the TFTP server after the
upgrade and accelerate the upgrade of the individual devices. Afterwards, restart the TFTP service on the
Unified Communications Manager servers, and restart the IP Phones in a controlled order to minimize
downtime. Because the phones cannot be used for calls when their firmware is being upgraded, we recommend
that you use a maintenance window outside of your upgrade window to upgrade phone firmware.

Before you begin

• Copy the new firmware load to the following directory on the TFTP server: /usr/local/cm/tftp
• Make a record of the system defaults and per-device assignments for your IP phones and registered
endpoints.

Procedure

Step 1 From Cisco Unified OS Administration, choose Software Upgrades > Install/Upgrade.
Step 2 Fill in the applicable values in the Software Location section and click Next.
Step 3 In the Available Software drop-down list, select the device package file and click Next.
Step 4 Verify that the MD5 value is correct, and then click Next.
Step 5 In the warning box, verify that you selected the correct firmware, and then click Install.
Step 6 Check that you received a success message.
Note Skip to Step 8 if you are rebooting the cluster.

Step 7 Stop and restart the TFTP server.

Step 8 Reset the affected devices to upgrade the devices to the new load.
Step 9 From Cisco Unified CM Administration, choose Device > Device Settings > Device Defaults and manually
change the name of the "Load Information" and "Inactive Load Information" for the specific Device Type
fields for the new load on the TFTP server.
Step 10 Click Save, and then reset the devices.

Verify Critical Services

Use the Cisco Unified Real Time Monitoring Tool (RTMT) to verify that all critical services are activated.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
77
 Upgrade the Applications
Deactivate Cisco Extension Mobility

Procedure

Step 1 From the Unified RTMT interface, select System > Server > Critical Services.
Step 2 To display system critical services, click the System tab.
Step 3 To display Unified Communications Manager critical services, select a Unified Communications Manager
node from the drop-down list and click the Voice/Video tab.
Step 4 To display IM and Presence Service critical services, click the IM and Presence tab and select an IM and
Presence Service Service node from the drop-down list.
Step 5 If the status indicates that any critical services are stopped, reactivate them before beginning the upgrade.

Deactivate Cisco Extension Mobility

Perform this procedure only if you are upgrading from Release 9.x or earlier. For upgrades from Release 9.x
or earlier, you must stop Cisco extension mobility on Unified Communications Manager nodes before you
begin an upgrade.

Procedure

Step 1 From Cisco Unified Serviceability, choose Tools > Service Activation.
Step 2 From the Server list, choose the node on which you want to deactivate services and click Go.
Step 3 Deselect the Cisco Extension Mobility services.
Step 4 Click Stop.
Step 5 Repeat Steps 2 through 4 for each node that is running Cisco Extension Mobility services.
Step 6 Make a list of all the nodes on which you have disabled these services. You will need to restart the services
after the upgrade is complete.

Stop the IM and Presence Sync Agent

If you need to upgrade Unified Communications Manager as part of your IM and Presence Service upgrade,
you must stop the IM and Presence Service Sync Agent service before you begin the upgrade process.

Procedure

Step 1 From the Cisco Unified Serviceability interface, select Tools > Control Center - Network Services.
Step 2 Select an IM and Presence Service Service node from the Server drop-down list and click Go.
Step 3 In the IM and Presence Services section, select the Cisco Sync Agent and click Stop.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
78
 Upgrade the Applications
Check the Available Common Partition Space

Check the Available Common Partition Space

Use the Real-Time Monitoring Tool (RTMT) to verify that you have enough common partition space for the
upgrade.

Procedure

Step 1 In the Real-Time Monitoring Tool, select Disk Usage from the list of System counters on the left navigation
pane.
A page displays detailed information about disk usage.
Step 2 View the tables on the bottom of the page and compare the Total Space to the Used Space for the common
partition. You need a minimum 25G of available common partition space before you begin an upgrade.

Adjust High and Low Watermarks

Use this procedure to adjust the low and high watermarks to reduce the traces and remove unnecessary log
files. After the upgrade, you must restore the high and low watermarks to their original values in order to
avoid premature purging of traces. The default value for the high watermark is 85. The default value for the
low watermark is 80.

Procedure

Step 1 In the Real Time Monitoring Tool (RTMT) interface, double-click Alert Central in the left navigation pane.
Step 2 On the System tab, right-click LogPartitionLowWaterMarkExceeded and select Set Alert/Properties.
Step 3 Select Next.
Step 4 Adjust the slider value to 30.
Step 5 On the System tab, right-click LogPartitionHighWaterMarkExceeded and select Set Alert/Properties.
Step 6 Select Next.
Step 7 Adjust the slider value to 40.

Maximize Usable Disk Space

When you upgrade from 11.5(X) to 12.5, verify the COP files that are required to be downloaded. To download
the COP files and the Readme files, go to https://software.cisco.com and then, navigate to Unified
Communications > Call Control > Cisco Unified Communications Manager (CallManager) > <Version> >
Unified Communications Manager/CallManager/Cisco Unity Connection Utilities.
To create additional space in the common partition, you can perform one or more of the steps in this procedure.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
79
 Upgrade the Applications
Maximize Usable Disk Space

Note If your current version has previously used a serial connection to upgrade from a pre-11.5(x) version then it's
likely that have an older OS partitioning scheme and virtual disk layout. This will amplify "out of disk space"
issues, thereby limiting the effectiveness of adding additional virtual disk space. The upgrade readiness COP
file checks for these issues, and provides guidance on how to resolve them.

Procedure

Step 1 Manually remove outdated or unused firmware files from the TFTP directory using one of the following
options:
• From the Cisco Unified OS Administration interface, select Software Upgrades > TFTP File
Management and delete any unnecessary files.
• From the command line interface, use the file list tftp and file delete tftp commands delete
any unnecessary files.
• From the Cisco Unified OS Administration interface, select Software Upgrades > Device Load
Management and delete any unnecessary files.
Note Run the show diskusage tftp <sort> command, to check tftp device load size, which is sorted by
descending file size.
Run the show diskusage common <sort> command, to check the common partition size for
available, and free space, which is sorted by descending file size.

Step 2 Perform this step only if the previous steps did not create enough disk space for the upgrade. Use the Free
Common Space COP file (ciscocm.free_common_space_v<latest_version>.cop.sgn).
This COP file removes the inactive side in the common partition to increase available disk space without
requiring a system rebuild. Ensure that you review the Readme file that supports this COP file before you
proceed.
Note You will not be able to switch back to the inactive version after installing this file because the
inactive partition becomes unusable.

Note For 110G or 80G single disk or two 80G disk deployments, available space for upgrade should be
at least twice the active partition disk space. For example, in a two 80G disk deployment, active
partition should not be more than 25G, and available space should be at least 50G. Following are
commands to check the disk usage.
a. Run the show diskusage activelog <sort> command, to check active side partition size, which
is sorted by descending file size.
b. Run the show diskusage common <sort> command, to check the common partition size for
available, and free space, sorted by descending file size.
c. Run the show diskusage tftp <sort> command, to check tftp device load size, which is sorted
by descending file size.
d. Run the file delete activelog <filename> command, to delete logs from active partition.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
80
 Upgrade the Applications
Obtain Upgrade Files

Obtain Upgrade Files

You must download the upgrade file for the new release, as well as any upgrade Cisco Option Package (COP)
files that are required.

Procedure

Step 1 Refer to the table below this procedure to identify the COP files, if any, that you need.
Step 2 Download the upgrade files for the applications from Cisco.com. The software is available in export restricted
(K9) and export unrestricted versions (XU), so be sure to confirm that you select the correct file.
• To download the Unified Communications Manager upgrade file, go to https://software.cisco.com and
then, navigate to Unified Communications > Call Control > Cisco Unified Communications Manager
(CallManager) > <Version> > Unified Communications Manager/CallManager/Cisco Unity
Connection Updates.
• To download the IM and Presence Service Service upgrade file, go to https://software.cisco.com and
then, navigate to Unified Communications > Unified Communications Applications > Presence
Software > Unified Communications Manager IM and Presence Service > <Version> > Unified
Presence Service (CUP) Updates.

Step 3 Go to https://software.cisco.com and then, navigate to Unified Communications > Call Control > Cisco
Unified Communications Manager (CallManager) > <Version> > Unified Communications
Manager/CallManager/Cisco Unity Connection Utilities to download COP files for Unified Communications
Manager.
Step 4 Go to https://software.cisco.com and then, navigate to Unified Communications > Unified Communications
Applications > Presence Software > Unified Communications Manager IM and Presence Service >
<Version> > Unified Presence Service (CUP) Updates and select UTILS to download COP files for IM
and Presence Service.

COP Files Required for Upgrades to Release 11.5

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.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
81
 Upgrade the Applications
COP Files Required for Upgrades to Release 11.5

Table 17: Required COP Files for Upgrades and Migrations to Cisco Unified Communications Manager Release 11.5(x)

From To Upgrade Type

8.6(x) 11.5(x) Refresh upgrade. Required COP files:
• ciscocm.version3-keys.cop.sgn
To install the COP file, see CUCM RSA Version-3 keys
COP file .

Optional COP files:

• ciscocm.vmware-disk-size-reallocation-<latest_version>.cop.sgn)
• ciscocm.free_common_space_v<latest_version>.cop.sgn

9.1(x) 11.5(x) Refresh upgrade. Required COP files:

• ciscocm.version3-keys.cop.sgn
To install the COP file, see CUCM RSA Version-3 keys
COP file .

Optional COP files:

• ciscocm.vmware-disk-size-reallocation-<latest_version>.cop.sgn)
• ciscocm.free_common_space_v<latest_version>.cop.sgn

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.

Table 18: Required COP Files for Refresh Upgrades from Cisco Unified Presence Releases

From Cisco Unified To IM and Presence Upgrade Type

Presence Release Release
8.5(4) through 8.6(1) 11.5(x) Refresh upgrade. Requires the following COP files:
• cisco.com.cup.refresh_upgrade_v<latest_version>.cop
• ciscocm.version3-keys.cop.sgn

Table 19: Required COP Files for Refresh Upgrades from IM and Presence Service Releases

From IM and To IM and Presence Upgrade Type

Presence Release Release

9.1(x) 11.5(x) Refresh upgrade. Requires the following COP file:

• ciscocm.version3-keys.cop.sgn

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
82
 Upgrade the Applications
Increase the Database Replication Timeout

From IM and To IM and Presence Upgrade Type

Presence Release Release

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.

Increase the Database Replication Timeout

Perform this procedure on the Unified Communications Manager publisher node only.
Increase the database replication timeout value when you upgrade large clusters so that more Unified
Communications Manager subscriber nodes have sufficient time to request replication. When the timer expires,
the first Unified Communications Manager subscriber node, plus all other Unified Communications Manager
subscriber nodes that requested replication within that time period, begin a batch data replication with the
Unified Communications Manager database publisher node.

Procedure

Step 1 Start a CLI session using one of the following methods:

• From a remote system, use SSH to connect securely to the Cisco Unified Operating System. In your SSH
client, enter your ssh adminname@hostname and enter your password.
• From a direct connection to the serial port, enter your credentials at the prompt that displays automatically.

Step 2 Execute the utils dbreplication setrepltimeout timeout command, where timeout is database replication
timeout, in seconds. Ensure that the value is between 300 and 3600.
The default database replication timeout value is 300 (5 minutes).

Disable High Availability on Presence Redundancy Groups

This procedure applies to IM and Presence Service Service nodes only. Use it to disable high availability on
the IM and Presence Service presence redundancy group.

Before you begin

Take a record of the number of active users for each cluster node in each Presence Redundancy Group. You
can find this information in the (System > Presence Topology) window of Cisco Unified CM IM and Presence
Administration. You will need this information later when you re-enable High Availability.

Procedure

Step 1 From the Cisco Unified CM Administration user interface, choose System > Presence Redundancy Groups.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
83
 Upgrade the Applications
Add a Serial Port to the Virtual Machine

Step 2 Click Find and select the group.

Step 3 On the Presence Redundancy Group Configuration window, uncheck the Enable High Availability check
box.
Step 4 Click Save.
Step 5 Repeat this procedure for each Presence Redundancy Group.
Step 6 When you are done, wait at least two minutes to sync the new HA settings across the cluster before you make
any further changes

Add a Serial Port to the Virtual Machine

Add a serial port to the virtual machine so that you can dump logs in the event of an upgrade failure.

Procedure

Step 1 Power off the virtual machine.

Step 2 Edit the settings to add a serial port. For more information about making configuration changes using vSphere
Client, refer to the user manual for the product.
Step 3 Attach the serial port to a .tmp file.
Step 4 Power on the virtual machine and proceed with the upgrade.

What to do next
After you successfully upgrade the system, follow the procedure to Remove the Serial Port, on page 104. In
the event of an upgrade failure, refer to Dump a Log File After an Upgrade Failure, on page 119.

Database Migration Required for Upgrades with Microsoft SQL Server

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

Before you begin

The database migration depends on the MSSQL_migrate_script.sql script. Contact Cisco TAC to
obtain a copy.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
84
Upgrade the Applications
Database Migration Required for Upgrades with Microsoft SQL Server

Procedure

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:
a. "Microsoft SQL Installation and Setup"—See this chapter for details on how to create your new SQL
server database on your upgraded IM and Presence Service.
b. "IM and Presence Service External Database Setup"—After your new database is created, refer to this
chapter to add the database as an external database in the IM and Presence Service.

Step 3 Run the System Troubleshooter to confirm that there are no errors with the new database.
a. From Cisco Unified CM IM and Presence Administration, choose Diagnostics > System Troubleshooter.
b. Verify that no errors appear in the External Database Troubleshooter section.

Step 4 Restart the Cisco XCP Router on all IM and Presence Service cluster nodes:
a. From Cisco Unified IM and Presence Serviceability, choose Tools > Control Center - Network Services.
b. From the Server menu, select an IM and Presence Service node and click Go.
c. Under IM and Presence Services, select Cisco XCP Router, and click Restart.

Step 5 Turn off services that depend on the external database:

a. From Cisco Unified IM and Presence Serviceability, choose Tools > Control Center - Feature Services.
b. From the Server menu, select an IM and Presence node and click Go.
c. Under IM and Presence Services, select the following services:
Cisco XCP Text Conference Manager
Cisco XCP File Transfer Manager
Cisco XCP Message Archiver
d. Click Stop.

Step 6 Run the following script to migrate data from the old database to the new database
MSSQL_migrate_script.sql.
Note Contact Cisco TAC to obtain a copy of this script.

Step 7 Run the System Troubleshooter to confirm that there are no errors with the new database.
a. From Cisco Unified CM IM and Presence Administration, choose Diagnostics > System Troubleshooter.
b. Verify that no errors appear in the External Database Troubleshooter section.

Step 8 Start the services that you stopped previously.

a. From Cisco Unified IM and Presence Serviceability, choose Tools > Control Center - Feature Services.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
85
 Upgrade the Applications
Database Migration Required for Upgrades with Microsoft SQL Server

b. From the Server menu, select an IM and Presence node and click Go.
c. Under IM and Presence Services, select the following services:
Cisco XCP Text Conference Manager
Cisco XCP File Transfer Manager
Cisco XCP Message Archiver
d. Click Start.

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.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
86
 CHAPTER 11
Upgrade Procedures
• Upgrade Overview, on page 87
• Before You Begin, on page 89
• Upgrade Task Flow, on page 90
• Upgrade the Applications, on page 90
• Version Switching, on page 93
• Switch to Previous Version, on page 96
• Verify that Database Replication is Functioning, on page 98
• Verify that Database Replication is Complete, on page 99

Upgrade Overview
Use the procedures in this chapter to perform an upgrade using the Unified CM OS Administration interface.

Note If you want to use Cisco Prime Collaboration Deployment to complete an upgrade or migration, refer to the
Cisco Prime Collaboration Deployment Administration Guide to set up an upgrade task or migration task.

Publisher Nodes and Subscriber Nodes

Within a cluster, there is a database publisher for each type of node that you install.
When you install Unified Communications Manager, the installation wizard prompts you to specify whether
the node you are installing is the first node in the cluster. The first Unified Communications Manager node
that you install becomes the publisher node, because it publishes the voice and video database to the other
Unified Communications Manager nodes in the cluster. All subsequent nodes in the cluster are called subscriber
nodes. Each subscriber node must be associated with the publisher node. You must set up all subscriber nodes
in the system topology on the publisher node before you install the software on the subscriber nodes.
When you install IM and Presence Service nodes, the first node that you install functions as the server for the
IM and Presence Service database. Because this node publishes the database for all of the IM and Presence
Service nodes in the cluster, it is referred to as the IM and Presence Service database publisher; however, you
must install this and all other IM and Presence nodes as subscribers of the Unified Communications Manager
publisher node. As with other subscriber nodes, you must add these in the system topology before you install
the software.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
87
 Upgrade the Applications
Understanding Version Switching

Understanding Version Switching

When you upgrade a node, the new software is installed as an inactive version. To activate the new software,
you must switch the node to the new software version. There are two ways to switch to the new software
version:
• Automatic switching—the system switches the version automatically as part of the upgrade process
• Manual switching—physically switch the version using the OS Administration interface after the upgrade
process is complete

The method that you choose depends on the type of upgrade that you are doing. During the upgrade process,
the wizard prompts you to choose whether to switch the software version automatically by rebooting to the
upgraded partition, or whether to switch the version manually at a later time. The table below lists the switching
method to use for each type of upgrade.

Upgrade type Switching type When prompted, Result

choose . . .

Standard Automatic GUI: Reboot to When you choose this option, the system reboots to
upgrade upgraded the new software version.
partition
CLI: Switch to
new version
after upgrade

Manual GUI: Do not When you choose this option, the system continues
reboot after to run the old software version when the upgrade is
upgrade complete. You can manually switch to the new
software later.
CLI: Do not
switch to new
version after
upgrade

Refresh upgrade Automatic GUI: Reboot to Choose this option to use the new software version
upgraded immediately following the upgrade.
partition
CLI: Switch to
new version
after upgrade

Manual GUI: Do not Use this option only if you are performing a refresh
reboot after upgrade in stages. When you choose this option the
upgrade system reboots to the old software version when the
upgrade is complete, and you can manually switch to
CLI: Do not
the new software later.
switch to new
version after
upgrade

When you switch versions, your configuration information migrates automatically to the upgraded version
on the active partition.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
88
 Upgrade the Applications
Before You Begin

If for any reason you decide to back out of the upgrade, you can restart the system to the inactive partition
that contains the older version of the software. However, any configuration changes that you made since you
upgraded the software will be lost.
For a short period of time after you install Unified Communications Manager or switch over after upgrading
to a different product version, any changes made by phone users may be lost. Examples of phone user settings
include call forwarding and message waiting indication light settings. This can occur because Unified
Communications Manager synchronizes the database after an installation or upgrade, which can overwrite
phone user settings changes.

Before You Begin

Caution Stop all configuration tasks. Do not make any configuration changes during an upgrade. For example, do not
change passwords, perform LDAP synchronizations, or run any automated jobs. Do not remove, re-add, or
reinstall any nodes in the cluster during the upgrade process. You can make configuration changes only when
you have completed the upgrade on all nodes and performed the post-upgrade tasks. Any configuration changes
that you make during an upgrade will be lost, and some configuration changes can cause the upgrade to fail.
We recommend that you suspend user synchronization with LDAP and do not resume synchronization until
you have completed the upgrade on all Unified Communications Manager nodes and all IM and Presence
Service Service nodes.

Caution During a Refresh Upgrade, traffic is no longer processed and several reboots are required, therefore, you must
perform a refresh upgrade during a maintenance window.

Note If you use RTMT as a monitoring tool and have a mega cluster deployment, Cisco recommends high-availability
setup for RTMT to avoid any connectivity loss during Simple Upgrade. Following are the steps to setup high
availability for RTMT Monitoring:
1. Login to CM Administration page.

2. Click System → Service Parameter.

3. Select any Unified Communications Manager node from server drop down.
4. Select Cisco AMC Service from Service drop down.
5. Select Primary Collector as any Subscriber node.
6. Select Failover Collector as any Subscriber node other than the node that is selected as Primary collector
and then click Save.
7. Connect RTMT to any Subscriber.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
89
 Upgrade the Applications
Upgrade Task Flow

Note During the switch version, only User Facing features (UFF) in dynamic tables (numplandynamic,
devicedynamic, and more) gets updated. Other tables are migrated during upgrade. Any configuration changes
after the upgrade or before the switch versions are lost.

Note The system checks for any existing phone service URLs during upgrade and automatically appends
“&EMCC=#EMCC#” if it does not added in the phone service URLs. As a result, any phones that do not
support EMCC may encounter issues trying to login to Extension Mobility. The appended
“&EMCC=#EMCC#” can be removed after upgrade if Unified Communications Manager contains any
legacy or third-party devices which does not support EMCC

Upgrade Task Flow

Procedure

Command or Action Purpose

Step 1 Upgrade the application using one of the Use these procedures when you upgrade Unified
following procedures: Communications Manager or the IM and
Presence Service using the Unified CM OS
• Upgrade from a Local Source, on page 90
Administration interface.
• Upgrade from a Remote Source, on page
92

Step 2 Switch the Software Version, on page 95 Use this procedure to activate the new software.

Step 3 Switch to Previous Version, on page 96 Use the procedures in this section if you need
to revert to the software version that was
running before the upgrade.

Step 4 Verify that Database Replication is Functioning,

on page 98
Step 5 Verify that Database Replication is Complete,
on page 99

Upgrade the Applications

Upgrade from a Local Source
Follow this procedure to upgrade to a new release of Unified Communications Manager or the IM and Presence
Service Service from a local source.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
90
Upgrade the Applications
Upgrade from a Local Source

Before you begin

Ensure that you have the correct ISO file for the upgrade. Upgrade files use the following naming convention:
• UCSInstall_CUP_<XXXXXXXX>.sgn.iso
• UCSInstall_UCOS_<XXXXXXXX>.sgn.iso
• Export unrestricted software has a XU license SKU.
• Export restricted software has a K9 license SKU.

Procedure

Step 1 Ensure that you can access the upgrade file. Choose one of the following options:
• Insert the CD or DVD into the disc drive on the local server that is to be upgraded.
• Create a data store ISO file on the local ESXi host.
• Create a data store ISO file on a storage area network (SAN) that is connected to the ESXi host.

Step 2 Log in to the management software for the node that you are upgrading:
• If you are upgrading an IM and Presence Service node, log in to Cisco Unified IM and Presence Operating
System Administration.
• If you are upgrading a Unified Communications Manager node, log in to Cisco Unified Communications
Operating System Administration.

Step 3 If you are performing a refresh upgrade that requires a COP file, install the required COP file.
If you are unsure whether you have to install a COP file, review the information about supported upgrade
paths. See the Related Topics section for more information.

Step 4 Select Software Upgrades > Install/Upgrade.

Step 5 Select DVD/CD from the Source list, or edit the virtual machine to map to the ISO file.
Step 6 In the Directory field, enter the path to the location of the patch file. If the file is in the root directory, enter
a slash (/).
Step 7 Enter your email address and IP address in the Email Notification and SMTP Server fields. This option
enables you to receive an email notification upon successful completion of the upgrade.
Note These fields are only visible for refresh upgrades.

Step 8 Select Next to continue the upgrade process.

Step 9 Select the upgrade version that you want to install and select Next.
Step 10 Monitor the progress of the download, which includes the filename and the number of megabytes that are
being transferred.
Step 11 When the download completes, verify the checksum value against the checksum for the file that you downloaded
from Cisco.com.
Step 12 Perform one of the following actions:
For standard upgrades:
• For a single-node deployment, if you want to install the upgrade and automatically reboot to the upgraded
software, select Reboot to upgraded partition.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
91
 Upgrade the Applications
Upgrade from a Remote Source

• For a multinode deployment, select Do not reboot after upgrade. This option allows you to install the
upgrade and later manually reboot to the upgraded software. For more information about how to manually
reboot the system and activate the upgrade, see the Related Topics section.

For refresh upgrades:

• Select Do not switch to new version after upgrade only if you perform a staged upgrade.
• Select Switch to new version after upgrade to remain on the new active software version.

Note For more information about the rules for switching during an upgrade, see Version Switching during
upgrade rules.

Step 13 Select Next.

Step 14 Select Finish when the installation completes.

Upgrade from a Remote Source

Follow this procedure to upgrade to a new release of Cisco Unified Communications Manager or the IM and
Presence Service Service using software from a network drive or remote node. The network drive or remote
node must run an SFTP/FTP server that is accessed by each node that you want to upgrade.

Before you begin

Ensure that you have the correct ISO file for the upgrade. Upgrade files use the following naming convention:
• UCSInstall_CUP_<XXXXXXXX>.sgn.iso
• UCSInstall_UCOS_<XXXXXXXX>.sgn.iso
• Export unrestricted software has a XU license SKU.
• Export restricted software has a K9 license SKU.

Procedure

Step 1 Ensure that you can access the FTP/SFTP server where you stored the upgrade file.
Step 2 Log in to the management software for the node that you are upgrading:
• If you are upgrading an IM and Presence Service node, log in to Cisco Unified IM and Presence Operating
System Administration.
• If you are upgrading a Unified Communications Manager node, log in to Cisco Unified Communications
Operating System Administration.

Step 3 If you are performing a refresh upgrade that requires a COP file, install the required COP file.
If you are unsure whether you have to install a COP file, review the information about supported upgrade
paths. See the Related Topics section for more information.

Step 4 Select Software Upgrades > Install/Upgrade.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
92
 Upgrade the Applications
Version Switching

Step 5 Select Remote Filesystem from the Source list.

Step 6 In the Directory field, enter the path to the patch file on the remote system.
Step 7 In the Server field, enter the FTP or SFTP server name.
Step 8 In the User Name field, enter the username for the remote node.
Step 9 In the User Password field, enter the password for the remote node.
Step 10 Enter your email address and IP address in the Email Notification and SMTP Server fields. This option
enables you to receive an email notification upon successful completion of the upgrade.
Note These fields are only visible for refresh upgrades.

Step 11 From the Transfer Protocol field, select the transfer protocol, for example, SFTP.
Step 12 Select Next to continue the upgrade process.
Step 13 Select the upgrade version that you want to install and select Next.
Step 14 When the download completes, verify the checksum value against the checksum for the file that you downloaded
from Cisco.com.
Step 15 Perform one of the following actions:
For standard upgrades:
• If this is a single-node deployment and you want to install the upgrade and automatically reboot to the
upgraded software, select Reboot to upgraded partition.
• If this is a multinode deployment, select Do not reboot after upgrade.This option allows you to install
the upgrade and then manually reboot to the upgraded software later. For more information about how
to manually reboot the system and activate the upgrade, see the Related Topics section.

For refresh upgrades:

• Select Do not switch to new version after upgrade only if you are performing a staged upgrade.
• Select Switch to new version after upgrade to remain on the new active software version.

Note See the topic called Version switching during upgrade rules for more information about the rules
for switching during an upgrade.

Step 16 Select Next.

Step 17 Select Finish when the installation completes.

Version Switching
A number of rules apply when you are manually switching versions and when you switch versions during an
upgrade. The table below outlines the version switching rules for activating the release 10.x software version
and for switching back to a previous software version.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
93
 Upgrade the Applications
Version Switching

Note You cannot switch the version of any node if doing so violates the version matching requirements. This rule
applies whether you are switching forward to a new software version, or switching back to a previous software
version.

Product Node type Switch from Switch to Switching rule

Activate the new software version

Unified CM Publisher 8.x or 9.x 11.x You must switch the software version on the
publisher node before you switch the software
10.x 11.x version on subscriber nodes.

Unified CM Subscriber 8.x or 9.x 11.x Supported when the publisher node has been
switched to the new version. The software
10.x 11.x version you are switching to must match the
version number of the active partition on the
Unified Communications Manager publisher
node.

IM and Database 8.x or 9.x 11.x Supported when the software version you are
Presence publisher switching to matches the major and minor
10.x 11.x version number of active partition on
theUnified Communications Manager
publisher node.

IM and Subscriber 8.x or 9.x 11.x Supported when the software version of this
Presence node matches the five version numbers of the
10.x 11.x IM and Presence Service database publisher
node.

Switch back to a previous software version

Unified CM Publisher 11.x 8.x or 9.x Supported. You must switch the software
version on the publisher node before you
11.y 10.x switch the software version on subscriber
nodes.

Unified CM Subscriber 11.x 8.x or 9.x Supported when the Unified Communications
Manager publisher node has been switched to
11.y 10.x the previous version. The software version
you are switching to must match the version
number of the active partition on the Unified
Communications Manager publisher node.
You cannot switch a subscriber node to a
previous version when the publisher node is
running new version.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
94
 Upgrade the Applications
Switch the Software Version

Product Node type Switch from Switch to Switching rule

IM and Database 11.x 8.x or 9.x Not supported when the Unified
Presence publisher Communications Manager publisher node is
11.y 10.x running a software version that is newer than
the one that you are switching back to.
Switching the IM and Presence Service
database publisher node to a previous release
after the Unified Communications Manager
has been upgraded to a newer release violates
the version matching requirements.
Switching back to a previous release is
supported only when the software version you
are switching to matches the major and minor
version number of active partition on the
Unified Communications Manager publisher
node.

IM and Subscriber 11.x 8.x or 9.x Not supported when the IM and Presence
Presence Service database publisher node is running a
11.y 10.x software version that is newer than the one
that you are switching back to.
Switching back to a previous release is
supported only when the software version of
this node matches the five version numbers
of the IM and Presence Service database
publisher node.

Switch the Software Version

When you perform a standard upgrade, the new software is installed as an inactive version. You can reboot
to the new software during the upgrade process or you can switch to the new version later.
If you did not switch versions immediately after completing the upgrade, do so now. You must switch versions
so that the upgrade is complete and all nodes in the cluster are updated. Do not perform a backup until you
have switched to the new software version.
When you switch versions, the system restarts, and the inactive software becomes active. The system restart
may take up to 15 minutes. When you perform this procedure both the active and inactive software versions
are indicated.

Caution This procedure causes the system to restart and become temporarily out of service.

Before you begin

The software versions on Unified Communications Manager and IM and Presence Service nodes must match
according to the manual switching rules. Therefore, you must switch Unified Communications Manager before
you switch IM and Presence Service.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
95
 Upgrade the Applications
Switch to Previous Version

Review the information in Understanding Version Switching, on page 88

Procedure

Step 1 If you switch versions in a multinode deployment, you must switch the publisher node first.
Step 2 Log in to the management software for the node that you are upgrading:
• If you are upgrading an IM and Presence Service node, log in to Cisco Unified IM and Presence Operating
System Administration.
• If you are upgrading a Unified Communications Manager node, log in to Cisco Unified Communications
Operating System Administration.

Step 3 Select Settings > Version.

Step 4 Verify the version of the active software and the inactive software.
Step 5 Select Switch Versions to switch versions and restart the system.

After you perform a switch version when you upgrade Unified Communications Manager, IP phones request
a new configuration file. This request results in an automatic upgrade to the device firmware.

Switch to Previous Version

If you need to revert to the software version that was running before the upgrade, you can do so by using the
Switch Version option to switch the system to the software version on the inactive partition.

Switch Cluster to Previous Version

To switch a cluster back to a previous version, complete these high-level tasks:

Procedure

Step 1 Switch back the publisher node.

Step 2 Switch back all backup subscriber nodes.
Step 3 Switch back all primary subscriber nodes.
Step 4 If you are reverting to an older product release, reset database replication within the cluster.

Switch Node to Previous Version

Procedure

Step 1 Log in to the management software for the node that you are upgrading:

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
96
 Upgrade the Applications
Reset Database Replication

• If you are upgrading an IM and Presence Service node, log in to Cisco Unified IM and Presence Operating
System Administration.
• If you are upgrading a Unified Communications Manager node, log in to Cisco Unified Communications
Operating System Administration.

Step 2 Choose Settings > Version.

The Version Settings window displays.

Step 3 Click the Switch Versions button.

After you verify that you want to restart the system, the system restarts, which might take up to 15 minutes.

Step 4 To verify that the version switch was successful, follow these steps:
a) Log in again to the management software for the node that you are upgrading.
b) Choose Settings > Version.
The Version Settings window displays.
c) Verify that the correct product version is now running on the active partition.
d) Verify that all activated services are running.
e) For the publisher node, log in to Cisco Unified CM Administration.
f) Verify that you can log in and that your configuration data exists.

Reset Database Replication

If you switch back the servers in a cluster to run an older product release, you must manually reset database
replication within the cluster. To reset database replication after you revert all the cluster servers to the older
product release, enter the CLI command utils dbreplication reset all on the publisher server.
When you switch versions by using Cisco Unified Communications Operating System Administration or the
CLI, you get a message that reminds you about the requirement to reset database replication if you are reverting
to an older product release.

Switch version back to Cisco Unified Presence 8.6(3) or earlier

Cisco Unified Presence releases 8.6(4) and later do not support the Cisco Presence Engine database. If you
upgrade from Release 8.6(3) or earlier and you subsequently want to revert to the previous release, you must
install a COP file that will reinstall the Cisco Presence Engine database. The COP filename is
ciscocm.cup.pe_db_install.cop and you can download it from Cisco.com.

Note In a multinode environment, you must install the COP file on every node in the cluster after you switch versions
from Cisco Unified Presence Release 8.6(4) or later.

In this release, you cannot downgrade to a version earlier than Release 8.6(3).

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
97
 Upgrade the Applications
Verify that Database Replication is Functioning

Note You must restart the system after you install the COP file.

Before you begin

Switch versions on Unified Communications Manager.

Procedure

Step 1 Download the following COP file from Cisco.com: ciscocm.cup.pe_db_install.cop.

Step 2 Sign in to Cisco Unified IM and Presence Operating System Administration.
Step 3 Select Settings > Version.
Step 4 Verify the version of the active and inactive software.
Note This procedure only applies if you want to switch from Release 9.0 or later back to a release earlier
than 8.6(4).

Step 5 Select Switch Versions to switch back to the earlier release and restart the system.
Step 6 After the system has restarted, install the COP file.
Note In a multinode environment, you must install the COP file on every node in the cluster.

Step 7 After you have installed the COP file, manually restart the system. To do this, select Settings > Version and
select Restart.
Step 8 Run the following CLI command (on the publisher or subscriber node) to check if the database replication is
active on the node: utils dbreplication runtimestate
If database replication is active on all nodes, the output lists all the nodes and the replication setup value for
each node is 2. If database replication is not complete (a value other than 2 is returned), core services will not
start on the subscriber node until replication is complete.

Step 9 Select Cisco Unified CM IM and Presence Administration > System > Notifications to determine whether
database replication is complete.
Step 10 If database replication cannot be established, use the following CLI command on the publisher node to reset
replication: utils dbreplication reset all

Verify that Database Replication is Functioning

Use Cisco Unified Reporting to generate Database Status reports for Unified Communications Manager and
IM and Presence Service nodes. You can use the reports to confirm that you have a database replication with
no errors.

Before you begin

Ensure that the Cisco Tomcat service is running.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
98
 Upgrade the Applications
Verify that Database Replication is Complete

Procedure

Step 1 Log in to the reporting interface for the node:

• For Unified CM nodes, log in to the Cisco Unified Reporting interface.
• For IM and Presence nodes, log in to the Cisco Unified IM and Presence Reporting interface.

Step 2 Select System Reports.

Step 3 Check database replication on the node:
• For Unified CM, select Unified CM Database Status.
• For IM and Presence, select IM and Presence Database Status.

Step 4 Click the Generate Report (bar chart) icon in the Reports window.
Step 5 Click the View Details link to expose details for a section that does not automatically appear.
Step 6 If the report indicates that there are errors, select the Report Descriptions report and review the troubleshooting
information with possible remedies.

Verify that Database Replication is Complete

Use this procedure to verify that the database replication has completed successfully. Replication takes 30
minutes on average, but it may take longer depending on the size of the database.

Procedure

Step 1 Start a CLI session using one of the following methods:

• From a remote system, use SSH to connect securely to the Cisco Unified Operating System. In your SSH
client, enter your ssh adminname@hostname and enter your password.
• From a direct connection to the serial port, enter your credentials at the prompt that displays automatically.

Step 2 Execute the utils dbreplication runtimestate command to monitor whether the database replication is active
on the node and to view the progress of the database setup.
If database replication is active on all nodes, the output lists all the nodes and the replication setup value for
each node is 2.
If database replication is not complete (a value other than 2 is returned), core services will not start on the
subscriber nodes until replication is complete.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
99
 Upgrade the Applications
Verify that Database Replication is Complete

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
100
 CHAPTER 12
Post-upgrade Tasks
• Post-upgrade Task Flow, on page 101

Post-upgrade Task Flow

Perform the tasks in this list for all upgrade and migration methods.

Procedure

Command or Action Purpose

Step 1 Switch the Software Version, on page 103 If you did not switch versions immediately
after completing the upgrade, do so now in
order to complete the upgrade. Do not perform
a backup until you have switched to the new
software version.
Perform this procedure for all nodes.

Step 2 Update CTL file, on page 104 If the cluster is in mixed mode, manually
update the CTL file. Reset the phones to reflect
the latest updates.
Note You can skip this for Unified
Communications Manger
Migration.

Step 3 Remove the Serial Port, on page 104 Remove the serial port that you added during
the pre-upgrade tasks so that it does not impact
VM performance.
Perform this procedure for all nodes.

Step 4 Restart Extension Mobility, on page 105 If you deactivated Cisco extension mobility as
part of the pre-upgrade tasks, you can now
restart it.

Step 5 Reset TFTP Parameters, on page 105 Reset TFTP parameters that are changed
during the upgrade process.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
101
 Upgrade the Applications
Post-upgrade Task Flow

Command or Action Purpose

Step 6 Restore Enterprise Parameters, on page 106 Restore any Enterprise Parameter settings on
IM and Presence Service nodes that may have
been overwritten during the upgrade process.

Step 7 Reset High and Low Watermarks, on page 106 Use this procedure to restore the high and low
watermarks to their original values in order to
avoid premature purging of traces.
You can skip this task for PCD migrations.

Step 8 Update VMWare Tools, on page 107 You must update the VMWare Tools after you
complete the upgrade.
Perform this procedure for all nodes.

Step 9 Install Locales, on page 107 After an upgrade, you must reinstall any
locales that you are using, with the exception
of US-English, which is installed by default.
Perform this procedure for all nodes.

Step 10 Restore the Database Replication Timeout, on Use this procedure if you increased the
page 108 database replication timeout value before you
began the upgrade process.
Perform this procedure on Unified
Communications Manager nodes only.

Step 11 Verify the Registered Device Count, on page Use this procedure to verify your endpoints
109 and resources on Unified CM nodes after the
upgrade is complete.

Step 12 Verify Assigned Users, on page 109 Use this procedure to verify the number of
assigned users on IM and Presence Service
nodes after the upgrade is complete.

Step 13 Test Functionality, on page 109 Verify phone functions and features are
working correctly after the upgrade.

Step 14 Upgrade RTMT, on page 110 If you use Cisco Unified Real Time Monitoring
Tool (RTMT), upgrade to the new software
version.

Step 15 Manage TFTP Server Files, on page 111 Optional. Use this procedure to upload phone
rings, callback tones, and backgrounds to a
TFTP server so that they are available to
Unfiied CM nodes.

Step 16 Set Up a Custom Log-On Message, on page Optional. For Unified CM nodes only, upload
112 a text file that contains a customized log-on
message.

Step 17 Configure IPSec Policies, on page 113 If you are completing a PCD migration from
Release 6.1(5), you must recreate your IPSec

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
102
 Upgrade the Applications
Switch the Software Version

Command or Action Purpose

policies as they are not migrated to the new
release.

Step 18 Assign New Manager Assistant Roles, on page If you had Manager Assistant deployed before
113 the upgrade and users were assigned to the
InterCluster Peer-User or Admin-CUMA roles,
you must reassign users to roles, as these roles
do not exist in the current release.

Step 19 Verify IM and Presence Service Data Use this procedure only if you performed an
Migration, on page 114 upgrade or migration from Cisco Unified
Presence Release 8.x to an IM and Presence
Service release.

Step 20 Enable High Availability on Presence If you disabled High Availability for the IM
Redundancy Groups, on page 114 and Presence Service Service before the
upgrade process, use this procedure to turn it
back on.

Step 21 Restart the IM and Presence Sync Agent, on If you stopped the IM and Presence Service
page 115 Sync Agent service before you began the
upgrade process, restart it now.

Switch the Software Version

When you perform a standard upgrade, the new software is installed as an inactive version. You can reboot
to the new software during the upgrade process or you can switch to the new version later.
If you did not switch versions immediately after completing the upgrade, do so now. You must switch versions
so that the upgrade is complete and all nodes in the cluster are updated. Do not perform a backup until you
have switched to the new software version.
When you switch versions, the system restarts, and the inactive software becomes active. The system restart
may take up to 15 minutes. When you perform this procedure both the active and inactive software versions
are indicated.

Caution This procedure causes the system to restart and become temporarily out of service.

Before you begin

The software versions on Unified Communications Manager and IM and Presence Service nodes must match
according to the manual switching rules. Therefore, you must switch Unified Communications Manager before
you switch IM and Presence Service.
Review the information in Understanding Version Switching, on page 88

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
103
 Upgrade the Applications
Update CTL file

Procedure

Step 1 If you switch versions in a multinode deployment, you must switch the publisher node first.
Step 2 Log in to the management software for the node that you are upgrading:
• If you are upgrading an IM and Presence Service node, log in to Cisco Unified IM and Presence Operating
System Administration.
• If you are upgrading a Unified Communications Manager node, log in to Cisco Unified Communications
Operating System Administration.

Step 3 Select Settings > Version.

Step 4 Verify the version of the active software and the inactive software.
Step 5 Select Switch Versions to switch versions and restart the system.

After you perform a switch version when you upgrade Unified Communications Manager, IP phones request
a new configuration file. This request results in an automatic upgrade to the device firmware.

Update CTL file

During an upgrade from Unified Communications Manger pre 12.0 to 12.0 or later version, the ITLRecovery
certificate is generated per cluster. If the cluster is in mixed mode, manually update the CTL file. Reset the
phones to reflect the latest updates.

Note From Release 12.5(1)SU3 Update CTL is no longer required.

Procedure

Step 1 Verify Unified Communications Manager Security Mode in Unified Communications Manager
Administration > System > Enterprise Parameters Configuration.
Locate the Cluster Security Mode field. If the value in the field displays as 1, Unified Communications
Manager is configured for mixed mode.

Step 2 Manually update CTL file. For more information on how to update CTL file, see Security Guide for Cisco
Unified Communications Manager.
Step 3 Reset the phones to reflect the updates.

Remove the Serial Port

During the pre-upgrade tasks, you added a serial port to the virtual machine to capture the upgrade logs. After
you have successfully upgraded the system, you must remove the serial port so that it does not impact the
performance of the virtual machine.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
104
 Upgrade the Applications
Restart Extension Mobility

Procedure

Step 1 Power off the virtual machine.

Step 2 Edit the settings to remove the serial port. For information about how to edit the settings, see the VMWare
documentation.
Step 3 Power on the virtual machine and proceed with the post-upgrade tasks.

Restart Extension Mobility

Upgrades from Release 9.x or earlier require you to stop Cisco extension mobility before you begin the upgrade
process. If you deactivated Cisco extension mobility as part of your pre-upgrade tasks, use this procedure to
restart the service on Unified Communications Manager nodes.

Procedure

Step 1 From Cisco Unified Serviceability, choose Tools > Service Activation.
Step 2 From the Server list, choose the node on which you want to deactivate services and click Go.
Step 3 Select the Cisco Extension Mobility services.
Step 4 Click Restart.

Reset TFTP Parameters

During the upgrade process, the TFTP service parameter Maximum Serving Count is changed to allow for
an increased number of device registration requests. Use this procedure to reset the parameter after the upgrade
is complete.

Procedure

Step 1 From the Cisco Unified CM Administration interface, choose System > Service Parameters.
Step 2 From the Server drop-down list, select the node that is running the TFTP service.
Step 3 From the Service drop-down list, select Cisco TFTP service.
Step 4 Click Advanced.
Step 5 Click Save.
Step 6 Set the Maximum Serving Count to the same value that you used prior to the upgrade, or to the value that
is recommended for your configuration.
The default value is 500. We recommend that you use the default value if you run the TFTP service with other
Cisco CallManager services on the same server. For a dedicated TFTP server, use the following values:
• 1500 for a single-processor system
• 3000 for a dual-processor system

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
105
 Upgrade the Applications
Restore Enterprise Parameters

• 3500 for dedicated TFTP servers with higher CPU configurations

Restore Enterprise Parameters

Some Enterprise Parameters exist on both Unified Communications Manager nodes and IM and Presence
Service nodes. Where the same parameter exists, the settings that are configured on Unified Communications
Manager nodes overwrite the settings configured on IM and Presence Service nodes during an upgrade.
Enterprise Parameters that are unique to IM and Presence Service nodes are retained during an upgrade.
Use this procedure to reconfigure the settings on IM and Presence Service nodes that have been overwritten
during the upgrade process.

Before you begin

Make sure you have access to the settings that you recorded as part of the pre-upgrade tasks.

Procedure

Step 1 From the Cisco Unified CM IM and Presence Administration interface, choose System > Enterprise
Parameters.
Step 2 Compare the current settings to the settings that existed prior to the upgrade and update the Enterprise
Parameters as needed.
Step 3 Click Save.
Step 4 Click Reset, and then click OK to reset all devices.

Reset High and Low Watermarks

Use this procedure to restore the high and low watermarks to their original values in order to avoid premature
purging of traces.

Procedure

Step 1 In the Real Time Monitoring Tool (RTMT) interface, double-click Alert Central in the left navigation pane.
Step 2 On the System tab, right-click LogPartitionLowWaterMarkExceeded and select Set Alert/Properties.
Step 3 Select Next.
Step 4 Adjust the slider value to 80.
Step 5 On the System tab, right-click LogPartitionHighWaterMarkExceeded and select Set Alert/Properties.
Step 6 Select Next.
Step 7 Adjust the slider value to 85.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
106
 Upgrade the Applications
Update VMWare Tools

Update VMWare Tools

You must update the VMWare Tools after you complete and upgrade. There are two options for updating the
VMWare Tools:
• configure the tool to use the Automatic Tools Upgrade option
• configure the tool to automatically check the tools version during a VM power-on and upgrade the tools
For information about how to configure these options, see the VMWare documentation.

Install Locales
Use this procedure to install locales. After an upgrade, you must reinstall any locales that you are using, with
the exception of US-English, which is installed by default. Install the latest version of the locales that match
the major.minor version number of your Unified Communications Manager node orIM and Presence Service
node.
You can install locales on Unified Communications Manager or on IM and Presence Service nodes. If you
are installing a locale for both products, install the locale on all cluster nodes in the following order:
1. Unified Communications Manager publisher node
2. Unified Communications Manager subscriber nodes
3. IM and Presence database publisher node
4. IM and Presence subscriber nodes

If you want to install specific locales on IM and Presence Service nodes, you must first install the Unified
Communications Manager locale file for the same country on the Unified Communications Manager cluster.

Procedure

Step 1 Find the locale installer for your release on cisco.com:

• For Cisco Unified Communications Manager, go to https://software.cisco.com/download/
navigator.html?mdfid=268439621&i=rm
• For IM and Presence Service, go to https://software.cisco.com/download/
navigator.html?mdfid=280448682&i=rm

Step 2 Download your release's locale installer to a server that supports SFTP. You need the following files:
• User Locale files—These files contain language information for a specific language and country and use
the following convention:
• cm-locale-language-country-version.cop ( Cisco Unified Communications Manager)
• ps-locale-language_country-version.cop ( IM and Presence Service)

• Combined Network Locale file—Contains country-specific files for all countries for various network
items, including phone tones, annunciators, and gateway tones. The combined network locale file uses
the following naming convention:
• cm- locale-combinednetworklocale-version.cop (Cisco Unified Communications
Manager)

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
107
 Upgrade the Applications
Restore the Database Replication Timeout

Step 3 Log in to Cisco Unified OS Administration using the administrator account.

Step 4 Choose Software Upgrades > Install/Upgrade.
Step 5 Complete the following fields in the Software Installation/Upgrade window:
• For the Source, choose Remote file System.
• From the Directory, enter the path to the directory where you saved the locale installer.
• From the Server field, enter the server name for the remote file system.
• Enter the credentials for the remote file system.
• From the Transfer Protocol drop-down list, choose SFTP. You must use SFTP for the transfer protocol.

Step 6 Click Next.

Step 7 Download and install the locale on the server.
Step 8 Restart the server. The updates take effect after the server restarts
Step 9 Repeat this procedure on all Unified Communications Manager and IM and Presence Service cluster nodes
in the prescribed order.

Note Do not reset user locales for your end users until the new locale is installed on all cluster nodes. If you are
installing the locale for both Unified Communications Manager and IM and Presence Service Service, you
must install the locale for both products before you reset user locales. If you run into any issues, such as could
occur if an end user resets a phone language before the locale installation is complete for IM and Presence
Service Service, have your users reset their phone language in the Self-Care Portal to English. After the locale
installation is complete, users can reset their phone language, or you use Bulk Administration to synchronize
locales to the appropriate language by bulk.

Restore the Database Replication Timeout

This procedure applies to Unified Communications Manager nodes only.
Use this procedure if you increased the database replication timeout value before you began the upgrade
process.
The default database replication timeout value is 300 (5 minutes). Restore the timeout to the default value
after the entire cluster upgrades and the Unified Communications Manager subscriber nodes have successfully
set up replication.

Procedure

Step 1 Start a CLI session using one of the following methods:

• From a remote system, use SSH to connect securely to the Cisco Unified Operating System. In your SSH
client, enter your ssh adminname@hostname and enter your password.
• From a direct connection to the serial port, enter your credentials at the prompt that displays automatically.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
108
 Upgrade the Applications
Verify the Registered Device Count

Step 2 Execute the utils dbreplication setrepltimeout timeout command, where timeout is database replication
timeout, in seconds. Set the value to 300 (5 minutes).

Verify the Registered Device Count

Use the Real Time Monitoring Tool (RTMT) to view the device count and verify your endpoints and resources
after the upgrade is complete.

Procedure

Step 1 From the Unified RTMT interface, select Voice/Video > Device Summary.
Step 2 Record the number of registered devices:
Item Count
Registered Phones

Registered Gateways

Registered Media Resources

Registered Other Station Devices

Step 3 Compare this information to the device counts that you recorded before the upgrade and ensure that there are
no errors.

Verify Assigned Users

Use this procedure to verify the number of assigned users on nodes after the upgrade is complete.

Procedure

Step 1 From the Cisco Unified CM IM and Presence Administration interface, select System > Cluster Topology.
Step 2 Compare this information to the number of assigned users that you recorded before the upgrade and ensure
that there are no errors.

Test Functionality
After the upgrade, perform the following tasks:
• Verify phone functions by making the following types of calls:
• Voice mail

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
109
 Upgrade the Applications
Upgrade RTMT

• Interoffice
• Mobile phone
• Local
• National
• International
• Shared line

• Test the following phone features:

• Conference
• Barge
• Transfer
• C-Barge
• Ring on shared lines
• Do Not Disturb
• Privacy
• Presence
• CTI call control
• Busy Lamp Field

• Test IM and Presence Service functions:

• Basic presence states, such as available, unavailable, and busy
• Send and receive files
• Advanced features, such as persistent chat, federated users, and message archiving

Upgrade RTMT

Tip To ensure compatibility, Cisco recommends that you upgrade RTMT after you complete the Unified
Communications Manager upgrade on all servers in the cluster.

RTMT saves user preferences and downloaded module jar files locally on the client machine. The system
saves user-created profiles in the database, so you can access these items in Unified RTMT after you upgrade
the tool.

Before you begin

Before you upgrade to a newer version of RTMT, Cisco recommends that you uninstall the previous version.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
110
 Upgrade the Applications
Manage TFTP Server Files

Procedure

Step 1 From Unified Communications Manager Administration, choose Application > Plugins.
Step 2 Click Find.
Step 3 Perform one of the following actions:
• To install the tool on a computer that is running the Microsoft Windows operating system, click the
Download link for the Cisco Unified Real-Time Monitoring Tool - Windows.
• To install the tool on a computer that is running the Linux operating system, click the Download link
for the Cisco Unified Real-Time Monitoring Tool - Linux.

Step 4 Download the installation file to your preferred location.

Step 5 Locate and run the installation file.
The extraction process begins.
Step 6 In the RTMT welcome window, click Next.
Step 7 Because you cannot change the installation location for upgrades, click Next.
The Setup Status window appears; do not click Cancel.
Step 8 In the Maintenance Complete window, click Finish.

Manage TFTP Server Files

You can upload files for use by the phones to the TFTP server. Files that you can upload include custom
phone rings, callback tones, and backgrounds. This option uploads files only to the specific server to which
you connected, and other nodes in the cluster do not get upgraded.
Files upload into the tftp directory by default. You can also upload files to a subdirectory of the tftp
directory.
If you have two Cisco TFTP servers that are configured in the cluster, you must perform the following
procedure on both servers. This process does not distribute files to all nodes, nor to both Cisco TFTP servers
in a cluster.
To upload and delete TFTP server files, follow this procedure:

Procedure

Step 1 From the Cisco Unified Communications Operating System Administration window, navigate to Software
Upgrades > TFTP > File Management.
The TFTP File Management window displays and shows a listing of the current uploaded files. You can filter
the file list by using the Find controls.

Step 2 To upload a file, follow this procedure:

a) Click Upload File.
The Upload File dialog box opens.
b) To upload a file, click Browse and then choose the file that you want to upload.
c) To upload the file to a subdirectory of the tftp directory, enter the subdirectory in the Directory field.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
111
 Upgrade the Applications
Set Up a Custom Log-On Message

d) To start the upload, click Upload File.

The Status area indicates when the file uploads successfully.
e) After the file uploads, restart the Cisco TFTP service.
Note If you plan to upload several files, restart the Cisco TFTP service only once, after you have
uploaded all the files.

For information about restarting services, refer to Cisco Unified Serviceability Administration Guide.

Step 3 To delete files, follow this procedure:

a) Check the check boxes next to the files that you want to delete.
You can also click Select All to select all of the files, or Clear All to clear all selection.
b) Click Delete Selected.
Note If you want to modify a file that is already in the tftp directory, you can use the CLI command
file list tftp to see the files in the TFTP directory and file get tftp to get a copy of a file in the
TFTP directory. For more information, see Command Line Interface Reference Guide for Cisco
Unifed Communications Solutions.

Set Up a Custom Log-On Message

You can upload a text file that contains a customized log-on message that appears in Cisco Unified
Communications Operating System Administration, Cisco Unified CM Administration, Cisco Unified
Serviceability, Disaster Recovery System Administration, Cisco Prime License Manager, and the command
line interface.
To upload a customized log-on message, follow this procedure:

Procedure

Step 1 From the Cisco Unified Communications Operating System Administration window, navigate to Software
Upgrades > Customized Logon Message.
The Customized Logon Message window displays.

Step 2 To choose the text file that you want to upload, click Browse.
Step 3 Click Upload File.
Note You cannot upload a file that is larger than 10kB.

The system displays the customized log-on message.

Step 4 To revert to the default log-on message, click Delete.

Your customized log-on message gets deleted, and the system displays the default log-on message.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
112
 Upgrade the Applications
Configure IPSec Policies

Note Check the Require User Acknowledgment checkbox if you want the custom message to be displayed
on the login screens of the Cisco Unified Communications Operating System Administration, Cisco
Unified CM Administration, Cisco Unified Serviceability, Disaster Recovery System Administration,
Cisco Prime License Manager, and the command line interface.

Configure IPSec Policies

Use this procedure only if you are performing a PCD migration from Release 10.5. You must reconfigure
your IPSec policies after the PCD migration is complete. Before migration, you must disable the IPsec policy
in both the nodes of the cluster. And after successful migration, ensure that you enable the IPsec policy.
• IPsec requires bidirectional provisioning, or one peer for each host (or gateway).
• When you provision the IPSec policy on two Unified Communications Manager nodes with one IPsec
policy protocol set to “ANY” and the other IPsec policy protocol set to “UDP” or “TCP”, the validation
can result in a false negative if run from the node that uses the “ANY” protocol.
• IPsec, especially with encryption, affects the performance of your system.

Procedure

Step 1 From Cisco Unified OS Administration, choose Security > IPSec Configuration.
Step 2 Click Add New.
Step 3 Configure the fields on the IPSEC Policy Configuration window. See the online help for more information
about the fields and their configuration options.
Step 4 Click Save.
Step 5 (Optional) To validate IPsec, choose Services > Ping, check the Validate IPsec check box, and then click
Ping.

Assign New Manager Assistant Roles

Perform this procedure only if your previous release was configured to use the Cisco Unified Communications
Manager Assistant feature, and you assigned application users to use either the InterCluster Peer-User or the
Admin-CUMA roles. The InterCluster Peer-User and Admin-CUMA roles are deprecated from release 10.0(1)
onward and are removed during the upgrade process. You must assign new roles for those users.

Procedure

Step 1 To configure roles and users, see the chapter Manage Users in Administration Guide for Cisco Unified
Communications Manager.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
113
 Upgrade the Applications
Verify IM and Presence Service Data Migration

Step 2 Ensure that the AXL user defined on the IM and Presence Service service user interface (Presence >
Inter-Clustering ) has a Standard AXL API Access role associated with it on the Unified Communications
Manager application user page.

Verify IM and Presence Service Data Migration

When you upgrade from Cisco Unified Presence Release 8.x to an IM and Presence Service Service release,
user profiles are migrated to Unified Communications Manager. The user profile information is stored as new
service profiles on Unified Communications Manager with the following name and description format:
Name: UCServiceProfile_Migration_x (where x is a number starting at 1)
Description: Migrated Service Profile Number x
To ensure that users can successfully log into Cisco Jabber after an upgrade from Cisco Unified Presence
Release 8.x, you must verify that the user profile data migration was successful.
Profiles that are created but that are not assigned to users are not migrated to Unified Communications Manager.

Procedure

Step 1 From Cisco Unified CM Administration, select User Management > User Settings > Service Profile.
Step 2 Select Find to list all service profiles.
Step 3 Verify that there are migrated service profiles with the following name format: UCServiceProfile_Migration_x
Step 4 If there are no migrated service profiles, check the installdb log file for any errors.
Step 5 If the data migration fails, an import error alarm is raised on Unified Communications Manager and the Cisco
Sync Agent sends a failure notification to the Cisco Unified CM IM and Presence Administration GUI.
Tip To view the alarm details, log into RTMT for Cisco Unified Communications Manager.

What to do next
You can edit these service profiles to give them more meaningful names. See Administration Guide for Cisco
Unified Communications Manager for more information about configuring service profiles.

Enable High Availability on Presence Redundancy Groups

This procedure applies to IM and Presence Service nodes only. If you disabled high availability on presence
redundancy groups before beginning the upgrade process, use this procedure to enable it now.

Before you begin

If it has been less than 30 minutes since your services restarted, confirm that your Cisco Jabber sessions have
been recreated before you enable High Availability. Otherwise, Presence will not work for Jabber clients
whose sessions aren't created.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
114
 Upgrade the Applications
Restart the IM and Presence Sync Agent

To obtain the number of Jabber sessions, run the show perf query counter "Cisco Presence Engine"
ActiveJsmSessions CLI command on all cluster nodes. The number of active sessions should match the
number of users that you recorded when you disabled high availability prior to the upgrade.

Procedure

Step 1 From the Cisco Unified CM Administration user interface, choose System > Presence Redundancy Groups.
Step 2 Click Find and select the Presence Redundancy Group.
The Presence Redundancy Group Configuration window displays.
Step 3 Check the Enable High Availability check box.
Step 4 Click Save.
Step 5 Repeat this procedure in each Presence Redundancy Group.

Restart the IM and Presence Sync Agent

If you stopped the IM and Presence Service Sync Agent service before you began the upgrade process, restart
it now.

Procedure

Step 1 From the Cisco Unified Serviceability interface, select Tools > Control Center - Network Services.
Step 2 Select an IM and Presence Service node from the Server drop-down list and click Go.
Step 3 In the IM and Presence Services section, select the Cisco Sync Agent and click Restart.

Example

Note After the Cisco Intercluster Sync Agent has finished the initial synchronisation, manually load the
new Tomcat certificate onto Unified Communications Manager. This ensures that the synchronisation
does not fail.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
115
 Upgrade the Applications
Restart the IM and Presence Sync Agent

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
116
PA R T V
Troubleshooting
• Troubleshooting, on page 119
 CHAPTER 13
Troubleshooting
This section contains the following information:
• Dump a Log File After an Upgrade Failure, on page 119
• Troubleshooting Unified Communications Manager Upgrades, on page 120
• Troubleshooting IM and Presence Upgrades, on page 123

Dump a Log File After an Upgrade Failure

Use this procedure in the event of a failure when you are upgrading Unified Communications Manager or the
IM and Presence Service.

Before you begin

You need the 7-Zip utility to open the log files. Go to http://www.7-zip.org/download.html

Procedure

Step 1 Attach a new, empty file to the serial port. Edit the settings on the VM and attach the file name where you
want the logs dumped.
Note If the system stops running due to an upgrade failure and prompts you to dump the logs, you must
attach the empty file before you answer Yes and proceed.

Step 2 Return to the VM console, and dump the logs into the serial port.
Step 3 When the process is complete, click Inventory > Datastores and Datastore Clusters.
Step 4 Select the datastore where you created the file.
Step 5 Right-click and choose Browse Datastore and browse to the file that you created.
Step 6 Right-click the file, select Download, and select a location on your PC to save the file.
Step 7 Open the file using 7-Zip and check the file size:
• If the size of the file is larger than 0, extract the files to your PC and then edit the settings on the virtual
machine to remove the serial port.
• If the file size is 0, proceed to the next step.

Step 8 If the file size is zero, complete the following steps:

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
119
 Troubleshooting
Troubleshooting Unified Communications Manager Upgrades

a) Power off the virtual machine.

b) Create a new file for log output.
c) Unmap the installation disk.
d) On the Options tab, select Boot Options and enable Force BIOS Setup.
e) Power on the virtual machine and wait for it to boot to the BIOS.
f) In the BIOS, select the hard drive as the first boot device and save and exit.
The system will boot to the hard drive and go back to the point where the upgrade failed. A failure
notification displays.
g) Input yes to dump the contents of the log to a file.
h) Navigate to the file and open it using 7-Zip.
Step 9 If the size of the file is larger than 0, extract the files to your PC and then edit the settings on the virtual
machine to remove the serial port.

Troubleshooting Unified Communications Manager Upgrades

This section provides information about troubleshootingUnified Communications Manager upgrades.

Upgrade Failure
Problem The upgrade of a subscriber node fails after you upgrade the Unified Communications Manager
publisher node and switch it to the new version, or the upgrade of one of the subscriber nodes in your cluster
failed during the upgrade cycle.
Solution Do one of the following:

• Correct the errors that caused the upgrade failure on the subscriber node. You may want to check the
network connectivity of the nodes in your cluster, reboot the subscriber node, and ensure that the server
memory and CPU usage on the subscriber node is not too high. Upgrade the subscriber node again.
• Make sure that the active partition of the Unified Communications Manager publisher node runs the
newest version of software installed on the server. Perform a fresh installation on the subscriber node
using the same software version as that running on the active partition of the publisher node. If you are
reinstalling the subscriber node, you should delete the server from Cisco Unified CM Administration
and add the server again as described in the Administration Guide for Cisco Unified Communications
Manager.

Reboot include on upgrade Success/Failed/Cancel case

Problem: Upgrades might fail or disturb if we didn’t reboot in below stages.
Solution:Reboot is required in the following scenarios:
1. Any upgrade (Legacy upgrade/Simple upgrade or Upgrade via PCD) get success or failure:
• When an L2 upgrade fails, a reboot is required only in case when an upgrade is required again.
• After a successful L2 upgrade, if you do not wish to switch to the new version and would like to
upgrade again, you need to reboot the node first before starting the upgrade.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
120
 Troubleshooting
Upgrade Fails with Insufficient Disk Space

• When an RU upgrade fails, it automatically switches to old partition and an automatic reboot is
performed (if upgrade status is failed, cancel the upgrade and reboot the node).

2. If the Switch version fails, you should reboot the server before you attempt any further action, as it may
stop/ halt the Service Manager and other services that could impact functionalities.
3. If you cancel any upgrade at any stage, you should reboot the IM&P/ UCM servers before you attempt
any other upgrade.

Upgrade Fails with Insufficient Disk Space

Problem The upgrade of Unified Communications Manager fails with an error stating that the common partition
is full.
Solution Typically, you need at least 25G of common partition space; however, your deployment may require
more space if you have a lot of TFTP data (device firmware loads), music-on-hold (MOH) files, or if you
have many locale files installed. Perform one or more of the following actions to create additional disk space:
• Use the Cisco Log Partition Monitoring Tool to adjust the low and high watermarks to reduce the traces
and remove unnecessary log files. Cisco recommends that you adjust the low watermark value to 30,
and the high watermark value to 40. After the upgrade, you must restore the high and low watermarks
to their original values in order to avoid premature purging of traces. The default value for the high
watermark is 85. The default value for the low watermark is 80. For more information about using the
Cisco Log Partition Monitoring Tool, see the Cisco Unified Real-Time Monitoring Tool Administration
Guide.
• Use the Disk Expansion COP file (ciscocm.vmware-disk-size-reallocation-<latest_version>.cop.sgn) to
expand the vDisk size if your virtual environment has additional available disk space. Ensure that you
review the Readme file that supports this COP file before you proceed.
• Use the Free Common Space COP file (ciscocm.free_common_space_v<latest_version>.cop.sgn). This
COP file removes the inactive side in the common partition to increase available disk space without
requiring a system rebuild. Ensure that you review the Readme file that supports this COP file before
you proceed.
• Manually remove outdated or unused firmware files from the TFTP directory. You can remove these
files using the TFTP File Management page in the OS Administration interface, or you can use the file
list tftp and file delete tftp commands from the command line interface.

You can download COP files and their Readme files from Cisco.com. Navigate to Support > Downloads >
Cisco Unified Communications Manager Version 10.0 > Unified Communications
Manager/CallManager/Cisco Unity Connection Utilities.

Download Failure in Cluster-Wide Upgrade

While performing a cluster-wide upgrade that includes both Unified Communications Manager and IM and
Presence Service nodes, and download of the image fails in any of the Unified Communications Manager or
IM and Presence Service nodes, follow this process:

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
121
 Troubleshooting
Reduced Permissions for Access Control Groups

Procedure

Step 1 Download the build manually on the failed node.

Step 2 Log into Cisco Unified Operating System Administration, choose the Software Upgrades > Install/Upgrade
Cluster.
Step 3 Select the local Filesystem option to get the existing image and proceed further.
Step 4 If you are performing the upgrade at Command Line Interface, run the utils system upgrade initiate
CLI command and select the Local Image option.
You do not need to download the image again.

Reduced Permissions for Access Control Groups

Problem When you add a new access control group to existing users, the level of privileges for some pre-existing
access control groups is unexpectedly reduced.
Solution Users can belong to multiple access control groups. When you add a new access control group to
existing users, the current level of privileges for some pre-existing access control groups may be reduced if
the new access control group has the “Effective Access Privileges for Overlapping User Groups and Roles”
Enterprise parameter set to minimum.
Access privilege reduction can occur inadvertently, for example, during an upgrade of Cisco Unified CM
Administration. If the upgrade version supports the Standard RealTimeAndTrace Collection user group, which
has the “Effective Access Privileges for Overlapping User Groups and Roles” Enterprise parameter set to
minimum, all users are automatically added to that user group during the upgrade. To resolve the permissions
issue in this example, you can remove users from the Standard RealTimeAndTrace Collection user group.

Loss of Phone Settings

For a short period of time after you install Unified Communications Manager or switch over after upgrading
to a different product version, settings that were configured by phone users may be reset. Examples of settings
configured by phone users include call forwarding and message waiting indication settings. This situation can
occur if there have been configuration changes during the upgrade window. When Unified Communications
Manager synchronizes the database after an installation or upgrade, it can overwrite setting changes made by
phone users. Cisco recommends that you do not make configuration changes during an upgrade.

Post-Upgrade Failure of Unified Communications Manager Publisher Node

Problem The upgrade is successful and the cluster is running the new release, but the Unified Communications
Manager publisher node subsequently fails.
Solution Do one of the following:

• restore the Unified Communications Manager publisher node use a DRS backup file
• if you do not have a DRS backup file, you must reinstall the entire cluster, including any IM and Presence
Service nodes

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
122
 Troubleshooting
Post-Upgrade Failure of Unified Communications Manager Subscriber Nodes

Post-Upgrade Failure of Unified Communications Manager Subscriber Nodes

Problem The upgrade is successful and the cluster is running the new release, but a Unified Communications
Manager subscriber node subsequently fails.
Solution Do one of the following:

• Restore the Unified Communications Manager subscriber node use a DRS backup file.
• If you do not have a DRS backup file, you must perform the upgrade on the subscriber node again. You
do not need to remove the subscriber node from the Unified Communications Manager publisher node's
server page before you reinstall it.

Troubleshooting IM and Presence Upgrades

This section provides information about troubleshooting IM and Presence Service Service upgrades.

Upgrade Failure of IM and Presence Database Publisher Node

Problem You are upgrading a multinode cluster that includes both Unified Communications Manager and IM
and Presence Service nodes, and the upgrade of the IM and Presence Service database publisher node fails.
Solution The action that you take depends on the point at which the failure occurred:

• if the upgrade on the IM and Presence Service database publisher node fails before the refresh upgrade
causes the node to reboot (that is, if the node failed before switching to the new partition), perform the
upgrade again on the IM and Presence Service database publisher node
• If the failure occurred after the IM and Presence Service database publisher node switched to the new
software version, you must switch back all the nodes and perform the upgrade again. Complete the
following tasks in the order listed:
• switch back the Unified Communications Manager publisher node
• switch back the Unified Communications Manager subscriber nodes
• switch back the IM and Presence Service database publisher node
• upgrade the Unified Communications Manager publisher node again
• switch the Unified Communications Manager publisher node forward to the new software version
• upgrade the Unified Communications Manager subscriber nodes again
• switch the Unified Communications Manager subscriber nodes forward to the new software version
• upgrade the IM and Presence Service database publisher node again

Upgrade Failure of IM and Presence Subscriber Node

Problem You are upgrading a multinode cluster that includes both Unified Communications Manager and IM
and Presence Service nodes, and the upgrade of the IM and Presence Service subscriber node fails.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
123
 Troubleshooting
Upgrade From Pre Release 8.6(4) Fails

Solution The action that you take depends on the point at which the failure occurred:

• if the upgrade on the IM and Presence Service subscriber node before the refresh upgrade causes the
node to reboot (that is, if the node failed before switching to the new partition), perform the upgrade
again on the IM and Presence Service subscriber node
• if the upgrade on the IM and Presence Service subscriber node fails after the node switched to the new
version, you must complete the following tasks in the order listed:
• switch the Unified Communications Manager publisher node back to the earlier software version
• switch the Unified Communications Manager subscriber node back to the earlier software version
• switch the IM and Presence Service database publisher node back to the earlier software version
• switch the IM and Presence Service subscriber nodes back to the earlier software version
• switch the Unified Communications Manager publisher node pub forward to the new software
version
• switch the IM and Presence Service database publisher node forward to the new software version
• perform the upgrade again on the IM and Presence Service subscriber node

Upgrade From Pre Release 8.6(4) Fails

Problem You are upgrading from a release earlier than Cisco Unified Presence 8.6(4) and the upgrade fails on
both the publisher and subscriber nodes.
Solution The Unified Communications Manager hostname is case-sensitive. You must ensure that the entry
for the Unified Communications Manager publisher node on the Cisco Unified Presence Administration
interface matches exactly the Unified Communications Manager hostname. Complete the following procedure:
1. Log into Cisco Unified Presence Administration interface and choose System > CUCM Publisher.
2. If the CUCM Publisher Hostname value does not match the hostname, modify it and click Save.
3. Restart the Cluster Manager service with the following CLI command: utils service restart Cluster
Manager
4. Open the platformConfig.xml file at the following location: /usr/local/platform/conf/
5. Verify that the values for IPSecMasterHost and NTPServerHost match exactly the Cisco Unified
Communications Manager hostname.
6. If necessary, modify the value for IPSecMasterHost and NTPServerHost , save the platformConfig.xml
file and restart the Cluster Manager service again.

IM and Presence user phone presence problems

Problem After an IM and Presence server upgrade, when all activated feature services and network services
are started, IM and Presence phone presence from users is delayed or slow to update.
Solution You must restart the Cisco SIP Proxy service. In Cisco Unified IM and Presence Serviceability, select
Tools > Control Center - Features Services.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
124
 Troubleshooting
Presence User Experiences Issues Obtaining Availability

Presence User Experiences Issues Obtaining Availability

Problem After an IM and Presence Service server upgrade, when all activated feature services and network
services are started, a user experiences inconsistent presence availability. The user can log in to IM and
Presence Service but experiences issues obtaining availability information mainly from SIP-based clients.
Solution This issue is caused when users are provisioned while IM and Presence Service is being upgraded.
You must unassign and then reassign the user.

Real-Time Monitoring Tool alert for Cisco SIP proxy service

Problem After an IM and Presence Service server upgrade, when all activated feature services and network
services are started, a Real-Time Monitoring Tool CoreDumpFileFound alert was generated for the Cisco SIP
Proxy service.
Solution You must restart the Cisco SIP Proxy service. In Cisco Unified IM and Presence Serviceability, select
Tools > Control Center - Features Services.

Cannot find upgrade file on remote server

Problem You cannot find the upgrade file on the remote server.

Solution If the upgrade file is located on a Linux or Unix server, you must enter a forward slash at the beginning
of the directory path that you want to specify. For example, if the upgrade file is in the patches directory, you
must enter /patches. If the upgrade file is located on a Windows server, check with your system administrator
for the correct directory path.

Upgrade file checksum values do not match

Problem The checksum value of the upgrade file does not match the checksum indicated on Cisco.com.

Solution The two checksum values must match to ensure the authenticity and integrity of the upgrade file. If
the checksum values do not match, download a fresh version of the file from Cisco.com and try the upgrade
again.

Database replication did not complete

Problem After an upgrade, database replication did not complete and the result of the command utils
dbreplication runtimestate was not 2.
Solution After a successful upgrade and switch version to the new software, database replication should take
place automatically. During this time core services on the subscriber nodes will not start. Database replication
in large deployments can take several hours to complete. If, after several hours, the utils dbreplication
runtimestate command shows that database replication did not complete, you need to reset the database
replication. Run the following command on the publisher node: utils dbreplication reset all

Cisco UP Presence Engine database does not restart

Problem After you switch back to Cisco Unified Presence Release 8.6(3) or an earlier software version, the
Cisco UP Presence Engine database does not restart.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
125
 Troubleshooting
Version Errors

Solution Ensure that you installed the required COP file, ciscocm.cup.pe_db_install.cop, on every
node in the cluster after you switched back to Cisco Unified Presence Release 8.6(3), or earlier.

Version Errors
Selected Upgrade Is Disallowed From the Current Version
Problem During a refresh upgrade, the following error is reported: Error encountered: The selected
upgrade is disallowed from the current version.
Solution You did not install the required COP file on the node. Download the following COP file from
Cisco.com: ciscocm.cup.refresh_upgrade_v<latest_version>.cop. Restart the server.
Install the COP file on every node in the cluster before you attempt the refresh upgrade again.

Version Does Not Match the Active or Inactive Version

Problem During an upgrade on a IM and Presence Service server, you cannot select the software image from
the disk or remote directory. The following error is reported: The version obtained from the
name does not match the active or inactive version of the publisher.
Solution The version matching rules have not been met. The software versions must meet the following
requirements:
• The software version of the IM and Presence Service database publisher node (the first IM and Presence
Service node that you upgrade) must match the first two numbers of the software version installed on
the Unified Communications Manager publisher node. The software version installed on the Unified
Communications Manager publisher node may be active or inactive. For example, IM and Presence
Service software version 10.0.1.10000-1 is compatible with Unified Communications Manager software
version 10.0.1.30000-2. Make sure to follow sequence rules while upgrading Unified Communications
Manager and IM and Presence Service nodes.
• The software version of the IM and Presence Service subscriber nodes that you upgrade must match five
numbers of the software version installed on the IM and Presence Service database publisher node.

Ensure that the first node that you upgrade is either the Unified Communications Manager publisher node or
the IM and Presence Service database publisher node, or select a different image for the software upgrade.

Switch Version on Cisco IM and Presence Node Fails

Problem Switching the version on the Cisco IM and Presence node fails. The following error is reported:
Version mismatch. Please switch versions on the publisher and try again.
Solution The version matching rules have not been met. The software versions must meet the following
requirements:
• The software version of the IM and Presence Service database publisher node (the first IM and Presence
Service node that you upgrade) must match the first two numbers of the software version installed on
the Unified Communications Manager publisher node. For example, IM and Presence Service Service
software version 10.0.1.10000-1 is compatible with Unified Communications Manager software version
10.0.1.30000-2.
• The software version of the IM and Presence Service subscriber nodes that you upgrade must match five
numbers of the software version installed on the IM and Presence Service database publisher node.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
126
 Troubleshooting
Failed refresh upgrade

To correct this error, ensure that the first node that you switch is either theUnified Communications Manager
publisher node or the IM and Presence Service database publisher node.

Failed refresh upgrade

Problem A refresh upgrade failed.

Solution Restart the system, it should reboot to the software version that was running before you attempted
the refresh upgrade. If you cannot access the system, you must use the Recovery CD to recover the node.

Cancelled or failed upgrade

If you cancel an upgrade at any stage, or if an upgrade fails, you must reboot the IM and Presence Service
server before you attempt another upgrade.

Directory Was Located and Searched but No Valid Options or Upgrades Were
Available
Problem During an IM and Presence Service upgrade, the IM and Presence Service server generates the
following error message, even though the upgrade path and file are valid:
The directory was located and searched but no valid options or upgrades
were available. Note, a machine cannot be downgraded so option and upgrade
files for previous releases were ignored.
Solution The upgrade manager checks for connectivity between IM and Presence Service and Unified
Communications Manager to validate the version during the upgrade. If this fails, the IM and Presence Service
server generates the error message even though the upgrade path and file are valid. Use a tool, such as the
Cisco Unified CM IM and Presence Administration System Troubleshooter, to check that there is connectivity
between IM and Presence Service and Unified Communications Manager before proceeding with the upgrade.

Common Partition Full Upgrade Failure

Problem The upgrade of IM and Presence Service fails with an error stating that the common partition is full.

Solution Download and apply the COP file ciscocm.free_common_cup_space_v<latest_version>.cop.sgn.

This COP file cleans up the common partition and allows subsequent upgrades to proceed as normal.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
127
 Troubleshooting
Common Partition Full Upgrade Failure

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
128
PA R T VI
Appendix
• Frequently Asked Questions, on page 131
• Upgrading from Legacy Releases, on page 135
• Additional Upgrade Resources, on page 137
 CHAPTER 14
Frequently Asked Questions
• Frequently Asked Questions, on page 131

Frequently Asked Questions

I am upgrading from a release of Unified Communications Manager or IM and Presence Service that has
different requirements for the virtual environment than the new release. What do I need to do?
Verify the requirements for the new release using the information below. After you have verified the
requirements for the new release, see Virtual Machine Configuration Tasks, on page 53for instructions.

Table 20: Virtual Machine Requirements

Item Description

OVA templates OVA files provide a set of predefined templates for virtual machine
configuration. They cover items such as supported capacity levels and any
required OS/VM/SAN alignment. You must use a VM configuration from
the OVA file provided for the Unified Communications Manager and IM
and Presence Service applications.
The correct VM configuration to use from the OVA file is based on the
size of the deployment. For information about OVA files, search for the
topic "Unified Communications Virtualization Sizing Guidelines" at
https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/uc_system/
virtualization/collaboration-virtualization-sizing.html.

VMware vSphere ESXi You must install a version of vSphere ESXi hypervisor that meets the
compatibility and support requirements for the release.
If you use Cisco Prime Collaboration Deployment (PCD) to perform an
upgrade or migration, you must also ensure that you install vSphere ESXi
with the correct license type. PCD is not compatible with all the license
types of vSphere ESXi because some of these licenses do not enable
required VMware APIs.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
131
 Appendix
Frequently Asked Questions

Item Description

VMware vCenter VMware vCenter is optional when you deploy Unified Communications
Manager or IM and Presence Service on Business Edition 6000/7000
appliances, or on UC on UCS tested reference configuration hardware.
VMware vCenter is mandatory when you deploy on UC on UCS
specs-based and third-party server specs-based hardware.

VM configuration virtual Verify whether you need to change the virtual hardware specifications on
hardware specifications your VM in order to upgrade to a new release of Unified Communications
Manager or IM and Presence Service. For example, verify the requirements
for vCPU, vRAM, vNIC adaptor type, and vDisk size, as well as other
specifications.
Any changes to a VM must align with the OVA configuration. VM changes
that result in an unsupported OVA configuration are not allowed. For
information about VM requirements, see Readme file with the OVA
template that supports your release.
Note If Unified Communications Manager is upgraded to version
12.5 from version 11.5 or higher, using 80GB OVA it is expected
to have a higher active partition up to 98%. We can correct this
by a system rebuilt with HDD 90GB/110GB. Use a default
110GB OVA template and rebuilt the node. Or on current 80GB
OVA, prior to clean install, go to VM > Edit Settings, and
increase the HDD size from 80GB to 90GB/110GB. Other specs
remain the same. Adding HDD disk to the system already
installed only adds additional HDD space to common partition.

You can find detailed information about the requirements for the virtualized environment by going to ..
www.cisco.com go virtualized-collaboration, where you can:
• follow the links for the Unified Communications Manager and IM and Presence Service applications to
find the requirements for the release and download OVA files.
• search for the topic "Unified Communications VMware Requirements" to find information about feature
support and best practices.

I want to move to a different VM size as part of the upgrade. Can I edit the VM configuration specifications?
Before you edit the VM configuration specifications, review the OVA ReadMe file to find the specific
requirements for the release that you are upgrading to. OVA files provide a set of predefined templates for
virtual machine configuration. They cover items such as supported capacity levels and any required
OS/VM/SAN alignment. The correct VM configuration to use from the OVA file is based on the size of the
deployment.
For information about OVA files, search for the topic "Unified Communications Virtualization Sizing
Guidelines" at .. www.cisco.com go virtualized-collaboration.
To obtain an OVA file, see Download and Install OVA Templates, on page 55.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
132
Appendix
Frequently Asked Questions

I have applications that use an administrative XML (AXL) interface to access and modify Unified
Communications Manager information. Will my application continue to work after I upgrade to Unified
Communications Manager?
For information about upgrading your AXL applications, see https://developer.cisco.com/site/axl/learn/how-to/
upgrade-to-a-new-axl-schema.gsp. To see a list of the AXL operations supported for your release, refer to
https://developer.cisco.com/site/axl/documents/operations-by-release/.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
133
 Appendix
Frequently Asked Questions

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
134
 CHAPTER 15
Upgrading from Legacy Releases
• Upgrading and Migrating from Legacy Releases, on page 135

Upgrading and Migrating from Legacy Releases

If a direct upgrade or migration from your current release is not supported, you can use the following process:
• perform a direct upgrade to an intermediate release using either the Unified CM OS Admin interface or
the Cisco Prime Collaboration Deployment (PCD) Upgrade task
• perform a migration from the intermediate release to the current release using the PCD Migration task

Find your starting release in the table below and use it to identify the intermediate releases that you can use
as steps in the upgrade and migration process. After you have identified the intermediate release, use the links
in the steps below to find the documentation for that release.
If your starting release is not listed, it may require an upgrade to more than one intermediate release. See the
"Supported Upgrade Paths To/From Table" at http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cucm/
compat/ccmcompmatr1.html#pgfId-391518.

Table 21: Upgrade Paths for Legacy Releases

Installed Version Upgrade to this Version on MCS Migrate to this Version on a Virtual
hardware Machine

Cisco Unified Communications Manager Releases

4.x Direct upgrade to 6.1(5), 7.1(3), or 7.1(5) PCD Migration to 11.5(1)

using Cisco Unified Communications
Manager Data Migration Assistant
(DMA)
Check the Software Compatibility Matrix
for the intermediate release to find the
supported upgrade path from your
current release, or see the "Supported
Upgrade Paths To/From Table" at the
link above.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
135
 Appendix
Upgrading and Migrating from Legacy Releases

Installed Version Upgrade to this Version on MCS Migrate to this Version on a Virtual
hardware Machine

5.1(2) Direct Upgrade to 6.1(5) or 7.1(3) PCD Migration to 11.5(1)

5.1(3)
6.0(x)
6.1(1)
6.1(2)
6.1(3)
6.1(4)

7.0(1) 7.1(3), 7.1(5), 8.x, or 9.x PCD Migration to 11.5(1)

7.1(2)

Cisco Unified Presence Releases

8.0(x) Direct Upgrade to 8.5(4) PCD Migration to 11.5(1)

Cisco Unified Communications Manager Business Edition Releases

Business Edition 3000 Upgrades and migrations are not supported for these deployments. We
(BE3000) recommend that you perform a fresh installation for upgrades from these
products to the current Cisco Unified Communications Manager release.
Business Edition 5000
(BE5000)

Procedure

Step 1 Refer to the upgrade documentation for the intermediate release and follow the instructions to upgrade your
system.
• For Cisco Unified Communications Manager upgrade documentation, see http://www.cisco.com/c/en/
us/support/unified-communications/unified-communications-manager-callmanager/
products-installation-guides-list.html.
• For IM and Presence Service (formerly Cisco Unified Presence) upgrade documentation, see
http://www.cisco.com/c/en/us/support/unified-communications/unified-presence/
products-installation-guides-list.html.

Step 2 Refer to the Cisco Prime Collaboration Deployment Administration Guide at http://www.cisco.com/c/en/us/
support/unified-communications/unified-communications-manager-callmanager/
products-maintenance-guides-list.html and follow the instructions to perform a PCD migration to the current
release.

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
136
 CHAPTER 16
Additional Upgrade Resources
• Additional Upgrade Resources, on page 137

Additional Upgrade Resources

Cisco Collaboration Systems Solution Reference Network Designs (SRND) for at http://www.cisco.com/c/
en/us/support/unified-communications/unified-communications-system/
products-implementation-design-guides-list.html
Cisco Preferred Architecture guides and Cisco Validated Design guides at http://www.cisco.com/c/en/us/
solutions/enterprise/design-zone-collaboration/index.html
Collaboration Virtual Machine Replacement Tool at http://ucs.cloudapps.cisco.com/
Cisco Collaboration Sizing Tool at http://tools.cisco.com/cucst

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
137
 Appendix
Additional Upgrade Resources

Upgrade and Migration Guide for Cisco Unified Communications Manager and IM and Presence Service, Release 11.5(1)
138