Rational ClearCase and ClearCase MultiSite Service Release 2003.06.01 Release Notes

August 2003


Copyright © 2003 Rational. All Rights Reserved.

Any reproduction or distribution of this work is expressly prohibited without the prior written consent of Rational.

Legal Notices Information


Scope

The product changes described in this document apply to:

This service release updates these products to v2003.06.01.

About a Rational Service Release

A Rational service release includes important product fixes but does not include new features. It is developed for a specific product-version and does not affect the licensing of your products. Because there is no effect on licensing, the service release does not allow you to configure licensing while you apply it to the software. You will, however, be asked to accept the service release license agreement before installing.

A service release detects the products on your system and updates the program components. Because a service release is cumulative, you can apply the latest service release without applying earlier service releases. After you apply a service release, you may see new shortcuts or files. This service release updates the Rational ClearCase and ClearCase MultiSite from version 2003.06.00 to version 2003.06.01.

Contents

Hardware/Software Information
Client Requirements
Server Requirements

Getting Started
Installation Information
Installation Issues

Product Documentation

Defects and Changes

Contacting Rational Customer Support

Hardware/Software Information

Client Requirements

There are no changes to the client requirements for v2003.06.00 of Rational ClearCase and ClearCase MultiSite in this service release. For information about client requirements, see the v2003.06.00 Rational ClearCase and ClearCase MultiSite Release Notes.

Server Requirements

There are no changes to the server requirements for v2003.06.00 of Rational ClearCase and ClearCase MultiSite in this service release. For information about server requirements, see the v2003.06.00 Rational ClearCase and ClearCase MultiSite Release Notes.

Getting Started

This service release applies only to v2003.06.00 of Rational ClearCase and ClearCase MultiSite. Do not install this service release if you are using another version of Rational ClearCase and ClearCase MultiSite.If you do not know which product versions are installed on your system, click Start > Programs > Rational Software > Rational Software Installed Product Information.

Installation Information

Rational Software Service Release Requirements

The following general requirements are necessary to install the Rational Software Service Release on your system.

We also recommend that you:

Supported Configurations

You can apply this service release directly to a client or server host. You can also apply it to an existing v2003.06.00 Rational ClearCase and ClearCase MultiSite release area created with the Enterprise Deployment installation option.

Unsupported Configurations

You cannot apply a Rational service release to:

If the service release detects an unsupported configuration, it cannot update the components. The program displays a generic warning message indicating that it did not find any suitable product for updating.

Installing an Additional Product to an Updated System

When you install any Rational product to a system that already has had a service release applied to it, the setup program warns you that the products on your system are updated. Continue with the installation and then reapply the service release to update the additional product.

Ensuring Version Compatibility

Before you can apply this service release, you must determine that v2003.06.00 Rational products are installed on your system.

  1. Click Start > Programs > Rational Software > Rational Software Installed Product Information.
  2. Ensure that, for each Rational product listed, the Build ID (version number) is 2003.06.00.436.000. If it is not 2003.06.00.436.000, remove or upgrade as follows:

  3. Continue with the service release installation

Using the Rational Software Setup Program

Installation Issues

Registry Size

You need to increase the size of your Windows registry if you encounter the following system error during installation of this service release:

"Your maximum registry size is too small. To ensure that Windows runs properly, increase your maximum registry size. For more information, see Help."

Let the service release installation complete; then increase your system’s Windows registry size by 10MB. For instructions, use your operating system's Help system.

Installation Instructions

Installing the Rational Service Release Directly to a Desktop Client or Server

  1. Download the service relese
  2. If you do not want to create an install log, double-click the msp file in the downloaded service release. If you want to create an install log, you must run the msiexec command to install the service release. From a command prompt, run the command

    msiexec /p msp_file /lv log_file

    where:

    For example, the following command applies the service release to the local host from a service release downloaded to D:\ServiceReleases\SR1 and creates a log file in C:\TEMP\SR1.log.

    D:\> msiexec /p ServiceReleases\SR1\ClearCase.msp /lv C:\TEMP\SR1.log

  3. When the Welcome dialog box opens, click Update
  4. Read the Product Warnings and perform any required tasks; then click Next.
  5. Read the License Agreement.
  6. Click Next and then click Install.
  7. At the end of the installation, click Finish. The Installation Complete window offers:

    You may need to restart your computer to complete the installation of the service release.

