IBM Support

Rational Team Concert Interim Fix 6 for 4.0.7

Download


Abstract

IBM Rational Team Concert 4.0.7_iFix006 has been made generally available and contains fixes to version 4.0.7 including all predecessor fixes.

Download Description

Table of Contents
Sections Description

The Change history section provides an overview on what is new in this interim fix with a description of any new functions or enhancements when applicable.

The How critical is this fix section provides information related to the impact of this interim fix to allow you to assess how your environment may be affected.

The Prerequisites section provides important information to review prior to the installation of this interim fix.

The Download package section provides the direct link to obtain the download package for installation in your environment.

The Installation instructions section provides the installation instructions necessary to apply this interim fix into your environment.

Click to review a complete list of the defects (APARs) resolved in this interim fix.

The Known side effects section contains a link to the known problems (open defects) identified at the time of this interim fix.

Supporting Documentation
Document Description

Click to review the detailed system requirements information for a complete list of hardware requirements, supported operating systems, prerequisites and optional supported software, with component-level details and operating system restrictions.

IBM Knowledge Center provides an entry point to product documentation. You can view, browse, and search online information related to the product.

The Jazz initiative consists of three elements: Platform, Products and Community. Explore the jazz.net product page.

Find technical developer content and resources.

Prerequisites

Prerequisites include:

IBM Rational Team Concert 4.0.7 must be installed to apply this iFix.

Note: Before you install the server patch file, verify that no other test fixes are installed. If other fixes are installed, contact IBM Software Support.

Installation Instructions

Click the corresponding tab below to review the installation instructions to apply the iFix on a server or client host:

Tab navigation

Note: Before you install this server patch file, verify that no other test fixes or hot fixes are installed. If other fixes are installed, contact IBM Software Support.

For a CLM deployment on a single server, complete the following steps once.

For a distributed CLM deployment, complete the same steps on each server.

Procedure to install the server patch:

  1. Stop the CLM server.

  2. Verify whether the following directory exists: server_installation_directory/server/patch.
    • If the directory exists, back up and remove its contents.
    • If the directory does not exist, create it.

  3. Copy the server patch file into the /server/patch directory.

  4. Start the server.

Note: For a distributed CLM deployment, complete the same steps on each server.


Procedure to uninstall the server patch:

  1. Stop the CLM server.

  2. Back up and remove the contents of the following directory: server_installation_directory/server/patch

  3. Start the CLM server.

Note: For a distributed CLM deployment, complete the same steps on each server.

Procedure to install the client update site:

  1. Extract the update site file to the computer where the client is installed.

  2. In the Rational Team Concert client, click Help > Install New Software.

  3. In the Install window, click Add.

  4. In the Add Repository window, click Local and navigate to the extracted update site file.
    Note: The update site root directory contains a site.xml file.

  5. Select the patches to install.

  6. If you agree to the terms, accept the license agreement and click Install.

  7. After the installation is complete, restart the Rational Team Concert client.

Note: To update the feature patch, you can install the new version directly over the old patch. You do not have to uninstall the old patch.


Procedure to uninstall the client update site:

  1. In the Rational Team Concert client, click Help > About Rational Team Concert > Installation Details.

  2. Select the patches to uninstall and click Uninstall.

  3. After the uninstall process is complete, restart the Rational Team Concert client.

WARNING:

If you run the uninstall process on a Rational Team Concert client that was installed by using a .zip file, the feature patch will be removed along with the original feature. Removing the patch will break the functionality of the affected feature.

For a client that was installed by using a .zip file, reinstall the features by downloading the Rational Team Concert p2 repository from Jazz.net, and use the same installation steps with the following exception:

  • For step 4, click Archive and select the p2 repository .zip file and install the Rational Team Concert feature. This step will remove the patched plug-ins and replace the missing features with the original versions of the feature from the p2 repository.

If you run the uninstall process on a Rational Team Concert client that was installed by using the p2 repository, to remove the patch, you must uninstall the entire Rational Team Concert p2 feature and then reinstall the entire Rational Team Concert feature through the p2 repository.

Download Package

The following sections provide detailed information related to this interim fix.

Click the FC link below to obtain the interim fix from Fix Central.


How critical is this fix?

Impact Assessment
Impact Description

This is a maintenance interim fix. It contains fixes for client-reported and internally found defects.

Test Results

Definitions

Regression: An error in the Maintenance Delivery Vehicle (MDV) that produces incorrect or unexpected behavior causing a supported feature to stop functioning as designed.
This includes:

  • Coding errors that cause a regression
  • Documentation or packaging problems that cause a regression
  • Errors reported in a new function delivered in a MDV that cause a regression

