E
dit
A
ttach
P
rintable
r6 - 2015-05-27 - 14:23:16 - Main.sbagot
You are here:
TWiki
>
Deployment Web
>
DeploymentTroubleshooting
>
IntegrationsTroubleshooting
>
IntegrationsTroubleshootingJazzandDOORS
>
IntegrationsTroubleshootingDebugCLMIntegrationWithDOORS
<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="" alt="" width="50" height="50" align="right"> How to debug CLM integrations with DOORS %DKGRAY% Authors: Main.MaeveOReilly<br> Build basis: CLM 4.x and later %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 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 <hostname>*. 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 <app>/admin page. For example, for RQM: </br><img alt="public-uri1.jpg" src="%ATTACHURL%/public-uri1.jpg" /> For DOORS, it is *<DWA>/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: </br><img alt="public-uri2.jpg" src="%ATTACHURL%/public-uri2.jpg" /> ---++ Check for known issues Known issues are listed in the <a href="IntegrationsTroubleshooting" target="_blank">Integration Troubleshooting</a> 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 <a href="http://www.ibm.com/support/docview.wss?uid=swg21612615" target="_blank">Technote 1612615</a> 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 <a href="http://www.ibm.com/support/docview.wss?uid=swg27020747#Table5" target="_blank">Rational Support</a> or logged on jazz.net. ---++ Logs The DWA festival logging is very good in particular for OSLC requests. Take a look at them for any errors or messages - *DWA Install Dir/server/festival/logs*. It is possible to activate more logging by renaming *DWA Install Dir/server/festival/config/festival-log4j.xml.support* to *festival-log4j.xml* and restarting DWA. Broker logging can be activated by renaming *DWA Install Dir/broker/conf/log4j.properties.support* to *log4j.properties* and restarting DWA. Interop level logging is the most detailed and cryptic. It is generally only useful to Rational support. Activate it by adding additional parameters to the command starting interop: *-loglevel 8 -l c:\logfile1.txt* See: [[http://www-01.ibm.com/support/docview.wss?uid=swg21397464][How to enable logging for DWA Interoperation server]] Consider also the Jazz application logs. *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. ---++ Enable HTTP tracing First consider where the problem is see: is it 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 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. Mozilla Firefox Install the firebug addon from <a href="http://getfirebug.com" target="_blank">getfirebug.com</a><br> Microsoft Internet Explorer 9+ Developer tools can be started by clicking F12 from the Tools menu<br> 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. <br> </br><img alt="Requirements-collect-links.jpg" src="%ATTACHURL%/Requirements-collect-links.jpg" /> <br> 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. <br> </br><img alt="Requirements-collect-link-details.jpg" src="%ATTACHURL%/Requirements-collect-link-details.jpg" /> <br> ---+++ 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 <a href="http://fiddler2.com" target="_blank">Fiddler</a> which works like Firebug and Developer Tools. Install and start Fiddler get it from: <noautolink>http://fiddler2.com/</noautolink>. 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): <verbatim> proxy=8888@127.0.0.1 proxy_type=HTTP </verbatim> <br> </br><img alt="EVs.jpg" src="%ATTACHURL%/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: [[DeploymentWebHome][Deployment web home]], [[DeploymentWebHome][Deployment web home]] ---+++++!! External links: * [[https://www.ibm.com][IBM]] ---+++++!! Additional contributors: None <sticky></div></sticky>
E
dit
|
A
ttach
|
P
rintable
|
V
iew topic
|
Backlinks:
We
b
,
A
l
l Webs
|
H
istory
: r6
<
r5
<
r4
<
r3
<
r2
|
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
.