Table Of Contents
Release Notes for Data Migration Assistant (DMA) Release 7.0(2)
Cisco Unified CM Target Version Checking
Unified CM Target Version Gets Saved in the DMABackupInfo.inf
Support For Mapped Network Drive
Exporting Quality Reporting Tool (QRT) Reports
Proper Return Code Sent To the DMA Framework
Unified CM Database, CAR, CER Components
What Gets Migrated via DMA When Unified CM Gets Integrated Into a Corporate LDAP Store
Caveats Resolved in DMA Release 7.0(2)
Use BugToolkit to Find the Latest Resolved Caveat Information
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:
–
Caveats Resolved in DMA Release 7.0(2)
–
•
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
•
•
–
–
Generally, these problems require user expertise to determine how best to alter the data to remove the migration incompatibility.
Note
Note
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
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.htmlRun DMA Early
Note
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
•
•
•
Completion Status Recognition
DMA completion can reflect four possible outcomes:
•
Note
•
•
•
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.
•
•
•
•
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
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.XTargetCCMVersion = X.Y.ZFor 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
DMA Uninstall
You can uninstall DMA by following these steps:
Step 1
Step 2
This removes IDS, IDS Client SDK (if it exists), DSNs, and the DMA application
Step 3
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:
•
•
•
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.
•
•
•
•
•
•
•
•
•
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)
The release of DMA Release 7.0(2) resolves the following caveats.
•
•
•
•
•
•
•
•
•
•
•
•
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
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
•
•
You can search for problems by using the Cisco Software Bug Toolkit.
To access Bug Toolkit, you need the following items:
•
•
•
To use the Software Bug Toolkit, follow these steps:
Procedure
Step 1
Step 2
Step 3
Tip
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
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.
CCDE, CCENT, Cisco Eos, Cisco Lumin, Cisco Nexus, Cisco StadiumVision, Cisco TelePresence, the Cisco logo, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn and Cisco Store 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, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, 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. and/or 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. (0807R)
Guest
