@@ -17,14 +17,14 @@ LCSB file transfer (LFT) is provided by IBM Aspera software deployed at the LCSB
## Obtaining a LFT access link
You need an **access link** to use LFT. An access link is a temporary, password-protected space, much like a drop box, on LCSB file transfer server. In order to obtain an access link, you should contact your research collaborator at the LCSB-University of Luxembourg. Once created, you will receive your **access link** and associated **password**(link) by e-mail.
You need an **access link** to use LFT. An access link is a temporary, password-protected space, much like a drop box, on LCSB file transfer server. In order to obtain an access link, you should contact your research collaborator at the LCSB-University of Luxembourg. Once created, you will receive your **access link** and associated **password** by e-mail.
> **IMPORTANT NOTE: Whenever the LCSB shares a password for an LFT endpoint (collaborator), the password is transmitted via a link which will expire in one week. Therefore you should make a record of your password once you view it.**
An access link can be reached via standard web browsers. Data can be transferred to/from an access link in two ways:
* Through the web browser by visiting the link, which is our recommended way of data transfer, described in this [section of the guide](#LFT_WEB)
* Through the use of a command line tool. If your data sits in an environment, where you can not launch a web browser, then you may use use a command line client tool to reach an access link. This process is described in this [section of this guide](#LFT_CLI).
* Through the web browser by visiting the link, which is our recommended way of data transfer, described in this [section of the guide](#LFT_WEB).
* Through the use of a command line tool. If your data sits in an environment, where you can not launch a web browser, then you may use a command line client tool to reach an access link. This process is described in this [section of this guide](#LFT_CLI).
The use of LFT is mediated by LCSB's data stewards. If you require assistance in using LFT, you should send an email to the [LCSB datastewards](mailto:lcsb-datastewards@uni.lu) or refer to the [Troubleshooting](#LFT_TROUBLESHOOTING) section of this guide.
...
...
@@ -34,7 +34,7 @@ The use of LFT is mediated by LCSB's data stewards. If you require assistance in
In the following steps we provide instructions on how to use LFT web interface.
1. Once you receive your **access link** and **password** from the LCSB, visit the link using a standard web browser. Firefox 66.x (or higher) recommended, but others should also work. You will be prompted for your password (see below).<br/>
1. Once you receive your **access link** and **password** from the LCSB, visit the link using a standard web browser. Firefox 66.x (or higher) is recommended, but others should also work. You will be prompted for your password (see below).<br/><br>
![Alt](img/lft_password.png"Password request")
2. When you visit an LFT access link for the very first time, you will be prompted to install or update **IBM Aspera Connect** client.
...
...
@@ -42,7 +42,7 @@ In the following steps we provide instructions on how to use LFT web interface.
* click **Install Connect** button (see below). <br/>![Alt](img/lft_install.png"Install Aspera Connect")
* open the installer just downloaded and start the installer. <br/>![Alt](img/lft_installAsperaConnect.png"Run installation of Aspera Connect")
* close the installer - *depending on your Operating System the Aspera Connect can try to open and you may be asked if you are sure to open it* -
* the prompt should disappear and you should see <br/>![Alt](img/lft_AsperaConnectInstalled.png"Aspera Connect is installed")
* the prompt should disappear and you should see the following message <br/>![Alt](img/lft_AsperaConnectInstalled.png"Aspera Connect is installed")
3. The **access link** page will display a **File Browser** section. Depending on the settings per access link, users can create or delete folders in the File Browser and upload and/or download data.<br/>
![Alt](img/lft_fileBrowser.png"File Browser")
...
...
@@ -51,9 +51,11 @@ In the following steps we provide instructions on how to use LFT web interface.
> Note: to download file/folder you need to select it first.
5. At any time you can launch **IBM Aspera Connect** to display the status of uploads to or downloads from your computer. <br/>
![Alt](img/lft_status.png"Aspera Connect status")
6. All data are encrypted on server side and they stay encrypted also upon download. For decryption, you have to navigate into your **IBM Aspera Connect** window and click "**Unlock encrypted files**". <br/>
@@ -66,35 +68,42 @@ Encrypted files are by default kept on your disc after decryption. If you want t
## Accessing LFT via Command-Line Tool
1. To access LFT via command line you need to have Aspera CLI (Command Line Interface) be installed. It should be preinstalled during installation of **IBM Aspera Connect** client (see step 2 above). Or you can download it manually on the [IBM website](https://www.ibm.com/products/aspera/downloads?list) and click on the "download now" under the Section "IBM Aspera CLI".
In the following steps we provide instructions on how to use LFT command line.
1. To access LFT via command line you need to have Aspera CLI (Command Line Interface) be installed. It should be preinstalled during installation of **IBM Aspera Connect** client (see step 2 above). Or you can download it manually: go on the [IBM website](https://www.ibm.com/products/aspera/downloads?list) and click on the "download now" under the Section "IBM Aspera CLI".
2. To transfer data you need to authenticate your connection. Authentication is done via SSH for which you need **SSH private key**. That key comes with the Aspera Connect installation and is named `asperaweb_id_dsa.openssh` (see Note below). You need to know the location of SSH private key. Please see the table below for the list of locations depanding on your operational system:
2. To transfer data you need to authenticate your connection. Authentication is done via SSH for which you need **SSH private key**. That key comes with the Aspera Connect installation and is named `asperaweb_id_dsa.openssh`. You need to know the location of SSH private key. Please see the table below for the list of locations depanding on your operational system:
You can use the official [IBM Aspera Diagnostic Tool](https://test-connect.asperasoft.com/) to troubleshoot your connectivity issues.
### ** Command-line error: failed to authenticate**
Aspera Connect 4.2 no longer includes the required SSH (`asperaweb_id_dsa.openssh`) private key.
Please follow [this guide](https://www.biostars.org/p/9528910/) and install older version of Aspera Connect.
### **Using Microsoft Edge browser**
Microsoft Edge browser requires to download and install [IBM Aspera Connect for Edge](https://microsoftedge.microsoft.com/addons/detail/ibm-aspera-connect/kbffkbiljjejklcpnfmoiaehplhcifki).
