Download
Abstract
IBM Rational Team Concert 5.0.2_iFix005 has been made generally available and contains fixes to version 5.0.2 including all predecessor fixes.
Download Description
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. |
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
IBM Rational Team Concert 5.0.2 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:
- Stop the CLM server.
- 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.
- Copy the server patch file into the
/server/patch
directory. - Start the server.
Note: For a distributed CLM deployment, complete the same steps on each server.
Procedure to uninstall the server patch:
- Stop the CLM server.
- Back up and remove the contents of the following directory:
server_installation_directory/server/patch
- Start the CLM server.
Note: For a distributed CLM deployment, complete the same steps on each server.
Procedure to install the client update site:
- Extract the update site file to the computer where the client is installed.
- In the Rational Team Concert client, click Help > Install New Software.
- In the Install window, click Add.
- 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. - Select the patches to install.
- If you agree to the terms, accept the license agreement and click Install.
- 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:
- In the Rational Team Concert client, click Help > About Rational Team Concert > Installation Details.
- Select the patches to uninstall and click Uninstall.
- 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.
Procedure to install the Visual Studio client update:
- Close all the running Visual Studio client(s).
- Extract the patch zip file to the computer where the RTC Visual Studio client is installed.
- In the IBM Installation Manger, click File > Preferences > Repositories > Add Repository and provide the path to the folder extracted in the second step.
- Click Ok to close Preferences window.
- Make sure that the check box File > Preferences > Files for Rollback > "Save files for rollback" is checked.
- Now click on Update in the Installation Manager.
- Select IBM Rational Team Concert Client for Microsoft Visual Studio IDE package group and click Next.
- Select the RTC version that needs to be updated and click Next.
- If you agree to the terms, accept the license agreement and click Install.
- Select the Visual Studio version(s) and click Next.
- Click on Update
- Click Finish to complete update.
- After the installation is complete, start the Rational Team Concert Visual Studio client.
To update the feature patch, you can install the new version directly over the old patch if the Visual Studio IDE version is 2010 or 2012. You do not have to uninstall the old patch.
Procedure to roll back to the previous client version:
- Close all the running Visual Studio client(s).
- In the IBM Installation Manager, click Roll Back.
- Select the IBM Rational Team Concert Client for Microsoft Visual Studio IDE package group and click Next.
- Select the patch to roll back to.
- Click on Roll Back.
- Click Finish.
WARNING:
The 5.0.2 patch can be installed only on top of 5.0.2 GA release.
To remove a patch, only Roll Back should be used in the Installation Manager.
Uninstalling the patch will completely remove the GA release along with the patch(s) installed on top of it.
Procedure to install the Data Collection Component patch:
- Stop the DCC server.
- 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.
- Copy the server patch file into the /server/patch directory.
- Start the DCC server.
Procedure to uninstall the Data Collection Component patch:
- Stop the DCC server.
- Back up and remove the contents of the following directory: server_installation_directory/server/patch
- Start the DCC server.
Procedure to install the patch with JRS deployed on Apache Tomcat server:
- Stop the JRS Tomcat server
- Copy the following file to a backup directory in the event you need to revert the patch:
- JRS_Install\server\tomcat\webapps\rs.war
- Delete the following file:
- JRS_Install\server\tomcat\webapps\rs.war
- Delete the following directories:
- JRS_Install\server\tomcat\webapps\rs
- JRS_Install\server\tomcat\work\Catalina\localhost\rs
- Place the new rs.war file under JRS_Install\server\tomcat\webapps
- Start the server
Procedure to uninstall the patch with JRS deployed on Apache Tomcat server:
- Stop the JRS Tomcat server
- Restore the original rs.war that was backed up in step 2 of the install instructions to the following directory
- JRS_Install\server\tomcat\webapps\
- Delete the following directories:
- JRS_Install\server\tomcat\webapps\rs
- JRS_Install\server\tomcat\work\Catalina\localhost\rs
- Start the server
Procedure to install the patch with JRS deployed on WebSphere Application Server:
- Unzip the reporting-war zip file somewhere either on your local machine or on the JRS server.
- In the WAS Admin Console, stop the JRS application: Go to Applications > Application Types > Websphere enterprise applications, select the checkbox next to rs_war and click on Stop.
- Update the rs_war file: Select the checkbox next to rs_war and click on Update.
- Select "Replace the entire application", then browse to the new rs.war file from the unzipped directory 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 the JRS server. Follow the Fast Path installation, and accept all of the defaults.
- Save the configuration changes when prompted after the update completes.
- Start the JRS application: select the checkbox next to rs_war and click on Start.
Procedure to uninstall the patch with JRS deployed on WebSphere Application Server:
- Locate the rs.war file in the original JRS installation.
- In the WAS Admin Console, stop the JRS application: Go to Applications > Application Types > Websphere enterprise applications, select the checkbox next to rs_war and click on Stop.
- Update the rs_war file: Select the checkbox next to rs_war and click on Update.
- Select "Replace the entire application", then browse to the rs.war file in the original JRS installation 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 the JRS server. Follow the Fast Path installation, and accept all of the defaults.
- Save the configuration changes when prompted after the update completes.
- Start the JRS application: select the checkbox next to rs_war and click on Start.
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 | Description |
---|---|
Corrective |
This is a maintenance interim fix. It contains fixes for client-reported and internally found defects. |
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
This server patch contains fixes for the following defects: |
APAR (WorkItem URL) | Description |
Data Collection Component | |
PI28909 | [Backport 5.0.2] Dashboard report is showing the last time the Java ETLs were run not when the last DCC ETLs were run. |
PI29074 | [Backport 5.0.2] CQPAR00108139: Job status shows failure for all resource groups even though only one of them actually failed. |
PI30420 | [Backport 5.0.2] [DCC] Records marked as softdeleted in TIMESHEET could be active again - DCC. |
PI39043 | [Backport 5.0.2] DCC - Timesheet ETL issues. |
Jazz Reporting Service | |
PI31540 | [Backport 5.0.2] JRS data source issues when using LDAP and custom DW extension names that end with “.‿. |
PI33336 | [Backport 5.0.2] CQPAR00118878: Custom Enumerations in certain case display as literal ID instead of name. |
PI33321 | [Backport 5.0.2] CQPAR00118829: JRS Not able to Handle RQM Categories like Attributes. |
PI28909 | [Backport 5.0.2] Missing custom link types for requirements. |
PI36076 | [Backport 5.0.2] Issues with RM custom attributes. |
PI28909 | [Backport 5.0.2] Able to download query spreadsheet non-authenticated/authorized, potential for malicious use and phishing attack. |
PI28909 | [Backport 5.0.2] JRS using the data warehouse is showing no results in non CM-enabled project traceability reports from requirements. |
PI36678 | [Backport 5.0.2] DW data source SQL queries do not handle a schema prefix. |
PI37951 | [Backport 5.0.2] Report Builder lists Soft Deleted project areas when selecting Scope. |
PI28909 | [Backport 5.0.2] JRS Failing to Input Validate and output encode data, leading to potential XSS (Cross Site Scripting) Vulnerability. |
Rational Jazz Foundation | |
PI28526 | NPE in ManagedFloatingLicenseClient$LeaseCache.getCheckoutOperations. |
PI28909 | Diagnostics Oracle JDBC Driver version check does not accept 12.1.0.2. |
PI28909 | Error during creation of Life Cycle Project in CLM 5.0.2RC1 with JazzProjectAdmins permission. |
PI28909 | Investigate implications of two components having the same ID. |
PI28909 | Issue #1 Maintenance 5.0.2 - PMC 341917. |
PI28909 | Issue #3 Maintenance 5.0.2 - PMC 341970. |
PI30407 | RTC ETL's should be able to handle date values where the year is not 4 digits long. |
PI30488 | DelegatedAuthHandler and LoginPageStatusHandler ignores com.ibm.team.jfs.app.oauth.OAuthHelper.disableSecureCookies property. |
PI31655 | The LPA templates can not be retrieved after a migration from 5.0.1 (with a server rename) to 5.0.2. |
PI31729 | 5.x Indexer for Excel can run out of memory. |
PI33689 | All Project Areas are deleted during upgrade to RDNG 5.0.2 if finalizeApplicationMigration is rerun following a failure. |
PI34460 | Adopt Report caching slow on Oracle (344963). |
PI35764 | Modify ClientHttpUtil to deal with an unexpected extra redirect when hitting /authenticated/identity (in 5.0.2 iFix). |
PI36337 | Project Dashboard shows incorrect content after loading a WI or Query Result and then performing a browser refresh in IE. |
PI37026 | Online Migration can skip states in the event of a retry-able DB exception (fix in 5.0.2). |
PI37053 | Creating iterations can break if translation is wrong (Fix in 5.0.2). |
PI37117 | Handle the query cancellation in query iterator and QueryFilter (resource context filter). |
PI38110 | Deleting resource in no-history storage area should not update history index to 502. |
TBD | Online migration can skip states on subsequent runs. |
Rational Team Concert | |
PI22400 | repotools -renindex gives an error: SEVERE: Failed to register SecureProtocolSocketFactory. |
PI25929 | RTC Planned-For drop down shows limited values. |
PI27899 | Build subset not building all dependent items as expected. |
PI28266 | Missing color expressions in 5.0.1. and newer (Server). |
PI28449 | 'undefined' state shown in dynamic query selection from Work Item widget. |
PI28775 | Adding literal to enumeration shows error. |
PI28849 | Removing the summary from the header section causes formatting problems - Advanced Fix. |
PI28849 | Removing the summary from the header section causes formatting problems. |
PI28909 | Back-port defect 347359 to 5.0.2 iFix005 - AbstractScmTypeHandler should implement INewTypeHandler.onTransactionFailed. |
PI28909 | SetBuildMapComponentUUIDTask - only the first 512 build maps are migrated. |
PI28965 | Kanban/Taskboard group by owner is slow with many users. |
PI29142 | Poor plan loading performance when there is a tree display with many layers. |
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. |
PI29150 | Clicking on "Select More Items" does not open the window "Access Context Selection" in the web client. |
PI29386 | Long option labels are not shown in QueryableComboView. |
PI29812 | parent links label when generated from work item template does not reflect latest summary when printed from the WebUI. |
PI29832 | [5.0.2 iFix 002] Improve user experience when dealing with large (1000+ 2048+) numbers of components. |
PI29946 | [Oracle] ROWNUM limit is applied before ORDER BY. |
PI30143 | Eclipse and WebUI do not generate the same descriptor for parameterized queries. |
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. |
PI30729 | WebUI - infinite calls to PlanRestService#postGetItems2() when loading a plan that has restricted visibility children. |
PI30751 | DependencyQueryService should run against the file without dependencies once. |
PI30880 | custom enum-type attribute is unexpectedly displayed in the history without "Synchronize Attributes" operation. |
PI30901 | Removed team member is still visible in the Work Breakdown view on WebUI. |
PI30946 | Dependency build automatically unlock the stream after 10 minutes. |
PI31096 | Source Code Data scanning service not picking up file name changes. |
PI31109 | Back-port defect 327641 to 5.0.2 iFix003 - Visual Studio: Cannot resolve a conflict because of this error message "Sync item with id '...' is not a conflict". |
PI31196 | Unexpected tab "Ups..." after creating new plan. |
PI31765 | Work items incorrectly linked to build when using subset builds. |
PI31814 | Clicking "Owned by" header in the plan view sorts the owners based on UUID, not the name. |
PI31829 | WorkItemPublisher does not check for array size in tagWorkItems(). |
PI32139 | Correct NPE when non-BF engine is defined for a BF definition for 5.0.2. |
PI32552 | Browser gets locked up in taskboard plan view with many owners. |
PI32589 | Backport blocking synchronization requests from 3rd party tool with an external system (RTC) to 5.0.2. |
PI32910 | class ISparqlQueryService failed to load for SystemDefinitionService. |
PI32965 | Fix defect 342786 for 5.0.2 iFix stream. |
PI33410 | Back-port defect 343463 to 5.0.2 iFix003 - RTC warehouse job SCM fails due to the error: [SQL0199] Keyword CONTENT not expected. |
PI33548 | Slow performance accepting change sets on MS SQL Server. |
PI33598 | Custom enum-type attribute is unexpectedly displayed in the work item editor without "Synchronize Attributes" operation. |
PI33717 | Plans with Circular Tracks References do Not Open. |
PI34027 | Adopt Only enumeration display name or value can be returned by Reportable REST API and not both (344297). |
PI34063 | Getting errors when executing concurrent builds during accept changes. |
PI34210 | Work Item Promotion creates a build property that can grow large enough to terminate the BFA process. |
PI34450 | Backport defect 340225 to 5.0.2 iFix004 - Unable To View .h and .c Files in Web Client. |
PI34496 | Drag & Drop Edit of "Work Item" Editor Presentation Layout is not working in 5.0.2. |
PI34523 | Investigate using transactional caches during history for versionable. |
PI34523 | [Defect 344131] Investigate using transactional caches during history for versionable. |
PI35066 | Promotion fails when there are more than 41 work-items. |
PI35071 | buildReport.xml not available in post-build script. |
PI35370 | Can't query buildPath from build maps anymore. |
PI35372 | When a gap is detected during promotion preview the error message displays the wrong change set. |
PI35420 | Cross repository tracks links with Accumulated Time column causes refresh loop and empty summary. |
PI36072 | Checkbox respond is slow when configuring Taskboard/Kanban States in Column Display tab. |
PI36955 | Inconsistent case in translation of "Unassigned" fails to load work items ~ "Não Designado" vs. "Não designado". |
PI37243 | Back-port defect 346552 to 5.0.2 iFix005 - RecentChangeSetsAffectingIterator pulls too much from the inner nodes affecting iterator. |
PI37399 | Creating a new linked WI in another Project Area is not working anymore. It will always create a new WI in the SAME Project Area/. |
PI38213 | Back-port defect 350470 to 5.0.2 iFix005 AcceptImpl.detectGaps should exhaust current page of iterator results before requerying. |
PI38707 | Collecting buildable files takes a long time for dependency build after all the files changed. |
This client update site contains fixes for the following defects: |
APAR (WorkItem URL) | Description |
Rational Team Concert Eclipse Client | |
PI28266 | Missing color expressions in 5.0.1. and newer (Eclipse Client). |
PI30775 | Issue with cross component re-factor (move). |
PI31109 | Fix for "327641: Cannot resolve a conflict because of this error message Problem running 'resolve conflict': <uuid> is not in conflict". |
PI31251 | [RichUI] Item is not located under the correct Folder. |
PI31674 | Sharing the query with a condition for querying multiple Types failed with a permission error. |
PI33972 | Back-port defect 344241 to 5.0.2 iFix003 - scm [not lscm] move path command leads to RuntimeException of the type CLIClientException: Attempted to beginRule: P/* does not match outer scope rule: F/*. |
PI34880 | Back-port defect 345551 to 5.0.2 iFix004 - NPE from scm show history. |
PI34940 | Fix for Conflict move needs to include unparented adds or moves (345423). |
PI35764 | Modify ClientHttpUtil to deal with an unexpected extra redirect when hitting /authenticated/identity (341149) -- Eclipse client -- 5.0.2 fix. |
PI36861 | Backport defect 348599 to 5.0.2 iFix004 - Moving an eclipse project in repository causes original project to become unshared, pending changes view still says its loaded. |
PI38273 | Back-port defect 351628 to 5.0.2 iFix005 - Exception occurred using CLI "scm move" command. |
SE59241 | SE59241 Language definitions appear in random order. |
Rational Team Concert Visual Studio Client | |
PI28909 | Request for multiple RTC 5.0.2 Backports [defects : 339231, 307440]. |
PI28909 | address issue in item 340443 - 5.0.2 iFix004. |
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. |
PI31109 | Back-port defect 327641 to 5.0.2 iFix003 - Visual Studio: Cannot resolve a conflict because of this error message "Sync item with id '...' is not a conflict". |
PI33273 | In intermediate history on a file, disable context menu options in case of Undo state. |
APAR (WorkItem URL) | Description | Steps to apply |
Rational Jazz Foundation | ||
PI22400 | Fix defect in redirect web page. |
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,
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
DEPLOYING ON TOMCAT
|
PI28909 | Use TLS instead of SSL by default. |
|
PI31655 | The LPA templates can not be retrieved after a migration from 5.0.1 (with a server rename) to 5.0.2. |
|
PI33587 | [5.0.2] LocalGroupLDAP doesn't support case insensitive mode (343625). |
This change is only relevant if you need to use LocalGroupLDAP in case insensitive mode.
|
PI33689 | All Project Areas are deleted during upgrade to RDNG 5.0.2 if finalizeApplicationMigration is rerun following a failure. |
|
Rational Team Concert | ||
PI22400 | repotools -renindex gives an error: SEVERE: Failed to register SecureProtocolSocketFactory. |
|
PI28909 | Back-port defect 347359 to 5.0.2 iFix005 - AbstractScmTypeHandler should implement INewTypeHandler.onTransactionFailed. |
The server patch from this iFix must be applied to 5.0.2 server BEFORE running the migration scripts for the fix to take effect. |
PI28909 | SetBuildMapComponentUUIDTask - only the first 512 build maps are migrated. |
This patch must be added to the 5.0.2 installation's patch directory after the 5.0.2 server is installed but BEFORE an attempt is made to migrate the 4.x or 5.0 data to 5.0.2. Since the fix is in the migration code itself, the issue can not be resolved if the 4.x or 5.0 has already been migrated to 5.0.2. In case for the migrated build definitions, customers have to set the property for each build definition in Properties tab as the following: team.enterprise.build.buildmaps.needMigrateComponent=true Then apply the fix and restart the 5.0.2 server, the migrated build definitions will be migrated again. Once the migration completed, the property above will be set to false by the migration service. |
PI33660 | Backport build: JBE changes directories when invoked on zLinux and PPC linux... |
When using jbe.sh for build on zLinux, pLinux and AIX for RTC 5.0.2, use the new jbe-i.sh or jbe-z.sh to replace <install-dir>/jazz/buildsystem/buildengine/eclipse/jbe.sh to fix APAR PI33660 depending on your platform. The script file should then be renamed to jbe.sh for compatibility with existing scripts. |
PI36803 | com.ibm.team.enterprise.build.ant_1.0.700.v20130903_1628.jar is missing from 4.0.5GA Build Toolkit zip on Linux for System Z. |
com.ibm.team.enterprise.build.ant_1.0.1200.v20141119_0341.jar is missing from Build Toolkit zip on Linux for system z for RTC 5.0.2 causing a ClassNotFoundException when running package. Following the instructions below to apply the mising jar:
|
Known Side Effects
Review the 5.0.2 Release Notes page on jazz.net for links to queries that list known problems and workaround articles for this release. |
Open defectsReview 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
No new features or functions in this iFix. |
Review the 5.0.2 New and Noteworthy page on jazz.net for a description of the new features included in this release. |
Click the link in the Download Options column:
Product Synonym
Rational Team Concert
Problems (APARS) fixed
Was this topic helpful?
Document Information
Modified date:
20 July 2018
UID
swg24039938