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

Post on 22-Sep-2020

0 Views

Category:

Documents

0 Downloads

Preview:

Click to see full reader

Transcript

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

    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

      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

        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

          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

            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

              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

                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

                  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

                    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

                      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

                        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

                          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

                            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

                              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

                                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

                                  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

                                    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

                                      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

                                        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

                                          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

                                            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

                                              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

                                                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

                                                  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

                                                    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

                                                      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

                                                        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

                                                          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

                                                            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

                                                              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

                                                                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

                                                                  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

                                                                    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

                                                                      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

                                                                        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

                                                                          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

                                                                            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

                                                                              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

                                                                                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

                                                                                  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

                                                                                    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

                                                                                      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

                                                                                        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

                                                                                          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

                                                                                            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

                                                                                              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

                                                                                                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

                                                                                                  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

                                                                                                    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

                                                                                                      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

                                                                                                        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

                                                                                                          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

                                                                                                            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

                                                                                                              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

                                                                                                                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

                                                                                                                  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

                                                                                                                    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

                                                                                                                      top related