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.

Table 1 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)

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
In the Rational ClearQuest project-area-links.rdf file, confirm that the new links have valid values.
Add each project link again.

Alternate method (requires restarting Rational ClearQuest Web Server)

In the project-area-links.rdf file, manually add or edit the oslc:version and oslc:domain parameters and associated values.
Restart Rational ClearQuest Web Server.