User manual: WebDAV connection setup


Using the WebDAV protocol is a convenient way to connect to data from DataHub. WebDAV is compatible with multiple software tools and libraries, such as web browsers, WinSCP, operating system-specific file browsers and Cyberduck. 

In this manual we limit ourselves to the use of Cyberduck, Windows Explorer and Linux.

The Cyberduck setup manual is directly available in MDR! Using this is our preferred method of connecting.




Credentials

Generate a WebDAV password 

You will find your user name and a generated password on the submenu of your user on the Navbar.

Please note that the password is shown once, you need to save it for future use until it expires!



Connect using Cyberduck

Download, Open and Connect Cyberduck

You can find the latest version of Cyberduck here.

When Cyberduck is installed, download the Cyberduck profile from MDR and enter your credentials.

Attention

Drop zones and projects are accessed by a different WebDAV endpoint, make sure you connect to the right endpoint.


Manual connection information for Cyberduck

Click on Open Connection.


Choose WebDAV(HTTPS) in the upper dropdown. 

Enter the login information

  • Server -  URL - found in MDR (A Cyberduck profile can be found in MDR)
  • Port - 443
  • Username - this is the username you copied from the previous step
  • Password - this is the password you copied from the previous step

You many need to uncheck the Anonymous Login check box to input your username and password

Click Connect. When the login is successful, you will see your collections.




connect using Windows Explorer

There is a known limitation in the default WebDAV driver for Windows. The maximum filesize is set to 50 MB and can be expanded to about 4 GB using a registry hack.


More information on how to change this setting can be found on the Microsoft Support website.
Be aware that changing the Windows registry is risky and if you decide to do so, it is on your own risk!

Instead, for transferring large files, we recommend to use the Cyberduck client (described above).

 I'm willing to take that risk...
1. Open regedit
2. Navigate to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters
3. Change the value of 'FileSizeLimitInBytes' to the maximum of 4294967295


Add WebDAV in Windows 


Open My Computer ( + E)

Click Map network drive 

  • Choose a new drive letter
  • at Folder enter the url mentioned in MDR
  • Disable Reconnect at sign-in
  • Enable Connect using different credentials. 

Click Finish and enter the credentials from the previous step.

Press OK and you can now browse and copy the data from the drive letter you chose.







connect using Linux

There are several ways to access WebDAV in Linux. We recommend the following two ways.

  1. Mount WebDAV through davfs2
  2. Download a collection directly through wget

There are advantages and disadvantages to both methods. Using wget you will download the entire collection directly and fast to your local share.

davfs2 will make all files of a collection accessible without downloading all. Furthermore it caches files that were opened before speeding up repeated access. This can be a benefit in certain applications. But can be a drawback when many big files need to be downloaded.

davfs2
# Make sure the package davfs2 has been installed
sudo mount -t davfs WEBDAV_URL /path/to/mount
wget
/usr/bin/wget \
    --mirror \   
    --no-host-directories \
    --no-parent \
    --reject 'index.*' \
    --user <user>@maastrichtuniversity.nl \
    --ask-password \
    WEBDAV_URL/P000000001/C000000001/