====== Installation ======


Pré-requis :
  - disposer d'un espace applicatif, par exemple ''/applis/svnwebadmin/''
  - disposer d'un serveur Apache2 avec les modules  ''mod_php5'', ''mod_dav'', et ''mod_dav_svn'' (éventuellement ''mod_ldap'' et ''mod_authnz_ldap'' si votre base d'utilisateur utilise un annuaire LDAP)
  - régler le DocumentRoot pour le faire pointer par exemple sur ''/applis/svnwebadmin/www/''

Voici comment procéder pour installer SvnWebAdmin sur un tel serveur :
  - récupérer la dernière version : <code>svn co https://subversion.cru.fr/svnwebadmin/trunk svnwebadmin</code>
  - récupérer les sources de la dernière version de svnwebadmin : <code>
cd /applis/svnwebadmin/
svn co https://subversion.cru.fr/svnwebadmin/trunk swa
</code>
  - créer un fichier ''prepend.php'' dans ''/applis/svnwebadmin/www/'' : <code php>
<?php

$delim = PATH_SEPARATOR;
$classpath  = '.'.$delim;
$classpath .= dirname(__FILE__).'/../swa/lib/pear'.$delim;
$classpath .= dirname(__FILE__).'/../swa/lib/classes'.$delim;
$classpath .= ini_get('include_path');
ini_set('include_path',$classpath);
</code>
  - créer un fichier ''index.php'' dans ''/applis/svnwebadmin/www/'' :<code php>
<?php

require_once dirname(__FILE__).'/prepend.php';

$title            = 'SVNWebAdmin demo';
$repository_path  = dirname(__FILE__).'/../repository';
$repository_url   = 'http://'.$_SERVER['SERVER_ADDR'].'/repository/%s/';
$authz_path       = dirname(__FILE__).'/../etc/authz';
$resources_path   = dirname(__FILE__).'/rsc';
$resources_url    = './rsc';
$debug            = false;

// indiquez directement le nom d'utilisateur authentifié
// si vous désirez utiliser un système d'authentification externe
//$auth_username = 'utilisateur-authentifie';

$connection_driver = 'LDAP';
$connection_options = array(
                            // parametre specifiques ldap
                            'host'       => 'localhost',
                            'port'       => 40191,
                            'basedn'     => 'dc=svnwebadmin',
                            'binddn'     => 'cn=manager,dc=svnwebadmin',
                            'bindpw'     => 'secret',
                            'usersdn'    => 'ou=people,dc=svnwebadmin',
                            'registerdn' => 'ou=people,dc=svnwebadmin',
                            'userdefaultvalue'  => array('objectclass' => array('top',
                                                                                'person',
                                                                                'inetOrgPerson')),

                            // parametres generiques
                            'usernamecol'  => 'mail',
                            'mailcol'      => 'mail',
                            'passwordcol'  => 'userPassword',
                            'passwordtype' => 'md5',
                            );

include 'svnwebadmin.index.php';
</code>
  - si vous souhaitez utiliser votre système d'authentification, dé-commenter éventuellement la ligne <code php>//$auth_username = 'utilisateur-authentifie';</code> et remplacez la par une [[auth-ldap|authentification LDAP]] ou par une [[auth-cas|authentification CAS]] ou pas un autre système de votre choix.\\ __Remarque__ : les variables ''$connection_driver'' et ''$connection_options'' ne sont utiles que si vous souhaitez utiliser le système de gestion des identités livré avec SvnWebAdmin. Pour en savoir plus sur les paramètres possibles rapportez à la documentation du module [[http://www.pxxo.net/fr/doc/pxxo_widget_identitymanager|Pxxo_Widget_IdentityManager]] (la section [[http://www.pxxo.net/fr/doc/pxxo_widget_identitymanager#le_parametre_connection_options|le paramètre connection_options]] vous sera particulièrement utile).
  - il reste à configurer votre serveur Apache pour permettre [[authz-repository|un accès contrôlé à vos dépôts SVN par HTTP]]. Cette étape est obligatoire, elle permet de rendre vos dépôts accessibles par des clients subversion tels que "tortoise svn" ou "eclipse" (comme présenté dans [[guidelines|le document d'architecture]]).