Easily synchronize data between Rational DOORS and HP Quality Center

Just follow these steps to install the IBM Rational DOORS for HP Quality Center Interface

IBM® Rational® DOORS® for HP Quality Center Interface, Version 3.5, helps you synchronize Rational requirements data and HP testing process data. This article tells you how to install and configure the interface.

Share:

Guru Prasad Ramesh (gururprasad@in.ibm.com), Staff Software Engineer, IBM

Author1 photoGuru Prasad Ramesh has worked with IBM Rational DOORS software for the past year and has more than six years of experience in the IT industry. His areas of interest include cloud computing and Open Services Lifecycle Collaboration (OSLC). He loves listening to music, watching movies, and playing cricket.



02 August 2011

Also available in Chinese

Overview of the Rational DOORS for HP Quality Center Interface

With the IBM® Rational® DOORS for HP Quality Center Interface, you can synchronize data between the Rational DOORS requirements management software and HP Quality Center, an integrated enterprise application for organizing and managing the entire testing process. You can transfer requirements in Rational DOORS to an HP Quality Center project and transfer tests and defects between the two applications. You can also access Rational DOORS requirements information by using your HP Quality Center Interface (QCI) and access HP Quality Center test and defect information by using your Rational DOORS interface.

System requirements

Operating systems that QCI 3.5 supports:

  • Windows Server 2003 R2 (Standard or Enterprise) 32-bit. IIS 6.0 must be running with ASP.NET v2.0 enabled.
  • Windows Server 2008 (Standard or Enterprise) 32-bit. IIS 7.0 must be running in IIS 6.0 compatibility mode, with ASP.NET v2.0 enabled.

Operating systems that QCI 3.5 supports:

  • A Rational DOORS version 9.2 or later database server must be installed.
  • An HP Quality Center server version 10.0 must be installed on any machine.

Architecture of the interface

The Rational DOORS for HP Quality Center Interface comprises three primary components, as depicted in the diagram in Figure 1:

  • Integration server
  • IAS admin (integration administration console)
  • Integration client
Figure 1. Quality Center Interface, enterprise system
IS synchronizes data between two applications.

Integration server

This is the main component that is responsible for the transfer and synchronization of data between the two applications. It a web service-based component that is deployed through a Microsoft IIS server. The integration server component should be installed on Microsoft Windows 2003 and Windows 2008 Server with IIS v6.0.

IAS Admin (integration administration console)

IAS Admin, or administration console, provides an interface for creation, execution, modification of synchronization tasks. A synchronization task specifies what data needs to be synchronized.

Integration Client

The Integration Client is a Rational DOORS component for these purposes:

  • Synchronization
  • Running reports on the test cases
  • Analyzing the results

Install Rational DOORS

To install Rational DOORS, first install the server and then the client.

Install the Rational DOORS server, version 9.2 and 9.3

  1. Run the Rational DOORS server setup.exe file.
  2. Click the Next button and accept the license server agreement.
  3. For Setup Type, select Typical, and then click Next.
  4. Enter the Database Port number, usually 36677.
  5. Click Install.

Note:
You can install the DOORS server on a non-Windows platform too.

Install the Rational DOORS client, version 9.2 and 9.3

  1. Run the Rational DOORS server setup.exe file.
  2. Click Next, and accept the license server agreement.
  3. For Setup Type, select Typical, and then click Next.
  4. In the Database Port field, type 36677. This number is the port number that is used to install the server.
  5. In the Database Host field, type either the IP address or the fully qualified host name of the machine on which the Rational DOORS server is installed, as shown in Figure 2.
Figure 2. Database port number and host name for the server
Enter DOORS Database Settings window
  1. On the License Information page (Figure 3), enter license server details in this format: PortNumber@IPAddress
    where PortNumber is the port number of the license server IPAddress is the IP address of the machine on which the Rational DOORS license server is installed
Figure 3. License server details
Information added as described
  1. Click Next to finish the client installation.

Run the installer

Before you begin

