Configuring Rational Quality Manager for the Tivoli Provisioning Manager Adapter

The IBM® Tivoli® Provisioning Manager adapter populates the IBM Rational® Quality Manager database with lab resource data from Tivoli Provisioning Manager. To use this feature, you must acquire and configure the Rational Quality Manager-Tivoli Provisioning Manager provisioning adapter.

About this task

To configure the Rational Quality Manager-Tivoli Provisioning Manager adapter:

Procedure

  1. Extract the Rational Quality Manager-Tivoli Provisioning Manager adapter file, com.ibm.tivoli.tpm.rtlm.spi.zip, to RQM install\server where RQM install is the folder into which you installed Rational Quality Manager, for example C:\Program Files\IBM\RQM20.
  2. Edit the integration_config.xml file in the RQM install folder and complete the following steps.
    Important: To avoid losing configuration information, save the original integration_config.xml file in the server folder as a backup.
    1. Add a new adapter definition for the Tivoli Provisioning Manager server as follows:
      <adapter>
      		<name>TPM RTLM Integration Adapter</name>
      		<version>1.0</version>
      		<APIVersionSupported>1.0</APIVersionSupported>
      		<inventoryExtensionId>com.ibm.tivoli.tpm.rtlm.spi.inventory.TPMInventorySPI</invent
      		oryExtensionId>
      		<automationExtensionId>com.ibm.tivoli.tpm.rtlm.spi.automation.TPMAutomationSPI</aut
      		omationExtensionId>
      		<pluginId>com.ibm.tivoli.tpm.rtlm.spi</pluginId>
      		<instance>
      				<instanceId>TPMAdapter</instanceId>
      				<hostname>hostname.domain.ibm.com</hostname>
      				<port>portnumber</port>
      				<offline>FALSE</offline>
      				<credential>
      						<username>tpm_username</username>
      						<password>tpm_password</password>
      				</credential>
      				<extendedInfo>
      						<name>discovery_ip_range_start</name>
      						<value>starting_ip_range</value>
      				</extendedInfo>
      				<extendedInfo>
      						<name>discovery_ip_range_end</name>
      						<value>ending_ip_range</value>
      				</extendedInfo>
      				<extendedInfo>
      						<name>discovery_user_name</name>
      						<value>discovery_username</value>
      				</extendedInfo>
      				<extendedInfo>
      						<name>discovery_user_password</name>
      						<value>discovery_password</value>
      				</extendedInfo>
      		</instance>
      </adapter>
    2. Change the following fields to match your environment:
      • <instanceId>: Enter an identifier for the adapter.
      • <hostname>: Enter the fully qualified Tivoli Provisioning Manager host name.
      • <port>: Enter the port number of your Tivoli Provisioning Manager server. The default port number is 8777.
      • <username> and <password>: Enter the Tivoli Provisioning Manager user ID and password.
      • In the <extendedInfo> section for <value>, enter the appropriate IP address ranges for discovery and enter a user ID and password. The user ID and password entered here are the credentials that Tivoli Provisioning Manager uses to access the discovered resources.
    3. Save the file.
  3. If you have installed Rational Quality Manager on IBM WebSphere® Application Server, 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. Make the value of the property 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.
  4. Reset the Rational Quality Manager server so that this adapter is deployed on the next time 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 you restart the server, the Tivoli Provisioning Manager adapter is deployed. You can open the Rational Quality Manager console and use this new function.

Feedback