A disk-based system powered by Dell, named Acacia after Australia’s national floral emblem the Golden Wattle – Acacia pycnantha, providing 60PB of high-speed object storage for hosting research data online. This multi-tiered cluster separates different types of data to improve data availability.
Detailed information on how to upload to acacia can be found at https://support.pawsey.org.au/documentation/display/US/Acacia+-+Common+Usage.
Setting up
Creating keys
- You will need to create a key for each "Storage" which you would like to use. Select the desired Storage Name from the dropdown, and click Create New Key, and click Yes when prompted to confirm.
- You will be shown an Access ID and a Secret Key that you will need later. The Access ID is easily obtained on the portal website, but the Secret Key will not be shown again. COPY THE ACCESS ID AND SECRET KEY AND KEEP THEM SOMEWHERE SAFE.
- If you lose the secret key, the easiest recovery method is to simply delete the key and create a new one.
Pawsey environment
The next step is to setup your environment on Pawsey so that you can access the Acacia "S3" system from Garrawarla, etc. There are two clients available for doing so:
- MinIO Client ("mc")
- rclone
The set up for each client is different, as detailed below.
MinIO Client
Code Block |
---|
language | bash |
---|
theme | Midnight |
---|
|
mc alias set <ALIAS_NAME> https://acacia.pawsey.org.au <ACCESS_ID> <SECRET_KEY> |
- ALIAS_NAME can be anything, but a sensible choice is the Storage Name (e.g. mwasci in the screenshots above)
- ACCESS_ID is the Access ID of the key created to access the given storage
- SECRET_KEY is the Secret Key given to you at the time your created the key.
You are now set up to use the mc command to move data to/from your Acacia storage. You do not need to load any special modules to use mc.
rclone
Create the following file:
Code Block |
---|
language | bash |
---|
theme | Midnight |
---|
title | ~/.config/rclone/rclone.conf |
---|
|
[<ALIAS_NAME>]
type = s3
provider = Other
access_key_id = <ACCESS_ID>
secret_access_key = <SECRET_KEY>
endpoint = https://projects.pawsey.org.au
acl = public-read-write
bucket_acl = public-read-write |
- ALIAS_NAME can be anything, but a sensible choice is the Storage Name (e.g. mwasci in the screenshots above)
- ACCESS_ID is the Access ID of the key created to access the given storage
- SECRET_KEY is the Secret Key given to you at the time your created the key.
To use rclone commands, you will need to load the rclone module:
Code Block |
---|
language | bash |
---|
theme | Midnight |
---|
|
module load rclone |
You are now set up to use rclone to move data to/from your Acacia storage.
mc cheatsheet
Creating a bucket
Code Block |
---|
language | bash |
---|
theme | Midnight |
---|
|
mc mb <ALIAS_NAME>/<BUCKET_NAME> |
Uploading data
Code Block |
---|
language | bash |
---|
theme | Midnight |
---|
|
mc cp <PATH_TO_FILE> <ALIAS_NAME>/<BUCKET_NAME>/<NAME_OF_FILE> |
Downloading data
Code Block |
---|
language | bash |
---|
theme | Midnight |
---|
|
mc cp <ALIAS_NAME/BUCKET_NAME/NAME_OF_FILE> <PATH_TO_DOWNLOAD_DIRECTORY> |
List buckets
Code Block |
---|
language | bash |
---|
theme | Midnight |
---|
|
mc ls <ALIAS_NAME> |
List bucket contents
Code Block |
---|
language | bash |
---|
theme | Midnight |
---|
|
mc ls <ALIAS_NAME>/<BUCKET_NAME> |