Create a separate group (for example: QCI_Admin_Console_Users) with administrative privileges for DOORS-QC integration.

  • It is best not to use the Windows "Administrators" group. This group will be used by the integration server to validate whether a user can access the integration Administration Console.
  • It is best to have a dedicated user (for example: IWSUSER) for the integration. This user account will be used as the identity of the DOORSQCIntegrationApplicationPool. You can either create a user manually with Admin privileges or choose to create the user when you run the Set Access Permissions Wizard post installation.
  • If you choose to create IWSUSER manually, ensure that Password is in compliance with Windows security policy for the network. Set the Password never to expire and that the user does not have to change the password during first login.
  • IWSUSER should be a part of Administrators group, QCI_Admin_Console_Users group and IIS_WPG group.

If you are installing the integration server on Windows Server 2008, you must set IIS7 to use IIS6 compatibility mode.

To set IIS7 to use IIS6 compatibility mode:

  1. Install the IIS 6.0 Management Compatibility Components in Windows Server 2008 R2 or in Windows Server by using the Server Manager tool:
  2. Click Start > Administrative Tools > Server Manager.
  3. In the navigation pane, expand Roles, right-click Web Server (IIS), and then click Add Role Services.
  4. In the Select Role Services pane, scroll down to IIS 6 Management Compatibility. Click to select the IIS 6 Metabase Compatibility and IIS 6 Management Console check boxes.
  5. In the Select Role Services pane, click Next, and then, at the Confirm Installations Selections pane, click Install.
  6. Click Close to exit the Add Role Services wizard.

Install the Rational Quality Center Interface and client

To install Rational Quality Center Interface, first install the server, and then the client.

  1. Install the Rational Quality Center Interface server, version 3.5, on Windows Server 2003 or Windows Server 2008:
  2. Run the Rational Quality Center Interface setup.exe file.
  3. Click Next and accept the license server agreement.
  4. For Setup Type, select Server and click Next, as shown in Figure 4.
Figure 4. Setup Type selection window
Two options: Client, Server, with Server selected
  1. Enter IIS Port (usually, the port number given is 80), and click Next.
  2. Enter the Domain and Group names, and then click Next and Install as Figure 5 shows.
Figure 5. Group and domain name
Authorization to access Administration Service

Configure the Rational Quality Center Interface

  1. Launch the Set Access Permission wizard by selecting All Programs > IBM Rational > IBM Rational Tools > IBM Rational DOORS for HP Quality Center Interface 3.5 Tools > Set Access Permission.
  2. Enter the name of the user (recommended: use local user named IWSUSER in ServerName\Username format).
  3. If you haven't created the user and want the wizard to create the one, check the box for "If the account doesn't exist, would you like the configuration tool to attempt to create the account?"
  4. Click Next, as shown in Figure 6.
Figure 6. Gather user credentials
Screen to enter username and password

The Rational DOORS Quality Center Integration allows configuring the integration only with the default website.

  1. Specify the location of virtual directories for the virtual folder. Default locations are already filled in, but if you have installed the integration on a different location, specify that and click Next, as shown in Figure 7
Figure 7. Gathering virtual folder structure
Enter location of virtual folder for the services
  1. Click Yes to configure the server.
  2. When Summary of Configuration is displayed, click Next.
  3. Then click Run Tests.
  4. Click the Yes button, and then click Next, as shown in Figure 8.
Figure 8. Test availability of the services
Testing Services view

This tests whether the SOQ services and TDI services are available and whether IWSUSER has access to these services.

Tip:
This might fail if IWSUSER is not being added to Administrators, IIS_WPG and QCI_Admin_Console_Users (the group created for QCI users)

  1. Provide the connection details for the Rational DOORS server address, username, and password.
  2. Click Test Connection, as shown in Figure 9.
Figure 9. User details for the Rational DOORS connection
Enter user detail to test DOORS server connection
  1. Provide the login details for HP Quality Center and click Test Connection.

Reminder:
Again, it is important that user is able to launch Microsoft Internet Explorer as IWSUSER and can browse the HP Quality Center site in the same session, as shown in Figure 10.

Figure 10. User details for HP Quality Center connection
Enter QualityCenter server info to test connection
  1. If you have already browsed the Quality Center website on the machine where the Set Access Permission wizard is being running, click No. Otherwise, click Yes.

You have now successfully configured the Rational DOORS HP Quality Center Interface server components.

Install the Rational Quality Center Interface client, version 3.5

  1. Run the Rational Quality Center Interface setup.exe file.
  2. Click Next and accept the license server agreement.
  3. For setup type, select Typical, and click Next.
  4. Enter the database port number (usually 36677), and click Install.

