Difference between revisions of "Remote System Explorer SFTP Setup for Eclipse"
| (8 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
| − | {{todo| | + | {{todo|SEOKWREV (11.15.13-17:21->KY+);(11.17.13-20:15->MD+);(03.04.14-16:50->BS-)|Michael Gloff|project=oe 4,mg,ky,md,bs,SEOKWREV}} |
| − | The Eclipse Remote System Explorer plugin provides SSH File Transfer Protocol (SFTP) capabilities to facilitate the transfer of files between the development machine and the target machine. This includes a GUI service which allows developers to "drag-and-drop" files between the development and remote file systems and the ability for Eclipse to edit a file within a local editor and update the remote copy when saved. | + | {{#seo: |
| + | |title=Remote System Explorer SFTP Setup for Eclipse | ||
| + | |titlemode=append | ||
| + | |keywords=Remote System Explorer,SFTP Setup,Eclipse,Transferring Files,Remote File Editing | ||
| + | |description=The Eclipse Remote System Explorer plugin provides SSH File Transfer Protocol (SFTP) capabilities to facilitate the transfer of files between the development machine and the target machine. | ||
| + | }} | ||
| + | The Eclipse Remote System Explorer plugin provides SSH File Transfer Protocol (SFTP) capabilities to facilitate the transfer of files between the development machine and the target machine. This includes a GUI service which allows developers to "drag-and-drop" files between the development and remote file systems, and the ability for Eclipse to edit a file within a local editor and update the remote copy when saved. | ||
== Open the RSE Perspective == | == Open the RSE Perspective == | ||
The RSE plugin provides the Eclipse workbench with a new perspective that facilitates the use of its services. To open this perspective: | The RSE plugin provides the Eclipse workbench with a new perspective that facilitates the use of its services. To open this perspective: | ||
# Select ''Window -> Open Perspective -> Other...'' | # Select ''Window -> Open Perspective -> Other...'' | ||
| − | # In the ''Open Perspective'' dialog, select ''Remote System Explorer'' and click ''OK''. This should result in a screen similar to that shown in Figure 1 below. To add a new connection, follow the instructions for doing so on the [[Remote System Explorer Setup for | + | # In the ''Open Perspective'' dialog, select ''Remote System Explorer'' and click ''OK''. This should result in a screen similar to that shown in Figure 1 below. To add a new connection, follow the instructions for doing so on the [[Remote System Explorer Setup for Eclipse|RSE Setup Guide]]. |
| − | [[File:EMAC_Eclipse_RSE_Fresh_Perspective.png|600px|left|thumb|Figure 1: RSE Perspective]] | + | ::[[File:EMAC_Eclipse_RSE_Fresh_Perspective.png|600px|left|thumb|Figure 1: RSE Perspective]] |
<br clear=all> | <br clear=all> | ||
| Line 14: | Line 20: | ||
Once a remote connection has been established, it is possible to use the Remote System Explorer View, highlighted in Figure 2 below, to navigate the directories of the remote machine as well as the local machine. This view can also be used to graphically drag-and-drop files between machines. | Once a remote connection has been established, it is possible to use the Remote System Explorer View, highlighted in Figure 2 below, to navigate the directories of the remote machine as well as the local machine. This view can also be used to graphically drag-and-drop files between machines. | ||
| − | [[File:EMAC_Eclipse_RSE_Remote_Browse.png|600px|left|thumb|Figure 2. Browsing a Remote Filesystem]] | + | ::[[File:EMAC_Eclipse_RSE_Remote_Browse.png|600px|left|thumb|Figure 2. Browsing a Remote Filesystem]] |
<br clear=all> | <br clear=all> | ||
| − | The drag-and-drop feature of RSE's SFTP facility is no different than that on any other computer. The target file can actually be | + | The drag-and-drop feature of RSE's SFTP facility is no different than that on any other computer. The target file can actually be dragged from its source and dropped into its destination folder using drag-and-drop. Alternatively, the Remote Systems View context menu can be used to copy a file and then paste it into its destination. |
| − | {{mbox | type = notice | text = The Remove Systems View can be opened from any perspective by selecting ''Window -> Show View -> Other...'' It is then possible to drag and drop between the Project Navigator View and the Remote Systems View.}} | + | {{mbox | type = notice | text = The Remove Systems View can be opened from any perspective by selecting ''Window -> Show View -> Other...'' It is then possible to drag and drop between the Project Navigator View and the Remote Systems View.}}<br clear=all> |
== Remote File Editing == | == Remote File Editing == | ||
| Line 26: | Line 32: | ||
=== Create a New File === | === Create a New File === | ||
To create a new file: | To create a new file: | ||
| − | + | <cl> | |
| − | + | 1. Right-click on the directory in the Remote Systems Explorer View where the new file is to be located to bring up a context menu for that directory. | |
| + | * Select ''New -> File'' or ''New -> Folder'' to create a new file or directory. This will cause the New File prompt to appear as shown in Figure 3 below. | ||
[[File:EMAC_Eclipse_RSE_Create_New_File.png|600px|left|thumb|Figure 3. New File Dialog]] | [[File:EMAC_Eclipse_RSE_Create_New_File.png|600px|left|thumb|Figure 3. New File Dialog]] | ||
<br clear=all> | <br clear=all> | ||
| − | + | * Enter the name of the new file in the ''New file name:'' field and click ''Finish'' to create the file. | |
| − | + | </cl> | |
This procedure creates a new file in the specified folder, but does not open it in an editor. The next step is to learn how to open the remote file in an editor, make changes, then save those changes on the remote machine. | This procedure creates a new file in the specified folder, but does not open it in an editor. The next step is to learn how to open the remote file in an editor, make changes, then save those changes on the remote machine. | ||
| Line 47: | Line 54: | ||
==== Save a Remote File ==== | ==== Save a Remote File ==== | ||
| − | Saving a file during a remote edit session is no different than doing the same during a local edit session. Simply click the ''Save'' button or use the ''File -> Save'' or ''File -> Save As...'' menus. The Ctrl+S keyboard shortcut may be used as well. | + | Saving a file during a remote edit session is no different than doing the same during a local edit session. Simply click the ''Save'' button or use the ''File -> Save'' or ''File -> Save As...'' menus. The ''Ctrl+S'' keyboard shortcut may be used as well. |
== Next Steps == | == Next Steps == | ||
After editing and uploading a file on the remote machine, it can be manipulated using an SSH Shell or Terminal -- two additional services provided by the RSE plugin. See the [[Remote System Explorer Shell and Terminal Setup|RSE Shell and Terminal Setup]] page to learn more. | After editing and uploading a file on the remote machine, it can be manipulated using an SSH Shell or Terminal -- two additional services provided by the RSE plugin. See the [[Remote System Explorer Shell and Terminal Setup|RSE Shell and Terminal Setup]] page to learn more. | ||
| − | [[Category: | + | <!--[[Category:Eclipse]]--> |
Latest revision as of 15:45, 25 March 2014
The Eclipse Remote System Explorer plugin provides SSH File Transfer Protocol (SFTP) capabilities to facilitate the transfer of files between the development machine and the target machine. This includes a GUI service which allows developers to "drag-and-drop" files between the development and remote file systems, and the ability for Eclipse to edit a file within a local editor and update the remote copy when saved.
Contents
Open the RSE Perspective
The RSE plugin provides the Eclipse workbench with a new perspective that facilitates the use of its services. To open this perspective:
- Select Window -> Open Perspective -> Other...
- In the Open Perspective dialog, select Remote System Explorer and click OK. This should result in a screen similar to that shown in Figure 1 below. To add a new connection, follow the instructions for doing so on the RSE Setup Guide.
Transferring Files
Once a remote connection has been established, it is possible to use the Remote System Explorer View, highlighted in Figure 2 below, to navigate the directories of the remote machine as well as the local machine. This view can also be used to graphically drag-and-drop files between machines.
The drag-and-drop feature of RSE's SFTP facility is no different than that on any other computer. The target file can actually be dragged from its source and dropped into its destination folder using drag-and-drop. Alternatively, the Remote Systems View context menu can be used to copy a file and then paste it into its destination.
 | The Remove Systems View can be opened from any perspective by selecting Window -> Show View -> Other... It is then possible to drag and drop between the Project Navigator View and the Remote Systems View. |
Remote File Editing
RSE's SFTP offers the ability to edit a copy of a remote file then automatically upload the contents of that file when it is saved during the edit session. The Remote Systems View also provides the convenience of being able to create a new file on the remote system
Create a New File
To create a new file:
-
Right-click on the directory in the Remote Systems Explorer View where the new file is to be located to bring up a context menu for that directory.
-
Select New -> File or New -> Folder to create a new file or directory. This will cause the New File prompt to appear as shown in Figure 3 below.
-
Enter the name of the new file in the New file name: field and click Finish to create the file.
This procedure creates a new file in the specified folder, but does not open it in an editor. The next step is to learn how to open the remote file in an editor, make changes, then save those changes on the remote machine.
Edit an Existing File
Once a file exists on the remote machine, RSE provides the ability to edit it on the development machine without having to manually transfer the files between machines.
Open a Remote File
To open a remote file in Eclipse on the development machine:
- Right-click on the file in the Remote Systems Explorer View to bring up the Remote Systems View context menu.
- Click Open. Alternatively, click Open with... to see a list of editors available for that type of file.
The file should open in the Eclipse editor and allow you to make changes.
Save a Remote File
Saving a file during a remote edit session is no different than doing the same during a local edit session. Simply click the Save button or use the File -> Save or File -> Save As... menus. The Ctrl+S keyboard shortcut may be used as well.
Next Steps
After editing and uploading a file on the remote machine, it can be manipulated using an SSH Shell or Terminal -- two additional services provided by the RSE plugin. See the RSE Shell and Terminal Setup page to learn more.
