IBM Support

db2setup may throw error "No X11 DISPLAY variable was set"

Troubleshooting


Problem

db2setup may throw error "No X11 DISPLAY variable was set"

Cause

On Linux and UNIX operating systems, to install a DB2 product using the DB2 Setup wizard, you require an X Window System (X11) to display the graphical user interface (GUI). To display the GUI on your local workstation, the X Window System software must be installed and running, and you must set the DISPLAY variable to the IP address of the workstation you use to install the DB2 product.

Diagnosing The Problem

Running db2setup will return below error:


[root@a301-4973-7566 rtcl]# ./db2setup
DBI1190I db2setup is preparing the DB2 Setup wizard which will guide
you through the program setup process. Please wait.


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:220)
at java.awt.Window.<init>(Window.java:546)
at java.awt.Frame.<init>(Frame.java:431)
at java.awt.Frame.<init>(Frame.java:396)
at LoadingGraphic.<init>(Unknown Source)
at LoadingGraphic.main(Unknown Source)

The DISPLAY variable is not set properly. Ensure that the DISPLAY variable is set properly and that permissions are set properly to open windows on the display specified, then rerun the command.
[root@a301-4973-7566 rtcl]#

Resolving The Problem

Set the DISPLAY variable to the IP address of the workstation you use to install the DB2 product (export DISPLAY=<ip-address>:0.0).

For example, export DISPLAY=192.168.1.2:0.0

For details, see this developerWorks® article: http://www.ibm.com/developerworks/community/blogs/paixperiences/entry/remotex11aix?lang=en

Related Information

[{"Product":{"code":"SSEPGG","label":"Db2 for Linux, UNIX and Windows"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Install\/Migrate\/Upgrade - Install\/Setup - Command Line","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"}],"Version":"9.7;10.1;10.5","Edition":"Advanced Enterprise Server;Advanced Workgroup Server;Enterprise Server;Express;Personal;Workgroup Server","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
16 June 2018

UID

swg21964270