Additional configuration requirements for Linux operating systems

If you use a Linux operating system, then you must check that your computer meets the requirements listed in this topic.

Environment variable might need setting for Firefox or Mozilla browsers

You might need to set the environment variable MOZILLA_FIVE_HOME to the folder containing your Firefox or Mozilla installation. For example, setenv MOZILLA_FIVE_HOME /usr/lib/firefox-1.5.

If you do not set this environment variable, then when you run the product you might see the following error message: org.eclipse.swt.SWTError: No more handles [Unknown Mozilla path (MOZILLA_FIVE_HOME not set)]

Firefox browsers must be dynamically linked

To support the SWT browser widget, your Firefox browser must be dynamically linked, which means it was not downloaded from mozilla.org, but was compiled from source. This is typically the case when the Firefox comes as part of the distribution (that is, it is in a place such as /usr/lib/firefox).

One way to ensure that the browser is dynamically linked is to see whether it is the browser that is pointed at by /etc/gre.conf. The purpose of this gre.conf file is to point to an embeddable browser.

If your browser is not dynamically linked, then you might see the following error message when you run the product:

org.eclipse.swt.SWTError: No more handles (java.lang.UnsatisfiedLinkError: /home/n0002466/.eclipse/ibm.software.development.platform_7.0.0/configuration/org.eclipse.osgi/bundles/267/1/.cp/libswt-mozilla-gtk-3236.so (libxpcom.so: cannot open shared object file: No such file or directory))

Installation requirements for embedded browsers on Linux systems

On Linux systems, the Eclipse Standard Widget Toolkit (SWT) might not be able to find and use the default native browser. Additional steps might be required to configure the browser setup before the product works correctly. For information about installation requirements for embedded browsers on Linux systems, see: http://www.ibm.com/support/docview.wss?uid=swg21616810

SUSE Linux might require a fix for invisible text problem

If your operating system is SUSE Linux Enterprise Desktop 10 SP1 or SUSE Linux Enterprise Server 10 SP1, then you might need the following operating system update to resolve a problem with text not being displayed in some editors: http://support.novell.com/techcenter/psdb/44ab155e3202595389c101e6cf7e20f2.html

Red Hat Enterprise Linux 6 requires specific versions of XULrunner

If your operating system is Red Hat Enterprise Linux 6, to ensure that the product starts smoothly as expected and to prevent the product from crashing as a result of a module libxul.so error, you must have a supported version of Mozilla XULrunner installed, following the instructions and workaround as described in this document: http://www.ibm.com/support/docview.wss?uid=swg21598554

Feedback