Problem

Trying to debug a remote Unix/Linux project in Eclipse results in an error:

Resolution

To be able to debug a remote project you need to have an X Windows server running on the machine where you are running Eclipse.  In the debug launch configuration the Default X Server (DISPLAY) field must contain the machine name or IP Address of the machine where the X Windows server is running and should include the display number:

If the problem still occurs after checking the local configuration open the Remote Systems perspective, select the connection, right-click on Shells and select Connect.  This will open a remote shell in Eclipse.  Next you need to set the DISPLAY environment variable to the same value as used in the debug configuration and then enter the command xterm to open a new xterm session:

export DISPLAY=192.168.1.1:0.0

xterm

If this fails then either Xterm is not installed or is not in the PATH. 

If Xterm is not installed you must install it as this is a prerequisite for doing remote debugging.

If xterm is installed but not on the PATH you will need to stop the RSE daemon with $COBDIR/remotedev/stoprdodaemon, set the PATH to include the location of XTERM then relaunch the RSE Daemon using $COBDIR/remotedev/startrdodaemon.

If this still fails you should check any firewall or SELinux settings to ensure that the remote connection is allowed.