Workarounds and Limitations: Known issues in IBM Rational Team Concert 6.0.6

Authentication fails when you link source control files from Eclipse 4.2.2 and earlier clients

First occurrence
6.0.6

Problem
An authentication error can occur when you create links between source control files in a global configuration if you use Rational Team Concert client for Eclipse IDE 4.2.2 or earlier and the Rational Team Concert server uses Jazz Authorization Server for authentication. Specifically, the client displays a login window with the message Contacting the authorization Server but the client cannot log in to the server. This problem occurs in Eclipse versions earlier than 4.4 that run the embedded browser in Internet Explorer 9 mode.

Workaround
Add this line to the eclipse.ini file where your Rational Team Concert Eclipse client is installed:

-Dorg.eclipse.swt.browser.IEVersion=11000

Related information
Work Item 451907

Conditions might be removed if queries created in the web client are edited in earlier versions of the client for Eclipse IDE

First occurrence
6.0.6

Problem
If you use version 6.0.6 or later of the Rational Team Concert web client to create a work item query that contains a Tags equals Unassigned condition, and then edit the query in version 6.0.5 or earlier of the client for Eclipse IDE, the Tags equals Unassigned condition might be removed.

Workaround
Do not use a version 6.0.5 or earlier client for Eclipse IDE to edit a work item query that was created or edited in the 6.0.6 or later web client.

Related information
Work Item 450401

Plans do not open in the 5.0.2 client for Eclipse IDE if they use a predefined small string attribute to sort work items

First occurrence
6.0.6

Problem
If you use the Rational Team Concert 6.0.6 web client to create a plan that uses a predefined small string attribute, such as status or resolution, to sort work items, you cannot open that plan in the Rational Team Concert 5.0.2 client for Eclipse IDE.

Workaround
Use the web client to work with the plan.

Related information
Work Item 448380

Excluded expressions are always listed as “All except business safe work types” in the SAFe Program process template

First occurrence
6.0.5

Problem
In a project area that uses the SAFe Program process template, when you edit a plan view and select Exclude and Expression, the editor sets the expression to All except business safe work types regardless of the expression that you select.

Workaround

1. Open the project area in the Rational Team Concert client for Eclipse IDE.
2. Click the Process Configuration Source tab.
3. Change the definition of the filter, and then save the project area:

Related information
Work Item 441262

Colors and gradients are missing or incorrect in versions of Eclipse 4.7

First occurrence
6.0.5

Problem
If you use Rational Team Concert P2 and any version of Eclipse 4.7, some colors and gradients might be missing or incorrect. For example, if you hover over the work item ID, the ID might be grayed out and unreadable. In other instances, an additional or unexpected color might be displayed.

These issues are caused by a problem with theme settings in Eclipse. In versions of Eclipse 4.5, the default theme is Windows. In versions of Eclipse 4.7, the default theme is Light. These issues do not occur in versions later than Eclipse 4.7, which have the default theme Windows Classic.

Workaround
In any version of Eclipse 4.7, change the theme from Light to Windows Classic:

1. In Eclipse, select Windows > Preferences > Search for Theme > Select Appearance.
2. On the Appearance tab, set the theme to Windows Classic.

Related information
Work Item 443424

Licensing errors might occur if you upgrade the Java environment or upgrade applications to version 6.0.5 or later

First occurrence
6.0.5

Problem
If you upgrade your version of Java to a fix pack that was built after April 2017, or you upgrade an application to version 6.0.5 or later and are using WebSphere Liberty, licensing errors might occur. The errors occur because earlier licenses were signed with the MD5 algorithm, which is now blocked by newer versions of Java.

For example, the License Key Management page for Jazz Team Server might display the following error in the Description field: CRJAZ1236I A development time license is being used. Similarly, the jts.log file might display the following error: CRJAZ0965I The file was not a valid server or client access license activation key.

The latest license files no longer contain the MD5 algorithm because IBM and Oracle Java introduced restrictions on JAR files that are signed with weak algorithms and keys.

Workaround
The licenses in the IBM Rational License Key Center were updated to use a different signature algorithm.

After you upgrade your server to version 6.0.5 or later, obtain the updated licenses from the IBM Rational License Key Center to replace your current licenses. If you previously used floating, token, or authorized user single install licenses, install their updated versions. Your existing user license assignments are kept during the installation of the updated licenses.

Important: If you are not upgrading all applications at the same time, you must apply an interim fix to the applications at earlier versions before you upgrade Jazz Team Server. The following interim fixes contain the compatible version of Java:

