Allas access is based on CSC's customer projects. To be able to use Allas, you need to be a member of 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:
Accessing Allas in the CSC computing environment and other Linux platforms
In order to use Allas in Puhti or Mahti, first load the module allas:
module load allas
Allas access for a specific project can then be enabled:
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 authenticates 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 Mahti, 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 three 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 start another shell session, you need to authenticate again in there to access Allas.
You can start using Allas with one of the following options. Note that the tools utilize two different protocols: Swift and S3. Data uploaded using one protocol is not necessary readable with another protocol.
Allas client software options for Puhti and Mahti and other linux servers
- a-tools for basic use: (Swift, optionally S3) Quick and safe: a-commands
- Advanced functions with rclone: (Swift) Advanced tool: rclone
- A wide range of functionalities: (Swift) Swift client
- S3 client and persistent Allas connections: (S3) S3 client
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, Cyberduck provides a graphical user interface to Allas (note however that the above mentioned linux command line tools are available for Macs too). See the list of functions Cyberduck offers for data management.
The instructions below describe how to open a Swift-protocol-based Cyberduck 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).
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.
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.
Figure Connecting to the server
Now you should be able to see the content of your project (which might be empty).
Cyberduck offers some basic functionalities for managing data in the object storage:
- Create buckets
- Upload objects
- List objects and buckets
- Download object and buckets
- Edit objects
- Edit metadata
- Share objects
- Remove objects and buckets
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.