Remote Tools is a lightweight remote service provider that is included with the Parallel Tools Platform (PTP). To access the remote target system, PTP supports a number of remote service providers. Currently supported remote service providers include Remote Tools (part of PTP) and the Eclipse Remote Systems Explorer (RSE) which is an optional package that can be installed at any time. The preferred remote service provider is Remote Tools which supports all the PTP and Remote Development Tools (RDT) functionality, however some installations use additional features that are only available in RSE. Most PTP information is described using Remote Tools, since it is the simplest and easiest to use.
See also Local vs. Remote Projects for more information on local and remote projects.
Topics:
New connections are typically created when a need for them arises, such as creating a remote or synchronized project, or a run configuration on a remote target machine. To create a new connection to a remote machine, e.g. when creating a synchronized project, the new connection information is specified as part of the New Synchronized Project dialog.
Select New... and on the Target Environment Configuration dialog, specify a target name of your choice. Select Remote Host and fill in user name and password. Select Finish to create the connection.
See the PTP Wiki FAQ on tunneling for how to set up the tunnel. For example, pick an unused port > 1024 such as 7373 in this example:
ssh -L 7373:<target-host>:22 <intermediate-userid>@<intermediate-host>
Then in the connection dialog, Select Advanced... and use the same port number that you specified from the command line ssh command.
To edit remote connection information after a connection is created, e.g. to change userid, password, etc., first select the Remote Environments view.
If the view isn't visible, open it via Window > Show View > Other... and under Remote Tools, select Remote Environments.
![]()
To edit a connection, it must first be stopped if it is running. To stop a connection, select it and use the "red box" action on the Remote Environments view toolbar.
Once stopped, edit the connection via the context menu (right mouse)
Then make any changes to the connection and select Finish
The connection need not be manually restarted. It will automatically restart the next time that communication with the target machine is needed.
To remove a connection, select it in the Remote Environments view, from the context menu (right mouse), select Remove.
For convenient shell access to a remote system with a Remote Tools (or other) connection, within an Eclipse view, see Remote Terminal.
Previous versions of PTP required an ssh connection back to the local machine in order to launch a parallel application on the local machine. Now you need only specify Local for the connection type in the launch configuration. No "connection" is required.