Updating link configuration for OSLC integrations

If you upgraded from ClearQuest® version 8.0.0.3 or earlier and your environment supports OSLC integrations, update the OSLC configuration to prevent link errors.

Before you begin

Complete this task after you upgrade from ClearQuest version 8.0.0.3 or earlier.

About this task

When you upgrade ClearQuest Web Server from version 8.0.0.3 or earlier, the new oslc:version and oslc:domain parameters do not have valid values because these parameters were not supported in ClearQuest releases earlier than version 8.0.0.4. As a result, you might encounter JavaScript issues when you attempt to access links in ClearQuest records to external OSLC resources.
The linking errors can occur in either of these scenarios:
  • The project link was created in the ClearQuest Web client interface in a version earlier than 8.0.0.4
  • The project link was created from another application to the ClearQuest Web client interface in a version of ClearQuest earlier than 8.0.0.4
When this problem exists, the preview for a linked artifact does not display when you hover over the link. If you use Firebug to debug the problem, this error is returned: 406 Not Acceptable.
Table 1 provides examples of the OSLC version and domain notations that are supported by IBM® Rational® ClearQuest version 8.0.0.4 and later.

To resolve OSLC linking errors in ClearQuest Web client, update the ClearQuest web link configuration in the project-area-links.rdf file to use valid version and domain specifications.

Procedure

Choose one of these methods to update the OSLC configuration parameters.
Recommended method (does not require restarting ClearQuest Web server)
  1. Remove existing project links from the Project Relationships administration page.
    The project-area-links.rdf file is in the following directory: < profile-root>\installedApps\< cell>\TeamEAR.ear\cqweb.war\WEB-INF\classes where the variable parameters have these values:
    • < profile-root> is the root directory of the WebSphere® Application Server profile where ClearQuest is deployed.
    • < cell> is the Name of the WebSphere Application Server cell
  2. In the ClearQuest project-area-links.rdf file, confirm that the new links have valid values.
  3. Add each project link again.
Alternate method (requires restarting ClearQuest Web Server)
  1. In the project-area-links.rdf file, manually add or edit the oslc:version and oslc:domain parameters and associated values.
  2. Restart ClearQuest Web Server.

Feedback