Get WebDAV CGI at Fast, secure and Free Open Source software downloads

WebDAV CGI: Troubleshooting Guide

Content of this site:
Back to the WebDAV CGI home

Client issues

Finder (MacOS X 10.x): iCal: Addressbook (MacOS X 10.6.x): iPhone/iPad: Windows Vista/7:

Setup/Configuration issues


Maybe it helps to increase the Timeout value in your Apache configuration (300 is a good minimum value).
If a larger Timeout value does not fix the problem perhaps the Apache mod_reqtimeout is loaded. You should disable this module (Debian/Ubuntu: a2dismod reqtimeout; /etc/init.d/apache2 restart) or configure it with larger values.

Apache error log: Request exceeded the limit of X internal redirects due to probable configuration error. Use 'LimitInternalRecursion' to increase the limit if necessary. Use 'LogLevel debug' to get a backtrace.

This is a typical rewrite misconfiguration. A common mistake is to take the .htaccess rewrite rule example for the Apache configuration. A rule like RewriteRule .* ... in the Apache configuration runs into a 'endless' recursion only stopped by the Apache limit (LimitInternalRecursion). Please use a rule like RewriteRule ^/ ... to fix this problem. In a .htaccess makes the pattern ^/ no sense because this pattern will never match. Rewite rule patterns in a .htaccess have to be relative to the current path therefore .* works fine.
If this does not help put the following to your Apache configuration:
RewriteLogLevel 3
RewriteLog /var/log/apache2/rewrite.log
and analyze the rewrite.log after a single access to your WebDAV area and don't forget to set the RewriteLogLevel back to 0 after your debug session.

404 File Not Found / 500 Internal Server Error / 'Premature end of script headers'

Please check the following:
  1. Apache error log - Apache writes sometimes helpful things into logs
  2. read and execute file permissions of webdavwrapper and and fix it if necessary (owner/group too):
    chmod a+rx
    chmod a+rx,ug+s webdavwrapper
    chown root:root webdavwrapper
  3. shebang of path to the Perl interpreter have to be correct
  4. /etc/webdav.conf syntax (maybe a broken config):
    #> perl -c /etc/webdav.conf
    webdav.conf syntax OK
  5. check your /etc/webdav.conf: wrong $VIRTUAL_BASE or $DOCUMENT_ROOT values are cause for a 404 File Not Found
  6. syntax (maybe a broken config or a missing Perl module):
    #> perl -I/etc/webdavcgi/lib/perl -c syntax OK
    #> bash /etc/webdavcgi/checkenv 
    +++ Checking perl:
      perl /usr/bin/perl
    ++++ Checking required modules:
      CGI installed
      DBI installed
      POSIX installed
      File::Temp installed
      Date::Parse installed
      UUID::Tiny installed
      XML::Simple installed
      Quota installed
      Archive::Zip installed
      IO::Compress::Gzip installed
      IO::Compress::Deflate installed
      Digest::MD5 installed
      Module::Load installed
    ++++ Checking optional modules:
      DBD::SQLite installed
      DBD::mysql installed
      DBD::Pg installed
    ++++ Checking required modules for FS backend:
      File::Spec::Link installed
    ++++ Checking required modules for AFS backend:
      File::Spec::Link already checked
    ++++ Checking required modules for GFS backend:
      File::Spec::Link already checked
    ++++ Checking required modules for SMB backend:
      Filesys::SmbClient installed
    ++++ Checking required modules for RCS backend:
      Rcs installed
    ++++ Checking optional binaries:
      smbclient /usr/bin/smbclient
    #### Summary:
    All modules found.
    All binaries found.
  7. Check your database setup ($DBI_SRC, $DBI_USER, $DBI_PASS).
  8. Call from a shell:
    #> env WEBDAVCONF=/etc/webdav.conf perl -I/etc/webdavcgi/lib/perl 
    DAV: 1, 2, 3, <>, extended-mkcol, access-control, calendar-access, calendarserver-private-comments, calendar-auto-schedule, addressbook, bind
    MS-Author-Via: DAV
    Status: 404 Not Found
    Date: Mon, 14 Mar 2011 12:51:35 GMT
    Etag: "d41d8cd98f00b204e9800998ecf8427e"
    Content-length: 0
    Content-Type: text/plain; charset=utf-8
  9. Call webdavwrapper from a shell:
    #> ./webdavwrapper
    Status: 404 Not Found
    Content-Type: text/plain
    404 Not Found - your wrapper
  10. Contact the author

FreeBSD/OpenBSD: all LOCK requests result in a segmentation fault error (signal 11)

In some installations OSSP::uuid module lets Perl crashing with a segmentation fault. A solution is to replace OSSP::uuid with UUID::Tiny (thx Tony Wijnhard):
  1. install UUID::Tiny: perl -MCPAN -e 'install UUID::Tiny'
  2. replace use OSSP:uuid; with use UUID::Tiny;:
    sed -i -e 's@use OSSP::uuid;@use UUID::Tiny;@g'
  3. replace sub getuuid { with sub _unused_getuuid {:
    sed -i -e 's@^sub getuuid@sub _unused_getuuid@g'
  4. add a new getuuid routine to
    cat - >> <<'EOF'
    sub getuuid {
            my ($fn) = @_;
            my $uuid_ns = create_UUID(UUID_V1, "opaquelocktoken:$fn");
            my $uuid = create_UUID(UUID_V3, $uuid_ns, "$fn".time());
            debug("_LOCK after uuid made in method:");
            return UUID_to_string($uuid);

Web interface: Copy/Cut/Paste and bookmarks do not work as expected.

WebDAV CGI uses the 'secure' flag for cookies. If you access the Web interface without encryption (http instead of https) all cookie based actions do not work.

Web interface: missing stylesheets, locales, and/or icons

  1. Check your $INSTALL_BASE variable in your /etc/webdav.conf (maybe you forget the trailing slash?)
  2. Check /etc/webdav.conf syntax: perl -c /etc/webdav.conf
  3. Check your Apache rewrite rule: the path to your webdav.conf must be correct: E=WEBDAVCONF:/etc/webdav.conf

Web interface: wrong date/time/number formatting for a language

WebDAV CGI uses language specific formattings for date/time/numbers. Check your locales
#> locale -a
and install missing locales for the language with a wrong date/time/number formatting, e.g. Ubuntu:
# add new locale entry to the list:
echo fr_FR.UTF-8 UTF-8 >> /var/lib/locales/supported.d/local
# or add all supported locales (! slows down package installation/updates):
### cp /usr/share/i18n/SUPPORTED /var/lib/locales/supported.d/local

# and don't forget to compile locale definition files:

Slow response working with WebDAV resources on Windows Vista or Windows 7

OR: see

RedHat/Fedora/CentOS: Graphics::Magick does not compile


Apache error log: Permission denied: exec of '.../webdavwrapper' failed

Speedy problems with different WebDAV CGI instances on a single server

If you run multiple WebDAV CGI instances on a single server with different setups and databases you have to separate the Speedy instances. This can be done with a additional rewrite option: E=SPEEDY_TMPBASE:myprojecttmpbase (replace myprojecttmpbase with a unique name for a WebDAV CGI instances, e.g. E=SPEEDY_TMPBASE:/tmp/project2)

Common issues

Wide character in print at ... warning

You can ignore this warning.
© ZE CMS, Humboldt-Universität zu Berlin | Written 2010-2015 by Daniel Rohde