====== Installazione e Configurazione Server WebDav ======

===== Installazione Base =====
  - Abilitare i moduli WebDAV. <cli>sudo a2enmod dav 
sudo a2enmod dav_fs</cli>
  - Riavviare Apache. <cli>sudo service apache2 restart</cli>
  - Creare la cartella che farà da repository WebDAV ed assegnarla ad Apache (www-data). <cli>mkdir -p <Your DocumentRoot>/web 
chown www-data <Your DocumentRoot>/web</cli>
  - Creare il file delle password per WrbDAV. <cli>htpasswd -c <Your DocumentRoot>/passwd.dav <Nome_Utente></cli>
  - Cambiare Owner e permessi del file appena creato come segue: <cli>chown root:www-data <Your DocumentRoot>/passwd.dav
chmod 640 <Your DocumentRoot>/passwd.dav</cli>
  - Modificare il file di configurazione del VirtualHost in uso (presumibilmente Default) come segue: <cli>sudo nano /etc/apache2/sites-available/default</cli> e renderlo simile a quello seguente <file><VirtualHost *:80>

        DocumentRoot /var/www/web1/web/
        <Directory /var/www/web1/web/>
                Options Indexes MultiViews
                AllowOverride None
                Order allow,deny
                allow from all
        </Directory>

	Alias /webdav /var/www/web1/web

        <Location /webdav>
           DAV On
           AuthType Basic
           AuthName "webdav"
           AuthUserFile /var/www/web1/passwd.dav
           Require valid-user
       </Location>

</VirtualHost></file> Ovviamente i percorsi vanno adattati alla situazione
  - Riavviare Apache. <cli>sudo service apache2 restart</cli>

Il server WebDAV ora dovrebbe essere raggiungibile su [[http://site-address/webdav]] con le credenziali dell'utente create al punto 5

===== Installazione WebDAV CGI =====

==== Installazione pre-requisiti ====
<cli>
## Debian/Ubuntu quick install: 
sudo apt-get install libdbi-perl libdbd-sqlite3-perl libtimedate-perl libuuid-tiny-perl libxml-simple-perl libquota-perl libarchive-zip-perl \
libgraphics-magick-perl libmodule-load-perl libfile-copy-link-perl libjson-perl libdatetime-perl

sudo perl -MCPAN -e "install DateTime::Format::Human::Duration"

## only for SMB backend users:
sudo apt-get install libfilesys-smbclient-perl

## only for RCS backend users:
sudo apt-get install librcs-perl
</cli>

==== Installazione pacchetti aggiuntivi ====
I seguenti pacchetti sono facoltativi ma rendono migliore l'interfaccia di WebDAV CGI:
   - Speedy - rende WebDAV CGI più veloce (Debian/Ubuntu: speedy-cgi-perl)
   - Ghostscript - consente all'interfaccia di WebDAV CGI di generare i thumbnails per o files PDF/PS (Debian/Ubuntu: ghostscript)
   - smbclient (solo per utilizzo del backend SMB) - consente all'interfaccia web di visualizzare informazioni sulla Quota (Debian/Ubuntu: smbclient)
   - kinit (solo per utilizzo dei backends SMB e AFS) - consente di omettere il modulo mod_auth_kerberos (Debian/Ubuntu: krb5-user) 

<cli>
## Debian/Ubuntu quick install:
apt-get install speedy-cgi-perl ghostscript

## only for SMB backend users:
apt-get install smbclient

## only for SMB and AFS backend users:
apt-get install krb5-user
</cli>

===== WebDAV CGI =====
  - Scaricare [[http://webdavcgi.sourceforge.net/index.html#download|WrbDav CGI]]
  - Spostarsi in //''/etc''// <cli>cd /etc</cli>
  - Decomprimere il file precedentemente scaricato <cli>sudo tar jxf webdavcgi-latest.tar.gz2</cli>
  - Entrare nella cartella appena estratta <cli>cd webdavcgi*</cli>
  - Avviare l'installazione <cli>sudo ./install.sh</cli>
  - Vedere la sezione seguente per la configurazione
  - Configurare Apache
     * Abilitare il modulo //''rewrite''// <cli>a2enmod rewrite</cli>
     * Verificare le sezioni di configurazione specifiche per ogni backend [[http://webdavcgi.sourceforge.net/doc.html#afs|AFS]], [[http://webdavcgi.sourceforge.net/doc.html#gfs|GFS]], [[http://webdavcgi.sourceforge.net/doc.html#smb|SMB/CIFS]], [[http://webdavcgi.sourceforge.net/doc.html#dbb|DBB]] e [[http://webdavcgi.sourceforge.net/doc.html#rcs|RCS]]
  - Modificare il file di configurazione del VirtualHost in uso (presumibilmente Default) aggiungendo le voci per lo scenario desiderato: <file>### EXAMPLE 1: a complete (virtual) server root handled by WebDAV CGI:
ScriptAlias /webdavcgi /etc/webdavcgi/cgi-bin/webdavwrapper
# ScriptAlias /logout /etc/webdavcgi/cgi-bin/logout
<Location /webdavcgi>
        AuthType Basic
        AuthName "WebDAV/CalDAV/CardDAV space"
        AuthUserFile /path-to-my-auth-file
        Require valid-user
</Location>
RewriteEngine On
# RewriteRule /logout - [L]
RewriteRule ^/ /webdavcgi [PT,E=WEBDAVCONF:/etc/webdav.conf,E=PERLLIB:/etc/webdavcgi/lib/perl,L]
</file> <file>
### EXAMPLE 2: a virtual path /webdav
ScriptAlias /webdavcgi /etc/webdavcgi/cgi-bin/webdavwrapper
# ScriptAlias /webdav/logout /etc/webdavcgi/cgi-bin/logout
<Location /webdavcgi>
        AuthType Basic
        AuthName "WebDAV space"
        AuthUserFile /path-to-my-auth-file
        Require valid-user
</Location>
# if you want to map this to a real path, do that:
# (end setup $VIRTUAL_BASE='/webdav/?' and $DOCUMENT_ROOT in your WebDAV CGI config)
RewriteEngine On
# RewriteRule ^/webdav/logout - [L]
RewriteRule ^/webdav /webdavcgi  [PT,E=WEBDAVCONF:/etc/webdav.conf,E=PERLLIB:/etc/webdavcgi/lib/perl,L]
</file> <file>
### EXAMPLE 3: a .htaccess file to handle a complete folder with WebDAV CGI:
### Prerequisites: /webdavcgi is a script alias 
##       (ScriptAlias /webdavcgi /etc/webdavcgi/cgi-bin/webdavwrapper) and
###      'AllowOverride AuthConfig FileInfo' is set for the current folder
RewriteEngine On
RewriteRule .* /webdavcgi [E=WEBDAVCONF:/etc/webdav.conf,E=PERLLIB:/etc/webdavcgi/lib/perl]

AuthType Basic
AuthName "A protected WebDAV folder"
AuthUserFile /path-to-my-auth-file
Require valid-user
</file>

<note important>Questa guida è un Work In Progress</note>

===== Riferimenti =====
^ Argomento ^ Sito ^
| Preparazione Apache con WebDAV | http://www.qazxdr.com/setting-up-webdav-server-on-ubuntu-12-04/ |
| Installazione WebDAV CGI | http://webdavcgi.sourceforge.net/doc.html#installation \\ http://webdavcgi.sourceforge.net/doc.html#setup|