Guest

Cisco Unified Communications Manager (CallManager)

Data Migration Assistant User Guide Release 5.1(1)

  • Viewing Options

  • PDF (339.3 KB)
  • Feedback
Data Migration Assistant User Guide Release 5.1(1)

Table Of Contents

Data Migration Assistant User Guide
Release 5.1(1)

Overview of DMA

Obtaining DMA

Installing DMA

Preinstallation Guidelines and Procedures

DMA Installation Procedure

Removing DMA

Uninstalling DMA

Removing Informix Dynamic Server

Uninstalling Informix Client SDK

Before You Begin

Migrating CAR Data

Migrating Cisco Unified CallManager Attendant Console Data

Migrating Existing CAPF 1.0(1) Data

Copying CAPF 1.0(1) Data from a 4.0 Subscriber Server to the 4.0 Publisher Database Server

Generating a New CAPF Certificate

Ensuring DMA Compatibility with Cisco Security Agent for Unified CallManager

Running DMA

Validating Backup Data

DMA Backup Information File

Administering and Troubleshooting DMA

Determining DMA Software Version

Reviewing the Results of the last DMA Backup Procedure

Log Files

Common Errors

Trace Files

Obtaining Documentation

Cisco.com

Product Documentation DVD

Ordering Documentation

Documentation Feedback

Cisco Product Security Overview

Reporting Security Problems in Cisco Products

Product Alerts and Field Notices

Obtaining Technical Assistance

Cisco Technical Support & Documentation Website

Submitting a Service Request

Definitions of Service Request Severity

Obtaining Additional Publications and Information


Data Migration Assistant User Guide
Release 5.1(1)


This document describes the Data Migration Assistant (DMA), explains how to install and use it, and provides related information.

Use this document if you are running Cisco Unified CallManager versions 4.0(x) or 4.1(x) and are ready to upgrade to Cisco Unified CallManager 5.1(1).

This document includes the following topics:

Overview of DMA

Obtaining DMA

Installing DMA

Removing DMA

Before You Begin

Migrating CAR Data

Migrating Cisco Unified CallManager Attendant Console Data

Migrating Existing CAPF 1.0(1) Data

Copying CAPF 1.0(1) Data from a 4.0 Subscriber Server to the 4.0 Publisher Database Server

Generating a New CAPF Certificate

Running DMA

DMA Backup Information File

Administering and Troubleshooting DMA

Obtaining Documentation

Documentation Feedback

Obtaining Technical Assistance

Obtaining Additional Publications and Information

Overview of DMA

DMA migrates data for Cisco Unified CallManager and Cisco Emergency Responder, as specified in the following sections.

DMA assists you with the first step in migrating Cisco Unified CallManager data from versions 4.0(x) and 4.1(x) to Cisco Unified CallManager 5.1(1) by backing up this data in a format that Cisco Unified CallManager 5.1(1) can read. Cisco Unified CallManager 4.1(x) runs in a Windows environment, and Cisco Unified CallManager 5.1(1) runs in a Linux environment, so DMA exports Windows-based data to a format that Linux can import. The Cisco Unified CallManager 5.1(1) installation process converts the backed up data as needed for Cisco Unified CallManager 5.1(1), which completes the data migration.

DMA saves the data that it exports in a tape archive (TAR) file in a location that you specify.

You must install and run DMA on the Cisco Unified CallManager publisher server before you upgrade to Cisco Unified CallManager 5.1(1). If you make any Cisco Unified CallManager configuration changes after running DMA, the system does not retain these changes when you upgrade.

In addition to exporting Cisco Unified CallManager data, DMA exports data for these related applications:

Cisco Unified CallManager Attendant Console (AC)

Cisco Extension Mobility (EM)

CDR Analysis and Reporting (CAR)

Certificate Authority Proxy Function (CAPF)

Certificate Trust List (CTL)

International Dial Plan (IDP)

DMA does not export this information:

Custom Music on Hold (MOH) files—You must reapply these files after you upgrade to Cisco Unified CallManager 5.1(1).

TFTP phone load files—You must reapply these files after you upgrade to Cisco Unified CallManager 5.1(1).

Files on Cisco Unified CallManager subscriber servers—Subscriber servers obtain required information from the publisher server as part of the Cisco Unified CallManager upgrade process.

DMA also exports data for upgrading Cisco Emergency Responder 1.3. For more information, refer to Cisco Emergency Responder Administration Guide.

Obtaining DMA

If you do not have DMA software on a disk, perform the following steps to download it to the Cisco Unified CallManager publisher server. Only a registered user of Cisco.com can download this software.

Procedure


Step 1 Go to this URL:

http://cco/cgi-bin/tablebuild.pl/cmva-3des

Step 2 Select DMA file.

Step 3 Follow the prompts and provide the required information to download the software.


Installing DMA

This section provides detailed installation information and instructions for DMA. It includes the following topics:

Preinstallation Guidelines and Procedures—Review this information before you install DMA.

