Comment migrer Dolibarr vers un nouveau serveur sans perte de données : guide complet

Table des Matières

1. Introduction

2. Pourquoi vous pourriez avoir besoin de migrer Dolibarr

3. Comprendre la structure des fichiers et de la base de données de Dolibarr

4. Préparation d'une migration : stratégie de sauvegarde

5. Choisir votre nouvel environnement d'hébergement

6. Installation des prérequis sur le nouveau serveur

7. Sauvegarde de la base de données Dolibarr

8. Exporter les fichiers de documents et de configuration de Dolibarr

9. Transfert sécurisé de fichiers vers le nouveau serveur

10. Restauration de la base de données sur le nouveau serveur

11. Ajuster le fichier de configuration (conf.php)

12. Définition des autorisations et des propriétés des répertoires

13. Test de l'instance restaurée

14. Considérations relatives au DNS et à la propagation des domaines

15. Gestion des différences de version pendant la migration

16. Nettoyage et optimisation post-migration

17. Erreurs courantes et comment les corriger

18. Migration des modules et plugins personnalisés

19. Assurer la compatibilité avec les intégrations externes

20. Contrôles d'intégrité des données après la migration

21. Gestion de l'accès des utilisateurs pendant le changement

22. Plan final de sauvegarde et de restauration

23. Meilleures pratiques de sécurité pendant la migration

24. Planification des temps d'arrêt et communication avec les parties prenantes

25. Conclusion : Migration fiable sans perte de données

1. Introduction

Migrer votre système ERP/CRM Dolibarr vers un nouveau serveur peut paraître complexe, surtout lorsque l'intégrité des données et la continuité de service sont essentielles. Que vous changiez d'hébergeur, mettiez à niveau votre matériel ou migriez vers un cloud privé, ce guide vous guide pas à pas tout au long du processus de migration, sans perte de données.

2. Pourquoi vous pourriez avoir besoin de migrer Dolibarr

Les scénarios courants incluent :

• Passer d'un hébergement mutualisé à un hébergement VPS ou dédié

• Passer d'un serveur de test à la production

• Passer à un fournisseur de cloud

• Mise à niveau du système d'exploitation ou de l'infrastructure

La migration garantit de meilleures performances, une meilleure flexibilité ou une meilleure sécurité, lorsqu’elle est effectuée correctement.

3. Comprendre la structure des fichiers et des bases de données de Dolibarr

Dolibarr s'appuie sur deux composants principaux :

• Base de données (MySQL/MariaDB) : Stocke toutes les données commerciales : clients, factures, inventaire, etc.

• Le système de fichiers:Contient des fichiers de configuration, des modules, des documents téléchargés par l'utilisateur (PDF, images) et le /htdocs/ dossier de candidature

Vous avez besoin des deux pour une migration complète.

4. Préparation d'une migration : stratégie de sauvegarde

Avant de faire quoi que ce soit :

• Sauvegarder la base de données en utilisant mysqldump

• Archiver l'intégralité du répertoire Dolibarr (par exemple, /var/www/dolibarr)

• Stockez les sauvegardes dans deux emplacements sécurisés

Il est également judicieux d’informer les utilisateurs de la fenêtre de maintenance et de désactiver temporairement l’accès en écriture.

5. Choisir votre nouvel environnement d'hébergement

Assurez-vous que votre nouveau serveur prend en charge :

• PHP 7.4+ ou PHP 8.1+

• MySQL ou MariaDB

• Apache ou Nginx

• Extensions PHP requises : gd, curl, mbstring, json, etc.

Évitez les piles de serveurs incompatibles ou plus anciennes.

6. Installation des prérequis sur le nouveau serveur

Installez les packages nécessaires :

sudo apt update
sudo apt install apache2 mariadb-server php php-mysql php-gd php-curl php-mbstring php-xml unzip

Activez ensuite les modules Apache requis :

sudo a2enmod rewrite ssl
sudo systemctl restart apache2

7. Sauvegarde de la base de données Dolibarr

Utilisez mysqldump ou phpMyAdmin :

mysqldump -u root -p dolibarr_db > dolibarr_backup.sql

Assurez-vous que votre décharge comprend :

• Tous les tableaux

• Structure et données du tableau

• Jeu de caractères UTF-8 (pour les caractères non anglais)

8. Exportation des fichiers de documents et de configuration de Dolibarr

Utilisez tar ou zip pour archiver votre dossier Dolibarr :

tar czf dolibarr_files.tar.gz /var/www/dolibarr

Cela préserve la structure du répertoire, les autorisations et les liens symboliques.

9. Transfert sécurisé des fichiers vers le nouveau serveur

Utilisez scp or rsync pour un transfert sécurisé :

scp dolibarr_backup.sql user@newserver:/home/user/
scp dolibarr_files.tar.gz user@newserver:/home/user/

Vous pouvez également utiliser SFTP ou un périphérique USB dans les environnements isolés.

10. Restauration de la base de données sur le nouveau serveur

Connectez-vous à MySQL et importez :

