If the remote host is running a firewall but is accessible via SSH, you can configure Eclipse to route its network traffic through a SOCKS proxy client such as PuTTY. The client forwards network traffic via the SSH daemon to the remote host machine.
You need the latest version of the PuTTY Telnet and SSH client. Download it from the PuTTY website -
click here.
The following example shows the two aspects of the configuration. Firstly, you need to configure the PuTTY Telnet and SSH client to act as a proxy client. Secondly, you will need to configure Eclipse to use the SOCKS network connection type to communicate network traffic.
Configuring PuTTY as the proxy server
-
In the PuTTY Telenet and SSH client, in the left panel, click
Connection > SSH > Tunnels.
This displays the
Options controlling SSH port forwarding panel.
-
Type an available listening port in the
Source port field.
-
Click
Dynamic.
-
Click
Add.
This adds the port number prefixed with a "D" in the
Forwarded ports field.
-
In the left panel, click
Connection > SSH > X11.
This displays the
Options controlling SSH X11 forwarding panel.
-
Check
Enable X11 forwarding.
-
In the
X display location field, type
localhost:0.
-
In the left panel, click
Session.
This displays the
Basic options for your PuTTY session panel.
-
In the
Host Name (or IP address) field, type the name or IP address of the remote server you want to connect to.
-
In the
Saved Sessions field, type a descriptive name for the session.
-
Click
Save.
This creates an entry in the
Saved Sessions list.
-
Click
Open.
This starts a terminal session. Type the username and password when prompted.
-
In the terminal window, type
echo $DISPLAY and press
Enter.
You should get a response similar to:
localhost:10.0
Make a note of the value that is displayed. It is required when configuring the Debug preferences.
Note: If you get a blank response to the
echo $DISPLAY command, right-click on the PuTTY terminal window header, and then click
Event Log. This opens the
PuTTY Event Log dialog. Scroll upwards from the bottom and make a note of any messages relating to access denied, forwarding refused or no program. Pass these details to your system administrator for resolution.
Configuring the Eclipse network connection
-
In Eclipse, click
Window > Preferences > General > Network Connections.
This opens the
Network Connections preferences dialog box.
-
In the
Active Provider list, select
Manual.
-
In the
Proxy entries table, click the
SOCKS row.
This highlights the row.
-
Click
Edit.
This opens the
Edit Proxy Entry dialog box.
-
In the
Host field, type
localhost.
-
In the
Port field, type the port number used in the
Source port field in PuTTY.
-
Click
OK.
This populates the
Host and
Port cells in the
Proxy entries table.
-
Click
Window > Preferences > Micro Focus > Debug.
This opens the debug preferences.
-
In the
Default X Server (DISPLAY) field, type the
DISPLAY value returned by the remote machine in step 13.
-
Click
Apply.
-
Click
OK.
Note: Steps 13, and 21-24 need to be performed each time the proxy server is started.
When you have completed the configuration you need to create a remote project. Specify
Remote file system (RSE) and select
Micro Focus DevHub using RSE when choosing the remote system type. See
Creating remote projects for more details on creating a remote project.
