Known issues

Review the known issues for version 7.0.2.

The following issues in this release have workarounds.

Defect ID Description
73340

IBM® Knowledge Center Help content fails to load in IBM Engineering Lifecycle Optimization - Publishing Studio and Launcher

First occurrence: 7.0.1

Problem: The IBM Knowledge Center Help pages do not load when you access Help Contents from IBM Engineering Lifecycle Optimization - Publishing Studio and Launcher.

Workaround
  1. Go to PUB_InstallDir\jre\lib\security
  2. Open the java.security file.
  3. Change the keystore.type value from Windows-MY to jks and save the file.
  4. Restart IBM Engineering Lifecycle Optimization - Publishing Studio and Launcher and access Help.
62443

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 Java version 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, and the newer versions of Java blocked the MD5 algorithm. 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 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 License Key Center (formerly known as 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 License Key Center to replace your current licenses. If you previously used floating, token, or authorized user single installation 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. 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 need 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 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 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 nonterm 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 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.
Note: If you imported trial licenses before the newer versions of Java were adopted, you might still receive errors in the jts.log file even after you import the updated licenses. For example, you might receive this error: CRJAZ0965I The file was not a valid server or client access license activation key. You can ignore these errors.
73539

The clmhelp.war file and the updateSite.zip for release 7.0.2 are not available for download

First occurrence: 7.0.1

Problem: The clmhelp.war file and the updateSite.zip file for release 7.0.2 are not available for download due to technical issues.

Workaround: You can install the KCCI.zip file on your intranet server to view the help locally. Click here to download the ELM702_KCCI_contents.zip file. For more information, see Installing help on an intranet server topic.