• 6.0.4 interim fix 007 and later
• 6.0.3 interim fix 010 and later
• 6.0.2 interim fix 015 and later
• No version of 5.0.2 contains a compatible Java version. For 5.0.2, complete the steps in the IBM Support flash article.

If you cannot apply the interim fix before the upgrade, upgrade Jazz Team Server and then complete the steps in the IBM Support flash article. If you do not apply the interim fix or complete the steps in the article, the internal licenses do not load on Jazz Team Server and the applications might experience issues.

To update your current license files, follow the instructions in the Interactive Upgrade Guide or complete the following steps based on the type of license:

For term (floating or authorized user) or token licenses:

Note: For token licenses, you are only required to download the jazztokens.zip file. You do not have to download the license.dat file because it does not contain changes.

1. Log in to Jazz Team Server, go to jts/admin > Server > License Key Management and note all the licenses on the server.
2. In IBM Rational License Key Center, under License Management, click Return Keys.
3. Click the product link that you want to return the license keys for, and then click Return.
4. After the license is returned, click Get Keys.
5. Click the product link to generate licenses for.
6. When prompted, provide the required information and click Generate.
7. Download the  file that contains the new licenses.
8. Log in to Jazz Team Server, go to Server > License Key Management and reimport the new license files.
9. To add a license, click Add, accept the license agreement if you agree to its terms, and then complete the steps in the wizard.

For non-term floating and authorized user licenses:

1. Log in to Jazz Team Server, go to jts/admin > Server > License Key Management and note all the licenses on the server.
2. In IBM Rational License Key Center, go to View keys by host or View keys by user.
3. Enter the information about the host or the user.
4. Select the product to generate the license for.
5. Click View Licenses for Selected Product Lines.
6. Select the license and click View Details.
7. Click Download Keys.
8. Log in to Jazz Team Server, go to Server > License Key Management and reimport the new license files.
9. To add a license, click Add, accept the license agreement if you agree to its terms, and then complete the steps in the wizard.

Related information
IBM Rational License Key Center
Interactive Upgrade Guide
Oracle release note: Restrict JARs signed with weak algorithms and keys

On case-insensitive macOS systems, existing SCM sandboxes must be repaired before use in 6.0.5 and later

First occurrence
6.0.5

Problem
Rational Team Concert 6.0.5 fixed several defects that affected source control management (SCM) operations on macOS systems. In previous releases, Rational Team Concert SCM operations treated all macOS file systems as case-sensitive, which caused problems because macOS systems can be case-insensitive. For details, see Work Item 416705, Work Item 417531, and Work Item 417542.

If you have sandboxes that were created before 6.0.5 on a case-insensitive macOS system, you must repair the metadata for those sandboxes. Otherwise, a warning is displayed when you start the client that prompts you to repair the metadata. If you use the client without repairing the metadata, you might see unresolved changes when there are none for files and directories whose names contain uppercase letters. Additionally, you will not be able to unload a repository workspace whose name contains uppercase letters.

Sandboxes on case-sensitive macOS systems are not affected and do not require their metadata to be repaired.

Workaround
In Rational Team Concert 6.0.5 and later, repair the metadata for existing sandboxes by using any of the following methods:

• In the warning that opens when you start the client, click the Repair Now button.
• Enter this command: scm repair -d sandbox-path
• In the client for Eclipse IDE, click Window > Preferences > Team > Jazz Source Control > Repair Metadata.

The metadata repair operation might take a long time to complete. An alternative to repairing the metadata is to create a new sandbox.

Related Information
Work Item 447226

URL for work item OSLC pickers has changed

First occurrence
6.0.4

Problem
In version 6.0.4 and later, the URL for the work item OSLC picker uses pickers instead of _ajax-modules.

The following example shows the new URL format:
https://jazz.net/jazz/pickers/com.ibm.team.workitem.WIPicker?projectAreaId=_1w8aQEmJEduIY7C8B09Hyw&showLoginLink=true&allowsMultiple=true

The following example shows the previous URL format:
https://jazz.net/jazz/_ajax-modules/com.ibm.team.workitem.WIPicker?projectAreaId=_1w8aQEmJEduIY7C8B09Hyw&showLoginLink=true&allowsMultiple=true

The previous format for URLs does not work with the picker dialog boxes.

Workaround
If you use a allowlist, change the URLs by replacing _ajax-modules with pickers.

Related information
Work Item 419973

