Edit
Attach
P
rintable
r3 - 2013-10-04 - 14:36:05 -
PaulEllis
You are here:
TWiki
>
Deployment Web
>
DeploymentInstallingUpgradingAndMigrating
>
UpgradingRequirementsComposerFrom2To3
>
UpgradingRRCRunningaTrialMigration
<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="new.png" width="50" height="50" align="right"> Perform a trial RRC2 to RRC3 migration %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 tips for planning your RRC2 to RRC3 migration by performing a trial upgrade. Refer to [[https://jazz.net/library/article/698][Upgrade Reference for CLM 2011]] for overall guidance on upgrading. We highly recommend that you perform a trial upgrade in a test environment before upgrading your production environment. However, we also recognize that performing a trial upgrade may be a complex, time-consuming task. One of the most important steps to preparing for the upgrade - understanding how your type system will look in RRC3 - can be accomplished without upgrading your entire repository. We recommend that you independently migrate one or two projects whose type systems are representative of your team's usage. This step will take a little extra time to setup, but it will save time overall. In this smaller environment, you may also review the migration logs and directories, run the upgrade report tool, and become familiar with the delta and error annotations. The files will be smaller and more manageable, for one project. You may find issues that can be reported to Support, or determine that some modifications to RRC2 data will be necessary. It is also easier and faster to re-test the migration, if necessary. The turn around time will be faster with only one project in the repository. After you are comfortable with the upgrade of the sample project, proceed with the trial upgrade of the entire repository. The upgraded sample repository cannot be used in a production environment. The sample project exported from RRC2 will not have all revisions of artifacts and some other data is not exported via the project archive. ---++ Extract and migrate a single project to evaluate the type system * From your current RRC2 client, download a project archive of a representative project * Install RRC2 on a test machine * Import the project archive into the test RRC2 repository. If you have a few projects, repeat for additional projects. * Install RRC3 on a test machine. * This can be the same machine you just installed RRC2. You cannot run RRC2 and RRC3 simultaneously, only one server can run at a time. * This can use the simplest configuration with Tomcat and Derby. * If you wish, you can setup the environment to mirror your production environment and reuse the environment to run the trial upgrade. However, this often involves multiple machines. With Tomcat and Derby, you will likely be able to use one machine, without overloading it. * From the RRC2 test server, export the test repository. Copy the tar file to the RRC3 test server. * From the RRC3 test server, perform the offline migration using the upgrade scripts. * Continue with the online migration step. * Examine the migration results and review the type system in RRC3 from 'Manage Project Properties' UI dialog * Review the type system information in _Link to article on type system._ * You may want to redo the migration to try some of the suggestions. You can restore from backup and try again. * Review the Results of the Migration - link to the article describing the results IMPORTANT: Take a backup after offline migration. For example, * from the !InstallDir/server directory, run "repotools-jts.bat -export toFile=afterOffline.tar" * if you need to re-do the online migration, run "repotools-jts.bat -import fromFile=afterOffline.tar" * if the network fails, or other major system failure, like a power outage, you have to restart from backup Note: If you change the RRC2 data, you will need to start with a new RRC3 install This exercise is for test purposes only - the upgraded RRC3 test repository will not have all data from your RRC2 repository. ---++ Run a Trial Upgrade Open the [[http://pic.dhe.ibm.com/infocenter/clmhelp/v3r0m1/index.jsp][Info Center]] and search for 'Staging a test environment for the upgrade process'. We recommend running a trial upgrade of your repository in a test environment before upgrading your production environment. * This will give you an idea of how long it will take in production * Expose any issues in the test environment, not while users are trying to work. * Possibly repair or reorganize some data in RRC2 before the upgrade * Some additional things to consider: * Archive old projects before performing the upgrade * [[#SectionR1][Reduce the RRC2 export time]] After running the trial upgrade and reviewing the results, some actions may be required on the RRC2 data. Perform those actions and repeat the trial until you are satisfied with results. When you are satisfied, perform upgrade on production data, taking care to take backups at every major step. #SectionR1 ---++ Reduce the RRC2 export time There are 3 ways to reduce the RRC2 export time: * We found that you will have a significant performance improvement if you run the repotools -export from the same machine where the database is installed. This requires installing RRC2 or Jazz Foundation 1.0.0.2 iFix 8 on the same machine as the DB server. However, many customers are prohibited from installing other software on the DB server. * Disable inclusion of indices in the tar file. They are not needed for migration. * Add to the existing teamserver.properties: com.ibm.team.jfs.enable.index.migration=false to disable inclusion of indices in tar file * Use an enhancement to repotools -export which allows us to skip storage areas that contain data that will never be used in RRC 3.x. * This feature is available in Jazz Foundation 1.0.0.2 iFix 8. * This version of Jazz Foundation was released after the latest release of RRC 2.x. It is not available in any RRC 2.x. However, this is not a problem. You only need JFS to run the repotools -export. How to install * Install JFS 1.0.0.2 iFix8 (either on DB machine or another machine) * Copy the !RRC2ServerInstallDir/server/conf directory (contains conf/jazz and conf/rdm) to the JFS install directory * Copy the update sites directories from the !RRC2ServerInstallDir/server directory to the JFS install directory * Configure teamserver.properties to point to the database being used by RRC2. (may already be correct from copying it above) * Add to the existing teamserver.properties: com.ibm.team.jfs.exportFilterHistoryInStorageAreas=com.ibm.rdm.project-resources,com.ibm.rdm.attributegroups,com.ibm.rdm.savedfilters to ignore these storage areas * Also add com.ibm.team.jfs.enable.index.migration=false to disable inclusion of indices in tar file * Shutdown the RRC 2.x server (if you haven't already done so) * Run the repotools -export from the JFS installation. ---+++++!! Related topics: [[UpgradingRequirementsComposerFrom2To3#SectionR1][Limitations]], [[UnderstandingTheDataTransformations][Understanding the data transformations]], [[UpgradingRRCRunningaTrialMigration][Running a trial migration]], [[UpgradingRequirementsComposerFrom2To3#SectionR4][Perform backups before offline and online migration steps]], [[UpgradingRequirementsComposerFrom2To3#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>
Edit
|
Attach
|
P
rintable
|
V
iew topic
|
Backlinks:
We
b
,
A
l
l Webs
|
H
istory
:
r4
<
r3
<
r2
<
r1
|
More topic actions...
Deployment.UpgradingRRCRunningaTrialMigration moved from Deployment.UpgradingRRCRunningatrialmigration on 2013-10-03 - 16:17 by
PaulEllis
-
Deployment
Deployment web
Planning and design
Installing and upgrading
Migrating and evolving
Integrating
Administering
Monitoring
Troubleshooting
Community information and contribution guidelines
Create new topic
Topic list
Search
Advanced search
Notify
RSS
Atom
Changes
Statistics
Web preferences
NOTE: Please use the Sandbox web for testing
Status icon key:
To do
Under construction
New
Updated
Constant change
None - stable page
Smaller versions of status icons for inline text:
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
.