IBM Rational Change for HP Quality Center Interface 3.7.0.2 Readme

IBM Corporation  24 May 2012

 

© Copyright IBM Corporation 2002, 2012

U.S. Government Users Restricted Rights - Use, duplication, or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

 

This file contains last-minute product information and updates to IBM Rational Change and HP Quality Center Interface 3.7.0.2. It is divided into the following sections:

    * System Requirements

    * Operating System Locales

    * What's new in this release

    * Setup Instructions

    * Installation Instructions

    * Limitations and known issues

    * Contacting IBM Rational Support

    * Notices

  

For the latest news and information on IBM Rational Change for HP Quality Center Interface, visit the IBM Rational website at

http://www.ibm.com/software/rational/support/

 

System Requirements

Before you install the integration, you must have the following installed as described later in the Setup Instructions.

  • HP’s Quality Center 9.2, 10.0 or 11.0 with all the latest patches.
  • IBM Rational Change 5.2.0.5 or 5.3.0.2
  • IBM Rational Synergy 7.1.0.4 or 7.2.0.1
  • Microsoft .NET Framework 3.5

 

The integration is supported on the following platforms.

  • Windows XP SP2
  • Windows Vista
  • Windows 2003 Server

 

Operating System Locales

This integration is supported in the following Windows locales:  IBM supports use in any locale using the Latin-1 character set or the Windows extension CP 1252; however, such locales have not been tested.

 

 

What’s New in This Release

  • Support for HP ALM 11
  • Bug fixes

 

Problems Fixed:

Rational Change for HP Quality Center  Interface 3.7.0.2 fixes the following problems:

R#41412 CR's are picked for Sync operation irrespective of their modify time.

R#42252 Change-QC integration fails to work with HP ALM 11

R#42528 Integration wipes out content of transition log when migrating new defects from QC to Change.

R#43018 (PM64954) The logs are populated in debug mode after applying the new 3.7.0.1

R#42999 (PM64777) BusinessLogic.dll.config value when set to ‘True’ initially does not sync updates from Rational Change to QC 

R#43000 (PM64781) Logs are getting created with a default size of 5MB irrespective of ‘logFileSizeCap’ setting. 

R#42810 (PM62779)  Locked records are not synchronized during subsequent sync Operation after being locked.

R#42606 (PM60498)  The parameter 'exePath' is invalid.

R#42613 (PM60567)  CR transition log in Rational Change does the record the CR submission details.

R#42894 (PM63794)  Sync logs are getting saved in the Integration Installation Directory location Implementation.

R#42893 (PM63791)  Attachments of size greater than 120 MB are not getting attached to a CR from a QC defect after the "Sync" operation. 

 

Rational Change for HP Quality Center  Interface 3.7.0.2 also includes 3.7.0.1 which fixes the following problems:

R#29608(PK85500)  Cannot synch fields BG_TARGET_REL and BG_DETECTED_IN_REL 

R#33593 Wrong usage of CMSynergy date format in tdsConfig.xml on Windows in German locale

R#35102(PM05706) Change-QC integrations does not write to the correct logs when multiple links are concurrently sync'ing

R#37014(PM17347) Change-Quality Center integration : Disabled sync Item

R#38673(PM27136) Mutli links are writing to same log in Rational Change integration for HP-QC

R#39691(PM33257) Change with QCI: Empty date fields (e.g. BG_CLOSING_DATE) cause error System.FormatException

R#40181(PM36227) Attachment of size greater than 8 MB does not updated in the CR from a QC defect

R#40274  Change QC Int 3.7 Patch03: Unhandled exception upon refreshing attributes in Change-QC integration interface

R#40278  Change QC Int 3.7 Patch03: New attribute added to change CR process not getting listed in the existing link of Change integrations for QC

R#40303(PM36824)  Sync operation in Change - HP QC 3.7 is picking up the Record Level Time Stamp rather that Field Level Time Stamp 

R#40303(PM36824) Sync operation in Change - HP QC 3.7 is picking up the Record Level Time Stamp rather that Field Level Time Stamp

R#40470 CS - QC Synchronization performance issue

R#40688  Change-QC 3.7 integration reports license error even when Change server is down

R#40689  Change-QC integration crashes randomly 

R#40691  It takes really long time to stop the Change-QC Integration service

R#40694  RC QC Int 3.7 Patch 1 : The Date and Time Formats of all the columns are different on the Status Page

R#40695  RC QC Int 3.7 Patch 1 : Even though the user asks not to proceed with Incorrect Change Details , the interface checks the setting details of Change in the New Link Wizard 

R#40698  RC QC Int 3.5 Patch 1 : The Change attribute list is not getting refreshed on clicking the Refresh Button under the Attributes tab

R#40699  RC QC Int 3.7 Patch 1 : The Refresh button fails to show the new state for the list of available states of Change

