IBM Support

Enable debug logging of DevOps Test UI adapter for Engineering Test Management

Question & Answer


Question

How do you enable debug logging for the IBM Rational Functional Tester/DevOps Test UI adapter for IBM Engineering Test Management (ETM) for the Functional Test perspective?
 

Answer

For Rational Functional Tester releases prior to 10.5

  1. Go to the RQM adapter directory, which is typically located in this location:
    C:\Program Files\IBM\SDP\FunctionalTester\RQMAdapter
  2. Paste the log4j.properties file into the adapter directory: log4j.properties (1KB)
  3. Edit the configureadapter.bat file, which is typically located in the same folder
  4. Search for this string:
    start "" %RFT_ARG_JRE% -classpath %RFT_INSTALL_DIR%\rational_ft.jar com.rational.test.ft.RQMAdapterConfigure %*
  5. Add the property "-Dlog4j.configuration=file:./log4j.properties" to the string, like this:
    start "" %RFT_ARG_JRE% -Dlog4j.configuration=file:./log4j.properties -classpath %RFT_INSTALL_DIR%\rational_ft.jar com.rational.test.ft.RQMAdapterConfigure %*

For Rational Functional Tester releases 10.5-10.5.4 and DevOpsTest UI 11.0 and later

  1. Go to the RQMAdapter directory, by default at this location:
    For Rational Functional tester:
     C:\Program Files\IBM\SDP\FunctionalTester\RQMAdapter

    For DevOps Test UI:
    C:\Program Files\IBM\DevOpsTest\FunctionalTester\RQMAdapter
  2. Paste the log4j2.xml file into the adapter directory: log4j2.xml (2KB) 
  3. Locate the following jars in your RFT installation:
    • commons-logging-1.2.jar
    • log4j-api-2.17.1.jar
    • log4j-core-2.17.1.jar
    • log4j-jcl-2.17.1.jar
  4. These should all be found in the same directory, by default:

    C:\Program Files\IBM\IBMIMShared\plugins\com.ibm.rqm.integration.client_<version>\lib

    NOTE: The version section of the path will vary according to your RFT/DevOps Test UI version.

  5. Copy those jar files to the adapter directory.
  6. Edit the configureadapter.bat file.
  7. Search for this command string:
    start "" %RFT_ARG_JRE% -classpath %RFT_INSTALL_DIR%\rational_ft.jar com.rational.test.ft.RQMAdapterConfigure %*
  8. Replace that command with this one:
    start "" %RFT_ARG_JRE% -Dlog4j2.configurationFile=.\log4j2.xml -classpath .\log4j-api-2.17.1.jar;.\log4j-core-2.17.1.jar;.\log4j-jcl-2.17.1.jar;.\commons-logging-1.2.jar;%RFT_INSTALL_DIR%\rational_ft.jar com.rational.test.ft.RQMAdapterConfigure %*

Start the adapter by using "Configure Adapter" option in the start menu or by using configureadapter.bat from the command line. You must start the adapter via configureadapter.bat or you will not pick up the changes you made to the start arguments and you will not see the logging info.

Collect the generated adapter logs from the adapter directory. The log file will be RftAdapter.log or dtui_ft_etmAdapter.log, depending on your version.

Disclaimer

All source code and/or binaries attached to this document are referred to here as "the Program". IBM is not providing program services of any kind for the Program. IBM is providing the Program on an "AS IS" basis without warranty of any kind. IBM WILL NOT BE LIABLE FOR ANY ACTUAL, DIRECT, SPECIAL, INCIDENTAL, OR INDIRECT DAMAGES OR FOR ANY ECONOMIC CONSEQUENTIAL DAMAGES (INCLUDING LOST PROFITS OR SAVINGS), EVEN IF IBM, OR ITS RESELLER, HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

[{"Type":"MASTER","Line of Business":{"code":"LOB59","label":"Sustainability Software"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSUVV6","label":"IBM Engineering Test Management"},"ARM Category":[{"code":"a8m50000000CjBdAAK","label":"ELM Test Management-\u003EExecution Framework-\u003ERFT Adapter - Rational Functional Tester"}],"ARM Case Number":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"All Versions"}]

Product Synonym

Rational Quality Manager

Document Information

Modified date:
26 February 2024

UID

swg21597847