page for documenting rcloneRclone is a tool for managing material in cloud services. In DDC, it is primarily a way of transferring content out of a donor's cloud storage into DDC's digital storage.
Setting up Rclone
Rclone should already be installed in BitCurator but if you are transferring content that you need to log in to access, you'll need to do some additional set up to connect to cloud storage service. This will have to be repeated for each cloud storage service and possibly reconnected if some time has passed between the last time you've used Rclone. Below lists the general set up process with sections for specific cloud storage providers used in practice so far. If there is a cloud storage provider you need to access that's not covered below, please contact the digital archivist.
...
- Open the terminal on the left-hand side of the BitCurator desktop
Type "rclone config" and hit enter
- Type "new" or "n" for new remote, i.e. new cloud service
- Enter a name for the cloud serve (e.g. dropbox)
- Choose the number that is listed in the terminal for cloud service you named in step 4. (e.g. DropBox is (fill in blank)10)
- Hit enter for questions about client id and client secret to accept the defaults
- Type "no" and hit enter for the advanced config question
- Type "y" and hit enter for the auto config option
- A link will appear in the terminal, highlight and copy it. Paste the link into your internet browser.
- On the page that pops up, choose the option to authorize Rclone access
- Return to the terminal, if you see "got code" as part of the output above, type "y" for "this is ok" and hit enter
- Type "q" and hit enter to quit if done setting up cloud connections.
OneDrive or Sharepoint
- Open the terminal on the left-hand side of the BitCurator desktop
Type "rclone config" and hit enter
- Type "new" or "n" for new remote, i.e. new cloud service
- Enter a name for the cloud serve (e.g. onedrive)
- Choose the number that is listed in the terminal for cloud service you named in step 4. (e.g. OneDrive is 26)
- Hit enter for questions about client id and client secret to accept the defaults
- Choose a national cloud region for OneDrive
...
- , most likely, 1 - "Microsoft Cloud Global"
- Type "no" and hit enter for the advanced config question
- Type "y" and hit enter for the auto config option
- A link will appear in the terminal, highlight and copy it. Paste the link into your internet browser.
- Return to the terminal, if you see "got code" as part of the output above.
- Type of connection, enter a number for the type of OneDrive/Sharepoint connection. 1 for basic OneDrive Personal or Business, you will get your personal one drive account and anything shared with you. 2 for sharepoint root will give you sharepoints that are open to you. 3 you can choose enter the site url for a specific sharepoint site, this is the easiest option to find exactly what you want.
- If you chose option 2, select the sharepoint from the list that you want to access. If you chose option 3, enter the url for the sharepoint site.
- If the drive you selected looks good, type "y" for "this is ok" and hit enter
- You will then get a summary of the configuration, if everything looks ok, type "y" for "this is ok" and hit enter
- Type "q" and hit enter to quit if done setting up cloud connections.
Google Drive
Using Rclone
In general we use Rclone for transferring files from cloud services. When possible we also use it to confirm the fixity of the files downloaded.
...