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

  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. Copie des fichiers
    1. Placez-vous dans le répertoire où installer Dolibarr (le répertoire racine défini pour votre serveur web) :

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

    2. Récupérez l'application
      1. Avec l'archive :

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

        Renommez le répertoire dolibarr-x.y.z en dolibarr afin d'avoir un nom de répertoire indépendant de la version (où x.y.z correspond à la version source)

      2. Avec les sources Git : Si vous partez des sources Git, récupérer les sources par

        ...@...:~ $ git clone -b X.Y http://github.com/Dolibarr/dolibarr.git dolibarr

        X.Y est la version à installer(Par exemple 9.0, 11.0, …). Il est possible de remplacer X.Y par develop pour récupérer la version en cours de développement.

  3. Gestion des droits :

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

  4. 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 :

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

  5. Répertoire de documents : créez le répertoire qui servira aux documents générés ou stockés par Dolibarr et attribuez lui comme propriétaire, l'utilisateur du serveur web. Il faut choisir un répertoire en dehors de la racine du site web. Par exemple /var/www/html/dolibarr/documents :

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

  6. 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