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

Integration server

IAS Admin (integration administration console)

Integration Client

Back to top

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.

6. 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

7. Click Next to finish the client installation.

Back to top

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.

Back to top

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.

5. Enter IIS Port (usually, the port number given is 80), and click Next.
6. Enter the Domain and Group names, and then click Next and Install as Figure 5 shows.

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.

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

5. 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

6. Click Yes to configure the server.
7. When Summary of Configuration is displayed, click Next.
8. Then click Run Tests.
9. Click the Yes button, and then click Next, as shown in Figure 8.

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)

10. Provide the connection details for the Rational DOORS server address, username, and password.
11. Click Test Connection, as shown in Figure 9.

10. 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.

11. 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.

3. 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.

4. Click Next to display the License Agreement screen. Accept the terms of the agreement by clicking Yes.
5. 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.
6. On the Ready to Install the Program screen, click Install. A progress bar will appear as the files are installed.
7. Click Finish.
8. 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.

9. Select an integration server from the server list.
10. 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.

Back to top

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.

Back to top

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

• Browse the Rational DOORS developerWorks page for links to technical articles and many related resources, and explore the instructions in the Rational DOORS Information Center.
  
  
• Visit the Rational software area on developerWorks for technical resources and best practices for Rational Software Delivery Platform products.
  
  
• Stay current with developerWorks technical events and webcasts focused on a variety of IBM products and IT industry topics.
  
  
• Attend a free developerWorks Live! briefing to get up-to-speed quickly on IBM products and tools, as well as IT industry trends.
  
  
• Watch developerWorks on-demand demos, ranging from product installation and setup demos for beginners to advanced functionality for experienced developers.
  
  
• Improve your skills. Check the Rational training and certification catalog, which includes many types of courses on a wide range of topics. You can take some of them anywhere, any time, and many of the "Getting Started" ones are free.
  
  

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

• Join the Rational DOORS forum to ask questions and participate in discussions.
  
  
• Share your knowledge and help others who use Rational software by writing a developerWorks article. You'll get worldwide exposure, RSS syndication, a byline and a bio, and the benefit of professional editing and production on the developerWorks Rational website. Find out what makes a good developerWorks article and how to proceed.
  
  
• Follow Rational software on Facebook and Twitter (@ibmrational), and add your comments and requests.
  
  
• Ask and answer questions and increase your expertise when you get involved in the Rational forums, cafés, and wikis.
  
  
• Connect with others who share your interests by joining the developerWorks community and responding to the developer-driven blogs.
  
  

About the author

Guru 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.

Rate this article

Comments

Back to top

Table of contents

• Overview of the Rational DOORS for HP Quality Center Interface
• Install Rational DOORS
• Run the installer
• Install the Rational Quality Center Interface and client
• Create a connection to Rational DOORS
• Create a connection to the HP Quality Center
• Resources
• About the author
• Comments

Next steps from IBM

• Try: Rational DOORS Web Access
• Demo: Rational DOORS Web Access
• Webcast: The value of extending requirements visibility and collaboration with Rational DOORS Web Access
• Buy: Rational DOORS Web Access

Dig deeper into Rational on developerWorks

Try IBM PureSystems. No charge.

Experience today!

---

Get started with the cloud-based trial and pattern development kit.

Special offers