Merge branch 'asperaweb-update' into 'develop'

Asperaweb update - adding troubleshooting section

See merge request R3/howto-cards!140

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
  ![Alt](img/asperaweb_1.png "Title")
 
 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/>![Alt](img/asperaweb_2.png "Title")
 
-	* wait for the download to finish, the prompt should go to step 3. <br/>![Alt](img/asperaweb_3.png "Title")
+* click **Download** or **Download the App** buttons (see below). <br/>![Alt](img/asperaweb_2.png "Title")
 
-	* open the installer just downloaded and start the installer. <br/>![Alt](img/asperaweb_4.png "Title")
+* wait for the download to finish, the prompt should go to step 3. <br/>![Alt](img/asperaweb_3.png "Title")
 
-	* 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/>![Alt](img/asperaweb_4.png "Title")
 
-	* 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/>
   ![Alt](img/asperaweb_6.png "Title")
 
+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/>
   ![Alt](img/asperaweb_8.png "Title")
 
-
-
-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/>
   ![Alt](img/asperaweb_9.png "Title") <br/>
 You will be prompted for encryption passphrase which is present on the file browser. <br/>
   ![Alt](img/asperaweb_10.png "Title") <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/> ![Alt](img/asperaweb_cli_tokens.png "Title") <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).