Workaround: Running the Rational Team Concert Eclipse client on 64-bit Linux

Evan Hughes, James Stuckey
Last Updated: January 28, 2014
Build Basis: Rational Team Concert 4.0

Summary

This workaround describes how to avoid the following issues from occurring when running the Rational Team Concert Eclipse client on 64-bit Linux platforms:

• No more handles [Unknown Mozilla path (MOZILLA_FIVE_HOME not set)] error
• XPCOM error -1041039104 message and crash

More Information

Problem

Some parts of the Rational Team Concert Eclipse client stop working, and the error message, No more handles [Unknown Mozilla path (MOZILLA_FIVE_HOME not set)], displays instead of the expected content. The Eclipse client might also display the error, An error occurred during creation of embedded help browser XPCOM error -1041039104, before crashing.

Environment

This issue occurs when running the 32-bit Rational Team Concert Eclipse client on 64-bit Linux distributions that do not have a 32-bit version of XULRunner installed. It can also occur when running a 32-bit or 64-bit Rational Team Concert Eclipse client (available in Rational Team Concert 4.0 and later) on 64-bit Linux distributions with a version of XULRunner that is incompatible with the underlying version of Eclipse.

Diagnosing the problem

After delivering a change set or saving a work item, the Team Advisor view displays the error, No more handles or XPCOM error -1041039104. The issue can also be seen when starting the local help system or when displaying the welcome page, as done on the initial launch of the client.

Reason

You are using a 32-bit Rational Team Concert Eclipse client, and the operating system does not ship a 32-bit XULRunner. Or you are using the 32-bit or 64-bit Eclipse client, and the operating system includes an incompatible version of XULRunner.

Workaround

• For 32-bit Rational Team Concert on 64-bit Linux:
  1. Install a 32-bit version of XULRunner:
     • yum install xulrunner.i686
  2. Restart the Rational Team Concert Eclipse client.


• For Rational Team Concert 3.x (which only supports 32-bit client install) or Rational Team Concert 4.x on 32-bit Linux:
  1. Install a compatible 32-bit XULRunner on the system.
  2. Update your eclipse.ini to point to the library (to ensure that it is being used) by adding a line similar to the following example to the vmargs:
     • Add -Dorg.eclipse.swt.browser.XULRunnerPath=/usr/lib/xulrunner-compat
• For Rational Team Concert 4.x on 64-bit Linux:
  1. Install a webkitgtk+ 1.2.x package on the system.
  2. Update your eclipse.ini, so that Eclipse uses webkitgtk, by adding a line similar to the following to the vmargs:
     • Add -Dorg.eclipse.swt.browser.UseWebKitGTK=true to the vmargs in the eclipse.ini, or install with eclipse 3.7.2+
  3. Alternately, you can install the Rational Team Concert Eclipse client with eclipse 3.7.2+, which supports additional versions of XULRunner. For details on supported XULRunner versions, see the link to the SWT FAQ in the related information section of this article.


• For Rational Team Concert 4.x on 64-bit Linux:
  • If you are using 64-bit Red Hat Enterprise Linux 6.x, you must use XULRunner 1.9.2.24 to avoid crashes of the embedded web browser.

Related Information

The following links point to related information:

• SWT FAQ on eclipse.org.
• Tech note request: How to correctly configure Xulrunner on Linux in support of Rational Team Concert Eclipse