IBM Support

Collecting Data: Solving Rational Quality Manager issues

Technote (troubleshooting)


This technote provides you with information about IBM Rational Quality Manager (RQM) for resolving issues in a timely fashion. It requires gathering certain technical data and sending them along with business impact justifications to IBM so they can be prioritized correctly and efficiently.

Resolving the problem

Rational Quality Manager data needed for IBM Support

Here is the short list of what must be acquired. Additional information might be requested depending on the situation at the time.

  1. Log files to gather
  2. Versions of applications
  3. Jazz.Log and other info needed
  4. Additional reference information

Log files to gather
  1. Location of the logs might differ depending on installed product, but they are always located in the server installation directory, referenced thereafter as <server_install_dir>.
  2. In order to get a "clean picture", rotate the logs.
    1. Stop the server
    2. Copy <log_file>.log <log_file>.log.old
    3. Start the server
Rational Quality Manager & Webserver.log or logs
    If You are using Tomcat, the Rational Quality Manager logs are in '<RQM>/server/' - all files starting with rqm.log (rollovers will have a .1, at the end).

    Tomcat logs are in '<RQM>/server/tomcat/logs' - all files.

    IBM WebSphere Application Server
    If You are using IBM WebSphere Application Server, the Rational Quality Manager logs are in:


    All files starting with rqm.log (rollovers will have a .1, at the end).

    WebSphere Application Server logs are in:


    All files ending with .log

Version and names of the following applications (including fixes if present)
  • Browser
  • Operating System (OS) for the client
  • Rational Quality Manager
  • Server OS
  • Database
  • Applications that integrate with Rational Quality Manager (if this applies)

    <server_install_dir>server\server\logs\jazz.log (RTC/RRC install)
    <server_install_dir>server\server\tomcat\logs\jazz.log (other install)
    Example: copy jazz.log to jazz.log.old

    Team server properties file (rename it - for example:

    Information about the error

    1. Provide screen shots of the error.
    2. Include full text of the error message.
    3. Step or steps leading to error.
    4. What were you attempting to execute up to the error/situation?

    Rational Requirements Composer and/or CLM (If this applies)

    Rational Requirements Composer Server (if Rational Requirements Composer is involved)
    <server_install_dir>server/conf/rdm/friendsconfig.rdf (rename it - example: friendsconfig_RDM.rdf)

    [Rational Requirements Composer] rdm.log
    located in <server_install_dir>server\server\logs\rdm.log

    [CLM Product] Server configuration files
    Depending on installed product, configuration files are located in:
      • [RTC/RQM] <server_install_dir>conf/jazz/
      • [Rational Requirements Composer] <server_install_dir>conf/rrc/
    Referenced thereafter as <server_conf_dir>:
      <server_conf_dir>friendsconfig.rdf(rename it - ex: friendsconfig_<product_name>.rdf)
      <server_conf_dir>services.xml(rename it - ex: services_<product_name>.xml)
      <server_conf_dir> it - ex: teamserver_<product_name>.properties)

    Business Impact
    1. Is this a production or testing environment?
    2. How many users are affected?
    3. Is the server completely down and or only certain components giving the issue?
    4. Please add any additional comments?

Additional reference information

Related information

1443299 Simplified Chinese translation

Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational Project Conductor General Information Windows 1.0
Software Development Rational Quality Manager General Information Windows 1.0, 1.0.1, 2.0, 2.0.1
Software Development Rational Requirements Composer General Information Windows 1.0, 2.0
Software Development Rational Team Concert General Information Windows 1.0, 1.0.1, 2.0

Document information

More support for: Rational Quality Manager
General Information

Software version: 2.0,,, 2.0.1

Operating system(s): Solaris, Windows

Reference #: 1438403

Modified date: 03 August 2010

Translate this page: