Troubleshooting
Problem
The Help application does not start when executed from a prompt or from the Help -> Help Contents menu item in IBM Rational Rhapsody. A blank dialog is displayed.
Symptom
In addition to the blank dialog, one of the following errors may appear in the log (<user home>/rcphelp/workspace/.metadata/.log):
- org.eclipse.swt.SWTError: No more handles [Unknown Mozilla path (MOZILLA_FIVE_HOME not set)]
- org.eclipse.swt.SWTError: No more handles [MOZILLA_FIVE_HOME='/usr/lib/mozilla'] (java.lang.UnsatisfiedLinkError: no swt-mozilla-gtk-3452 or swt-mozilla-gtk in swt.library.path, java.library.path or the jar file)
Cause
This problem is caused when a browser control cannot be embedded properly. The Help application is built on Eclipse, which uses SWT to display the help Browser control. SWT relies on individual operating systems to have an external browser which can be embedded in the SWT application.
Typically, this failure will not occur if the operating system has already included a supported browser with its packaging. If you have downloaded or upgraded Firefox using a download directly from mozilla.org, instead of using a packaged version for your operating system, then you will likely encounter this problem . More details can be found in the SWT FAQ at http://www.eclipse.org/swt/faq.php#browserlinux,.
Resolving The Problem
Common distributions are shipped with a version of Firefox AND the matching XULRunner. When performing an upgrade, you must obtain and install the correct XULRunner for the version of the browser you are using. This is an Eclipse/Linux requirement.
To resolve this problem and enable the display of the Rational Rhapsody help system, install the correct version of XULRunner for Linux. After doing this, SWT will be able to find the libraries at runtime and use them to create the Browser component. XULRunner for Linux can be downloaded from https://developer.mozilla.org/en/XULRunner_1.8.0.1_Release_Notes#Installing_XULRunner.
Specific browser criteria must be met to resolve the issue. Here are the supported environments for the Help application:
* Mozilla 1.4 GTK2 - 1.7.x GTK2 and XULRunner 1.8.x - 1.9.0.x.
A Firefox release whose contained Gecko version correlates with the Mozilla versions above can also be used with Eclipse 3.1 and newer (Linux only), provided that it has been compiled with linkable Gecko libraries. It is important to note that Firefox downloads from mozilla.org do not satisfy this criteria, but Firefox installations that are included in major Linux distributions often do in the absence of a XULRunner installation. Attempting to use a Firefox install without linkable Gecko libraries will display an error with message, "No more handles [NS_InitEmbedding...error -2147221164]".
Related Information
Product Synonym
Rational Rhapsody
Was this topic helpful?
Document Information
Modified date:
27 May 2022
UID
swg21422315