Guest

Cisco Unified Communications Manager (CallManager)

Release Notes for Data Migration Assistant Release 7.0(2)

  • Viewing Options

  • PDF (451.5 KB)
  • Feedback
Release Notes for Data Migration Assistant (DMA) Release 7.0(2)

Table Of Contents

Release Notes for Data Migration Assistant (DMA) Release 7.0(2)

Contents

Introduction

Important Notes

Upgrades That Are Supported

Run DMA Early

Cisco Security Agent (CSA)

Completion Status Recognition

Configuration File

Cisco Unified CM Target Version Checking

Unified CM Target Version Gets Saved in the DMABackupInfo.inf

Support For Mapped Network Drive

Exporting RTMT Reports

Exporting Quality Reporting Tool (QRT) Reports

DMA Uninstall

Proper Return Code Sent To the DMA Framework

Unified CM Database, CAR, CER Components

Linux Install

What Gets Migrated via DMA When Unified CM Gets Integrated Into a Corporate LDAP Store

Caveats

Caveats Resolved in DMA Release 7.0(2)

Use BugToolkit to Find the Latest Resolved Caveat Information

UsingBug Toolkit

Open Caveats

Obtaining Documentation and Submitting a Service Request


Release Notes for Data Migration Assistant (DMA) Release 7.0(2)


February 9, 2009

This document comprises the new features that are included and caveats that are resolved in Data Migration Assistant (DMA) Release7.0(2).

Contents

These release notes discuss the following topics:

Introduction

Important Notes

Caveats

Caveats Resolved in DMA Release 7.0(2)

Use BugToolkit to Find the Latest Resolved Caveat Information

Open Caveats

Obtaining Documentation and Submitting a Service Request

Introduction

Data Migration Assistant (DMA) Release 7.0(x) collects application data from a Cisco Unified Communications Manager Releases 4.1(x), 4.2(x) and 4.3(x) system for upgrade to Cisco Unified CM Release 7.0(x). DMA exports data in the current Windows based system (with SQL Server database) that later will get imported to the Linux based system (with Informix database).

DMA also collects application data from a Cisco Emergency Response (CER) 1.3 system for upgrade to CER 7.0.

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

In addition to creating an export, DMA also performs a set of migration compatibility tests (data validation) on the exported Unified CM 4.x data

If DMA discovers issues, either in the export itself, or in the data validation, DMA may report some type of "Failure." Do not consider such a message to be alarming.

Even when DMA completes successfully, but especially if any "Error" or "Warning" occurs, the user should examine the generated messages. These messages may be

Simply information about auto-data-correction that will be performed in the migration.

Alerts to let you know the problems that DMA encountered as it attempted to check the data.

Generally, these problems require user expertise to determine how best to alter the data to remove the migration incompatibility.


Note You must install and run DMA Release 7.0(x) on the Cisco Unified Communications Manager publisher server before you upgrade to Unfied CM 7.0(1). If you make any configuration changes to Cisco Unified Communications Manager after you run DMA, the system does not retain these changes when you upgrade.



Note Do not consider the DMA Export a substitute for a system backup. You cannot use it to restore your Cisco Unified Communications Manager system in the unlikely event that you are unable to complete your upgrade.


Important Notes

The following section contains important information to help you get started with Data Migration Assistant Release 7.0(x).

Upgrades That Are Supported

Run DMA Early

Cisco Security Agent (CSA)

Completion Status Recognition

Configuration File

Cisco Unified CM Target Version Checking

Unified CM Target Version Gets Saved in the DMABackupInfo.inf

Support For Mapped Network Drive

Exporting RTMT Reports

Exporting Quality Reporting Tool (QRT) Reports

DMA Uninstall

Proper Return Code Sent To the DMA Framework

Linux Install

What Gets Migrated via DMA When Unified CM Gets Integrated Into a Corporate LDAP Store

Upgrades That Are Supported