IBM Installation Manager does not detect Microsoft Visual Studio 2017 when it is installed

First occurrence
6.0.4

Problem
When you install the IBM Rational Team Concert client for Microsoft Visual Studio IDE, an additional option for Visual Studio 2017 is available. The option is disabled if Visual Studio 2017 is not detected on the computer, or if the Visual Studio 2017 installation is corrupt. Microsoft provides a Setup API to query installed editions of Visual Studio 2017 with sample code and utilities at Microsoft/vs-setup-samples. Run the sample to determine whether your Visual Studio 2017 installation is corrupt.

Workaround
If the installation is corrupt, repair Visual Studio 2017 and ensure that it installs successfully:

1. Close IBM Installation Manager and all instances of Microsoft Visual Studio.
2. Repair Visual Studio 2017 by using the Visual Studio Installer as described in Modify, Repair, And Uninstall Visual Studio 2017 Using Visual Studio Installer.
3. Re-run IBM Installation Manager and confirm that the Visual Studio 2017 option is enabled.

Related information
Work Item 416092

Rational Team Concert client is not installed on all instances of Microsoft Visual Studio 2017

First occurrence
6.0.4

Problem
When you install the IBM Rational Team Concert client for Microsoft Visual Studio IDE from IBM Installation Manager and select Visual Studio 2017, the integration is installed on all instances of Microsoft Visual Studio 2017. However, if you install additional instances of Microsoft Visual Studio 2017 after you install the Rational Team Concert client, the integration is not available on the newly installed instances of Microsoft Visual Studio 2017.

Workaround
Re-install the Rational Team Concert client for Microsoft Visual Studio IDE by completing the following steps:

1. In IBM Installation Manager, select the Modify option, deselect Visual Studio 2017, and then finish the installation.
2. In IBM Installation Manager, select the Modify option, select Visual Studio 2017, and then finish the installation.

This process installs the Rational Team Concert client on all installed instances of Microsoft Visual Studio 2017.

Related Information
Work Item 416095

The “Story Points (numeric)” value is always 0

First occurrence
6.0.4

Problem
As part of the fix for Work Item 405355, enumeration literal values for the Complexity attribute were modified in the SAFe 4.0 Process (Program) template; however, the calculated script that uses this attribute was not updated. As a result, the calculated value for “Story Points (numeric)” is always 0.

Workaround
Complete these steps:

1. In the Eclipse client for Rational Team Concert, open the project area.
2. Go to the Process Configuration tab.
3. Expand Project Configuration > Configuration Data > Work Items and select Attribute Customization.
4. Expand Calculated Values and select Calculated Story Points (Numeric).
5. Update the switch condition in the script to use the new values:

       switch (a_label) {
     case ‘1 pt’:
      result= 1;
      break;
     case ‘2 pts’:
      result= 2;
      break;
     case ‘3 pts’:
      result= 3;
      break;
     case ‘5 pts’:
      result= 5;
      break;
     case ‘8 pts’:
      result= 8;
      break;
     case ’13 pts’:
      result= 13;
      break;
     case ’20 pts’:
      result= 20;
      break;
     case ’40 pts’:
      result= 40;
      break;
     case ‘100 pts’:
      result= 100;
      break;
        }

6. Go to Project Configuration > Configuration Data > Work Items > Types and Attributes and select the Story work item type.
7. Edit the Story Points (numeric) attribute.
8. Change Calculated Value Script to None, and then change it back to Calculated Story Points (Numeric).
9. Save the project.
10. Create a new Boolean attribute or use an existing attribute for the story work item. Make the calculated value dependent on this attribute.
11. Run a query that includes all the story work items that require the “Story Points (numeric)” attribute to be updated, and include the attribute in the query results.
12. Update the attribute to true, which triggers the new script and updates the values of existing work items.

Note: The script-based calculated values are not designed to detect updates to the script itself. If a dependent attribute is changed, in this case Story Points, it triggers the script execution.

Related information
Work Item 433587

An error is displayed when the Rational Team Concert Client Extension is installed with products based on Eclipse 4.6 (Neon)

First occurrence
6.0.3

Problem
When the Rational Team Concert Client Extension is installed with products that are based on Eclipse 4.6 (Neon), such as Rational Software Architect, an error might be displayed once each session with text such as An SWT error has occurred or No more handles.

Workaround
On Linux systems that use the apt-get tool to install software, run the following command to install the libwebkitgtk library:

sudo apt-get install libwebkitgtk-1.0-0

On Linux systems that use RPM to install software, such as Red Hat, download webkitgtk-2.4.9-1.el7.x86_64.rpm and run the following command to install it:

sudo rpm -ihv webkitgtk-2.4.9-1.el7.x86_64.rpm

Related information
Work Item 425554
Stack overflow: swt browser No more handles Error

Jazz repository login errors occur if the Rational Team Concert Client Extension is installed after Rational Software Architect

First occurrence
6.0.3

Problem
This issue occurs if you use IBM Installation Manager to install Rational Software Architect 9.5 or 9.6 (and possibly other versions) and then install version 6.0.3 interim fix 005 or later of the Rational Team Concert Client Extension for Eclipse 4.x. After you install the client extension, you cannot log in to the Rational Team Concert server and receive a Repository Connection Failed error or errors in the Eclipse error log that begin like this:

java.lang.NoClassDefFoundError: org.apache.http.impl.client.WinHttpClients
at com.ibm.team.repository.transport.client.RemoteTeamServer.isWindowsAuthAvailable(RemoteTeamServer.java:2590)
at com.ibm.team.repository.client.login.AbstractLoginInfo.isWindowsAuthPossible(AbstractLoginInfo.java:31)

Workaround
This issue does not occur if you install Rational Software Architect and the Rational Team Concert Client Extension at the same time. For new installations, use IBM Installation Manager to install both items at the same time.

If you already have Rational Software Architect installed, and then install the client extension and experience this issue, start the Eclipse IDE by using the -clean option. If you use a Windows shortcut to start the IDE, add -clean to the end of the Target field in the shortcut properties. If you start the IDE by running the Eclipse executable file from a command prompt, add -clean to the command argument list.

To correct the issue, you should only have to start Eclipse by using the -clean option once.

Related information
Work Item 416596

Known issues for Rational Team Concert on Eclipse 4.4 and 4.6

First occurrence
6.0.6

Problem
Starting in version 6.0.6, the downloads for the Rational Team Concert Client for Eclipse IDE are based on Eclipse 4.4. and 4.6. The following known issues are related to these versions of Eclipse.

Common issues

• The first time that you open the Rational Team Concert Client for Eclipse 4.4 IDE, the initialization process might take longer than with other Eclipse versions, and you might receive an Application is not responding message. In this case, wait for Rational Team Concert to initialize. For details, see Work Item 456354.
   
• The product Welcome might include visual issues and inconsistencies. For example, icons might not be visible and icon tooltips might be incorrect. For details, see Work Item 402442 and Work Item 432353.
   
• The Eclipse error log might show errors after the Rational Team Concert for Eclipse IDE opens for the first time, but which do not affect performance. For details, see Work Item 414649.

Linux-specific issues

• Linux systems can be difficult to configure for Eclipse because specific versions of support libraries are required, and Linux systems might not include these libraries or might have unsupported versions installed by default. For helpful configuration information about the Eclipse Standard Widget Toolkit, see The SWT FAQ. Specifically, see the GTK, WebKit, and XULRunner sections. For tips on avoiding specific issues, see Workaround: Running the Rational Team Concert Eclipse client on 64-bit Linux and Work Item 456519.
   
• Eclipse performance on Linux platforms in GUI mode is more reliable with desktop environments such as GNOME and Unity instead of others such as KDE. See the related Installation Manager support article: IBM Installation Manager on Linux platforms in GUI mode requires the GNOME desktop environment. If you experience setup or configuration issues, switching the desktop environment might help. For details, see Work Item 454223.
   
• To avoid windowing system errors and crashes on Ubuntu 16.04 LTS systems, and other systems, start from the command line with the following sequence:

Mac-specific issues

• Downloads of the Rational Team Concert client on macOS are initially in an untrusted (quarantined) state. To remove the quarantine flags, use the xattr command. For details, see Eclipse application might not start from the Finder on macOS when using the Rational Team Concert Eclipse 4.2 Client .zip download.
   
• To avoid the display issues described in Work Item 453595 and Work Item 454389, open Rational Team Concert by running the eclipse.sh script from a terminal command line prompt:

 

• The Eclipse error log on macOS might include errors about a bundle or extension named com.ibm.cds which cannot be found. You can ignore this error, or prevent it by editing the config.ini file as described in Work Item 454631.

Connecting to IBM Bluemix DevOps Services projects is no longer supported

First occurrence
6.0.5

