Debugging instructions for RQM/ETM adapter

You need to configure the property file in Rational® Test RealTime to update the debug log-in instructions for the use of the IBM® Rational® Quality Manager (RQM) or IBM® Engineering Test Management (ETM) adapter.

Before you begin

You must have administration rights to edit the log4j.properties or log4j2.xml file.

Procedure

  1. Browse to Rational® Test RealTime installation files: <install location>/RQMAdapter/TestRTAdapter/.
  2. Proceed as follows depending on the version of Rational® Test RealTime that you are using:
    • For an integration of IBM® Rational® Quality Manager (RQM) with Rational® Test RealTime up to version 8.3.1:
      1. Edit the log4j.properties file.
        In the log4j.properties file, you find the following lines (lines 28 to 30): 
        #log4j.logger.com.ibm.rqm.adapter.library=DEBUG
#log4j.logger.com.ibm.rqm.adapter.testrt=DEBUG
log4j.logger.com.ibm.rqm.adapter.testrt=INFO
      2. Uncomment the two first lines (lines 28 and 29) and comment out the last one (line 30) as follows:
        log4j.logger.com.ibm.rqm.adapter.library=DEBUG
log4j.logger.com.ibm.rqm.adapter.testrt=DEBUG
#log4j.logger.com.ibm.rqm.adapter.testrt=INFO
    • For an integration of IBM® Engineering Test Management (ETM) with Rational® Test RealTime8.3.2:
      1. Edit the log4j2.xml file.
        In the log4j2.xml file, you find the following lines (lines 40 to 45): 
        <!--
<Logger name="com.ibm.rqm.adapter.library" level="INFO"/>
<Logger name="com.ibm.rqm.adapter.commandline" level="INFO"/>
<Logger name="com.ibm.rqm.integration.client.clientlib" level="ERROR"/>
-->
<Logger name="com.ibm.rqm.adapter.testrt" level="INFO"/>
      2. Uncomment the first line and update the uncommented lines as follows:
        <Logger name="com.ibm.rqm.adapter.library" level="DEBUG"/>
<!--
<Logger name="com.ibm.rqm.adapter.commandline" level="INFO"/>
<Logger name="com.ibm.rqm.integration.client.clientlib" level="ERROR"/>
-->
<Logger name="com.ibm.rqm.adapter.testrt" level="DEBUG"/>