<div id="header-title" style="padding: 10px 15px; border-width:1px; border-style:solid; border-color:#FFD28C; background-image: url(<nop>https://jazz.net/wiki/pub/Deployment/WebPreferences/TLASE.jpg); background-size: cover; font-size:120%"> ---+!! <img src="https://jazz.net/wiki/pub/Deployment/WebPreferences/new.png" alt="under construction" width="50" height="50" align="right">Advanced Upgrade observations: IBM Rational Requirements Composer 2.x to 3.x %DKGRAY% Authors: Main.ShirleyHui<br> Build basis: CLM 2011, Rational Team Concert 3.0.1, Rational Requirements Composer 3.0.1%ENDCOLOR%</div></sticky> <!-- Page contents top of page on right hand side in box --> <sticky><div style="float:right; border-width:1px; border-style:solid; border-color:#DFDFDF; background-color:#F6F6F6; margin:0 0 15px 15px; padding: 0 15px 0 15px;"> %TOC{title="Page contents"}% </div></sticky> <sticky><div style="margin:15px;"></sticky> This article describes details specific to migrating from Rational Requirement Composer (RRC)2 to RRC3, also known as CLM 2011.%BR% Refer to [[https://jazz.net/library/article/698][Upgrade Reference for CLM 2011]] for overall guidance on upgrading.%BR% This article is also relevant to those who wish to migrate to RRC 4.x/CLM 2012 and beyond, as the migration to 3.x is a first step in the two-step process of migrating from RRC 2.x.%BR% ---++ Recommendations * Migrate using the most recent version of 3.0.1.x in order to have the most up to date fixes in migration code. Currently this is version RRC 3.0.1.6. * Validate the data after migrating to 3.0.1.6 and BEFORE proceeding with an upgrade to 4.x or newer versions. Please use the following sections to understand the data migration, and to plan and execute your migration. * [[#SectionR1][Limitations]] * [[UnderstandingTheDataTransformations][Understanding the data transformations]] * [[UpgradingRRCRunningaTrialMigration][Running a trial migration]] * [[#SectionR4][Perform backups before offline and online migration steps]] * [[#SectionR5][Online migration error handling]] * [[UpgradingRRCReviewTheMigrationResults][Review the migration results]] #SectionR1 ---+++ Limitations * The migration occurs for the entire RRC2 repository. Partial or project-by-project migration is not supported.%BR% * Migration of RRC2 project archives is not supported.%BR% * All URI references using the rich-client based protocol (rpc://protocol) will be broken after migration.%BR% * This protocol is not supported in RRC3.%BR% #SectionR4 ---+++ Perform backups Migration cannot be resumed or restarted if an error is encountered. You must restart the migration at the previous step from backup. Perform a backup of the Jazz Team Server and database (this includes the database and the !InstallDir/server/conf directory) before:%BR% * Running the upgrade\rm_upgrade.bat script (offline migration step) * Starting the online migration #SectionR5 ---+++ Online migration error handling The online migration phase must run uninterrupted from start to finish.%BR% Fatal error conditions: * Loss of connectivity to JTS. * Insufficient disk space. * General environment failures, such as power failure or other network issues.%BR% If you encounter any of these fatal errors, resolve the environment issues, restore the Jazz Team Server server from backup and run the online migration again. ---+++ Unexpected migration error When the online migration is complete, it will report whether it was successful.%BR% If it reports that the migration failed, locate the 'migration-errors.log' in !InstallDir/conf/rdm/migration/systime-tmp directory. _systime_ is a 13 digit number based on the time the migration ran.%BR% Review the errors for conditions related to the environment (network, JTS error). If possible, correct the condition, restore from backup, and run the online migration again.%BR% If there are no environment failures, contact IBM Support.%BR% ---+++ Errors in individual resources The online migration will be successful even if there are errors in individual resources. These errors are not considered fatal. You will be able to access the repository to validate the migration. <img src="%ATTACHURLPATH%/migrationWithErrors.JPG" alt="migrationWithErrors.JPG" width="696" height="466" /> We highly recommend that you perform a trial upgrade in a test environment before upgrading your production environment. Errors in individual resources should be investigated to determine if the migration code can be corrected. Often, the resource was corrupted in RRC2 and is no longer in use in your project. ---+++++!! Related topics: [[#SectionR1][Limitations]], [[UnderstandingTheDataTransformations][Understanding the data transformations]], [[UpgradingRRCRunningaTrialMigration][Running a trial migration]], [[#SectionR4][Perform backups before offline and online migration steps]], [[#SectionR5][Online migration error handling]], [[UpgradingRRCReviewTheMigrationResults][Review the migration results]] ---+++++!! External links: * [[https://jazz.net/library/article/698][Upgrade Reference for CLM 2011]] ---+++++!! Additional contributors: Main.PaulEllis <sticky></div></sticky>
Attachments
Attachments
Topic attachments
I
Attachment
Action
Size
Date
Who
Comment
jpg
migrationWithErrors.JPG
manage
57.5 K
2013-10-03 - 16:36
PaulEllis
This topic: Deployment
>
WebHome
>
DeploymentInstallingUpgradingAndMigrating
>
UpgradingRequirementsComposerFrom2To3
History: r3 - 2013-11-06 - 10:02:33 -
PaulEllis
Copyright © by IBM and non-IBM contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our
Terms of Use.
Please read the following
disclaimer
.
Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more
here
.