Remote System Explorer Setup for Eclipse

TODO: {{#todo:SEOKWREV (11.15.13-15:56->KY+);(11.17.13-22:100>MD+);(03.04.14-16:50->BS-);(03.25.14-16:30->BS+)|Michael Gloff|oe 4,ky,mg,md,bs,SEOKWREV}}

The Remote Systems Explorer (RSE) is a useful tool for implementing remote development on EMAC products. However, it does require some initial setup. This page will guide developers through the process of selecting the RSE perspective in Eclipse and using it to create a connection in the Remote Systems View.

Open the RSE Perspective

The first step to any task involving remote application development, execution, or debugging is to open the RSE Perspective. Follow the steps below to begin this process.

Procedure

1. Open the Eclipse application
2. Select Window -> Open Perspective -> Other...
3. Select Remote System Explorer as shown in Figure 1. The list of available perspectives may differ depending on which plugins are installed in Eclipse.

Figure 1: Open Perspective Dialog

Create a Remote Connection

This set of configuration steps assumes that Eclipse has the RSE Perspective active.

Procedure

1. Right-click anywhere in the Remote Systems view

2. Select New -> Connection... See figure 2.

   

   Figure 2: New Remote Connection

   
   

3. Select General -> SSH Only and click Next > in the Select Remote System Type dialog.

   

   Figure 3: Select Remote System Type

   
   

4. Using Figure 4 as a guide, enter the following information:

   • Enter the IP address or host name of the target board in the Host name: field

   • Optionally, enter a Connection name and Description

   • Leave all other options set to their defaults

   

   Figure 4: Remote SSH Only System Connection

   
   

5. Click Finish. Once the remote connection is created, the Eclipse workbench should appear as shown in Figure 5 below.

   

   Figure 5: Initial RSE Perspective With New Connection

   
   

   
   

Initiate an RSE Connection

To use the new connection to the remote machine:

1. Right-click on the new connection created above in the Remote Systems View.

2. Select Connect

3. Set the User ID to the user you wish to use on the remote system. The default user for EMAC products is root.

4. Set the Password for the user chosen in the previous step. The default password for the default EMAC user is emac_inc.

Once connected, the Properties View and the Remote System Details View will be updated to reflect the remote system's details. This is shown below in Figure 6. Note that the Remote System Details View also shows information about local host connections.

Figure 6: RSE Perspective With Active Connection

Figure 6 has the Properties View highlighted in red and the Remote System Details View highlighted in blue. The Properties View provides information about, but no control over, the remote system whereas the Remote System Details View provides control in the form of the same connection context menu available in the Remote Systems View.

Next Steps

Learn more about RSE by following the RSE SFTP setup guide.