IBM Rational ClearQuest and ClearQuest MultiSite

Release Notes(R)

Version 7.0.1
Windows, UNIX, and Linux
GI11-6729-01

Before using this information, be sure to read the general information under Appendix. Notices.

June 2007

This edition applies to IBM Rational ClearQuest Version 7.0.1.

Copyright International Business Machines Corporation 1997, 2007. All rights reserved.
US Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

Tables
About this release of Rational ClearQuest
Installing this release
Obtaining the latest release notes
New features in IBM Rational ClearQuest 7.0.1
Support for feature level 5 and 6
Workspace permissions
Enhancements to Rational ClearQuest Client and Rational ClearQuest Client for Eclipse
Enhancements to Rational ClearQuest Test Manager
Control of case-sensitivity for queries of multiline text fields on Oracle databases
Storing history dates in Universal Coordinated Time
Enhancements to Rational ClearQuest Web
Global script cloning
Availability of Rational ClearQuest information center
New features in IBM Rational ClearQuest 7.0
Platform-independent client
Enhancements to existing clients
Enhanced Rational Web Platform
Rational ClearQuest Test Manager
Deployment tracking packages
Record ID limitation improvement
SSL support for LDAP authentication
Rational ClearQuest Web request manager recycling
DB2 server connection
Rational ClearQuest Diagnostics utility
Extended code page support
Reorganized documentation
Announcements
Rational ClearCase and Rational ClearQuest performance resources on developerWorks
Perl software
Obtaining product version information on UNIX systems and Linux
Support announcements
Accessible documentation
About this release of Rational ClearQuest MultiSite
New features 7.0
Contacting IBM Customer Support for Rational software products
Downloading the IBM Support Assistant
Appendix. Notices

Tables

  1. Modifications to Perl 5.8.6 distribution

About this release of Rational ClearQuest

This chapter describes new features and other changes introduced in IBM(R) Rational(R) ClearQuest(R) versions 7.0 through 7.0.1.

Installing this release

Before installing this release, obtain the latest version of the IBM Rational ClearQuest and ClearQuest MultiSite Installation and Upgrade Guide from the IBM Publications Center.

Obtaining the latest release notes

You can download the most current edition of this document from the IBM Publications Center, as follows:

  1. Go to http://www.ibm.com/shop/publications/order.
  2. Click Search for Publications.
  3. In the Publication number field, enter the number of the form GIxx-xxxx-xx from the title page of this document.

The version of the release notes available from the IBM Publications Center contains the following additional chapters:

New features in IBM Rational ClearQuest 7.0.1

This section describes new features in this release.

Support for feature level 5 and 6

Rational ClearQuest introduces feature level 6. This release supports both feature level 6 and feature level 5, so administrators can choose whether to upgrade to feature level 6. The feature level defines the set of features available for use with Rational ClearQuest applications.

Feature level 6 enables several new features by default:

However, clients and administrative tools from version 7.0 and earlier cannot access schema repositories and user databases that are raised to feature level 6; those clients must be upgraded to version 7.0.1 before moving to feature level 6. Raising the feature level is a process that requires careful deployment; you should perform this task only when adequate time and resources are available.

Note that the record ID limitation improvement was released in version 7.0. To increase the record ID limit for a feature level 5 user database, use the installutil sethighrecordlimit subcommand or simply upgrade to feature level 6.

If you raise the feature level of a user database from 5 to 6, run the timechange.pl script after performing the upgrade.

For instructions on raising the feature level and enabling these features, see the Administering Rational ClearQuest Help and the IBM Rational ClearQuest and ClearQuest MultiSite Installation and Upgrade Guide.

Workspace permissions

IBM Rational ClearQuest provides a role-based access control (RBAC) model to enable permissions for workspace folders .

Workspace folder permissions allow administrators to control which folders users can see and modify in the workspace. Folder permissions apply only to folders, not to the individual queries or reports residing within a folder. These permissions do not apply to the Personal Queries folder or its contents.

In previous releases, all users could view everything in the Public Queries folder and its subfolders; the Public Folder Administrator privilege provided the ability to add, modify, and delete queries in that folder and all its subfolders. Because the Public Queries folder can contain subfolders for a variety of projects, many users needed the Public Folder Administrator privilege in a large Rational ClearQuest environment. These privileged users were able to make changes to queries or reports outside their project area.

In Version 7.0.1, the workspace folder permissions allows administrators to associate specific permissions for user groups with individual folders in the workspace. If no permissions are defined, all users can see and modify all public queries.

Enhancements to Rational ClearQuest Client and Rational ClearQuest Client for Eclipse

The Rational ClearQuest Client and Rational ClearQuest Client for Eclipse include the following enhancements:

Enhancements to Rational ClearQuest Test Manager

This release includes the following new features in Rational ClearQuest Test Manager:

Control of case-sensitivity for queries of multiline text fields on Oracle databases

Rational ClearQuest stores multiline text fields in Oracle databases by using the Character Large Object (CLOB) data type. By default, queries on multiline text fields can only be case-sensitive.

In this release, administrators who run Rational ClearQuest on Oracle databases can now control whether users can create case-sensitive or case-insensitive multiline text queries. You enable this feature by running two SQL scripts, setup_cq_ora_user_clob.sql and setup_cq_clob_index.sql, and following additional procedures.

For more information, see http://www.ibm.com/developerworks/rational/library/07/0531_clearquest/.

Storing history dates in Universal Coordinated Time

Rational ClearQuest now stores history time stamps in Coordinated Universal Time (UTC), which allows you to compare times accurately across time zones. In previous releases, the time stamps that recorded the creation and modification of records always used the local time of the database server.

UTC is the default when you create or upgrade databases to feature level 6. Feature level 5 databases store history time stamps in the local time of the database server. Rational ClearQuest provides a tool for converting feature level 5 history time stamps into UTC history time stamps. For more information, see the IBM Rational ClearQuest and ClearQuest MultiSite Installation and Upgrade Guide.

Enhancements to Rational ClearQuest Web

This release adds the following features to Rational ClearQuest Web:

Global script cloning

Global scripts are intended to be used as a collection of subroutines that can be called from other hooks (such as access control hooks, initialization hooks, and validation hooks). To allow this, all global script code is included as part of the Perl code used for every hook execution. However, global script code can include statements that are outside of subroutine scope (at file scope).

Beginning in version 7.0.1, a new Perl hook enhancement that clones global scripts is available. When this enhancement is enabled, a Perl hook environment is created; all global script code is compiled and then cloned to create new hook environments. The cloning process avoids recompiling code and allows hook environments to share a parse tree. Cloning scripts saves time and memory for each Perl hook environment, which provides better performance (with significant improvements for Rational ClearQuest Web).

Availability of Rational ClearQuest information center

All product documentation is now available from an information center based on IBM Eclipse Help System (IEHS) technology and located at http://publib.boulder.ibm.com/infocenter/cqhelp/v7r0m0/index.jsp. The information center contains a search utility that can search the entire information center or only selected topics. You can also print individual topics or a hierarchy of topics. The information center contains some updated content that is not in the media version of the product. In previous releases, updated content was published in the Documentation updates chapter of the IBM Rational ClearQuest and ClearQuest MultiSite Release Notes.

New features in IBM Rational ClearQuest 7.0

Platform-independent client

This release introduces the Rational ClearQuest Client, which is the Eclipse Rich Client Platform (RCP) client. This client does not require you to install an Eclipse Integrated Development Environment (IDE) and provides a consistent user interface on Windows(R), Linux(R), Solaris, and AIX(R). It provides the same capabilities as those available with the existing Rational ClearQuest Client for Eclipse (the Eclipse plug-in client), including the enhancements introduced in this release.

Enhancements to existing clients

The Rational ClearQuest Client for Eclipse includes the following enhancements:

The Rational ClearQuest Web client has been enhanced to include the following features:

Enhanced Rational Web Platform

Rational Web Platform (RWP) is now based on the Embedded version of WebSphere(R) Application Server Express. In addition, you can perform Web server load balancing by using the plugin-cfg method.

Rational ClearQuest Test Manager

Rational ClearQuest Test Manager supports test management with Rational ClearQuest, as follows:

In addition, you can use the RequisitePro(R) Version 1.8 package to provide lifecycle traceability for the requirement to test plan, test case, configured test case and test suite relationships. Rational ClearQuest Test Manager also includes a tutorial.

Deployment tracking packages

This release includes a Deployment tracking feature, which enables you to use Rational ClearCase(R) and Rational ClearQuest to track software assets in your specific software testing environments throughout the deployment lifecycle. Highlights of deployment tracking:

Three new packages enable deployment tracking:

Record ID limitation improvement

In previous releases, the maximum number of database record IDs was approximately 16 million. For stateless records, the new limit is approximately 2 billion; for stateful records, it is approximately 100 million. For databases that use site-ID values of 2 or greater (these are old databases), the upper limits are smaller.

To increase the record ID limit for a user database, use the new installutil sethighrecordlimit subcommand. For instructions about increasing the record ID limit, see IBM Rational ClearQuest and ClearQuest MultiSite Installation and Upgrade Guide.

For information about the implications of this feature for replicated databases, see the sections of this document about Rational ClearQuest MultiSite.

SSL support for LDAP authentication

This release adds support for using Secure Socket Layers (SSL) protocol with Lightweight Directory Access Protocol (LDAP) user authentication. SSL encrypts data sent between clients and servers, such as Rational ClearQuest clients or the Rational ClearQuest Web Request Manager and LDAP servers. You can use SSL to ensure that communication between Rational ClearQuest clients and the LDAP directory server is secure and private. For more information, see the Administering Rational ClearQuest online help.

Rational ClearQuest Web request manager recycling

The Rational ClearQuest Web request manager recycling feature shuts down and restarts the request manager process without interrupting user sessions.

DB2 server connection

In this release, Rational ClearQuest connects directly to the DB2(R) server, which eliminates the need to install the DB2 client on Rational ClearQuest clients. However, there is no need to uninstall the DB2 client if it is installed; other applications might be using it, and Rational ClearQuest ignores any DB2 client that is installed on a computer where a Rational ClearQuest client or the Rational ClearQuest Web server request manager process is running.

Rational ClearQuest Diagnostics utility

The Rational ClearQuest Diagnostics utility examines your schema repository and user databases and identifies conditions that might cause integrity or performance problems. The purpose of the utility is to help you quickly diagnose the source of database integrity problems so that you can repair your schema repository and user database. The utility generates log and results files that document the analysis and include a summary of the execution results. For more information about using the utility see the Administering Rational ClearQuest online help.

The tool supports validation of the following database platforms:

Extended code page support

Rational ClearQuest has extended its character set (code page) support as follows:

Reorganized documentation

The documentation has been substantially revised and reorganized:

Announcements

Rational ClearCase and Rational ClearQuest performance resources on developerWorks

A new Rational ClearCase and Rational ClearQuest Performance page is now available on the IBM developerWorks(R) web site at http://www-128.ibm.com/developerworks/rational/performance/. This page contains white papers, technical notes and performance benchmarks for current Rational ClearCase and Rational ClearQuest releases. This information helps you evaluate your existing Rational ClearCase and ClearQuest installations as well as the existing hardware and network infrastructure.

Perl software

Perl 5.8.6 and related Perl modules are distributed with this release and are available at www.cpan.org. In conformance with the Artistic License Agreement under the terms of which Perl is distributed, the following table describes the modifications that were made to Perl version 5.8.6. The same modified version of Perl 5.8.6 is distributed with multiple IBM Rational products; the table describes all modifications, not just those made in support of Rational ClearQuest.

Table 1. Modifications to Perl 5.8.6 distribution
Source files modified Reason for modification
C code changes
perl.c Fixed environment handling in a multithreaded environment. Fixed bug on Linux MVFS where $^X ends up pointing to the view storage container of Perl.
util.c Fixed environment handling in a multithreaded environment.
win32/win32.c Changed the lookup of the lib folders to match the UNIX names and directory structure.
utf8.c Fixed compile problem.
encGlue.c Fixed crash on Solaris (from April 8, 2005 posting on comp.lang.perl.tk)
Changes to support building and packaging with Rational ClearCase software
lib/ExtUtils/MM_Unix.pm, lib/ExtUtils/MM_Win32.pm, lib/ExtUtils/MakeMaker.pm, ext/SDBM_File/Makefile.PL Support building with clearmake and omake.
Configure, Makefile.SH, win32/Makefile, installperl, win32/bin/pl2bat.pl, win32/config.bc, win32/config.gc, win32/config.vc Updated to change the name of perl to ratlperl and libperl.so to libratlperl.so. Changed to support linking with the C++ compiler.
Miscellaneous changes
ext/DynaLoader/hints/aix.pl Enabled use of native dlopen on AIX 4.3.3 or later.
hints/aix.sh Support for fix of environment handling in a multithreaded environment.
win32/buildext.pl Added -I../lib when calling pl2bat.pl.

