Connecting to CloudStor
AARNet have announced that CloudStor will be decommissioned by the end of 2023. For long-term storage of your Galaxy data, we recommend archiving your histories to storage solutions provisioned by your institution. Find information on managing your Galaxy histories on the Galaxy Training Network. If you have any concerns about this transition, please make a support request.
The import/export tools allow you to transfer one or more files to a registered AARNet CloudStor account. Transfers to/from CloudStor are encrypted over HTTPS.
Before you can use this service, you must perform a one-off task where you must provide Galaxy with credentials to access your CloudStor account on your behalf. You must first setup an app specific password in CloudStor for Galaxy to use. You must then let Galaxy know what that app password is.
Setting up an app password in CloudStor
To create an app password:
Log into your CloudStor account
and then click on
Settings
in the top right corner of the interface. Once in Settings you will see a
menu on the left, click
Security
and you will see a section called app passwords.
App passwords simply require an "app name" this can be anything that helps
you later identify the password in the future, for example "Galaxy". Fill
in an "app name" and click
Create new app password.
You will then be presented with a username and password/token. Your
username will be your email address and the password/token with be a
randomly generated token. Please write this token down somewhere or copy
it to your computer clipboard. When you click
Done
you will never be able to see this password/token again.
Once the app password is created you will see it in the list of app
passwords. You can also see when that password was last used. You also
have the option to unlink your accounts by deleting the app password.
Click here
for the most up to date instructions from AARNet.
Letting Galaxy know your app password
In Galaxy, go to your profile settings under the User menu > Preferences > Manage Information, where you will need to set OwnCloud/CloudStor Credentials.
Server URL: https://cloudstor.aarnet.edu.au/plus/remote.php/webdav
Username: The email your account is registered with
Password: Copied from the app password set up at CloudStor
If the details above are configured properly, the next time you access the Cloudstor import/export functions in Galaxy (below) your folder/files will be visible.
WARNING: Your CloudStor credentials will be stored on this server. While reasonable efforts have been made to store these credentials safely, you must be aware and accept the risks of storing these credentials. In the event that the server is compromised, it may be possible for an attacker to gain access to your CloudStor account.
Data import from CloudStor
-
File or files to be imported into your Galaxy history from Cloudstor are
accessed from the
Upload Data
>
Choose Remote Files
tool:
- Single or multiple files can be selected for Import. Folders selected will import all files as individual files, not a Collection, into your History
Data export to CloudStor
- To export data to Cloudstor, use the Export datasets to files source tool
-
If your Cloudstor account is configured inside Galaxy the
Directory URI
option will show your Cloudstor folder:
WARNING: the export tool WILL overwrite existing CloudStor files, so choose your target folder carefully!