Workarounds and Limitations: Known issues in IBM Rational Publishing Engine 6.0.5
The following known problems are related to this release.
Workarounds
The following problems in this release have workarounds:
- Licensing errors might occur if you upgrade the Java environment or upgrade applications to version 6.0.5 or later
- Links in a generated Word document cause authentication errors
Limitations
The following problems in this release do not currently have workarounds:
- Java 7.1 SR4 FP10 is not supported
- Java 8 SR5 Fix Pack 5 through Fix Pack 10 is not supported as the runtime for Document Builder on a Windows platform
Workarounds
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.
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.
IBM Rational License Key Center
Interactive Upgrade Guide
Oracle release note: Restrict JARs signed with weak algorithms and keys
Links in a generated Word document cause authentication errors
First occurrence
2.1.2
Problem
If you generate a Microsoft Word document that contains hyperlinks to CLM artifacts, clicking a hyperlink in the Word document might fail and cause the following error after you complete the login for CLM:
Invalid path to authentication servlet.
Workaround
Complete the steps in the following article to add a registry key entry for Word, which enables you to successfully log in to CLM after clicking the hyperlink in the Word document:
Error message when clicking hyperlink in Office: “Cannot locate the Internet server or proxy server”
Related information
Work Item 414080
Limitations
Java 7.1 SR4 FP10 is not supported
First occurrence
6.0.5
Problem
Document Builder 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. Document Builder supports Java version 1.8.0 SR4 FP10, which is stable.
Related information
Work Item 439584
Java 8 SR5 Fix Pack 5 through Fix Pack 10 is not supported as the runtime for Document Builder on a Windows platform
First occurrence
6.0.5
Problem
Rational Publishing Engine Document Builder 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
© Copyright IBM Corporation 2018
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.