diff --git a/external/exchange-channels/lft/img/lft_AsperaConnect.png b/external/exchange-channels/lft/img/lft_AsperaConnect.png new file mode 100644 index 0000000000000000000000000000000000000000..0efef1481f82b599c4767fdc962d173b02f31d19 --- /dev/null +++ b/external/exchange-channels/lft/img/lft_AsperaConnect.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:04b02f26d85d3cc39757de02f33ae752f37a59f37c95b41fa9fd5caff1ab45f4 +size 22238 diff --git a/external/exchange-channels/lft/img/lft_AsperaConnectInstalled.png b/external/exchange-channels/lft/img/lft_AsperaConnectInstalled.png new file mode 100644 index 0000000000000000000000000000000000000000..632f239b75c575a900a8b1f241854a998514e923 --- /dev/null +++ b/external/exchange-channels/lft/img/lft_AsperaConnectInstalled.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:1804813e5927e453bc224a20c2568659e232b769c97a2baa3a50f46bd7d14816 +size 6104 diff --git a/external/exchange-channels/lft/img/lft_AsperaCrypt.png b/external/exchange-channels/lft/img/lft_AsperaCrypt.png new file mode 100644 index 0000000000000000000000000000000000000000..686fb1c6ccec2bcd69cd7c7952d3a607504b59ce --- /dev/null +++ b/external/exchange-channels/lft/img/lft_AsperaCrypt.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:470c8201733ba0b7c67a6cce7407d2067b0ed884dff99022798dcd22a7f42440 +size 20103 diff --git a/external/exchange-channels/lft/img/lft_FirefoxAddOn.jpg b/external/exchange-channels/lft/img/lft_FirefoxAddOn.jpg new file mode 100644 index 0000000000000000000000000000000000000000..d926d741e9357644ad5777287b9afc550d3c65ee --- /dev/null +++ b/external/exchange-channels/lft/img/lft_FirefoxAddOn.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:603eed59cc54575db873f9984fcf0998c78f28b58feac0f961298245bef82104 +size 56692 diff --git a/external/exchange-channels/lft/img/lft_asperaExtension.jpg b/external/exchange-channels/lft/img/lft_asperaExtension.jpg new file mode 100644 index 0000000000000000000000000000000000000000..3ab855ccc23df28def7cd7f9f835ef0e8ae1ffd1 --- /dev/null +++ b/external/exchange-channels/lft/img/lft_asperaExtension.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:d83b582571a26d4b7fae47a10a1d84950f931ef08a82b55022e041bbedb53a5f +size 16651 diff --git a/external/exchange-channels/lft/img/lft_command.png b/external/exchange-channels/lft/img/lft_command.png new file mode 100644 index 0000000000000000000000000000000000000000..246702bc15ea08c87d6e87bd524743d2a70dff5b --- /dev/null +++ b/external/exchange-channels/lft/img/lft_command.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:9b5e757f9527d88354d2937797a997a15e6a97f93ad0d99ab3e49fb09dfef368 +size 170696 diff --git a/external/exchange-channels/lft/img/lft_encryptionPassword.png b/external/exchange-channels/lft/img/lft_encryptionPassword.png new file mode 100644 index 0000000000000000000000000000000000000000..87ef5b261ef0779379bb352518b2c5d0448d39ad --- /dev/null +++ b/external/exchange-channels/lft/img/lft_encryptionPassword.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:195e781e6e446c3f8fce449e7f980b8fc835a8c17340bf6290b6dd5308409b1b +size 29614 diff --git a/external/exchange-channels/lft/img/lft_fileBrowser.png b/external/exchange-channels/lft/img/lft_fileBrowser.png new file mode 100644 index 0000000000000000000000000000000000000000..2a4a845b02b499c0eada2488849d5c039335a503 --- /dev/null +++ b/external/exchange-channels/lft/img/lft_fileBrowser.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:d402fad67203b49aaf04450ea3afaf863052eddbfc9276baa768506a0d0fb983 +size 26572 diff --git a/external/exchange-channels/lft/img/lft_help.png b/external/exchange-channels/lft/img/lft_help.png new file mode 100644 index 0000000000000000000000000000000000000000..d758b481cbcd9c6824eda37b96b22c7145e7fbf3 --- /dev/null +++ b/external/exchange-channels/lft/img/lft_help.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:30f61b9d2860cf94c081847da80bace84a283db0797c2d0ffbaab882de81ad19 +size 93890 diff --git a/external/exchange-channels/lft/img/lft_helpCommandLine.png b/external/exchange-channels/lft/img/lft_helpCommandLine.png new file mode 100644 index 0000000000000000000000000000000000000000..4852d57dafc7226602991288d4a4d9e22b71b983 --- /dev/null +++ b/external/exchange-channels/lft/img/lft_helpCommandLine.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:53a52bc13a3fa18c9b7e33649eda80912b808cd7a944955171647200023df558 +size 57327 diff --git a/external/exchange-channels/lft/img/lft_install.png b/external/exchange-channels/lft/img/lft_install.png new file mode 100644 index 0000000000000000000000000000000000000000..e06ee83425526f57348e0e2ae1a8d1a54298caa2 --- /dev/null +++ b/external/exchange-channels/lft/img/lft_install.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:022325cc083c3dd5b1bacf4e4feb73fba68aea21a28683697fe2c550fd56d3cf +size 11564 diff --git a/external/exchange-channels/lft/img/lft_installAsperaConnect.png b/external/exchange-channels/lft/img/lft_installAsperaConnect.png new file mode 100644 index 0000000000000000000000000000000000000000..74f087a6c47b997c5f7e64275205504816c4a005 --- /dev/null +++ b/external/exchange-channels/lft/img/lft_installAsperaConnect.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:0c6cfed8e8ecd0c2385c330f78b20e18c10d5f545daf43ba7a024c5eb716d754 +size 30346 diff --git a/external/exchange-channels/lft/img/lft_password.png b/external/exchange-channels/lft/img/lft_password.png new file mode 100644 index 0000000000000000000000000000000000000000..e817ced82aa23e271c3e51476400ba627600f1bb --- /dev/null +++ b/external/exchange-channels/lft/img/lft_password.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:ce6e75af2ef6d44378b26c34221dd703d417336eeba6cf7fc38a416ef737fd7b +size 37585 diff --git a/external/exchange-channels/lft/img/lft_runInstallation.png b/external/exchange-channels/lft/img/lft_runInstallation.png new file mode 100644 index 0000000000000000000000000000000000000000..4b4d089e9611d512a0cff165c24e387af9b13cb8 --- /dev/null +++ b/external/exchange-channels/lft/img/lft_runInstallation.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:6e9757e2210dc8005b68fd7557d92226732c069455b580adfad3e80c00caf718 +size 24652 diff --git a/external/exchange-channels/lft/img/lft_status.png b/external/exchange-channels/lft/img/lft_status.png new file mode 100644 index 0000000000000000000000000000000000000000..6fa98a111820a1155746a99ed5f326f3403cd921 --- /dev/null +++ b/external/exchange-channels/lft/img/lft_status.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:be511aa58b0af61f60e1aa8ef146eb0592f4d9932b1372d6b1fc174ad7abd493 +size 27387 diff --git a/external/exchange-channels/lft/lft.md b/external/exchange-channels/lft/lft.md new file mode 100644 index 0000000000000000000000000000000000000000..88d489e555eb2f7f4797e77e1ea8d8cd204ac90b --- /dev/null +++ b/external/exchange-channels/lft/lft.md @@ -0,0 +1,124 @@ +--- +card_order: 100 +layout: page +permalink: /external/exchange-channels/lft/ +shortcut: exchange-channels:lft +redirect_from: + - /cards/exchange-channels:lft + - /external/cards/exchange-channels:lft +--- +# LCSB file transfer (LFT) Quick Guide + +{:toc} + +## Overview + +LCSB File Transfer (LFT) is a tool based on IBM Aspera software that supports end-to-end encrypted data transfer and can handle high data volumes e.g. several tera bytes. + +## 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** 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 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. + +<a name="LFT_WEB"></a> + +## Accessing LFT via Web Interface + +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) is recommended, but others should also work. You will be prompted for your password (see below).<br/><br> +  + +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. + +* click **Install Connect** button (see below). <br/> +* open the installer just downloaded and start the installer. <br/> +* 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 the following message <br/> + +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. + +  + +4. Clicking **Upload** or **Download** icons will launch the **IBM Aspera Connect** client on your computer. You first will be asked whether you allow the client to connect to the server. Choose **Allow**. +> 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/> + +  + +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/> + +  <br/> + +You will be prompted for encryption passphrase which is present on the file browser (click on the copy icon to copy into clipboard). + +  <br/> +  <br/> +Encrypted files are by default kept on your disc after decryption. If you want to change this behaviour, navigate to Options->Settings and check "Delete encrypted files when finished" box. + +7. You can also navigate to the help section on the top of the browser. It contains information and links to get support. + +<a name="LFT_CLI"></a> + +## Accessing LFT via Command-Line Tool + +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 Connect be installed (see step 2 above). + +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 `aspera_tokenauth_id_rsa`. 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: + +| Environment | Location | Alternate location | +|-|-|-| +| MacOS | `$HOME/Applications/Aspera\ Connect.app/Contents/Resources/aspera_tokenauth_id_rsa` | `/Applications/Aspera\ Connect.app/Contents/Resources/aspera_tokenauth_id_rsa` | +| Windows | `C:\\Program Files (x86)\Aspera\Aspera Connect\etc\aspera_tokenauth_id_rsa` |`C:\\Users\username\AppData\Local\Programs\Aspera\Aspera Connect\etc\aspera_tokenauth_id_rsa` | +| Linux | `$HOME/.aspera/connect/etc/aspera_tokenauth_id_rsa` | `/opt/aspera/etc/aspera_tokenauth_id_rsa` | +| Iris | `/opt/apps/resif/data/production/$PROD_VERSION/default/software/tools/Aspera-CLI/$CLI_VERSION/etc/aspera_tokenauth_id_rsa` | | + +3. Go to the help section of your access link. + + <br/> + +And follow instructions there. Export variables and execute the command to download/upload data. + + <br/><br/> + +<a name="LFT_TROUBLESHOOTING"></a> +## Troubleshooting + +You can use the official [IBM Aspera Diagnostic Tool](https://test-connect.asperasoft.com/) to troubleshoot your connectivity issues. + +### **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). + +### **UDP/TCP port and firewall** + +> **IMPORTANT NOTE:** Aspera requires UDP ports to be enabled on firewalls. + +Specifically your firewall should: + +* Allow outbound connections from the Aspera client on the TCP port (TCP/33001, by default, when connecting to a Windows server, or on another non-default port for other server operating systems). +* Allow outbound connections from the Aspera client on the fasp UDP port (33001, by default). +* If you have a local firewall on your server (like Windows Firewall), verify that it is not blocking your SSH and fasp transfer ports (e.g. TCP/UDP 33001). + +Detailed information on how to configure firewalls when working with Aspera is given [here](https://download.asperasoft.com/download/docs/p2p/3.5.1/p2p_admin_win/webhelp/dita/configuring_the_firewall.html). + +### Command-Line error "command not found: ascp" ### + +Run `ascli config ascp show` to show path of `ascp`. + +Modify command with the path instead of `ascp`. + +Here is an example of download command + +`<path-to-ascp-executable> -d -i $SSHKEY -P 33001 --file-crypt decrypt -W $TOKEN $ASPERA_USERNAME@aspera-hts-01-srv.lcsb.uni.lu:/<remote-dir> </local-dir>` \ No newline at end of file