Table Of Contents
Release Notes for Data Migration Assistant (DMA) Release 6.1(2)
Updated April 24, 2008
This document comprises the new features that are included and caveats that are resolved in Data Migration Assistant (DMA) Release 6.1(2).
These release notes discuss the following topics:
Data Migration Assistant (DMA) Release 6.1(2) collects application data from a Unified CM Releases 4.1(x) and 4.2(x) system for upgrade to Cisco Unified Communications Manager Release 6.1(2). The purpose of the DMA is to export data in the current Windows based system (with SQL Server database) that will be later imported to the Linux based system (with Informix database).
Data Migration Assistant Release 6.1(2) also collects application data from a Cisco Emergency Response (CER) 1.3 system for upgrade to CER 2.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, then DMA may report some type of "Failure." Do not consider such a message 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 6.1(2) on the Cisco Unified Communications Manager publisher server before you upgrade to Cisco Unified Communications Manager Release 6.1(2). 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.
New and Changed Information for Data Migration Assistant 6.1(2)
The following sections contain information that is new or changed for this release of Data Migration Assistant:
Enhancements for Data Migration Assistant
The Data Migration Assistant 6.1(2) generates a configuration file (platformConfig.xml) that can assist you in performing an upgrade of the first node to Cisco Unified Communications Manager 6.1(2) from supported releases of Cisco Unified CallManager 4.x. The configuration file prepopulates several fields during the upgrade, including domain name, IP address, primary DNS, secondary DNS, and NTP server.
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 6.1(2) 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 will have a W95 FAT32 format.
Installation/Upgrade (Migration) Considerations
To use the configuration file generated by Data Migration Assistant to prepopulate fields during and upgrade to Cisco Unified Communications Manager 6.1(2) 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 6.1(2) DVD.
Upgrades That Are Supported
DMA installation applications block any installation on Unified CM systems other than 4.1(3) and CUCM 4.2(3).
Linux installation application verifies the target versions to ensure the tarball version is compatible.
Note DMA 6.1(2) does not support upgrades from 5.1(2), 5.1(3), 6.0(1a) and 6.1(1).
Database Message Improvements
DMA Data Validation executes the same operations on customer data as will be performed in the actual upgrade. This enables DMA to catch problems that might cause the upgrade to fail. Be aware that catching these errors during data validation, while the Cisco Unified CallManager 4.x system is still available and operating, is very important.
Because you cannot anticipate and test for every variation of a data problem variations in advance, the mechanism used to catch these errors depends on the built-in error reporting in the general-purpose database tools that are used. Unfortunately, the error messages that result are not very specific. They do not specify the problem and solution in terms that are familiar to the user.
Enhancements in this release now provide additional commentaries that are relevant to Cisco Unified Communications Manager on a few of the most commonly seen error messages.
Examples of the Most Commonly Seen Error Messages
The -691 Referential Integrity ErrorThis record was not processed because another record it needs, (see reference name listed below), is missing. This likely may be due to a previous error already reported in the log above, or the result of Directory Services Export issues reported separately, or due to missing Product, Locale, or other add-on definition CSV files that should exist on the source system but do not.SUGGESTED ACTION: Resolve all prior reported issues. If none, look at the Suspected Field, if listed, for an indication of what data reference could not be resolved. Some hints:- if ...DirGroup related, check for a Directory Export failure- if ...Locale related, check for a missing Locale Plug-InRe-execute DMA when all other issues are addressed.
The -11005 IDS Connection Failure ErrorThis is a hard error probably related to a DMA installation problem. It is a general issue and NOT related to the record / request being processed. DMA was unable to perform migration testing due to this failure. This reflects an installation or system failure. Likely causes include:- improper prior uninstall of the DBMS in a DMA upgrade- a bad Informix password perhaps containing backslashes- a system or disk or space related issueSUGGESTED ACTION: Uninstall and re-install DMA carefully following all documented procedures.
The -271 IDS I/O Related ErrorThis is a transient error related to DMA/DB data access issues. It is a general issue. While possibly related to the record / request being processed, it does not indicate a problem with that record / request. DMA was unable to perform migration testing due to a failure accessing the data. This may have been due to resource constraints on the system or other activity.SUGGESTED ACTION: Re-boot the server and re-execute DMA.
The -391 Null Value ErrorThis record was not processed because it is missing a required value. This could also be caused by specifying the value NULL in a required field.SUGGESTED ACTION: Check the Suspected Field information and record contents, if provided, to determine which data needs to be filled in and for which record. Update that record to specify the required data and then re-execute DMA.
The -239 Duplicate Record ErrorThis record was not processed because another record exists with the same key value in a field, (or combination of fields), required to be unique. For example, CM 4.x permits multiple NumPlan entries with the same DNorPattern+RoutePartition value combination. Later CUCM versions enforce uniqueness in these combined values.SUGGESTED ACTION: Check the Suspected Field information and record contents, if provided, to determine which data may be causing the uniqueness violation. Find the records sharing these values and determine and make the appropriate changes to remove the duplication. Then re-execute DMA.
The -530 Constraint Violation ErrorThis record was not processed because it contains a value which is incompatible with the restrictions associated with this setting. (See reference name listed below).SUGGESTED ACTION: Check the documented setting range limits for the problem field. Correct the setting to be compatible with the requirements of CUCM version to which you intend to migrate. Then re-execute DMA.
For More Information
Refer to the Data Migration Assistant User Guide.
Directory Message Improvements
Table 1 comprises the improvements that have been made to user-viewed messages.
CER Improved Messages
The following improvements are made in the CER areas:
"Error Messages Details
"Fixed logical errors
"Misc. minor corrections
Added the CSV file name in the error message - When parsing the CSV file, if the number of columns does not match number of column types, then an error message is logged, this error message was not having the CSV file name. Added the CSV file name in the error message.
Added error messages if not able to create "cer" and "exported" directories - CER DMA creates two directories named "cer" and "exported", there was no check to see whether the directory creation was successful or not. Added checks to see if the directory creation was successful or not. If directories are not created then an error message is logged.
Misc. Minor Corrections
Following messages are changed to specify the real cause:
Proper Return Code Sent To the DMA Framework
During DMA export and validation phases, the DMA framework launches separate processes to invoke the underlying components' .exe 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.
Using this information the framework can determine if there are fatal issues encountered and if 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 are:
•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.
During an upgrade, the Linux install application determines if 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.
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.Z
For example, for DMA 6.1(2), the target Unified CM upgrade version is release 6.1(2). So, this field displays 6.1.2 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 CUCM 6.1.2 respin becomes a reality in the future, the logic will work andthe customer can use DMA 6.1(2) to upgrade to the Unified CM Release 6.1.2 respin release.
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 That Are Resolved in Data Migration Assistant 6.1(2)
This section contains a partial list of the defects that are resolved in this release of Data Migration Assistant. You can obtain a full list by reviewing and implementing the information in "UsingBug Toolkit" section
CSCsl57662 - Need to add Product Deployment field in platformConfig.xml file
CSCsl59339 - Need exists for user to see the file on tape - DMA backup tar files
CSCsl61200 - DMA does not check to see if the destination is writeable/accessible
CSCsl52704 - DMA cannot store the .tar file to a mapped drive letter
CSCsl85046 - URL displayed on the DMA result status.html page refers to Unified CM information
CSCsl85071 - DMA backup on CER does not update the results in status.html GUI properly
CSCsl85126 - DMA backup on CER132 box shows validation failed
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.
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:
•Cisco.com user ID and password
To use the Software Bug Toolkit, follow these steps:
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.
Table 2 describes possible unexpected behaviors in Data Migration Assistant.
Tip For more information about an individual defect, click the associated Identifier in Table 2 to access the online record for that defect, including workarounds.
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.
Note Because defect status continually changes, be aware that Table 1 reflects a snapshot of the defects that were open at the time this report was compiled. For an updated view of open defects, access Bug Toolkit and follow the instructions as described in the UsingBug Toolkit.
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.
Table 2 Open Caveat as of April 28, 2008
DMA install does not populate SIP profile field on SIP trunks.
Errors Log button opens an error file that does not display any errors.
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:
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.
Cisco Product Security Overview
This product contains cryptographic features and is subject to United States and local country laws governing import, export, transfer and use. Delivery of Cisco cryptographic products does not imply third-party authority to import, export, distribute or use encryption. Importers, exporters, distributors and users are responsible for compliance with U.S. and local country laws. By using this product you agree to comply with applicable laws and regulations. If you are unable to comply with U.S. and local laws, return this product immediately.
A summary of U.S. laws governing Cisco cryptographic products may be found at: http://www.cisco.com/wwl/export/crypto/tool/stqrg.html. If you require further assistance please contact us by sending email to firstname.lastname@example.org.
CCVP, the Cisco logo, and Welcome to the Human Network are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn is a service mark of Cisco Systems, Inc.; and Access Registrar, Aironet, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, IP/TV, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, iQuick Study, LightStream, Linksys, MeetingPlace, MGX, Networkers, Networking Academy, Network Registrar, PIX, ProConnect, ScriptShare, SMARTnet, StackWise, The Fastest Way to Increase Your Internet Quotient, and TransPath 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. (0711R)
© 2008 Cisco Systems, Inc. All rights reserved.
Printed in the USA on recycled paper containing 10% postconsumer waste.