Incomplete: An error in the MDV has not regressed, but does not work as designed.
This includes:

  • Fixed APARs which did not solve the original problem but did not break anything new
  • APARs reporting documentation errors, such as readme errors, that cause problems applying an MDV but do not lead to a regression


Notes:
  • Regression and incomplete APARs are considered fix-in-error or MDV-in-error
  • Definitions above apply only to valid APARs that result in product fixes (APARs returned as working-as-designed are not assessed for being fix-in-error)
  • Issues in major releases due to new functionality do not apply in this definition

There are no known regressions to report.

In addition to the fixes listed in this document, the iFix may also contain fixes for security issues.

For more details, please refer to the IBM Product Security Incident Response (PSIRT) Blog.

Problems Solved

Defects resolved in this iFix.

This server patch contains fixes for the following defects:

APAR (WorkItem URL) Description
Rational Jazz Foundation
PI14143

Parse error when running reports on server in Turkish locale.

PI16116

[Process] Investigate an active migration fix for defect 262994.

PI19783

bottleneck in ComponentRegistry.getComponentDescriptorForServiceUri (206501).

PI19421

CLM database migration [DB2 to Oracle] failed due to 'CRJAZ1150E' The repository was not verified.

PI22170

Too much synchronization on ComponentConfigurationRegistry.ensureMapsAreInitialized().

PI22153

Reduce Lock Contention in a mixed client (N-1) environment (Backport 295511 to 407 ).

PI23880

Expand RTC report: error CRJAZ0368I A SQL query..

PI25057

Workaround missing resource content during deletion.

PI26888

Deadlock issue in JNDI due to classloader problem.

PI37388

Incorrect third argument to substr SQL function for server rename.

PI28526

NPE in ManagedFloatingLicenseClient$LeaseCache.getCheckoutOperations.

PI40009

Lucene crashes because of Mmap issue (Backport to 407).

PI40126

TeamAreaRole ETL flips two columns (354920).

Rational Team Concert
PI12890

Archived users show up on 'Owned By' inline combo search in Web UI.

PI14219

dependency build not building files when a new component is added to the build stream.

PI14497

Normalize and fix duration based attributes behavior in WorkItems and Planning - Server Fix.

PI14552

promotionInfo.xml temp file not unique and can get clobbered.

PI14710

WebUI - work item fails to load after changing Links layout.

PI15109

Copybook in comment gets added to dependency data in some cases.

PI15272

[Server] Promotion does not target the correct PDS in some cases.

PI15686

ccm log filled up with many Premature end of file. exceptions caused by the Packaging Pruner Task.

PI16128

"Time Spent" attribute only shows hour value of "actual spend time" input.

PI17289

[Server] Override credentials not taken into account by work-item promotion.

PI17383

Nothing gets rebuilt on first dependency build.

PI19391

Kanban tasks disappear after changing owner.

PI19549

SCD Scanners convert file contents to String using default system encoding.

PI21194

No files are rebuilt even if it's personal build with no previous successful team build.

PI23698

add pre-build SCM check in Build Forge integration.

PI15699

Presence of Eclipse project references in the scratch directory makes scm daemon track more than one sandbox automatically.

PI15910

WebUI - Duplicate attributeDefinition id found in PA source when using "reuse existing attribute".

PI15911

WebUI - The same attribute can be added more than once to a given type.

PI16233

Users get email notification when they create a workitem.

PI16549

Loading a Plan owned by a Team area with more than 2048 members throws error.

PI17199

The due date can't be recognized correctly by DateBulkEditDialog in Eclipse client with Japanese locale.

PI17733

Plan editor shows archived work item categories in Filed Against column.

PI17862

Subset created from a work item with a deleted file causes a NPE.

PI18050

WebUI - Unable to sort results when querying from Quick Search box.

PI18284

Overlapping timespans are not handled correctly while adding timespans in traditional scheduler.

PI18292

Subset initialized from work-item does not contain the related files.

PI18631

Backport of Build Forge connections should retry on APIAccessDenied exceptions.

PI19121

System z scanner creating bad INCL dependencies for Assembler files.

PI19650

[wi 319401] - Build WorkspaceStatistics is very expensive and should be configurable.

PI20212

Two-way sync export fails to make folders visible if an uncheckout trigger to remove empty branch is configured on the CC VOB.

PI20946

There is an inconsistency of timing to consume RTC Developer Floating license.

PI20967

Work Item query chooser does not load after copying / pasting the WorkItemViewlet statistics viewlet ...

PI21266

Query editor throws TypeError: node is undefined setting condition title of deleted condition.

PI21525

Buildmap Storage Area and JFS Indexes are growing too large.

PI23423

Opening a Cross project plan with gantt chart throws error 'TypeError: transform(...) is undefined'.

PI26677

Allow disabling the Complex Custom Attribute ETL.

PI15296

Time Tracking problem after change Time/Date (Brazilian DST) on WebClient.

PI22274

Missing dependency in PLI source file - following statement with no ending ;.

PI23154

Plan load takes a massive amount of time in getWorkItemAttributeValueSets.

PI23456

Classification problems with C source files.

PI23603

Dependency build not finding C dependency files in SCM.

PI24376

COBOL copybook missing dependencies because it is misidentified as PLI by System z scanner.

PI24393

Classification problems with 11 source files.

PI24394

classificationScan - PL/I file classified as language UNKN.

PI24821

Create work items from the template causes validation error due to exceeded size limit.

PI25128

C and PLI source files are being miss-classified.

PI26287

Add a check to prevent concurrent promotions.

PI26802

Dependency Build Query throws a HTTP/1.1 400 Bad Request error.

PI27804

SCD for Cobol source file missing COPY and INCLUDE references backport.

PI37148

Defect with the pre-condition "prevent adding user owned component".

PI38707

Collecting buildable files takes a long time for dependency build after all the files changed.

PI40984

Promoting multiple changes to a file can fail validation.

PI22400

Attempting to run repotools-jazz -rebuildTextIndices results in java.lang.IllegalArgumentException: CRJAZ8081E: Name must not be empty (PRD2).

PI22400

repotools -renindex gives an error: SEVERE: Failed to register SecureProtocolSocketFactory.

PI29144

Dependency build baseline creation should fail the build if the stream resource does not exist.

PI29144

Dependency build failed when a stream is locked by a scan that was interrupted.

PI29832

[4.0.7 iFix 004] Improve user experience when dealing with large (1000+ 2048+) numbers of components.

PI30420

Records marked as softdeleted in TIMESHEET could be active again - Java ETL.

PI30454

ORA-01795 maximum number of expressions in a list is 1000 during CCM rebuildTextIndices.

PI30751

DependencyQueryService should run against the file without dependencies once.

PI30946

Dependency build automatically unlock the stream after 10 minutes.

PI31096

Source Code Data scanning service not picking up file name changes.

PI31765

Work items incorrectly linked to build when using subset builds.

PI31829

WorkItemPublisher does not check for array size in tagWorkItems().

PI32139

Correct NPE when non-BF engine is defined for a BF definition for 4.0.7.

PI32589

Backport blocking synchronization requests from 3rd party tool with an external system (RTC) to 4.0.7.

PI32908

Excessive value provider exception floods the log.

PI32910

class ISparqlQueryService failed to load for SystemDefinitionService.

PI34210

Work Item Promotion creates a build property that can grow large enough to terminate the BFA process.

This client update site contains fixes for the following defects:

APAR (WorkItem URL) Description
Rational Team Concert Eclipse Client
PI12485

Assigning Language Definitions through UI is too performance-intensive.

PI13508

System Definition dependency types not resolving correctly when created from Ant export file.

PI14497

Normalize and fix duration based attributes behavior in WorkItems and Planning - Client Fix.

PI15553

[Defect 306852] error Job found still running after platform shutdown.

PI17289

[Client] Override credentials not taken into account by work-item promotion.

PI22510

Both included children and impacted files options are not taken into account in package wizard.

PI21782

"Read-only" text/html presentation is implemented badly in Eclipse client.

PI21848

import/export of system defs. Import does not set output property if a variable is involved in an allocation.

PI22400

Address XML parser security issue in Eclipse client.

PI24316

Strange boolean attribute behaviour when moving a WI.

PI25025

Merge issue - modified lines inserted multiple time by Autoresolve.

PI30873

Backport SVN fix from workitem 323740 in 4.0.x.

PI31251

[RichUI] Item is not located under the correct Folder.

PI38141

Missing files in subset definition when adding files manually.

SE59241

SE59241 Language definitions appear in random order.

Rational Team Concert Visual Studio Client
PI10581

Non-empty baselines getting hidden, Escalation 296747.

PI14313

Visual Studio: forgets "flow only components..." changes when you have to scroll.

PI14789

Unloaded projects during accept not getting automatically reloaded, Escalation 9688.

PI30421

Visual Studio Client can't display the Check-In History of a Change Set if in this Change Set is an undo.

PI15699

Presence of Eclipse project references in the scratch directory makes scm daemon track more than one sandbox automatically.

PI28909

Add component to stream fails if no permission to change stream name.

PI30422

First right click doesn't work in Pending Changes View in Visual Studio.

PI26179

"Search Change Set" -< "Search by Name" searches in change set comment, ER.

PI22400

address issue in item 340443 - 4.0.7 iFix005.

PI28909

Request for multiple RTC 4.0.7iFix005 Backports [defects : 339231, 307440].

PI29663

Visual Studio: 414 Request-URI Too Long error is thrown when Searching for Change set.

PI30674

Change set search filters - "Created before" and "Created after" should work from beginning of day.

PI30675

Clicking on a link that reports problems with multiple work items in Team Advisor fails.

PI33273

In intermediate history on a file, disable context menu options in case of Undo state.

Additional fixes:
APAR (WorkItem URL) Description Steps to apply
Rational Jazz Foundation
PI22400

Use TLS instead of SSL by default.

  1. Stop the Apache Tomcat server.
  2. Back up the JAZZ_HOME/tomcat/conf/server.xml file to server.xml.bak.
  3. Extract the ServerConfigurationToUseTLS_RJF-I20150211-0806.zip file to a temporary directory.
  4. Copy the server.xml file to the JAZZ_HOME/tomcat/conf directory.
  5. If you made any custom configuration changes to your server (such as changing port numbers), manually copy them from server.xml.bak to the new server.xml file.
  6. If you are using Windows:
    1. Back up the JAZZ_HOME/server/server.startup.bat file to server.startup.bat.bak.
    2. Copy the server.startup.bat file to the JAZZ_HOME/server/ directory.
    3. If you made any customizations to the server startup file, manually copy them from server.startup.bat.bak to server.startup.bat
  7. If you are using Linux:
    1. Back up the JAZZ_HOME/server/server.startup file to server.startup.bak.
    2. Copy the server.startup file to the JAZZ_HOME/server/ directory.
    3. If you made any customizations to the server startup file, manually copy them from server.startup.bak to server.startup
  8. Start the server
Rational Team Concert
PI22400

Backport defect 336076 into the 4.0.7 maintenance stream.

This fix must also be applied to the Jazz build engine.

In order to apply it take the attached jar file com.ibm.team.build.engine_3.0.801.v20141107_0149.jar and replace the existing jar file com.ibm.team.build.engine_3.0.801.v20140505_2247.jar in the Build Toolkit install directory under /buildsystem/buildengine/eclipse/plugins.

When the new jar is in place start the jbe with -clean once.

The engine is then ready to go with normal parameters.

In addition to that fix, the client-side update site must be installed as well.

To install the update site follow the directions above.

PI22400

repotools -renindex gives an error: SEVERE: Failed to register SecureProtocolSocketFactory.

  • Go to the JAZZ_HOME/server directory.
  • Execute the following command:
    repotools-ccm -clean
  • Execute the following command:
    repotools-qm -clean
WebSphere Application Server
PI22400

Fix defect in redirect web page.

WAR files changed in iFix006 and must be re-deployed. Follow the instructions for the web server you use (WAS or Tomcat).

NOTE: If the context root used by the any application is not the default, it will be necessary to rename the war file (and adjust some of the directory paths referenced below) based on the context root currently in use.

For example:

  • if your current context root for Requirements Management is 'rdm', you must rename the rm.war file to rdm.war
  • if your current context root for Quality Management is 'jazz', you must rename the qm.war file to qm.war
  • if your current context root for Change and Configuration Management is 'jazz', you must rename the ccm.war file to jazz.war

In summary, the name of the war file needs to be the same as the respective context root in use

NOTE: For users of the RDNG browser add-on, the rm.war file must be properly matched with the browser plugin files.

This only applies during installation of the plugin, so for those users that have already installed the plugin, no action is required.

For any new installations of the browser plugin, the customer should contact IBM Support and request a refresh of the browser add-on files along with the properly paired version of the rm.war file that includes this fix.

DEPLOYING ON WEBSPHERE APPLICATION SERVER
  1. 1. Backup these files:
    1. JAZZ_HOME/server/webapps/jts.war
    2. JAZZ_HOME/server/webapps/ccm.war
    3. JAZZ_HOME/server/webapps/qm.war
    4. JAZZ_HOME/server/webapps/rm.war
    5. JAZZ_HOME/server/webapps/admin.war
  2. Copy the jts.war file somewhere either on your local machine or on the CLM server (you may copy to the JAZZ_HOME/server/webapps directory)
  3. In the WAS Admin Console, stop the jts application: Go to Applications>Application Types>Websphere enterprise applications, select the checkbox next to jts_war and click on Stop.
  4. Update the jts_war file: Select the checkbox next to jts_war and click on Update.
  5. Select "Replace the entire application", then browse to the new jts.war file from step 2 and click on Next. Browse locally if the file was saved on the local machine in step 1, or do a remote browse if the file was saved on a different machine. Follow the Fast Path installation, and accept all of the defaults.
  6. Save the configuration changes when prompted after the update completes.
  7. Start the jts application: select the checkbox next to jts_war and click on Start.
  8. Repeat 2-7 with all other WAR files that you need to upgrade.
