UQRDM Upload Guidelines for Site PIs

Access to UQRDM

A. If you have received an email notification that you have been granted access as a collaborator, storage on UQRDM can be accessed as follows:

Using the UQRDM cloud web interface
1. Enter this address https://cloud.rdm.uq.edu.au/ into your web browser. You will be taken to the login screen below.
2. After logging in, navigate to the folder of interest. You can now drag files and folders directly from your local computer into UQRDM.(Detailed instructions for using the UQRDM web interface can be found here: https://guides.library.uq.edu.au/for-researchers/uq-research-data-manager/using-uqrdmcloud

2. Using rclone

First rclone must be configured as follows:

If you're using a Mac:

Create a New App Password:
- Open your preferred web browser.
- Visit https://cloud.rdm.uq.edu.au/ and log in
- Click on your initials at the top right corner.
- Click on 'Settings'
  , then 'Security'.
- Create a new app password. 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 later. Remember that it's crucial to keep your password secure. Don't paste it anywhere that others may have access to.
Open Terminal:
- Press 'Command' and 'Spacebar' on your keyboard simultaneously. This opens Spotlight.
- Type 'Terminal' and press 'Enter'. This opens the Terminal app.
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' or 'uqrdm’) and press 'Enter'.
- When asked for the 'Storage', type 40 (which corresponds to a specific storage type you need) and press 'Enter'.
- When asked for the 'url', type <https://cloud.rdm.uq.edu.au/remote.php/dav/files/your-email/> (replace 'your-email' with your actual UQ email address) and press 'Enter'.
- When asked for the 'vendor', type 1 (which corresponds to Nextcloud) and press 'Enter'.
- When asked for the 'user', type your UQ email address 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) and then press 'Enter'.
- Confirm your password by typing 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.
Test the Configuration:
- Type rclone lsd rdm3: in the Terminal and press 'Enter'. It should list the RDM records that you have access to.

If you're using Windows:

Create a New App Password:
- Follow the same instructions as for Mac in step 1.
Open Command Prompt:
- Press the 'Windows' key and 'R' on your keyboard at the same time to open the 'Run' dialog.
- Type 'cmd' in the 'Run' dialog and click 'OK'. This opens the Command Prompt.
Configure rclone:
- The steps are the same as for Mac in step 3, but you'll be typing into the Command Prompt instead of Terminal.
Test the Configuration:
- Follow the same instructions as for Mac in step 4.

Please remember to replace any placeholder (like 'your-email') with your actual details.

Sure, once rclone is configured properly, you can use it to sync, copy, or move files from your local system to the UQ RDM, and vice versa. Here are the basic instructions applicable to all operating systems including Mac, Windows, and Linux.

To Copy Files:

To copy a file from your local system to UQ RDM, you can use the copy command:
```
rclone copy /path/to/local/file rdm3:/path/on/rdm
```
Replace /path/to/local/file with the actual path of the file on your local system, and rdm3:/path/on/rdm with the desired location on the UQ RDM. rdm3 is the name of the remote you've configured for UQ RDM.

To Sync Folders:

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
```
Again, replace /path/to/local/folder with the path of the local folder, and rdm3:/path/on/rdm with the destination folder on the UQ RDM.

To Move Files:

If you wish to move (i.e., copy and then delete the source), you can use the move command. This is useful if you want to free up space on your local system after ensuring the files are safely stored on UQ RDM.
```
rclone move /path/to/local/file rdm3:/path/on/rdm
```
Remember, this will delete the file from the local system after it has been copied to UQ RDM.

Remember to replace the placeholders in the commands with the actual paths. You can run these commands from Terminal on Mac, Command Prompt on Windows, or the Terminal on Linux.

One more thing: rclone commands are case-sensitive, so always ensure you're using lowercase unless otherwise needed. For instance, rclone Copy will not work; you must use rclone copy.

B. If you have not been granted access as a collaborator but have received an email granting access to a specific folder, your instructions are as follows:

Click on the link and enter the provided password when prompted. This will take you to the folder which you have been granted access to.
Bookmark the url to this folder within your web browser and make a note of the password or save it in a password manager of your choosing.