IBM Support

The launcheradmin.sh script generates a "No X11 DISPLAY variable was set, but this program performed an operation which requires it" error

Troubleshooting


Problem

Running the launcheradmin.sh script generates a "No X11 DISPLAY variable was set, but this program performed an operation which requires it" error.

Symptom

The launcheradmin.sh utility does not start and generates an error of:

Exception in thread "main" java.awt.HeadlessException:
No X11 DISPLAY variable was set, but this program performed an operation which requires it.
at java.awt.GraphicsEnvironment.checkHeadless (GraphicsEnvironment.java:174)
at java.awt.Window.<init>(Window.java:445)
at java.awt.Frame.<init>(Frame.java:414)
at java.awt.Frame.<init>(Frame.java:379)
at javax.swing.SwingUtilities.getSharedOwnerFrame (SwingUtilities.java:1830)
at javax.swing.JOptionPane.getRootFrame(JOptionPane.java:1684)
at com.ibm.websphere.dtx.launcher.gui.EventServerAdmin.<init> (Unknown Source)
at com.ibm.websphere.dtx.launcher.gui.EventServerAdmin.main (Unknown Source)
at com.ibm.websphere.dtx.launcher.gui.EventServerAdminConsole. main(Unknown Source)

Cause

The UNIX DISPLAY environment variable has not been set properly.

Environment

UNIX operating systems

Diagnosing The Problem

Check what the value of the DISPLAY environment variable is:

echo $DISPLAY

Resolving The Problem

If the value returned is blank or not the correct hostname, correct the DISPLAY value by exporting the DISPLAY environment variable. The syntax for this command is:

export DISPLAY=<hostname_to_display_X11_graphics_to>:0.0

Similar errors occur for the resourceregistry.sh and mgmtconsole.sh utilities and can also be corrected by exporting the DISPLAY environment variable.

[{"Product":{"code":"SSVSD8","label":"IBM Transformation Extender"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Launcher Administration","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"}],"Version":"8.3;8.4;8.4.1","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Product Synonym

Mercator Ascential DataStageTX

Document Information

More support for:
IBM Transformation Extender

Software version:
8.3, 8.4, 8.4.1

Operating system(s):
AIX, HP-UX, Linux, Solaris

Document number:
500635

Modified date:
16 June 2018

UID

swg21654543

Page Feedback