Problem
In previous releases, you could connect from the Rational Team Concert client for Eclipse IDE and the Rational Team Concert client for Microsoft Visual Studio IDE to IBM Bluemix DevOps Services projects. You can no longer connect to IBM Bluemix DevOps Services projects from those clients. DevOps Services at hub.jazz.net is retired.

Related information
Work item 433977
Work item 433975

Custom Quick Planner views saved before version 6.0.5 do not load

First occurrence
6.0.5

Problem
In 6.0.5, Quick Planner Next is now the default Quick Planner interface. Quick Planner Next was available as a technical preview in 6.0.4. In 6.0.5, when you select Plans > Quick Planner, the new Quick Planner interface opens. If you saved a Quick Planner view before 6.0.5 and open the URL, the page does not load and the following error is displayed:

Unable to find a corresponding action for the specified ID.

You cannot migrate custom Quick Planner views that were created before 6.0.5. You must re-create these views in the new Quick Planner interface. The old Quick Planner interface is available in 6.0.5 only as a reference to re-create existing saved views.

To enable the deprecated Quick Planner menu option, edit the Quick Planner (deprecated) property on the Advanced Properties page of the administrative web client. For details about modifying advanced properties, see Configuring advanced properties.

After the flag is enabled, the Quick Planner (deprecated) menu option is displayed under the Plans component menu.

Related information
Work item 417753

Java 7.1 SR4 FP10 is not supported

First occurrence
6.0.5

Problem
Collaborative Lifecycle Management (CLM) applications that run on WebSphere Application Server Liberty (16.0.0.4 and 17.0.0.2) and that are configured with JRE 7.1 SR4 FP10 might crash. By default, versions 6.0.5 and later include a Java version that is stable.

Related information
Work Item 439584

Java 8 SR5 Fix Pack 5 through Fix Pack 10 is not supported as the runtime for CE/CLM applications on a Windows platform

First occurrence
6.0.5

Problem
Continuous Engineering (CE) and Collaborative Lifecycle Management (CLM) applications on a Windows platform that run on Java 8 SR5 Fix Pack 5 through Fix Pack 10 encounter null pointer exceptions and might not be usable. Use Java 8 SR5 Fix Pack 11 (8.0.5.11) or later as the runtime.

Related information
Work Item 455371
Work Item 452307
APAR IJ04429

Extensions should not be disabled or uninstalled from Microsoft Visual Studio 2017

First occurrence
6.0.4

Problem
When you install IBM Rational Team Concert into Microsoft Visual Studio 2017, the Rational Team Concert extensions are listed under Tools > Extensions and Updates. Do not disable or uninstall the Rational Team Concert extensions from within Visual Studio 2017. To install or uninstall the Rational Team Concert client for Microsoft Visual Studio IDE, use only IBM Installation Manager.

Related Information
Work Item 417681

Rational Team Concert Shell does not show the status of ignored files and folders

First occurrence
5.0

Problem
Rational Team Concert Shell uses overlay icons to indicate the source control status of files and folders in a sandbox. However, in Windows 8.1 and 10, Rational Team Concert does not use overlay icons to show the source control status of ignored files and folders. To view the source control status of a file or folder, right-click it; then, click Rational Team Concert > Pending Changes Status. If the file or folder is not ignored, and the overlay icon is not displayed, see Workaround: Overlay icons do not appear on files and folders in a sandbox in Rational Team Concert Shell to check for overlay icon issues in Rational Team Concert Shell.

Related information
Work Item 371097
Workaround: Overlay icons do not appear on files and folders in a sandbox in Rational Team Concert Shell

Load bars are inaccurate for users in different time zones from the server

First occurrence
3.0

Problem
If team members work in or have their computers set to a time zone that differs from the server’s time zone, the plan load bar and user load bar do not reflect the correct remaining time.

For example, if the server is set to Eastern Time (ET) and the scrum master checks the plan load at 09:00 ET, team members whose work day ends at 17:00 Indian Standard Time (IST) are incorrectly shown as contributing 8 hours of available load to the plan load for the current day. Because the work day is over for those team members, the plan load should not include any time for them.

When the scrum master checks the user load for team members in the IST time zone, the amount of available load differs based on the computer’s time zone:

• On a computer set to ET, the load bar shows 8 hours of available load.
• On a computer set to Pacific Time (PT), the load bar shows 7 hours of available load.
• On a computer set to IST, the load bar shows 0 hours of available load.

Related information
Work Item 437989
Work Item 138912
Assessing team work with progress and load bars