diff --git a/external/exchange-channels/asperaweb/asperaweb.md b/external/exchange-channels/asperaweb/asperaweb.md index f9a19936611b8863b8d18383aec6ad95b9520490..af04cea4450508bd85cd3bed2099552f67f241ef 100644 --- a/external/exchange-channels/asperaweb/asperaweb.md +++ b/external/exchange-channels/asperaweb/asperaweb.md @@ -13,6 +13,8 @@ redirect_from: {:toc} +> AsperaWEB will be deprecated in the future (the end of service is planned for January 2023). LCSB File Transfer (LFT) will be used instead ([LFT quick guide](https://howto.lcsb.uni.lu/?exchange-channels:lft)). + ## Overview AsperaWEB is an IBM Aspera deployment at the LCSB-University of Luxembourg. AsperaWEB supports end-to-end encrypted data transfer and can handle high data volumes e.g. several tera bytes. @@ -42,32 +44,27 @@ In the following steps we provide instructions on how to use AsperaWEB web inter 2. When you visit a AsperaWEB access link for the very first time, you will be prompted to install or update **IBM Aspera Connect** client. * click **Download** or **Download the App** buttons (see below). <br/> - * wait for the download to finish, the prompt should go to step 3. <br/> - * open the installer just downloaded and start the installer. <br/> - * close the installer, the Aspera Connect should try to open - *depending on your Operating System you may be asked if you are sure to open it* - - * the prompt should disappear - * restart your browser -1. 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/> +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/>  -2. Clicking **Upload** or **Download** will launch the **IBM Aspera Connect** client on your computer. You first will be asked whether you allow the client to connect to aspera.lcsb.uni.lu. Choose **Allow**. +4. Clicking **Upload** or **Download** will launch the **IBM Aspera Connect** client on your computer. You first will be asked whether you allow the client to connect to aspera.lcsb.uni.lu. Choose **Allow**. -3. At any time you can launch **IBM Aspera Connect** to display the status of uploads to or downloads from your computer. <br/> +5. At any time you can launch **IBM Aspera Connect** to display the status of uploads to or downloads from your computer. <br/>  -4. 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/> +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. <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. -5. You can also navigate to the help section on the top right of the browser. It contains information and links to get support. +7. You can also navigate to the help section on the top right of the browser. It contains information and links to get support. <a name="ASPERAWEB_CLI"></a> @@ -101,3 +98,11 @@ Specifically your firewall should: * 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 a path of `ascp`. + +Modify command with the path instead of `ascp`:<br> +Here is an example of download command +`<path-to-ascp-executable> -d -i $SSHKEY -P 33001 --file-crypt decrypt -W $TOKEN app_duma_private@aspera.lcsb.uni.lu:/<remote-dir> </local-dir>`