Configuring Rational® ClearQuest® Web to manage OSLC integrations in a load-balanced deployment

You can store OSLC configuration settings in the Rational® ClearQuest® schema repository as master properties for shared use by all servers in the deployment.

Before you begin

You must have the Super User privilege to complete the next steps.

About this task

You must complete some additional configuration steps to enable load balancing of OSLC requests in a load-balanced Rational® ClearQuest® Web deployment.

Procedure

Configure load balancing on each Rational® ClearQuest® Web server.
On each Rational® ClearQuest® Web server in the load-balanced deployment, edit the cqrest.properties configuration file, which is installed in the following directory:
WASinstallDir\installedApps\WAScell\TeamEAR.ear\cqweb.war\WEB-INF\classes
where:
- WASinstallDir is the directory where WebSphere® Application Server is installed.
- WAScell is the WebSphere® Application Server cell directory.
Change or add the following property and setting:
```
com.ibm.rational.cm.web.component.oslc.configuration.location=repo
```
Note: This property is new to Rational® ClearQuest® 8.0.1. If you are upgrading from a version of Rational® ClearQuest® earlier than 8.0.1, the cqrest.properties file on each Rational® ClearQuest® Web server does not include the new property. This is because the cqrest.properties file is preserved and restored by the IBM® Installation Manager. Absence of the com.ibm.rational.cm.web.component.oslc.configuration.location property in the file indicates that the OSLC configuration settings are currently managed on the server file system.
Save and close the cqrest.properties file on each server.
If you want to automatically import existing OSLC configuration settings from a server file system to the Rational® ClearQuest® repository, change or add the following property and setting to the cqrest.properties file on this server only:
```
com.ibm.rational.cm.web.component.oslc.configuration.autoInitializeRepository=true
```
Restart all the Rational® ClearQuest® Web servers in the load-balanced deployment and log on to each server.
Logging on to each server refreshes the OSLC configuration settings in memory from the values that are stored in the schema repository, ensuring consistent settings across all servers.
If you chose not to complete step 4, log on to the load-balancing URL that you configured in step 1 and configure the OSLC server friend relationships. For more information about configuring server friend relationships, see Configuring Rational® ClearQuest® Web server for Collaborative Lifecycle Management integrations.

Results

You configured Rational® ClearQuest® Web to manage OSLC integrations in a load-balanced deployment.

What to do next

It might be useful or necessary to manually update OSLC configuration settings in the repository after you configure Rational® ClearQuest® Web to manage OSLC integrations in a load-balanced deployment. For more information, see Manually update OSLC configuration settings in the repository.