For information about supported upgrades, see the Cisco Unified Communications Manager Compatibility Matrix at the following URL:

http://www.cisco.com/en/US/products/sw/voicesw/ps556/products_device_support_tables_list.html

Run DMA Early


Note Be aware that it is important that you run DMA early - possibly as early as weeks before the actual upgrade window to allow time for you to fix any non compliant data.


A successful DMA run does not completely prepare you for migration and upgrade.

To understand critical tasks that must be completed, Cisco recommends that you read the "Before You Begin" section of the Data Migration Assistant User Guide Release 7.0(1a) before you use DMA to export data from the Windows system.

To understand critical upgrade tasks that must be completed, Cisco recommends that you refer to Upgrading to Cisco Unified Communications Manager Release 7.0(1) from Cisco Unified Communications Manager 4.x Releases.

These documents may be found at http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_installation_guides_list.html.

Cisco Security Agent (CSA)

Before the DMA export begins, check the system CSA version by right-clicking the red CSA flag in the systray and, from the options that display, click About.

If the CSA version equals

Less than 2.0(5), DMA stops CSA automatically during the export.

Less than 3.0(3) but greater than 2.0(5), you must manually disable CSA before you run DMA.

3.0(3) or higher, CSA can remain enabled while DMA runs.

Completion Status Recognition

DMA completion can reflect four possible outcomes:

Export Success & Validation Success


Note If your DMA run results in one of the following three outcomes, you must fix the inconsistencies and rerun DMA.


Export Success & Validation Success but with Warnings

Export Success & Validation Failure

Export Failure

You can access the DMA log files from the final status window. You can use them to see what needs to be fixed.

Configuration File

Data Migration Assistant 7.0(x) generates a configuration file (platformConfig.xml) that can assist you in performing an upgrade of the first node to Cisco Unified Communications Manager 7.0(1) from supported releases of Cisco Unified CallManager 4.x. During the upgrade, the configuration file prepopulates several fields, including domain name, IP address, primary DNS, secondary DNS, and NTP server.

platformConfig.xml extracts info from the CM 4.X servers to automate some steps during Linux installation on the publisher server.

platformConfig.xml gets stored in the same location as the DMA tarball if the storage location is on local or network drives.

platformConfig.xml gets stored in D:\DMA\ if the DMA tarball storage location is on the tape drive.

Customer must copy platformConfig.xml to a USB key and plug in this USB key on the publisher server during the Linux installation.

When this platformConfig.xml is used during W1 install, the "Apply a Patch" screen gets skipped

The Linux install screen populates input data that is extracted from the platformConfig.xml

To use the configuration file, copy the platformConfig.xml file to a USB key and place the USB key into the Cisco Unified Communications Manager first node before you boot the server with the Cisco Unified Communications Manager 7.0(1) DVD.

If you choose to store the DMA tar file on a network directory or local directory, DMA stores the platformConfig.xml in the same directory. If you choose to store the DMA tar file on a tape drive, DMA stores the platformConfig.xml in D:/DMA.


Note Cisco requires that you use USB keys that are compatible with Linux 2.4. Cisco recommends that you use USB keys that are preformatted to be compatible with Linux 2.4 for the configuration file. These keys have a W95 FAT32 format.


Installation/Upgrade (Migration) Considerations

To use the configuration file that Data Migration Assistant generates to prepopulate fields during an upgrade to Cisco Unified Communications Manager 7.0(1) from supported releases of Cisco Unified CallManager 4.x, copy the platformConfig.xml file to a USB key before you boot the server with the Cisco Unified Communications Manager 7.0(1) DVD.

Cisco Unified CM Target Version Checking

DMA generates DMABackupInfo.inf and includes this file in the tarball, as in the previous releases.

TargetCCMVersion = X.Y.Z (for example 7.0.1) indicates the Unified CM version with which this DMA tarball is compliant.

