Must Gather to troubleshoot Broken Links in GC enabled Project Areas

Introduction

Must gather if a user report a broken links when working on Global Configuration enabled project areas. This document do not explain where links are stored or in details about LDX. This is high level document to explain as to what kind of logs to be collected to investigate broken link issues in GC context.

Troubleshooting broken links in GC enabled project area is complex and this document is to assist list of logs which needs to gathered out broken configuration. The broken links could be classified in several ways, lets us consider following two use cases:

1. Creating a link from QM Test Case to DNG requirement is expected to establish a link between TC and requirement. In some cases, you'd see a link of TC on DNG requirement but not in Test Case or vice-versa.

2. Populating artifacts from a GC baseline into a GC stream. In GC baseline link between Test case and DNG requirement exist as expected, however GC stream created out that baseline contain a broken links.

Introductory paragraph Introductory paragraph Introductory paragraph Introductory paragraph Introductory paragraph Introductory paragraph Introductory paragraph Introductory paragraph Introductory paragraph Introductory paragraph Introductory paragraph Introductory paragraph Introductory paragraph Introductory paragraph Introductory paragraph Introductory paragraph Introductory paragraph Introductory paragraph Introductory paragraph

Log Collections

1. Output of Contribution tree, copy outcome into a text file called GC-ID.txt

escaped: ! https://:/rm/gcsdk/tree?configurationUri=https:///gc/configuration/<GC-ID>

2. GC ID (e.g https://:/gc/configuration/4)

3. Local configuration URI of QM. This can be obtained from the web UI of where GC Test case exist. Click on Current Configuration, hover over Local Configuration name and copy link (e.g https://:/qm/oslc_config/resources/com.ibm.team.vvc.Configuration/<_1QceYBSuEequ-JEash4SxA>)

4. GC verioned Test Case URL. From test case, click on "Copy link for this page" and then select Copy OSLC URL. This should contain full versioned test case (e.g https://:/qm/oslc_qm/contexts/<_0VIssRSuEequ-JEash4SxA>/resources/com.ibm.rqm.planning.VersionedTestCase/<_Ggks8xSwEequ-JEash4SxA>/<_4dfh2xSxEequ-JEash4SxA>)

<_Ggks8xSwEequ-JEash4SxA> : VersionedTestCase Item ID

<_4dfh2xSxEequ-JEash4SxA> : VersionedTestCase State ID

5. Local configuration URI of RM. This can be obtained from the web UI of where GC Requirement exist (e.g https://:rm/cm/stream/<_xQvHkBSuEeqCl9XOGtTvzQ>)

6. DNG Requirement link that was add to Test Case. From requirement use, pick up Share Link option and then copy a link (e.g https://:/rm/resources/<_-5ElgxSuEeqCl9XOGtTvzQ> )

7. QM Test Case history PDF. From Test Case menu, go to History, click on Export History to save TC history.

8. TRS Feed. Go to trsConsole (https://:/qm/trsConsole) and click on download, this should download a ZIP of the TRS2 feed (RQM Resources (TRS 2.0)) including all base page(s) and change log page(s).

9. LDX graph query output for Test Case. To run this query, go to https://:/ldx/web/query#sparql. Select Configuration scope: to where TC is exist (eg gcStream1)

prefix dcterms: <http://purl.org/dc/terms/>
prefix oslc_config: <http://open-services.net/ns/config#>
prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>

SELECT ?selected WHERE 

{ <https://<server>:<port>/qm/oslc_config/resources/com.ibm.team.vvc.Configuration/<uuid-lc-qm>/selections>; <http://open-services.net/ns/config#selects>; ?selected FILTER regex(str(?selected), "<uuid-gc-qm-itemID>")

} 

note:

<uuid-lc-qm> : this is UUID of the local config, see step 3)

<uuid-gc-qm-itemID> : VersionedTestCase Item ID, see step 4)

10. DNG resource query against LDX, this query should be scoped to GC where the link exists (eg gcStream1) in LDX. It’s the query that DNG uses to fetch the links from LDX

prefix dcterms: <http://purl.org/dc/terms/>
prefix oslc_config: <http://open-services.net/ns/config#>
prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
prefix owl: <http://www.w3.org/2002/07/owl#>
SELECT ?sURL ?linkType ?tURL ?indLinkType 
WHERE {
   {
      VALUES ?linkType {
         <http://jazz.net/xmlns/prod/jazz/calm/1.0/implementsRequirementCollection>
         <http://open-services.net/ns/qm#validatesRequirementCollection>
         <http://open-services.net/ns/qm#validatesRequirement>
         <http://open-services.net/ns/cm#implementsRequirement>
         <http://open-services.net/ns/cm#affectsRequirement>
         <http://open-services.net/ns/cm#tracksRequirement>
      }
      VALUES ?tURL {
         <RM resource URI>
      }
      {
         ?sURL ?linkType ?tURL.
         BIND( ?linkType as ?indLinkType ) .
      }
      UNION
      {
         ?indLinkType owl:sameAs ?linkType .
         ?sURL ?indLinkType ?tURL .
      }
   }
   OPTIONAL
   {
      ?reification rdf:subject ?sURL .
      ?reification rdf:predicate ?indLinkType .
      ?reification rdf:object ?tURL .
      ?reification ?property ?release .
      ?release oslc_config:configuration ?config
   }
}
ORDER BY ?tURL ?linkType ?sURL LIMIT 1000

11. Verification of the selections page if the state ID is same as the "_uX2E3GjiEeqN_eb5TIbnUg". The selection page

https://:/qm/oslc_config/resources/com.ibm.team.vvc.Configuration/<uuid-lc-qm>/selections

Heading 2 (use sentence-style capitalization)

Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text

Heading 2 (use sentence-style capitalization)

Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text Sub-Section text

Heading 1

Related topics: Deployment web home, Deployment web home

External links:

• IBM

Additional contributors: TWikiUser, TWikiUser