Rational ClearQuest 2000 Patch 2 Release Notes

Copyright (c) 2000 Rational Software and its subsidiaries. All rights reserved.

Please read this document to learn about known product issues, important tips, and other Rational ClearQuest product information.

Release Notes, version 10.6.00


Contents

1.0 Supported Platforms and System Requirements

1.1 List of Supported Platforms and Operating Systems
1.2 Upgrading from Previous ClearQuest Releases
1.3 What's New in ClearQuest 2000 Patch 2
1.4 Defects Fixed in ClearQuest 2000 Patch 2
1.5 Oracle Database Connection Options
2.0 Known Defects

2.1 Installation
2.2 CQ Client
2.3 CQ Designer
2.4 CQ Web
2.5 CQ Import and Export
2.6 User Documentation
2.7 UCM Integration
3.0 Troubleshooting Web Services

3.1 Basic Troubleshooting Tips
3.2 Advanced Troubleshooting Tips

4.0 The Rational Web Site


5.0 Subscribing to the ClearQuest User Group


6.0 Accessing the Sample Hooks Database


7.0 Contacting Technical Support


1.0 Supported Platforms and System Requirements

1.1 List of Supported Platforms and Operating Systems

    Platforms:     Supported Languages:     Browsers and Other Packages:     Databases:     Disk Space Requirements:

 

1.2 Upgrading from Previous ClearQuest Releases

This section describes the steps to install Rational ClearQuest 2000 Patch 2. Customers may upgrade to this patch release from a variety of previous releases including ClearQuest 2000 Patch 1, ClearQuest 2000, ClearQuest 2.0 SP2, ClearQuest 2.0, ClearQuest 1.1 SP1, etc. Instructions to upgrade to this patch version from any of the previously mentioned releases are described in detail in this section.

If you are currently using Rational ClearQuest 2000 and need to generate report formats using Crystal Reports, please refer to section 1.2.1. If you are using Rational ClearQuest 2000 or ClearQuest 2000 Patch 1 and either already upgraded to Crystal Reports 8 or do not need to generate report formats, please refer to section 1.2.2. Please also refer to section 1.2.3 for additional details on the upgrade process.

If you are using Rational ClearQuest 2.0 or ClearQuest 2.0 Patch 1 or ClearQuest 2.0 Patch 2, please refer to section 1.2.4. If you are using a ClearQuest version prior to ClearQuest 2.0, please refer to section 1.2.5.

1.2.1 Upgrading from Rational ClearQuest 2000 and upgrading from Crystal Reports 6 to Crystal Reports 8

In order to create new report formats in ClearQuest 2000 Patch 1 or Patch 2, Crystal Reports 8 is required. You cannot create new reports in ClearQuest 2000 Patch 1 or Patch 2 using Crystal Reports 6 (see defect 12965 in section 2.2). In this scenario, you will be required to upgrade both Crystal Reports and Rational ClearQuest. To upgrade in this scenario, follow these steps:

Please refer to section 1.2.3 for more information on the upgrade process.

1.2.2 Upgrading from Rational ClearQuest 2000 or ClearQuest 2000 Patch 1

To upgrade, follow these steps:

Please refer to section 1.2.3 for more information on the upgrade process.

1.2.3 Customers upgrading from Rational ClearQuest 2000 or ClearQuest 2000 Patch 1 to ClearQuest 2000 Patch 2 should be aware of the following:

1.2.4 Upgrading from Rational ClearQuest 2.0

If you have installed Rational Suite 1.5 or ClearQuest 2.0, you may install ClearQuest 2000 Patch 2 over the previous installation. To upgrade, follow the steps:

Customers upgrading from ClearQuest 2.0 to ClearQuest 2000 (or ClearQuest 2000 Patch 2) should note the following:

1.2.5 Upgrading from Rational ClearQuest 1.0, 1.1, or 1.1 SP1

Customers upgrading from ClearQuest 1.0, 1.1, or 1.1 Service Pack 1 should refer to the documentation in Chapter 7 of the manual, Installing Rational ClearQuest. Please be especially aware of the following:

If you do not apply the needed upgrade packages after upgrading the ClearQuest software and databases, the existing functionality (notification mail, integration with your source code management system, etc.) will be inoperative.

NOTE: Be careful when selecting the packages to install. Some packages (such as Email and Visual SourceSafe) have a version for first-time installations (for example, version '1.0') and a version for upgrades (for example, version 'Upgrade 1.0'). Be sure to select the correct version. As a general rule of thumb, when installing upgrade packages, if there is more than one version, always apply the highest-numbered version. Record types, fields, and actions that were added by the add-ins are modified by the packages. The package takes "ownership" of these entities (record types, fields, and actions) so that in some cases they become read only in the ClearQuest Designer.

1.3 What's New in ClearQuest 2000 Patch 2

Introduction

ClearQuest 2000 Patch 2 provides an update to ClearQuest 2000 and ClearQuest Patch 1, offering a variety of fixes in a number of areas that may be critical to deploying ClearQuest in certain configurations. These include:

ClearQuest Web and Perl Scripting

