cisco unified contact center express data migration tool ...€¦ · then perform the data...

58
Americas Headquarters: Cisco Systems, Inc., 170 West Tasman Drive, San Jose, CA 95134-1706 USA © 2009 Cisco Systems, Inc. All rights reserved. Cisco Unified Contact Center Express Data Migration Tool User Guide, Release 1.0 Cisco Unified Contact Center Express and Cisco Unified IP IVR October, 2009 This document describes the Data Migration Tool (DMT, version 1.0), explains how to use it, and provides information about the data migration process including automated backup 1 and restore 2 activities. Use this document if you are running Cisco Customer Response Solutions (CRS) or Cisco IP IVR 4.0(5/5a) and are ready to upgrade to Cisco Unified Contact Center Express (Unified CCX) or Cisco Unified IP IVR 7.0(1). Note For information on supported releases, refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide. 1. In this document, this 'backup' always refers to backing up data using DMT, unless otherwise specified, such as backing up data using the Backup And Restore System (BARS). 2. In this document, this 'restore' always refers to restoring data using DMT, unless otherwise specified, such as restoring data using the BARS.

Upload: others

Post on 22-Sep-2020

0 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Cisco Unified Contact Center Express and Cisco Unified IP IVR

October 2009

This document describes the Data Migration Tool (DMT version 10) explains how to use it and provides information about the data migration process including automated backup1 and restore2 activities

Use this document if you are running Cisco Customer Response Solutions (CRS) or Cisco IP IVR 40(55a) and are ready to upgrade to Cisco Unified Contact Center Express (Unified CCX) or Cisco Unified IP IVR 70(1)

Note For information on supported releases refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

1 In this document this backup always refers to backing up data using DMT unless otherwise specified such as backing up data using the Backup And Restore System (BARS)

2 In this document this restore always refers to restoring data using DMT unless otherwise specified such as restoring data using the BARS

Americas Headquarters Cisco Systems Inc 170 West Tasman Drive San Jose CA 95134-1706 USAcopy 2009 Cisco Systems Inc All rights reserved

Overview of DMT

This document contains the following sections

bull Overview of DMT page 2

bull Obtain DMT page 4

bull Prerequisite page 5

bull Important Considerations page 7

bull Back Up Cisco CRS 40(55a) System Data page 9

bull Upgrade Cisco CRS 40(55a) System page 21

bull Restore the Backed Up Data page 23

bull View Log Files page 39

bull Troubleshooting Tips page 40

bull Best Practices page 57

bull Obtain Additional Support and Documentation page 58

Overview of DMTDMT migrates data by backing it up from a system running CRS 40(55a) and restoring the backed up data automatically on a system installed with Unified CCX 70(1) while you upgrade from CRS 40(55a) to Unified CCX 70(1)

Note DMT supports the backup process on a system running CRS 40(55a) and its services releases (SR1 and SR2) including ES releases if any

Restoring backed up data on the Unified CCX 70(1) system must be done as soon as you finish installing Unified CCX 70(1) on a new system and before you perform the initial setup configuration

Note If you are running Cisco CRS versions earlier than 40(55a) upgrade to Cisco CRS 40(55a) in order to use this tool You can also manually upgrade to Cisco CRS 5x using the available white paper and then refer to the Cisco Unified CCX 70(1) Installation Guide to upgrade to Unified CCX 70(1)

2Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Overview of DMT

The entire upgrade process from CRS 40(55a) to Unified CCX 70(1) involves the following steps

1 Backing up data on the CRS 40(55a) system

2 Upgrading to latest compatible Cisco Unified Communications Manager (Unified CM) and installing Unified CCX 70(1)

Note While the data migration activity using DMT on the CRS 40(55a) system currently supports the Cisco CallManager versions 41(3) and 42(3) refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide to find all the supported versions of Cisco Unified CM compatible with the Unified CCX 70(1) system to successfully perform the data migration activity If you are running any other version of Cisco CallManager with your CRS 40(55a) system upgrade Cisco CallManager to the version 41(3) or 42(3) and then perform the data migration activity For more information refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

3 Restoring the backed up data on a Unified CCX 70(1) system

Caution DMT only supports the base version of Unified CCX 70(1) for the successful data migration process

3Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain DMT

Obtain DMTDMT version 10 is available on the Download Software page of Ciscocom To obtain DMT perform the following steps and download it on your CRS 40(55a) system Only a registered user of Ciscocom can download this application

Step 1 Go to the software download page on Ciscocom

Step 2 Follow the prompts and provide the required information to download the tool

Step 3 Unzip the downloaded ZIP file which should contain the following files and folders (see Figure 1)

Figure 1 Contents of the Downloaded ZIP file

4Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Prerequisite

PrerequisiteBefore you run this tool and start the data migration activity it is recommended that you verify the following and perform any necessary steps

bull Hard disk compatibility and database (DB) size of the system on which you plan to upgrade while using Microsoft SQL Server Check the hard disk compatibility and supported database (DB) size of the Unified CCX 70(1) system according to the following matrix (see Table 1)

Table 1

Hard disk size on Unified CCX 70(1) system

Data allowed to migrate to Unified CCX 70(1) system

DB Type on Unified CCX 70(1) system

Less than or equal to 72GB 7GB MS SQL Server

Greater than 72GB 10GB MS SQL Server

Any size 1GB MSDE

Disk Space Matrix on Unified CCX 70(1) System for Data Migration

Warning The minimum disk space to store the backed up data on the Unified CCX 70(1) system must be 10 more than the migrated data size

Note If you are currently not running on any of the supported hardware (as mentioned in the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide) of Cisco Unified CCX 70(1) or later releases then it is recommended to procure the hardware supported for Unified CCX 70(1) according to your deployment model (Standalone or High Availability)

bull Maximum supported DB size of the Unified CCX 70(1) system Before you run DMT check the maximum supported DB size of the Unified CCX 70(1) system on which you plan to upgrade If the DB size to be backed up on your CRS 40(55a) system is more than the DB size allowed on the Unified CCX 70(1) system you have to purge the excess data until the DB size is reduced to the allowed DB size (see Table 1) on the Unified CCX 70(1) system

5Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Prerequisite

Note It is recommended that you check the DB size manually before you take the backup as this is out of the purview of this tool

While backing up data on your CRS 40(55a) system you have to manually purge the data on the source system if the size of the DB to be migrated is more than the DB size allowed (see Table 1) For more information on purging refer to the Cisco Unified CCX Administration Guide available at

httpwwwciscocomenUSproductsswcustcoswps1846products_installation_and_configuration_guides_listhtml

However while restoring data the Data Migration tool logically purges any excess data if the size of the data getting migrated is higher than the allowed DB size on the Unified CCX 70(1) system

Warning You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Storage space for the backup Make sure that your system running CRS 40(55a) or the network location intended to store the backup data has enough disk space

Note It is recommended that you remove all unnecessary data not related to CRS 40(55a) in order to store the backed up data on your CRS 40(55a) system

bull Keep new Unified CCX 70(1) licenses handy Procure Unified CCX 70(1) licenses before you start the data migration activity If you do not have the license handy or have not procured yet open a case with the Cisco license team (licensingciscocom)

bull Use Base version of Unified CCX 70(1) DMT only supports the base version of Unified CCX 70(1) to successfully carry out the data migration process DMT will not support any SRES version on top of Unified CCX 70(1) base version

6Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Important Considerations

bull Disk space for Microsoft Desktop Engine (MSDE) Installation For MSDE installation the buffer space on the Unified CCX 70(1) system is set to 1GB (to enable you to migrate up to a maximum 1GB of data) while another 1GB space is allocated for new calls resulting a total of 2GB for MSDE data (see Table 1)

Important ConsiderationsBefore you start the data migration process using DMT you must consider the following

bull Use the latest compatible Backup And Restore System (BARS) to take the regular backup of the entire CRS 40(55a) system data before starting the data migration activity To download the latest version of BARS visit httpwwwciscocomkobayashisw-centerindexshtml

bull Use the latest Data Migration Assistant (DMA) tool compatible with the chosen version of Unified CM to upgrade Cisco CallManager

bull Stop the Node Manager from services before you run the DMA tool to upgrade Cisco CallManager in co-resident deployment setup

bull Upgrade Cisco CallManager using DMA to a version compatible with Unified CCX 70(1) prior to performing the restore process To find the latest version of Unified CM and its compatibility matrix refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

bull During Cisco CallManager upgrade using DMA the passwords for all the CRS 40(55a) users (including Agents Supervisors Administrators and Historical users) are reset to the default one that you specify during the Cisco CallManager upgrade

bull Upgrade all the CRS 40(55a) supported software using their own utilities to a version that is compatible with Unified CCX 70(1) For more information refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

bull DMT will discard all active call-related data (data accumulated if your call center is operational while DMT is running) during or after the backup process

7Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Important Considerations

bull Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any currently active on all CRS 40(55a) nodes in the cluster and on the Unified CCX 70(1) system before you start using DMT

bull Restore the backed up data on the Unified CCX 70(1) system before you perform the initial setup configuration on it

bull At any given time during the data migration only a single instance of DMT can remain active

bull Manually install the third-party ODBC drivers (if any on the CRS 40(55a) system) and create all the system DSN configurations (if any) on the Unified CCX 70(1) system even though DMT migrates all the Data source and Enterprise Database Subsystem Configurations

bull DMT will only back up the current active LDAP profile configuration data available on your CRS 40(55a) system

bull It is strongly recommended to retain the same IP address for the Unified CCX 70(1) system as it was for your CRS 40(55a) system However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

bull It is important that you install an SRES update on the Unified CCX 70(1) machine only after completing the data migration process

bull Backing up process using DMT for 10GB of data might take up to 40 minutes on an average loaded CRS 40(55a) system However restoring the same amount of data using DMT on a Unified CCX 70(1) system might take up to 3 hours Therefore you must consider that the time required to complete the backup and restore process using DMT may vary as it is entirely dependent on the amount of HR and configuration data (including CAD data) available on the CRS 40(55a) system and the deployment model of the Unified CCX 70(1) system

8Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Back Up Cisco CRS 40(55a) System DataThe automated backup process using DMT UCCXDataMigratorexe helps you migrate all historical and configuration data available on your CRS 40(55a) system

DMT supports migrating up to 10GB of data to ensure availability of adequate space on the Unified CCX 70(1) system after the data migration activity However if DMT finds that the data size is greater than 10 GB on the CRS 40(55a) system it prompts the user to manually purge the data before it proceeds with the backup activity

DMT saves the backed up data in a tape archive (TAR) file at a location that you specify during the backup activity

Data migration on the CRS 40(55a) system involves the following

bull Perform the Pre-Backup Activities page 9

bull Run the Backup Process page 10

bull Perform the Post-Backup Activities page 20

Perform the Pre-Backup ActivitiesBefore DMT starts backing up the data on the CRS 40(55a) system verify whether you have performed the following pre-backup activities

1 Use BARS to take the regular backup of the CRS 40(55a) system

2 Verify that the call center is not operational as you may lose some historical data if the call center is operational during the backup activity

3 Make sure that all the nodes in the cluster and the Unified CM are up and running

4 Make sure that there is enough space available to store the backup on the desired network location

5 Ensure that the data on the CRS 40(55a) system and Unified CM are in sync by clicking the JTAPI Resynchronization option in the Application Administration Web interface

6 Procure all the necessary Unified CCX 70(1) licenses and keep them handy

9Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on all the CRS 40(55a) nodes in the cluster

8 Convert all the recording data (audio files) using the RAW to WAV utility and store at a secure server on the network

9 Capture screenshots for all the system DSN configurations and alarm definitions in order to be able to re-create them in Unified CCX 70(1) system

Run the Backup ProcessRunning the backup process using DMT backs up all historical and configuration data available on your CRS 40(55a) system Make sure your CRS 40(55a) system has enough space to stage the backed up data

Step 1 Download the DMT ZIP file containing UCCXDataMigratorexe on your CRS 40(55a) system

Warning DMT should always be run from the DB Publisher node of the CRS 40(55a) system

Tip Keep the UCCXDataMigratorzip file at a safe location as you will need it again to restore the backed up data on the Unified CCX 70(1) system

Step 2 Double-click to run the UCCXDataMigratorexe file The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 2)

10Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 2 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Backup Checklist window appears (see Figure 3)

Note To quit DMT and stop the backup activity at any time choose File gt Exit

11Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 3 Pre-Backup Checklist Window

Step 4 Read through all the listed activities in the Pre-Backup Checklist window and ensure to perform and complete each one of them before proceeding with the backup activity

Step 5 Click Accept The Backup Storage Location window appears (see Figure 4)

12Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 4 Backup Storage Location Window

Step 6 In the Backup Storage Location window choose the destination where DMT stores the TAR file

a Network Directory Stores the TAR file on a network location

ndash Backup locationmdashNetwork path or IP address of the system that should store the backup file

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder that should store the backup file

13Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

b LocalShared Directory Stores the TAR file on thelocal drive (on which you are running the DMT) or a shared location (can be a network location with read and write access but without requiring user authentication) In the Path Name field enter the path to the localshared folder manually or click Browse to choose a localshared folder that should store the backup file

Step 7 Click Next DMT starts backing up the data to the specified backup storage location and the Backup in Progress window appears (see Figure 5)

Figure 5 Backup in Progress Window

Step 8 If you have specified a local drive to store the backup on the CRS 40(55a) system a warning message might appear to prompt you to save the backup TAR file to a safe network location (see Figure 6)

14Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 6 Warning Message to Store the Backup at a Safe Network

Location

Step 9 The data is backed up to the said location A status window is displayed once DMT successfully completes the backup operation (see Figure 7)

15Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 7 Status Message for Successful Backup Operation

Step 10 Click OK on the status message and you can view the detailed status including the location of the log file (see Figure 8)

16Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 8 Detailed Status Window Highlighting Location of the Log File

If the backup operation does not complete successfully the status window displays the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

Step 11 Click Next The Post-Backup Checklist window appears (see Figure 9) This checklist reminds you of the tasks that you need to perform after the backup process

17Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 9 Post-Backup Checklist Window

Step 12 Click Finish The Exit Confirmation window appears (see Figure 10)

Figure 10 Exit Confirmation Window

Step 13 Click Yes to quit DMT

DMT records all historical and configuration data and automatically backs up the database to the specified storage location either on your CRS 40(55a) system or on a safe network location in the TAR format

18Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

View Backup TAR File Details

After you complete the backup activity you can validate the backup TAR file and view its details To validate the backed up TAR file and view its details do the following

Step 1 From the Cisco Unified CCX Data Migration Tool Home window choose Options gt Check Archive

The Enter the location of a valid backup file window appears (see Figure 11)

Figure 11 Enter the Location of a Valid Backup File Window

Step 2 Enter the location information and user credentials of the latest TAR file you backed up

Step 3 Click Validate DMT validates the backup TAR file and displays the Data Migration Backup File Info window (see Figure 12)

19Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 2: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Overview of DMT

This document contains the following sections

bull Overview of DMT page 2

bull Obtain DMT page 4

bull Prerequisite page 5

bull Important Considerations page 7

bull Back Up Cisco CRS 40(55a) System Data page 9

bull Upgrade Cisco CRS 40(55a) System page 21

bull Restore the Backed Up Data page 23

bull View Log Files page 39

bull Troubleshooting Tips page 40

bull Best Practices page 57

bull Obtain Additional Support and Documentation page 58

Overview of DMTDMT migrates data by backing it up from a system running CRS 40(55a) and restoring the backed up data automatically on a system installed with Unified CCX 70(1) while you upgrade from CRS 40(55a) to Unified CCX 70(1)

Note DMT supports the backup process on a system running CRS 40(55a) and its services releases (SR1 and SR2) including ES releases if any

Restoring backed up data on the Unified CCX 70(1) system must be done as soon as you finish installing Unified CCX 70(1) on a new system and before you perform the initial setup configuration

Note If you are running Cisco CRS versions earlier than 40(55a) upgrade to Cisco CRS 40(55a) in order to use this tool You can also manually upgrade to Cisco CRS 5x using the available white paper and then refer to the Cisco Unified CCX 70(1) Installation Guide to upgrade to Unified CCX 70(1)

2Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Overview of DMT

The entire upgrade process from CRS 40(55a) to Unified CCX 70(1) involves the following steps

1 Backing up data on the CRS 40(55a) system

2 Upgrading to latest compatible Cisco Unified Communications Manager (Unified CM) and installing Unified CCX 70(1)

Note While the data migration activity using DMT on the CRS 40(55a) system currently supports the Cisco CallManager versions 41(3) and 42(3) refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide to find all the supported versions of Cisco Unified CM compatible with the Unified CCX 70(1) system to successfully perform the data migration activity If you are running any other version of Cisco CallManager with your CRS 40(55a) system upgrade Cisco CallManager to the version 41(3) or 42(3) and then perform the data migration activity For more information refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

3 Restoring the backed up data on a Unified CCX 70(1) system

Caution DMT only supports the base version of Unified CCX 70(1) for the successful data migration process

3Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain DMT

Obtain DMTDMT version 10 is available on the Download Software page of Ciscocom To obtain DMT perform the following steps and download it on your CRS 40(55a) system Only a registered user of Ciscocom can download this application

Step 1 Go to the software download page on Ciscocom

Step 2 Follow the prompts and provide the required information to download the tool

Step 3 Unzip the downloaded ZIP file which should contain the following files and folders (see Figure 1)

Figure 1 Contents of the Downloaded ZIP file

4Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Prerequisite

PrerequisiteBefore you run this tool and start the data migration activity it is recommended that you verify the following and perform any necessary steps

bull Hard disk compatibility and database (DB) size of the system on which you plan to upgrade while using Microsoft SQL Server Check the hard disk compatibility and supported database (DB) size of the Unified CCX 70(1) system according to the following matrix (see Table 1)

Table 1

Hard disk size on Unified CCX 70(1) system

Data allowed to migrate to Unified CCX 70(1) system

DB Type on Unified CCX 70(1) system

