Data Transfer/WebDAV

From bwHPC Wiki
Jump to navigation Jump to search

WebDAV is a network protocol used for data transfer. It is based on http and offers a faster and more robust connection than sftp. The suitability for permanent connections depends highly on the used client. We advise the Rclone client. An introduction is given on the Rclone page. See rclone webdav config docs for more details.

Usage

Windows

See the instructions for establishing a permanent connection with smb. Replace the smb network path with the webDAV url and use your regular username of the form xy_ab123.

MacOS & Linux (using Rclone)

To configure a WebDAV remote for a specific service, you need the following information:

  • Url
  • Username
  • ServicePassword

Instructions

Execute:

rclone config

This will guide you through an interactive setup process. Afterwards, you should have a look at rclone usage and rclone mount. The needed <client-name> is the name that you choose in your configuration beneath.

No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> `<client-name>`

Type of storage to configure.
Choose a number from below, or type in your own value
[snip]
XX / WebDAV
   \ "webdav"
[snip]
Storage> webdav

URL of http host to connect to
E.g. https://example.com
Enter a value
url> `<url>`

Name of the WebDAV site/service/software you are using
Choose a number from below, or type in your own value
 1 / Fastmail Files
   \ (fastmail)
 2 / Nextcloud
   \ (nextcloud)
 3 / Owncloud
   \ (owncloud)
 4 / Sharepoint Online, authenticated by Microsoft account
   \ (sharepoint)
 5 / Sharepoint with NTLM authentication, usually self-hosted or on-premises
   \ (sharepoint-ntlm)
 6 / Other site/service or software
   \ (other)
vendor> other

User name
user> `<username>`

Password.
y) Yes type in my own password
g) Generate random password
n) No leave this optional password blank
y/g/n> y
Enter the password:
password: <enter *ServicePassword*>
Confirm the password:
password: <enter *ServicePassword*>

Bearer token instead of user/pass (e.g. a Macaroon)
bearer_token>

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Remote config
--------------------
[`<client-name>`]
type = webdav
url = `<url>`
vendor = other
user = `<username>`
pass = *** ENCRYPTED ***
bearer_token =
--------------------
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
After this, you can exit the rclone config program.

Source and destination paths are specified by the name you gave the storage system in the config file (<client-name>), then the subpath (e.g. "<client-name>:folderX" to look at folderX on the remote system).