IBM Support

When upgrading to Rational DOORS version 9.5, use the same host name for the Rational Quality Manager integration

Technote (troubleshooting)


Problem(Abstract)

When you migrate IBM Rational Quality Manager integration data after upgrading from Rational DOORS version 9.3 to version 9.4 or later, the host name and port number of the Rational Quality Manager application must match exactly with the entries in the QM provider configuration in Rational DOORS and also the entries in the configuration files of exported data that is generated by the point-to-point integration.

Symptom

Steps to reproduce the problem:

  1. Upgrade to Rational DOORS version 9.4 or later and a compatible version of Rational Quality Manager version 3.0.1 or later.
  2. Register Rational DOORS to consume and provide OSLC services with Rational Quality Manager.
  3. Log in to Rational DOORS as Administrator and click RQMI and select Migrate.

Note: This migration moves data from the Rational Quality Manager point-to-point integration that was used in Rational DOORS version 9.3 to the OSLC-based integration that is used in Rational DOORS version 9.4 and later and in Rational Quality Manager version 3.0 and later.


Result: The migration validation failure message is displayed. The log file has the error details, as described in the Symptom section above. The migration user interface has a column that lists the host name of the data to be migrated. You should make note of the host name.


Migration validation has failed for some/all views. Please check validation log file for more details.

The detail of the failure is logged in the log file, which can be found in the folder <DOORS_home_directory>/RQMInterface/Migration.

The full error message is as follows:

Either RQM Host/Port rqm.example.ibm.com/9443 is not configured in DOORS DB or incompliant OSLC Version. Migration is supported only for OSLC V2.0 RQM Server. The domain name of root services uri, service provider url and the testplan url in the rqmi configuration file should exactly match. "DomainName.ibm.com" is not equal to "DomainName". Domain names are case sensitive. To update the domain in the RQMi configuration file, Administrator can use the dxl api "updateRQMIConfFile(moduleId, viewId, newDomainName, newPort) or updateAllRQMIConfigFiles(newDomainName, newPort)" Corresponding Module Id {0001d562} and ViewId {0}


Cause

The host name of Rational Quality Manager does not match exactly with the host name of QM configuration in Rational DOORS or in the configuration files of exported data generated by the point-to-point integration.


Resolving the problem

Verify that the host name in the public URI of Rational Quality Manager exactly matches with the host name of QM provider configured in DOORS and point-to-point integration configuration files.


Here is an example of the public URI of Rational Quality Manager application:


The host name and port in the above picture should exactly match the following entries:

  • QM provider configuration in Rational DOORS



  • Point-to-point integration export configuration files. This can be checked by executing the migration tool, which lists the host names of the data to be migrated.


Note: The host name must match exactly. "DomainName.ibm.com" is not equal to just "DomainName" or IP Address. Domain names are case sensitive.

To update the QM provider host name and port number in Rational DOORS:

  1. Log in to Rational DOORS as a database manager or a custom user who has the power to manage the database, and open the database properties.
  2. In the Rational DOORS database properties, select the Remote Services tab.
  3. If necessary, edit the remote services entry for Rational Quality Manager to include the correct host name and domain for the root services. For example, https://rqm.example.com:9443/qm/rootservices.
  4. Add the RQM project area under the collaboration Links section.

To update the host name and port number in point-to-point integration configuration files, run the following Rational DOORS DXL perms as the Administrator user:
  • bool updateRQMIConfFile(string moduleId, string viewId, string newRqmDomainName, string newRqmPort)
    This updates the configuration file of the given module and view combination.
    The module ID and view ID can be obtained from the log file, as described in the Symptom section above.
  • bool updateAllRQMIConfFiles(string newRqmDomainName, string newRqmPort)
    This updates the configuration files with the new RQM domain name and port.

Both of the DXL Perms must include the following headers:
#include <rqmi/migration/migrationConfig.inc>
#include <rqmi/migration/generalLibrary.inc>

You can now rerun the data migration in Rational DOORS.

Document information

More support for: Rational DOORS
Integrations: IBM

Software version: 9.5

Operating system(s): Windows

Reference #: 1617880

Modified date: 21 November 2012