In Linux installation application, additional logic got added to verify that TargetCCMVersion matches the Unified CM version that you are installing.

TargetCCMVersion gets saved in the DMABackupInfo, inf file in the DMA tarball.

This provides a hook for the Linux installation application to verify whether the DMA tarball is generated by the proper DMA version.

Unified CM Target Version Gets Saved in the DMABackupInfo.inf

DMA export saves the target Unified CM version in the DMABackupInfo.inf file:

Sample in the DMABackupInfo.inf:

CCMVersion= 4.1.X
TargetCCMVersion = X.Y.Z

For example, for DMA 7.0(x), the target Unified CM upgrade version equals release 7.0(1). So, this field displays 7.0.1, which is the Unified CM version, not the DMA current version, in case the version numbers get out of sync in future releases.

This means that if a Cisco Unified CM 7.0(1) respin becomes a reality in the future, the logic will work, and the customer can use DMA 7.0(x)) to upgrade to the Unified CM Release 7.0.1 respin release.

Support For Mapped Network Drive

DMA can create the DMA tarball in a mapped network drive that is defined in the Storage Location Window.

Select Network Directory Option and provide the path (for example, M:\export), userID, and password.

The drive letter gets translated to Windows UNC frormat (for example, 10.89.75.11\c$\export)

CSCsl52704

The system renamed Network Directory to Windows Network Directory.

Exporting RTMT Reports

DMA exports RTMT Reports data files that reside in C:\CiscoWebs\Service\RTMTReports\. DMA stores the files in the \serv\rtmt directory of the DMA TAR file.

Exporting Quality Reporting Tool (QRT) Reports

DMA exports QRT files to the DMA TAR file that exist in the location that is specified in the Log File field in the Service Parameter Configuration window for the Cisco Extended Functions service. The specified log file path must reside on the C:\ drive. If the path does not exist on the C:\ drive, DMA does not export the QRT reports, so the administrator must export the reports manually.


Note If the Cisco Extended Function Service is running, the last (current) QRT file that is being used by this service cannot be exported. This is expected behavior, and is not an error.


DMA Uninstall

You can uninstall DMA by following these steps:


Step 1 From the Start menu, click Settings > Control Panel > Add/Remove Program.

Step 2 Locate Cisco Data Migration Assistant in the list of programs and click Remove.

This removes IDS, IDS Client SDK (if it exists), DSNs, and the DMA application

Step 3 When the removal completes, reboot the server as prompted.

You will see IDS uninstall prompts that will be auto-selected for you.

In the Add/Remove Programs list, the Informix Dynamic Server 10.00 and corresponding SDK Client specify no longer selectable.


Proper Return Code Sent To the DMA Framework

During DMA export and validation phases, the DMA framework launches separate processes to invoke the underlying component .exe files to export or validate the Unified CM database, directory, CAR, or CER data. When a fatal error exists in the data export or data validation, the logic returns failure to the DMA framework instead of continuing.

By using this information, the framework can determine whether fatal issues are encountered and whether DMA should be aborted.

Unified CM Database, CAR, CER Components

Exportdb.exe gets used to export and validate Unified CM, CAR, and CER databases. The return codes from the exportdb.exe follow:

0 - Indicates success, DMA framework continues

1 - Indicates warning, DMA framework continues but display proper warning messages on the status page

-1 - Indicates failure. DMA framework halts.

Linux Install

During an upgrade, the Linux install application determines whether a platformConfig.xml file exists in the customer USB key. If it exists, the data gets read and populates in the UI. Default values gets used for data that is not found in the platformConfig.xml.

What Gets Migrated via DMA When Unified CM Gets Integrated Into a Corporate LDAP Store

The DirExport is the part of DMA that extracts user data from the directory and creates CSV files of that data. The CSV files get used to populate the database. All the user information gets migrated from the directory to the database.

