diff --git a/external/exchange-channels/asperaweb/asperaweb.md b/external/exchange-channels/asperaweb/asperaweb.md index e8777099b2ea08d543b49c8adf695dd4336ba884..30552f7efa025774a83d90e24bc300d958b3f2bb 100644 --- a/external/exchange-channels/asperaweb/asperaweb.md +++ b/external/exchange-channels/asperaweb/asperaweb.md @@ -11,16 +11,8 @@ redirect_from: {:toc} ## 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.z -> **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). +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. ## Obtaining a AsperaWEB access link @@ -33,9 +25,10 @@ An access link can be reached via standard web browsers. Data can be transferred * Through the web browser by visiting the link, which is our recommended way of data transfer, described in this [section of the guide](#ASPERAWEB_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](#ASPERAWEB_CLI). -The use of AsperaWEB is mediated by LCSB's data stewards. If you require assistance in using AsperaWEB, you should send an email to the [LCSB datastewards](mailto:lcsb-datastewards@uni.lu). +The use of AsperaWEB is mediated by LCSB's data stewards. If you require assistance in using AsperaWEB, you should send an email to the [LCSB datastewards](mailto:lcsb-datastewards@uni.lu) or refer to the [Troubleshooting](#ASPERAWEB_TROUBLESHOOTING) section of this guide. <a name="ASPERAWEB_WEB"></a> + ## Accessing AsperaWEB via Web Interface In the following steps we provide instructions on how to use AsperaWEB web interface. @@ -44,44 +37,38 @@ 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/> +* click **Download** or **Download the App** buttons (see below). <br/> - * open the installer just downloaded and start the installer. <br/> +* wait for the download to finish, the prompt should go to step 3. <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* - +* open the installer just downloaded and start the installer. <br/> - * the prompt should disappear +* 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* - - * restart your browser +* the prompt should disappear +* restart your browser -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/> +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/>  +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**. - - - -5. At any time you can launch **IBM Aspera Connect** to display the status of uploads to or downloads from your computer. <br/> +3. 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/> +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/>  <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. - -7. You can also navigate to the help section on the top right of the browser. It contains information and links to get support. +5. 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> -## Accessing AsperaWEB via Command-Line Tool +## Accessing AsperaWEB via Command-Line Tool Go to the help section of your access link @@ -90,3 +77,24 @@ Go to the help section of your access link And follow the steps in the **Using the command line** section. <br/>  <br/><br/><br/> + +<a name="ASPERAWEB_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://www.microsoft.com/store/productId/9N6XL57H8BMG). + +### **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).