The IBM Rational Quality Manager “How do I” covers: (Last updated  12-Nov-09)

Table of Contents

The IBM Rational Quality Manager “How do I” covers: (Last updated  12-Nov-09) 1

Table of Contents. 1

General.. 1

1.       How do I – understand the links from RQM defects cause RQM application to reload main page. 1

2.       How do I – understand tha Silent/Non-graphical install of Rational Quality Manager 2.0 on AIX.. 3

3.       How do I – understand about Rational Quality Manager 2.0 iFix001. 4

4.       How do I – understand that opening test suite results in "The tab for this failed to load" error. 5

5.       How do I – understand the availability of new Rational product training modules. 6



1.            How do I – understand the links from RQM defects cause RQM application to reload main page

When an RQM defect is created, it may contain links to test artifacts such as Test Cases or Execution Results. Clicking on these links may cause the RQM application to reload in the same browser tab, which closes any other pages that the user has open.



Clicking on a link from an RQM defect causes the RQM page you are looking at to be replaced with the test artifact you selected opened in a new RQM instance.



The interface to RTC from RQM does not allow sufficient customization of the links in the work item editor for RQM to program the desired behavior.


Diagnosing the problem

If you click on an available link from an RQM defect, such as one of those shown below, that page is displayed but your previously open RQM tabs are no longer displayed.


Resolving the problem

Instead of clicking directly on the Link, right-click in order to open the context menu as shown. Then you can choose to open the test artifact in either a new browser window or a new browser tab instead of losing your existing RQM instance.



Related information Defect 17601




2.            How do I – understand tha Silent/Non-graphical install of Rational Quality Manager 2.0 on AIX

IBM Installation Manager can be used to perform a silent install of IBM Rational Quality Manager 2.0 on any supported platform. This document outlines the details of performing a silent install on the IBM AIX operating system. Silent installs are useful in an AIX environment when the prerequisites for a graphical install cannot be met.



Before installing Rational Quality Manager on a system running the AIX operating system, please ensure the following prerequisites are met:

1.     Rational Quality Manager installation image

Depending on how the install image is obtained (CD image, download from, download from Passport Advantage, etc), there should be a minimum of two directories in your install image: RQM_SETUP and RQM. Verify you have these directories.

2.     A silent install response file 

Response files contain the information normally provided in Installation Manager's graphical interface and should be customized for the location that you have downloaded Rational Quality Manager and the location you want to install to. Below is a sample of a response file which can be used to install Rational Quality Manager to its default location. It assumes the Rational Quality Manager images are in the /tmp/rqm directory on the AIX system.

<?xml version="1.0" encoding="UTF-8"?>
<agent-input acceptLicense='true'>
<repository location='/tmp/rqm/RQM/disk1'/>
<profile installLocation='/opt/IBM/RQM20' id='IBM Rational Quality Manager 2.0'>
<data key='eclipseLocation' value='/opt/IBM/RQM20'/>
<data key='' value='en'/>
<install modify='false'>
<offering profile='IBM Rational Quality Manager 2.0' features='' id=''/>
<preference value='/opt/ibm/IBMIMShared' name=''/>
<preference value='30' name=''/>
<preference value='30' name=''/>
<preference value='0' name=''/>
<preference value='true' name='offering.service.repositories.areUsed'/>
<preference value='false' name=''/>
<preference value='false' name=''/>
<preference value='true' name=''/>
<preference value='false' name='PassportAdvantageIsEnabled'/>
<preference value='false' name=''/>

o    Repository location should refer to the location of the RQM/disk1 directory in the image.

o    installLocation and eclipseLocation should refer to where Rational Quality Manager should be installed.

o should refer to the language support to install. The response file can be placed anywhere on the AIX system.

Installation Procedure

These instructions assume that the Rational Quality Manager image was unzipped in /tmp/rqm and that the response file is /tmp/rqm/rqm_silent_install.xml. IBM Installation Manager has many options for logging or displaying different levels of output or logging. This example will show the most output. See below for a complete reference to silent install commands and flags.

4.     Make RQM_SETUP/InstallerImage_aix your current directory (e.g. /tmp/rqm/RQM_SETUP/InstallerImage_aix).

5.     Run the following command:

§  ./install --launcher.ini silent-install.ini -log -showVerboseProgress -input

§  Example:

./install --launcher.ini silent-install.ini -log /tmp/rqm_inst_log -showVerboseProgress -input /tmp/rqm/rqm_silent_install.xml

6.     The installation will run and provide status messages. After installation, Rational Quality Manager can be started normally.

See Installation Manager Silent Installation Reference for more information.

3.            How do I – understand about Rational Quality Manager 2.0 iFix001

Installing Rational Quality Manager 2.0 iFix001

You can install this iFix using the Update Packages wizard in the IBM Installation Manager. By default, the iFix is installed directly from the IBM update repository. However, it is also available for download on the Jazz Community web site and at the bottom of this page.

Follow these steps to download and install this upgrade to Rational Quality Manager:

