Configuring Rational Quality Manager to connect with Rational Build Forge version 7.1

After you configure IBM® Rational® Build Forge® to connect with IBM Rational Quality Manager, there are several steps you must perform in Rational Quality Manager to receive lab resource data from Rational Build Forge.
The function that this topic describes might not be available, depending on how lab management permissions and client access licenses have been defined for your user account. You must install Rational Build Forge, version 7.1 and edit the buildforge.conf file before you perform these steps.
To configure Rational Quality Manager:
  1. In the Rational Quality Manager installation folder, in the server folder, open the integration_config.xml file in a text editor.
  2. Delete the comment tags at the beginning and the end of the code: <!-- and -->.
    Note: Be sure that there is not a blank line at the top of the code.
  3. In the <hostname></hostname> line, change the text to the hostname or the IP address of the Rational Build Forge server, for example <hostname>server1</hostname>.
  4. In the <password></password> line, change the password to the password that you defined in the buildforge.conf file on the Rational Build Forge server, for example: <password>stage1</password>.
    Note: The <username></username> setting is ignored in the Rational Build Forge configuration process. However, you can optionally change the user name from <username>root</username> to a user name you choose. You must enter a value for <password>.
  5. In the <instanceID></instanceID> line, change the instance ID to a meaningful name for the Rational Build Forge server. This name will display in the user interface.
  6. Save this file. If Rational Quality Manager is running, restart it. If not, start Rational Quality Manager to enable these changes.
This example shows the integration_config.xml file with the hostname of the Rational Build Forge server, and the password that we defined in "Configuring Rational Build Forge to connect with Rational Quality Manager."

Again, it is important that there is no blank space at the top of the code.

<?xml version="1.0" encoding="UTF-8"?>
<RTLMExtensionAPIRegistration>
  	<adapter>
 		<name>BuildForge RTLM Integration Adaptor</name>
 		<version>1.0</version>
 		<APIVersionSupported>1.0</APIVersionSupported>
  		<inventoryExtensionId>com.ibm.rational.test.lm.spi.bf.v71.inventory</inventoryExtensionId>
 		<automationExtensionId>com.ibm.rational.test.lm.spi.bf.v71.automation</automationExtensionId>
 		<pluginId>com.ibm.rational.test.lm.spi.bf.v71</pluginId>
  		<instance>
 			<instanceId>test_buildforge</instanceId>
  			<hostname>server1</hostname>
 			<port>3966</port>
 			<offline>FALSE</offline>
 			<credential>
 				<username>root</username>
 				<password>stage1</password>
 			</credential>
 		</instance> 
 	</adapter>
</RTLMExtensionAPIRegistration>
 
Note: If you have installed Rational Quality Manager on a WebSphere® Application Server, you must specify the location of the integration_config.xml file with a Java™ system property. In the WebSphere administrative console, go to Application servers >server1 > Process Definition > Java Virtual machine > Custom Properties. Add a custom property with the name com.ibm.rational.test.lm.spi.xml.location. The value of the property should be the location of your integration_config.xml file, for example C:\Program%20Files\IBM\RQM\server\integration_config.xml. You must use "%20" for spaces in the path, and ensure that the "file:///" prefix is not used.

Feedback