When you upgrade from Cisco Unified CM 4.x to Cisco Unified CM 5.x or later, the following get migrated.

EndUser

IPMAManagerAssistant

EndUserDeviceMap

DirGroup

EndUserDirGroupMap

Endusernumplanmap .CSV

PersonalAddressBook

PersonalPhoneBook

crsapplication

Caveats

This section contains information about the caveats that get resolved by this release of DMA and information about how to create your own list of resolved and open caveats.

Caveats Resolved in DMA Release 7.0(2)

Use BugToolkit to Find the Latest Resolved Caveat Information

Open Caveats

Caveats Resolved in DMA Release 7.0(2)

The release of DMA Release 7.0(2) resolves the following caveats.

CSCsq35564 IPPhonesRules results in a misleading error message in DMA backup.

CSCsq83929 Storage location window message should be made explicit

CSCsq94528 Cancelling DMA export : Message should be clear in status file.

CSCsv52001 DMA Export : Spelling mistake exists in Cancel Export Process message box.

CSCsv66362 DMA uninstall does not report MSI failures correctly.

CSCsw30146 DMA status page gets displayed without options for viewing the log file.

CSCsw30534 DMA export to tape drive - Message not proper.

CSCsw36871 Platformconfig.xml file does not get created.

CSCsw37022 DMARoot folder does not get removed after export occurs.

CSCsw37289 DMA export tar file gets created after cancellation of export.

CSCsw69192 If you manually remove the DMARoot folder, DMA hangs.

CSCsr06635 DMA Export - Proper error logs do not occur in a network outage scenario.

Use BugToolkit to Find the Latest Resolved Caveat Information

You can find the latest resolved caveat information for Data Migration Assistant by using Bug Toolkit, which is an online tool that is available for customers to query defects according to their own needs.


Tip You need an account with Cisco.com to use the Bug Toolkit to find open and resolved caveats of any severity for any release.

To access the Bug Toolkit, log on to http://www.cisco.com/cgi-bin/Support/Bugtool/launch_bugtool.pl.


UsingBug Toolkit

Known problems (bugs) get graded according to severity level. These release notes contain descriptions of

All severity level 1 or 2 bugs.

Significant severity level 3 bugs.

You can search for problems by using the Cisco Software Bug Toolkit.

To access Bug Toolkit, you need the following items:

Internet connection

Web browser

Cisco.com user ID and password

To use the Software Bug Toolkit, follow these steps:

Procedure


Step 1 Acccess the Bug Toolkit, http://tools.cisco.com/Support/BugToolKit/action.do?hdnAction=searchBugs.

Step 2 Log in with your Cisco.com user ID and password.

Step 3 If you are looking for information about a specific problem, enter the bug ID number in the "Search for Bug ID" field and click Go.



Tip Click Help on the Bug Toolkit window for information about how to search for bugs, create saved searches, create bug groups, and so on.


Open Caveats

No open caveats exist for DMA 7.0(2)

Understanding the Fixed-in Version and the Integrated-in Fields in the Online Defect Record

When you open the online record for a defect, you may see data in the "First Fixed-in Version" or "Integrated-in" fields. The information that displays in these fields identifies the list of Cisco Unified Communications Manager interim versions in which the defect was fixed. These interim versions then get integrated into Cisco Unified Communications Manager releases.

Some more clearly defined versions include identification for Engineering Specials (ES) or Service Releases (SR); for example 03.3(04)ES29 and 04.0(02a)SR1; however, the version information that displays for the Cisco Unified Communications Manager maintenance releases may not be as clearly identified.


Tip Bug Toolkit requires that you have an account with Cisco.com. By using the Bug Toolkit, you can find caveats of any severity for any release. Bug Toolkit may also provide a more current listing than this document provides. To access the Bug Toolkit, log on to http://tools.cisco.com/Support/BugToolKit/action.do?hdnAction=searchBugs.


Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

Subscribe to the What's New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS version 2.0.