mysql -u root -p
CREATE DATABASE dolibarr_db CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
exit
mysql -u root -p dolibarr_db < dolibarr_backup.sql

Assurez-vous que les informations d'identification de l'utilisateur correspondent à celles de conf.php.

11. Ajustement du fichier de configuration (conf.php)

Open htdocs/conf/conf.php et mise à jour :

• db_host

• db_user

• db_pass

• db_name

• dolibarr_main_url_root

Assurez-vous que les URL correspondent au nouveau domaine du serveur ou à l’IP.

12. Définition des autorisations et des propriétés des répertoires

Définissez les autorisations utilisateur appropriées :

chown -R www-data:www-data /var/www/dolibarr
chmod -R 755 /var/www/dolibarr

Ils assurent l'accès du serveur Web aux fichiers Dolibarr.

13. Test de l'instance restaurée

Accédez à votre page de connexion Dolibarr à la nouvelle URL. Vérifiez :

• Connectivité de la base de données

• Fonctionnalité de connexion

• génération de PDF

• Activation des modules

Utilisez les outils de développement du navigateur ou les journaux d’erreurs PHP pour déboguer les problèmes.

14. Considérations relatives au DNS et à la propagation des domaines

Si vous changez de domaine :

• Mettre à jour les enregistrements DNS A vers la nouvelle adresse IP du serveur

• Configurer HTTPS avec Let's Encrypt ou autre SSL

• Prévoyez 24 à 48 heures pour la propagation DNS mondiale

15. Gestion des différences de version pendant la migration

Si votre nouveau serveur utilise une version plus récente de Dolibarr :

• Suivez les procédures de mise à niveau avant la migration

• Exécutez le programme d'installation de Dolibarr à /install/ pour mettre à jour le schéma de la base de données

Ne restaurez jamais une ancienne sauvegarde vers une installation plus récente sans étapes de migration.

16. Nettoyage et optimisation post-migration

Les tâches post-migration incluent :

• Suppression .sql et .tar.gz fichiers de sauvegarde

• Suppression des dossiers temporaires ou de cache

• Exécution de scripts d'optimisation de base de données

• Vérification des modules ou des données inutilisés

17. Erreurs courantes et comment les corriger

18. Migration des modules et plugins personnalisés

Copiez tous les modules personnalisés depuis : /htdocs/custom/

Migrer également :

• Fichiers de langue

• Thèmes personnalisés ou CSS

• Modèles et crochets supplémentaires

Assurez-vous qu'ils sont compatibles avec votre version de Dolibarr.

19. Assurer la compatibilité avec les intégrations externes

Après la migration, testez :

• Points de terminaison API

• Ponts WooCommerce ou Prestashop

• Paramètres SMTP de messagerie

• Webhooks ou scripts CRON

Mettez à jour les adresses IP ou les jetons selon les besoins sur les plateformes connectées.

20. Vérifications de l'intégrité des données après la migration

Valider:

• Les totaux des factures correspondent aux anciens enregistrements

• Les données clients et fournisseurs sont intactes

• Les rapports correspondent aux instantanés antérieurs à la migration

• Aucun fichier manquant dans /documents/

Utilisez des requêtes SQL pour vérifier les enregistrements aléatoires.

21. Gestion de l'accès des utilisateurs pendant le changement

Meilleur entrainement:

• Informer les utilisateurs à l'avance

• Geler l'accès pendant la sauvegarde

• Autoriser l'accès uniquement après un test sur un nouveau serveur

Envisagez de définir un mode lecture seule temporaire si les temps d’arrêt sont minimes.

22. Plan final de sauvegarde et de restauration

Toujours:

• Sauvegarder le nouveau serveur après une migration réussie

• Conservez l'ancien instantané du serveur pendant au moins 7 jours

• Documentez toutes les étapes et tous les problèmes pendant la migration

Cela fournit un filet de sécurité en cas de bugs post-migration.

23. Meilleures pratiques de sécurité pendant la migration

• Utilisez SSH/SFTP, pas FTP

• Rotation des mots de passe de la base de données et de l'administrateur après la migration

• Sécurisez le pare-feu et les paramètres PHP de votre nouveau serveur

• Activer HTTPS immédiatement

24. Planification des temps d'arrêt et communication avec les parties prenantes

Informer les clients et les utilisateurs :

• Fenêtre d'arrêt prévue

• Toute modification des URL ou des identifiants de connexion

• Contacts d'assistance en cas de problème

Planifiez la migration pendant les heures creuses si possible.

25. Conclusion : Migration fiable sans perte de données

La migration de Dolibarr vers un nouveau serveur est sûre et facile à gérer si vous suivez les étapes appropriées. En planifiant soigneusement, en sauvegardant minutieusement vos données et en vérifiant chaque étape, vous pouvez migrer vers une infrastructure ou un hébergeur plus performant sans interruption de service ni perte de données.

Que vous souhaitiez étendre vos opérations ou améliorer la sécurité, cette migration contribuera à garantir que Dolibarr reste une colonne vertébrale stable de vos opérations commerciales.