R#40733(PM41766) Change - HP QC sync fails intermittently and reports license unavailable error

R#40805(PM42449) ATTACHMENT CREATE/SYNC WHILE USING CHANGE-QC 3.7 TAKES 6 MINUTES PER ATTACHMENT REGARDLESS ITS SIZE

R#40903  CS-QC Integration: Locked records not synchronized during sync

R#40905  CS-QC Int: Unable to map new QC fields to CS fields in Integration GUI

R#40952  Checking an issue logged in the disabled sync items does not resync the defect and CR 

R#41122  RC QC Int 3.7.0.1: Deleted QC attribtue is not removed from mappable attributes list 

R#41150  RC QC Int 3.7.0.1: Cannot create a link once a wrong Change URL is specified. 

R#41156  RC QC Int 3.7.0.1: Upon entering invalid QC credentials, the cursor shows busy state all the time. 

R#41157  RC QC Int 3.7.0.1: Correct the error message when login to QC fails. 

R#41158  RC QC Int 3.7.0.1: New QC attribute is not get listed when creating a new link. 

R#41192  Change QC integration 3.7.0.1: Cannot cancel the sync operation when integration cannot connect to Change Server. 

R#41198  Change QC integration 3.7.0.1: Sync service does not work once error occurs in one of the links.

R#41316  Add preference based handling of missing modification time for Change attributes during synchronization 

R#41403  Change-QC int 3.7.0.1: An empty value from QC to change gets synced as "<no value>" in change. 

R#41442  Change QC int 3.7.0.1: crstatus not getting synced from Change to QC 

 

Setup Instructions

  1. Install supported version of HP Quality Center. For detailed instructions, refer to the Quality Center documentation.
  2. Install supported version of IBM Rational Synergy and IBM Rational Change.  For detailed instructions refer to the documentation of these products and readme files in each of their iFixes or Fixpacks.
  3. Install this interface on any machine. In addition, install the CRProcess included with the integration as described in Manually Configure the IBM Rational Change Machine below, or ensure that your custom CRProcess meets the requirements described in Customization later in this document. 
  4. To setup the Quality Center projects and to customize projects, user must have necessary user privileges on the Quality Center server, consult your Quality Center Administrator
  5. To run the IBM Rational Change for HP Quality Center Interface, the user should have enough privileges to modify Quality Center defects in a given Quality Center project. The user should also have ccm_admin and pt_admin privileges in IBM Rational Change database to transition the change request.  The user must also have privileges to modify the following directories underneath the directory where the integration is installed:  LastSyncTimes, LinkFiles, and logs.
  6. Most of the Quality Center Project Customization that is required to run this interface is automatically setup by the Link wizard that comes with this integration. However before running this integration user must complete the following customization:
    • The Project Lists values in Quality Center or Attribute list values in IBM Rational Change. The list values and range for the Quality Center field must match the attribute range value in the IBM Rational Change.
    • Check the History Checkbox for all the System fields for which SYNC_ON is selected during link Configuration. Without History setting SYNC_ON operation will not be able to detect latest changes to the fields.
    • If Quality Center and IBM Rational Change servers are located on different machines, the Clock on these machines should be set to same time.

 

Client Setup

Quality Center is a web-based product. Therefore, you do not need to install Quality Center on the client machine.

After Quality Center is installed on the server machine, the system administrator provides users with a URL address that they can use to connect to the Quality Center server. The address is in the following format http://ServerMachineName:portNo/qcbin

 

Installation Instructions

 

To install the IBM Rational Change for HP Quality Center Interface, you need to:

  • Install the interface on a dedicated machine.
  • Manually configure the IBM Rational Change machine.

            These steps are described below.

 

Upgrade Information

 

  • Make a backup copy of the LastSyncTimes and LinkFiles directories from your existing integration install directory.
  • Uninstall the older version of the interface
  • Follow the instructions below to install Rational Change for HP Quality Center Interface.
  • Copy the contents of LastSyncTimes and LinkFiles from your backup to the new integration installation.

Install the interface on a dedicated machine

 

To install the IBM Rational Change for HP Quality Center Interface on a dedicated machine, do the following:

 

  1. Please close all applications before installing this integration. Stop the sync service and uninstall any older versions of IBM Rational Change for HP Quality Center Interface you might have on this machine.  You must also stop any other application that integrates with IBM Rational Change.
  2. If you have not already done so, read and perform the steps in Server and Client Setup described earlier in this document.
  3. If it is not already installed, install Microsoft .NET Framework 2.0 on the machine.  For more information see this site: http://msdn.microsoft.com/netframework/technologyinfo/howtoget/default.aspx
  4. Download the interface zip file from the technical support web site to a directory of your choice.
  5. Use a zip program to extract the contents of the integration zip file.
  6. Double-click setup.exe or RationalChangeQualityCenterInt.msi  file to start the installation program and follow the wizard

 

