Question & Answer
Question
How can I modify the OSLC configuration stored in ClearQuest schema respository master properties when completing a CLM server rename operation?
Cause
In ClearQuest version 8.0.1.1 and later, the OSLC configuration settings for load-balanced ClearQuest servers must be stored in the ClearQuest schema repository as master properties: OSLC_FRIENDSCONFIG
, OSLC_OAUTHCONSUMERS
, and OSLC_PROJECTAREALINKS
. Because the CLM rename script is configured to update the OSLC settings stored in the ClearQuest WebSphere Application Server profile home directory, you must retrieve the OSLC configuration files from the master properties before you begin the server rename operation.
Answer
When you perform a CLM server rename operation, the server rename script updates the OSLC configuration settings typically stored in the following files:
friendsconfig.rdf
project-area-links.rdf
oauth-consumers.rdf
The default location for these files is in the WebSphere Application Server Directory profile directory for ClearQuest:
WAS_profile_home\installedApps\nodecell\TeamEAR.ear\cqweb.war\WEB-INF\classes
If the OSLC configuration settings are stored in ClearQuest database master properties, use the following procedure to retrieve the OSLC configuration files, complete a CLM server rename operation, and update the OSLC configuration files stored in the master properties.
Updating OSLC configuration settings during a CLM server rename operation
for a load-balanced ClearQuest server
- Identify the ClearQuest server where the CLM server rename will be performed.
- To retrieve the master property corresponding to each of the files that the CLM server rename script must modify, run the
installutil getmasterpropertytofile
command. See example.
If you don't retrieve the master properties directly to the path and file names that the CLM server rename script is expecting, the files must be moved or copied to the appropriate path and file names before continuing to the next step. See example.
- Complete the CLM server rename operation.
For instructions, see CLM server rename in the ClearQuest documentation.
- To update the master property for each of the modified OSLC files, run the following command
installutil getmasterpropertytofile
. See example.
- Log in to each ClearQuest web server where you want to refresh the OSLC configuration settings. See Technote #1644559 for information about automating this process.
Example
In the following example, the ClearQuest version 8.0.0 OSLC configuration files are retrieved from the ClearQuest schema repository master properties to the directory c:\temp, copied to the directory where the server rename script retrieves them, and then stores the updated files in the ClearQuest master properties.
installutil getmasterpropertytofile 8.0.0 admin "" OSLC_FRIENDSCONFIG c:\temp\friendsconfig.rdf
installutil getmasterpropertytofile 8.0.0 admin "" OSLC_OAUTHCONSUMERS c:\temp\oauth-consumers.rdf
installutil getmasterpropertytofile 8.0.0 admin "" OSLC_PROJECTAREALINKS c:\temp\project-area-links.rdf
After retrieving the files, copy them to the WebSphere Application Server profile directory location where the CLM rename server script is expecting the files:
WAS_profile_home\installedApps\nodecell\TeamEAR.ear\cqweb.war\WEB-INF\classes
After completing the CLM server rename operation, update the master property for each OSLC configuration file with the updated information.
installutil setmasterpropertyfromfile 8.0.0 admin "" OSLC_FRIENDSCONFIG WAS_profile_home\installedApps\nodecell\TeamEAR.ear\cqweb.war\WEB-INF\classes\friendsconfig.rdf
installutil setmasterpropertyfromfile 8.0.0 admin "" OSLC_OAUTHCONSUMERSWAS_profile_home\installedApps\nodecell\TeamEAR.ear\cqweb.war\WEB-INF\classes\oauth-consumers.rdf
installutil setmasterpropertyfromfile 8.0.0 admin "" OSLC_PROJECTAREALINKS WAS_profile_home\installedApps\nodecell\TeamEAR.ear\cqweb.war\WEB-INF\classes\project-area-links.rdf
Note: When you complete a CLM server rename for a CLM server that is configured to integrate with multiple ClearQuest schema repositories, you must execute these steps independently for each ClearQuest schema repository.
Related Information
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21646293