Preupgrade Overview
The preupgrade process ensures that your systems have the necessary software to support your contact center. These tasks prepare the way for a successful upgrade of your Cisco contact center components to the new release.
![]() Note |
During the Technology Refresh (TR) Upgrade process, the installer is designed to identify any unsupported features present in the source deployment. These features are then listed in a dialog box for you to review. You have two options on how to proceed:
For more information about the list of unsupported features, see the Removed and Unsupported Features topic in the Release Notes for Cisco Contact Center Enterprise Solutions at https://www.cisco.com/c/en/us/support/customer-collaboration/unified-contact-center-enterprise/products-release-notes-list.html |
![]() Note |
If you need to upgrade from version 12.6(2) to 15.0(1) to leverage the capabilities of graceful shutdown, you must first install 12.6(2) ES53 before proceeding with the upgrade to 15.0(1). For more information about the router graceful shutdown, see the Unified CCE Router graceful shutdown topic in the Administration Guide for Cisco Unified Contact Center Enterprise, Release 15.0(1). |
![]() Note |
During Unified CCE installation on to Windows Server 2019 and SQL Server 2019, SQL Server Security Hardening optional configuration should not be selected as part of an installation. SQL Security Hardening should be applied post Unified CCE installation using the Security Wizard tool. |
![]() Note |
If AppDynamics Monitoring was enabled on the ICM source machine, it will not be automatically enabled based on the source machine’s configuration during the Technology Refresh Upgrade. For deployments using AppDynamics for monitoring, it is necessary to manually configure and enable performance monitoring on the destination machines after completing the Technology Refresh Upgrade. |
![]() Note |
If the system is enabled with TDE, see Enable and Disable TDE on a Database. |
Preupgrade Tools
During the preupgrade process, use the following tools as required:
-
User Migration Tool—A standalone Windows command-line application used for all upgrades that involve a change of domain. The tool exports all existing user accounts (config/setup and supervisors) from the source domain to a .bin file. The file is used in the target domain during the upgrade.
You can download the User Migration Tool from Cisco.com by clicking ICM User Migration Tool Software.
-
ICM12.6.2.exe—The Unified CCE patch installer. It copies all files into relevant folders, updates the registries, and installs needed third-party software such as JRE, Apache Tomcat, and Microsoft .NET Framework.
-
Regutil Tool—Used in Technology Refresh upgrades, the tool exports the Cisco Systems, Inc. registry from the source machine during the preupgrade process. The output of the tool is required on the destination machine when running the Unified CCE Installer during the upgrade process.
You can download the Regutil Tool from Cisco.com by clicking Contact Center Enterprise Tools.
-
Cisco Unified Intelligent Contact Management Database Administration (ICMDBA) Tool—Used to create new databases, modify or delete existing databases, and perform limited SQL Server configuration tasks.
The ICMDBA Tool is delivered with the main installer.
-
Domain Manager—Used to provision Active Directory.
The Domain Manager Tool is delivered with the main installer.
-
Upgrade.exe—Used to upgrade the schema of the logger, AW DB, HDS DB, and BA databases to a version compatible with the current Unified CCE software version. It is typically used when the installer fails to automatically upgrade the schema.
Perform the following steps to use the tool:
<ICM install directory>:\icm\bin>upgrade.exe -s <Server Name> -d <Database name> -dt <Database Type> -i <Instance Name>
Where
<Database Type> - can be either " logger" or "hds" or "aw" or "ba", depending on the database that requires the schema to be upgraded.