Less than or equal to 72GB 7GB MS SQL Server

Greater than 72GB 10GB MS SQL Server

Any size 1GB MSDE

Disk Space Matrix on Unified CCX 70(1) System for Data Migration

Warning The minimum disk space to store the backed up data on the Unified CCX 70(1) system must be 10 more than the migrated data size

Note If you are currently not running on any of the supported hardware (as mentioned in the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide) of Cisco Unified CCX 70(1) or later releases then it is recommended to procure the hardware supported for Unified CCX 70(1) according to your deployment model (Standalone or High Availability)

bull Maximum supported DB size of the Unified CCX 70(1) system Before you run DMT check the maximum supported DB size of the Unified CCX 70(1) system on which you plan to upgrade If the DB size to be backed up on your CRS 40(55a) system is more than the DB size allowed on the Unified CCX 70(1) system you have to purge the excess data until the DB size is reduced to the allowed DB size (see Table 1) on the Unified CCX 70(1) system

5Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Prerequisite

Note It is recommended that you check the DB size manually before you take the backup as this is out of the purview of this tool

While backing up data on your CRS 40(55a) system you have to manually purge the data on the source system if the size of the DB to be migrated is more than the DB size allowed (see Table 1) For more information on purging refer to the Cisco Unified CCX Administration Guide available at

httpwwwciscocomenUSproductsswcustcoswps1846products_installation_and_configuration_guides_listhtml

However while restoring data the Data Migration tool logically purges any excess data if the size of the data getting migrated is higher than the allowed DB size on the Unified CCX 70(1) system

Warning You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Storage space for the backup Make sure that your system running CRS 40(55a) or the network location intended to store the backup data has enough disk space

Note It is recommended that you remove all unnecessary data not related to CRS 40(55a) in order to store the backed up data on your CRS 40(55a) system

bull Keep new Unified CCX 70(1) licenses handy Procure Unified CCX 70(1) licenses before you start the data migration activity If you do not have the license handy or have not procured yet open a case with the Cisco license team (licensingciscocom)

bull Use Base version of Unified CCX 70(1) DMT only supports the base version of Unified CCX 70(1) to successfully carry out the data migration process DMT will not support any SRES version on top of Unified CCX 70(1) base version

6Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Important Considerations

bull Disk space for Microsoft Desktop Engine (MSDE) Installation For MSDE installation the buffer space on the Unified CCX 70(1) system is set to 1GB (to enable you to migrate up to a maximum 1GB of data) while another 1GB space is allocated for new calls resulting a total of 2GB for MSDE data (see Table 1)

Important ConsiderationsBefore you start the data migration process using DMT you must consider the following

bull Use the latest compatible Backup And Restore System (BARS) to take the regular backup of the entire CRS 40(55a) system data before starting the data migration activity To download the latest version of BARS visit httpwwwciscocomkobayashisw-centerindexshtml

bull Use the latest Data Migration Assistant (DMA) tool compatible with the chosen version of Unified CM to upgrade Cisco CallManager

bull Stop the Node Manager from services before you run the DMA tool to upgrade Cisco CallManager in co-resident deployment setup

bull Upgrade Cisco CallManager using DMA to a version compatible with Unified CCX 70(1) prior to performing the restore process To find the latest version of Unified CM and its compatibility matrix refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

bull During Cisco CallManager upgrade using DMA the passwords for all the CRS 40(55a) users (including Agents Supervisors Administrators and Historical users) are reset to the default one that you specify during the Cisco CallManager upgrade

bull Upgrade all the CRS 40(55a) supported software using their own utilities to a version that is compatible with Unified CCX 70(1) For more information refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

bull DMT will discard all active call-related data (data accumulated if your call center is operational while DMT is running) during or after the backup process

7Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Important Considerations

bull Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any currently active on all CRS 40(55a) nodes in the cluster and on the Unified CCX 70(1) system before you start using DMT

bull Restore the backed up data on the Unified CCX 70(1) system before you perform the initial setup configuration on it

bull At any given time during the data migration only a single instance of DMT can remain active

bull Manually install the third-party ODBC drivers (if any on the CRS 40(55a) system) and create all the system DSN configurations (if any) on the Unified CCX 70(1) system even though DMT migrates all the Data source and Enterprise Database Subsystem Configurations

bull DMT will only back up the current active LDAP profile configuration data available on your CRS 40(55a) system

bull It is strongly recommended to retain the same IP address for the Unified CCX 70(1) system as it was for your CRS 40(55a) system However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

bull It is important that you install an SRES update on the Unified CCX 70(1) machine only after completing the data migration process

bull Backing up process using DMT for 10GB of data might take up to 40 minutes on an average loaded CRS 40(55a) system However restoring the same amount of data using DMT on a Unified CCX 70(1) system might take up to 3 hours Therefore you must consider that the time required to complete the backup and restore process using DMT may vary as it is entirely dependent on the amount of HR and configuration data (including CAD data) available on the CRS 40(55a) system and the deployment model of the Unified CCX 70(1) system

8Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Back Up Cisco CRS 40(55a) System DataThe automated backup process using DMT UCCXDataMigratorexe helps you migrate all historical and configuration data available on your CRS 40(55a) system

DMT supports migrating up to 10GB of data to ensure availability of adequate space on the Unified CCX 70(1) system after the data migration activity However if DMT finds that the data size is greater than 10 GB on the CRS 40(55a) system it prompts the user to manually purge the data before it proceeds with the backup activity

DMT saves the backed up data in a tape archive (TAR) file at a location that you specify during the backup activity

Data migration on the CRS 40(55a) system involves the following

bull Perform the Pre-Backup Activities page 9

bull Run the Backup Process page 10

bull Perform the Post-Backup Activities page 20

Perform the Pre-Backup ActivitiesBefore DMT starts backing up the data on the CRS 40(55a) system verify whether you have performed the following pre-backup activities

1 Use BARS to take the regular backup of the CRS 40(55a) system

2 Verify that the call center is not operational as you may lose some historical data if the call center is operational during the backup activity

3 Make sure that all the nodes in the cluster and the Unified CM are up and running

4 Make sure that there is enough space available to store the backup on the desired network location

5 Ensure that the data on the CRS 40(55a) system and Unified CM are in sync by clicking the JTAPI Resynchronization option in the Application Administration Web interface

6 Procure all the necessary Unified CCX 70(1) licenses and keep them handy

9Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on all the CRS 40(55a) nodes in the cluster

8 Convert all the recording data (audio files) using the RAW to WAV utility and store at a secure server on the network

9 Capture screenshots for all the system DSN configurations and alarm definitions in order to be able to re-create them in Unified CCX 70(1) system

Run the Backup ProcessRunning the backup process using DMT backs up all historical and configuration data available on your CRS 40(55a) system Make sure your CRS 40(55a) system has enough space to stage the backed up data

Step 1 Download the DMT ZIP file containing UCCXDataMigratorexe on your CRS 40(55a) system

Warning DMT should always be run from the DB Publisher node of the CRS 40(55a) system

Tip Keep the UCCXDataMigratorzip file at a safe location as you will need it again to restore the backed up data on the Unified CCX 70(1) system

Step 2 Double-click to run the UCCXDataMigratorexe file The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 2)

10Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 2 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Backup Checklist window appears (see Figure 3)

Note To quit DMT and stop the backup activity at any time choose File gt Exit

11Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 3 Pre-Backup Checklist Window

Step 4 Read through all the listed activities in the Pre-Backup Checklist window and ensure to perform and complete each one of them before proceeding with the backup activity

Step 5 Click Accept The Backup Storage Location window appears (see Figure 4)

12Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 4 Backup Storage Location Window

Step 6 In the Backup Storage Location window choose the destination where DMT stores the TAR file

a Network Directory Stores the TAR file on a network location

ndash Backup locationmdashNetwork path or IP address of the system that should store the backup file

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder that should store the backup file

13Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

b LocalShared Directory Stores the TAR file on thelocal drive (on which you are running the DMT) or a shared location (can be a network location with read and write access but without requiring user authentication) In the Path Name field enter the path to the localshared folder manually or click Browse to choose a localshared folder that should store the backup file

Step 7 Click Next DMT starts backing up the data to the specified backup storage location and the Backup in Progress window appears (see Figure 5)

Figure 5 Backup in Progress Window

Step 8 If you have specified a local drive to store the backup on the CRS 40(55a) system a warning message might appear to prompt you to save the backup TAR file to a safe network location (see Figure 6)

14Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 6 Warning Message to Store the Backup at a Safe Network

Location

Step 9 The data is backed up to the said location A status window is displayed once DMT successfully completes the backup operation (see Figure 7)

15Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 7 Status Message for Successful Backup Operation

Step 10 Click OK on the status message and you can view the detailed status including the location of the log file (see Figure 8)

16Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 8 Detailed Status Window Highlighting Location of the Log File

If the backup operation does not complete successfully the status window displays the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

Step 11 Click Next The Post-Backup Checklist window appears (see Figure 9) This checklist reminds you of the tasks that you need to perform after the backup process

17Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 9 Post-Backup Checklist Window

Step 12 Click Finish The Exit Confirmation window appears (see Figure 10)

Figure 10 Exit Confirmation Window

Step 13 Click Yes to quit DMT

DMT records all historical and configuration data and automatically backs up the database to the specified storage location either on your CRS 40(55a) system or on a safe network location in the TAR format

18Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

View Backup TAR File Details

After you complete the backup activity you can validate the backup TAR file and view its details To validate the backed up TAR file and view its details do the following

Step 1 From the Cisco Unified CCX Data Migration Tool Home window choose Options gt Check Archive

The Enter the location of a valid backup file window appears (see Figure 11)

Figure 11 Enter the Location of a Valid Backup File Window

Step 2 Enter the location information and user credentials of the latest TAR file you backed up

Step 3 Click Validate DMT validates the backup TAR file and displays the Data Migration Backup File Info window (see Figure 12)

19Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 3: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Overview of DMT

The entire upgrade process from CRS 40(55a) to Unified CCX 70(1) involves the following steps

1 Backing up data on the CRS 40(55a) system

2 Upgrading to latest compatible Cisco Unified Communications Manager (Unified CM) and installing Unified CCX 70(1)

Note While the data migration activity using DMT on the CRS 40(55a) system currently supports the Cisco CallManager versions 41(3) and 42(3) refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide to find all the supported versions of Cisco Unified CM compatible with the Unified CCX 70(1) system to successfully perform the data migration activity If you are running any other version of Cisco CallManager with your CRS 40(55a) system upgrade Cisco CallManager to the version 41(3) or 42(3) and then perform the data migration activity For more information refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

3 Restoring the backed up data on a Unified CCX 70(1) system

Caution DMT only supports the base version of Unified CCX 70(1) for the successful data migration process

3Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain DMT

Obtain DMTDMT version 10 is available on the Download Software page of Ciscocom To obtain DMT perform the following steps and download it on your CRS 40(55a) system Only a registered user of Ciscocom can download this application

Step 1 Go to the software download page on Ciscocom

Step 2 Follow the prompts and provide the required information to download the tool

Step 3 Unzip the downloaded ZIP file which should contain the following files and folders (see Figure 1)

Figure 1 Contents of the Downloaded ZIP file

4Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Prerequisite

PrerequisiteBefore you run this tool and start the data migration activity it is recommended that you verify the following and perform any necessary steps

bull Hard disk compatibility and database (DB) size of the system on which you plan to upgrade while using Microsoft SQL Server Check the hard disk compatibility and supported database (DB) size of the Unified CCX 70(1) system according to the following matrix (see Table 1)

Table 1

Hard disk size on Unified CCX 70(1) system

Data allowed to migrate to Unified CCX 70(1) system

DB Type on Unified CCX 70(1) system

Less than or equal to 72GB 7GB MS SQL Server

Greater than 72GB 10GB MS SQL Server

Any size 1GB MSDE

Disk Space Matrix on Unified CCX 70(1) System for Data Migration

Warning The minimum disk space to store the backed up data on the Unified CCX 70(1) system must be 10 more than the migrated data size

Note If you are currently not running on any of the supported hardware (as mentioned in the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide) of Cisco Unified CCX 70(1) or later releases then it is recommended to procure the hardware supported for Unified CCX 70(1) according to your deployment model (Standalone or High Availability)

bull Maximum supported DB size of the Unified CCX 70(1) system Before you run DMT check the maximum supported DB size of the Unified CCX 70(1) system on which you plan to upgrade If the DB size to be backed up on your CRS 40(55a) system is more than the DB size allowed on the Unified CCX 70(1) system you have to purge the excess data until the DB size is reduced to the allowed DB size (see Table 1) on the Unified CCX 70(1) system

5Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Prerequisite

Note It is recommended that you check the DB size manually before you take the backup as this is out of the purview of this tool

While backing up data on your CRS 40(55a) system you have to manually purge the data on the source system if the size of the DB to be migrated is more than the DB size allowed (see Table 1) For more information on purging refer to the Cisco Unified CCX Administration Guide available at

httpwwwciscocomenUSproductsswcustcoswps1846products_installation_and_configuration_guides_listhtml

However while restoring data the Data Migration tool logically purges any excess data if the size of the data getting migrated is higher than the allowed DB size on the Unified CCX 70(1) system

Warning You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Storage space for the backup Make sure that your system running CRS 40(55a) or the network location intended to store the backup data has enough disk space

Note It is recommended that you remove all unnecessary data not related to CRS 40(55a) in order to store the backed up data on your CRS 40(55a) system

bull Keep new Unified CCX 70(1) licenses handy Procure Unified CCX 70(1) licenses before you start the data migration activity If you do not have the license handy or have not procured yet open a case with the Cisco license team (licensingciscocom)

bull Use Base version of Unified CCX 70(1) DMT only supports the base version of Unified CCX 70(1) to successfully carry out the data migration process DMT will not support any SRES version on top of Unified CCX 70(1) base version

6Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Important Considerations

bull Disk space for Microsoft Desktop Engine (MSDE) Installation For MSDE installation the buffer space on the Unified CCX 70(1) system is set to 1GB (to enable you to migrate up to a maximum 1GB of data) while another 1GB space is allocated for new calls resulting a total of 2GB for MSDE data (see Table 1)

Important ConsiderationsBefore you start the data migration process using DMT you must consider the following

bull Use the latest compatible Backup And Restore System (BARS) to take the regular backup of the entire CRS 40(55a) system data before starting the data migration activity To download the latest version of BARS visit httpwwwciscocomkobayashisw-centerindexshtml

bull Use the latest Data Migration Assistant (DMA) tool compatible with the chosen version of Unified CM to upgrade Cisco CallManager

bull Stop the Node Manager from services before you run the DMA tool to upgrade Cisco CallManager in co-resident deployment setup

bull Upgrade Cisco CallManager using DMA to a version compatible with Unified CCX 70(1) prior to performing the restore process To find the latest version of Unified CM and its compatibility matrix refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

bull During Cisco CallManager upgrade using DMA the passwords for all the CRS 40(55a) users (including Agents Supervisors Administrators and Historical users) are reset to the default one that you specify during the Cisco CallManager upgrade

bull Upgrade all the CRS 40(55a) supported software using their own utilities to a version that is compatible with Unified CCX 70(1) For more information refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

bull DMT will discard all active call-related data (data accumulated if your call center is operational while DMT is running) during or after the backup process

7Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Important Considerations

bull Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any currently active on all CRS 40(55a) nodes in the cluster and on the Unified CCX 70(1) system before you start using DMT

bull Restore the backed up data on the Unified CCX 70(1) system before you perform the initial setup configuration on it

bull At any given time during the data migration only a single instance of DMT can remain active

bull Manually install the third-party ODBC drivers (if any on the CRS 40(55a) system) and create all the system DSN configurations (if any) on the Unified CCX 70(1) system even though DMT migrates all the Data source and Enterprise Database Subsystem Configurations

bull DMT will only back up the current active LDAP profile configuration data available on your CRS 40(55a) system

bull It is strongly recommended to retain the same IP address for the Unified CCX 70(1) system as it was for your CRS 40(55a) system However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

bull It is important that you install an SRES update on the Unified CCX 70(1) machine only after completing the data migration process

bull Backing up process using DMT for 10GB of data might take up to 40 minutes on an average loaded CRS 40(55a) system However restoring the same amount of data using DMT on a Unified CCX 70(1) system might take up to 3 hours Therefore you must consider that the time required to complete the backup and restore process using DMT may vary as it is entirely dependent on the amount of HR and configuration data (including CAD data) available on the CRS 40(55a) system and the deployment model of the Unified CCX 70(1) system

8Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Back Up Cisco CRS 40(55a) System DataThe automated backup process using DMT UCCXDataMigratorexe helps you migrate all historical and configuration data available on your CRS 40(55a) system

DMT supports migrating up to 10GB of data to ensure availability of adequate space on the Unified CCX 70(1) system after the data migration activity However if DMT finds that the data size is greater than 10 GB on the CRS 40(55a) system it prompts the user to manually purge the data before it proceeds with the backup activity

DMT saves the backed up data in a tape archive (TAR) file at a location that you specify during the backup activity

Data migration on the CRS 40(55a) system involves the following

bull Perform the Pre-Backup Activities page 9

bull Run the Backup Process page 10

bull Perform the Post-Backup Activities page 20

Perform the Pre-Backup ActivitiesBefore DMT starts backing up the data on the CRS 40(55a) system verify whether you have performed the following pre-backup activities

1 Use BARS to take the regular backup of the CRS 40(55a) system

2 Verify that the call center is not operational as you may lose some historical data if the call center is operational during the backup activity

3 Make sure that all the nodes in the cluster and the Unified CM are up and running

4 Make sure that there is enough space available to store the backup on the desired network location

5 Ensure that the data on the CRS 40(55a) system and Unified CM are in sync by clicking the JTAPI Resynchronization option in the Application Administration Web interface

6 Procure all the necessary Unified CCX 70(1) licenses and keep them handy

9Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on all the CRS 40(55a) nodes in the cluster

