Configuring Rational Quality Manager for the Tivoli Application Dependency Manager Adapter

The IBM® Tivoli® Application Dependency Manager adapter reads information about lab resources that the application discovers and populates the IBM Rational® Quality Manager database with this information. To take advantage of this feature, you must acquire and configure the Rational Quality Manager-Tivoli Application Dependency Manager inventory adapter.

About this task

To configure the Rational Quality Manager-Tivoli Application Dependency Manager adapter:

Procedure

  1. Install Rational Quality Manager. The default installation directory is C:\Program Files\IBM\RQM20. The steps in this task refer to this location as rqm_install_dir.
  2. Acquire the Rational Quality Manager-Tivoli Application Dependency Manager inventory adapter (RQMLM_TADDM_Adapter.zip). Extract the .zip file to a temporary location.
  3. Copy the Tivoli Application Dependency Manager update site directory, taddm-rqm-update-site, from the temporary location to rqm_install_dir\server\.
  4. Copy the taddm-profile.ini file in the temporary location to rqm_install_dir\server\conf\jazz\provision_profiles\.
  5. On the server that runs Rational Quality Manager, create a directory, for example C:\ibm\sdk.
  6. Copy the etc folder and the TaddmNormalization.xml file from your temporary location to the folder you created. In the code in step 7, the etc folder and the TaddmNormalization.xml file are in the C:\ibm\sdk folder.
  7. Edit the integration_config.xml file in rqm_install_dir\server\ and add a new adapter definition for the Tivoli Application Dependency Manager inventory adapter. Copy the text from this example into the XML file.
    <adapter>
    	<name>TADDM RTLM Integration Adapter</name>
    	<version>1.0</version>
    	<APIVersionSupported>1.0</APIVersionSupported>
    	<inventoryExtensionId>com.ibm.tivoli.taddm.rtlm.spi.inventory</inventoryExtensionId>
    	<pluginId>com.ibm.tivoli.taddm.rtlm.spi</pluginId>
    	<instance>
    		<instanceId>TADDMadapter</instanceId>
    		<hostname>hostname.domain.ibm.com</hostname>
    		<port>portnumber</port>
    		<offline>FALSE</offline>
    		<credential>
    			<username>taddm_username</username>
    			<password>taddm_password</password>
    		</credential>
    		<property>
    			<name>com.collation.home</name>
    			<value>C:\ibm\sdk</value>
    		</property>
    		<debug>false</debug>
    		<extendedInfo>
    			<name>discovery</name>
    			<value>rtlmwin</value>
    		</extendedInfo>
    	</instance>
    </adapter>
  8. Modify the following fields to match your environment:
    1. <instanceId>: Enter an identifier for the Tivoli Application Dependency Manager inventory adapter.
    2. <hostname>: Enter the fully qualified Tivoli Application Dependency Manager host name.
    3. <port>: Enter the port number of the Tivoli Application Dependency Manager server. The default is 9530.
    4. <username> and <password>: Enter the Tivoli Application Dependency Manager user ID and password. Add SSL and port information in this section, if required.
    5. In the <property> sections for <value>, enter the path that you created in step 5.
    6. <debug>: This displays debug information in the Tomcat console. Entering true turns debug on.
    7. In the <extendedInfo> section for <value>, enter the name of the discovery scope defined on the Tivoli Application Dependency Manager server.
    8. Save the integration_config.xml file.
  9. If you have installed Rational Quality Manager on IBM WebSphere® Application Server, you must specify the location of the integration_config.xml file with a Java system property:
    1. In the WebSphere Administrative Console, go to Application servers > server1 > Process Definition > Java Virtual Machine > Custom Properties.
    2. Add a custom property with the name com.ibm.rational.test.lm.spi.xml.location. The value of the property is the location of your integration_config.xml file, for example c:\Program%20Files\IBM\RQM20\server\integration_config.xml. The file:/// prefix is not used.
  10. Reset the Rational Quality Manager server so that this adapter is deployed the next time that you restart the server.
    1. In a browser, enter https://localhost:9443/jazz/admin?internal#action=com.ibm.team.repository.admin.serverReset
    2. Click Request Server Reset, and then log out.
    3. Stop and start the Rational Quality Manager server. When the server is restarted, the Tivoli Application Dependency Manager adapter is deployed. You can now open the Rational Quality Manager console and use this new function.

Feedback