Updating link configuration for OSLC integrations

If you upgraded from Rational® 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 Rational® ClearQuest® version 8.0.0.3 or earlier.

About this task

When you upgrade Rational® 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 Rational® ClearQuest® releases earlier than version 8.0.0.4. As a result, you might encounter JavaScript™ issues when you attempt to access links in Rational® ClearQuest® records to external OSLC resources.
The linking errors can occur in either of these scenarios:
  • The project link was created in the Rational® ClearQuest® Web client interface in a version earlier than 8.0.0.4
  • The project link was created from another application to the Rational® ClearQuest® Web client interface in a version of Rational® 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.
OSLC version and domain notations provides examples of the OSLC version and domain notations that are supported by Rational® ClearQuest® version 8.0.0.4 and later.
Table 1. OSLC version and domain notations
OSLC notation Description
Version notations The OSLC specification version that is supported by your linked product. Valid values are 1.0 and 2.0
Example specifications:

Version 1: <version xmlns="http://open-services.net/ns/core#">1.0</version>

Version 2.0: <version xmlns="http://open-services.net/ns/core#">2.0</version>
Domain notations The OSLC domain specification your product.
Example specifications
Open Services for Lifecycle Collaboration Change Management Specification, Version 1.0
<domain xmlns ="http://open-services.net/ns/core#">http://open-services.net/xmlns/cm/1.0</domain>
Open Services for Lifecycle Collaboration Requirements Management Specification, Version 1.0:
<domain xmlns="http://open-services.net/ns/core#">http://open-services.net/xmlns/rm/1.0/</domain>
To specify the Open Services for Lifecycle Collaboration Quality Management Specification, Version 1.0:
<domain xmlns="http://open-services.net/ns/core#">http://open-services.net/xmlns/qm/1.0/</domain>

To resolve OSLC linking errors in Rational® ClearQuest® Web client, update the Rational® 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 Rational® 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 Rational® ClearQuest® is deployed.
    • < cell> is the Name of the WebSphere® Application Server cell
  2. In the Rational® ClearQuest® project-area-links.rdf file, confirm that the new links have valid values.
  3. Add each project link again.
Alternate method (requires restarting Rational® 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 Rational® ClearQuest® Web Server.