[Sommaire] [Imprimer]

   1    Dolibarr Installation
   2    Rodolphe Quiédeville
   3    $Id: dolibarr-install.sgml,v 1.11 2004/02/12 09:54:20 erics
   4    Exp $
   5  
   6    Installation et mise à jour de Dolibarr
   7    ______________________________________________________________________
   8  
   9    Table des matières
  10  
  11  
  12    1. Installation
  13       1.1 Récupérer les sources
  14       1.2 Pré-requis
  15          1.2.1 Pear
  16       1.3 Base de données
  17       1.4 Apache
  18       1.5 Dolibarr
  19  
  20    2. Mise à jour
  21       2.1 Mise à jour de la base de données
  22       2.2 Autres actions
  23  
  24    3. Annexe A - Fichiers de conf Apache
  25       3.1 Fichier de config pour Apache 1.3
  26       3.2 Fichier de config pour Apache 1.3 + mod_auth_mysql
  27       3.3 Fichier de config pour Apache 2 + mod_auth_mysql + webmin
  28  
  29  
  30    ______________________________________________________________________
  31  
  32    1.  Installation
  33  
  34    1.1.  Récupérer les sources
  35  
  36    Récupérer les sources sur  <http://www.dolibarr.com/>
  37  
  38    Les sources se présentent sous la forme d'un fichier tar compressé
  39    avec gzip.
  40  
  41    1.2.  Pré-requis
  42  
  43    Liste des logiciels à installer pour faire fonctionner Dolibarr :
  44  
  45  
  46    ·  php4
  47  
  48    ·  php4-mysql
  49  
  50    ·  php4-curl (pour la partie gestion des adhérents)
  51  
  52    ·  php4-gd (pour les graphiques)
  53  
  54    ·  php4-cli (pour les scripts en mode console)
  55  
  56    ·  Apache
  57  
  58       Pour la gestion de l'authentification, Dolibarr fonctionne soit
  59       avec mod-auth-mysql soit avec Pear. Cette dernière est plus facile
  60       à installer.
  61  
  62    ·  libapache-mod-auth-mysql
  63  
  64  
  65  
  66    1.2.1.  Pear
  67  
  68    Pear n'est plus nécessaire à partir de Dolibarr 2.0.0 les librairies
  69    Pear utilisées ont été incluses dans les sources directement.
  70  
  71    1.3.  Base de données
  72  
  73    1- créer une base de données mysql appelée 'dolibarr' (vous pouvez
  74    changer le nom, dans ce cas remplacer dans la suite des commandes
  75    'dolibarr' par le nom de votre base de données)
  76  
  77  
  78  
  79                 # mysqladmin create dolibarr
  80  
  81  
  82  
  83    2- charger la base en exécutant :
  84  
  85    Cette étape n'est plus nécessaire à partir de la version 2.0.0 de
  86    Dolibarr le chargement de la base est effectué lors de l'installation.
  87  
  88  
  89                 # mysql dolibarr < mysql/mysql.sql
  90  
  91  
  92  
  93    1.4.  Apache
  94  
  95    Pour configurer Apache : des fichier httpd.conf.dist est fournit avec
  96    les sources, vous pouvez vous en servir pour configurer votre serveur,
  97    il est prévu pour que vous ayez juste à ajouter une régle Include dans
  98    votre fichier principal httpd.conf.
  99  
 100    Utilisez le fichier httpd.conf.dist pour l'authentification par Pear
 101    (conseillé) et le fichier httpd.conf.dist.modauth pour utiliser mod-
 102    auth-mysql.
 103  
 104    1.5.  Dolibarr
 105  
 106    Créer un répertoire appelé document dans le répertoire htdocs des
 107    sources et affectez les droits d'écriture dans ce répertoire à
 108    l'utilisateur exécutant le serveur web.
 109  
 110    Créer un fichier conf/conf.php et donnez les droits d'écriture dans ce
 111    fichier à l'utilisateur exécutant le serveur web.
 112  
 113    Pour configurer Dolibarr accédez à la page
 114  
 115  
 116         /install/index.php
 117  
 118  
 119  
 120    , pour vous logger utlisez le login admin avec le mot de passe admin.
 121  
 122    Si les contrôles sont corrects vous n'avez qu'à cliquer sur le lien,
 123    'Configurer les modules'.
 124  
 125    Une fois les modules configurés il ne reste plus qu'à définir les
 126    utilisateurs et leurs permissions respectives. Pour cela cliquer sur
 127    Accueil -> Utilisateurs
 128  
 129    Il est fortement conseillé de supprimer le fichier install.php une
 130    fois l'installation terminée. De même pensez à modifier le mot de
 131    passe de l'utilisateur admin.
 132  
 133    2.  Mise à jour
 134  
 135    Certaines action sont nécessaires lors de la mise à jour de Dolibarr
 136    vers une version plus récente des sources.
 137  
 138    2.1.  Mise à jour de la base de données
 139  
 140    Il peut être nécessaire de faire des modifications sur la structure
 141    et/ou les données contenues dans la base Mysql lors de la mise à jour
 142    de Dolibarr. Pour cela des scripts sont fournis dans le répertoire
 143    mysql/migration/. Il se présente sous la forme a.b.c-e.d.f.sql, les
 144    trois premiers numéros indique la version de départ et les 3 suivants
 145    la version que vous souhaitez atteindre. Si vous passez par exemple de
 146    la version 0.1.3 à la version 0.1.6 il vous faudra appliquer les
 147    patchs 0.1.3-0.1.4.sql, 0.1.4-0.1.5.sql et 0.1.5-0.1.6.sql si un patch
 148    n'éxiste pas d'une version à une autre c'est qu'il n'y a pas eu de
 149    modification de base.
 150  
 151    2.2.  Autres actions
 152  
 153    Il peut-être nécessaire d'effectuer d'autres actions lors de la mise à
 154    jour, comme la désactivation et la réactivation des modules. Cette
 155    information est communiquée dans le fichier README à la racine des
 156    sources.
 157  
 158    3.  Annexe A - Fichiers de conf Apache
 159  
 160    3.1.  Fichier de config pour Apache 1.3
 161  
 162    Exemple pour l'authentification avec Pear
 163  
 164  
 165    ______________________________________________________________________
 166            #
 167            # Sample httpd.conf for dolibarr
 168            #
 169            <VirtualHost dolibarr.lafrere.lan>
 170            ServerAdmin webmaster.fr@lolix.org
 171            DocumentRoot /home/www/dolibarr/dolibarr/htdocs
 172            ServerName dolibarr.lafrere.lan
 173            ErrorLog  /home/www/dolibarr/logs/error.log
 174            CustomLog /home/www/dolibarr/logs/access.log combined
 175  
 176            ErrorDocument 401 /public/error-401.html
 177  
 178            php_flag register_globals on
 179  
 180            </VirtualHost>
 181  
 182    ______________________________________________________________________
 183  
 184  
 185  
 186    3.2.  Fichier de config pour Apache 1.3 + mod_auth_mysql
 187  
 188    Cet exemple ne fonctionne pas sur la série Apache 2, voir le fichier
 189    correspond dans la section suivante.
 190  
 191  
 192  
 193    ______________________________________________________________________
 194            #
 195            # Sample httpd.conf for dolibarr
 196            #
 197            <VirtualHost dolibarr.lafrere.lan>
 198            ServerAdmin webmaster.fr@lolix.org
 199            DocumentRoot /home/www/dolibarr/dolibarr/htdocs
 200            ServerName dolibarr.lafrere.lan
 201            ErrorLog  /home/www/dolibarr/logs/error.log
 202            CustomLog /home/www/dolibarr/logs/access.log combined
 203  
 204            ErrorDocument 401 /public/error-401.html
 205  
 206            php_flag register_globals on
 207  
 208            <Location />
 209            Options Indexes FollowSymLinks
 210            AllowOverride All
 211            Order deny,allow
 212            Deny from all
 213  
 214            AuthType                                Basic
 215  
 216            # N'utilisez la ligne suivante que si vous utilisez aussi
 217            # le module d'authentification basé sur postgresql
 218            #Auth_MySQL_Authoritative               on
 219  
 220            # Utilisez les lignes suivantes si le serveur Apache ne
 221            # peut se logger en anonymous (ce qui est conseillé ;-)
 222            # rq. erics: sur ma debian je n'ai pas le droit de mettre ces
 223            # instructions dans un <virtualhost> ... (apache 1.3.27.0-2)
 224            #AuthMySQL_DefaultHost <host>
 225            #AuthMySQL_DefaultUser <user>
 226            #AuthMySQL_DefaultPassword <pass>
 227  
 228            Auth_MySQL_DB                   dolibarr
 229            Auth_MySQL_Password_Table               llx_user
 230            Auth_MySQL_Username_Field               login
 231            Auth_MySQL_Password_Field               pass
 232  
 233            # Pour l'instant les pass sont enregistrés en clair
 234            # le stockage crypté est dans la TODO
 235  
 236            Auth_MySQL_Encrypted_Passwords  off
 237  
 238            AuthName                                "Dolibarr"
 239  
 240            require valid-user
 241            satisfy any
 242            </Location>
 243  
 244            <Location /public/>
 245            Options Indexes FollowSymLinks
 246            AllowOverride All
 247            Order deny,allow
 248            Allow from all
 249            </Location>
 250  
 251            </VirtualHost>
 252  
 253    ______________________________________________________________________
 254  
 255  
 256  
 257    3.3.  Fichier de config pour Apache 2 + mod_auth_mysql + webmin
 258  
 259  
 260  
 261    ______________________________________________________________________
 262          Options Indexes FollowSymLinks
 263          AllowOverride All
 264          Order deny,allow
 265          Deny from all
 266  
 267          AuthType Basic
 268  
 269          # N'utilisez la ligne suivante que si vous utilisez aussi
 270          # le module d'authentification basé sur postgresql
 271          AuthMySQLAuthoritative on
 272  
 273          # Utilisez les lignes suivantes si le serveur Apache ne
 274          # peut se logger en anonymous (ce qui est conseillé ;-)
 275          # rq. erics: sur ma debian je n'ai pas le droit de mettre ces
 276          # instructions dans un <virtualhost> ... (apache 1.3.27.0-2)
 277          #AuthMySQL_DefaultHost <host>
 278          #AuthMySQL_DefaultUser <user>
 279          #AuthMySQL_DefaultPassword <pass>
 280  
 281          AuthMySQLHost localhost
 282          AuthMySQLUser leDBuser
 283          AuthMySQLPassword leDBpass
 284          AuthMySQLDB dolibarr
 285          AuthMySQLUserTable llx_user
 286          AuthMySQLNameField login
 287          AuthMySQLPasswordField pass
 288  
 289          # Pour l'instant les pass sont enregistrés en clair
 290          # le stockage crypté est dans la TODO
 291          AuthMySQLCryptedPasswords off
 292  
 293          AuthName "Dolibarr"
 294  
 295          require valid-user
 296          Satisfy any
 297  
 298    ______________________________________________________________________
 299  
 300  
 301  
 302    Pour les gens qui installent Dolibarr dans un répertoire, utilisez
 303    Webmin et ajoutez une "Per-Directory Options" à votre serveur virtuel.
 304    Utilisez "Location" comme "Type" et "/dolibarr" comme "Path". Une fois
 305    créée, editez les directives et copiez la config ci-dessus, sauvez,
 306    restartez Apache et testez en allant à domainname.com/dolibarr. Le
 307    navigateur va vous demander de taper le login/pass.
 308  
 309    Il faut créer des options pour chaque <Location> du fichier httpd.conf
 310    donné en exemple.
 311  
 312    Merci à la personne qui m'a transmis ces infos, et aux précédentes qui
 313    avaient fait de même au sujet d'Apache 2
 314  
 315  
 316