new.png How to debug CLM integrations with DOORS

Authors: MaeveOReilly
Build basis: The Rational solution for Collaborative Lifecycle Management (CLM) 4.x

This topic provides a general strategy for debugging Open Services for Lifecycle Collaboration (OSLC) based integrations with IBM Rational DOORS.

Double check the basics

  • Can the DOORS Web Access (DWA) server resolve the hostnames of the Jazz server (in an enterprise topology, for instance, if IBM Rational Quality Manager (RQM) and Jazz Team Server (JTS) have different hostnames), can it resolve all of the Jazz topology names? Check this with nslookup . Then check in the other direction, can the Jazz server find DWA?
  • Can the DWA servers ping the Jazz servers and vice versa?
  • Are the timestamps between the servers synchronized? Timestamps are part of the oAuth dance and having a mismatch can break it.
  • Is a Pop Up Blocker blocking stuff?
  • Is a network Proxy preventing access?
  • Is browser security impacting? If it is seeing internal servers as ‘Internet’, try them as trusted or intranet.
  • Microsoft Internet Explorer MUST work for accessing any application you wish to link to DOORS. If it does not work in Internet Explorer, it is unlikely it will work in DOORS.
  • Are the URLs entered for rootservices documents correct? For Jazz applications, they follow a standard of <public uri/rootservices. Do not replace any part of the public uri. For instance, do not use an IP Address or physical hostname. Match it exactly to what is set as the public URI for that application. That can be seen in the /admin page. For example, for RQM:


public-uri1.jpg

For DOORS, it is /dwa/public/rootservices. Here again, we must be consistent. Match the protocol, hostname and port to the URL seen for an object, either in DOORS or DWA:


public-uri2.jpg

Check for known issues

Known issues are listed in the Integration Troubleshooting section of the Deployment wiki.

Double check the DWA configuration

In particular in versions prior to 9.5.1, ensure the DOORS Database and DWA have been configured to use the exact same protocol, port, and hostname. See technote Technote 1612615 for more details.

Data Matters

Is the issue specific to a particular DOORS module, view, object or a particular artifact on the Jazz side? Are there non alpha numeric characters that might be breaking it? If this is the case, it is likely a defect and should be addressed by Rational Support or logged on jazz.net.

Enable HTTP tracing

First consider where the problem is seen – in a Jazz application or in DOORS Web Access (DWA) or in DOORS 9 client? If it starts in a DOORS 9 client, is it reproducible in DOORS Web Access? Moving to a web based application simplifies debugging.

A. Issue seen in Jazz Application or DOORS Web Access

Logs: The DWA festival logging is very good in particular for OSLC requests. So take a look at them for any errors or messages - /server/festival/logs. It is possible to activate more logging by following the instructions in /server/festival/config/festival-log4j.xml.support

It these logs shed no light, take a look in the Jazz application log (ccm.log for Rational Team Concert (RTC), qm.log for RQM, rm.log for Rational Requirements Composer (RRC) or DOORS Next Generation (NG), dm.log for Design Manager).

If it is still not possible to progress, http tracing tools such as Firebug (an addon for Mozilla Firefox), Internet Explorer Developer Tools (from Internet Explorer 9 onwards, as we need network tracing) or Google Chrome Developer Tools can help.

Mozille Firefox – Install the firebug addon from getfirebug.com
Microsoft Internet Explorer 9+ – Developer tools can be started by clicking F12 from the Tools menu
Google Chrome – Developer tools can be started from the Tools menu

Regardless of the browser or tool, what we are mostly interested in is the Network tracing. At their most basic, OSLC integrations are sending and receiving HTTP GET, PUT, or POST requests. If something is failing, it is likely one of those we want to trace. Is there an error code in there we are not seeing in the logs? Is there something different in a request which works and one which fails?

Some screenshots – from Chrome. A Test Plan creates a Requirements Collection Link to a view in DOORS. Then the Test Plan is saved. Here we see GET, PUT, POST operations.



Requirements-collect-links.jpg

In this instance, they all worked, so all give a 200. If we want to look in more detail, we double click on the request of interest. For instance, for the final POST – this was a Save of the Test Plan. That operation writes to the View in DOORS so that DOORS is also aware that the view is linked to a Test Plan.



Requirements-collect-link-details.jpg

B. Issue is seen in DOORS 9

This is a bit trickier. There is little in the way of out of the box logging and for the most part, DWA will not be used so its logging does not help. From 9.5.0.1 however, it is possible to use Fiddler which works like Firebug and Developer Tools.

Install and start Fiddler – get it from: http://fiddler2.com/. If either application is using https (this is the default for Jazz applications and recommended for DWA), under Tools-Fiddler Options-HTTPS, check Decrypt HTTPS traffic.

Create two environment variables (right click on My Computer > Properties > Advanced > Environment Variables; or just type environment variable in the Start menu):

proxy=8888@127.0.0.1
proxy_type=HTTP


EVs.jpg

Start the DOORS Client. Now all OSLC requests DOORS makes will go through the proxy defined here and can be seen in Fiddler which can help track down the particular one which is failing in the same manner as Firebug.

Remember to delete the environment variables when you are done or DOORS will not function correctly if Fiddler is not started.

Related topics: Deployment web home, Deployment web home

External links:

Additional contributors: None

Questions and comments:

Warning: Can't find topic Deployment.IntegrationsTroubleshootingDebugCLMIntegrationWithDOORSComments

Topic attachments
I Attachment ActionSorted ascending Size Date Who Comment
Jpgjpg EVs.jpg manage 54.9 K 2013-10-24 - 16:15 UnknownUser Environment Variables
Jpgjpg Requirements-collect-link-details.jpg manage 233.5 K 2013-10-24 - 16:15 UnknownUser Requirements Collections Link Details
Jpgjpg Requirements-collect-links.jpg manage 71.2 K 2013-10-24 - 16:15 UnknownUser Requirements Collections Links
Jpgjpg public-uri1.jpg manage 29.2 K 2013-10-24 - 16:13 UnknownUser Public URI
Jpgjpg public-uri2.jpg manage 44.6 K 2013-10-24 - 16:14 UnknownUser Public URI
 
This site is powered by the TWiki collaboration platformCopyright © 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.