Prior to Rational ClearQuest 2000 Patch 2, ClearQuest Web could not be used if hooks were authored using Perl. This was due to improper support for multiple threads in CPAN's Perl (v 5.00502). As a consequence, ClearQuest Web server hung when multiple users accessed ClearQuest via the Web interface. This problem made the Web interface unusable if hooks were authored in Perl. In addition to the instability of the Web server, there were many memory leaks and corruption problems such as the $entity variable pointing to the wrong entity when Perl hooks were nested, etc.

ClearQuest 2000 Patch 2 addressed the above issues by using Active State's Perl (v 5.6, build 616) which has support for multiple threads and multiple Perl engines. As a consequence, customers can now author hooks in Perl and successfully deploy ClearQuest Web. A Perl engine is created when an action is performed and destroyed upon the completion of the action. New actions started within a hook will also create a new Perl engine. This ensures that memory is efficiently managed and built-in $entity object is set correctly.

ClearQuest Web has been tested extensively with the new version of Perl. In order to ensure web stability under high loads, Rational is performing load testing involving 50 simultaneous users performing normal operations (e.g., submit, modify, query) which is equivalent to a typical user community of approximately 300 users per web server. Based on this load testing, Rational recommends the following configurations for best performance and stability under high loads:

IIS performance tuning: In order to ensure top performance from ClearQuest Web in a multi-user environment, please be sure the following IIS tuning is completed:

Note: Rational ClearQuest was load tested using Rational Performance Studio. Rational recommends at least 1 GB of RAM and a Pentium II processor (500 MHz and greater) on the Web server for optimal performance.

Other Issues

The following lists a number of other defects that have been addressed in ClearQuest 2000 Patch 2. See section 1.4 for a more complete list.

1.4 Defects Fixed in ClearQuest 2000 Patch 2

1.5 Oracle Database Connection Options

Oracle Connection Options

The connect_options database property has been expanded to support Oracle 8 clients. This option is a site-wide setting per database. The ClearQuest user sees these options as a string in the Connect Options field in the ClearQuest Maintenance tool when attempting to connect to an Oracle database. The permissible values are:

host=<host>;sid=<sid>;server_ver=<ver>;client_ver=<ver>;lob_type=LONG

where,
<host> is the network hostname of the Oracle database server;
<sid> is the instance ID of the Oracle database server;
<ver> is the Oracle version number, either, 7, 8.0 or 8.1;
server_ver is the Oracle database server version number;
client_ver is the Oracle client version number;
lob_type is the Oracle data type used for text fields; currently, this must be of type LONG.

You can override each, or all, of the connect options values per machine by using installutil registeroracleoptions command-line utility. This will not change the setting in the master database, only the way a specified client will connect to the database. A sample registry entry looks like:

[HKEY_CURRENT_USER\Software\Rational Software\ClearQuest\2000.02.10\Core] "OverrideOracleConnectOptions"="client_ver=8.0"

For Unix, the client-based connect override can be achieved by setting the environment variable:
CQ_OVERRIDE_ORACLE_CONNECT_OPTIONS

The Oracle client connect options are also described in the guide, Installing ClearQuest. Please refer to the section, "Creating ClearQuest Databases." Also note that, while not all the Oracle connect values are required, it's a good practice to set all the values to avoid any undesirable default behavior.

What Does This Mean to the ClearQuest User?

Oracle 7 and 8x Servers; Oracle 7 Clients:

This is the supported configuration prior to ClearQuest 2000 Patch 1 and customers don't have to set any Oracle connect options in order to continue using this Oracle client/server configuration.

Oracle 7 and 8x Servers; Oracle 8 and 8i Clients:

Customers should use the appropriate Oracle connect options for their configuration. For example, if they can connect to an Oracle 8.0.5 server via an Oracle 8i client, they should use:

Oracle 7 and 8x Servers; Oracle 7, 8, and 8i Clients:

This configuration will require setting the Oracle connect options for the site, as well as on machines that deviate from the site setting. If most of the ClearQuest clients are using Oracle 8.0.5 client, they should set connect options with client_ver=8.0 in the master database. Then, for the ClearQuest client machines that have Oracle 7 or Oracle 8i clients, those users will need to use the installutil registeroracleoptions command-line utility in order to override the 8.0-client master DB setting.

Setting Connect Options for New Databases:

You should set the appropriate connect options using the guidelines above.

Setting Connect Options for Existing Databases:

To set the connect options for an existing schema repository (i.e. not newly- created with the ClearQuest Maintenance tool), use the installutil registeroracleoptions command-line utility to set the connect options for existing user databases. After that, use ClearQuest Designer and execute the "Database Property" dialog and enter the connect options there. Make sure to answer "NO" when it asks whether you want to physically move the database. Another way is to run the installutil relocateuserdb command-line utility.

An Example: The server is an Oracle 8i instance; and there are existing ClearQuest 2000 Patch 1 clients with Oracle 7 client software; as well as new ClearQuest 2000 Patch 2 clients with Oracle 8i client software.

There are two methods to set up this site:

Method 1: Set the client 8 option per ClearQuest client machine. Method 2: Set the client 8 option for all ClearQuest clients.

