WebDAV access

From OpenKM Documentation
Revision as of 16:56, 16 November 2011 by Pavila (talk | contribs) (Windows)

Jump to: navigation, search

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/repository/default

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.


Nota clasica.png 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

Windows

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


Nota clasica.png 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:


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

Connection from Windows without third-party software

  • 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/

Nota clasica.png 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:

Linux

From Linux you can use:

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

See also: