Installation - Mise à jour

Retour index
Documentation Utilisateur

Les procédures suivantes décrivent comment installer ou mettre à jour Dolibarr.

Procédure d'installation

Ce chapitre décrit les différentes méthodes possibles (des plus simples, aux manuels) pour une première installation. Voir plus loin pour la mises à jour.

Sur un poste/serveur dédié

Avec DoliWamp (package Windows .exe)

- Prérequis: Windows

- Niveau: Débutant

Si vous maitrisez l'installation d'un serveur Web Apache, de PHP et Mysql, le chapitre suivant est plus approprié. Pour les moins expérimentés qui sont sous Windows, il existe une distribution Dolibarr nommée DoliWamp qui permet de faire une installation Dolibarr sous Windows avec tous ses prérequis (Apache, Mysql, PHP) sans connaissance informatiques. Voici comment l'installer:

• Récupérez la version de Dolibarr pour Windows.

Pour cela, voir la page de téléchargement de DoliWamp chez NLTechno.

• Lancer le .exe téléchargé et suivez les instructions.

Avec DoliBuntu (package Ubuntu .deb)

- Prerequisite: Linux Ubuntu

- Level: Débutant

Cette procédure fonctionne uniquement pour les utilisateurs Linux Ubuntu ou Debian et est recommandé pour ceux qui n'ont pas de connaissances informatiques particulières. Si vous êtes un administrateur expérimenté d'Apache, PHP et Mysql, le chapitre suivant sera peut-être plus approprié. Dans le cas contraire, vous pouvez utilisez DoliBuntu. DoliBuntu est un package de Dolibarr spécialisé pour la distribution Ubuntu. Ce package vous permet d'installer Dolibarr sous Ubuntu ou Debian avec tous ces prérequis (Apache, Mysql, PHP) et ce sans connaissances techniques particulières.

• La procédure pour installer DoliBuntu est décrite sur la page Dolibarr pour Ubuntu.

Avec Dolibarr (package standard .tgz)

- Prérequis: Apache, PHP et un serveur de base de données (MySQL ou PostgreSQL) sont présents et opérationnels.

- Niveau: Un peu de connaissances informatiques en administration Web.

Cette procédure décrit l'installation manuelle (recommandée) sur un système GNU/Linux (Debian, Mandriva, ...) mais elle est valable avec d'autres systèmes comme Windows moyennant une adaptation des chemins à ceux de votre OS. Elle est applicable pour toute version de Dolibarr >= 2.0.0

• Vérifiez que vous avez bien Apache, PHP et un serveur de base données (MySQL ou PostgreSQL) d'installés (consulter pour cela la liste des packages installés sur votre machine grâce au gestionnaire de mise à jour de package de votre distribution).

Note: L'installeur peut créer en option la base de donnée si elle n'existe pas encore, mais dans ce cas, vous devez connaitre le login administrateur de votre base de donnée et son mot de passe.

Pour les utilisateurs Linux, si vous venez juste d'installer la base de donnée MySQL, le login administrateur est root. Vous devez exécuter la commande suivante pour initialiser le mot de passe:

mysql

Une fois dans l'interface Mysql, taper la commande de modification du mote de passe de root:

grant all privileges on *.* to root@'localhost' identified by 'newrootpass' with grant option;

Puis entrée et pour quitter \q

Pour vérifier que l'accès avec ce couple user/mot de passe fonctionne, lancer la commande

mysql -u root -p

Et taper votre mot de passe newrootpass suivi de \q pour quitter la sessions si la connexion a réussie.

Pour les utilisateurs Linux, si vous venez juste d'installer la base de donnée PostgresSQL, vous devez exécuter d'abord créer un utilisateur administrateur et son mot de passe. Pour cela, ajouter la ligne suivante dans le fichier /etc/postgresql/x.x/main/pg_hba.conf (remplacer x.x avec votre version de postgres)

local   all         dolibarrowner    md5

Ensuite, lancer la commande sous un shell root

sudo -s -u postgres
createuser dolibarrowner
psql -d template1 -c "alter user dolibarrowner with password dolibarrownerpass"
exit
sudo /etc/init.d/postgresql-x.x restart

Vous pouvez tester la connexion pour l'utilisateur crée avec la commande

psql -d postgres -U dolibarrowner -W

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

• Placez-vous dans le répertoire dans lequel installer Dolibarr (le répertoire racine défini pour votre serveur web)

1. Pour Debian et les familles Ubuntu, il s'agit en général de: /var/www
2. Pour Mandriva: /var/www/html
3. Pour RedHat: à compléter
4. Pour Suse: à compléter

$ cd /var/www

• Récupérez l'archive de l'application

$ wget http://www.dolibarr.org/files/dolibarr.tgz

• Décompressez l'archive

$ tar xvfz dolibarr.tgz

• 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)

$ mv dolibarr-x.y.z dolibarr

• En tant que root, forcez les permissions pour etre sur que tous les fichiers soient en lecture seule pour les groupes et autres

$ chmod -R 755 /var/www/dolibarr

• En tant que root, créez, dans le répertoire dolibarr/htdocs/conf, un fichier de configuration vide, et attribuez-lui comme propriétaire du fichier, l'utilisateur du serveur web (exemple www-data sur debian, nobody sur une vieille RedHat, apache sur une autre version ...). Ceci est requis car le serveur web a besoin d'écrire dans ce fichier lors de l'installation.

$ cd dolibarr ; touch htdocs/conf/conf.php ; chown www-data htdocs/conf/conf.php

• Toujours en root, créez le répertoire qui servira aux documents générés ou stockés par Dolibarr (factures pdf, images, ...), et attribuez lui comme propriétaire, l'utilisateur du serveur web (exemple www-data sur Debian, nobody sur une vieille RedHat, Apache sur une Mandriva ou une RedHat récente, ...). Le serveur web doit avoir les droits en écriture dans ce répertoire.

$ mkdir documents ; chown www-data documents

• Pointez votre navigateur sur la page principale

http://127.0.0.1/dolibarr/htdocs/

• Suivez les instructions de l'installation

• Pour des raisons de sécurité nous vous conseillons, une fois l'installation terminée, de créer un fichier install.lock dans le répertoire d'installation, que seul root doit avoir le droit d'effacer. Ceci va vérouiller la procédure d'installation qui ne pourra plus être appelée par erreur (Il faudra le supprimer pour les mises à jour).

$ touch /var/www/dolibarr/install.lock; chmod go-w /var/www/dolibarr;

Sur un hébergement mutualisé

Il n'est pas possible de présenter une solution générique à ce cas car la procédures dépend de l'hébergeur. La plupart du temps, la procédure d'installation par la package standard .tgz sur un poste/serveur dédié (voir chapitre prcédent) peut convenir.

Voici toutefois quelques documents/procédures spécifiques à certains hébergeurs:

• Hébergement FREE mutualisé: File:Installation Dolibarr Free-20100526.odt
• Hébergement OVH oneclick: OVH propose une vieille version de Dolibarr installable depuis son interface d'administration dans sa solution "OneClick".

Procédure de mise à jour

Avec DoliWamp (package Windows .exe)

Si vous aviez installé la version de Dolibarr spécifique nommé DoliWamp (qui embarque le serveur Web, PHP et Mysql), la procédure à suivre est celle-ci. Dans tout autre cas, utilisez la procédure du chapitre suivant.

• Télécharger la nouvelle version de DoliWamp.

• Lancer le .exe et laissez vous guider dans toutes les étapes sans rien changer aux valeurs proposées par défaut.

Avec DoliBuntu (package Ubuntu .deb)

Si vous aviez installé Dolibarr via un packagage Ubuntu, sa mise a jour se fait simplement de la même manière qu'une première installation. Il suffit d'installer le nouveau package .deb. Par exemple en suivant la procédure Dolibarr pour Ubuntu.

Avec Dolibarr (package standard .tgz)

Cette procédure décrit la mise à jour de Dolibarr (depuis une ancienne version) vers une plus récente. Elle est applicable dès lors que la mise à jour se fait pour une version de Dolibarr >= 2.0.0

• Placez-vous dans le répertoire dans lequel a été installé Dolibarr (le répertoire racine de votre serveur web, par exemple /var/www sous Debian)

$ cd /var/www

• Récupérez l'archive de la nouvelle version

$ wget http://www.nltechno.com/files/dolibarr.tgz

• Décompressez l'archive

$ tar xvfz dolibarr.tgz

• Recopiez les nouveaux fichiers (qui ont été décompressés dans le répertoire dolibarr-x.y.z) vers le répertoire où vous avez votre ancienne version de Dolibarr. Ceci a pour effet de remplacer les anciens fichiers par les nouveaux tout en conservant les fichiers qui vous sont spécifiques (comme le fichier conf.php ou encore vos modules complémentaires non officiels installés).

$ cp -r dolibarr-x.y.z/* dolibarr

• Vous pouvez alors supprimer le répertoire des fichiers sources

$ rm -fr dolibarr-x.y.z

• Pointez votre navigateur sur la page d'install

http://127.0.0.1/dolibarr/install/

Si vous avez un message signalant que le processus de mise à jour est vérrouillé par un fichier install.lock, supprimer ce fichier (il est stocké dans le répertoire racine de Dolibarr) puis rafraichissez la page.

• Choisissez Mise à jour dans le menu proposé

• Pour des raisons de sécurité nous vous conseillons, une fois la mise à jour terminée, de verrouiller le répertoire d'installation. Dans le cas contraire, Dolibarr vous avertira d'un message dans l'interface une fois loggé

$ echo > dolibarr/install.lock
$ chmod 444 dolibarr/install.lock

Configurer une connexion LDAP

A compléter.

Importer des données externes

Pour cette opération, consulter la page Imports_de_masse.

Configuration - Paramétrage

Voir la page Configuration/Paramétrage.