Gitlab is now using https://gitlab.lcsb.uni.lu as it's primary address. Please update your bookmarks. FAQ.

Commit 4881b339 authored by Vilem Ded's avatar Vilem Ded Committed by Laurent Heirendt
Browse files

Asperaweb update - adding troubleshooting section

parent 066180cc
......@@ -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).
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment