IBM Support

Rational Eclipse-based product help content is missing and help preferences are broken

Troubleshooting


Problem

The help content for IBM Rational Eclipse-based products may be missing, either topics in the Table of Contents, or some contextual help.

Symptom

The Preferences > Help > Content page appears twice in the preferences dialog, and neither of them can be edited.

The workspace/.metadata/.log file contains an error similar to the following:

java.lang.ArrayIndexOutOfBoundsException: Array index out of range: 2


at org.eclipse.help.ui.internal.preferences.ICPreferences.prefsToICs(ICPreferences.java:89)
at org.eclipse.help.ui.internal.preferences.ICPreferences.getICs(ICPreferences.java:68)
at org.eclipse.help.ui.internal.preferences.ICTable.loadPreferences(ICTable.java:279)
at org.eclipse.help.ui.internal.preferences.ICTable.<init>(ICTable.java:58)

Cause

This is caused by a corruption of a configuration file due to a formatting change.

This issue is generally found in shell-sharing scenarios where multiple Rational products are installed into the same Eclipse shell, or an upgrade of an existing product.

Resolving The Problem

WORKAROUND:

  1. Backup and delete the following directory (see note below) and file:
    • <product install folder>\configuration\com.ibm.ut.help.common
    • <workspace>\.metadata\.plugins\org.eclipse.core.runtime\.settings\org.eclipse.help.base.prefs

  2. Restart the product

Help will now be accessible.

Note: The configuration folder may be in other locations, depending on your Operating System setup. For example, if you do not have write access to the product install folder, the settings may be in your user directory. If you have a Windows redirected profile, you may need to look at your profile location for the configuration\com.ibm.ut.help.common folder.

[{"Product":{"code":"SSUC3U","label":"IBM Engineering Workflow Management"},"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Component":"Documentation","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"4.0.5","Edition":"","Line of Business":{"code":"LOB02","label":"AI Applications"}},{"Product":{"code":"SSYK2S","label":"Rational Software Architect Designer"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Eclipse","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}},{"Product":{"code":"SSRTLW","label":"Rational Application Developer for WebSphere Software"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Eclipse","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}},{"Product":{"code":"SSJK49","label":"IBM Developer for z Systems"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Component":"General Information","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Product":{"code":"SSAE4W","label":"Rational Developer for i"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Component":"General Information","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB08","label":"Cognitive Systems"}}]

Product Synonym

Rational Team Concert

Document Information

Modified date:
27 October 2020

UID

swg21664825