Difference between revisions of "WebDAV access"

Revision as of 16:59, 21 December 2011

While OpenKM has had WebDAV support since early versions, the new WebDAV implementation in version 5.1.8 brings improved WebDAV compatibility, thanks to its use of the excellent open-source Milton WebDAV API for Java. The Milton project maintains a detailed WebDAV client compatibility list that describes a "Recipe for broad client compatibility."

Below you there is a list of WebDAV clientes grouped by Operating System. Once you have installed any of these tools, you can access to OpenKM repository with this URL:

http://your-domain.com/OpenKM/webdav

To enhance compatibility, starting with OpenKM 5.0.4 when an WebDAV path is like /okm:root/myfile.txt it is translated to /okm_root/myfile.txt because some WebDAV clients does not like character : in the path. Starting with OpenKM 5.1 we have added a new configuration parameter called system.webdav.fix to make this behavior configurable.

Since OpenKM 5.0 WebDAV is disabled by default. If you want to enable it, add system.webdav≠on to your OpenKM.cfg configuration file. Starting with OpenKM 5.1 this property will be renamed to: system.webdav.server≠on And should be changed from Administration > Configuration.

Windows

From Windows you can access OpenKM repository exposed via WebDAV using one o this tools:

• http://www.netdrive.net/ (Free for home use but does not handle document versioning properly)
• http://www.webdrive.com/ (The recommended option and create a new document version when you save the modifications)

Starting with OpenKM 5.1.8 WebDAV URL is http://host:8080/OpenKM/webdav/okm:root.

Connection from Windows without third-party software

Be aware that there are multiple versions of WebDAV Microsoft libraries (and different flavors of bugs). To avoid some frustration if the steps below don't work for you, [Update Windows XP for Web Folders], or take more information about Web Folder Client (MSDAIPP.DLL) Versions and Issues.

Windows Vista and Windows 7 both restrict access to WebDAV servers that use Basic HTTP authentication on non-SSL connections. This restriction can be solved by changing a registry key. Read more on . However, SSL connections do bring improved security. This page from Greenbytes is an excellent resource to analyze & fix problems with your Windows WebDAV client.

You can try connecting directly using windows networking:

• open networking
• connect as network resource
• write url http://host:8080/OpenKM/repository/default/okm:root
• write user and password

• Open the Registry Editor utility (regedit.exe).
• Into HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters look for TypeUseBasicAuth and replace the default value (1) by 2 allowing BasicAuth through NON SSL connections.
• Then map your drive using this address: \\localhost:8080/OpenKM/repository/default/okm_root/

Starting with OpenKM 5.1.8 the WebDAV URL is \\localhost:8080/OpenKM/webdav/okm_root/.

See also: Forum: OpenKM + Webdav + Windows 7 => finally working.

Windows slow WebDAV performance

If you have a slow webdav connection in windows 7 please follow the instructions in Fix Slow WebDAV Performance in Windows 7. It turns out to be a windows issue, not OpenKM.

Furthermore in Windows 7/Vista you need to add your certificate (if its not issued by a verified CA) into windows if you plan to use Webdav over SSL (and,like me, do not compensate with digest auth):

1. Get the certificate from the server administrator in CER format or download it from Firefox.
2. Start windows Certificate Manager: in “cmd” type certmgr.msc
3. Select on the left “Trusted Root Certification Authorities”
4. In the menu “Actions” -> “All Tasks” select “Import” and then “Next”
5. Browse for the location of certificate file you saved earlier on your computer and click “Open”.
6. You will get a few more warning messages. Just say to go through with it until the certificate is accepted.

Then you can map webdav content as a network drive without any other software. The folder should be: https://server:port/OpenKM/repository/default/

To make sure that everything is ok with certificates, open the address using IE. If no warning pops up then its a go.

This allows you to read/view files. If you need write access over a network drive you need to disable File Locking (windows does not support webdav file lock).

Note: For Windows XP there is a fix (KB907306).

See also: Forum: OpenKM + Webdav + Windows 7 => finally working.

Mac

From OS X you can use:

• http://cyberduck.ch/
• http://www.webdrive.com/ (Yes, there is a version for Macintosh OS/X)

Linux

From Linux you can use:

• http://dav.sourceforge.net/
• http://savannah.nongnu.org/projects/davfs2

For example, in Ubuntu or any Debian-based Linux distro you can install this utility this way:

$ sudo aptitude install davfs2

Make a mount point:

$ mkdir ~/okmdav

And mount it:

$ sudo mount.davfs "http://localhost:8080/OpenKM/repository/default" ~/okmdav

Starting with OpenKM 5.1.8 WebDAV URL is http://host:8080/OpenKM/webdav.

See also:

• Ubuntu: Mounting remote filesystem using davfs2 (FUSE)