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.
During the preupgrade process, use the following tools as required:
User Migration Tool—A standalone Windows command-line application that is used for all upgrades that involve a change of domain. The tool exports all existing user accounts (config/setup and supervisors) in the source domain into a flat 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.
Regutil Tool—Used in Technology Refresh upgrades, 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.
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 CCE Software version. It is typically used when the installer fails to automatically upgrade the schema of the AW database. The other databases are typically upgraded using EDMT and not the installer.
Perform the following steps to use the tool:
<Install Drive>: \icm\bin>upgrade.exe -s <Server Name> -d <Database name> -dt <Database Type> -i <Instance Name>
<Database Type> - can be either " logger" or "hds" or "aw" or "ba", depending on the database that requires the schema to be upgraded.
Enhanced Database Migration Tool (EDMT)—A wizard application that is used for all upgrades to migrate the HDS, Logger, and BA databases during the upgrade process.
You can download the EDMT from Cisco.com by clicking Cisco Enhanced Data Migration Tool Software Releases.
The prerequisites for running EDMT are:
EDMT also requires Microsoft® ODBC Driver 11 for SQL Server® andDriver 11 for SQL Server® and Visual C++ Redistributable for Visual Studio 2015 . The latest version of these packages can be downloaded from the Microsoft website. However, a copy of the same is also available in the Prerequisites folder of EDMT.
The EDMT displays status messages during the migration process, including warnings and errors. Warnings are displayed for informational purposes only and do not stop the migration. Errors stop the migration process and leave the database in a corrupt state. If an error occurs, restore the database from your backup, fix the error, and run the tool again.
If you are configuring SQL services to run as Virtual account (NT SERVICE) or Network Service account (NT AUTHORITY\NETWORK SERVICE), you must run EDMT as an administrator.
The installer, not the EDMT, upgrades the AW database for the Administration & Data Server.
User Role Update Tool—A powershell script which is required to be executed in any one of the distributor boxes once after the upgrade. Logger, Router and distributor services should be running before running this tool. The User Role Update tool gets the AD security group membership (config and setup groups) of the users in User_Group table and update the UserRole column.