Rational Quality Manager Adapter

1.0 Introduction

The Danlaw Rational Quality Manager Adapter provides an interface between the MxSuite and Rational Quality Manager, the Quality Management Tool from IBM Rational. The download package comes with 2 components: “MxExtension” which is to be installed in the server computer where Rational Quality Manager is installed and “MxAdapter” which must be installed in ALL the computers where the Adapter is used.

The adapter supports “Server Rename” capability. Click here for details.

hmtoggle_plus12.0 Installation of IBM Rational Quality Manger / Collaborative Lifecycle Management

Refer to the IBM Rational website for instructions on downloading and installing the Collaborative Lifecycle Management/Rational Quality Manger.

For example:

For CLM 5.0, download is available at https://jazz.net/downloads/clm/ and installation instructions are available at http://www-01.ibm.com/support/knowledgecenter/SSYMRC_5.0.0/com.ibm.jazz.install.doc/topics/c_install_overview.html.

hmtoggle_plus13.0 Setup/Configuration

1)Create a Rational Quality Manager User ID.

2)Assign a Connector Client Access License to this User ID. Please follow the instructions as shown in https://jazz.net/help-dev/clm/index.jsp?re=1&topic=/com.ibm.jazz.repository.web.admin.doc/topics/c_license_mgmt_over.html&scope=null
hmtoggle_plus14.0 Installation of Mx-Extension

1)Download the “Adapter_Extension” zip files from Danlaw website.

2)Unzip the files into any folder in the server other than the folder where Rational Quality Manager/ Jazz Team Server is installed.

3)Copy the file danlaw.adapter.ini to the location where provision profiles are located. For example: C:\Program Files\IBM\JazzTeamServer\server\conf\qm\provision_profiles

4)Copy the path where the “Adapter_Extension” files are unzipped and update the URL path specified in danlaw.adapter.ini

For example: “url=file:C:/Mx_RQM_Adapter/MX Extension/MX Extension”

5)To reset the Rational Quality Manager server, use the Rational Quality Manager Server administrative URL:
 
https://<jazz server host>:<jazz port>/qm/admin?internal#action=com.ibm.team.repository.admin.serverReset  

6)Start the Rational Quality Manager Server and continue to work with Rational Quality Manager.
hmtoggle_plus15.0 Installation of the Mx-Adapter

1)Download the Adapter_Exe zip files from Danlaw website.

2)Unzip the files into any folder in the machine(s) where the adapter is planned to be used.

3)Run/double-click RQMAdapter.exe. This starts the Adapter application.

4)Update the Configuration Settings as specified in Configuration Details for MxAdapter.

5)Select the “Start Adapter.”

Once the Adapter is started, right click on the Adapter Icon and click Configuration Settings.

RQM1

 

1)URL = Point to the URL of Rational Quality Manager e.g.: "https://clm.danlaw.com:9443/qm"

2)Login Name = User Id of Rational Quality Manager e.g.: "user_rqm”

3)Password = Password of Rational Quality Manager e.g.: "*********".

4)Project Area = Name of the Project Area in Rational Quality Manager e.g.: "MyFirstRQMProject"

5)Adapter Name = Name of the Adapter e.g.: "Danlaw RQM Adapter Machine 1".

6)Poll Interval = Polling interval of the Adapter in Seconds e.g.: "5"

7)MxV Results Location = Path e.g.: "C:\Mxsuite"

 

Server Rename

If the server is renamed, enter the new server location in the “URL” field of the Adapter’s Configuration Settings.

Rational Quality Manager Login Credentials

Enter the Rational Quality Manager User ID in the “Login Name” field and password in the “Password” field. The password is hidden and encrypted.

Mapping of Rational Quality Manager Project Area

Enter the name of the Rational Quality Manager Project area in the “Project Area” field of the Adapter Configuration settings.

Adapter Name

Provide a unique name specific to the computer. Include details such as location, lab, and user name to make it more meaningful.

Poll Interval

The recommended default value of polling interval for the adapter is between 5-10 seconds.

Location of Results File

Provide the location in local drive where the MxSuite Test Results are to be stored temporarily.
hmtoggle_plus16.0 Using the Danlaw MxSuite Adapter in Rational Quality Manager