8 Convert all the recording data (audio files) using the RAW to WAV utility and store at a secure server on the network

9 Capture screenshots for all the system DSN configurations and alarm definitions in order to be able to re-create them in Unified CCX 70(1) system

Run the Backup ProcessRunning the backup process using DMT backs up all historical and configuration data available on your CRS 40(55a) system Make sure your CRS 40(55a) system has enough space to stage the backed up data

Step 1 Download the DMT ZIP file containing UCCXDataMigratorexe on your CRS 40(55a) system

Warning DMT should always be run from the DB Publisher node of the CRS 40(55a) system

Tip Keep the UCCXDataMigratorzip file at a safe location as you will need it again to restore the backed up data on the Unified CCX 70(1) system

Step 2 Double-click to run the UCCXDataMigratorexe file The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 2)

10Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 2 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Backup Checklist window appears (see Figure 3)

Note To quit DMT and stop the backup activity at any time choose File gt Exit

11Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 3 Pre-Backup Checklist Window

Step 4 Read through all the listed activities in the Pre-Backup Checklist window and ensure to perform and complete each one of them before proceeding with the backup activity

Step 5 Click Accept The Backup Storage Location window appears (see Figure 4)

12Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 4 Backup Storage Location Window

Step 6 In the Backup Storage Location window choose the destination where DMT stores the TAR file

a Network Directory Stores the TAR file on a network location

ndash Backup locationmdashNetwork path or IP address of the system that should store the backup file

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder that should store the backup file

13Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

b LocalShared Directory Stores the TAR file on thelocal drive (on which you are running the DMT) or a shared location (can be a network location with read and write access but without requiring user authentication) In the Path Name field enter the path to the localshared folder manually or click Browse to choose a localshared folder that should store the backup file

Step 7 Click Next DMT starts backing up the data to the specified backup storage location and the Backup in Progress window appears (see Figure 5)

Figure 5 Backup in Progress Window

Step 8 If you have specified a local drive to store the backup on the CRS 40(55a) system a warning message might appear to prompt you to save the backup TAR file to a safe network location (see Figure 6)

14Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 6 Warning Message to Store the Backup at a Safe Network

Location

Step 9 The data is backed up to the said location A status window is displayed once DMT successfully completes the backup operation (see Figure 7)

15Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 7 Status Message for Successful Backup Operation

Step 10 Click OK on the status message and you can view the detailed status including the location of the log file (see Figure 8)

16Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 8 Detailed Status Window Highlighting Location of the Log File

If the backup operation does not complete successfully the status window displays the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

Step 11 Click Next The Post-Backup Checklist window appears (see Figure 9) This checklist reminds you of the tasks that you need to perform after the backup process

17Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 9 Post-Backup Checklist Window

Step 12 Click Finish The Exit Confirmation window appears (see Figure 10)

Figure 10 Exit Confirmation Window

Step 13 Click Yes to quit DMT

DMT records all historical and configuration data and automatically backs up the database to the specified storage location either on your CRS 40(55a) system or on a safe network location in the TAR format

18Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

View Backup TAR File Details

After you complete the backup activity you can validate the backup TAR file and view its details To validate the backed up TAR file and view its details do the following

Step 1 From the Cisco Unified CCX Data Migration Tool Home window choose Options gt Check Archive

The Enter the location of a valid backup file window appears (see Figure 11)

Figure 11 Enter the Location of a Valid Backup File Window

Step 2 Enter the location information and user credentials of the latest TAR file you backed up

Step 3 Click Validate DMT validates the backup TAR file and displays the Data Migration Backup File Info window (see Figure 12)

19Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 4: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Obtain DMT

Obtain DMTDMT version 10 is available on the Download Software page of Ciscocom To obtain DMT perform the following steps and download it on your CRS 40(55a) system Only a registered user of Ciscocom can download this application

Step 1 Go to the software download page on Ciscocom

Step 2 Follow the prompts and provide the required information to download the tool

Step 3 Unzip the downloaded ZIP file which should contain the following files and folders (see Figure 1)

Figure 1 Contents of the Downloaded ZIP file

4Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Prerequisite

PrerequisiteBefore you run this tool and start the data migration activity it is recommended that you verify the following and perform any necessary steps

bull Hard disk compatibility and database (DB) size of the system on which you plan to upgrade while using Microsoft SQL Server Check the hard disk compatibility and supported database (DB) size of the Unified CCX 70(1) system according to the following matrix (see Table 1)

Table 1

Hard disk size on Unified CCX 70(1) system

Data allowed to migrate to Unified CCX 70(1) system

DB Type on Unified CCX 70(1) system

Less than or equal to 72GB 7GB MS SQL Server

Greater than 72GB 10GB MS SQL Server

Any size 1GB MSDE

Disk Space Matrix on Unified CCX 70(1) System for Data Migration

Warning The minimum disk space to store the backed up data on the Unified CCX 70(1) system must be 10 more than the migrated data size

Note If you are currently not running on any of the supported hardware (as mentioned in the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide) of Cisco Unified CCX 70(1) or later releases then it is recommended to procure the hardware supported for Unified CCX 70(1) according to your deployment model (Standalone or High Availability)

bull Maximum supported DB size of the Unified CCX 70(1) system Before you run DMT check the maximum supported DB size of the Unified CCX 70(1) system on which you plan to upgrade If the DB size to be backed up on your CRS 40(55a) system is more than the DB size allowed on the Unified CCX 70(1) system you have to purge the excess data until the DB size is reduced to the allowed DB size (see Table 1) on the Unified CCX 70(1) system

5Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Prerequisite

Note It is recommended that you check the DB size manually before you take the backup as this is out of the purview of this tool

While backing up data on your CRS 40(55a) system you have to manually purge the data on the source system if the size of the DB to be migrated is more than the DB size allowed (see Table 1) For more information on purging refer to the Cisco Unified CCX Administration Guide available at

httpwwwciscocomenUSproductsswcustcoswps1846products_installation_and_configuration_guides_listhtml

However while restoring data the Data Migration tool logically purges any excess data if the size of the data getting migrated is higher than the allowed DB size on the Unified CCX 70(1) system

Warning You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Storage space for the backup Make sure that your system running CRS 40(55a) or the network location intended to store the backup data has enough disk space

Note It is recommended that you remove all unnecessary data not related to CRS 40(55a) in order to store the backed up data on your CRS 40(55a) system

bull Keep new Unified CCX 70(1) licenses handy Procure Unified CCX 70(1) licenses before you start the data migration activity If you do not have the license handy or have not procured yet open a case with the Cisco license team (licensingciscocom)

bull Use Base version of Unified CCX 70(1) DMT only supports the base version of Unified CCX 70(1) to successfully carry out the data migration process DMT will not support any SRES version on top of Unified CCX 70(1) base version

6Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Important Considerations

bull Disk space for Microsoft Desktop Engine (MSDE) Installation For MSDE installation the buffer space on the Unified CCX 70(1) system is set to 1GB (to enable you to migrate up to a maximum 1GB of data) while another 1GB space is allocated for new calls resulting a total of 2GB for MSDE data (see Table 1)

Important ConsiderationsBefore you start the data migration process using DMT you must consider the following

bull Use the latest compatible Backup And Restore System (BARS) to take the regular backup of the entire CRS 40(55a) system data before starting the data migration activity To download the latest version of BARS visit httpwwwciscocomkobayashisw-centerindexshtml

bull Use the latest Data Migration Assistant (DMA) tool compatible with the chosen version of Unified CM to upgrade Cisco CallManager

bull Stop the Node Manager from services before you run the DMA tool to upgrade Cisco CallManager in co-resident deployment setup

bull Upgrade Cisco CallManager using DMA to a version compatible with Unified CCX 70(1) prior to performing the restore process To find the latest version of Unified CM and its compatibility matrix refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

bull During Cisco CallManager upgrade using DMA the passwords for all the CRS 40(55a) users (including Agents Supervisors Administrators and Historical users) are reset to the default one that you specify during the Cisco CallManager upgrade

bull Upgrade all the CRS 40(55a) supported software using their own utilities to a version that is compatible with Unified CCX 70(1) For more information refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

bull DMT will discard all active call-related data (data accumulated if your call center is operational while DMT is running) during or after the backup process

7Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Important Considerations

bull Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any currently active on all CRS 40(55a) nodes in the cluster and on the Unified CCX 70(1) system before you start using DMT

bull Restore the backed up data on the Unified CCX 70(1) system before you perform the initial setup configuration on it

bull At any given time during the data migration only a single instance of DMT can remain active

bull Manually install the third-party ODBC drivers (if any on the CRS 40(55a) system) and create all the system DSN configurations (if any) on the Unified CCX 70(1) system even though DMT migrates all the Data source and Enterprise Database Subsystem Configurations

bull DMT will only back up the current active LDAP profile configuration data available on your CRS 40(55a) system

bull It is strongly recommended to retain the same IP address for the Unified CCX 70(1) system as it was for your CRS 40(55a) system However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

bull It is important that you install an SRES update on the Unified CCX 70(1) machine only after completing the data migration process

bull Backing up process using DMT for 10GB of data might take up to 40 minutes on an average loaded CRS 40(55a) system However restoring the same amount of data using DMT on a Unified CCX 70(1) system might take up to 3 hours Therefore you must consider that the time required to complete the backup and restore process using DMT may vary as it is entirely dependent on the amount of HR and configuration data (including CAD data) available on the CRS 40(55a) system and the deployment model of the Unified CCX 70(1) system

8Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Back Up Cisco CRS 40(55a) System DataThe automated backup process using DMT UCCXDataMigratorexe helps you migrate all historical and configuration data available on your CRS 40(55a) system

DMT supports migrating up to 10GB of data to ensure availability of adequate space on the Unified CCX 70(1) system after the data migration activity However if DMT finds that the data size is greater than 10 GB on the CRS 40(55a) system it prompts the user to manually purge the data before it proceeds with the backup activity

DMT saves the backed up data in a tape archive (TAR) file at a location that you specify during the backup activity

Data migration on the CRS 40(55a) system involves the following

bull Perform the Pre-Backup Activities page 9

bull Run the Backup Process page 10

bull Perform the Post-Backup Activities page 20

Perform the Pre-Backup ActivitiesBefore DMT starts backing up the data on the CRS 40(55a) system verify whether you have performed the following pre-backup activities

1 Use BARS to take the regular backup of the CRS 40(55a) system

2 Verify that the call center is not operational as you may lose some historical data if the call center is operational during the backup activity

3 Make sure that all the nodes in the cluster and the Unified CM are up and running

4 Make sure that there is enough space available to store the backup on the desired network location

5 Ensure that the data on the CRS 40(55a) system and Unified CM are in sync by clicking the JTAPI Resynchronization option in the Application Administration Web interface

6 Procure all the necessary Unified CCX 70(1) licenses and keep them handy

9Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on all the CRS 40(55a) nodes in the cluster

8 Convert all the recording data (audio files) using the RAW to WAV utility and store at a secure server on the network

9 Capture screenshots for all the system DSN configurations and alarm definitions in order to be able to re-create them in Unified CCX 70(1) system

Run the Backup ProcessRunning the backup process using DMT backs up all historical and configuration data available on your CRS 40(55a) system Make sure your CRS 40(55a) system has enough space to stage the backed up data

Step 1 Download the DMT ZIP file containing UCCXDataMigratorexe on your CRS 40(55a) system

Warning DMT should always be run from the DB Publisher node of the CRS 40(55a) system

Tip Keep the UCCXDataMigratorzip file at a safe location as you will need it again to restore the backed up data on the Unified CCX 70(1) system

Step 2 Double-click to run the UCCXDataMigratorexe file The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 2)

10Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 2 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Backup Checklist window appears (see Figure 3)

Note To quit DMT and stop the backup activity at any time choose File gt Exit

11Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 3 Pre-Backup Checklist Window

Step 4 Read through all the listed activities in the Pre-Backup Checklist window and ensure to perform and complete each one of them before proceeding with the backup activity

Step 5 Click Accept The Backup Storage Location window appears (see Figure 4)

12Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 4 Backup Storage Location Window

Step 6 In the Backup Storage Location window choose the destination where DMT stores the TAR file

a Network Directory Stores the TAR file on a network location

ndash Backup locationmdashNetwork path or IP address of the system that should store the backup file

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder that should store the backup file

13Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

b LocalShared Directory Stores the TAR file on thelocal drive (on which you are running the DMT) or a shared location (can be a network location with read and write access but without requiring user authentication) In the Path Name field enter the path to the localshared folder manually or click Browse to choose a localshared folder that should store the backup file

Step 7 Click Next DMT starts backing up the data to the specified backup storage location and the Backup in Progress window appears (see Figure 5)

Figure 5 Backup in Progress Window

Step 8 If you have specified a local drive to store the backup on the CRS 40(55a) system a warning message might appear to prompt you to save the backup TAR file to a safe network location (see Figure 6)

14Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 6 Warning Message to Store the Backup at a Safe Network

Location

Step 9 The data is backed up to the said location A status window is displayed once DMT successfully completes the backup operation (see Figure 7)

15Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 7 Status Message for Successful Backup Operation

Step 10 Click OK on the status message and you can view the detailed status including the location of the log file (see Figure 8)

16Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 8 Detailed Status Window Highlighting Location of the Log File

If the backup operation does not complete successfully the status window displays the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

Step 11 Click Next The Post-Backup Checklist window appears (see Figure 9) This checklist reminds you of the tasks that you need to perform after the backup process

17Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 9 Post-Backup Checklist Window

Step 12 Click Finish The Exit Confirmation window appears (see Figure 10)

Figure 10 Exit Confirmation Window

Step 13 Click Yes to quit DMT

DMT records all historical and configuration data and automatically backs up the database to the specified storage location either on your CRS 40(55a) system or on a safe network location in the TAR format

18Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

View Backup TAR File Details

After you complete the backup activity you can validate the backup TAR file and view its details To validate the backed up TAR file and view its details do the following

Step 1 From the Cisco Unified CCX Data Migration Tool Home window choose Options gt Check Archive

The Enter the location of a valid backup file window appears (see Figure 11)

Figure 11 Enter the Location of a Valid Backup File Window

Step 2 Enter the location information and user credentials of the latest TAR file you backed up

Step 3 Click Validate DMT validates the backup TAR file and displays the Data Migration Backup File Info window (see Figure 12)

19Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 5: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Prerequisite

PrerequisiteBefore you run this tool and start the data migration activity it is recommended that you verify the following and perform any necessary steps

bull Hard disk compatibility and database (DB) size of the system on which you plan to upgrade while using Microsoft SQL Server Check the hard disk compatibility and supported database (DB) size of the Unified CCX 70(1) system according to the following matrix (see Table 1)

Table 1

Hard disk size on Unified CCX 70(1) system

Data allowed to migrate to Unified CCX 70(1) system

DB Type on Unified CCX 70(1) system

Less than or equal to 72GB 7GB MS SQL Server

Greater than 72GB 10GB MS SQL Server

Any size 1GB MSDE

Disk Space Matrix on Unified CCX 70(1) System for Data Migration

Warning The minimum disk space to store the backed up data on the Unified CCX 70(1) system must be 10 more than the migrated data size

Note If you are currently not running on any of the supported hardware (as mentioned in the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide) of Cisco Unified CCX 70(1) or later releases then it is recommended to procure the hardware supported for Unified CCX 70(1) according to your deployment model (Standalone or High Availability)

bull Maximum supported DB size of the Unified CCX 70(1) system Before you run DMT check the maximum supported DB size of the Unified CCX 70(1) system on which you plan to upgrade If the DB size to be backed up on your CRS 40(55a) system is more than the DB size allowed on the Unified CCX 70(1) system you have to purge the excess data until the DB size is reduced to the allowed DB size (see Table 1) on the Unified CCX 70(1) system

5Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Prerequisite

Note It is recommended that you check the DB size manually before you take the backup as this is out of the purview of this tool

While backing up data on your CRS 40(55a) system you have to manually purge the data on the source system if the size of the DB to be migrated is more than the DB size allowed (see Table 1) For more information on purging refer to the Cisco Unified CCX Administration Guide available at

httpwwwciscocomenUSproductsswcustcoswps1846products_installation_and_configuration_guides_listhtml

However while restoring data the Data Migration tool logically purges any excess data if the size of the data getting migrated is higher than the allowed DB size on the Unified CCX 70(1) system

Warning You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Storage space for the backup Make sure that your system running CRS 40(55a) or the network location intended to store the backup data has enough disk space

Note It is recommended that you remove all unnecessary data not related to CRS 40(55a) in order to store the backed up data on your CRS 40(55a) system

bull Keep new Unified CCX 70(1) licenses handy Procure Unified CCX 70(1) licenses before you start the data migration activity If you do not have the license handy or have not procured yet open a case with the Cisco license team (licensingciscocom)

bull Use Base version of Unified CCX 70(1) DMT only supports the base version of Unified CCX 70(1) to successfully carry out the data migration process DMT will not support any SRES version on top of Unified CCX 70(1) base version

6Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Important Considerations

bull Disk space for Microsoft Desktop Engine (MSDE) Installation For MSDE installation the buffer space on the Unified CCX 70(1) system is set to 1GB (to enable you to migrate up to a maximum 1GB of data) while another 1GB space is allocated for new calls resulting a total of 2GB for MSDE data (see Table 1)

Important ConsiderationsBefore you start the data migration process using DMT you must consider the following

bull Use the latest compatible Backup And Restore System (BARS) to take the regular backup of the entire CRS 40(55a) system data before starting the data migration activity To download the latest version of BARS visit httpwwwciscocomkobayashisw-centerindexshtml

bull Use the latest Data Migration Assistant (DMA) tool compatible with the chosen version of Unified CM to upgrade Cisco CallManager

bull Stop the Node Manager from services before you run the DMA tool to upgrade Cisco CallManager in co-resident deployment setup

bull Upgrade Cisco CallManager using DMA to a version compatible with Unified CCX 70(1) prior to performing the restore process To find the latest version of Unified CM and its compatibility matrix refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