Obtaining product version information on UNIX systems and Linux

In previous releases on UNIX, you could use either of two commands to display product version information: clearquest -version or clearquest version. Beginning with this release, you must use only clearquest -version.

Support announcements

Windows Vista

Beginning in release 7.0.0.1, the following Rational ClearQuest clients and administration tools support Windows Vista Business, Windows Vista Enterprise, and Windows Vista Ultimate:

Database drivers and database support

The product includes DataDirect drivers for connectivity to Oracle, SQL Server, and DB2 databases.

Client support

The following clients are supported:

The following client functionality is no longer provided:

Rational Web Platform

The Rational Web Platform (RWP) is supported only on server platforms; it is not supported on Windows XP.

MAPI support

The MAPI messaging protocol is no longer supported by the Rational ClearQuest MailReader. MAPI is supported for e-mail notification only in matching code page deployments.

Crystal Reports

This release supplies Business Objects Crystal Reports XI components for executing reports. Crystal Reports designer V10 and XI are supported for authoring reports. To define report formats, you must obtain Crystal Reports with Crystal Reports Designer (For more information, see http://www.businessobjects.com/). The Crystal Reports Designer tool is supported on the Rational ClearQuest for Windows client only, and the report format definitions are stored in the Rational ClearQuest database.

Rational ClearQuest includes runtime support for Crystal Reports Version XI, which you can use to generate reports from report formats that have been defined using either Version 10 or Version XI.

Accessible documentation

Documentation delivered in PDF format with this release is also available in HTML format from the IBM Publications Center.

About this release of Rational ClearQuest MultiSite

This chapter describes new features and other changes introduced in IBM Rational ClearQuest MultiSite version 7.0. The 7.0.1 release contains no new ClearQuest MultiSite features.

New features 7.0

New features in this release include the following:

Contacting IBM Customer Support for Rational software products

If you have questions about installing, using, or maintaining this product, contact IBM Customer Support as follows:

The IBM software support Internet site provides you with self-help resources and electronic problem submission. The IBM Software Support Home page for Rational products can be found at http://www.ibm.com/software/rational/support/.

Voice Support is available to all current contract holders by dialing a telephone number in your country (where available). For specific country phone numbers, go to http://www.ibm.com/planetwide/.

Note:
When you contact IBM Customer Support, please be prepared to supply the following information:

Downloading the IBM Support Assistant

The IBM Support Assistant (ISA) is a locally installed serviceability workbench that makes it both easier and simpler to resolve software product problems. ISA is a free, stand-alone application that you download from IBM and install on any number of machines. It runs on AIX, (RedHat Enterprise Linux AS), HP-UX, Solaris, and Windows platforms.

ISA includes these features:

For more information about ISA, including instructions for downloading and installing ISA and product plug-ins, go to the ISA Software Support page.

IBM Support Assistant: http://www.ibm.com/software/support/isa/

Appendix. 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 license inquiries, in writing, to:

IBM Director of Licensing 
IBM Corporation North Castle Drive 
Armonk, NY 10504-1785 
U.S.A.

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

IBM World Trade Asia Corporation Licensing 
2-31 Roppongi 3-chome, Minato-ku 
Tokyo 106, 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:

IBM Corporation 
Department BCFB
20 Maguire Road
Lexington, MA 02421 
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 measurement 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.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrates programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM's application programming interfaces.

Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:

(c) (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. (c) Copyright IBM Corp. _enter the year or years_. All rights reserved.

Additional legal notices are described in the legal_information.html file that is included in your Rational software installation.

Trademarks

AIX, ClearCase, ClearCase Attache, ClearCase MultiSite, ClearDDTS, ClearGuide, ClearQuest, DB2, DB2 Universal Database, DDTS, Domino, IBM, Lotus Notes, MVS, Notes, OS/390, Passport Advantage, ProjectConsole Purify, Rational, Rational Rose, Rational Suite, Rational Unified Process, RequisitePro, RUP, S/390, SoDA, SP1, SP2, Team Unifying Platform, WebSphere, XDE, and z/OS are trademarks of International Business Machines Corporation in the United States, other countries, or both.

Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. 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.

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

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

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