WebDAV, according to WebDAV.org, "stands for "Web-based Distributed Authoring and Versioning". It is a set of extensions to the HTTP protocol which allows users to collaboratively edit and manage files on remote web servers." WebDAV provides an easy way to manipulate remote files. CyVerse has added support for WebDAV to the Data Store. This means a users can access their home and public folders in the CyVerse Data Store from their local computers use web browsers and other WebDAV enabled applications like common operating system file managers. With WebDAV, a user can copy files between her local computer and the Data Store as easily as if she were copying them between two folders on her local computer.
WebDAV works best for small files or small collections of files. There is no hard size limit for files, but it is recommended to not work with files over 1 GiB in size. However, 10 GiB files have been downloaded from the CyVerse WebDAV service using a web browser with decent performance. The iCommands still out perform WebDAV. For better ways to download large files or large sets of files, please see Data Store Intro.
Accessing the WebDAV Service
There are two ways to access the WebDAV service. It provides anonymous read-only access through URLs rooted at https://data.cyverse.org/dav-anon/. All data that can be seen by the
anonymous user can be accessed anonymously through this service excluding the immediate contents of
/iplant/home and the immediate contents of
is any CyVerse login. The service also provides authenticated access through URLs rooted at https://data.cyverse.org/dav/. Once a user has authenticated with his CyVerse credentials, he can access any file or folder with the permission level he has on that file or folder.
A user with a CyVerse login of <username> would use the WebDAV link https://data.cyverse.org/dav/iplant/home/<username>
to access his data.
To access project data stored in iRODS at
, the link https://data.cyverse.org/dav/iplant/projects/<project>/ would be used.
To access data released by the CyVerse community into the Data Commons, the following link can be used: https://data.cyverse.org/dav-anon/iplant/projects/.
CyVerse Curated Data
To access the data curated by CyVerse in the Data Commons (that is, datasets with DOIs), the following link can be used: https://data.cyverse.org/dav-anon/iplant/commons/cyverse_curated/.
Common Ways to Access the WebDAV Service
Since WebDAV is an extension of HTTP, any web browser can be used to browse and download data through the service.
Most common operating systems come with a file manager application that can interface with a WebDAV service and can mount a WebDAV folder into the local file system. This allows other applications running on the same computer to access WebDAV data as if it were local.
Mac OS X Finder
The following instructions demonstrate how to mount a Data Store folder using Finder.
- Open a Finder window.
- Click the Go menu at the top left and then click Connect to Server (or type command k):
- In the Server Address field, enter the URL for the folder to access and click Connect.
- Enter your CyVerse username and password if prompted. If you want to have your username and password saved and automatically used the next time you connect to the Data Store using WebDAV, click Remember this password in my keychain.
- Once connected, the chosen Data Store folder appears under the Shared section in Finder, and you may now interact with it as if it is a local or network storage device.
Microsoft Windows File Explorer
The following instructions demonstrate how to mount a Data Store folder in Windows 10 using the File Explorer.
- Open File Explorer (file and folder browser).
- Right click on This PC.
- Click on Map network drive....
- In the What network folder would you like to map? window, click on Connect to a Web site that you can use to store your documents and pictures.
- In the Welcome to the Add Network Location Wizard, click Next button
- In Where do you want to create this network location?, click on Choose a custom network location.
- In Specify the location of your website, enter the WebDAV URL for the desired Data Store folder. Then click Next.
- If you want your home folder and your username is myusername, use https://data.cyverse.org/dav/iplant/home/myusername/.
- If you want a community folder named shareddata, use https://data.cyverse.org/dav-anon/iplant/projects/shareddata/.
- Windows will ask you to authenticate if the folder is restricted. Enter your credentials and check the box Remember my credentials, if desired. Click OK.
- In the What do you want to name this location?, you can click on Next to accept the default name or create your own name.
- In the Completing the Add Network Location Wizard, click on Finish.
- The folder should automatically open (if you left the checkbox checked). Otherwise, you can find the folder in File Explorer, under the Network icon.
These instructions are for Microsoft Windows 7. Other versions of Microsoft Windows should be similar, but have not been tested.
Problems have been reported using WebDAV with Microsoft Windows 7, especially the 64-bit version. This is an operating system issue — not a CyVerse issue. See the Microsoft Answers website for more information. An alternate setup for Windows 7 64-bit is listed below.
The following instructions demonstrate how to mount a Data Store folder in Windows 7 using the File Explorer.
- Click the Windows logo at the bottom left of the screen to open the Start menu.
- Click Computer from the list at the right:
- To add a network connection, right-click in the Computer window and then click Add a network location:
- Enter your Data Store information.
- Click Choose a custom network location and then click Next.
- Enter the WebDAV URL for the desired Data Store folder, and click Next.
- Enter your CyVerse username and password if prompted. If you want to have your username and password saved and automatically used the next time you connect to the Data Store WebDAV service, click Remember my credentials, and click OK.
Once connected, the chosen Data Store folder appears in Windows Explorer, and you may interact with it as if it were a local or network storage device.
Windows 7 Alternate
This setup circumvents the issues caused by the built-in Microsoft WebDAV Mini Redirector.
- Go to NetDrive to download and install the NetDrive WebDAV client.
- Start NetDrive.
- Click New Site.
- Enter a name for the connection.
- Click Server Type and then click WebDAV.
- In the Site IP or URL field in NetDrive, enter the WebDAV URL for the desired Data Store folder.
- If authentication is required, click the Account field and enter your CyVerse username.
- If authentication is required, click the Password field and enter your CyVerse password.
- Click Advanced.
- In the Advanced window:
- Click Use HTTPS.
- Click OK. The port should change to 443.
- Select a drive letter.
- (Optional) Click Automatic login when system starts or Automatic login when NetDrive starts.
- Click Save.
- Click Connect.
Gnome Desktop on Linux
These instructions were written using Ubuntu 18.04. Other Linux distributions with a desktop environment will be similar.
The following instructions demonstrate how to mount a Data Store folder in the Gnome Desktop.
- Open Files (the file manager).
- Select Other Locations in the Places sidebar.
- In the Connect to Server footer, enter the WebDAV URL for the desired Data Store folder. Note: Files identifies TLS encrypted WebDAV URLs with the scheme
davs . This means the base for CyVerse URLs is
davs://data.cyverse.org/ instead of
- Click the neighboring Connect button.
- Provide your CyVerse username and password if prompted.
Privilege Escalation Requirement
This method requires root or at least sudo access.
The following instructions demonstrate how to mount a Data Store folder into the file system through a terminal.
- Ensure that davfs2 is installed, e.g., for Ubuntu,
sudo apt install davfs2.
- Create a directory where you want to mount the desired Data Store folder, e.g.,
- Mount the data as root, i.e.,
sudo mount -o gid=<you>,uid=<you> -t davfs <link> /tmp/data, where <you> is your username on the Linux machine and <link> is the WebDAV URL to the desired Data Store folder.
- Provide your CyVerse username and password if prompted.