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:
- Make sure the X11 window server is running, and use the following command to note the port number:
ps -ef | egrep X11
- Set the environment variable for the application server JVM:
-
For releases of WebSphere Application Server V6.0.2 and V6.1 releases:
- Open the Administrative Console.
- Navigate to the following:
Server > Application Servers > application server on which application is installed
- Expand Java and Process Management, select the Process Definition > Custom Properties
- Click New and enter:
- DISPLAY in the Name field
- port # on which X11 is running in the Value field (default is :0.0).
- Open the Administrative Console.
- Navigate to the following:
Server > Application Servers > application server on which application is installed
- Expand Java and Process Management, select the Process Definition > Environment
- Click New and enter:
- DISPLAY in the Name field
- port # on which X11 is running in the Value field (default is :0.0).
- Open the Administrative Console.
- Navigate to the following:
Server > Application Servers > application server on which application is installed
- Under Configuration, select the Process Definition.
- Under Additional Properties, click Environment entries.
- Click New and enter:
- DISPLAY in the Name field
- port # on which X11 is running in the Value field (default is :0.0).
- Optionally, enter a description about this variable.
For releases of WebSphere Application Server V5.1 releases:
- 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.
- Use the xhost + command to make this variable to global scope with above.
| 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:
Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.