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

You can store OSLC configuration settings in the 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 ClearQuest Web deployment.

Procedure

  1. Configure load balancing on each ClearQuest Web server.
  2. On each 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 ClearQuest 8.0.1. If you are upgrading from a version of ClearQuest earlier than 8.0.1, the cqrest.properties file on each 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.
  3. Save and close the cqrest.properties file on each server.
  4. If you want to automatically import existing OSLC configuration settings from a server file system to the 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
  5. Restart all the 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.
  6. 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 ClearQuest Web server for Collaborative Lifecycle Management integrations.

Results

You configured 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 ClearQuest Web to manage OSLC integrations in a load-balanced deployment. For more information, see Manually update OSLC configuration settings in the repository.

Feedback