Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Open your preferred web browser.

  2. Visit https://cloud.rdm.uq.edu.au/ and log in

  3. Click on your initials at the top right corner.

  4. Click on 'Settings'

    , then 'Security'.

  5. Scroll down until you find the "Devices & sessions" section.

  6. There’s a field to name your new app password. Type ‘rclone’ into this field so that you know what the password is for.

  7. Click on the 'Create new app password' button. This will generate a new password.

  8. This new password will be displayed just once. Highlight it, right-click and select 'Copy' or press 'Ctrl+C' (Windows) or 'Command+C' (Mac) to copy it. You'll need to paste this in the rclone configuration later.

  9. Open Terminal:

    • Press 'Command' and 'Spacebar' on your keyboard simultaneously. This opens Spotlight.

    • Type 'Terminal' and press 'Enter'. This opens the Terminal app.

  10. Configure rclone:

    • In the Terminal, type rclone config and press 'Enter'.

    • When asked 'e/n/d/r/c/s/q>', type n and press 'Enter'.

    • Type a name for the new remote (like 'rdm3’) and press 'Enter'.

    • When asked for the 'Storage', type webdav and press 'Enter'.

    • When asked for the 'url', type https://cloud.rdm.uq.edu.au/remote.php/dav/files/your-emailusername/ (replace 'your-emailusername' with the username displayed when you created the new app password in step 8) and press 'Enter'.

    • When asked for the 'vendor', type 1 (which corresponds to Nextcloud) and press 'Enter'.

    • When asked for the 'user', type the username displayed when you created the new app password in step 8 and press 'Enter'.

    • When asked ‘y/g/n>' for the ‘pass', type y and press 'Enter'. You will then be prompted to enter the password. To paste the password you copied earlier, right-click in the Command Prompt or Terminal and select 'Paste' (or use 'Ctrl+V' for Windows or 'Command+V' for Mac). Remember, even though you might not see anything appearing in the Terminal or Command Prompt when you paste your password, it's still being entered. Don't be alarmed if it seems like nothing has been pasted. Once you’ve pasted it, press 'Enter’.

    • Confirm your password by pasting it again and pressing 'Enter'.

    • Skip the 'bearer_token' by simply pressing 'Enter'.

    • When asked 'Edit advanced config?', type n and press 'Enter'.

    • To confirm the configuration is okay, type y and press 'Enter'. Then type q and press 'Enter' to quit the config.

  11. Test the Configuration:

    • Type rclone lsd rdm3: in the Terminal and press 'Enter'. It should list the RDM records that you have access to.

...

Please remember to replace any placeholder (like 'your-emailusername') with your actual details. Now that rclone has been configured, it can be used to transfer files to the UQRDM.

...

  • To copy a file or an entire folder from your local system to UQRDM, you can use the copy command:

    • If using a Mac or Linux system:

      • In the Terminal, type rclone copy /path/to/local/file_or_folder rdm3:/path/on/rdm and press 'Enter'.

      • Replace /path/to/local/file_or_folder with the actual path of the file or folder on your local system, and rdm3:/path/on/rdm with the desired location on the UQRDM. rdm3 is the name of the remote you've configured for UQRDM.

    • If using a Windows system:

      • Open the Command Prompt, type rclone copy "C:\path\to\local\file_or_folder" rdm3:/path/on/rdm and press 'Enter'. Replace C:\path\to\local\file_or_folder with the actual path of the file or folder on your local system, and rdm3:/path/on/rdm with the desired location on the UQRDM.

Please note that it is a good practice to avoid spaces in your filenames and folder names when using rclone. If your filename or folder name has spaces, make sure to enclose the entire path in quotation marks. For example: rclone copy "/path/to/your file.txt" rdm3:/path/on/rdm".

...

  • To sync a local folder to a folder on UQ RDM, use the sync command. This command makes the destination folder match the source folder, altering the contents of the destination folder if necessary. rclone sync /path/to/local/folder rdm3:/path/on/rdm and press 'Enter'.

    Again, replace /path/to/local/folder with the path of the local folder, and rdm3:/path/on/rdm with the destination folder on the UQRDM.

  • If you would like real-time statistics on how much data has been transferred, and at what speed, you can use this instead:

    • For mac or Linux users: rclone sync -P /path/to/local/folder rdm3:/path/on/rdm and press 'Enter'.

    • For windows users: rclone sync -P " C:\path\to\local\folder " rdm3:/path/on/rdm .

2.5 Moving files with rclone:

...