[Sommaire] [Imprimer]

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