====== FileZilla detailed configuration ======

<WRAP leftalign>
[[ configuracio_filezilla | Configuració detallada del FileZilla (en Català)]] | [[ https://sermn-uab-cat.translate.goog/wiki/doku.php?id=filezilla_configuration&_x_tr_sl=auto&_x_tr_tl=es | Other languages using Google Translate]]
</WRAP>


On this page we explain step by step with screenshots how to configure the program [[http://filezilla-project.org/ | FileZilla]] to access our data server and download your spectra. FileZilla is an FTP client with a graphical interface, and is available for Windows, Mac OS X and Linux.

These instructions are intended for users who are not familiar with FileZilla configuration. If you are a regular user of the program you can try using [[:howto_retrieve_your_data#quick_setup | the short setup instructions]] on the //How to recover your data// page.

<WRAP tip>
FileZilla allows you to configure Catalan and Spanish as the program's interface languages. Despite this possibility, in the following instructions we have used the texts and screenshots of the English version. In any case, the equivalence should be obvious.
</WRAP>

===== Download and install =====

First of all you will have to [[https://filezilla-project.org/download.php?show_all=1 | download the most current version]] for your operating system (Windows, Mac OS X, or Linux) and install it according to the [[https://wiki.filezilla-project.org/Client_Installation | instructions]] available on the program website.

As of February 2024, the most current version is 3.66.4, but since new versions come out quite often, you'll likely find a newer version to download and install.

It is highly recommended that you keep the program updated for security reasons. When the program detects that there is a new version, it will offer you to download and install it. We recommend that you update it before continuing with the download of your data. The update is a quick process, it does not affect your current settings, and once completed, the program will open and let you continue connecting and downloading data.
===== General configuration of the program =====

Once the FileZilla Client has been installed, before you can connect, you must
   * check the general configuration of the program; and
   * in the **"Site Manager"** you will have to create an //account// for our data server, where you will have to configure the connection parameters according to the instructions below.

To open the settings window for the program's general configuration options, click //Edit -> Settings//

{{ :informacio_usuaris:fset01-m.png | How to access the FileZilla client configuration window}}

In //Connection -> FTP// select the transfer mode //Passive//, which is the one used by our server,

{{ :informacio_usuaris:fset02-m.png | Transfer mode settings}}

and in //Connection -> FTP -> Passive mode// select the option //Use the server's external IP address instead// to avoid problems with our firewall,

{{ :informacio_usuaris:fset03-m.png | Transfer mode settings for Passive-FTP}}

In //Transfers -> File Types// select //Binary// as default transfer type,

{{ :informacio_usuaris:fset04a-m.png | Select binary as transfer mode}}

and**uncheck** the options //Treat files without extension...// and //Treat dotfiles as...//.

{{ :informacio_usuaris:fset04b-m.png | Remove all exceptions to binary transfer}}

<WRAP tip>
If you do not set these last two options correctly, the files containing the acquired data (//fid// and //ser//) as well as the transformed and processed data (//1r//, //1i//, //2rr//, //2ii//, ...) will be transferred incorrectly and you will lose the information they contain.
</WRAP>

Finally, in //Language// choose the interface language you prefer,

{{ :informacio_usuaris:fset05-m.png | Setting the interface language}}

and press the <key>OK</key> button to save your changes and exit the //Settings// window.

===== Connection settings =====

In order not to have to enter the connection parameters every time you want to connect to our server, it is highly recommended to create an account for our server in the //Site Manager// (Site Manager) of the FileZilla Client, and configure and save connection settings in this account.

To access the //Site Manager// you can do it through the menu //File -> Site Manager// (or directly with the keyboard shortcut <key>Control</key><key>s</key>),

{{ :informacio_usuaris:f02-m.png | Access the Site Manager through the menu}}

or by pressing the leftmost button in the button bar,

{{ :informacio_usuaris:f03-m.png | Access the Site Manager via the button bar}}

In the //Site Manager// window,

{{ :informacio_usuaris:f04-m.png | Site Manager window}}

press the <key>New Site</key> button to create a new site. A new node with the temporary name //New site// will appear in the //My Sites// tree

{{ :informacio_usuaris:f05-m.png | Site manager - create a new site}}

which you can ername to something more informative such as //SeRMN-UAB data server//

{{ :informacio_usuaris:f06.png | Site manager - rename the site}}

<WRAP tip>
In mid-2022 **we changed the FTPS server port number from 21 to <color red>990</color>** in order to use the official port number for this protocol:

**Port 990 Details**
\\ Service: ftps
\\ Details: FTPS Protocol, FTP over TLS/SSL (IANA official) uses ports 989 and 990.
\\ https://www.speedguide.net/port.php?port=990

</WRAP>

In the //General// tab enter the following values:

  * Host:  sermn.uab.cat
  * Port:  990  (cannot be left blank)
  * Protocol:   FTP - File Transfer Protocol
  * Encryption:   Require explicit FTP over TLS

and define the account type and access credentials. If this is a computer for exclusive use by members of the research group or your personal computer, set it up with

    * Logon Type:   //Normal//
    * User:    the //username// of your group (ask your group leader or a senior member)
    * Password:  the //password// of your group (ask your Group Leader or a senior member for it)

{{ :informacio_usuaris:f07-m.png | Site manager - General tab}}

If the computer is shared with other groups or people, set the //Logon Type// to //Interactive// so that FileZilla prompts for the username and password every time someone wants to connect. This will help to keep protected your data and the data of other members of your research group.

{{ :informacio_usuaris:f08-m.png | Site manager - General tb}}

The default values in the //Advanced//, //Transfer Settings// and //Charset// tabs are already correct, and you don't need to change anything, but if you want, in the //Transfer Settings// tab you can set the //Transfer mode// to //Passive//

{{ :informacio_usuaris:f10-12-m.png?800 | Site manager - Other tabs }}

Press the <key>Ok</key> button to save the settings and exit the //Site Manager// window.

{{ :informacio_usuaris:f13a-m.png | Site manager - Press OK to save the configuration }}

===== Example of transfer data session =====

Now that you have the program set up, you can try to connect and transfer data following the instructions described in the [[:howto_retrieve_your_data#example_of_data_transfer_session | general information page]].