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 !


Mettre à jour Dolibarr vers une nouvelle version

Comment faire une migration de Dolibarr vers une version plus récente sans perdre ses données, ses documents ?

Comment revenir en arrière si quelque chose s’est mal passé ?

Dolibarr contient le système de mise à jour vers une version plus récente ainsi qu’une documentation. Une fois les sources de la nouvelle version installés, la base de données est mise à jour. Simple, automatique…

Mais cela peut mal se passer. Mieux vaut donc prendre des précautions.

Nous supposons qu’on a une version X de Dolibarr installée en production sur un serveur web classique.

Dolibarr est composé d’une base de données et de 3 répertoires habituellement regroupés sous un répertoire dolibarr (dans mon exemple) :

  1. htdocs : les sources des pages de gestion
  2. documents : tous les documents générés par Dolibarr (pdf, images ….)
  3. scripts : les tâches planifiées.

L’url de Dolibarr (dolibarr.domaine.com) pointe normalement sur le répertoire htdocs, Les répertoires documents et scripts ne doivent pas être visibles depuis un navigateur ( faille de sécurité)

Pré-requis

Première étape

Deux cas

Via SSH

  1. Allez dans le répertoire racine de votre serveur web (ex. /var/www/html) :

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

  2. Récupérez l'archive de la nouvelle version (ex: 13.0.0) :

    ...@...:/var/www/html $ wget 'https://sourceforge.net/projects/dolibarr/files/Dolibarr ERP-CRM/13.0.0/dolibarr-13.0.0.zip'

  3. Décompressez l'archive :

    ...@...:/var/www/html $ unzip dolibarr-13.0.0.zip

  4. Recopiez les nouveaux fichiers (qui ont été décompressés dans le répertoire dolibarr-x.y.z) vers le répertoire de votre ancienne version de Dolibarr (ex: dolibarr) :

    ...@...:/var/www/html $ cp -r dolibarr-13.0.0/* dolibarr/

    Ceci remplace 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).

  5. Supprimez le répertoire des fichiers sources :$

    ...@...:/var/www/html $ rm -fr dolibarr-x.y.z

Par FTP

  1. Cliquez sur le bouton Accueil (en haut)
  2. Cliquez sur Outils d'administration → Mise à jour / extension
  3. La page affiche :
    1. Version actuelle de Dolibarr : (par ex. 5.0.3)
    2. Dernière version stable disponible : (par ex. 13.0.0)
  4. Suivez la procédure proposée :
    1. Téléchargez le package (par exemple depuis le site web officiel https://www.dolibarr.org/downloads/)
    2. Décompressez les fichiers de l'archive dans le répertoire du serveur Dolibarr indiqué (par ex. /var/www/html/dolibarr/)
    3. Effacer le fichier /var/www/html/dolibarr/documents/install.lock s'il existe afin d'autoriser l'outil de mise à jour.

Autres étapes

  1. Lancez Dolibarr dans votre navigateur habituel
  2. L'assistant de migration s'ouvre et détecte que vous avez une base en version ancienne
  3. Choisissez le menu proposé pour migrer à la version supérieure. Si vous avez fait un saut de plusieurs versions, garder le choix proposé de migrer d'une seule version, à la fin le menu vous sera reproposé pour migrer à la suivante et ainsi de suite jusqu'à atteindre la version qui a été installée (par ex. si vous avez installé Dolibarr 3.5 par dessus votre version courante qui était Dolibarr 3.2, choisissez le menu de migration pour passer de 3.2 à 3.3, puis 3.3 à 3.4 puis 3.4 à 3.5)
  4. Recréez un fichier /var/www/html/dolibarr/documents/install.lock via FTP
  5. Changez ses droits pour ne lui donner que les droits de lecture (pour interdire à nouveau les mises à jour)

Conclusion

Problèmes connus

Voir aussi