![](/_scripts/dojo_dist/jazz/cs/graphics/Library/bttn_article52.gif)
Workarounds and Limitations: Known issues in Jazz Foundation 7.0
The following known problems are related to this release.
Workarounds
The following problems in this release have workarounds:
- Additional steps required after a server rename to correct contribution caching
- Client FullTextIndex data is obsolete and needs rebuild
- Tomcat is no longer supported as an application server
- Upgrade to Java 8 SR6 to avoid GPF error during full text reindexing
- Application menu is empty in the Add Association dialog box
- Licensing errors might occur if you upgrade the Java environment or upgrade applications to version 6.0.5 or later
- Global Configuration Management custom attributes and links are editable by default after upgrading from a pre-6.0.4 release
- Long response time for editing project areas with large numbers of project associations
Limitations
The following problems in this release do not currently have workarounds:
Workarounds
Additional steps required after a server rename to correct contribution caching
First occurrence
7.0
Problem
When performing a server rename process in 7.0, you might observe that the config-enabled ELM applications (GCM, DOORS Next, ETM, and EWM) using the default TRS-based contribution caching mode are not resolving to the correct local configuration. Depending on the consuming application, this could exhibit different behaviors such as errors, empty results, or resolving a global configuration context to an incorrect local configuration. Sometimes, these errors might also show up in the Current Configuration widget on the banner.
This issue does not appear if the advanced property Use MQTT for contribution cache is set to true for GCM application.
Workaround
After a server rename, clear the GC SDK cache in every application container (each instance of GCM, DOORS Next, ETM, and EWM).
To clear the cache, complete the following steps:
- As a JazzAdmin user for each application (GCM, DOORS Next, ETM, and EWM), go to its Configuration Diagnostics page: contextRoot/gcsdk/diagnostics.
- Click the Clear Configuration Cache button and click OK to the confirmation prompt.
Work Item 499182
FullTextIndex data is obsolete and needs to be deleted
First occurrence
7.0
Problem:
The FullTextIndex analyzers have been updated to generate proper tokens (indexing and searching) for version text.
For example, input text "eclipse 4.2.2" generates two tokens: "eclipse" and "4.2.2", instead of four tokens such as "eclipse", "4", "2", and "2". This update requires existing full-text search indexes that were created in previous releases to be rebuilt.
Workaround:
The Engineering Workflow Management (EWM) client for Eclipse IDE maintains a local full-text search index in the .metadata/.plugins/com.ibm.team.fulltext.client/fulltext_index folder in each Eclipse workspace. When you upgrade the EWM client for Eclipse IDE to 7.0, make sure you delete that folder in each workspace before you run the upgraded version of EWM.
Related information:
Tomcat is no longer supported as an application server
First occurrence
7.0
Problem
Starting in Engineering Lifecycle Management (ELM) V7.0 release, Tomcat is no longer supported as an application server. For details on the support and planning notes, see:
https://jazz.net/blog/index.php/2018/07/16/news-you-can-use-ceclm-support-and-planning-notes/
Workaround
When upgrading a Tomcat-based deployment to an ELM V7.0 (or later), you must base the new deployment on WebSphere Application Server or WebSphere Application Server Liberty Profile. The Interactive Upgrade Guide generates instructions for migrating from Tomcat to Liberty Profile. Migrating to a WebSphere Application Server profile must be done manually.
The command options related to migrating to a new Tomcat installation are removed from the upgrade scripts and the repository tools migration commands. The following attributes are no longer supported, and result in errors if you use them:
- updateTomcatFiles
- newApplicationTomcatHome
- newJTSTomcatHome
- newTomcatHome
repotools-<app> -migration_<app>_updateConfigurationFiles updateTomcatFiles=yes, where <app> is one of jts, ccm, rm, qm, gc, dcc, or relm.
Related information
Work Item 482145
Upgrade to Java 8 SR6 to avoid GPF error during full text reindexing
First occurrence
6.0.6.1
Problem
Release 6.0.6.1 and 7.0 requires rebuilding the full text search indexes. On 64 bit Linux servers, a defect in the IBM Java runtime environment (IJ20395 ) might cause a general protection fault (GPF) during the reindex process.
Workaround
When you upgrade to release 6.0.6.1 or 7.0, upgrade the IBM Java runtime environment to IBM Java 8 SR6 (version 8.0.6.0) before you perform the full text reindexing.
Related information
Application menu is empty in the Add Association dialog box
First occurrence
6.0.6
Problem
When you add an association to a project area, the Application menu in the Add Association dialog box might be empty. Typically, this issue occurs if you have several hundred project areas and use Mozilla Firefox as a web browser.
Workaround
Complete one of the following workarounds:
- Add the association by using another supported web browser.
- In Mozilla Firefox, close the dialog box and re-open it. It might take several attempts to populate the Application menu. Note: With hundreds of project areas, the dialog box can take 10 or more seconds to load.
Work Item 458116
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 and 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.
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.
- Log in to Jazz Team Server, go to jts/admin > Server > License Key Management and note all the licenses on the server.
- In IBM Rational License Key Center, under License Management, click Return Keys.
- Click the product link that you want to return the license keys for, and then click Return.
- After the license is returned, click Get Keys.
- Click the product link to generate licenses for.
- When prompted, provide the required information and click Generate.
- Download the file that contains the new licenses.
- Log in to Jazz Team Server, go to Server > License Key Management and reimport the new license files.
- To add a license, click Add, accept the license agreement if you agree to its terms, and then complete the steps in the wizard.
- Log in to Jazz Team Server, go to jts/admin > Server > License Key Management and note all the licenses on the server.
- In IBM Rational License Key Center, go to View keys by host or View keys by user.
- Enter the information about the host or the user.
- Select the product to generate the license for.
- Click View Licenses for Selected Product Lines.
- Select the license and click View Details.
- Click Download Keys.
- Log in to Jazz Team Server, go to Server > License Key Management and reimport the new license files.
- 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
Global Configuration Management custom attributes and links are editable by default after upgrading from a pre-6.0.4 release
First occurrence
6.0.4
Problem
In Global Configuration Management version 6.0.1, 6.0.2, and 6.0.3, custom attributes and links of baselines are read-only in the web client. If you upgrade from one of these releases to version 6.0.4 or later, the attributes and links are editable by default after the upgrade.
Workaround
If you prefer custom attributes and links of baselines to remain read-only after the upgrade, go to Manage Project Properties and clear the Allow editing on baselines check box for each item.
Related information
Work Item 370782
Long response time for editing project areas with large numbers of project associations
First occurrence
6.0.1
Problem
If you have a large number of project associations in a project area, selecting "Edit project area" in the web client kicks off a service on the JTS that can run for many hours. If you try to execute it again after the service times out, several processes run again and reduces the performance of the server as they use up all of the available CPU.
Workaround
There are two potential workarounds:
- Limit the number of project area associations in a single project area.
- If you cannot limit the number of project area associations, then use the Eclipse client to edit the project area.
Related information
Limitations
Known issue in translated versions of ELM 7.0 documentation
First occurrence
7.0.0
Problem
The table of contents for ELM 7.0 documentation on IBM Knowledge Center might display long navigation titles in place of short titles for content in languages other than English.
Related information
Task 496011
© Copyright IBM Corporation 2021
Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means.
Learn more here.