1.     Download the Rational Quality Manager and Rational Test Lab Manager zip file from the All Downloads tab on the Jazz Community web site or from the bottom of this page.

2.     Extract the contents of the downloaded zip file to a directory called "updatesite."

3.     Run the IBM Installation Manager.

4.     Select Preferences from the Install Manager File menu. On the Repositories page, click the Add Repository button, browse to the directory (e.g., "updatesite") that you created in Step 2, and click OK. Check the box for the new location and click OK.

On the main Installation Manager menu, click the Update icon to proceed with the upgrade installation


See the Rational Quality Manager and Rational Test Lab Manager 2.0 iFix1 - Release Notes for links to the work items that were addressed in this release (listed below):

Work Item



Performance - test suite execution polls once per second, fetching a large amount of data.


Remove vega:id attributes from resource XML when ?metadata=UUID is not specified


LOCK and UNLOCK support in the REST API for testplan, testcase, testscript


Trim the amount of data returned at the Test suite console during polling operation.


RTM migration: Computer lists fail to migrate


After migration to gm - java exception - missing executionwork_obj.gif doesn't exist


Clicking on Print option for completed Manual Executions give error


Need to prevent floating license combination with functional cal


TypeError _57 is undefined when creating TERs


Updating a Lab resource Changes its Internal Id


Error 500 when attempt to import in a custom quality objective


Renaming a section in a Test Plan doesn't work


RQM does not handle included Build Forge environments


Exception while printing some Manual Test Scripts to PDF


Large data request to RQM REST service result in RQM server memory leak


NullPointerException being thrown from Requirements 'isArchived' API


Test plan cannot be imported when migrating from to 2.0


ClassCastException encountered when migrating repository into RQM 2.0


Repotools import results in two Risk Assessment fields for any existing Project Area


errors saving test plan indicating ADMIN has modified this item when no one else is in it


Using repotools to move server fails with: CRJAZ1150I ** ERROR ** Duplicate permissions operation id specified:


The build record and definition created in RTC can't be tracked in RQM


Pasted MS Word content causes raw/tagged content in PDF


RQM REST API should return OSLC links to WIs


RTC-Int:IE: Unable to input to the fields in "Add Existing Defect" popup window if it's not opened at the first time


Error 500 shows during print history.


Printing a Requirement generates an HTTP 500 error


qm.xsd can't be exported by REST API

Known problems are documented in the form of individual technotes in the Support knowledge base at Rational Quality Manager Support. As problems are discovered and resolved, the knowledge base is updated. By searching the knowledge base, you can quickly find workarounds or solutions to problems.

The following links open customized queries of the live Support knowledge base:

View all known problems resolved in Rational Quality Manager Version 2.0


4.            How do I – understand that opening test suite results in "The tab for this failed to load" error

Attempts to open a Test Suite using IBM Rational Quality Manager client results in the error "Unable to retrieve the specified test suite."



The full error message is as follows:

Unable to retrieve the specified test suite. The tab for this failed to
load  .
artifact will be closed.
CRJAZ0215I Item not found:
l@24342434 (staeID: [UUD_LxyjV5hdEd61X5WsHaOK3Q],
itemID: [UUID_lxfoUJhdEd61X5WsHaOK3Q],origin:,immutable:)

You might observe the problem after you upgraded Microsoft SQL Server 2005 from SP3 to SP4.



This issue has been identified as a product defect under APAR PK98288


Resolving the problem

There is no workaround.


5.            How do I – understand the availability of new Rational product training modules

Here is a list of the most recent IEA training modules that have been published to the Web. These are multimedia education modules designed to help you gain a better understanding of IBM software products and use them more effectively to meet your business needs.

How to create a Struts-Tiles application using IBM Rational Application Developer 7.5.3 and WebSphere Application Server 6.1

Step One: How to create a J2EE project and add the Struts capabilities

Step two: How to create a default page

Step three: How to add the tiles functionality

Step four: How to create a layout file

Step five: How to add the tiles definitions

Step six: How to create the needed jsp files

Step seven: How to create the three action mappings

Step eight: How to create an action forward with the name you set in the default page

Step nine: How to edit the action classes

Installation Manager for Rational Application Developer

Installing Rational Application Developer V 7.5 with updates and permanent licenses

Updating an existing installlation of Rational Application Developer V 7.5 to the latest version

Importing a Product Activation kit to convert a product license from trial to permanent

Rational Business Developer

Creating an EGL Web project

Rational Quality Manager

How to set up Rational Quality Manager as a service with the Derby Database


Configuring TestManager DB2 Backend for UCM Source Control

Configuring and using a RequisitePro project for baselining under ClearCase UCM

Additional IEA modules can be found here

This website is published "as is". There is no warranty of any kind (express or implied) as to the operation of our site, the accuracy of the information or the services or products referred to on it. All warranties are excluded as far as permitted at law. Neither we nor any third party will be liable for any losses or damage that may result from use of the website or as a consequence of any inaccuracies in, or any omissions from, the information which it contains.