bull During Cisco CallManager upgrade using DMA the passwords for all the CRS 40(55a) users (including Agents Supervisors Administrators and Historical users) are reset to the default one that you specify during the Cisco CallManager upgrade

bull Upgrade all the CRS 40(55a) supported software using their own utilities to a version that is compatible with Unified CCX 70(1) For more information refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

bull DMT will discard all active call-related data (data accumulated if your call center is operational while DMT is running) during or after the backup process

7Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Important Considerations

bull Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any currently active on all CRS 40(55a) nodes in the cluster and on the Unified CCX 70(1) system before you start using DMT

bull Restore the backed up data on the Unified CCX 70(1) system before you perform the initial setup configuration on it

bull At any given time during the data migration only a single instance of DMT can remain active

bull Manually install the third-party ODBC drivers (if any on the CRS 40(55a) system) and create all the system DSN configurations (if any) on the Unified CCX 70(1) system even though DMT migrates all the Data source and Enterprise Database Subsystem Configurations

bull DMT will only back up the current active LDAP profile configuration data available on your CRS 40(55a) system

bull It is strongly recommended to retain the same IP address for the Unified CCX 70(1) system as it was for your CRS 40(55a) system However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

bull It is important that you install an SRES update on the Unified CCX 70(1) machine only after completing the data migration process

bull Backing up process using DMT for 10GB of data might take up to 40 minutes on an average loaded CRS 40(55a) system However restoring the same amount of data using DMT on a Unified CCX 70(1) system might take up to 3 hours Therefore you must consider that the time required to complete the backup and restore process using DMT may vary as it is entirely dependent on the amount of HR and configuration data (including CAD data) available on the CRS 40(55a) system and the deployment model of the Unified CCX 70(1) system

8Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Back Up Cisco CRS 40(55a) System DataThe automated backup process using DMT UCCXDataMigratorexe helps you migrate all historical and configuration data available on your CRS 40(55a) system

DMT supports migrating up to 10GB of data to ensure availability of adequate space on the Unified CCX 70(1) system after the data migration activity However if DMT finds that the data size is greater than 10 GB on the CRS 40(55a) system it prompts the user to manually purge the data before it proceeds with the backup activity

DMT saves the backed up data in a tape archive (TAR) file at a location that you specify during the backup activity

Data migration on the CRS 40(55a) system involves the following

bull Perform the Pre-Backup Activities page 9

bull Run the Backup Process page 10

bull Perform the Post-Backup Activities page 20

Perform the Pre-Backup ActivitiesBefore DMT starts backing up the data on the CRS 40(55a) system verify whether you have performed the following pre-backup activities

1 Use BARS to take the regular backup of the CRS 40(55a) system

2 Verify that the call center is not operational as you may lose some historical data if the call center is operational during the backup activity

3 Make sure that all the nodes in the cluster and the Unified CM are up and running

4 Make sure that there is enough space available to store the backup on the desired network location

5 Ensure that the data on the CRS 40(55a) system and Unified CM are in sync by clicking the JTAPI Resynchronization option in the Application Administration Web interface

6 Procure all the necessary Unified CCX 70(1) licenses and keep them handy

9Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on all the CRS 40(55a) nodes in the cluster

8 Convert all the recording data (audio files) using the RAW to WAV utility and store at a secure server on the network

9 Capture screenshots for all the system DSN configurations and alarm definitions in order to be able to re-create them in Unified CCX 70(1) system

Run the Backup ProcessRunning the backup process using DMT backs up all historical and configuration data available on your CRS 40(55a) system Make sure your CRS 40(55a) system has enough space to stage the backed up data

Step 1 Download the DMT ZIP file containing UCCXDataMigratorexe on your CRS 40(55a) system

Warning DMT should always be run from the DB Publisher node of the CRS 40(55a) system

Tip Keep the UCCXDataMigratorzip file at a safe location as you will need it again to restore the backed up data on the Unified CCX 70(1) system

Step 2 Double-click to run the UCCXDataMigratorexe file The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 2)

10Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 2 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Backup Checklist window appears (see Figure 3)

Note To quit DMT and stop the backup activity at any time choose File gt Exit

11Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 3 Pre-Backup Checklist Window

Step 4 Read through all the listed activities in the Pre-Backup Checklist window and ensure to perform and complete each one of them before proceeding with the backup activity

Step 5 Click Accept The Backup Storage Location window appears (see Figure 4)

12Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 4 Backup Storage Location Window

Step 6 In the Backup Storage Location window choose the destination where DMT stores the TAR file

a Network Directory Stores the TAR file on a network location

ndash Backup locationmdashNetwork path or IP address of the system that should store the backup file

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder that should store the backup file

13Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

b LocalShared Directory Stores the TAR file on thelocal drive (on which you are running the DMT) or a shared location (can be a network location with read and write access but without requiring user authentication) In the Path Name field enter the path to the localshared folder manually or click Browse to choose a localshared folder that should store the backup file

Step 7 Click Next DMT starts backing up the data to the specified backup storage location and the Backup in Progress window appears (see Figure 5)

Figure 5 Backup in Progress Window

Step 8 If you have specified a local drive to store the backup on the CRS 40(55a) system a warning message might appear to prompt you to save the backup TAR file to a safe network location (see Figure 6)

14Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 6 Warning Message to Store the Backup at a Safe Network

Location

Step 9 The data is backed up to the said location A status window is displayed once DMT successfully completes the backup operation (see Figure 7)

15Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 7 Status Message for Successful Backup Operation

Step 10 Click OK on the status message and you can view the detailed status including the location of the log file (see Figure 8)

16Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 8 Detailed Status Window Highlighting Location of the Log File

If the backup operation does not complete successfully the status window displays the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

Step 11 Click Next The Post-Backup Checklist window appears (see Figure 9) This checklist reminds you of the tasks that you need to perform after the backup process

17Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 9 Post-Backup Checklist Window

Step 12 Click Finish The Exit Confirmation window appears (see Figure 10)

Figure 10 Exit Confirmation Window

Step 13 Click Yes to quit DMT

DMT records all historical and configuration data and automatically backs up the database to the specified storage location either on your CRS 40(55a) system or on a safe network location in the TAR format

18Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

View Backup TAR File Details

After you complete the backup activity you can validate the backup TAR file and view its details To validate the backed up TAR file and view its details do the following

Step 1 From the Cisco Unified CCX Data Migration Tool Home window choose Options gt Check Archive

The Enter the location of a valid backup file window appears (see Figure 11)

Figure 11 Enter the Location of a Valid Backup File Window

Step 2 Enter the location information and user credentials of the latest TAR file you backed up

Step 3 Click Validate DMT validates the backup TAR file and displays the Data Migration Backup File Info window (see Figure 12)

19Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 6: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Prerequisite

Note It is recommended that you check the DB size manually before you take the backup as this is out of the purview of this tool

While backing up data on your CRS 40(55a) system you have to manually purge the data on the source system if the size of the DB to be migrated is more than the DB size allowed (see Table 1) For more information on purging refer to the Cisco Unified CCX Administration Guide available at

httpwwwciscocomenUSproductsswcustcoswps1846products_installation_and_configuration_guides_listhtml

However while restoring data the Data Migration tool logically purges any excess data if the size of the data getting migrated is higher than the allowed DB size on the Unified CCX 70(1) system

Warning You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Storage space for the backup Make sure that your system running CRS 40(55a) or the network location intended to store the backup data has enough disk space

Note It is recommended that you remove all unnecessary data not related to CRS 40(55a) in order to store the backed up data on your CRS 40(55a) system

bull Keep new Unified CCX 70(1) licenses handy Procure Unified CCX 70(1) licenses before you start the data migration activity If you do not have the license handy or have not procured yet open a case with the Cisco license team (licensingciscocom)

bull Use Base version of Unified CCX 70(1) DMT only supports the base version of Unified CCX 70(1) to successfully carry out the data migration process DMT will not support any SRES version on top of Unified CCX 70(1) base version

6Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Important Considerations

bull Disk space for Microsoft Desktop Engine (MSDE) Installation For MSDE installation the buffer space on the Unified CCX 70(1) system is set to 1GB (to enable you to migrate up to a maximum 1GB of data) while another 1GB space is allocated for new calls resulting a total of 2GB for MSDE data (see Table 1)

Important ConsiderationsBefore you start the data migration process using DMT you must consider the following

bull Use the latest compatible Backup And Restore System (BARS) to take the regular backup of the entire CRS 40(55a) system data before starting the data migration activity To download the latest version of BARS visit httpwwwciscocomkobayashisw-centerindexshtml

bull Use the latest Data Migration Assistant (DMA) tool compatible with the chosen version of Unified CM to upgrade Cisco CallManager

bull Stop the Node Manager from services before you run the DMA tool to upgrade Cisco CallManager in co-resident deployment setup

bull Upgrade Cisco CallManager using DMA to a version compatible with Unified CCX 70(1) prior to performing the restore process To find the latest version of Unified CM and its compatibility matrix refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

bull During Cisco CallManager upgrade using DMA the passwords for all the CRS 40(55a) users (including Agents Supervisors Administrators and Historical users) are reset to the default one that you specify during the Cisco CallManager upgrade

bull Upgrade all the CRS 40(55a) supported software using their own utilities to a version that is compatible with Unified CCX 70(1) For more information refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

bull DMT will discard all active call-related data (data accumulated if your call center is operational while DMT is running) during or after the backup process

7Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Important Considerations

bull Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any currently active on all CRS 40(55a) nodes in the cluster and on the Unified CCX 70(1) system before you start using DMT

bull Restore the backed up data on the Unified CCX 70(1) system before you perform the initial setup configuration on it

bull At any given time during the data migration only a single instance of DMT can remain active

bull Manually install the third-party ODBC drivers (if any on the CRS 40(55a) system) and create all the system DSN configurations (if any) on the Unified CCX 70(1) system even though DMT migrates all the Data source and Enterprise Database Subsystem Configurations

bull DMT will only back up the current active LDAP profile configuration data available on your CRS 40(55a) system

bull It is strongly recommended to retain the same IP address for the Unified CCX 70(1) system as it was for your CRS 40(55a) system However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

bull It is important that you install an SRES update on the Unified CCX 70(1) machine only after completing the data migration process

bull Backing up process using DMT for 10GB of data might take up to 40 minutes on an average loaded CRS 40(55a) system However restoring the same amount of data using DMT on a Unified CCX 70(1) system might take up to 3 hours Therefore you must consider that the time required to complete the backup and restore process using DMT may vary as it is entirely dependent on the amount of HR and configuration data (including CAD data) available on the CRS 40(55a) system and the deployment model of the Unified CCX 70(1) system

8Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Back Up Cisco CRS 40(55a) System DataThe automated backup process using DMT UCCXDataMigratorexe helps you migrate all historical and configuration data available on your CRS 40(55a) system

DMT supports migrating up to 10GB of data to ensure availability of adequate space on the Unified CCX 70(1) system after the data migration activity However if DMT finds that the data size is greater than 10 GB on the CRS 40(55a) system it prompts the user to manually purge the data before it proceeds with the backup activity

DMT saves the backed up data in a tape archive (TAR) file at a location that you specify during the backup activity

Data migration on the CRS 40(55a) system involves the following

bull Perform the Pre-Backup Activities page 9

bull Run the Backup Process page 10

bull Perform the Post-Backup Activities page 20

Perform the Pre-Backup ActivitiesBefore DMT starts backing up the data on the CRS 40(55a) system verify whether you have performed the following pre-backup activities

1 Use BARS to take the regular backup of the CRS 40(55a) system

2 Verify that the call center is not operational as you may lose some historical data if the call center is operational during the backup activity

3 Make sure that all the nodes in the cluster and the Unified CM are up and running

4 Make sure that there is enough space available to store the backup on the desired network location

5 Ensure that the data on the CRS 40(55a) system and Unified CM are in sync by clicking the JTAPI Resynchronization option in the Application Administration Web interface

6 Procure all the necessary Unified CCX 70(1) licenses and keep them handy

9Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on all the CRS 40(55a) nodes in the cluster

8 Convert all the recording data (audio files) using the RAW to WAV utility and store at a secure server on the network

9 Capture screenshots for all the system DSN configurations and alarm definitions in order to be able to re-create them in Unified CCX 70(1) system

Run the Backup ProcessRunning the backup process using DMT backs up all historical and configuration data available on your CRS 40(55a) system Make sure your CRS 40(55a) system has enough space to stage the backed up data

Step 1 Download the DMT ZIP file containing UCCXDataMigratorexe on your CRS 40(55a) system

Warning DMT should always be run from the DB Publisher node of the CRS 40(55a) system

Tip Keep the UCCXDataMigratorzip file at a safe location as you will need it again to restore the backed up data on the Unified CCX 70(1) system

Step 2 Double-click to run the UCCXDataMigratorexe file The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 2)

10Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 2 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Backup Checklist window appears (see Figure 3)

Note To quit DMT and stop the backup activity at any time choose File gt Exit

11Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 3 Pre-Backup Checklist Window

Step 4 Read through all the listed activities in the Pre-Backup Checklist window and ensure to perform and complete each one of them before proceeding with the backup activity

Step 5 Click Accept The Backup Storage Location window appears (see Figure 4)

12Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 4 Backup Storage Location Window

Step 6 In the Backup Storage Location window choose the destination where DMT stores the TAR file

a Network Directory Stores the TAR file on a network location

ndash Backup locationmdashNetwork path or IP address of the system that should store the backup file

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder that should store the backup file

13Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

b LocalShared Directory Stores the TAR file on thelocal drive (on which you are running the DMT) or a shared location (can be a network location with read and write access but without requiring user authentication) In the Path Name field enter the path to the localshared folder manually or click Browse to choose a localshared folder that should store the backup file

Step 7 Click Next DMT starts backing up the data to the specified backup storage location and the Backup in Progress window appears (see Figure 5)

Figure 5 Backup in Progress Window

Step 8 If you have specified a local drive to store the backup on the CRS 40(55a) system a warning message might appear to prompt you to save the backup TAR file to a safe network location (see Figure 6)

14Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 6 Warning Message to Store the Backup at a Safe Network

Location

Step 9 The data is backed up to the said location A status window is displayed once DMT successfully completes the backup operation (see Figure 7)

15Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 7 Status Message for Successful Backup Operation

Step 10 Click OK on the status message and you can view the detailed status including the location of the log file (see Figure 8)

16Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 8 Detailed Status Window Highlighting Location of the Log File

If the backup operation does not complete successfully the status window displays the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

Step 11 Click Next The Post-Backup Checklist window appears (see Figure 9) This checklist reminds you of the tasks that you need to perform after the backup process

17Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 9 Post-Backup Checklist Window

Step 12 Click Finish The Exit Confirmation window appears (see Figure 10)

Figure 10 Exit Confirmation Window

Step 13 Click Yes to quit DMT

DMT records all historical and configuration data and automatically backs up the database to the specified storage location either on your CRS 40(55a) system or on a safe network location in the TAR format

18Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

View Backup TAR File Details

After you complete the backup activity you can validate the backup TAR file and view its details To validate the backed up TAR file and view its details do the following

Step 1 From the Cisco Unified CCX Data Migration Tool Home window choose Options gt Check Archive

The Enter the location of a valid backup file window appears (see Figure 11)

Figure 11 Enter the Location of a Valid Backup File Window

Step 2 Enter the location information and user credentials of the latest TAR file you backed up

Step 3 Click Validate DMT validates the backup TAR file and displays the Data Migration Backup File Info window (see Figure 12)

19Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 7: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Important Considerations

bull Disk space for Microsoft Desktop Engine (MSDE) Installation For MSDE installation the buffer space on the Unified CCX 70(1) system is set to 1GB (to enable you to migrate up to a maximum 1GB of data) while another 1GB space is allocated for new calls resulting a total of 2GB for MSDE data (see Table 1)

Important ConsiderationsBefore you start the data migration process using DMT you must consider the following

bull Use the latest compatible Backup And Restore System (BARS) to take the regular backup of the entire CRS 40(55a) system data before starting the data migration activity To download the latest version of BARS visit httpwwwciscocomkobayashisw-centerindexshtml

bull Use the latest Data Migration Assistant (DMA) tool compatible with the chosen version of Unified CM to upgrade Cisco CallManager

bull Stop the Node Manager from services before you run the DMA tool to upgrade Cisco CallManager in co-resident deployment setup

bull Upgrade Cisco CallManager using DMA to a version compatible with Unified CCX 70(1) prior to performing the restore process To find the latest version of Unified CM and its compatibility matrix refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

bull During Cisco CallManager upgrade using DMA the passwords for all the CRS 40(55a) users (including Agents Supervisors Administrators and Historical users) are reset to the default one that you specify during the Cisco CallManager upgrade

bull Upgrade all the CRS 40(55a) supported software using their own utilities to a version that is compatible with Unified CCX 70(1) For more information refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

bull DMT will discard all active call-related data (data accumulated if your call center is operational while DMT is running) during or after the backup process

7Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Important Considerations

bull Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any currently active on all CRS 40(55a) nodes in the cluster and on the Unified CCX 70(1) system before you start using DMT

bull Restore the backed up data on the Unified CCX 70(1) system before you perform the initial setup configuration on it

bull At any given time during the data migration only a single instance of DMT can remain active

bull Manually install the third-party ODBC drivers (if any on the CRS 40(55a) system) and create all the system DSN configurations (if any) on the Unified CCX 70(1) system even though DMT migrates all the Data source and Enterprise Database Subsystem Configurations

bull DMT will only back up the current active LDAP profile configuration data available on your CRS 40(55a) system

bull It is strongly recommended to retain the same IP address for the Unified CCX 70(1) system as it was for your CRS 40(55a) system However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

bull It is important that you install an SRES update on the Unified CCX 70(1) machine only after completing the data migration process

bull Backing up process using DMT for 10GB of data might take up to 40 minutes on an average loaded CRS 40(55a) system However restoring the same amount of data using DMT on a Unified CCX 70(1) system might take up to 3 hours Therefore you must consider that the time required to complete the backup and restore process using DMT may vary as it is entirely dependent on the amount of HR and configuration data (including CAD data) available on the CRS 40(55a) system and the deployment model of the Unified CCX 70(1) system

8Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Back Up Cisco CRS 40(55a) System DataThe automated backup process using DMT UCCXDataMigratorexe helps you migrate all historical and configuration data available on your CRS 40(55a) system

DMT supports migrating up to 10GB of data to ensure availability of adequate space on the Unified CCX 70(1) system after the data migration activity However if DMT finds that the data size is greater than 10 GB on the CRS 40(55a) system it prompts the user to manually purge the data before it proceeds with the backup activity

DMT saves the backed up data in a tape archive (TAR) file at a location that you specify during the backup activity

Data migration on the CRS 40(55a) system involves the following

bull Perform the Pre-Backup Activities page 9

bull Run the Backup Process page 10

bull Perform the Post-Backup Activities page 20

Perform the Pre-Backup ActivitiesBefore DMT starts backing up the data on the CRS 40(55a) system verify whether you have performed the following pre-backup activities

1 Use BARS to take the regular backup of the CRS 40(55a) system

2 Verify that the call center is not operational as you may lose some historical data if the call center is operational during the backup activity

3 Make sure that all the nodes in the cluster and the Unified CM are up and running

4 Make sure that there is enough space available to store the backup on the desired network location

5 Ensure that the data on the CRS 40(55a) system and Unified CM are in sync by clicking the JTAPI Resynchronization option in the Application Administration Web interface

6 Procure all the necessary Unified CCX 70(1) licenses and keep them handy

9Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on all the CRS 40(55a) nodes in the cluster

8 Convert all the recording data (audio files) using the RAW to WAV utility and store at a secure server on the network

9 Capture screenshots for all the system DSN configurations and alarm definitions in order to be able to re-create them in Unified CCX 70(1) system

Run the Backup ProcessRunning the backup process using DMT backs up all historical and configuration data available on your CRS 40(55a) system Make sure your CRS 40(55a) system has enough space to stage the backed up data

Step 1 Download the DMT ZIP file containing UCCXDataMigratorexe on your CRS 40(55a) system

Warning DMT should always be run from the DB Publisher node of the CRS 40(55a) system

Tip Keep the UCCXDataMigratorzip file at a safe location as you will need it again to restore the backed up data on the Unified CCX 70(1) system

Step 2 Double-click to run the UCCXDataMigratorexe file The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 2)

10Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 2 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Backup Checklist window appears (see Figure 3)

Note To quit DMT and stop the backup activity at any time choose File gt Exit

11Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 3 Pre-Backup Checklist Window

Step 4 Read through all the listed activities in the Pre-Backup Checklist window and ensure to perform and complete each one of them before proceeding with the backup activity

Step 5 Click Accept The Backup Storage Location window appears (see Figure 4)

12Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 4 Backup Storage Location Window

Step 6 In the Backup Storage Location window choose the destination where DMT stores the TAR file

a Network Directory Stores the TAR file on a network location

ndash Backup locationmdashNetwork path or IP address of the system that should store the backup file

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder that should store the backup file

13Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

b LocalShared Directory Stores the TAR file on thelocal drive (on which you are running the DMT) or a shared location (can be a network location with read and write access but without requiring user authentication) In the Path Name field enter the path to the localshared folder manually or click Browse to choose a localshared folder that should store the backup file

Step 7 Click Next DMT starts backing up the data to the specified backup storage location and the Backup in Progress window appears (see Figure 5)

Figure 5 Backup in Progress Window

Step 8 If you have specified a local drive to store the backup on the CRS 40(55a) system a warning message might appear to prompt you to save the backup TAR file to a safe network location (see Figure 6)

14Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 6 Warning Message to Store the Backup at a Safe Network

Location

Step 9 The data is backed up to the said location A status window is displayed once DMT successfully completes the backup operation (see Figure 7)

15Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 7 Status Message for Successful Backup Operation

Step 10 Click OK on the status message and you can view the detailed status including the location of the log file (see Figure 8)

16Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 8 Detailed Status Window Highlighting Location of the Log File

If the backup operation does not complete successfully the status window displays the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

Step 11 Click Next The Post-Backup Checklist window appears (see Figure 9) This checklist reminds you of the tasks that you need to perform after the backup process

17Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 9 Post-Backup Checklist Window

Step 12 Click Finish The Exit Confirmation window appears (see Figure 10)

Figure 10 Exit Confirmation Window

Step 13 Click Yes to quit DMT

DMT records all historical and configuration data and automatically backs up the database to the specified storage location either on your CRS 40(55a) system or on a safe network location in the TAR format

18Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

View Backup TAR File Details

After you complete the backup activity you can validate the backup TAR file and view its details To validate the backed up TAR file and view its details do the following

Step 1 From the Cisco Unified CCX Data Migration Tool Home window choose Options gt Check Archive

The Enter the location of a valid backup file window appears (see Figure 11)

Figure 11 Enter the Location of a Valid Backup File Window

Step 2 Enter the location information and user credentials of the latest TAR file you backed up

Step 3 Click Validate DMT validates the backup TAR file and displays the Data Migration Backup File Info window (see Figure 12)

19Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 8: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Important Considerations

bull Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any currently active on all CRS 40(55a) nodes in the cluster and on the Unified CCX 70(1) system before you start using DMT

bull Restore the backed up data on the Unified CCX 70(1) system before you perform the initial setup configuration on it

bull At any given time during the data migration only a single instance of DMT can remain active

bull Manually install the third-party ODBC drivers (if any on the CRS 40(55a) system) and create all the system DSN configurations (if any) on the Unified CCX 70(1) system even though DMT migrates all the Data source and Enterprise Database Subsystem Configurations

bull DMT will only back up the current active LDAP profile configuration data available on your CRS 40(55a) system

bull It is strongly recommended to retain the same IP address for the Unified CCX 70(1) system as it was for your CRS 40(55a) system However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

bull It is important that you install an SRES update on the Unified CCX 70(1) machine only after completing the data migration process

bull Backing up process using DMT for 10GB of data might take up to 40 minutes on an average loaded CRS 40(55a) system However restoring the same amount of data using DMT on a Unified CCX 70(1) system might take up to 3 hours Therefore you must consider that the time required to complete the backup and restore process using DMT may vary as it is entirely dependent on the amount of HR and configuration data (including CAD data) available on the CRS 40(55a) system and the deployment model of the Unified CCX 70(1) system

8Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Back Up Cisco CRS 40(55a) System DataThe automated backup process using DMT UCCXDataMigratorexe helps you migrate all historical and configuration data available on your CRS 40(55a) system

DMT supports migrating up to 10GB of data to ensure availability of adequate space on the Unified CCX 70(1) system after the data migration activity However if DMT finds that the data size is greater than 10 GB on the CRS 40(55a) system it prompts the user to manually purge the data before it proceeds with the backup activity

DMT saves the backed up data in a tape archive (TAR) file at a location that you specify during the backup activity

Data migration on the CRS 40(55a) system involves the following

bull Perform the Pre-Backup Activities page 9

bull Run the Backup Process page 10

bull Perform the Post-Backup Activities page 20

Perform the Pre-Backup ActivitiesBefore DMT starts backing up the data on the CRS 40(55a) system verify whether you have performed the following pre-backup activities

1 Use BARS to take the regular backup of the CRS 40(55a) system

2 Verify that the call center is not operational as you may lose some historical data if the call center is operational during the backup activity

3 Make sure that all the nodes in the cluster and the Unified CM are up and running

4 Make sure that there is enough space available to store the backup on the desired network location

5 Ensure that the data on the CRS 40(55a) system and Unified CM are in sync by clicking the JTAPI Resynchronization option in the Application Administration Web interface

6 Procure all the necessary Unified CCX 70(1) licenses and keep them handy

9Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on all the CRS 40(55a) nodes in the cluster

8 Convert all the recording data (audio files) using the RAW to WAV utility and store at a secure server on the network

9 Capture screenshots for all the system DSN configurations and alarm definitions in order to be able to re-create them in Unified CCX 70(1) system

Run the Backup ProcessRunning the backup process using DMT backs up all historical and configuration data available on your CRS 40(55a) system Make sure your CRS 40(55a) system has enough space to stage the backed up data

Step 1 Download the DMT ZIP file containing UCCXDataMigratorexe on your CRS 40(55a) system

Warning DMT should always be run from the DB Publisher node of the CRS 40(55a) system

Tip Keep the UCCXDataMigratorzip file at a safe location as you will need it again to restore the backed up data on the Unified CCX 70(1) system

Step 2 Double-click to run the UCCXDataMigratorexe file The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 2)

10Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 2 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Backup Checklist window appears (see Figure 3)

Note To quit DMT and stop the backup activity at any time choose File gt Exit

11Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 3 Pre-Backup Checklist Window

Step 4 Read through all the listed activities in the Pre-Backup Checklist window and ensure to perform and complete each one of them before proceeding with the backup activity

Step 5 Click Accept The Backup Storage Location window appears (see Figure 4)

12Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 4 Backup Storage Location Window

Step 6 In the Backup Storage Location window choose the destination where DMT stores the TAR file

a Network Directory Stores the TAR file on a network location

ndash Backup locationmdashNetwork path or IP address of the system that should store the backup file

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder that should store the backup file

13Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

b LocalShared Directory Stores the TAR file on thelocal drive (on which you are running the DMT) or a shared location (can be a network location with read and write access but without requiring user authentication) In the Path Name field enter the path to the localshared folder manually or click Browse to choose a localshared folder that should store the backup file

Step 7 Click Next DMT starts backing up the data to the specified backup storage location and the Backup in Progress window appears (see Figure 5)

Figure 5 Backup in Progress Window

Step 8 If you have specified a local drive to store the backup on the CRS 40(55a) system a warning message might appear to prompt you to save the backup TAR file to a safe network location (see Figure 6)

14Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 6 Warning Message to Store the Backup at a Safe Network

Location

Step 9 The data is backed up to the said location A status window is displayed once DMT successfully completes the backup operation (see Figure 7)

15Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 7 Status Message for Successful Backup Operation

Step 10 Click OK on the status message and you can view the detailed status including the location of the log file (see Figure 8)

16Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 8 Detailed Status Window Highlighting Location of the Log File

If the backup operation does not complete successfully the status window displays the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

Step 11 Click Next The Post-Backup Checklist window appears (see Figure 9) This checklist reminds you of the tasks that you need to perform after the backup process

17Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 9 Post-Backup Checklist Window

Step 12 Click Finish The Exit Confirmation window appears (see Figure 10)

Figure 10 Exit Confirmation Window

Step 13 Click Yes to quit DMT

DMT records all historical and configuration data and automatically backs up the database to the specified storage location either on your CRS 40(55a) system or on a safe network location in the TAR format

18Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

View Backup TAR File Details

After you complete the backup activity you can validate the backup TAR file and view its details To validate the backed up TAR file and view its details do the following

Step 1 From the Cisco Unified CCX Data Migration Tool Home window choose Options gt Check Archive

The Enter the location of a valid backup file window appears (see Figure 11)

Figure 11 Enter the Location of a Valid Backup File Window

Step 2 Enter the location information and user credentials of the latest TAR file you backed up

Step 3 Click Validate DMT validates the backup TAR file and displays the Data Migration Backup File Info window (see Figure 12)

19Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 9: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Back Up Cisco CRS 40(55a) System Data

Back Up Cisco CRS 40(55a) System DataThe automated backup process using DMT UCCXDataMigratorexe helps you migrate all historical and configuration data available on your CRS 40(55a) system

DMT supports migrating up to 10GB of data to ensure availability of adequate space on the Unified CCX 70(1) system after the data migration activity However if DMT finds that the data size is greater than 10 GB on the CRS 40(55a) system it prompts the user to manually purge the data before it proceeds with the backup activity

DMT saves the backed up data in a tape archive (TAR) file at a location that you specify during the backup activity

Data migration on the CRS 40(55a) system involves the following

bull Perform the Pre-Backup Activities page 9

bull Run the Backup Process page 10

bull Perform the Post-Backup Activities page 20

Perform the Pre-Backup ActivitiesBefore DMT starts backing up the data on the CRS 40(55a) system verify whether you have performed the following pre-backup activities

1 Use BARS to take the regular backup of the CRS 40(55a) system

2 Verify that the call center is not operational as you may lose some historical data if the call center is operational during the backup activity

3 Make sure that all the nodes in the cluster and the Unified CM are up and running

4 Make sure that there is enough space available to store the backup on the desired network location

5 Ensure that the data on the CRS 40(55a) system and Unified CM are in sync by clicking the JTAPI Resynchronization option in the Application Administration Web interface

6 Procure all the necessary Unified CCX 70(1) licenses and keep them handy

9Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on all the CRS 40(55a) nodes in the cluster

8 Convert all the recording data (audio files) using the RAW to WAV utility and store at a secure server on the network

9 Capture screenshots for all the system DSN configurations and alarm definitions in order to be able to re-create them in Unified CCX 70(1) system

Run the Backup ProcessRunning the backup process using DMT backs up all historical and configuration data available on your CRS 40(55a) system Make sure your CRS 40(55a) system has enough space to stage the backed up data

Step 1 Download the DMT ZIP file containing UCCXDataMigratorexe on your CRS 40(55a) system

Warning DMT should always be run from the DB Publisher node of the CRS 40(55a) system

Tip Keep the UCCXDataMigratorzip file at a safe location as you will need it again to restore the backed up data on the Unified CCX 70(1) system

Step 2 Double-click to run the UCCXDataMigratorexe file The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 2)

10Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 2 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Backup Checklist window appears (see Figure 3)

Note To quit DMT and stop the backup activity at any time choose File gt Exit

11Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 3 Pre-Backup Checklist Window

Step 4 Read through all the listed activities in the Pre-Backup Checklist window and ensure to perform and complete each one of them before proceeding with the backup activity

Step 5 Click Accept The Backup Storage Location window appears (see Figure 4)

12Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 4 Backup Storage Location Window

Step 6 In the Backup Storage Location window choose the destination where DMT stores the TAR file

a Network Directory Stores the TAR file on a network location

ndash Backup locationmdashNetwork path or IP address of the system that should store the backup file

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder that should store the backup file

13Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

b LocalShared Directory Stores the TAR file on thelocal drive (on which you are running the DMT) or a shared location (can be a network location with read and write access but without requiring user authentication) In the Path Name field enter the path to the localshared folder manually or click Browse to choose a localshared folder that should store the backup file

Step 7 Click Next DMT starts backing up the data to the specified backup storage location and the Backup in Progress window appears (see Figure 5)

Figure 5 Backup in Progress Window

Step 8 If you have specified a local drive to store the backup on the CRS 40(55a) system a warning message might appear to prompt you to save the backup TAR file to a safe network location (see Figure 6)

14Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 6 Warning Message to Store the Backup at a Safe Network

Location

Step 9 The data is backed up to the said location A status window is displayed once DMT successfully completes the backup operation (see Figure 7)

15Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 7 Status Message for Successful Backup Operation

Step 10 Click OK on the status message and you can view the detailed status including the location of the log file (see Figure 8)

16Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 8 Detailed Status Window Highlighting Location of the Log File

If the backup operation does not complete successfully the status window displays the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

Step 11 Click Next The Post-Backup Checklist window appears (see Figure 9) This checklist reminds you of the tasks that you need to perform after the backup process

17Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 9 Post-Backup Checklist Window

Step 12 Click Finish The Exit Confirmation window appears (see Figure 10)

Figure 10 Exit Confirmation Window

Step 13 Click Yes to quit DMT

DMT records all historical and configuration data and automatically backs up the database to the specified storage location either on your CRS 40(55a) system or on a safe network location in the TAR format

18Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

View Backup TAR File Details

After you complete the backup activity you can validate the backup TAR file and view its details To validate the backed up TAR file and view its details do the following

Step 1 From the Cisco Unified CCX Data Migration Tool Home window choose Options gt Check Archive

The Enter the location of a valid backup file window appears (see Figure 11)

Figure 11 Enter the Location of a Valid Backup File Window

Step 2 Enter the location information and user credentials of the latest TAR file you backed up

Step 3 Click Validate DMT validates the backup TAR file and displays the Data Migration Backup File Info window (see Figure 12)

19Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 10: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Back Up Cisco CRS 40(55a) System Data

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on all the CRS 40(55a) nodes in the cluster

8 Convert all the recording data (audio files) using the RAW to WAV utility and store at a secure server on the network

9 Capture screenshots for all the system DSN configurations and alarm definitions in order to be able to re-create them in Unified CCX 70(1) system

Run the Backup ProcessRunning the backup process using DMT backs up all historical and configuration data available on your CRS 40(55a) system Make sure your CRS 40(55a) system has enough space to stage the backed up data

Step 1 Download the DMT ZIP file containing UCCXDataMigratorexe on your CRS 40(55a) system

Warning DMT should always be run from the DB Publisher node of the CRS 40(55a) system

Tip Keep the UCCXDataMigratorzip file at a safe location as you will need it again to restore the backed up data on the Unified CCX 70(1) system

Step 2 Double-click to run the UCCXDataMigratorexe file The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 2)

10Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 2 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Backup Checklist window appears (see Figure 3)

Note To quit DMT and stop the backup activity at any time choose File gt Exit

11Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 3 Pre-Backup Checklist Window

Step 4 Read through all the listed activities in the Pre-Backup Checklist window and ensure to perform and complete each one of them before proceeding with the backup activity

Step 5 Click Accept The Backup Storage Location window appears (see Figure 4)

12Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 4 Backup Storage Location Window

Step 6 In the Backup Storage Location window choose the destination where DMT stores the TAR file

a Network Directory Stores the TAR file on a network location

ndash Backup locationmdashNetwork path or IP address of the system that should store the backup file

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder that should store the backup file

13Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

b LocalShared Directory Stores the TAR file on thelocal drive (on which you are running the DMT) or a shared location (can be a network location with read and write access but without requiring user authentication) In the Path Name field enter the path to the localshared folder manually or click Browse to choose a localshared folder that should store the backup file

Step 7 Click Next DMT starts backing up the data to the specified backup storage location and the Backup in Progress window appears (see Figure 5)

Figure 5 Backup in Progress Window

Step 8 If you have specified a local drive to store the backup on the CRS 40(55a) system a warning message might appear to prompt you to save the backup TAR file to a safe network location (see Figure 6)

14Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 6 Warning Message to Store the Backup at a Safe Network

Location

Step 9 The data is backed up to the said location A status window is displayed once DMT successfully completes the backup operation (see Figure 7)

15Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 7 Status Message for Successful Backup Operation

Step 10 Click OK on the status message and you can view the detailed status including the location of the log file (see Figure 8)

16Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 8 Detailed Status Window Highlighting Location of the Log File

If the backup operation does not complete successfully the status window displays the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

Step 11 Click Next The Post-Backup Checklist window appears (see Figure 9) This checklist reminds you of the tasks that you need to perform after the backup process

17Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 9 Post-Backup Checklist Window

Step 12 Click Finish The Exit Confirmation window appears (see Figure 10)

Figure 10 Exit Confirmation Window

Step 13 Click Yes to quit DMT

DMT records all historical and configuration data and automatically backs up the database to the specified storage location either on your CRS 40(55a) system or on a safe network location in the TAR format

18Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

View Backup TAR File Details

After you complete the backup activity you can validate the backup TAR file and view its details To validate the backed up TAR file and view its details do the following

Step 1 From the Cisco Unified CCX Data Migration Tool Home window choose Options gt Check Archive

The Enter the location of a valid backup file window appears (see Figure 11)

Figure 11 Enter the Location of a Valid Backup File Window

Step 2 Enter the location information and user credentials of the latest TAR file you backed up

Step 3 Click Validate DMT validates the backup TAR file and displays the Data Migration Backup File Info window (see Figure 12)

19Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 11: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Back Up Cisco CRS 40(55a) System Data

Figure 2 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Backup Checklist window appears (see Figure 3)

Note To quit DMT and stop the backup activity at any time choose File gt Exit

11Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 3 Pre-Backup Checklist Window

Step 4 Read through all the listed activities in the Pre-Backup Checklist window and ensure to perform and complete each one of them before proceeding with the backup activity

Step 5 Click Accept The Backup Storage Location window appears (see Figure 4)

12Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 4 Backup Storage Location Window

Step 6 In the Backup Storage Location window choose the destination where DMT stores the TAR file

a Network Directory Stores the TAR file on a network location

ndash Backup locationmdashNetwork path or IP address of the system that should store the backup file

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder that should store the backup file

13Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

b LocalShared Directory Stores the TAR file on thelocal drive (on which you are running the DMT) or a shared location (can be a network location with read and write access but without requiring user authentication) In the Path Name field enter the path to the localshared folder manually or click Browse to choose a localshared folder that should store the backup file

Step 7 Click Next DMT starts backing up the data to the specified backup storage location and the Backup in Progress window appears (see Figure 5)

Figure 5 Backup in Progress Window

Step 8 If you have specified a local drive to store the backup on the CRS 40(55a) system a warning message might appear to prompt you to save the backup TAR file to a safe network location (see Figure 6)

14Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 6 Warning Message to Store the Backup at a Safe Network

Location

Step 9 The data is backed up to the said location A status window is displayed once DMT successfully completes the backup operation (see Figure 7)

15Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 7 Status Message for Successful Backup Operation

Step 10 Click OK on the status message and you can view the detailed status including the location of the log file (see Figure 8)

16Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 8 Detailed Status Window Highlighting Location of the Log File

If the backup operation does not complete successfully the status window displays the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

Step 11 Click Next The Post-Backup Checklist window appears (see Figure 9) This checklist reminds you of the tasks that you need to perform after the backup process

17Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 9 Post-Backup Checklist Window

Step 12 Click Finish The Exit Confirmation window appears (see Figure 10)

Figure 10 Exit Confirmation Window

Step 13 Click Yes to quit DMT

DMT records all historical and configuration data and automatically backs up the database to the specified storage location either on your CRS 40(55a) system or on a safe network location in the TAR format

18Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

View Backup TAR File Details

After you complete the backup activity you can validate the backup TAR file and view its details To validate the backed up TAR file and view its details do the following

Step 1 From the Cisco Unified CCX Data Migration Tool Home window choose Options gt Check Archive

The Enter the location of a valid backup file window appears (see Figure 11)

Figure 11 Enter the Location of a Valid Backup File Window

Step 2 Enter the location information and user credentials of the latest TAR file you backed up

Step 3 Click Validate DMT validates the backup TAR file and displays the Data Migration Backup File Info window (see Figure 12)

19Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 12: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Back Up Cisco CRS 40(55a) System Data

Figure 3 Pre-Backup Checklist Window

Step 4 Read through all the listed activities in the Pre-Backup Checklist window and ensure to perform and complete each one of them before proceeding with the backup activity

Step 5 Click Accept The Backup Storage Location window appears (see Figure 4)

12Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 4 Backup Storage Location Window

Step 6 In the Backup Storage Location window choose the destination where DMT stores the TAR file

a Network Directory Stores the TAR file on a network location

ndash Backup locationmdashNetwork path or IP address of the system that should store the backup file

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder that should store the backup file

13Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

b LocalShared Directory Stores the TAR file on thelocal drive (on which you are running the DMT) or a shared location (can be a network location with read and write access but without requiring user authentication) In the Path Name field enter the path to the localshared folder manually or click Browse to choose a localshared folder that should store the backup file

Step 7 Click Next DMT starts backing up the data to the specified backup storage location and the Backup in Progress window appears (see Figure 5)

Figure 5 Backup in Progress Window

Step 8 If you have specified a local drive to store the backup on the CRS 40(55a) system a warning message might appear to prompt you to save the backup TAR file to a safe network location (see Figure 6)

14Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 6 Warning Message to Store the Backup at a Safe Network

Location

Step 9 The data is backed up to the said location A status window is displayed once DMT successfully completes the backup operation (see Figure 7)

15Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 7 Status Message for Successful Backup Operation

Step 10 Click OK on the status message and you can view the detailed status including the location of the log file (see Figure 8)

16Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 8 Detailed Status Window Highlighting Location of the Log File

If the backup operation does not complete successfully the status window displays the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

Step 11 Click Next The Post-Backup Checklist window appears (see Figure 9) This checklist reminds you of the tasks that you need to perform after the backup process

17Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 9 Post-Backup Checklist Window

Step 12 Click Finish The Exit Confirmation window appears (see Figure 10)

Figure 10 Exit Confirmation Window

Step 13 Click Yes to quit DMT

DMT records all historical and configuration data and automatically backs up the database to the specified storage location either on your CRS 40(55a) system or on a safe network location in the TAR format

18Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

View Backup TAR File Details

After you complete the backup activity you can validate the backup TAR file and view its details To validate the backed up TAR file and view its details do the following

Step 1 From the Cisco Unified CCX Data Migration Tool Home window choose Options gt Check Archive

The Enter the location of a valid backup file window appears (see Figure 11)

Figure 11 Enter the Location of a Valid Backup File Window

Step 2 Enter the location information and user credentials of the latest TAR file you backed up

Step 3 Click Validate DMT validates the backup TAR file and displays the Data Migration Backup File Info window (see Figure 12)

19Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 13: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Back Up Cisco CRS 40(55a) System Data

Figure 4 Backup Storage Location Window

Step 6 In the Backup Storage Location window choose the destination where DMT stores the TAR file

a Network Directory Stores the TAR file on a network location

ndash Backup locationmdashNetwork path or IP address of the system that should store the backup file

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder that should store the backup file

13Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

b LocalShared Directory Stores the TAR file on thelocal drive (on which you are running the DMT) or a shared location (can be a network location with read and write access but without requiring user authentication) In the Path Name field enter the path to the localshared folder manually or click Browse to choose a localshared folder that should store the backup file

Step 7 Click Next DMT starts backing up the data to the specified backup storage location and the Backup in Progress window appears (see Figure 5)

Figure 5 Backup in Progress Window

Step 8 If you have specified a local drive to store the backup on the CRS 40(55a) system a warning message might appear to prompt you to save the backup TAR file to a safe network location (see Figure 6)

14Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 6 Warning Message to Store the Backup at a Safe Network

Location

Step 9 The data is backed up to the said location A status window is displayed once DMT successfully completes the backup operation (see Figure 7)

15Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 7 Status Message for Successful Backup Operation

Step 10 Click OK on the status message and you can view the detailed status including the location of the log file (see Figure 8)

16Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 8 Detailed Status Window Highlighting Location of the Log File

If the backup operation does not complete successfully the status window displays the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

Step 11 Click Next The Post-Backup Checklist window appears (see Figure 9) This checklist reminds you of the tasks that you need to perform after the backup process

17Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 9 Post-Backup Checklist Window

Step 12 Click Finish The Exit Confirmation window appears (see Figure 10)

Figure 10 Exit Confirmation Window

Step 13 Click Yes to quit DMT

DMT records all historical and configuration data and automatically backs up the database to the specified storage location either on your CRS 40(55a) system or on a safe network location in the TAR format

18Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

View Backup TAR File Details

After you complete the backup activity you can validate the backup TAR file and view its details To validate the backed up TAR file and view its details do the following

Step 1 From the Cisco Unified CCX Data Migration Tool Home window choose Options gt Check Archive

The Enter the location of a valid backup file window appears (see Figure 11)

Figure 11 Enter the Location of a Valid Backup File Window

Step 2 Enter the location information and user credentials of the latest TAR file you backed up

Step 3 Click Validate DMT validates the backup TAR file and displays the Data Migration Backup File Info window (see Figure 12)

19Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 14: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Back Up Cisco CRS 40(55a) System Data

b LocalShared Directory Stores the TAR file on thelocal drive (on which you are running the DMT) or a shared location (can be a network location with read and write access but without requiring user authentication) In the Path Name field enter the path to the localshared folder manually or click Browse to choose a localshared folder that should store the backup file

Step 7 Click Next DMT starts backing up the data to the specified backup storage location and the Backup in Progress window appears (see Figure 5)

Figure 5 Backup in Progress Window

Step 8 If you have specified a local drive to store the backup on the CRS 40(55a) system a warning message might appear to prompt you to save the backup TAR file to a safe network location (see Figure 6)

14Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 6 Warning Message to Store the Backup at a Safe Network

Location

Step 9 The data is backed up to the said location A status window is displayed once DMT successfully completes the backup operation (see Figure 7)

15Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 7 Status Message for Successful Backup Operation

Step 10 Click OK on the status message and you can view the detailed status including the location of the log file (see Figure 8)

16Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 8 Detailed Status Window Highlighting Location of the Log File

If the backup operation does not complete successfully the status window displays the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

Step 11 Click Next The Post-Backup Checklist window appears (see Figure 9) This checklist reminds you of the tasks that you need to perform after the backup process

17Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 9 Post-Backup Checklist Window

Step 12 Click Finish The Exit Confirmation window appears (see Figure 10)

Figure 10 Exit Confirmation Window

Step 13 Click Yes to quit DMT

DMT records all historical and configuration data and automatically backs up the database to the specified storage location either on your CRS 40(55a) system or on a safe network location in the TAR format

18Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

View Backup TAR File Details

After you complete the backup activity you can validate the backup TAR file and view its details To validate the backed up TAR file and view its details do the following

Step 1 From the Cisco Unified CCX Data Migration Tool Home window choose Options gt Check Archive

The Enter the location of a valid backup file window appears (see Figure 11)

Figure 11 Enter the Location of a Valid Backup File Window

Step 2 Enter the location information and user credentials of the latest TAR file you backed up

Step 3 Click Validate DMT validates the backup TAR file and displays the Data Migration Backup File Info window (see Figure 12)

19Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 15: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Back Up Cisco CRS 40(55a) System Data

Figure 6 Warning Message to Store the Backup at a Safe Network

Location

Step 9 The data is backed up to the said location A status window is displayed once DMT successfully completes the backup operation (see Figure 7)

15Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 7 Status Message for Successful Backup Operation

Step 10 Click OK on the status message and you can view the detailed status including the location of the log file (see Figure 8)

16Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 8 Detailed Status Window Highlighting Location of the Log File

If the backup operation does not complete successfully the status window displays the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

Step 11 Click Next The Post-Backup Checklist window appears (see Figure 9) This checklist reminds you of the tasks that you need to perform after the backup process

17Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 9 Post-Backup Checklist Window

Step 12 Click Finish The Exit Confirmation window appears (see Figure 10)

Figure 10 Exit Confirmation Window

Step 13 Click Yes to quit DMT

DMT records all historical and configuration data and automatically backs up the database to the specified storage location either on your CRS 40(55a) system or on a safe network location in the TAR format

18Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

View Backup TAR File Details

After you complete the backup activity you can validate the backup TAR file and view its details To validate the backed up TAR file and view its details do the following

Step 1 From the Cisco Unified CCX Data Migration Tool Home window choose Options gt Check Archive

The Enter the location of a valid backup file window appears (see Figure 11)

Figure 11 Enter the Location of a Valid Backup File Window

Step 2 Enter the location information and user credentials of the latest TAR file you backed up

Step 3 Click Validate DMT validates the backup TAR file and displays the Data Migration Backup File Info window (see Figure 12)

19Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 16: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Back Up Cisco CRS 40(55a) System Data

Figure 7 Status Message for Successful Backup Operation

Step 10 Click OK on the status message and you can view the detailed status including the location of the log file (see Figure 8)

16Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 8 Detailed Status Window Highlighting Location of the Log File

If the backup operation does not complete successfully the status window displays the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

Step 11 Click Next The Post-Backup Checklist window appears (see Figure 9) This checklist reminds you of the tasks that you need to perform after the backup process

17Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 9 Post-Backup Checklist Window

Step 12 Click Finish The Exit Confirmation window appears (see Figure 10)

Figure 10 Exit Confirmation Window

Step 13 Click Yes to quit DMT

DMT records all historical and configuration data and automatically backs up the database to the specified storage location either on your CRS 40(55a) system or on a safe network location in the TAR format

18Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

View Backup TAR File Details

After you complete the backup activity you can validate the backup TAR file and view its details To validate the backed up TAR file and view its details do the following

Step 1 From the Cisco Unified CCX Data Migration Tool Home window choose Options gt Check Archive

The Enter the location of a valid backup file window appears (see Figure 11)

Figure 11 Enter the Location of a Valid Backup File Window

Step 2 Enter the location information and user credentials of the latest TAR file you backed up

Step 3 Click Validate DMT validates the backup TAR file and displays the Data Migration Backup File Info window (see Figure 12)

19Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 17: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Back Up Cisco CRS 40(55a) System Data

Figure 8 Detailed Status Window Highlighting Location of the Log File

If the backup operation does not complete successfully the status window displays the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

Step 11 Click Next The Post-Backup Checklist window appears (see Figure 9) This checklist reminds you of the tasks that you need to perform after the backup process

17Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 9 Post-Backup Checklist Window

Step 12 Click Finish The Exit Confirmation window appears (see Figure 10)

Figure 10 Exit Confirmation Window

Step 13 Click Yes to quit DMT

DMT records all historical and configuration data and automatically backs up the database to the specified storage location either on your CRS 40(55a) system or on a safe network location in the TAR format

18Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

View Backup TAR File Details

After you complete the backup activity you can validate the backup TAR file and view its details To validate the backed up TAR file and view its details do the following

Step 1 From the Cisco Unified CCX Data Migration Tool Home window choose Options gt Check Archive

The Enter the location of a valid backup file window appears (see Figure 11)

Figure 11 Enter the Location of a Valid Backup File Window

Step 2 Enter the location information and user credentials of the latest TAR file you backed up

Step 3 Click Validate DMT validates the backup TAR file and displays the Data Migration Backup File Info window (see Figure 12)

19Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 18: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Back Up Cisco CRS 40(55a) System Data

Figure 9 Post-Backup Checklist Window

Step 12 Click Finish The Exit Confirmation window appears (see Figure 10)

Figure 10 Exit Confirmation Window

Step 13 Click Yes to quit DMT

DMT records all historical and configuration data and automatically backs up the database to the specified storage location either on your CRS 40(55a) system or on a safe network location in the TAR format

18Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

View Backup TAR File Details

After you complete the backup activity you can validate the backup TAR file and view its details To validate the backed up TAR file and view its details do the following

Step 1 From the Cisco Unified CCX Data Migration Tool Home window choose Options gt Check Archive

The Enter the location of a valid backup file window appears (see Figure 11)

Figure 11 Enter the Location of a Valid Backup File Window

Step 2 Enter the location information and user credentials of the latest TAR file you backed up

Step 3 Click Validate DMT validates the backup TAR file and displays the Data Migration Backup File Info window (see Figure 12)

19Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 19: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Back Up Cisco CRS 40(55a) System Data

View Backup TAR File Details

After you complete the backup activity you can validate the backup TAR file and view its details To validate the backed up TAR file and view its details do the following

Step 1 From the Cisco Unified CCX Data Migration Tool Home window choose Options gt Check Archive

The Enter the location of a valid backup file window appears (see Figure 11)

Figure 11 Enter the Location of a Valid Backup File Window

Step 2 Enter the location information and user credentials of the latest TAR file you backed up

Step 3 Click Validate DMT validates the backup TAR file and displays the Data Migration Backup File Info window (see Figure 12)

19Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 20: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Back Up Cisco CRS 40(55a) System Data

Figure 12 Data Migration Backup File Info Window

Step 4 Review the backup TAR file information and then click Close

Step 5 Finally click Home to go back to the Cisco Unified CCX Data Migration Tool Home window

Perform the Post-Backup ActivitiesYou have to convert and store the recording data (audio files) at a safe network location as the recording data will not be automatically backed up by DMT

Step 1 Collect all IP addresses for all CRS and CAD servers Include all off-board recording servers if any

Step 2 On each of these servers convert any recordings stored on it to WAV format using the RAW to WAV utility (raw2wavexe) Refer to the Cisco CAD Installation Guide for details on using this utility

20Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 21: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Upgrade Cisco CRS 40(55a) System

Note Since after upgrading CRS 40(55a) and Cisco CallManager existing recordings will be deleted from the recording server and will no longer be available for review through Cisco Supervisor Desktop you must use the RAW to WAV utility to convert them to WAV format and store the converted files on a secure server on the network for later use These files can then be played using any application that is capable of playing WAV format files You can use the batch file processing option of the RAW to WAV utility to convert multiple recordings (audio files) to WAV format at once

By default recordings are located at CProgram FilesCiscoDesktopDesktop_Audio If a custom location was configured use the registry key to locate it Open the Windows Registry and then navigate to the key

HKEY_LOCAL_MACHINESOFTWARESpanlinkCADRecording amp Playback ServerconfigAudio Directory

Step 3 Copy the converted recording files to a secure server on the network

Upgrade Cisco CRS 40(55a) SystemTo upgrade Cisco CRS 40(55a) to Unified CCX 70(1) and the corresponding Unified CM to the latest compatible version do the following

Note To find the most compatible version of Unified CM refer to the Cisco Unified Contact Center Express Software and Hardware Compatibility Guide

Step 1 It is mandatory that you use only the DMA tool to upgrade Cisco CallManager to the latest compatible version of Unified CM in order to run with Unified CCX 70(1) For additional information on the DMA tool see httpwwwciscocomenUSdocsvoice_ip_commcucmdma7_1_2dmaug712html

a Go to this URL and log in using your Ciscocom User Name and Password httptoolsciscocomsupportdownloadsgoRedirectxmdfid=278875240

21Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 22: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Upgrade Cisco CRS 40(55a) System

b Choose IP Telephony gt Call Control gt Cisco Unified Communications Manager (CallManager) and then choose the DMA version that is most compatible with the Cisco CallManager

For more information on how to install Unified CM see httpwwwciscocomenUSproductsswvoiceswps556prod_installation_guides_listhtml

Caution Do not perform LDAP synchronization during Cisco CallManager upgrade (using DMA) prior to running the Unified CCX Data Migration Tool

Step 2 Install Windows 2003 OS and Unified CCX 70(1) on a machine where you want to restore the backed up data For installation instructions refer to the Cisco Unified CCX 70(1) Installation Guide

Caution Do not perform the initial setup configuration on the Unified CCX 70(1) system after fresh installation to avoid any data conflicts

Note If you have been running Cisco IP Queue Manager (IP QM) license on your CRS 40(55a) system then upgrade it to Unified CCX 70(1) with Cisco Unified IP Interactive Voice Response (Unified IP IVR) license For more information on upgrading from IP QM to Unified IP IVR refer to the End-of-Life (EOL) notice

Warning Delete the CRS 40(55a) node2 CTI ports only if you have taken the backup from a CRS 40(55a) system having HA setup

22Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 23: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Restore the Backed Up Data

Restore the Backed Up DataRestoring the backed up data on the Unified CCX 70(1) system involves the following

bull Perform the Pre-Restore Activities page 23

bull Run the Restore Process page 23

bull Perform the Post-Restore Activities page 34

Perform the Pre-Restore ActivitiesBefore DMT starts restoring the CRS 40(55a) data on the Unified CCX 70(1) system verify whether you have performed the following pre-restore activities

1 Make sure that you have not performed any initial setup configuration on the Unified CCX 70(1) system

2 Make sure that the Unified CM is upgraded to the most up-to-date version compatible with Unified CCX 70(1) using the DMA tool

3 Make sure that the Unified CM services are up and running

4 Clean up any existing configuration data if found on the Unified CCX 70(1) system

5 Perform the Add to Cluster operation only after the backed up data is successfully restored on the Unified CCX 70(1) system

6 Be patient during the restore activity as it may take several minutes to complete based on the data getting restored

7 Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on the Unified CCX 70(1) system

8 You might lose some historical reporting data if the hard disk size on the Unified CCX 70(1) system is downgraded

Run the Restore ProcessTo automatically restore the backed up data on a system installed with Unified CCX 70(1) run DMT again on the Unified CCX 70(1) system

23Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 24: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Restore the Backed Up Data

Step 1 Obtain a copy of the DMT ZIP file containing UCCXDataMigratorexe from the location where you stored earlier

Step 2 Double-click to run the UCCXDataMigratorexe The Cisco Unified CCX Data Migration Tool Home window appears (see Figure 13)

Figure 13 Cisco Unified CCX Data Migration Tool Home Window

Step 3 Click Next The Pre-Restore Checklist window appears (see Figure 14)

24Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 25: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Restore the Backed Up Data

Figure 14 Pre-Restore Checklist Window

Step 4 Make sure that you have performed all the listed action items and then click Accept to proceed The Location of a Valid Backup File window appears (see Figure 15)

If you have missed any of the listed action items click Decline perform that action item and then restart the restore process from Step 1

25Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 26: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Restore the Backed Up Data

Figure 15 Location of a Valid Backup File Window

Step 5 In the Location of a Valid Backup File window enter the location of the stored backup TAR file and the user credentials (user name and password) to access it

a For a Network Directory enter

ndash Backup locationmdashNetwork path or IP address of the system where the backup file is stored

ndash User NamemdashUser name for network access

ndash PasswordmdashPassword for network access

After you enter the network path or IP address and the user credentials click Browse () to navigate to the appropriate folder where the backup file is stored

b For a LocalShared Directory enter the path to the folder in the Path Name field or click Browse () to choose the localshared folder

26Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 27: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Restore the Backed Up Data

Step 6 Click Next to proceed The Cisco Unified CCX Data Migration Tool License Upload window appears (see Figure 16)

Figure 16 License Upload Window

Step 7 In the License File Location field click Browse () to specify a local folder where the valid Unified CCX 70(1) license files are located or enter the location manually

Step 8 Click Next The License Validation window appears (see Figure 17)

27Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 28: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Restore the Backed Up Data

Figure 17 License Validation Window

Step 9 Click OK The Cisco Unified CM Administration login details window appears (see Figure 18)

28Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 29: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Restore the Backed Up Data

Figure 18 Cisco Unified CM Administration login details Window

Step 10 Verify if the Unified CM Administrator authentication details (including Unified CM IP address AXL Admin User Name and Password) that are displayed in the Cisco Unified CM Administration login details window are up-to-date and click Next

Caution It is not recommended to change the Cisco Call Manager IP address or Administrator credentials during the upgrade However if you have changed these details while upgrading Cisco CallManager using the DMA tool verify if the information pre-populated in the Unified CM Administration login details window is up-to-date if not update the information in this window accordingly

Step 11 The Unified CM Validation Completed Successfully message window appears prompting you to click OK to start data migration (see Figure 19)

29Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 30: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Restore the Backed Up Data

Figure 19 Unified CM Validation Completed Sucessfully Message

Window

Step 12 Click OK

Step 13 If the database being used on the Unified CCX 70(1) system is different from what you have used in CRS 40(55a) then you might be prompted with a message to confirm the same (see Figure 20)

Figure 20 Database Confirmation Window

Step 14 Click Yes to confirm The Restore in Progress window appears (see Figure 21)

30Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 31: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Restore the Backed Up Data

Note If you had HA setup on your CRS 40(55a) system a warning message might appear prompting you to upload a valid Unified CCX 70(1) HA license (if you have not done so) before you perform the Add to Cluster operation

Figure 21 Restore in Progress Window

Step 15 The data is restored from the said location A status window is displayed once DMT successfully completes the restore operation (see Figure 22)

31Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 32: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Restore the Backed Up Data

Figure 22 Restore Operation Successful Window

Step 16 After the restore activity is successful a warning message appears with further information to complete the restore activity Read thoroughly and click OK

An Information window appears with the message that DMT successfully completed the data restore operation (see Figure 23)

Figure 23 Information Window

Step 17 Click OK The Application Administration page appears

32Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 33: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Restore the Backed Up Data

Step 18 Minimize the Application Administration page and click Next on the Restore Operation Successful window The Post-Restore Checklist window appears (see Figure 24)

Figure 24 Post-Restore Checklist Window

Step 19 Read through the listed activities and click Finish The Exit Confirmation window appears (see Figure 25)

Figure 25 Exit Confirmation Window

Step 20 Click Yes to quit DMT

If the restore operation does not complete successfully a status window is displayed with the appropriate error message(s) You must review the error logs and correct problems as described in ldquoTroubleshooting Tipsrdquo section on page -40

33Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 34: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Restore the Backed Up Data

To successfully complete the data migration process complete the post-restore activities on the Unified CCX 70(1) system as listed in the ldquoPerform the Post-Restore Activitiesrdquo section on page -34 Once you complete all these activities your call center should be functional and ready to handle calls without any further configuration

Perform the Post-Restore ActivitiesRunning DMT on a Unified CCX 70(1) system restores all the historical and configuration data However some of the settings may not have been preserved during the upgrade and need to be manually re-configured

Step 1 Restore the Application Administration page that you minimized earlier and log in to the Unified CCX 70(1) Application Administration with the Administrator credentials (with the same user name as used in CRS 40(5) and the password as specified during Cisco CallManager upgrade) to start the JTAPI data resynchronization operation (see Figure 26)

Note It may take a while to start the Application Administration process after the node manager restart If you encounter ldquoPage Not Foundrdquo error wait for a few minutes and then refresh the Application Administration web page to start the JTAPI data resynchronization operation

34Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 35: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Restore the Backed Up Data

Figure 26 Application Administration Window Showing JTAPI Data

Resynchronization

Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Step 2 On the Application Administration page choose Subsystems gt Cisco Unified CM Telephony and then click Cisco JTAPI Resync on the left pane of the Unified CCX 70(1) node to synchronize the JTAPI client

Step 3 On the Unified CM choose User Management gt End User and change the password for all the Administrators or Supervisors to avoid any security threat

Step 4 Launch Cisco Desktop Administrator and verify whether the configuration settings from your CRS 40(55a) system have been restored

Note It is also recommended that you test workflows on the Cisco Desktop Administrator to make sure that they work appropriately

35Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 36: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Restore the Backed Up Data

Step 5 If the configuration settings from your CRS 40(55a) system have not been restored after the restore process manually re-create the following configuration settings on the Cisco Desktop Administrator

bull Re-enable the reason codes for each workflow group (if required) since the reason codes get automatically disabled after the upgrade

bull Re-insert the accent grave symbol (`) after the upgrade if you have used it earlier in your CRS 40(55a) system The accent grave symbol (`) disappears from all the instances where it has been used in a field name in CAD 61(5)

bull Re-create the custom enterprise data field with the index number 0 (zero) after the upgrade since it gets deleted after the upgrade

bull In an HTTP action the system field AGENT_ID is changed to AGENT_NAME and is functionally the same However the AGENT_ID system field is still available for you to use

bull Since CAD-BE is available in CAD 66(1) re-configure all Agent Desktop workflows after the upgrade Existing Agent Desktop workflows are not applied to CAD-BE as it was not available in CAD 61(5)

bull Use the Supervisor credentials configured while installing in Unified CCX 70(1) to log into Cisco Supervisor Desktop since you might have lost the Supervisor Desktop preferences due to underlying changes in the structure of Report tables

bull Note that all Conference Call Control actions become supervised conference Call Control actions after the restore process

bull Note that all existing Logout reason codes are prepended with a 1 (for example reason codes 1 2 and 3 become 11 12 and 13) and all existing Not Ready reason codes are prepended with a 2 (for example reason codes 1 2 and 3 become 21 22 and 23) to ensure that all reason codes have unique IDs

Step 6 On all Agent Desktops uninstall all CRS 40(55a) plug-ins and reboot all the Agent Desktops

Step 7 Install the latest compatible Unified CCX 70(1) desktop suites including CAD 66 on the rebooted and clean Agent Desktops Make sure that the system is updated as needed to provide the appropriate system environment For system requirements and instructions on installing Unified CCX 70(1) desktop suites refer to the Cisco CAD Installation Guide for CAD 66 for Unified CCX 70(1)

36Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 37: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Restore the Backed Up Data

Note Cisco Desktop Administrator has changed significantly since version 61 and portions of the functionality are now configured using a web interface To understand the location where you should enter all the configuration data and review all the enhanced features (such as reason codes work flows and more) refer to the Cisco Desktop Administrator User Guide available here httpwwwciscocomenUSproductsswcustcoswps1846products_user_guide_listhtml

Step 8 If you are migrating data from an HA setup existing in your CRS 40(55a) system you must delete all the node2 CTI ports from the Unified CM to avoid any port conflicts while setting up HA on the Unfied CCX 70(1) system

To delete all the node2 CTI ports from Unified CM you must complete the restore operation on the first node of the Unfied CCX 70(1) system using DMT and then do the following

a Choose Options gt Remove CTI Ports from the Restore Operation Successful window or from the Cisco Unified CCX Data Migration Tool Home window (see Figure 27)

Note You will find the Remove CTI Ports option enabled in the Restore Operation Successful window or in the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Remove CTI Ports option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

Figure 27 Choosing to Remove CTI Ports from Unified CM

b Click Yes in the Confirmation window that appears (see Figure 28)

37Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 38: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Restore the Backed Up Data

Figure 28 Confirmation Window for Removing CTI Ports

Note You can view all the CTI ports listed on the CCTIPortshtml page before you start deleting the CTI ports from Unified CM

c DMT starts deleting the CTI ports (see Figure 29)

Figure 29 Deleting CTI Ports by DMT

38Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 39: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

View Log Files

d After all the node2 CTI ports are deleted a warning message appears (see Figure 30) that prompts you to go ahead with the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system For more information refer to the Cisco Unified Contact Center Express Administration Guide

Figure 30 Confirmation Window for Removing Node2 CTI Ports

You can now perform the Add to Cluster operation to bring up the HA setup on the Unified CCX 70(1) system

If all the node2 CTI ports are not removed then you will get a warning message prompting you to choose Options gt Remove CTI Ports again until all the node2 CTI ports are deleted

Figure 31 Warning Message for Removing Node2 CTI Ports

Step 9 Make sure that the custom Java classes are compatible with JDK15 being used in Unified CCX 70(1)

View Log FilesIf you encounter problems while running DMT you can obtain and examine the migration log file (CDMLogltDateTimegtzip) generated by DMT

To analyze the log file for the most recent iteration of data migration activity unzip the log file and open the CCXDataMigration(0)-0log file

39Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 40: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Troubleshooting Tips

Troubleshooting TipsWhile using DMT for the data migration activity you may encounter some errors and warnings that can hamper the data migration process This section contains the following troubleshooting tips for the problems that can occur during the data migration activity

Power Failure during Data Restore with DMT

Problem Restore process fails due to power outage or an error occurs during historical reporting (HR) data restore process using DMT

Workaround Check the registry entry from HKEY_LOCAL_MACHINESOFTWARECisco Systems Inc CCXDataMigrationMigrationStatus If the value is less than 4 run DMT again to complete the data migration If the value is equal to 4 choose Options gt Repair DB on the Cisco Unified CCX Data Migration Tool Home window and run DMT again Choosing Options gt Repair DB performs the sanity check of the database creates missing tables (if any) and cleans the partially migrated tables

Tip To map the phase that got migrated refer to lsquoComponents Completedrsquo entry in the log file such as lsquoMigrationStatus 4rsquo means HR data migration

Note You will find the Repair DB option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Repair DB option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

40Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 41: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Troubleshooting Tips

Remove Attached CRS 40(55a) Database after Restore Failure

Problem Data migration fails because a wrong TAR file is selected during the restore process or data migration fails at the end of phase 4 while the attached db_cra_4x is being removed

Workaround If the restore process fails because of an error the CRS 40(55a) DB remains attached to the Unified CCX 70(1) DB Choose Options gt Tear Down from the Cisco Unified CCX Data Migration Tool Home window to remove the attached CRS 40(55a) database from the Unified CCX 70(1) database prior to running DMT again

Note You will find the Tear Down option enabled on the Cisco Unified CCX Data Migration Tool Home window only if you use a system installed with Unified CCX 70(1) base version The Tear Down option will be disabled if the Unified CCX 70(1) system is installed with any other SR or ES releases

DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled

Problem After an SRES release is installed on the Unified CCX 70(1) system the options Remove CTI Ports Tear Down and Repair DB become disabled in DMT

Error Message None

Workaround Uninstall the SRES release from the Unified CCX 70(1) system and then perform the required operation

41Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 42: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Troubleshooting Tips

Generic Error Message Displayed for any Data Migration Error

Problem A generic error message is displayed whenever an error occurred during the Data Migration

Error Message An error occurred during the Data Migration operation The CCX Data Migration tool will now abort

Workaround Check the data migration log to find out the root cause for the issue and take necessary action

DMT Intended to Run Only on a Valid CRS Unified CCX System

Problem DMT is intended to run only on a valid CRS Unified CCX system during backup or restore operation

Error Message Error no server JVM at ltJAVA_HOMEgtbinserverjvmdll

Error Message Please run the Cisco Unified CCX data migration tool on valid CRS CCX box

Error Message Not a Cisco CRSUnified CCX box Please run this tool in a valid CRS CCX box

Workaround Run the DMT on a valid CRS Unified CCX system that is either on CRS 40(5) or Unified CCX 70(1) base version

42Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 43: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Troubleshooting Tips

Network Path not Accessible during Data Backup

Problem Network path is not accessible during data backup process

Error Message 1 There was a problem accessing the backup path

Error Message 2 Make sure the path exists and is accessible

Workaround Make sure that the network connectivity is active and the backup location is accessible and then run DMT again to start the backup process from the beginning

Split Operation on Database Backup File Failed

Problem The db_cradmp file split operation failed Tip The split operation will happen only if the db_cra size is greater than 8GB

Error Message DB backup file split operation failed

Workaround Make sure that the database backup file in staging directory (CDM-STI) is not accessed by any other program during the export Run DMT again to start the backup process from the beginning

43Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 44: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Troubleshooting Tips

Creating Backup TAR file on a Network Location Failed

Problem Error thrown while creating the backup TAR archive on a network location

Error Message Backup TAR file creation failed

Workaround Make sure that the network connectivity is up and running to the backup location and you have necessary permissions to create a backup file on the network location Re-run DMT to start the backup activity from scratch

CRS Database Backup Operation Failed

Problem CRS database (CDSADSRDSHDS) backup operation is failed

Error Message CRS database backup operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

Agent Desktop Configuration Data Backup Operation Failed on Engine Node

Problem Agent Desktop Configuration data backup operation fails on the engine node

Error Message Desktop Agent config export operation failed

Workaround Make sure that LDAP monitor service is running on the engine node and check the desktop logs (CProgram FilesCiscoDesktoplog) to find out the root cause for the issue

44Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 45: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Troubleshooting Tips

Data Backup Operation failed while Exporting Engine Session ID

Problem Data backup operation failed while backing up the Engine Session ID

Error Message Engine Session ID export operation failed

Workaround Stop and disable Cisco Security Agent (CSA) and other antivirus software applications if any running on CRS 40(55a) Engine master and DB publisher nodes

Config Data Backup Operation Failed

Problem Config data backup operation failed

Error Message Session IDAlarmLicenseScriptsJTAPI TraceNode ConfigUsersLDAP Profile Export operation failed

Workaround Check the data migration log to find out the root cause for the issue and take necessary action Re-run DMT to start the backup activity from scratch

CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM

Problem CRS Group configuration data backup operation failed due to data inconsistency between CRS and Unified CM

Error Message Group Config export failed Seems like the CRS and CCM data are not in sync

Workaround Run the JTAPI Resynchronization operation from the CRS Application Administration page and re-run DMT to start the backup activity from scratch

45Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 46: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Troubleshooting Tips

Configuration Data Backup Operation Failed because no AXL Host Information Found

Problem Configuration data backup operation failed because DMT could not find the AXL host (Cisco CallManger) information

Error Message Config export failed Couldnt find the AXL host information

Workaround Make sure that the Unified CM node is up and running and re-run DMT to start the backup activity from scratch

AXL Error during the LDAP Configuration Data Backup Operation

Problem AXL error during the LDAP configuration data backup

Error Message AXL error occurred during the export

Workaround Make sure that the Unified CM is accessible and the AXL service is running

LDAP Configuration Data Backup Operation Failed

Problem LDAP configuration data backup operation failed

Error Message ltLDAP config Namegt export failed

Workaround Make sure that the directory service (DCNDAD) is up and running and can be accessed from the CRS system Re-run DMT to start the backup activity from scratch

46Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 47: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Troubleshooting Tips

Catalog File Creation Failed

Problem Catalog file creation failed

Error Message Data Migration catalog creation failed

Workaround Re-run DMT to start the backup activity from scratch

CVD Communication Failed because Node Manager is Down

Problem Node Manager is down during backup or restore activity

Error Message 1 CVD communication failed Please make sure that the Node Manager is up and running on this node

2 CVD communication failed

Workaround Start the Node Manager and re-run DMT Also make sure that all the nodes in the cluster are up and running before you re-run DMT

CRS EngineDB Master Node not Found

Problem DMT could not find the CRS EngineDB master nodes CRS Cluster is in an inconsistent state

Error Message Couldnt find the EngineDB master node

Workaround Make sure that the CRS cluster is in a working state before starting the backup operation

47Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 48: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Troubleshooting Tips

DMT is not Executed from the DB Publisher Node

Problem DMT is intended to run only from the DB publisher node

Error Message Please run this tool on the DB publisher node (IP)

Workaround Run DMT from the Database publisher node

CRS License Package not Found

Problem CRS cluster license package is lsquoNonersquo

Error Message CRS cluster license package is None

Workaround Upload a valid CRS 40(5) license before running DMT for the data backup operation

Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)

Problem Maximum supported database for export is 10 GB

Error Message The used DB space is greater than the size supported in CCX 70 releaseSo please purge the data before continue the data export operation

Workaround Purge the database to a supported size for data migration and re-run DMT

48Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 49: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Troubleshooting Tips

Disk Space not Enough to Store the Backup File

Problem Local staging drive (C) does not have enough space to store the backup data

Error Message There is not enough space in local disk to store the backup data

Workaround Free up local staging drive space to store the backup file

Staging Directory File Creation Failed

Problem Staging directory file creation failed

Error Message Staging directory file creation failed

Workaround Make sure you have permissions to create directories in the staging drive (C) and re-run DMT to start the backup operation

File Join Operation Failed

Problem The db_cradmp file join operation failed

Error Message File join operation failed

Workaround Make sure that the split files (db_cradmp_1 and db_cradmp_2) are not accessed by any other programs Re-run DMT to start the restore activity from scratch

49Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 50: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Troubleshooting Tips

Unified CCX 70(1) ICD Language is Different from CRS 40(55a)

Problem Customer has installed Unified CCX 70(1) system with an ICD language different from the CRS 40(55a) system

Error Message CCX 70 ICD language is different from the CRS 40

Workaround Reinstall the Unified CCX 70(1) system with proper CAD language selected (same as CRS 40(55a) backup) and run DMT again

High Availability Mode not Supported during Data Migration

Problem HA has been formed before performing the data migration

Error Message CCX 70(1) setup is in High Availability mode

Workaround Backup activity should be performed only on FirstSingle Node Remove the second node and re-run DMT

License Upload Failed

Problem License upload failed

Error Message CCX 70 license upload failed

Workaround Make sure that the license directory has not been deleted during the restore process and re-run DMT

50Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 51: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Troubleshooting Tips

Not Enough Space to Stage Backup File On Unified CCX 70(1)

Problem Unified CCX 70(1) system does not have enough space to stage the backup TAR archive

Error Message The system doesnt have enough space to stage the backup TAR archive

Workaround Run DMT after freeing up space on the staging drive (C) on the Unified CCX 70(1) system

Invalid Backup TAR File Used

Problem Invalid backup tar file is used

Error Message Not a CRS 40(5) Data Migration backup TAR

Workaround Re-run DMT and select the valid CRS 40(55a) backup TAR file

SQL Server Port Mismatch

Problem SQL Server is installed with a different SQL port on the Unified CCX 70(1) system

Error Message CCX 70 SQL Server port is different from the CRS 40 backup

Workaround Re-install the SQL Server with proper SQL port selected (same as used for CRS 40(55a) backup) and re-run DMT

51Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 52: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Troubleshooting Tips

Backup TAR File Validation Failure

Problem Not a valid backup TAR file

Error Message Error while validating the backup TAR file

Workaround Make sure that you are using the backup TAR file with the same version as the tool You can view the backup TAR file info (including the version) using the Check Archive option during the restore activity using DMT

Component Activation Failed on Unified CCX 70(1) System

Problem DB and engine component activation failed

Error Message Component activation failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Configuration Framework Initialization Failed on Unified CCX 70(1) System

Problem Configuration framework initialization failed

Error Message Config framework initialization failed

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

52Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 53: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Troubleshooting Tips

Configuration Objects cannot be Accessed on Unified CCX 70(1) System

Problem DMT can not access the Unified CCX 70(1) configuration objects

Error Message Error while retrieving the CCX Node ID

Workaround Make sure that the restore process is carried out on a freshly installed Unified CCX 70(1) system

Historical Reporting Database Data Purging Operation Failed

Problem Historical Reporting database data purging operation failed

Error Message HR DB data purging operation failed

Workaround Check the data migration log to find out the root cause and run DMT again

Node2 CTI Ports Removal Failed

Problem Node2 CTI Ports are not removed before performing the Add to Cluster operation and setting up HA on Unified CCX 70(1) system

Error Message HR DB data purging operation failed

Workaround Choose Options gt Remove CTI Ports until all the node2 CTI ports are deleted

If this option is unable to delete the CTI Ports do the following to manually remove the node2 CTI ports from the Cisco Unified CM

Step 1 Delete phones by choosing Device gt Phone page

53Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 54: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Troubleshooting Tips

Step 2 Delete each port by choosing Call Routing gt Route Plan Report page

Since this page does not provide an option to delete all of such ports together you should manually delete each port by accessing the configuration page of that particular port After deleting each port you will be redirected to the Phone page so that you repeat this step to delete the next port

CTI Ports Removal Failed

Problem Removing CTI ports fails and the log has the following exception javalangArrayIndexOutOfBoundsException 0

Error Message Error occurred while removing CTI port

Workaround Launch DMT and perform the port removal operation again

Data Migration Process cannot be CompletedIf you are unable to complete the data migration process (backup or restore) using DMT use BARS to retrieve the entire backed up data taken initially prior to starting the backup process using DMT This will help you roll back to your existing CRS 40(55a) system and get your call center back in operation

However this is not recommended unless it is absolutely necessary to make the call center operational

Agent Desktop Configuration Backup Process Failed

Problem Cisco Security Agent (CSA) or other antivirus applications are not disabled or stopped during data migration

Error Message Agent desktop config backup failed

Workaround Stop and disable CSA and all other antivirus applications and run the backup process again

54Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 55: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Troubleshooting Tips

Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table

Problem Restore process fails during migration of CRS JTAPI user but the upgraded Unified CM has the JTAPI user

Error Message The JTAPI user seems to be missing in the CUCM end user table Insert the user and re-run the tool

Workaround Run DMT again DMT should resume from the beginning of this phase and migrate data successfully

This occurs when AXL query to the Unified CM does not return an appropriate value

User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration

Problem User is Unable to log in to Unified CCX 70(1) Application Administration page even after a successful data migration Warning If any of the Administrator capabilities are not assigned to some users by DMT complete the Application Administration setup by logging in with the default Administrator credentials (user name as lsquoAdministratorrsquo and password as lsquociscociscorsquo complete the initial setup and then perform the JTAPI Client and Data Resynchronization operation

Workaround If the above warning occurred during restore perform the recommended action and select the Administrators during initial setup

Tip Make sure that the passwords for all AdministratorSupervisorAgentHR Users are reset since CallManager upgrade using DMA resets all end user passwords

55Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 56: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Troubleshooting Tips

Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration

Problem Some of the services are not functioning correctly since the Unified CCX 70(1) server IP addresshostname has changed during the upgrade

Workaround If the Unified CCX 70(1) server IP address is different after the upgrade and data migration the following issues and symptoms may appear which can be resolved using the corresponding workarounds

bull Availability of incorrect VoIP Monitor and Recording amp Playback services in Directory Services Remove any incorrect VoIP Monitor and Recording amp Playback services from Directory Services using the web portion of Cisco Desktop Administrator Choose Services Configuration gt Silent Monitoring amp Recording gt Remove VoIPRecording amp Playback Services and remove the obsolete services

Note This feature is not available in the base version of Unified CCX 70(1) You must have Unified CCX 70(1) SR1 installed to access this feature

bull Some services stops functioning correctly at the startup This happens only when both CRS 40(55a) and Unified CCX 70(1) servers are active at the same time To resolve this issue do either of the following

ndash Turn off the CRS 40(55a) server before you start the Unified CCX 70(1) server

ndash Restart any CAD services that are reported as being out of service on the agent desktop

Note It is strongly recommended to retain the same IP address for the Unified CCX 70(1) server as it was for your CRS 40(55a) server However if you have expansion deployments in CRS 40(55a) retain the Engine Master and Slave IP addresses on the Unified CCX 70(1) Node1 and Node2 respectively

56Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 57: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Best Practices

Best PracticesTo reduce the downtime of your contact center it is recommended that you plan the upgrade and data migration in advance The following are the best practices that help reduce the downtime of your contact center

bull Download the Data Migration Assistant (DMA) tool to upgrade Unified CM and keep it handy

bull Download Data Migration Tool (DMT) on the CRS 40(55a) system and keep it handy

bull Upgrade process should be carried out during off-peak hours or in a maintenance window as your system cannot handle calls during an upgrade

bull Procure the appropriate licenses for Unified CCX 70(1) and Unified CM and keep them handy

bull Keep the installer DVDs of Unified CCX 70(1) and Unified CM handy

bull See Table 1 on page 5 for DB size limit and manually purge any excess data accordingly

bull You must plan the data migration activity andor any purging activity well in advance to avoid extended downtime and unnecessary delay

bull Perform the pre-backup activities for recordings and other data if any on your CRS 40(55a) system while your call center is operational

bull After you complete the data migration activity uninstall CRS 40(55a) plug-ins from the agent desktops and install Unified CCX 70(1) desktop suite on these agent desktops immediately so they can start handling calls

Warning Data migration activity might fail if the hard disk size for the Unified CCX 70(1) system is downgraded For successful data migration make sure that the free hard disk space on the Unified CCX 70(1) system (after fresh installation) is 21 times more than the backup file size

57Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation
Page 58: Cisco Unified Contact Center Express Data Migration Tool ...€¦ · then perform the data migration activity. For more information, refer to the Cisco Unified Contact Center Express

Obtain Additional Support and Documentation

Obtain Additional Support and DocumentationFor information on obtaining support obtaining additional documentation providing documentation feedback security guidelines and also recommended aliases and general Cisco documents see the monthly Whats New in Cisco Product Documentation which also lists all new and revised Cisco technical documentation at

httpwwwciscocomenUSdocsgeneralwhatsnewwhatsnewhtml

This document is to be used in conjunction with the document_title publication

CCDE CCENT CCSI Cisco Eos Cisco HealthPresence Cisco IronPort the Cisco logo Cisco Lumin Cisco Nexus Cisco Nurse Connect Cisco StackPower Cisco StadiumVision Cisco TelePresence Cisco Unified Computing System Cisco WebEx DCE Flip Channels Flip for Good Flip Mino Flip Video Flip Video (Design) Flipshare (Design) Flip Ultra and Welcome to the Human Network are trademarks Changing the Way We Work Live Play and Learn Cisco Store and Flip Gift Card are service marks and Access Registrar Aironet AsyncOS Bringing the Meeting To You Catalyst CCDA CCDP CCIE CCIP CCNA CCNP CCSP CCVP Cisco the Cisco Certified Internetwork Expert logo Cisco IOS Cisco Press Cisco Systems Cisco Systems Capital the Cisco Systems logo Cisco Unity Collaboration Without Limitation EtherFast EtherSwitch Event Center Fast Step Follow Me Browsing FormShare GigaDrive HomeLink Internet Quotient IOS iPhone iQuick Study IronPort the IronPort logo LightStream Linksys MediaTone MeetingPlace MeetingPlace Chime Sound MGX Networkers Networking Academy Network Registrar PCNow PIX PowerPanels ProConnect ScriptShare SenderBase SMARTnet Spectrum Expert StackWise The Fastest Way to Increase Your Internet Quotient TransPath WebEx and the WebEx logo are registered trademarks of Cisco Systems Inc andor its affiliates in the United States and certain other countries

All other trademarks mentioned in this document or website 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 (0907R)

58Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10

  • Cisco Unified Contact Center Express Data Migration Tool User Guide Release 10
    • Overview of DMT
    • Obtain DMT
    • Prerequisite
    • Important Considerations
    • Back Up Cisco CRS 40(55a) System Data
      • Perform the Pre-Backup Activities
      • Run the Backup Process
        • View Backup TAR File Details
          • Perform the Post-Backup Activities
            • Upgrade Cisco CRS 40(55a) System
            • Restore the Backed Up Data
              • Perform the Pre-Restore Activities
              • Run the Restore Process
              • Perform the Post-Restore Activities
                • View Log Files
                • Troubleshooting Tips
                  • Power Failure during Data Restore with DMT
                  • Remove Attached CRS 40(55a) Database after Restore Failure
                  • DMT Options ldquoRemove CTI Portsrdquo ldquoTear Downrdquo and ldquoRepair DBldquo are Disabled
                  • Generic Error Message Displayed for any Data Migration Error
                  • DMT Intended to Run Only on a Valid CRS Unified CCX System
                  • Network Path not Accessible during Data Backup
                  • Split Operation on Database Backup File Failed
                  • Creating Backup TAR file on a Network Location Failed
                  • CRS Database Backup Operation Failed
                  • Agent Desktop Configuration Data Backup Operation Failed on Engine Node
                  • Data Backup Operation failed while Exporting Engine Session ID
                  • Config Data Backup Operation Failed
                  • CRS Group Configuration Data Backup Operation Failed due to Data Inconsistency between CRS and Unified CM
                  • Configuration Data Backup Operation Failed because no AXL Host Information Found
                  • AXL Error during the LDAP Configuration Data Backup Operation
                  • LDAP Configuration Data Backup Operation Failed
                  • Catalog File Creation Failed
                  • CVD Communication Failed because Node Manager is Down
                  • CRS EngineDB Master Node not Found
                  • DMT is not Executed from the DB Publisher Node
                  • CRS License Package not Found
                  • Backup DB Size is Greater than Supported DB Space in Unified CCX 70(1)
                  • Disk Space not Enough to Store the Backup File
                  • Staging Directory File Creation Failed
                  • File Join Operation Failed
                  • Unified CCX 70(1) ICD Language is Different from CRS 40(55a)
                  • High Availability Mode not Supported during Data Migration
                  • License Upload Failed
                  • Not Enough Space to Stage Backup File On Unified CCX 70(1)
                  • Invalid Backup TAR File Used
                  • SQL Server Port Mismatch
                  • Backup TAR File Validation Failure
                  • Component Activation Failed on Unified CCX 70(1) System
                  • Configuration Framework Initialization Failed on Unified CCX 70(1) System
                  • Configuration Objects cannot be Accessed on Unified CCX 70(1) System
                  • Historical Reporting Database Data Purging Operation Failed
                  • Node2 CTI Ports Removal Failed
                  • CTI Ports Removal Failed
                  • Data Migration Process cannot be Completed
                  • Agent Desktop Configuration Backup Process Failed
                  • Restore Process Failed Because of Missing JTAPI User in the Unified CM End User Table
                  • User Unable to Log in to Unified CCX 70(1) Application Administration after Successful Data Migration
                  • Unified CCX 70(1) IP AddressHostname Changed during Upgrade and Data Migration
                    • Best Practices
                    • Obtain Additional Support and Documentation