CloudStor is an AARNet developed and supported service that enables AARNet customers and the wider community to quickly and securely sync, share and store files using the high-speed AARNet network. 

Nectar offers a helper command called cloudstor-setup for users who wish to make their CloudStor storage available on their Nectar virtual machine. It walks you though the setup procedure, and mounts your CloudStor storage to /cloudstor within your instance.

Getting Started

When logged into your Nectar virtual machine, start the setup by typing cloudstor-setup at the command prompt, which will begin the setup. This command is available on Nectar official images, build after 2018-10-10. See the table below for more information.
The cloudstor-setup command will prompt you for your CloudStor username and password. For this, we recommend you generate an App password specifically for your VM. Using an app password will allow you to selectively remove a single password if you need to. You can do this from the CloudStor Security settings page.

Type in a name (a good choice is the name of your Nectar VM), and then click the Create new app password button. Copy the username and password generated, and enter it into the cloudstor-setup command when prompted.

Under the hood the cloudstor-setup command uses software called davfs2 to connect to your AARNet CloudStor account.

You should now be able to work with your CloudStor data at /cloudstore on your virtual machine.

Supporting images

The cloudstor-setup command is available in Nectar official images built after 2018-10-10. This table lists the the first image builds that include the command.

Image ID
Image Name
Build
Date
86b13f08-b0f5-4a4d-9210-1861aaef91e9
NeCTAR CentOS 6
71
2018-10-10
192a60eb-10a5-470b-82db-7f4bec122a12
NeCTAR CentOS 7
77
2018-10-11
6c0b1c17-4232-491e-85b3-c75801c72857
NeCTAR Debian 8 (Jessie)
63
2018-10-10
1d1d4528-f3c0-438a-a9f2-118965bf932e
NeCTAR Debian 9 (Stretch)
19
2018-10-10
63200ef1-be18-4d17-8092-cccba36f5afb
NeCTAR Fedora 28
4
2018-10-10
0687d66c-c9c8-4219-b1c8-f29c9992ed47
NeCTAR Ubuntu 16.04 LTS (Xenial)
33
2018-10-18
c0760a8e-c226-4644-97a8-efde3f07072e
NeCTAR Ubuntu 18.04 LTS (Bionic)
7
2018-10-11
5a7b9d00-a2f9-4e4e-9d51-bce1b5585162
NeCTAR Ubuntu 18.10 (Cosmic)
1
2018-10-18

Security considerations

Your password

Aarnet Cloudstor is secured using a password. Our recommendation is that you use the App Password that Cloudstor can generate for you on the CloudStor Security Settings page. If you prefer to choose your own password, make sure you read our password recommendations.

Snapshotting your CloudStor-connected instance

Cloudstor-setup will store on your behalf in a privileged user account on your VM. If you snapshot your VM with cloudstor configured by cloudstor-setup, this password will become part of the snapshot. If you subsequently share the snapshot with another user, you are also sharing the password, and this other user will have access to your data. 

General Nectar Security info

You should practice good security around your VM. Nectar documentation has information about good security practice in a number of articles. Search them here