Versions Compared

Old Version 15

changes.mady.by.user Maithili Kalamkar-Stam

Saved on

compared with

New Version Current

changes.mady.by.user Alice Stuart-Lee

Saved on

Key

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

This documentation is derived from https://www.uu.nl/en/research/yoda, and adjusted to Yoda hosted at SURF.

You can upload and download data to and from Yoda , by using the Yoda Network Disk drive on your laptop or PC. This will add a network drive to your computer that contains your research data. Once the Yoda Network Disk network drive has been configured, you can use your existing applications and tools to work with the data. See Yoda servers' hostnames and URLsHosting (URLs) for looking up the correct URL to use for the Yoda Network Disknetwork drive.

Credentials

To access Yoda via network disk is required to get the network drive, a Data Access Password is required (How to get a Data Access Password).

The Data Access Password must be entered when a password is requiredrequested.

For Windows users:

Mapping the network drive

Open “This PC” from the Start menu

...

Select a drive letter — any free letter is okay. Now enter the server address of the environment in the Folder field (see Yoda servers' hostnames and Hosting (URLs)).

Ensure the box “Connect using different credentials” is checked and click on the "Finish" button.

You will be prompted for a name and password. If you are working on your personal PC or laptop, tick the checkbox “Remember my credentials”. If you are working on a shared computer, it is better not to tick this checkbox for security reasons. Click on the “OK” "OK" button.

The Explorer screen will show the folders you have access rights to. You can now drag and drop your files to upload or download them.

Increasing maximum file size

By default, the native WebDAV client only works with files smaller than 50 MB. You can increase this limit to 4 GB if you have a local administrator account:

  • Open the registry editor by pressing the start button, entering “regedit” and pressing the enter key.
  • If you are asked whether the registry editor should be allowed to change the system settings, confirm.
  • Navigate to key HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters
  • Open the FileSizeLimitInBytes key

...

  • Set it to FFFFFFFF (hexadecimal)

  • Click on the “OK” "OK" button and close the registry editor
  • Restart your computer


For Mac users:

You can open the Yoda Network Disk drive using the Finder app. By default, the Finder icon is shown in the bottom left corner of your screen , (in the Dock). Click on this icon.

If you don’t see the Finder icon, you can alternatively start Finder by pressing the command key and the space bar, then typing “finder” and pressing enter.

Now press the command key and the “K” "K" key to connect to the Yoda server. You should now see this dialog:

...

Enter the server address of your environment, see Yoda servers' hostnames and URLsHosting (URLs).

The Finder app will show a confirmation dialog, similar to the one below. The address shown in the dialog should be the address you entered in the previous dialog.

...

You should now have a new Yoda Network Disk network drive location in Finder. Its name is the network address you entered before. You may have to scroll down in finder in order to see it.


For Linux users:

GNOME users can connect to the Yoda Network Disk drive using GNOME Files (also known as Nautilus in older versions of GNOME). Alternatively, if you are comfortable with using commandline command line tools, utilize use davfs2 to mount the Yoda Network Disknetwork drive. The Cadaver commandline command line WebDAV client is also compatible with the Yoda Network Disknetwork drive.

Connecting using GNOME files

GNOME users can connect to the Yoda Network Disk network drive with GNOME Files (also known as Nautilus in older versions of GNOME).

...

Click on “+Other Locations” and enter the server address in the “Connect to Server” bar, see Yoda servers' hostnames and URLsHosting (URLs).

Then click on the Connect button.

...

This page describes how to connect to the Yoda Network Disk network drive on a Linux system using davfs2. It assumes familiarity with using commandline command line tools. The instructions are suitable for RedHat-based distributions (e.g., Fedora or CentOS) and for Debian-based distributions (e.g., Ubuntu).

Installing the package

Install the davfs2 package.

...

  • sudo apt -y install davfs2
  • Confirm that unprivileged users should be able to mount davfs2 volumes (“Yes”"Yes"). 

For RedHat/CentOS/Fedora:

  • sudo yum -y install epel-release
  • sudo yum -y install davfs2

Configuring group membership

Look up your user name, uid and gid using the “id” command.

Add your user account to the davfs2 group: sudo usermod -aG davfs2 user (replace “user” "user" with your user nameusername).

Close the terminal window and open a new one to activate the group change.

Configuring Davfs2

Open the davfs2 configfile config file in a text editor (e.g., sudo vi /etc/davfs2/davfs2.conf). Ensure parameter delay_upload is set to 0 (zero). This limits the risk of data loss from a failure to flush data after large file transfers.

Look up the Yoda Network Disk network drive URL of your Yoda Environmentenvironment.

Open the /etc/fstab file in a text editor (e.g., sudo vi /etc/fstab) and add a configuration line for the Yoda Network Disknetwork drive:

https://surf-data.irods.surfsara.nl /mnt davfs user,auto,uid=1000,gid=1000 0 0

...

  • Replace https://surf-data.irods.surfsara.nl with the URL of your Yoda Network Disknetwork drive, see Yoda servers' hostnames and URLsHosting (URLs).
  • If you’d like to mount the Yoda Network Disk network drive in a different location, replace /mnt with a different local directory.
  • Replace the uid and gid parameters with your uid and gid, as shown by the id command.
  • If you don’t want the Yoda Network Disk network drive to be mounted automatically after your system starts, remove “auto,” from the options.

Now use a text editor to create a secrets file, which contains your Yoda Network Disk network drive URL, Yoda user name username and password, separated by spaces. Example of a secrets file: “https://surf-data.irods.surfsara.nl j.jansen@uu.nl mySecretPassword”. You need to escape any backslashes and double quotes in your password with a backslash (e.g. use “"\\” " instead of “"\”").

Install this secrets file as the global davfs2 secrets file:

  • sudo install -m 0600 -o root -g root secrets /etc/davfs2/secrets
  • rm secrets

Mounting the Yoda Network

...

drive

The disk drive should be mounted automatically after a reboot if you have configured the “auto” "auto" option in /etc/fstab.

To manually mount the Yoda Network Disknetwork drive:

  • On Debian/Ubuntu: mount /mnt
  • On RedHat/CentOS/Fedora: sudo mount /mnt (you can ignore any warnings about writing to the mtab file)

...