|
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 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).
For releases of WebSphere Application Server V6.0 and V6.0.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 > Environment
- 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:
- 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 V4.0:
- Open the Administrative Console.
- Navigate to the following:
WebSphere Administrative Domain > Nodes > node_name
> Application servers > application server on which
application is installed
- 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)
- Click OK, then click Apply.
- Restart the Application Server.
Notes:
- 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.
|
|
|
|
|
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 |
|
|
|
|
|
|