It is important to understand/recap the terminology used by IBM Rational Quality Manager and the MxSuite before they are integrated.

In the Rational Quality Manager – A Test Plan is an artifact used for planning the test activities. A TestCase is an artifact used for designing the test, and a Test Script is used for executing the designed test case. Test Reports can be test results plus any associated logs of the test being executed.

In MxSuite - An MxV Project (.mxp) is an artifact which stores configuration information. An MxV Scenario (.mxs) is a self-contained group of MxV TestCases, which when executed can produce a meaningful result and reports. An MxV TestCase (.mxc) is a smaller unit which can be re-used across various MxV Scenarios.

It is decided that one Rational Quality Manager TestCase shall have one Rational Manager Test Script which in turn will have one MxSuite Test Scenario. This way when a Rational Quality Manager TestCase is run, the corresponding MxSuite Test Scenario is run and the test results are fed back to Rational Quality Manager for archiving.

When a new Test Script is created, select the “Danlaw Mx Suite” type as highlighted in red, which takes you to the MxSuite interface shown below.

Click to expand.

Click to expand.

 

This is used to link the test script to an already existing MxSuite Scenario.

1.Click “Select Existing MxV Scenario”.
 
This takes you to Adapter section. If the adapter is running correctly, the Health column shows green. If not, red. If green, go to step 3 below.

2.If the Health is red, cancel this operation and restart the Danlaw MxSuite Adapter and start from Step 1 above.

3.Click “Next”.

4.Copy and paste the path where MxV Project is created to the “Project Path” and click “Get Mx Projects”.

5.A list of all the MxV projects in this path is shown. Select the relevant project and click Next.

6.A list of all the MxV Scenarios under this path is shown. Select the Scenario you wish to attach to this Rational Quality Manager Test Script.

7.Click Finish. This will take you back to the Rational Quality Manager Test Script Page.

8.Enter a name for the Rational Quality Manager Test Script and click Save.

This is used to create an MxSuite Scenario by launching MxSuite.

1.Click “Create a New MxV Scenario”.
 
This takes you to the Adapter section. If the adapter is running correctly, the Health column shows green. If not, red. If it is green, go to step 3 below.

2.If the Health column is red, cancel this operation, restart the Danlaw MxSuite Adapter, and start from Step 1 above.

3.Click Finish. MxSuite launches in a separate window.

4.Enter the Scenario Name and start creating the MxV Scenario.

5.Go back to Select existing MxV Scenario to link the Rational Quality Test Script to the newly created MxV Scenario.

This useful feature brings the MxSuite properties into the Rational Quality Manager for easy reference.

Click MxV Scenario Properties to read the MxV Scenario properties and display them in Rational Quality Manager as shown below:

Click to expand.

Click to expand.

•Click “Hide MxV Scenario Properties” to hide this screen.

•Clicking  “Show MxV Scenario Properties” again displays the MxV Scenario Properties page with cached information.

•Select “Refresh Scenario Properties” and "Show MxV Scenario Properties” to fetch the MxV Scenario properties from MxSuite again and update the display.

 

Running the Rational Quality Manager test case triggers MxSuite to execute the associated MxV Scenario. While the MxV Scenario is being executed, the execution status is updated and once MxV Scenario is fully executed, the MxV test results along with MxV test logs are fed back to Rational Quality Manager for archiving along with the associated Rational Quality Manager test case.

1.Run the selected Rational Quality Manager test case by clicking the green Run button as shown below:

Click to expand.

Click to expand.

2.Select “Danlaw Mx Adapter.”

3.If the adapter is running correctly, the Health column shows green. If not, red. If green, go to step 5 below.

4.If the Health column is red, cancel this operation, restart the Danlaw MxSuite Adapter, and start from Step 1 above.

5.Click Finish to launch the MxSuite and the corresponding MxV Scenario.
 
While the MxV Scenario is being executed, the execution progress bar is updated. Once MxSuite executes the Scenario & test results are generated, the progress bar reaches 100%.

6.Click Show Results – Result Details. This provides the overall test result of the executed Scenario.

7.Click the PDF file to open the detailed MxV report in a new window.

8.Click .mxlog file.

9.Provide the location to save the .mxlog file.