DMA Installation Procedure—Follow these steps to install DMA.

Preinstallation Guidelines and Procedures

Review the following guidelines and perform the appropriate procedures before you install DMA:

Ensure that one of the supported products is installed on the server before you install DMA on that server:

Cisco Unified CallManager 4.1(x) is installed and configured as the publisher.

Cisco Emergency Responder 1.3.


Note DMA installation wizard checks for the presence of a supported product. You cannot install DMA unless a supported product has been previously installed on the server.


Do not use Terminal Services to install DMA.

You can use Virtual Network Computing (VNC) to install DMA. For more information about VNC, refer to the latest version of Using Virtual Network Computing, which is available at this URL:

http://www.cisco.com/univercd/cc/td/doc/product/voice/iptel_os/vnc/index.htm

DMA requires 4 GB of free disk space on the C:\ drive of the Cisco Unified CallManager 4.1(x) server.

Disable the Cisco Security Agent for Unified CallManager, if it is enabled.


Note In some cases, you may have to uninstall Cisco Security Agent for Unified CallManager before you can run DMA. If you have difficulties, contact Cisco support for more information.


Make sure to enable the CSA after you complete the installation.

For instructions on disabling and enabling the CSA, refer to Installing Cisco Security Agent for Unified CallManager, which is available at this URL:

http://www.cisco.com/univercd/cc/td/doc/product/voice/c_callmg/sec_vir/csa/index.htm

DMA Installation Procedure

To install DMA, perform the following steps.

This procedure should take about 20 minutes to complete.

Before you install DMA, make sure to review the information in the "Preinstallation Guidelines and Procedures" section.


Note If you have an earlier version of DMA installed, you must remove it before you can install another version. See the "Removing DMA" section for more information.


Procedure


Step 1 Log in to the server as the Windows Administrator.

Step 2 Take one of these actions:

If you have a DMA installation disk, insert the disk.

If you have downloaded DMA, go to the folder in which you saved DMA and double-click DataMigrationAssistant-5-0-4.exe.

The DMA Welcome window displays.

Step 3 In DMA Welcome window, click Next.

The License Window displays.

Step 4 Accept the license agreement and click Next. The Informix Password window displays.

Step 5 Enter a password for the Informix Database Server (IDS) in the Informix Password text box.

The password must contain 8-14 characters, including at least one of each of the following character types:

Upper case letter (A-Z)

Lower case letter (a-z)

Numeral (0-9)

Special character ({ } , . < > : ? / | \ ` ~ ! @ $ ^ & * ( ) _ - +)


Caution Do not change the Informix password after installing DMA. Changing the password will cause DMA backups to fail.

Step 6 Enter the password again in the Confirm Password text box.

The Ready to Install the Program window displays.

Step 7 In the Ready to Install window, click Install.

The installation begins. The Installing Data Migration Assistant window shows you the status as the installation proceeds.

After about 20 minutes, the InstallShield Wizard Completed window displays.

Step 8 In the InstallShield Wizard Completed window, click Finish.

You are prompted to restart the server.

Step 9 To restart the server, click Yes.

The server restarts, and DMA installation completes.


Removing DMA

You must remove DMA and the applications that are installed with it before installing another DMA version. See the following sections for instructions:

"Uninstalling DMA" task

"Removing Informix Dynamic Server" task

"Uninstalling Informix Client SDK" task

Uninstalling DMA

To uninstall DMA, follow these steps:

Procedure


Step 1 Choose Start > Settings > Control Panel > Add/Remove Programs.

Step 2 From the Add/Remove Programs Window, choose Cisco Data Migration Assistant.

Step 3 Click Remove.

Step 4 Reboot the system.


Removing Informix Dynamic Server

To remove Informix Dynamic Server (IDS), follow these steps:


Step 1 Uninstall the IDS application:

a. Choose Start > Settings > Control Panel > Add/Remove Programs.

b. From the Add/Remove Programs Window, choose IDS (Informix Dynamic Server).

c. Click Remove. The Uninstall Informix Dynamic Server dialog box displays.

d. Choose the uninstallation method Remove all database server files and all database information, then choose OK. The Delete User Account dialog box displays.

e. Choose Yes to delete the informix user account. You are asked whether to remove Informix Storage Manager (ISM) servers.

f. Choose Yes to remove Informix Storage Manager (ISM) servers. You are asked whether to remove SNMP extension agents.

g. Choose Yes to remove SNMP extension agents.

Step 2 Delete the following folders from the hard drive:

C:\informix

C:\ifmxdata

C:\ciscowebs\dma\bin\IIF

C:\tmp

C:\preferences

C:\DMAROOT

C:\Program Files\Cisco\Trace\DMA

C:\Program Files\Cisco\Trace\DBL\installdb*

C:\Program Files\Cisco\Trace\DBL\dbl_INSTALLDB*

Step 3 Reboot the system.


Uninstalling Informix Client SDK

To remove Informix Client SDK, follow these steps:


Step 1 Choose Start > Settings > Control Panel > Add/Remove Programs.

Step 2 From the Add/Remove Programs Window, choose IBM Informix Client-SDK.

Step 3 Click Remove. The Uninstall IBM Informix Client-SDK dialog box displays.

Step 4 Click Yes to remove the IBM Informix Client-SDK.

Step 5 Reboot the system.


Before You Begin

Before you start DMA, perform the procedures that are shown in Table 1.

Table 1 Procedures to Follow Before Running DMA 

Procedure
Reference

Use the Cisco Unified CallManager Backup and Restore Utility to back up your data. You can use the BARS backup to fall back to your current software version, if necessary.

Refer to the appropriate version of Cisco Unified CallManager Backup and Restore Utility Administration Guide and related documentation at this URL:

http://www.cisco.com/univercd/cc/td/doc/product/voice/backup/index.htm

Cisco recommends that you use the Cisco Unified CallManager Upgrade Utility to verify that your system is in a good state before the upgrade

Refer to the appropriate version of Using Cisco Unified CallManager Upgrade Utility at this URL:

http://www.cisco.com/univercd/cc/td/doc/product/voice/c_callmg/index.htm

To back up CAR data, ensure the CAR plug-in is installed on the publisher server

See the "Migrating CAR Data" section.

If you use Cisco Unified CallManager Attendant Console, ensure the required files exist on the publisher server.

See the "Migrating Cisco Unified CallManager Attendant Console Data" section.

Copy CAPF data from the subscriber servers to the publisher server.

See the "Migrating Existing CAPF 1.0(1) Data" section.

Ensure that DMA will work correctly if Cisco Security Agent for Unified CallManager is installed on the server.

See the "Ensuring DMA Compatibility with Cisco Security Agent for Unified CallManager" section.

If you are running DMA on a Cisco Emergency Responder system, create the following file and move all subscriber data to be backed up into it: C:\Program Files\Cisco Systems\CiscoER\Subscriber_backup

For more information, refer to the appropriate version of Cisco Emergency Responder Administration Guide.


Migrating CAR Data

Before you can back up Cisco CDR Analysis and Reporting (CAR) data, you must ensure that the CAR plug-in is installed on the publisher server. If the CAR plug-in is not installed, navigate to Application>Install Plugins and install the CAR plug-in. For more information, see the Cisco Unified CallManager Administration Guide or the Cisco Unified CallManager Serviceability Administration Guide.


Note If you do not need to carry over your CDR records to Cisco Unified CallManager 5.1(1), Cisco recommends that you purge the CDR records before you run DMA.


Migrating Cisco Unified CallManager Attendant Console Data

If you use Cisco Unified CallManager Attendant Console, make sure that the following files exist on the publisher server before you run DMA. If the files do not exist on the publisher server, copy them to the publisher server from the subscriber server before you run DMA.

C:\Program Files\Cisco\CallManagerAttendant\etc\acserver.properties

C:\Program Files\Cisco\CallManagerAttendant\etc\DialRules.xml

Migrating Existing CAPF 1.0(1) Data


Caution Failing to perform the tasks that are described in this section may cause a loss of CAPF data. Use the following information in conjunction with the "Copying CAPF 1.0(1) Data from a 4.0 Subscriber Server to the 4.0 Publisher Database Server" section.

For information on using CAPF with Cisco Unified CallManager 5.1(1), refer to the Cisco Unified CallManager Security Guide.

Review the following details before you upgrade to Cisco Unified CallManager 5.1(1):

Upgrades from Cisco Unified CallManager 4.0 where CAPF was installed on the Cisco Unified CallManager 4.0 publisher database server—If you performed certificate operations with Cisco Unified CallManager 4.0 and CAPF 1.0(1) ran on the publisher database server, the latest operation status migrates to the Cisco Unified CallManager 4.1 database.

Upgrades from Cisco Unified CallManager where CAPF was installed on a Cisco Unified CallManager 4.0 subscriber server—If you performed certificate operations with Cisco Unified CallManager 4.0 and CAPF 1.0(1) ran on a subscriber server, you must copy the CAPF data to the 4.0 publisher database server before you upgrade to Cisco Unified CallManager 5.1(1).


Caution If you fail to copy the data prior to the Cisco Unified CallManager 5.1(1) upgrade, the CAPF data on the Cisco Unified CallManager 4.x subscriber server does not migrate to the Cisco Unified CallManager 5.1(1) database, and a loss of data may occur. If a loss of data occurs, the locally significant certificates that you issued with CAPF utility 1.0(1) remain in the phones, but CAPF 5.1(1) must reissue the certificates, which are no longer valid.

Upgrades from one release of Cisco Unified CallManager 4.1(x) to Cisco Unified CallManager 5.1(1)—The upgrade automatically migrates the CAPF data.

Copying CAPF 1.0(1) Data from a 4.0 Subscriber Server to the 4.0 Publisher Database Server


Caution If you installed CAPF utility 1.0(1) on a Cisco Unified CallManager 4.0 subscriber server, you must copy the CAPF data to the 4.0 publisher database server before you upgrade to Cisco Unified CallManager 5.1(1). Failing to perform this task causes a loss of CAPF data; for example, you may lose the phone record files in C:\Program Files\Cisco\CAPF\CAPF.phone. If a loss of data occurs, the locally significant certificates that you issued with CAPF utility 1.0(1) remain in the phones, but CAPF 5.1(1) must reissue the certificates because the certificates are not valid.

Use the following procedure in conjunction with the "Migrating Existing CAPF 1.0(1) Data" section. To copy the files, perform the following procedure:

Procedure


Step 1 Copy the files in Table 2 from the machine where CAPF 1.0 is installed to the publisher database server where Cisco Unified CallManager 4.0 is installed:

Table 2 Copy from Server to Server

Files to Copy
From Machine Where CAPF 1.0 Is Installed
To Publisher Database Server Where Cisco Unified CallManager 4.0 Is Installed

*.0

in C:\Program Files\Cisco\CAPF

to C:\Program Files\Cisco\Certificates

CAPF.phone

in C:\Program Files\Cisco\CAPF

to C:\Program Files\Cisco\CAPF

CAPF.config files

in C:\Program Files\Cisco\CAPF

to C:\Program Files\Cisco\CAPF


Step 2 Upgrade every server in the cluster to Cisco Unified CallManager 5.1(1).

Step 3 After you upgrade the cluster to Cisco Unified CallManager 5.1(1), perform the following tasks before you use the phones:

a. Delete the existing Cisco CTL client.

b. Install the latest Cisco CTL client by choosing Application->Plugins in Cisco Unified CallManager Administration.

c. Configure the client to create or update the CTL file.


Tip For information on installing and configuring the Cisco CTL client, refer to the Cisco Unified CallManager Security Guide.


The Cisco CTL client copies the CAPF certificate to all the servers in the cluster.

Step 4 Uninstall the CAPF utility that you used with Cisco Unified CallManager 4.0.

Step 5 See the "Generating a New CAPF Certificate" section.

Generating a New CAPF Certificate

If you need to regenerate the CAPF certificate, use the Cisco Unified CallManager Certificate Management features. For instructions and more information, refer to the Cisco Unified Communications Operating System Administration Guide.

Ensuring DMA Compatibility with Cisco Security Agent for Unified CallManager

Cisco Security Agent for Unified CallManager will cause DMA backup to fail in some cases. In some of these cases, DMA automatically disables Cisco Security Agent for Unified CallManager during the backup. In other cases, you must manually disable the Cisco Security Agent for Unified CallManager service prior to running the DMA backup, or the backup will fail.

For instructions on disabling and enabling the CSA, refer to Installing Cisco Security Agent for Unified CallManager, which is available at this URL:

http://www.cisco.com/univercd/cc/td/doc/product/voice/c_callmg/sec_vir/csa/index.htm

If you manually disable Cisco Security Agent for Unified CallManager, remember to enable it after the DMA backup finishes.


Note In some cases, you may have to uninstall Cisco Security Agent for Unified CallManager before you can run DMA. If you have difficulties, contact Cisco support for more information.


The following rules apply to the interaction between DMA and Cisco Security Agent for Unified CallManager:

For DMA versions 5.0(4) and lower:

Cisco Security Agent for Unified CallManager versions lower than 2.0(5) are automatically disabled during DMA backup.

Cisco Security Agent for Unified CallManager versions 2.0(5) and higher are not automatically disabled. You must manually disable Cisco Security Agent for Unified CallManager prior to DMA backup.

For DMA versions 5.1(1) and higher:

Cisco Security Agent for Unified CallManager versions 3.0(2) and higher can remain enabled during DMA backup.

Cisco Security Agent for Unified CallManager versions lower than 3.0(2) cannot remain enabled during DMA backup, and are not automatically disabled. You must manually disable Cisco Security Agent for Unified CallManager prior to DMA backup.

Running DMA

To run DMA on a Cisco Unified CallManager publisher server, perform the following steps.

Before you start DMA, make sure to review the information in the "Before You Begin" section.

Procedure


Step 1 Choose Start > Programs > Cisco DMA > DMAAdmin.

Step 2 When prompted, log in as the Windows Administrator.

The Data Migration Assistant Home window displays.

Step 3 From the Data Migration Assistant menu bar, choose Backup > Storage Location.

The Backup Storage Location window displays.

Step 4 In the Backup Storage Location window

a. Choose the destination where DMA stores the TAR file by clicking one of the following radio buttons:

Network Directory—Stores the TAR file in a network folder. Enter information in these fields:

Path Name—Network path to the appropriate folder

User Name—Username for network access

Password—Password for network access

Local Directory—Stores the TAR file in a folder on the server on which you are running DMA. In the Path Name field, enter the path to the folder or click Browse to choose a folder.


Note Do not specify a mapped network directory for the Local Directory. If you do, DMA may not be able to create the destination folder.


Tape Device—Stores the TAR file to a backup device. Choose an available tape device from the pulldown menu.

DMA allows you to save two TAR files in each destination directory. If you try to save a third TAR file, the older of the existing TAR files gets deleted, after the new TAR file is successfully created.

b. Click Update.

c. If you chose Local Directory as the backup storage location, click OK when you see this prompt:

Please ensure that you transfer the contents from the LOCAL path to an external device before upgrading. The files will not be readable from the local directory during the upgrade installation

Step 5 From the Data Migration Assistant menu bar, choose Backup > Backup Now.

The Migrate Data Source Server window displays. An estimate of the time required to perform the backup displays.

Step 6 In the Migrate Data Source Server window, click Start Backup Now.

The backup begins.

A status window shows you the status of the backup as it proceeds. The status window includes an estimate of the time that is required to complete the backup, both at the start of the backup and at the start of the validation phase. If you close the status window, you can display it again by clicking the View Latest Status link in the Migrate Data Source Server window.

The backup process can take a long time to complete. You can stop this process at any time by choosing Start > Programs > Cisco DMA > Cancel Backup and then clicking Cancel Backup Now in the Cancel Backup Process dialog box. The system could require several minutes to cancel the backup process.


Note If you close the DMA window while a backup process is running, the backup continues; however, when you restart DMA, the main window will display the Reset Status button. Clicking the Reset Status button cancels the backup process that is currently running.


When the backup completes, the status window displays the following lines:

Archive built successfully
Backup information file DMABackupinfo.inf saved to D:\DMA

Note DMA might make some minor modifications to your data to ensure that it can be successfully migrated.


Step 7 If you saved the TAR file in a local directory in Step 4, copy that file to a network server or to a tape device before you upgrade.

The following format shows how the TAR file is named, where date and time indicate when the file was created:

DMABackupdate#time.tar

You must perform this step because a TAR file on the local disk will not be accessible during the upgrade process, and the file will be deleted when the upgrade process reformats the local server disks.


Validating Backup Data

After performing a DMA backup, you can validate the data by examining the log file C:\CiscoWebs\DMA\bin\datavalidation.log. This log validates the data to ensure that it complies with your business rules.

If you find errors in this log, you can still use the DMA backup to upgrade your system. However, the faulty data will still be faulty on the upgraded system, and you will need to correct it before using it. To avoid restoring the faulty data to the upgraded system, you can correct the data using Microsoft SQL, then run DMA backup again.

You can view a log of the backup progress in the file C:\Program Files\Cisco\Trace\DMA\Progress\AllProgress.log. Additional log files are also located in that folder. For more information, see the "Log Files" section.

DMA Backup Information File

DMA automatically creates a backup information file when it backs up data. This file contains configuration and environment data regarding the DMA software, the server on which you ran DMA, and the software for which you backed up data.

The system saves the backup information file, which is named DMABackupInfo.inf, in the D:\DMA folder on the server on which you run DMA. The file also gets saved as part of the TAR file, so you do not need to do anything with this file.

Administering and Troubleshooting DMA

The following sections provide information that you can use to administer and troubleshoot DMA:

Determining DMA Software Version

Reviewing the Results of the last DMA Backup Procedure

Log Files

Trace Files

Determining DMA Software Version

To determine the version of DMA that is installed on a server, follow these steps:

Procedure


Step 1 Take one of these actions to display the Data Migration Assistant window, if it does not display already:

If DMA is running, choose Backup > Home from DMA menu bar.

If DMA is not running, choose Start > Programs > Cisco DMA > DMAAdmin and log in as the Windows Administrator when prompted.

Step 2 In the Data Migration Assistant window, click the Details button.


Reviewing the Results of the last DMA Backup Procedure

To see the results of the last backup procedure that you performed with DMA, follow these steps:

Procedure


Step 1 Choose Start > Programs > Cisco DMA > DMAAdmin.

Step 2 When prompted, log in as the Windows Administrator.

Step 3 From the Data Migration Assistant menu bar, choose Backup > Backup Now.

Step 4 In the Migrate Data Source Server window, click the View Latest Status link.

If you click the View Latest Status link during a backup procedure, the status of the current procedure displays.


Log Files

Table 3 describes the log files that DMA creates. If necessary, you can provide log files to the Cisco Technical Assistance Center (TAC) for assistance with troubleshooting.

Table 3 DMA Log Files 

File Type
Description
File Location
File Name

Installation log files

Created each time that you perform the DMA installation procedure.

C:\Program Files\ Common Files\Cisco\Logs

DMAInstalldate_ time.log, where date_ time specifies the date and time that the file was created

DMAInstallUI.log

IDSInstall.log

Backup operation log file

Created each day that you run DMA to back up data. If you run the backup procedure more than once on the same day, DMA appends information to the existing file for that day.

C:\Program Files\ Common Files\Cisco\Logs\ DMA\BACKUP

Backupdate.log, where date specifies the date that the file was created

This log also displays when you click the View Latest Status link.

Database export operation log file

Created the first time that you run DMA to back up data. Each subsequent time that you run the backup procedure, DMA appends information to this file.

C:\CiscoWebs\DMA\Bin

exportdb.log

These additional database export logs are located in this folder:

createdb.log

dropdb.log

dropdb_w.log

Directory export operation error log file

Created each time that you run DMA to back up data. If the file exists, DMA overwrites it.

C:\CiscoWebs\DMA\ DirExport\logs

DirExport_Error.log

Directory export operation report file

Created the first time that you run DMA to back up data. Each subsequent time that you run the backup procedure, DMA appends information to this file.

C:\CiscoWebs\DMA\ DirExport\logs

DirExport_Reprt.txt

Directory export operation results file

Created each time that you run DMA to back up data. If the file exists, DMA overwrites it.

C:\CiscoWebs\DMA\ DirExport\logs

DirExport_Result.txt

Data validation log

Contains any validation errors that are found during the verification of database and directory data during the backup process

C:\CiscoWebs\DMA\Bin

datavalidation.log

Backup progress indicator logs

Created when you run DMA. Contains a high-level log of backup and data validation progress.

C:\Program Files\Cisco\Trace\DMA\Progress

AllProgress.log

If there are errors in the backup progress, the following log files are created in the same folder:

CSV_Import*.*

ExportDB_CCM*.*

ExportToCSVs*.*

InstallDB_Full*.*

Informix Dynamic Server (IDS) installation log

Created during DMA installation. Contains a log of the IDS installation.

C:\Program Files\Common Files\Cisco\Logs

IDSInstall.log


Common Errors

DMA can return the errors that are described in Table 4, which can cause it to fail.

Table 4 DMA Errors Messages and Descriptions 

Error Message
Description

Failure- Product check; Database contains models that are no longer supported in this release.

AT, AS, and ICS gateways are not supported. Please remove unsupported models and repeat export.

This error displays if any of the following items are present in the device table:

Cisco AT-2 Gateway PRODUCT_AT2_GATEWAY

Cisco AT-4 Gateway PRODUCT_AT4_GATEWAY

Cisco AT-8 Gateway PRODUCT_AT8_GATEWAY

Cisco AS-2 Gateway PRODUCT_AS2_GATEWAY

Cisco AS-4 Gateway PRODUCT_AS4_GATEWAY

Cisco AS-8 Gateway PRODUCT_AS8_GATEWAY

All ICS platforms

Failure, Pre-SD CCM Migration

This error indicates that a problem occurred during the migration from Cisco CallManager 3.x to Cisco Unified CallManager 4.1.

Failure - Sony devices exist in the database, but there is no corresponding csv file.

Please reinstall the Sony installation.

This error indicates that the system cannot find a CSV file for a Sony phone. Before you can continue with the migration, you must reinstall the device.

Failure - Tandberg devices exist in the database, but there is no corresponding csv file.

Please reinstall the Tandberg installation.

This error indicates that the system cannot find a CSV file for a Tandberg phone. Before you can continue with the migration, you must reinstall the device.

Failure- Invalid enum 31970 in Zimbabwe Locale csv file.

Zimbabwe network locale needs to be replaced with a newer version before upgrade.

The error indicates that you have an invalid version of the Zimbabwe locale file. Before you can continue with the migration, you must download a new copy of the Zimbabwe locale file from Cisco.com and install it on your system.

Failure- Zimbabwe network locale needs to be replaced with a newer version before upgrade.

The error indicates that you have an invalid version of the Zimbabwe locale file. Before you can continue with the migration, you must download a new copy of the Zimbabwe locale file from Cisco.com and install it on your system.

Failure- Tandberg.xml file is invalid and needs to be replaced before upgrade.

Please reinstall Tandberg with a newer installation.

The error indicates that you have an invalid version of the Tandberg.xml file. Before you can continue with the migration, you must download a new copy of the Tandberg.xml file from Cisco.com and install it on your system.


Trace Files

Table 5 describes the trace files that DMA creates. If necessary, you can provide trace files to the Cisco Technical Assistance Center (TAC) for assistance with troubleshooting.

Table 5 DMA Trace Files 

File Type
Description
File Location
File Name

DMA operation trace file

Created each day that you run DMA to back up data. If you run the backup procedure more than once on the same day, DMA appends information to the existing file for that day

C:\Program Files\ Cisco\Trace\DMA

Tracedate.log, where date specifies the date that the file was created or updated.

Database export operation trace file

DMA creates one file each time that it backs up Cisco Unified CallManager data and one file each time that it backs up CAR data.

C:\Program Files\ Cisco\Trace\DBL

Export: installdbccm.log

W1install: installdbw1.log

Directory export operation trace file

Created the first time that you run DMA to back up data. Each subsequent time that you run the backup procedure, DMA appends information to this file.

C:\CiscoWebs\DMA\ DirExport\logs

DirExport_Trace.log

Database install setup trace file

Displays the Informix setup status

C:\CiscoWebs\DMA\Bin

dbcmds.log


Obtaining Documentation

Cisco documentation and additional literature are available on Cisco.com. This section explains the product documentation resources that Cisco offers.

Cisco.com

You can access the most current Cisco documentation at this URL:

http://www.cisco.com/techsupport

You can access the Cisco website at this URL:

http://www.cisco.com

You can access international Cisco websites at this URL:

http://www.cisco.com/public/countries_languages.shtml

Product Documentation DVD

The Product Documentation DVD is a library of technical product documentation on a portable medium. The DVD enables you to access installation, configuration, and command guides for Cisco hardware and software products. With the DVD, you have access to the HTML documentation and some of the PDF files found on the Cisco website at this URL:

http://www.cisco.com/univercd/home/home.htm

The Product Documentation DVD is created and released regularly. DVDs are available singly or by subscription. Registered Cisco.com users can order a Product Documentation DVD (product number DOC-DOCDVD= or DOC-DOCDVD=SUB) from Cisco Marketplace at the Product Documentation Store at this URL:

http://www.cisco.com/go/marketplace/docstore

Ordering Documentation

You must be a registered Cisco.com user to access Cisco Marketplace. Registered users may order Cisco documentation at the Product Documentation Store at this URL:

http://www.cisco.com/go/marketplace/docstore

If you do not have a user ID or password, you can register at this URL:

http://tools.cisco.com/RPF/register/register.do

Documentation Feedback

You can provide feedback about Cisco technical documentation on the Cisco Technical Support & Documentation site area by entering your comments in the feedback form available in every online document.

Cisco Product Security Overview

Cisco provides a free online Security Vulnerability Policy portal at this URL:

http://www.cisco.com/en/US/products/products_security_vulnerability_policy.html

From this site, you will find information about how to do the following:

Report security vulnerabilities in Cisco products

Obtain assistance with security incidents that involve Cisco products

Register to receive security information from Cisco

A current list of security advisories, security notices, and security responses for Cisco products is available at this URL:

http://www.cisco.com/go/psirt

To see security advisories, security notices, and security responses as they are updated in real time, you can subscribe to the Product Security Incident Response Team Really Simple Syndication (PSIRT RSS) feed. Information about how to subscribe to the PSIRT RSS feed is found at this URL:

http://www.cisco.com/en/US/products/products_psirt_rss_feed.html

Reporting Security Problems in Cisco Products

Cisco is committed to delivering secure products. We test our products internally before we release them, and we strive to correct all vulnerabilities quickly. If you think that you have identified a vulnerability in a Cisco product, contact PSIRT:

For emergencies only — security-alert@cisco.com

An emergency is either a condition in which a system is under active attack or a condition for which a severe and urgent security vulnerability should be reported. All other conditions are considered nonemergencies.

For nonemergencies — psirt@cisco.com

In an emergency, you can also reach PSIRT by telephone:

1 877 228-7302

1 408 525-6532


Tip We encourage you to use Pretty Good Privacy (PGP) or a compatible product (for example, GnuPG) to encrypt any sensitive information that you send to Cisco. PSIRT can work with information that has been encrypted with PGP versions 2.x through 9.x.

Never use a revoked encryption key or an expired encryption key. The correct public key to use in your correspondence with PSIRT is the one linked in the Contact Summary section of the Security Vulnerability Policy page at this URL:

http://www.cisco.com/en/US/products/products_security_vulnerability_policy.html

The link on this page has the current PGP key ID in use.

If you do not have or use PGP, contact PSIRT to find other means of encrypting the data before sending any sensitive material.


Product Alerts and Field Notices

Modifications to or updates about Cisco products are announced in Cisco Product Alerts and Cisco Field Notices. You can receive Cisco Product Alerts and Cisco Field Notices by using the Product Alert Tool on Cisco.com. This tool enables you to create a profile and choose those products for which you want to receive information.

To access the Product Alert Tool, you must be a registered Cisco.com user. (To register as a Cisco.com user, go to this URL: http://tools.cisco.com/RPF/register/register.do) Registered users can access the tool at this URL: http://tools.cisco.com/Support/PAT/do/ViewMyProfiles.do?local=en

Obtaining Technical Assistance

Cisco Technical Support provides 24-hour-a-day award-winning technical assistance. The Cisco Technical Support & Documentation website on Cisco.com features extensive online support resources. In addition, if you have a valid Cisco service contract, Cisco Technical Assistance Center (TAC) engineers provide telephone support. If you do not have a valid Cisco service contract, contact your reseller.

Cisco Technical Support & Documentation Website

The Cisco Technical Support & Documentation website provides online documents and tools for troubleshooting and resolving technical issues with Cisco products and technologies. The website is available 24 hours a day at this URL:

http://www.cisco.com/techsupport

Access to all tools on the Cisco Technical Support & Documentation website requires a Cisco.com user ID and password. If you have a valid service contract but do not have a user ID or password, you can register at this URL:

http://tools.cisco.com/RPF/register/register.do


Note Use the Cisco Product Identification Tool to locate your product serial number before submitting a request for service online or by phone. You can access this tool from the Cisco Technical Support & Documentation website by clicking the Tools & Resources link, clicking the All Tools (A-Z) tab, and then choosing Cisco Product Identification Tool from the alphabetical list. This tool offers three search options: by product ID or model name; by tree view; or, for certain products, by copying and pasting show command output. Search results show an illustration of your product with the serial number label location highlighted. Locate the serial number label on your product and record the information before placing a service call.



Tip Displaying and Searching on Cisco.com

If you suspect that the browser is not refreshing a web page, force the browser to update the web page by holding down the Ctrl key while pressing F5.

To find technical information, narrow your search to look in technical documentation, not the entire Cisco.com website. On the Cisco.com home page, click the Advanced Search link under the Search box and then click the Technical Support & Documentation radio button.

To provide feedback about the Cisco.com website or a particular technical document, click Contacts & Feedback at the top of any Cisco.com web page.


Submitting a Service Request

Using the online TAC Service Request Tool is the fastest way to open S3 and S4 service requests. (S3 and S4 service requests are those in which your network is minimally impaired or for which you require product information.) After you describe your situation, the TAC Service Request Tool provides recommended solutions. If your issue is not resolved using the recommended resources, your service request is assigned to a Cisco engineer. The TAC Service Request Tool is located at this URL:

http://www.cisco.com/techsupport/servicerequest

For S1 or S2 service requests, or if you do not have Internet access, contact the Cisco TAC by telephone. (S1 or S2 service requests are those in which your production network is down or severely degraded.) Cisco engineers are assigned immediately to S1 and S2 service requests to help keep your business operations running smoothly.

To open a service request by telephone, use one of the following numbers:

Asia-Pacific: +61 2 8446 7411
Australia: 1 800 805 227
EMEA: +32 2 704 55 55
USA: 1 800 553 2447

For a complete list of Cisco TAC contacts, go to this URL:

http://www.cisco.com/techsupport/contacts

Definitions of Service Request Severity

To ensure that all service requests are reported in a standard format, Cisco has established severity definitions.

Severity 1 (S1)—An existing network is "down" or there is a critical impact to your business operations. You and Cisco will commit all necessary resources around the clock to resolve the situation.

Severity 2 (S2)—Operation of an existing network is severely degraded, or significant aspects of your business operations are negatively affected by inadequate performance of Cisco products. You and Cisco will commit full-time resources during normal business hours to resolve the situation.

Severity 3 (S3)—Operational performance of the network is impaired while most business operations remain functional. You and Cisco will commit resources during normal business hours to restore service to satisfactory levels.

Severity 4 (S4)—You require information or assistance with Cisco product capabilities, installation, or configuration. There is little or no effect on your business operations.

Obtaining Additional Publications and Information

Information about Cisco products, technologies, and network solutions is available from various online and printed sources.

The Cisco Online Subscription Center is the website where you can sign up for a variety of Cisco e-mail newsletters and other communications. Create a profile and then select the subscriptions that you would like to receive. To visit the Cisco Online Subscription Center, go to this URL:

http://www.cisco.com/offer/subscribe

The Cisco Product Quick Reference Guide is a handy, compact reference tool that includes brief product overviews, key features, sample part numbers, and abbreviated technical specifications for many Cisco products that are sold through channel partners. It is updated twice a year and includes the latest Cisco channel product offerings. To order and find out more about the Cisco Product Quick Reference Guide, go to this URL:

http://www.cisco.com/go/guide

Cisco Marketplace provides a variety of Cisco books, reference guides, documentation, and logo merchandise. Visit Cisco Marketplace, the company store, at this URL:

http://www.cisco.com/go/marketplace/

Cisco Press publishes a wide range of general networking, training, and certification titles. Both new and experienced users will benefit from these publications. For current Cisco Press titles and other information, go to Cisco Press at this URL:

http://www.ciscopress.com

Internet Protocol Journal is a quarterly journal published by Cisco Systems for engineering professionals involved in designing, developing, and operating public and private internets and intranets. You can access the Internet Protocol Journal at this URL:

http://www.cisco.com/ipj

Networking products offered by Cisco Systems, as well as customer support services, can be obtained at this URL:

http://www.cisco.com/en/US/products/index.html

Networking Professionals Connection is an interactive website where networking professionals share questions, suggestions, and information about networking products and technologies with Cisco experts and other networking professionals. Join a discussion at this URL:

http://www.cisco.com/discuss/networking

"What's New in Cisco Documentation" is an online publication that provides information about the latest documentation releases for Cisco products. Updated monthly, this online publication is organized by product category to direct you quickly to the documentation for your products. You can view the latest release of "What's New in Cisco Documentation" at this URL:

http://www.cisco.com/univercd/cc/td/doc/abtunicd/136957.htm

World-class networking training is available from Cisco. You can view current offerings at this URL:

http://www.cisco.com/en/US/learning/index.html