Accessing Allas

Gaining access

Allas access is based on CSC customer projects. To be able to use Allas, you need to be a member in a CSC project that has the permission to use Allas. If you do not have a CSC account, you must first register as a CSC user and join or start a computing project for which Allas has been enabled. This can be done in the MyCSC user portal: https://my.csc.fi.

Accessing Allas from the web

The OpenStack Horizon web interface provides easy-to-use basic functions for data management in Allas:

Web client – OpenStack Horizon Dashboard

Accessing Allas in the CSC computing environment and other Linux platforms

In order to use Allas in Puhti or Taito, first load the module allas:

module load allas

Allas access for a specific project can then be enabled:

allas-conf

or

allas-conf project_name

The allas-conf command prompts for your CSC password (the same that you use to login to CSC servers). It lists your Allas projects and asks you to define a project (if not already defined as an argument). allas-conf generates a rclone configuration file for the Allas service and autheticates the connection to the selected project. You can only be connected to one Allas project at a time in one session. The project you are using in Allas does not need to match the project you are using in Puhti or Taito, and you can switch to another project by running allas-conf again.

Authentication information is stored in the shell variables OS_AUTH_TOKEN and OS_STORAGE_URL and is valid for up to 3 hours. However, you can refresh the authentication at any time my running allas-conf again. The environment variables are available only for that login session, so if you log into Puhti in another session, you need to authenticate again in there to access Allas.

Start using Allas with one of the following options. Note that the tools utilize two different protocols: Swftt and S3. Data that is uploaded with one protocol is not necessary readable with another protocol.

Allas client software options for Puhti and Taito and other linux servers

The client software listed above can be used in other linux servers as well, e.g. a virtual machine running in cPouta or your own Linux-based laptop. In that case, you need to install the client software and configure the connection to Allas yourself. Instructions: allas-cli-utils

Accessing Allas with Windows or Mac

For Windows and Mac, we recommend CyberDuck. See the list of functions CyberDuck offers for data management.

The instructions below describe how to open a Swift protocol-based Cybeduck connection to Allas. With this setup, Cyberduck is compatible with rclone, Swift and a_tools but not with s3cmd based on the S3 protocol. More information: Directory object error.

1. Install CyberDuck.

2. Navigate to the CyberDuck main menu and choose Bookmark | New Bookmark (Ctrl-Shift-B).

"New bookmark" Figure Creating a new bookmark

3. In the first dropdown menu, choose Swift (OpenStack Object Storage).

4. As the Server, type pouta.csc.fi and choose the Port 5001.

5. In the section Tenant ID:Access Key, type (without spaces) the desired project's name, add ":" and your Pouta username (this is the CSC user accout you use in Puhti, Taito and cPouta ). Thus, it should be in the format projectname:username, e.g. project_123456:john.

6. Type your CSC password in the Secret Key field. You can close the bookmark by clicking X on the upper right corner of the pop-up window.

"Entering information for a bookmark" Figure Entering information for a bookmark

7. Navigate to the top left corner to the icons under Open Connection and choose the Bookmarks icon (second from the left).

8. Next, right-click the created bookmark and choose the option Connect to server.

"Connecting to the server" Figure Connecting to the server

Now you should be able to see the content of your project (which might be empty).

Cyberduck functions

Cyberduck offers some basic functionalities for managing data in the object storage:

The Cyberduck user interface is quite easy to use. The data management options can be displayed by either right-clicking the bucket/object or choosing the bucket/object and then clicking the Action button on the menu bar. To navigate back to the previous directory, use backspace.