...
You are now set up to use rclone to move data to/from your Acacia storage.
AWS Client
To use aws client commands, you will need to load the aws client module:
| Code Block | ||||
|---|---|---|---|---|
| ||||
module load awscli/1.16.308 |
To create a new bucket using AWS S3 CLI, use the S3 mb command:
> aws --endpoint-url=https://projects.pawsey.org.au --profile=<PROFILE_NAME> s3 mb s3://<BUCKET_NAME>
Where:
<PROFILE_NAME>is the name you gave to the account credentials when configuring AWS S3 CLI.<BUCKET_NAME>is the name you want to give your bucket, subject to naming requirements.
To delete a bucket using AWS S3 CLI, use the S3 rb command:
> aws --endpoint-url=https://projects.pawsey.org.au --profile=<PROFILE_NAME> s3 rb s3://<BUCKET_NAME>
Where:
<PROFILE_NAME>is the name you gave the storage space when configuring aws S3 cli.<BUCKET_NAME>is the name of the bucket you want to remove.
To list the buckets in your account using AWS S3 CLI, use the S3 ls command:
> aws --endpoint-url=https://projects.pawsey.org.au --profile=<PROFILE_NAME> s3 ls
Where:
<PROFILE_NAME>is the name you gave to the account credentials when configuring AWS S3 CLI.
To list the objects in a bucket:
> aws --endpoint-url=https://projects.pawsey.org.au --profile=<PROFILE_NAME> s3 ls s3://<BUCKET_NAME>
Where:
<BUCKET_NAME>is the name of the bucket you want to list the objects within.
To list objects in a pseudo folder:
> aws --endpoint-url=https://projects.pawsey.org.au --profile=<PROFILE_NAME> s3 ls s3://<BUCKET_NAME>/<PREFIX>
Where:
<PREFIX>is the name of the pseudo folder you want to list the objects within.
To upload an object using AWS S3 CLI, use the S3 cp command:
> aws --endpoint-url=https://projects.pawsey.org.au --profile=<PROFILE_NAME> s3 cp <SOURCE> <TARGET>
Where:
<SOURCE>is the filesystem path and name of the file you want to upload.<TARGET>is the key of the object on Acacia, so bucket name, pseudo folder (optional), and object name. You can specify any object name to “rename” the file on upload.
To download an object from Acacia:
> aws --endpoint-url=https://projects.pawsey.org.au --profile=<PROFILE_NAME> s3 cp <SOURCE> <TARGET>
Where:
<SOURCE>is the key of the object on Acacia you want to download, so bucket name, pseudo folder (optional), and object name.<TARGET>is the filesystem path where you want the object to be downloaded to.
To delete an object using AWS S3 CLI, use the rm command:
> aws --endpoint-url=https://acacia.pawsey.org.au --profile=<PROFILE_NAME> s3 rm s3://<BUCKET_NAME>/<OBJECT_NAME>
Where:
<PROFILE_NAME>is the name you gave to the account credentials when configuring AWS S3 CLI.<BUCKET_NAME>is the name of the bucket containing the object.<OBJECT_NAME>is the name of the object to remove.
The following command removes all objects:
> aws --endpoint-url=https://acacia.pawsey.org.au --profile=<PROFILE_NAME> s3 rm s3://<BUCKET_NAME> --recursive
> aws --endpoint-url=https://acacia.pawsey.org.au --profile=<PROFILE_NAME> s3 rm s3://<BUCKET_NAME>/<PREFIX> --recursive
Where:
<PROFILE_NAME>is the name you gave to the account credentials when configuring AWS S3 CLI.<BUCKET_NAME>is the name of the bucket containing the object.<OBJECT_NAME>is the name of the object to remove.
To share an object using AWS S3 CLI, use the presign command:
> aws --endpoint-url=https://projects.pawsey.org.au --profile=<PROFILE_NAME> s3 presign s3://<BUCKET_NAME>/<OBJECT_NAME>
Where:
<PROFILE_NAME>is the name you gave to the account credentials when configuring AWS S3 CLI.<BUCKET_NAME>is the name of the bucket containing the object.<OBJECT_NAME>is the name of the object to share.
Example workflows
Some example workflows are given at https://support.pawsey.org.au/documentation/display/US/Supercomputing+project+example. These examples are designed for Setonix, but can be used almost exactly as is from hpc-data. The only (necessary?) thing that needs to change is the name of the partition, which is "copy" on Setonix, but "copyq" elsewhere:
...