DEPLOYING ON TOMCAT
  1. 1. Backup these files:
    1. JAZZ_HOME/server/tomcat/webapps/jts.war
    2. JAZZ_HOME/server/tomcat/webapps/ccm.war
    3. JAZZ_HOME/server/tomcat/webapps/qm.war
    4. JAZZ_HOME/server/tomcat/webapps/rm.war
    5. JAZZ_HOME/server/tomcat/webapps/admin.war
  2. Copy the war files to the JAZZ_HOME/server/tomcat/webapps directory.
  3. Stop the Tomcat server.
  4. Delete the JAZZ_HOME/server/tomcat/webapps/jts directory
  5. Delete the JAZZ_HOME/server/tomcat/webapps/ccm directory
  6. Delete the JAZZ_HOME/server/tomcat/webapps/qm directory
  7. Delete the JAZZ_HOME/server/tomcat/webapps/rm directory
  8. Delete the JAZZ_HOME/server/tomcat/webapps/admin directory
  9. Delete the JAZZ_HOME/server/tomcat/work/Catalina/localhost/jts directory
  10. Delete the JAZZ_HOME/server/tomcat/work/Catalina/localhost/ccm directory
  11. Delete the JAZZ_HOME/server/tomcat/work/Catalina/localhost/qm directory
  12. Delete the JAZZ_HOME/server/tomcat/work/Catalina/localhost/rm directory
  13. Delete the JAZZ_HOME/server/tomcat/work/Catalina/localhost/admin directory

Known Side Effects

The following defects were not resolved in this interim fix:

Review the 4.0.7 Release Notes page on jazz.net for links to queries that list known problems and workaround articles for this release.

Open defects

Review the following list of open APARs for Rational Team Concert on the IBM Support Portal.

Review technote 1461170: Open APARs for Rational products available on the Web for information on how to configure your MyNotifications subscription account and subscribe to the APARs you are interested in following.

Change History

What's new

No new features or functions in this iFix.

Review the 4.0.7 New and Noteworthy page on jazz.net for a description of the new features included in this release.

On
[{"DNLabel":"RTC 4.0.7_iFix006","DNDate":"17 Apr 2015","DNLang":"English","DNSize":"223620000","DNPlat":{"label":"Windows","code":"PF033"},"DNURL":"http://www.ibm.com/support/fixcentral/swg/quickorder?parent=ibm%7ERational&product=ibm%2FRational%2FRational+Team+Concert&release=4.0.7&platform=All&function=fixId&fixids=4.0.7-Rational-RTC-ifix006&includeSupersedes=0&source=fc","DNURL_FTP":" ","DDURL":null}]
[{"Product":{"code":"SSUC3U","label":"IBM Engineering Workflow Management"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Installation","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"4.0.7","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Product Synonym

Rational Team Concert

Problems (APARS) fixed
PI14143;PI16116;PI19783;PI19421;PI22170;PI22153;PI23880;PI25057;PI26888;PI37388;PI28526;PI40009;PI40126;PI12890;PI14219;PI14497;PI14552;PI14710;PI15109;PI15272;PI15686;PI16128;PI17289;PI17383;PI19391;PI19549;PI21194;PI23698;PI15699;PI15910;PI15911;PI16233;PI16549;PI17199;PI17733;PI17862;PI18050;PI18284;PI18292;PI18631;PI19121;PI19650;PI20212;PI20946;PI20967;PI21266;PI21525;PI23423;PI26677;PI15296;PI22274;PI23154;PI23456;PI23603;PI24376;PI24393;PI24394;PI24821;PI25128;PI26287;PI26802;PI27804;PI37148;PI38707;PI40984;PI22400;PI29144;PI29832;PI30420;PI30454;PI30751;PI30946;PI31096;PI31765;PI31829;PI32139;PI32589;PI32908;PI32910;PI34210;PI12485;PI13508;PI15553;PI22510;PI21782;PI21848;PI24316;PI25025;PI30873;PI31251;PI38141;SE59241;PI10581;PI14313;PI14789;PI30421;PI28909;PI30422;PI26179;PI29663;PI30674;PI30675;PI33273

Document Information

Modified date:
20 July 2018

UID

swg24040239