This page covers debugging problems creating links from IBM Rational Quality Manager (RQM) and IBM Rational Team Concert (RTC) to IBM Rational DOORS. While there is some overlap, issues creating links
from Rational DOORS to RQM and RTC will be covered separately. The link model used with Design Manager and IBM Rational Requirements Composer (RRC) is different and hence that is also not covered here though again there is overlap.
Initial assessment
- What error is seen?
- Is it failing for all users?
- Has it ever worked?
- Is it failing for all possible link types?
- In which tool is it failing?
Symptoms
- A link from RTC or RQM is not created. The effect is, when looking at a Work Item or a Test Case, the related DOORS requirement is not seen and no hover over is possible.
- A backlink from DOORS to RTC or RQM is not created. In this case, the link is there in RTC or RQM and the users in those tools can see the related requirement. However the users in DOORS have no knowledge the link exists. For example, they may not see the DOORS requirement is linked to a RTC Work Item or RQM Test Case.
Impact
This may impact all users
Recommended data gathering and subsequent analysis steps
Firebug can be useful if no error is seen in the web browser. It can show what requests it is sending to DWA and what responses are arriving back. Of particular note is usually the Net tab.
Extra logging in DOORS Web Access will show what requests are arriving and responses are being sent. See "How to increase the Rational DOORS Web Access logging levels"
http://www.ibm.com/support/docview.wss?uid=swg21456938 and review the request.log and response.log.
Possible causes and solutions
No write access to the DOORS module
The DOORS module is open in exclusive edit mode or a relevant section is locked or the user does not have access to write to the DOORS module. Creating a backlink requires write access to the module - it will fail if this is not possible. For further details see: "Saving an IBM Rational Quality Manager Test Plan linked to a view in IBM Rational DOORS fails with "An error occurred while saving links from requirements provider"",
http://www.ibm.com/support/docview.wss?uid=swg21612615
DOORS Web Access (DWA) configuration error
It is critical that the settings in festival.xml's published.url.prefix match exactly what was set in the DOORS database via dbadmin -dwaHost/dwaProtocol/dwaPort. See "Saving an IBM Rational Quality Manager Test Plan linked to a view in IBM Rational DOORS fails with "An error occurred while saving links from requirements provider"",
http://www.ibm.com/support/docview.wss?uid=swg21612615 and "Clicking Rational DOORS Implements Requirement link fails with HTTP 404 error in Rational Team Concert",
http://www.ibm.com/support/docview.wss?uid=swg21607827
Browser security settings
In particular on Internet Explorer it is necessary to ensure the browser is displaying all content and not blocking it. Pop up blockers can also impact. See also Creating link to Rational DOORS in RTC results in "Navigation to the webpage was cancelled" error,
http://www.ibm.com/support/docview.wss?uid=swg21625320
Project association not done on database level
The RQM/RTC project is not associated with the DOORS database, instead it has only been associated with a view. For links which require access to a requirements collection, such as in RTC Plans or RQM Test Plans, they will not be able select a collection and the user cannot proceed. For further details see "How to select a Rational DOORS View in Rational Team Concert or Rational Quality Manager",
http://www.ibm.com/support/docview.wss?uid=swg21610453 and "Only the URIs of Rational DOORS Requirements are shown in Rational Team Concert Requirements Selection dialog",
http://www.ibm.com/support/docview.wss?uid=swg21620604
Defects
There are some defects, particularly in early versions. See:
External links:
Additional contributors: MaeveOReilly