Please note that, if your existing ClearQuest client machine is still using a non-patched 2000.02.10 version of ClearQuest, the only option is to use method 1 above (See also defect 12405 in section 2.1).


2.0 Known Defects

2.1 Installation

2.2 ClearQuest Client

2.3 ClearQuest Designer

2.4 ClearQuest Web

2.5 ClearQuest Import and Export

2.6 User Documentation

2.7 UCM Integration

3.0 Troubleshooting Web Services

3.1 Basic Troubleshooting Tips

3.2 Advanced Troubleshooting Tips

There is detailed documentation on the configuration of IIS 4.0 and IIS 5.0 in the Installing Rational ClearQuest guide that may help you troubleshoot installing Web services.
        Failed condition: disposition == (0x00000001L) 
        Location: ClearQuest Core:adregistry.cpp:569occurred 
        in BBOLEI~1
See the printed document, Installing Rational ClearQuest, to set the proper permissions.
        Logon Error 80020009
        Could not create directory
        occurred in ClearQuest.FileCache.1
See the printed document, Installing Rational ClearQuest, to set the proper permissions.
 
Logon Error 
Unable to logon to the MS_ACCESS database
"\\\\.mdb".
The vendor error message was: 
SQLConnect: RETCODE=-1, State=S1000, Native Error=-1032
[Microsoft][ODBC Microsoft Access 97 Driver]The Microsoft Jet database engine cannot open the
file '(unknown)'. It is already opened exclusively by another user, or you need permission to
view its data.
This indicates a permissions problem regarding an Access Database. Try the following steps:
                            error 'ASP 0113'
                            Script timed out
The maximum amount of time for a script to execute was exceeded. You can change this limit by specifying a new value for the property Server.Script.Timeout or by changing the value for ScriptTimeout in the Registry. error '800a041d'

By default Active Server Pages Scripts (which are the providers of the ClearQuest Web pages) are given 90 seconds to complete. If they do not complete in 90 seconds the IIS Server terminates them and presents the user with an error message similar to the above. You may increase the value from the default 90 seconds by editing the following registry key value with regedit.

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\
      W3SVC\ASP\Parameters\ScriptTimeout
  HKEY_USERS\.DEFAULT\Software\Rational
       Software\ClearQuest\2000.02.10\Core
  HKEY_USERS\.DEFAULT\Software\Rational
       Software\ClearQuest\2000.02.10\Install

If you have used cqdbsetup to change the schema repository characteristics, it might change the values under these keys in HKEY_CURRENT_USER, and HKEY_LOCAL_MACHINE but these settings will be overridden because the web server uses keys from HKEY_USERS\.DEFAULT instead of HKEY_CURRENT_USER. To make it see the right values, delete the values as described above; then, the ones from HKEY_LOCAL_MACHINE will be used.


4.0 The Rational Web Site

Please visit the Rational Web site for latest Release Notes, patches and information:

http://www.rational.com/


5.0 Subscribing to the ClearQuest User Group.

The ClearQuest User Group is an e-mail forum where you can share your experiences, pose questions, or obtain useful information from other ClearQuest users. To subscribe to the group, visit the Rational web site at:

 http://www.rational.com/support/usergroups/

 Your e-mail address will not be given out to anyone.


6.0 Accessing the Sample Hooks Database

The ClearQuest Sample Hooks Repository provides a place for users to trade hook scripts with one another. The Repository is located at:

 http://clearquest.rational.com/cqhooks

 To gain access enter:
 
 

username: user
password: password
You can browse the existing hook scripts for ideas, or add a script you would like to share with others.


7.0 Contacting Technical Support

If you have any problems with the software or documentation, please contact Rational Technical Support via telephone or electronic mail as described below. For information regarding support hours, languages spoken, and other Rational Software information, visit the Rational web site, http://www.rational.com/sitewide/support.

Rational's web site contains an extensive library of Technical Notes. To access the Technical Notes, go to http://solutions.rational.com/solutions/.

Rational maintains Support Centers in different geographic regions. To contact the center nearest you, consult the chart below. If you are contacting Technical Support by phone, dial the phone number shown below and follow the voice prompts to select ClearQuest Technical Support.
 
 
Support Location
Telephone
Electronic Mail
North America
(800) 433-5444
(408) 863-4000
Europe
PHONE:+31 20 454-6200
+31 20 454-6201
Asia Pacific
+61-2-9419-0111

(c) 2000 Rational Software Corporation and its subsidiaries. All rights reserved. Rational Software Corporation and its subsidiaries ("Rational") claim copyright in this Program and documentation as an unpublished work, versions of which were first licensed on the date indicated in the foregoing notice. Claim of copyright does not imply waiver of Rational's other rights. See Notice of Proprietary Rights.

NOTICE OF PROPRIETARY RIGHTS

This computer program and documentation are confidential trade secrets and the property of Rational Software Corporation and its subsidiaries. Use, examination, reproduction, copying, disassembly, decompilation, transfer and/or disclosure to others, in whole or in part, are strictly prohibited except with the express prior written consent of Rational Software Corporation and its subsidiaries.