Troubleshooting
Problem
Defect 138161 : 0.6 migration: ill-formed URIs need to be handled more gracefully impacts upgrades from DOORS Next 6.x to DOORS Next 7.x.
This issue will cause upgrades to fail as URIs within the DOORS Next data are broken after upgrade, but do not currently result in the upgrade being reported as failed.
This technote describes how to run a repotools command before a test upgrade to detect any ill-formed URIs and how to correct them. This command scans the DOORS Next database and outputs a list of bad URIs that need to be substituted during upgrade.
The problem URIs do not conform to Uniform Resource Identifiers(URI): Generic Syntax. Before you run the upgrade command, encode the ill-formed URIs to be conformant.
Note: The URIs in the existing DOORS Next 6.x database appear as originally created in the artifacts.
Symptom
This defect impacts anyone with URIs that do not conform to Uniform Resource Identifiers(URI): Generic Syntax upgrading from DOORS Next 6.0.x to DOORS Next 7.0 or 7.0.1 or 7.0.2.
The errors in the logs/repotools-rm.log look similar to:
1)
ERROR internal.migration.m
06.handlers.links.LinkMigrator - Ill-formed URI cannot be set on link td://td_validation_tests.ip.qualitycenter.customer.com/qcbin/[AnyModule]?EntityType=ITest&EntityID=208735
This fails due to a java.net.URISyntaxException: Illegal character in path at index 61.Or
2) ERROR internal.migration.m06.handlers.links.LinkMigrator - URI exceeds the maximum length allowed on link https:/ibmjazz.net/<over 443 characters in total>
Alternatively, you can check the migrationOutput.log at the end of a test upgrade for these error codes:
CRRRS2103W Ill-formed URI cannot be set on link
CRRRS2119W Link URI was truncated
Note: Due to defect, 139445: 0.6 migration: failure to migrate a link should result in upgrade failure, the CRRRS2103W errors are reported as a warning and do not cause an upgrade to report itself as failed.
As of 7.0.2 Ifix 8, defect 139445 is resolved,CRRRS2103E Ill-formed URI cannot be set on link is reported in the migrationOutput.log, and the addTables.log reports the overall upgrade as failed.
Document Location
Worldwide
[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSUVLZ","label":"IBM Engineering Requirements Management DOORS Next"},"ARM Category":[{"code":"a8m50000000L3D5AAK","label":"DOORS Next"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"6.0.6"},{"Product":{"code":"SSPRJQ","label":"IBM Engineering Lifecycle Management Base"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB77","label":"Automation Platform"}},{"Product":{"code":"SSF34G","label":"IBM Engineering Lifecycle Management Suite"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB77","label":"Automation Platform"}},{"Product":{"code":"SSUVV6","label":"IBM Engineering Test Management"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB77","label":"Automation Platform"}},{"Product":{"code":"SSUC3U","label":"IBM Engineering Workflow Management"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB77","label":"Automation Platform"}}]
Log InLog in to view more of this document
This document has the abstract of a technical article that is available to authorized users once you have logged on. Please use Log in button above to access the full document. After log in, if you do not have the right authorization for this document, there will be instructions on what to do next.
Was this topic helpful?
Document Information
Modified date:
04 July 2023
UID
ibm16453317