Install the administration console

  1. Make sure that you have both Version 2.0 and Version 3.0 of the Microsoft .NET framework installed. If you need to install the .NET framework, do so now.
  2. In your Internet browser, and type: http://<integrationserver>/AdminToolInstall

Note:
The .NET Framework is installed in the background. Make sure that it is installed before you proceed. The .NET icon will be displayed in the notification area on the taskbar.

  1. To run the Administration Console installer, click set up.
    • If you want to install the console from the local machine, select Save, and then double-click the setup.exe file.
    • If you want to install the console from the network, select Run.

Tip:
You can also navigate here to get the setup.exe file: C:\Inetpub\wwwroot\DOORSTDIServices\OCD\setup.exe

You will then see the Welcome screen.

  1. Click Next to display the License Agreement screen. Accept the terms of the agreement by clicking Yes.
  2. When the Choose Destination Location screen is displayed, enter the path to the folder that you want to install to, or leave the default and click Next.
  3. On the Ready to Install the Program screen, click Install. A progress bar will appear as the files are installed.
  4. Click Finish.
  5. Start the administration console: From the Start menu, select All Programs > IBM Rational > IBM Rational DOORS for HP Quality Center Interface 3.5 Tools > Administration Tool, as shown in Figure 11.
Figure 11. Administration tool authentication
Login window
  1. Select an integration server from the server list.
  2. Click OK if you use integrated Windows authentication, or clear the check box and type in your user name and password, and then click OK.

Connect to an integration server

  1. Click Tools > Connection Manager to reach the Server Connection Manager dialog window.
  2. Enter the address, name and description of the integration server; you can specify as many integration servers as you want.
  3. If you have specified more than one integration server, select a default.
  4. Click OK.

Create a connection to Rational DOORS

  1. Click File > New > Data Connection to reach the New Data Connection wizard.
  2. Select Rational DOORS, and click Next.
  3. Specify the server and user details for the Rational DOORS connection:
  4. Enter the location of the server, in the following format: port@servername
  5. Replace port with the port number you are using, and servername with the name of your server.
  6. Enter your user name and password.
  7. Test the connection to make sure that the user name, password, and location are correct.
  8. Click Next.
  9. If you want, set up a time during which synchronizations cannot be run (this time is set for each database). Select Enable Exclusion Time Window. Enter a start time and an end time, and click Next.
  10. After the summary information is displayed in the Data Connection Summary screen, click Finish.

Create a connection to the HP Quality Center

  1. Click File > New > Data Connection to reach the New Data Connection wizard.
  2. Select HP Quality Center, and click Next.
  3. Specify the server and user details for the HP Quality Center connection:
    • Enter the location of the server, in the following format: http://servername:port/qcbin
    • Replace servername with the name of the server, and port with your port number.
    • Enter the user name and password.
    • Select Test Connection to make sure the user name, password, and location are correct.
  4. Click Next.
  5. Enter the number of sessions and number of objects for the connection, and click Next. These settings set the maximum number of chunks that can be run in parallel and the maximum number of objects in each chunk.
  6. If you want to specify a time during which synchronizations cannot be run, select the Enable Exclusion Time Window. Enter a start time and an end time, and click Next.
  7. After the summary information is displayed in the Data Connection Summary screen, click Finish.

Resources

Learn

Get products and technologies

  • Get the free trial download for Rational DOORS Web Access.
  • Evaluate IBM software in the way that suits you best: Download it for a trial, try it online, use it in a cloud environment, or spend a few hours in the SOA Sandbox learning how to implement service-oriented architecture efficiently.

Discuss

Comments

developerWorks: Sign in

Required fields are indicated with an asterisk (*).


Need an IBM ID?
Forgot your IBM ID?


Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.

 


The first time you sign into developerWorks, a profile is created for you. Information in your profile (your name, country/region, and company name) is displayed to the public and will accompany any content you post, unless you opt to hide your company name. You may update your IBM account at any time.

All information submitted is secure.

Choose your display name



The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

Required fields are indicated with an asterisk (*).

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.

 


All information submitted is secure.

Dig deeper into Rational software on developerWorks


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=Rational
ArticleID=742848
ArticleTitle=Easily synchronize data between Rational DOORS and HP Quality Center
publish-date=08022011