IBM Support

XULRunner version issue on RHEL and CentOS systems

Technote (troubleshooting)


If you are running InfoSphere® Streams Studio on a RHEL or CentOS system, you might experience problems with the Streams Studio Eclipse help system and the internal browser feature. This can occur if your version of XULRunner is not compatible with your Eclipse version.


When running Streams Studio on RHEL or CentOS, Version 5.8, or later, you experience one of the following problems:

  • Accessing links to HTML pages in the Eclipse help system opens an external browser window.
  • The internal browser feature is disabled (Windows > Preferences > General > Web Browser).
  • Streams Studio crashes when you use the hover help.

You might also receive warning messages similar to the following example, which indicate that serious SWT errors have occurred and that you need to restart Eclipse.

                org.eclipse.swt.SWTError: XPCOM error -2147467262
                    at org.eclipse.swt.browser.Mozilla.error(
                    at org.eclipse.swt.browser.Mozilla.unhookDOMListeners(
                    at org.eclipse.swt.browser.Mozilla.onDispose(
                    at org.eclipse.swt.browser.Mozilla$5.handleEvent(
                    at org.eclipse.swt.widgets.EventTable.sendEvent(
                    at org.eclipse.swt.widgets.Widget.sendEvent(
                    at org.eclipse.swt.widgets.Widget.sendEvent(
                    at org.eclipse.swt.widgets.Widget.sendEvent(
                    at org.eclipse.swt.widgets.Widget.release(
                    at org.eclipse.swt.widgets.Control.release(
                    at org.eclipse.swt.widgets.Composite.releaseChildren(
                    at org.eclipse.swt.widgets.Canvas.releaseChildren(


XULRunner Version 10, or later (XULrunner-2) is not compatible with all releases of Eclipse 3.6 and 3.7.

Note: XULRunner is updated as a dependency when you update the Firefox browser to Version 10, or later.

Resolving the problem

      • There is no solution for this problem for IBM® POWER7® systems because there is no version of XULRunner for IBM POWER7 systems that is compatible with Eclipse 3.6 or Eclipse 3.7.
      • On x86_64 systems, download XULRunner Version 1.9.2 and make it available for Streams Studio.
        1. To download the XULRunner tar file, go to
        2. Extract the contents of the tar file by entering the following command:
          tar -xvif tar-file-name
        3. You can make the new XULRunner version available to Streams Studio using the following methods:

          • Update the Streams Studio streamstudio.ini file and add the following line at the end of the file:

            Note: This update applies to a specific instance of Streams Studio. If the instance of Streams Studio was installed for an individual user, the update only applies to that user. If Streams Studio was installed as a shared instance that is used by multiple users, the update applies to all users of the shared instance.
          • The following procedure makes the new version available to all users on the system:
            • As user root, extract the XULRunner runtime directory to a location that is accessible to all users, for example, /usr/lib/xulrunner-1.9.2.
            • From the XULRunner directory, enter the following command:
              ./xulrunner --register-global
          • The following procedure makes the new version available to an individual user
            • Extract the XULRunner runtime directory to the home directory of the user.
            • From the XULRunner directory, enter the following command:
              ./xulrunner --register-user
          • Note: Registering XULRunner persists across system and Stream Studio restarts.
        4. Restart Streams Studio and confirm that the issues have been resolved.

      To uninstall XULRunner, use the following methods:

      • If you updated the streamstudio.ini file, remove the following line from the file:

      • If the xulrunner --register-global command was used to make the version available to all users on the system, enter the following command:

        ./xulrunner --unregister-global
      • If the xulrunner --register-user command was used to make the version available to an individual user, enter the following command:

        ./xulrunner --unregister-user

Document information

More support for: IBM Streams

Software version: 2.0

Operating system(s): Linux

Reference #: 1592804

Modified date: 08 May 2013

Translate this page: