E
dit
A
ttach
P
rintable
r3 - 2013-10-04 - 14:36:42 -
PaulEllis
You are here:
TWiki
>
Deployment Web
>
DeploymentInstallingUpgradingAndMigrating
>
UpgradingRequirementsComposerFrom2To3
>
UpgradingRRCReviewTheMigrationResults
<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"> Reviewing the RRC3 migration results %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 how to access and review the results of the RRC3 migration. Refer to [[https://jazz.net/library/article/698][Upgrade Reference for CLM 2011]] for overall guidance on upgrading. To review the results of the upgrade, run the [[#SectionA1][RRC Upgrade report tool ]]and review the [[#SectionA2][contents of the upgrade directory]]. #SectionA1 ---++ Upgrade Report Tool The upgrade report tool is available in versions 3.0.1.4 and higher in !InstallDir/conf/rdm/tools.%BR% Command line:%BR% upgrade-reports.bat -help%BR% upgrade-reports.sh -help%BR% upgrade-reports.bat _command_ {-help}%BR% upgrade-reports.sh _command_ {-help}%BR% commands: makeResourceReport, makeErrorReport, makeDeltaReport, makeErrorArchive%BR% *makeResourceReport* %BR% Generates resource-centric reports: * resource-urls.csv - a list of the resource urls for artifacts with errors. Note: this does not include internal resources, such as links or comments, that do not have a front side url. Each artifact listed may have multiple revisions with errors - consult the file resource-report-errs.csv. The entry in this list is the URL that will display the artifact in a browser, if the artifact is accessible. You may use this URL in RRC2 to determine if the current revision of this artifact was accessible and not corrupted. The entry also includes the number of revisions of this artifact that are reporting an error. * resource-report-errs.csv - one report for all error annotations. * resource-report._projectAreaId.csv - one for each project area, with delta annotations for each resource, including the resources that were reported in the errors report.%BR% Each row represents a version of each resource, noting the value of all annotations on that resource version noted during the upgrade. There may be multiple versions of a particular resource, one row per version. *makeErrorReport* Generates an error-centric report, error-report.txt, which contains an entry for each error found during the upgrade. *makeDeltaReport* Generates a delta annotation-centric report, delta-report.txt, which contains an entry for each delta annotation noted during the upgrade. *makeErrorArchive* Generates an archive of all recorded data for resources that encountered errors during the upgrade. The archive will be found in !InstallDir/rdm/migration/systime-tmp/systime-tmp.jar. This archive may be used to communicate with Support about non-critical resource errors. #SectionA2 ---++ Upgrade Results ---+++ Location of the upgrade results directory This directory will be found in the !InstallDir/rdm/migration/systime-tmp directory. systime is a 13 digit number. ---+++ Navigating the upgrade directory This directory contains: * migration-errors.log - If the upgrade has a critical failure, this file contains information about the failure * resource-errors.log - This file contains information about non-critical errors for individual resources * migration-metrics.rdf and resources-metrics.csv - Statistics from the migration * Folders representing different kinds of resources (for example, "Resources", "Folders", "Links", "Comments") contain files related to those resources. * When you run the upgrade report tool, output files are written to this directory. *To find the original RRC2 xhtml content for a resource that reported an error:* * Find the resource id in the entry in resource-errors.log, in the form 'rrc' followed by an ID. * Note the revision ID. For example, Resource: !https://server:9443/jts/storage/com.ibm.rdm.resources/rrc308?revision=_v1wbhmagEeCeW9etSZqfCw * Change to the Resources/rrcID directory. In the directory, there will be files with unique id names, with no extension, one file for each version of the resource. For example: _v1wbhmagEeCeW9etSZqfCw This file contains the original RRC2 xhtml content for a version of this resource. *To find the resource delta file for a resource:* * To access the resource delta file for resource, find the resource id, in the form 'rrc' followed by an ID. Change to the Resources/rrcID directory. In the directory, there will be files with unique id names, with a .rdf extension, one file for each version of the resource. For example: _v1wbhmagEeCeW9etSZqfCw This is the resource delta file for this version of the resource. ---++ Review Results Checklist * Run !InstallDir/rdm/tools/upgrade-report.bat makeResourceReport' * Review output files in the upgrade results directory. * Get the list of artifacts with migration errors from resource-urls.csv * Determine if each artifact is accessible in RRC2 and RRC3 by opening the URL. It will look something like, !https://server:9443/rdm/resources/rrc346. The RRC2 UI may report it cannot open the artifact or encountered an error opening the artifact. * Eliminate artifacts that are no longer used in RRC2 - this may include artifacts that were corrupted in 2.x, or deleted. If the artifact is no longer used, you may ignore this error. * Some artifacts may not be accessible in RRC3 and some may be displayed but cannot display their contents. Separate the artifacts into two lists. * Using the resource-errors.log and the resource-report-errs.csv file, evaluate the errors for remaining artifacts. * The resource-report-errs.csv report contains a column 'contentRepaired', which indicates whether a special repair transform was attempted on the resource content, and whether the repair succeeded or not. If it says 'Content repaired', the resource content was preserved but the original formatting needed to be removed. Other annotations indicate that the content could not be repaired. * If the artifact is active and required, contact IBM Support to submit a defect. ---+++++!! 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>
E
dit
|
A
ttach
|
P
rintable
|
V
iew topic
|
Backlinks:
We
b
,
A
l
l Webs
|
H
istory
: r3
<
r2
<
r1
|
M
ore topic actions
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
.