IBM Support

java.lang.InternalError: Cannot connect to X11 window server using ':0.0' as the value of the DISPLAY variable

Technote (troubleshooting)


When the DISPLAY environment variable is not set for the application server Java™ virtual machine (JVM) process, you receive a java.lang.InternalError.


When WebSphere Application Server is running on UNIX platforms that do not have graphics display support, the X11 server must be running to retrieve graphics from an application installed on WebSphere Application Server.

Resolving the problem

If you receive the error,

java.lang.InternalError: Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable

in the logs when attempting to serve a page with graphics content, following these steps to solve the problem:

  1. Make sure the X11 window server is running, and use the following command to note the port number:

    ps -ef | egrep X11

  2. Set the environment variable for the application server JVM:
    1. Open the Administrative Console.

    2. Navigate to the following:

      Server > Application Servers > application server on which application is installed

    3. Expand Java and Process Management, select the Process Definition > Java Virtual Machine > Custom Properties
    4. Click New and enter:
      • DISPLAY in the Name field
      • port # on which X11 is running in the Value field (default is :0.0).
  1. Setting the DISPLAY variable using script or in cell by issuing,

    setenv DISPLAY=localhost:0.0 export DISPLAY

    results in setting this variable for only that script process or for the cell with the local scope.
  2. Use the xhost + command to make this variable to global scope with above.

Cross reference information
Segment Product Component Platform Version Edition
Application Servers WebSphere Application Server for z/OS Not Applicable
Application Servers Runtimes for Java Technology Java SDK
Application Servers WebSphere Application Server for z/OS z/OS 6.1, 6.0

Document information

More support for: WebSphere Application Server

Software version: 7.0, 8.0, 8.5.5

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

Software edition: Advanced, Base, Express, Network Deployment, Single Server

Reference #: 1163846

Modified date: 14 December 2006