Syntax highlighting of SFTP

Here we will see how to retrieve MarsSI data using the Filezilla client software and the Secure File Transfert Protocol (SFTP).

{{{#!wiki note
Since SFTP is a well established standard, you can easily use other clients such as the sftp unix program or WinSCP, but documenting multiple client is outside of the scope of this page.
}}}

<<TableOfContents()>>

== Installing and configuring Filezilla Client ==

First, you need to download the Filezilla Client for MacOS/Linux distributions/Windows on their website: [[https://filezilla-project.org/download.php?type=client]], but Linux users should probably use their distribution package/application manager.

Install it, you can (and should) skip intalling the optionnal parts. Run it and select the site manager, circled in red on the following screenshot:

{{attachment:sftp_filezilla_1.png}}

Like in the screenshot bellow, use the button "New Site" (1.) to add a new bookmark that you can rename (2.). Then fill out the server information (3.) with:
 * Host: `lstemars.univ-lyon1.fr`
 * Protocol: `SFTP`
 * Logon type: `normal`
 * User: your MarsSI login
 * Password: your MarsSI password

{{attachment:sftp_filezilla_2.png}}

After that, you can connect to the server.

== Fetching MarsSI datasets ==

Once you triggered a copy action in MarsSI workspace tab (see [[Getting-started]] for more information about the application layout), the data will be copied to your personnal space in the MarsSI infrastructure.

You can then start FileZilla, open the site manager:

{{attachment:sftp_filezilla_1.png}}

Just select your MarsSI boorkmark from the site manager and click "connect":

{{attachment:sftp_filezilla_3.png}}

For your first connexion, you will get a popup dialog window to check the host identity:

{{attachment:sftp_filezilla_4.png}}

You can agree if the fingerprints are the same on the image above and remember your trust setting. Then you will get the main window:

{{attachment:sftp_filezilla_5.png}}

One panel is your local files, the other your workspace on MarsSI servers, where your copied datasets are organized by mission and instrument folders. Data can be transfered by dragging the directories/files accross the panes.