Mettre à jour Dolibarr !

L’ERP et CRM Dolibarr est un système de gestion des entreprises et les organismes privé ou étatique, c’est l’un des solutions open source les plus puissants sur le marché avec plusieurs modules disponible gratuitement à leurs utilisateurs, et comme tout les ERP, Dolibarr dispose d’un système robuste qui permet à leurs utilisateurs de mettre à jour leurs Dolibarr une fois les sources de la nouvelle version sont déployés en ligne, dans ce cas là vous avez deux méthode pour effectuer la mise à jour de Dolibarr: Simple ou automatique…

Attention ! ce type de mise à jour sur les systèmes de gestion des entreprises non pas toujours considérer comme simple ou facile à réaliser, il faudrait des experts (informaticiens, développeurs ou sociétés spécialisés) dans l’ERP de Dolibarr afin de prendre des précautions pour éviter toute perte des données ou blocage sur votre outil Dolibarr qui est utilisé dans votre entreprise.

Je vous présente un petit exemple sur la difficulté de la mise à jour de Dolibarr, supposant qu’on a Dolibarr installé sur une version Y en production et déployé sur un serveur web classique, si vous utilisez xamp,  Wamp ou Mamp, ou une autre installation Debian, ce sera un peu différent sur les trois serveurs, car les sources ne sont pas installés aux mêmes emplacements.

Procédure d'installation de Dolibarr:

Avant d’installer l’ERP Dolibarr, il vaut mieux connaître l’architecture de Dolibarr qui est composé d’une base de données et de 3 répertoires qui sont à leurs tours regroupés sous un répertoire dolibarr (ci-dessous un exemple d’illustration) :

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

Le lien de l’url de Dolibarr (dolibarr.votre-site.com) pointe normalement sur le répertoire htdocs et ce dernier qui contient le système de Gestion de l’ERP Dolibarr, Les autres répertoires documents et scripts ne doivent pas être visibles depuis un navigateur chrome ou firefox ( il faut interdire l’accès de sécurité)

Remarque : IL FAUT TOUJOURS SAUVEGARDEZ afin d’éviter tout problème lié à votre donnée, faites une copie de sauvegarde des 3 répertoires (mentionnées en haut) et mettez la copie en endroit sûr. Sauvegardez la base de données de Dolibarr (mysqldunp, phpmyadmin, ou via l’interface de Dolibarr) et mettez-là aussi dans un endroit sûr.

1^ère  Etape : Faites une copie de votre Dolibarr de production :

• créez un répertoire nommé nouveaudolibarr (par exemple)
• copiez-y les répertoires de Dolibarr : htdocs et scripts de l’ancienne version
• recopiez votre répertoire documents de l’ancien installation Dolibarr dans le nouveau répertoire « nouveaudolibarr »
• créez une seconde base de données vide nommé (nouveaudolibarr)
• importez la sauvegarde de votre ancien ERP dolibarr dans cette nouvelle base de donnée.
• modifiez soigneusement le fichier htdocs/conf/conf.php : les lignes de la base de données, l’url de votre Dolibarr et le chemin vers le répertoire documents.
• créer l’url pour accéder à ce nouveau dolibarr (exemple : dolibarr.votre-site.com)

Après cette opération tout devrait fonctionner normalement car la version de sauvegarde est une copie conforme la version de Production.

Donc la version Dolibarr de Production servira à faire la migration et l’ancienne installation continue à être utilisée pendant ce temps par les utilisateurs de votre entreprise ou vous débloquez si vous voulez faire une facture client ou fournisseur…

Maintenant, si vous êtes prêts à décoller ! on passe aux étapes de migration :

Etape 2 : Migration de Dolibarr :

• On effectue la migration dans le nouveau Dolibarr et l’ancienne version s’occupe de votre gestion au quotidien.
• Désactivez tous les modules externes installer sur votre Dolibarr
• conservez le fichier htdocs/conf/conf.php
• et puis remplacez les répertoires htdocs et scripts de la nouvelle installation par les répertoires de la nouvelle version.
• connectez-vous à l’ERP Dolibarr et exécutez les scripts de migration.

C’est tout est Ok, vous avez maintenant une nouvelle version de Dolibarr de de base et vos anciennes données. Commencez à vérifier si tout fonctionne correctement.

Etape 3 : installez les nouvelles versions des modules externes de Dolibarr :

• vous avez effectués la mise à jour de Dolibarr, il faut aussi installez les nouvelles versions des modules (vous devez contacter les développeurs des modules). Important, car un module acheté pour votre ancienne version de Dolibarr ne fonctionnera pas sur la nouvelle version.
• Télécharger les fichier .zip de vos nouvelles version de Modules, puis Activez chaque module pour qu’il exécute lui aussi ses scripts de migration.

Etape 4 : TESTEZ LA MIGRATION

• Étape de Vérification : Vérifiez que les fonctions que vous utilisez habituellement dans votre Dolibarr fonctionnent correctement : créez un contact, un tiers, établir des factures, examinez les documents, uploader des fichiers dans votre ged dolibarr, etc…
• Testez les nouvelles fonctions de Dolibarr que vous voulez utiliser habituellement,
• Testez le bon fonctionnement des modules externes et si vous avez rencontrer des problèmes, vous devez contacter le développeur de votre module externe.

Etape 5 : La mise en production de Dolibarr !

• En premier lieux sauvegardez la base de données de Dolibarr en production,
• Arrêtez toutes les tâches planifiées, les imports éventuels sur votre Dolibarr de production,
• désactivez tous les modules externes,
• conservez le fichier htdocs/conf/conf.php en lieu sûr…
• remplacez les htdocs et scripts avec ceux de la nouvelle version que vous avez testée (modules externes compris)
• récupérez le fichier htdocs/conf/conf.php de la version ancienne de production de votre ERP Dolibarr
• connectez-vous à votre Dolibarr de production et exécutez les scripts de migration (Attention ! on le refait, mais sur les données de production).
• connectez vous et ré activez les modules externes à nouveau,
• remettez en route les tâches planifiées
• vérifiez à nouveau !

Félicitations, Vous avez effectué votre migration Dolibarr!

IMPORTANT ! Si pour une raison où une autre votre migration de Dolibarr a échouée, ci-dessous nos conseils : comment récupérer votre ancienne version :

• supprimez les répertoires htdocs et scripts de l’installation en prod,
• remettez vos anciennes sources, sauvegardées précieusement au point 2,
• supprimez toutes les colonnes de la base de données de production
• restaurez la sauvegarde de la base de prod que vous avez effectués juste avant la mise en production (étape 5)

CONCLUSION: 

L’opération de migration d’un système Open Source n’est jamais une petite affaire, si on voulais maintenir un système en production toujours à jour et en bonne fonctionnement. Je vois trop de sujets postés sur les forums de Dolibarr concernant les problèmes de migration. Pourtant avec un peu de méthode et de concentration, cela se passe fort bien.

Vous voulez de l’aide pour votre migration, commandez notre service de migration de Dolibarr !