Manually configure the IBM Rational Change machine

 

  • Copy the td_process.xml file, which is in the integration zip file, to the IBM Rational Change Process installation directory. For example, this directory might be as follows:

      C:\Program Files\IBM Rational Change 5.1\cs_app\webapps\synergy\WEB-INF\cr_process

  • Unzip the td_template.zip file, which is in the integration zip file, to the IBM Rational Change package_templates directory. For example, this directory might be as follows:

            C:\Program Files\IBM Rational Change 5.1\cs_app\webapps\synergy\WEB-INF\package_templates

  • Log on to IBM Rational Change as Admin, and create a new package using the td_process.xml process file and the td_template package template.  To learn how to create and install a new package, refer to the IBM Rational Change documentation.
  • Read the Help documentation that comes with this integration, and performs the operations described in Chapter 4 “Quality Center Project & IBM Rational Change Process Setup”.

 

Logging Information:

 

The tdcsConfig.xml file in your IBM Rational Change for HP Quality Center Interface installation directory, allows you set the logging level for your IBM Rational Change Synchronization Service. The size of the log files is set to a default value of 5 (5 Megabytes.) in the tdcsConfig.xml file. You could change the log file size by changing this value. The default setting for maintaining history of log files is ‘keepOldLogFile’ is 1. For the manual Migration and Synchronization operations you can select the logging levels within the IBM Rational ChangeLifecycle Manager dialogs. The ‘TimePatterns’ section in the tdcsConfig.xml file defines the date/time format used for IBM Rational Change query and Quality Center query.

 

Limitations and known issues:

a.      Synchronization process recreates attachments that were deleted manually from the Quality Center project.

b.      IBM Rational Change Lifecycle Manager and the IBM Rational Change for HP Quality Center Interface service should be restarted any time choices are added, removed, or modified in a listbox attribute in either IBM Rational Change or Quality Center.

c.      Quality Center OTA client component has a memory leak issue. Because of this known problem, links may start freezing randomly after some time. In order to avoid this problem, you should use Windows scheduled tasks to restart “IBM Rational Change for HP Quality Center Interface” service every 3 to 4 hours.  Please refer to HP bug ID QCCR1J13177.

 

DCM Caveats:

If your databases are not DCM enabled, you must not synchronize more than one IBM Rational Change database with a single Quality Center project.  Each Quality Center project must sync with exactly one IBM Rational Change database.

If you are using DCM and all your databases are DCM enabled, you may sync more than one IBM Rational Change database with the same Quality Center project.

Initializing DCM after beginning use of this integration is not recommended at this time.

 

Customization:

This integration will work with any custom IBM Rational Change and Quality Center lifecycles.  However, all custom IBM Rational Change lifecycles must contain the following attribute:

Name: td_problem

Web type: CCM_STRING

Database type: string

The ‘R&D Comments’ field in Quality Center must be mapped to a IBM Rational Change attribute defined as having the CCM_TEXT web type.

IBM Rational recommends that the td_problem and R&D Comments attributes in IBM Rational Change have security rules such that only users with the pt_admin role can modify them. Using the CCM_READONLY web type on the show dialog may cause problems during sync.

When using custom lifecycles, you must add the following lines to your package template CFG file:

[CCM_ATTRIBUTE][NAME]db_id[/NAME][ALIAS]DCM DB ID[/ALIAS][TYPE]CCM_STRING[/TYPE][/CCM_ATTRIBUTE]

[CCM_ATTRIBUTE][NAME]delimiter[/NAME][ALIAS]DCM Delimiter [/ALIAS][TYPE]CCM_STRING[/TYPE][/CCM_ATTRIBUTE]

[CCM_LISTBOX][NAME]ALL_USERS[/NAME][TYPE]STANDARD[/TYPE][VALUES][/VALUES][FROM_DATABASE]users[/FROM_DATABASE][/CCM_LISTBOX]

 

Contacting Support

 

Please visit our Telelogic support overview site at: http://www.ibm.com/software/rational/support/telelogic/  You will find a one-sheet reference guide about how to best contact support in your geography.

 

Notices

This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send written license inquiries to:
IBM Director of Licensing
IBM Corporation
North Castle Drive

Armonk, NY 10504-1785 U.S.A.

For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send written inquiries to:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions. Therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

Intellectual Property Dept. for Rational Software
IBM Corporation
1 Rogers Street
Cambridge, Massachusetts 02142
U.S.A.

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

If you are viewing this information softcopy, the photographs and color illustrations may not appear.

Trademarks

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at Copy and Trademark information at www.ibm.com/legal/copytrade.html.

Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.

IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications Agency which is now part of the Office of Government Commerce

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office

UNIX is a registered trademark of The Open Group in the United States and other countries.

Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom.

Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Other company, product or service names may be trademarks or service marks of others.