Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.

Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement… :-)

Ceci est une ancienne révision du document !


Installation de Dolibarr sur votre poste ou sur un serveur dédié

Avec Dolibarr (package standard .zip ou sources Git)

Pré-requis

  1. Apache
  2. PHP 5.6.0+ (avec DateTimeZone.getOffset, php-intl)
  3. un serveur de base de données (MySQL 5.1+ ou PostgreSQL)
    1. utilisateur root ou admin principal pour le serveur de base de donnée connu et fonctionnel
  4. login/mot de passe d'accès (à une nouvelle base ou au serveur) connus

Première étape

Sécurisez la base de données.

  1. MySql ou MariaDB sous Linux : si vous venez juste d'installer la base de donnée, le login administrateur est root.
    1. Pour initialiser le mot de passe, lancez mysql pour modifier le mot de passe de root :

      ...@...:~ $ mysql -u root -p
      Enter password: 
      ...
      MariaDB [(none)]> grant all privileges on *.* to root@'localhost' identified by 'newrootpass' with grant option; MariaDB [(none)]> \q
      Bye

      (Donnez le mot de passe, \q pour quitter)

    2. Pour vérifier :

      ...@...:~ $ mysql -u root -p
      Enter password: 
      ...
      MariaDB [(none)]> \q
      Bye

      Tapez votre nouveau mot de passe et \q pour quitter la session.

  2. Postgresql :
    1. si vous venez juste d'installer la base de donnée PostgreSQL, vous devez d'abord créer un utilisateur administrateur et son mot de passe :
      1. Ajoutez la ligne suivante dans le fichier /etc/postgresql/x.x/main/pg_hba.conf (remplacer x.x avec votre version de postgres) :
        /etc/postgresql/x.x/main/pg_hba.conf
        local   all         dolibarrowner    md5
      2. Mettez en commentaire la ligne
        /etc/postgresql/x.x/main/pg_hba.conf
        #local   all         all                               ident

        qui impose que le compte système utilisé pour accéder à la base (sous lequel tourne l'application web), ait le même nom que le compte dans la base (ce n'est jamais le cas).

    2. Puis lancez la commande :

      ...@...:~ $ sudo -s -u postgres
      createuser dolibarrowner
      psql -d template1 -c "alter user dolibarrowner with password 'dolibarrownerpass'"
      exit
      psql
      create database databasename;
      grant all privileges on database databasename to dolibarrowner;
      ALTER DATABASE databasename OWNER TO dolibarrowner;
      \q
      sudo /etc/init.d/postgresql restart

    3. Testez la connexion pour l'utilisateur créé :

      ...@...:~ $ psql -h localhost -d postgres -U dolibarrowner -W

      et entrez le mot de passe dolibarrownerpass et \q pour quitter la session si la connexion est ok.

Autres étapes

  1. Connectez-vous à votre serveur via SSH :

    ...@...:~ $ ssh user@monsite.fr

  2. Placez-vous dans le répertoire racine de votre serveur web :

    ...@...:~ $ cd /var/www/html

  3. Récupérez et décompressez l'archive de Dolibarr :

    ...@...:~ $ wget 'https://sourceforge.net/projects/dolibarr/files/Dolibarr ERP-CRM/12.0.4/dolibarr-12.0.4.zip'
    ...@...:~ $ unzip dolibarr.zip

  4. Renommez le répertoire dolibarr-x.y.z pour obtenir un nom de répertoire indépendant de la version (par exemple, en dolibarr) :

    ...@...:~ $ mv dolibarr-x.y.z dolibarr

    (où x.y.z correspond à la version source)

  5. Gestion des droits :

    ...@...:~ $ sudo chmod -R 2755 /var/www/html/dolibarr/
    ...@...:~ $ sudo chown -R www-data:www-data /var/www/html/dolibarr/

  6. Fichier de configuration : créez, dans le répertoire dolibarr/htdocs/conf, un fichier de configuration vide et attribuez-lui comme propriétaire l'utilisateur du serveur web :

    ...@...:~ $ sudo touch /var/www/html/dolibarr/htdocs/conf/conf.php
    ...@...:~ $ sudo chown www-data:www-data /var/www/html/dolibarr/htdocs/conf/conf.php

  7. Créez le répertoire /var/www/html/dolibarr/documents, en dehors du répertoire htdocs, pour les documents de Dolibarr (factures pdf, images, …), attribuez-lui le propriétaire www-data et réglez ses permissions :

    ...@...:~ $ sudo mkdir -p /var/www/html/dolibarr/documents
    ...@...:~ $ sudo chown www-data:www-data /var/www/html/dolibarr/documents/
    ...@...:~ $ sudo chmod -R 2755 /var/www/html/dolibarr/documents/

  8. Installation :
    1. Suivez les instructions de l'installation
    2. Créez un fichier install.lock dans le répertoire dédiés aux documents pour verrouiller la procédure d'installation qui ne pourra plus être appelée par erreur (Il faudra le supprimer pour les mises à jour) :

      ...@...:~ $ sudo touch /var/www/html/dolibarr/documents/install.lock
      ...@...:~ $ sudo chmod go-w /var/www/html/dolibarr/documents

Conclusion

Problèmes connus

Voir aussi