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 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.0 and 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.

For releases of WebSphere Application Server V4.0:

  1. Open the Administrative Console.

  2. Navigate to the following:

    WebSphere Administrative Domain > Nodes > node_name > Application servers > application server on which application is installed

  3. On the General tab, click Environment, then click Add and enter:
    • DISPLAY in the Name field
    • port # on which X11 is running in the Value field (default is :0.0)

  4. Click OK, then click Apply.

  5. Restart the Application Server.
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
 
 


Document Information


Current web document: swg21163846.html
Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > General
Operating system(s): z/OS
Software version: 6.0
Software edition:
Reference #: 1163846
IBM Group: Software Group
Modified date: Dec 14, 2006