  Dolibarr Installation
  Rodolphe Quideville
  $Id: dolibarr-install.sgml,v 1.8 2003/10/24 10:59:15
  rodolphe Exp $

  Installation et mise  jour de Dolibarr
  ______________________________________________________________________

  Table des matires


  1. Installation
     1.1 Rcuprer les sources
     1.2 Pr-requis
        1.2.1 Pear
     1.3 Base de donnes
     1.4 Apache
     1.5 Dolibarr

  2. Mise  jour
     2.1 Mise  jour de la base de donnes
     2.2 Autres actions

  3. Annexe A - Fichiers de conf Apache
     3.1 Fichier de config pour Apache 1.3
     3.2 Fichier de config pour Apache 1.3 + mod_auth_mysql
     3.3 Fichier de config pour Apache 2 + mod_auth_mysql + webmin


  ______________________________________________________________________

  [1m1.  Installation[0m

  [1m1.1.  Rcuprer les sources[0m

  Rcuprer les sources sur  <http://www.dolibarr.com/>

  Les sources se prsentent sous la forme d'un fichier tar compress
  avec gzip.

  [1m1.2.  Pr-requis[0m

  Liste des logiciels  installer pour faire fonctionner Dolibarr :


    php4

    php4-mysql

    php4-curl (pour la partie gestion des adhrents)

    php4-gd (pour les graphiques)

    Apache

     Pour la gestion de l'authentification, Dolibarr fonctionne soit
     avec mod-auth-mysql soit avec Pear. Cette dernire est plus facile
      installer.

    Pear (package Auth)

    libapache-mod-auth-mysql



  [1m1.2.1.  Pear[0m

  Pear est un ensemble de classes et d'outils pour les installer et les
  mettre  jour. Les classes requises pour Dolibarr sont (par ordre
  d'installation) :


    Archive_Tar

    Console_Getopt

    PEAR

    Auth

    DB

  Pour installer un paquet Pear, excutez en root '$ pear install <nom
  du paquet>'.

  Pour plus d'informations sur Pear et sa configuration, veuillez vous
  reporter  son site officiel  <pear.php.net>.

  [1m1.3.  Base de donnes[0m

  1- crer une base de donnes mysql appele 'dolibarr' (vous pouvez
  changer le nom, dans ce cas remplacer dans la suite des commandes
  'dolibarr' par le nom de votre base de donnes)



               # mysqladmin create dolibarr



  2- charger la base en excutant :



               # mysql dolibarr < mysql/mysql.sql



  [1m1.4.  Apache[0m

  Pour configurer Apache : des fichier httpd.conf.dist est fournit avec
  les sources, vous pouvez vous en servir pour configurer votre serveur,
  il est prvu pour que vous ayez juste  ajouter une rgle Include dans
  votre fichier principal httpd.conf.

  Utilisez le fichier httpd.conf.dist pour l'authentification par Pear
  (conseill) et le fichier httpd.conf.dist.modauth pour utiliser mod-
  auth-mysql.

  [1m1.5.  Dolibarr[0m

  Crer un rpertoire appel document dans le rpertoire htdocs des
  sources et affectez les droits d'criture dans ce rpertoire 
  l'utilisateur excutant le serveur web.


  Crer un fichier conf/conf.php et donnez les droits d'criture dans ce
  fichier  l'utilisateur excutant le serveur web.

  Pour configurer Dolibarr accdez  la page


       /install.php



  , pour vous logger utlisez le login [1madmin [22mavec le mot de passe [1madmin[22m.

  Si les contrles sont corrects vous n'avez qu' cliquer sur le lien,
  'Configurer les modules'.

  Une fois les modules configurs il ne reste plus qu' dfinir les
  utilisateurs et leurs permissions respectives. Pour cela cliquer sur
  Accueil -> Utilisateurs

  Il est fortement conseill de supprimer le fichier install.php une
  fois l'installation termine. De mme pensez  modifier le mot de
  passe de l'utilisateur admin.

  [1m2.  Mise  jour[0m

  Certaines action sont ncessaires lors de la mise  jour de Dolibarr
  vers une version plus rcente des sources.

  [1m2.1.  Mise  jour de la base de donnes[0m

  Il peut tre ncessaire de faire des modifications sur la structure
  et/ou les donnes contenues dans la base Mysql lors de la mise  jour
  de Dolibarr. Pour cela des scripts sont fournis dans le rpertoire
  mysql/migration/. Il se prsente sous la forme a.b.c-e.d.f.sql, les
  trois premiers numros indique la version de dpart 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.

  [1m2.2.  Autres actions[0m

  Il peut-tre ncessaire d'effectuer d'autres actions lors de la mise 
  jour, comme la dsactivation et la ractivation des modules. Cette
  information est communique dans le fichier README  la racine des
  sources.

  [1m3.  Annexe A - Fichiers de conf Apache[0m

  [1m3.1.  Fichier de config pour Apache 1.3[0m

  Exemple pour l'authentification avec Pear



  ______________________________________________________________________
          #
          # Sample httpd.conf for dolibarr
          #
          <VirtualHost dolibarr.lafrere.lan>
          ServerAdmin webmaster.fr@lolix.org
          DocumentRoot /home/www/dolibarr/dolibarr/htdocs
          ServerName dolibarr.lafrere.lan
          ErrorLog  /home/www/dolibarr/logs/error.log
          CustomLog /home/www/dolibarr/logs/access.log combined

          ErrorDocument 401 /public/error-401.html

          php_flag register_globals on

          </VirtualHost>

  ______________________________________________________________________



  [1m3.2.  Fichier de config pour Apache 1.3 + mod_auth_mysql[0m

  Cet exemple ne fonctionne pas sur la srie Apache 2, voir le fichier
  correspond dans la section suivante.



  ______________________________________________________________________
          #
          # Sample httpd.conf for dolibarr
          #
          <VirtualHost dolibarr.lafrere.lan>
          ServerAdmin webmaster.fr@lolix.org
          DocumentRoot /home/www/dolibarr/dolibarr/htdocs
          ServerName dolibarr.lafrere.lan
          ErrorLog  /home/www/dolibarr/logs/error.log
          CustomLog /home/www/dolibarr/logs/access.log combined

          ErrorDocument 401 /public/error-401.html

          php_flag register_globals on

          <Location />
          Options Indexes FollowSymLinks
          AllowOverride All
          Order deny,allow
          Deny from all

          AuthType                                Basic

          # N'utilisez la ligne suivante que si vous utilisez aussi
          # le module d'authentification bas sur postgresql
          #Auth_MySQL_Authoritative               on

          # Utilisez les lignes suivantes si le serveur Apache ne
          # peut se logger en anonymous (ce qui est conseill ;-)
          # rq. erics: sur ma debian je n'ai pas le droit de mettre ces
          # instructions dans un <virtualhost> ... (apache 1.3.27.0-2)
          #AuthMySQL_DefaultHost <host>
          #AuthMySQL_DefaultUser <user>
          #AuthMySQL_DefaultPassword <pass>

          Auth_MySQL_DB                   dolibarr
          Auth_MySQL_Password_Table               llx_user
          Auth_MySQL_Username_Field               login
          Auth_MySQL_Password_Field               pass

          # Pour l'instant les pass sont enregistrs en clair
          # le stockage crypt est dans la TODO

          Auth_MySQL_Encrypted_Passwords  off

          AuthName                                "Dolibarr"

          require valid-user
          satisfy any
          </Location>

          <Location /public/>
          Options Indexes FollowSymLinks
          AllowOverride All
          Order deny,allow
          Allow from all
          </Location>

          </VirtualHost>

  ______________________________________________________________________



  [1m3.3.  Fichier de config pour Apache 2 + mod_auth_mysql + webmin[0m



  ______________________________________________________________________
        Options Indexes FollowSymLinks
        AllowOverride All
        Order deny,allow
        Deny from all

        AuthType Basic

        # N'utilisez la ligne suivante que si vous utilisez aussi
        # le module d'authentification bas sur postgresql
        AuthMySQLAuthoritative on

        # Utilisez les lignes suivantes si le serveur Apache ne
        # peut se logger en anonymous (ce qui est conseill ;-)
        # rq. erics: sur ma debian je n'ai pas le droit de mettre ces
        # instructions dans un <virtualhost> ... (apache 1.3.27.0-2)
        #AuthMySQL_DefaultHost <host>
        #AuthMySQL_DefaultUser <user>
        #AuthMySQL_DefaultPassword <pass>

        AuthMySQLHost localhost
        AuthMySQLUser leDBuser
        AuthMySQLPassword leDBpass
        AuthMySQLDB dolibarr
        AuthMySQLUserTable llx_user
        AuthMySQLNameField login
        AuthMySQLPasswordField pass

        # Pour l'instant les pass sont enregistrs en clair
        # le stockage crypt est dans la TODO
        AuthMySQLCryptedPasswords off

        AuthName "Dolibarr"

        require valid-user
        Satisfy any

  ______________________________________________________________________



  Pour les gens qui installent Dolibarr dans un rpertoire, utilisez
  Webmin et ajoutez une "Per-Directory Options"  votre serveur virtuel.
  Utilisez "Location" comme "Type" et "/dolibarr" comme "Path". Une fois
  cre, editez les directives et copiez la config ci-dessus, sauvez,
  restartez Apache et testez en allant  domainname.com/dolibarr. Le
  navigateur va vous demander de taper le login/pass.

  Il faut crer des options pour chaque <Location> du fichier httpd.conf
  donn en exemple.

  Merci  la personne qui m'a transmis ces infos, et aux prcdentes qui
  avaient fait de mme au sujet d'Apache 2



