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

Technote (troubleshooting)


Problem(Abstract)

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

Cause

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:
    For releases of WebSphere Application Server V6.0.2 and V6.1 releases:
    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 > 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).
    For releases of WebSphere Application Server V6.0 and V6.0.1 releases:
    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 > Environment
    4. Click New and enter:
      • DISPLAY in the Name field
      • port # on which X11 is running in the Value field (default is :0.0).

    For releases of WebSphere Application Server V5.1 releases:

    1. Open the Administrative Console.

    2. Navigate to the following:

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

    3. Under Configuration, select the Process Definition.

    4. Under Additional Properties, click Environment entries.

    5. Click New and enter:
      • DISPLAY in the Name field
      • port # on which X11 is running in the Value field (default is :0.0).

    6. Optionally, enter a description about this variable.
Notes:
  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

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

WebSphere Application Server
General

Software version:

5.1, 6.0, 6.1

Operating system(s):

AIX, HP-UX, IBM i, Linux, Solaris

Software edition:

Advanced, Base, Express, Network Deployment, Single Server

Reference #:

1163846

Modified date:

2006-12-14

Translate my page

Machine Translation

Content navigation