Applying This Service Release to a Release Area

  1. Download the service release.
  2. From a command prompt, run the command:

    msiexec /p msp_file /a msi_file /lv log_file

    where:

    For example, the following command would apply the service release to an existing ClearCase 2003.06.00 release area at D:\releases\ClearCase2003 from a service release downloaded to D:\ServiceReleases\SR1 and create a log file in C:\TEMP\SR1.log. (For readability, the command has been split into two lines using the Windows ^ line-continuation character):

    D:\> msiexec /p ServiceReleases\SR1\ClearCase.msp ^
    /a releases\ClearCase2003\SETUP\ClearCase.msi /lv C:\TEMP\SR1.log

  3. When the Welcome dialog box opens, click Update.
  4. Read the Product Warnings and perform any required tasks, then click Next.
  5. Read the License Agreement.
  6. Click Next and then click Install.
  7. At the end of the installation, click Finish. The Installation Complete window offers:

After you have applied the service release to a release area, individual hosts can upgrade by installing from the patched release area.

Removing a Service Release

After a service release is applied, you cannot uninstall the updates it makes. To revert to your previous Rational product configuration:

  1. Uninstall all Rational products for which the service release was applied.
  2. Install your preferred Rational product version again.

To revert an updated release area to a previous Rational product version, remove the release area and recreate it from the original distribution media.

Note: If you plan to apply this service release to an existing release area, consider creating a copy of the release area and applying the service release to the copy.

Product Documentation

Documentation for ClearCase and MultiSite is available online. Click Start > Programs > Rational Software > Rational ClearCase > Online Help.

Defects and Changes

Defects and limitations associated with v2003.06.00 Rational ClearCase and ClearCase MultiSite are documented in the v2003.06.00 Rational ClearCase and ClearCase MultiSite Release Notes.

Defects Fixed in This Service Release

Defect NumberDescription
RATLC00240908Corrects a defect that causes the datamodeler.dll file not to register properly. This problem typically would have occurred when you install any Rational Suites product, followed by installing the XDE Developer Plus Suite.
RATLC00513091Corrects a defect in the ClearCase integration with XDE that could cause XDE models to become corrupted after checkin.
RATLC00683518In the Project Explorer, corrects the names and operations of two buttons on the ClearQuest tab of the Project Properties dialog so that they appear and work as described in the documentation and Help. " Ensure all activities are linked" becomes "Link unlinked activities mastered at this replica." "Ensure all activities are unlinked" becomes "Unlink all activities mastered at this replica."
RATLC00687334 Corrects a defect that allowed the Project Explorer to enable the "Link unlinked activities mastered at this replica" button for unreplicated PVOBs.
RATLC00688072 Corrects a defect that could cause cleartool mkcomp to miss some elements when converting existing VOB subdirectories to components.
RATLC00688491 Corrects a defect that could allow a child stream to be created in a single-stream UCM project.
RATLC00690731 Corrects the names of several UCM project policies so that they are the same in ClearCase and ClearQuest.
RATLC00690905 Corrects a defect that could cause the lock manager to fail while it was being shut down.
RATLC00692313 Corrects a defect that could cause clearmake to mishandle cyclic dependencies in Java classes and display spurious "cycle in dependency graph" warnings.
RATLC00692846 Corrects a defect that would cause ClearQuest to display version information incorrectly or as unknown.
RATLC00693824 Corrects a defect in the ClearCase Web interface that could cause certain merge operations to fail with a message of the form "Malformed branch pathname" when version selectors were specified using a backslash character (\main\LATEST, for example).
RATLC00693976 Corrects a defect that could cause checkvob -ucm to display messages in which activity names were corrupted.
RATLC00694006 Improves the usability of various prompts displayed by checkvob -ucm when repairing links between a UCM project and a ClearQuest user database.
RATLC00694201 Corrects a defect that could cause clearmake to fail and dump core on some platforms when invoked with certain long command line options (-environment- overrides, for example).
RATLC00694202 Corrects a defect in the ClearCase Web interface that could cause invalid operations to be enabled when combinations of checked-out, checked-in, and view-private files were selected.
RATLC00694510 Corrects a defect that could cause ClearCase integrations with various Integrated Development Environments to crash when an Add to Source Control operation was attempted but no files were specified to be added.
RATLC00694736 Corrects a defect in the ClearCase integration with Microsoft Visual Studio .NET that could cause Open from Source Control operations to fail in an environment that included VS.NET virtual projects.
RATLC00694752 Corrects a defect that could cause the graphical diff/merge tool to exit on startup.
RATLC00694793 Corrects a defect that could cause the albd_server to fail during the transition from standard time to daylight saving time.
RATLC00694882 Corrects a defect that could cause cleardiffmrg to fail with an access violation when run with the -blank_ignore option (cleartool diff -g -options -b).
RATLC00694956 Improves the ability of the ClearCase Web interface to provide user feedback when invoked by a browser in which Java support is disabled or improperly configured.
RATLC00694983 Corrects a defect that could cause the graphical diff/merge tool to crash when trying to merge files that contain an ASCII form feed (0xC) character.
RATLC00694994 Corrects a defect that could cause clearmake to pass any top-level compatibility mode specification (-C) to subordinate clearmake processes in which a different compatibility mode was specified.
RATLC00695188 Corrects a defect that could cause clearmake to enter an infinite loop when processing a macro definition in which a line continuation was contained in an ifdef block.
RATLC00695193 Provides improved support for debugging problems with the ClearCase WSAD integration.
RATLC00695250 Corrects a defect that prevented cleartool describe -fmt '%[model]' from displaying the project model type (SIMPLE or DEFAULT).
RATLC00695349 Corrects a defect that could prevent clearmake from examining all potential candidates for winkin.
RATLC00695437 Corrects a defect that could cause MultiSite syncreplica export to log spurious zero-length version data errors.
RATLC00695496 Corrects a defect that could cause omake to fail when a quoted target included a drive letter specification
RATLC00695594 Corrects a defect that could cause the ClearCase installer to allow selection of incompatible features when modifying an existing installation.
RATLC00695612 Corrects a defect that could cause omake -EN to fail with an internal error when parsing a makefile that included nmake path search syntax of the form {$(INCLUDE)}"filename"
RATLC00695855 Corrects a defect that could cause clearmake to fail with a memory exception when target-specific macros were defined on the command line.
RATLC00696142 Corrects a defect that could cause ClearCase and MultiSite license keys to be written incorrectly in the license server's license database when two or more keys were specified at install time.
RATLC00696146 Corrects a defect that could cause clearmake to display spurious warnings about macros used in built-in definitions when invoked with the --warn-undefined-variables option in an environment where .EXPORT_ALL_VARIABLES was set.
RATLC00696169 Corrects a defect that could cause clearmake -C gnu to enter an infinite loop when processing a $(shell) statement.
RATLC00696290 Corrects a defect that could cause a parallel build to fail when a build script removed an explicit dependency from a view-private directory.
RATLC00696357 Corrects a defect that could prevent ClearCase Doctor from running a pre-installation analysis.
RATLC00698185 Corrects a regression, introduced in a previous ClearCase patch, that could affect the performance of cleartool lsview -long. For more information, see Technical Bulletin #59.

Files changed by this release

CTPackage.dll
CTPackageUI.dll
Controller.js
page_template
Messages.js
page_template
albd_server.exe
cccmndlg.dll
ccscc.dll
cleardiffmrg.exe
libatriabuild.dll
libatriacmd.dll
libatriacmdsyn.dll
libatriadb.dll
libatriasquidcore.dll
libatriasum.dll
libatriasumcmd.dll
libatriatbs.dll
libatriavob.dll
libatriaxdr.dll
lockmgr.exe
mvfs40.sys
mvfs50.sys
omake.exe
multitool.exe
libatriafsimport.dll
libatriaimport.dll
map.nt
default.magic

Contacting Rational Customer Support

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

Your Location Telephone Facsimile E-mail
North America

(800) 433-5444
(toll free)

(408) 863-4000
Cupertino, CA

(781) 676-2460
Lexington, MA

support@rational.com
Europe, Middle East, Africa

+ 31 (0) 20 4546 200
Netherlands

+31 (0) 20 4545 202
Netherlands

support@europe.rational.com
Asia Pacific

+61 2 9419 0111
Australia

+61 2 9419 0123
Australia

support@apac.rational.com

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