AARNet CloudStor

Mount CloudStor in VM

You have a CloudStor account and you have generated an App Password to access it from your Nectar instance. The steps below show you how to use the cloudstor-setup command provided by Nectar.

  1. SSH to your Nectar virtual machine via your preferred terminal software. If you’re not familiar with this, we have some other tutorials for you.

  2. Start the CloudStor setup by typing cloudstor-setup at the command prompt.

    $ cloudstor-setup
    

    The cloudstor-setup command will re-emphasise using App Passwords to you.

  3. By default the cloudstor-setup command will prompt you for your CloudStor username and password. Follow the prompts and paste in the username and password you generated in the previous section. You should see some output similar to this:

    $ cloudstor-setup
    This command guides you through the process of mounting your AARNet CloudStor 
    storage to your Nectar instance.
       
       
    To mount your CloudStor storage, you will be prompted for a username and 
    password. You can generate specific use 'app passwords' from the security 
    settings of your CloudStor account here:
    https://cloudstor.aarnet.edu.au/plus/settings/personal?sectionid=security
       
    PLEASE NOTE: If you snapshot this instance and share it, your CloudStor 
    app password may be exposed though the configuration file /etc/davfs2/secrets.
    For more information, please see the CloudStor setup article at: 
    https://support.ehelp.edu.au/support/solutions/articles/6000211327
       
    Press [ENTER] to continue or Ctrl+C to exit.
       
    Username: wile.c@acme.edu.au
    App password:
    Testing your CloudStor credentials... OK
    Mounting CloudStor storage... done
    Your CloudStor account has been mounted to /cloudstor
    $ 
       
    
  4. You should now be able to work with your CloudStor data at /cloudstor on your virtual machine. You can use the df command to verify, similar to.:

    $ df -h
    Filesystem                                  Size  Used Avail Use% Mounted on
    ...
    https://cloudstor....us/remote.php/webdav/  1.1T   11G  1.0T   2% /cloudstor
    

The cloudstor-setup command can uninstall your mounted connection for you too. Use the -h argument for more information, e.g.

$ cloudstor-setup -h

Note
The command cloudstor-setup is available on Nectar official images, build after 10/10/2018. Under the hood the cloudstor-setup command uses software called davfs2 to connect to your AARNet CloudStor account.