Dolibarr ERP CRM Wiki

Changes

FAQ Migrer ma base Mysql vers PostgreSQL (view source)

Revision as of 11:59, 2 June 2021

3,210 bytes added ,  3 years ago
m
no edit summary
Line 1: Line 1:  +
<!-- BEGIN interlang links -->
 +
<!-- Do NOT edit this section
 +
    Links below are automatically managed by PolyglotBot
 +
    You can edit links on the English source page : FAQ_Migrate_my_Mysql_database_to_PostgreSQL -->
 +
[[en:FAQ_Migrate_my_Mysql_database_to_PostgreSQL]]
 +
[[es:FAQ_Migrar_mi_base_de_datos_MySQL_hacia_PostgreSQL]]
 +
<!-- END interlang links -->
 +
 
[[Category:FAQ FR]]
 
[[Category:FAQ FR]]
 
= Prérequis=
 
= Prérequis=
Line 4: Line 12:  
Si ce n'est pas le cas, procéder d'abord à une mise à jour de votre Dolibarr sous MySql.
 
Si ce n'est pas le cas, procéder d'abord à une mise à jour de votre Dolibarr sous MySql.
   −
=Procédure=
     −
=== Export Mysql ===
+
=Procédure 1=
 +
 
 +
=== Installer le module MigToPG ===
 +
Ce module est disponible gratuitement sur Dolistore.
 +
Il permet de migrer de MySQL vers PgSQL avec les contrôles d'intégrité et vérification des problèmes potentiel.
 +
Normalement le fichier de configuration est modifié automatiquement mais si ce n'est pas le cas, voir le paragraphe ci dessous.
 +
 
 +
=== Modifier le fichier de configuration Dolibarr ===
 +
* Ouvrer avec un éditeur de texte le fichier '''htdocs/conf/conf.php''' qui se trouve dans la racine de votre installation de Dolibarr.
 +
* Modifier les lignes pour faire pointer les programmes sur la nouvelle base de donnée
 +
<syntaxHighlight lang="ini">
 +
$dolibarr_main_db_host='nom_ou_ip_du_serveur_postgresql';
 +
$dolibarr_main_db_port='port_serveur_postgresql';
 +
$dolibarr_main_db_name='nom_base_postgresql';
 +
$dolibarr_main_db_user='login_base_postgresql';
 +
$dolibarr_main_db_pass='mot_de_passe_base_postgresql';
 +
$dolibarr_main_db_type='pgsql';
 +
</syntaxHighlight>
 +
 
 +
=== Tester l'application===
 +
Vous devez retrouver une application 100% fonctionnelle et avec toutes ses données.
 +
La base de donnée MySql peut être arrêtée.
 +
 
 +
 
 +
=Procédure 2=
 +
 
 +
=== Exporter la base Mysql ===
 
* Aller sur la page '''Configuration - Outils - Sauvegarde'''.  
 
* Aller sur la page '''Configuration - Outils - Sauvegarde'''.  
 
* Choisir la méthode d'export "'''MySql dump'''".
 
* Choisir la méthode d'export "'''MySql dump'''".
Line 16: Line 49:  
* Dans la zone "'''Compression'''", mettre "'''Aucune'''"
 
* Dans la zone "'''Compression'''", mettre "'''Aucune'''"
 
* Puis cliquer sur "'''Générer sauvegarde'''".
 
* Puis cliquer sur "'''Générer sauvegarde'''".
−
* Aller dans le répertoire de vos données Dolibarr (le répertoire est indiqué dans "'''Configuration - Info systèmes - Dolibarr - Tous les paramètres'''" sur la ligne "'''Répertoire racine des fichiers de données'''").
+
* Aller dans le répertoire de vos données Dolibarr (le répertoire est indiqué dans "'''Configuration - Info systèmes - Dolibarr - Tous les paramètres'''" sur la ligne "'''Répertoire racine des fichiers de données'''"). Aller dans le sous répertoire '''admin/backup'''. Vous y trouverez le dump de sauvegarde de la base qui viens d'être généré. Nous appellerons ce fichier mysqldump_mydatabase_version_date.sql dans la suite de ce tutorial. Copier ce fichier dans le répertoire /tmp.
−
* Aller dans le sous répertoire '''admin/backup'''. Vous y trouverez le dump de sauvegarde de la base qui viens d'être généré. Nous appellerons ce fichier mysqldump_mydatabase_version_date.sql dans la suite de ce tutorial. Conserver ce fichier, il sera utilisé plus loin.
     −
=== Création base de donné sous PostGreSQL ===
+
=== Créer la base de donnée sous PostGreSQL ===
−
* Renommer le fichier conf.php de Dolibarr en conf.php.mysql (il doit etre soit dans /etc/dolibarr soit dans htdocs/conf)  
+
* Renommer le fichier '''conf.php''' de Dolibarr en '''conf.php.mysql''' (il doit etre soit dans '''/etc/dolibarr''' soit dans '''htdocs/conf''')  
−
* Lancer Dolibarr. Le fichier de conf n'existant plus, la procédure d'installation doit être proposée. Choisissez première installation et saisissez les informations de postgresql comme base de données source. Dérouler la procédure jusqu'au bout. Pour le compte administrateur, choissisez le meme que celui qui existait sous Mysql.
+
* Créer un fichier '''conf.php''' vide pour remplacer celui qui a été renommé en lui donnant les droits en lecture et écriture pour tout le monde.
−
Rem: En cas de problème, pour revenir sur un Dolibarr qui pointe sur la base Mysql, restaurer le fichier renommé.
+
* Lancer Dolibarr. Le fichier de conf n'existant plus, la procédure d'installation doit être proposée au lieu de la logon. Choisissez première installation et saisissez les informations de postgresql comme base de données source. Dérouler la procédure jusqu'au bout. Pour le compte administrateur, choisir le même que celui qui existait sous Mysql.
 +
* Se connecter. On arrive sur une instance opérationnelle mais sans donnée.
 +
* Activer tous les modules qui était actif dans l'ancienne base (une activation suffit, leur configuration n'est pas requise, car tout ce que nous voulons, c'est obtenir la même structure de base que l'ancienne base de donnée).
 +
* Si vous aviez ajouter des "champs complémentaires" pour certains éléments, vous devez aussi les définir dans cette nouvelle instance (la encore, le but est d'avoir les mêmes champs que dans l'ancienne instance de base).
 +
* On va charger les anciennes données à l'étape suivante.
 +
Rem: En cas de problème, pour revenir sur un Dolibarr qui pointe sur l'ancienne base Mysql, restaurer simplement le fichier conf renommé avec son nom d'origine en '''conf.php'''.
   −
=== Import sauvegarde ===
+
=== Importer la sauvegarde MySql ===
 +
* Modifier la configuration de postgresql afin d'accepter temporairement la syntaxe du fichier issu du dump mysql en plaçant la directive escape_string_warning à off dans le fichier '''postgresql.conf'''
 +
<syntaxHighlight lang="ini">
 +
escape_string_warning = off
 +
</syntaxHighlight>
 +
Redémarrer le serveur.
 +
* Désactiver les contraintes pour permettre l'import. Pour cela, se connecter à la base et exécuter la procédure stockée dol_util_triggerall qui a été installé avec Dolibarr avec la paramètre à off:
 +
<syntaxHighlight lang="sql">
 +
psql -h name_or_ip_of_postgresql_server -d name_database_postgresql -U login_database_mysql
 +
> select dol_util_triggerall(false);
 +
CTRL+D
 +
</syntaxHighlight>
 
* Modifier le fichier généré dans la phase export afin de mettre les bons échappements sur les chaines:
 
* Modifier le fichier généré dans la phase export afin de mettre les bons échappements sur les chaines:
−
<source lang="bash">
+
<syntaxHighlight lang="bash">
−
sed -e "s/\\\'/\'\'/g" mysqldump_mydatabase_version_date.sql > tmpfile.sql
+
cd /tmp
−
sed -e 's/\\/\\\\/g' tmpfile.sql > mysqldump_readyforpgsql.sql
+
sed -e "s/\\\'/\'\'/g" mysqldump_mydatabase_version_date.sql > mysqldump_readyforpgsql.sql
−
</source>
+
</syntaxHighlight>
 
* Après avoir convertit le fichier, importer le sur votre base postgresql vierge:
 
* Après avoir convertit le fichier, importer le sur votre base postgresql vierge:
−
<source lang="bash">
+
<syntaxHighlight lang="bash">
−
psql -h nom_ou_ip_du_serveur_postgresql -d nom_base_postgresql -U login_base_mysql -f mysqldump_readyforpgsql.sql
+
psql -h nom_ou_ip_du_serveur_postgresql -d nom_base_postgresql -U login_base_mysql -f mysqldump_readyforpgsql.sql >resimport.sql 2>&1
−
</source>
+
</syntaxHighlight>
−
* Une fois l'import terminé, il est nécessaire de mettre à jour les séquences pour correspondre aux nouvelles valeures
+
Jeter un oeil au fichier sortie resimport.log. Si la structure de la base Postgresql correspond bien à la structure de la base Mysql (pas de table ni de champs en moins), vous ne devriez pas avoir d'erreur.
−
<source lang="bash">
+
Si vous en avez, reportez le sur le forum dolibarr.
 +
Noter que vous pouvez réexécuter cette commande d'import après des corrections manuelles de la structure de la base d'accueil. C'est sans risque car toutes les tables Dolibarr sont protégées par une contraintes "clé unique". Aussi si vous réalisez cela, vous aurez juste des erreurs de type "clé dupliquée", que vous pouvez ignorer. Ne faites attention qu'aux autres erreurs.
 +
* Une fois l'import terminé, il est nécessaire de réactiver les contraintes et mettre à jour les séquences pour correspondre aux nouvelles valeures
 +
<syntaxHighlight lang="sql">
 
psql -h name_or_ip_of_postgresql_server -d name_database_postgresql -U login_database_mysql
 
psql -h name_or_ip_of_postgresql_server -d name_database_postgresql -U login_database_mysql
−
# select rebuilt_sequences();
+
> select dol_util_triggerall(true);
 +
> select dol_util_rebuild_sequences();
 
CTRL+D
 
CTRL+D
−
</source>
+
</syntaxHighlight>
−
 
+
Vous pouvez aussi restaurer le fichier postgresql.conf à sa valeur initiale.
−
=== Modification de votre fichier de configuration Dolibarr ===
+
<syntaxHighlight lang="ini">
−
* Ouvrer avec un éditeur de texte le fichier '''htdocs/conf/conf.php''' qui se trouve dans la racine de votre installation de Dolibarr.
+
escape_string_warning = on
−
* Modifier les lignes pour faire pointer les programmes sur la nouvelle base de donnée
+
</syntaxHighlight>
−
<source lang="ini">
  −
$dolibarr_main_db_host='nom_ou_ip_du_serveur_postgresql';
  −
$dolibarr_main_db_port='port_serveur_postgresql';
  −
$dolibarr_main_db_name='nom_base_postgresql';
  −
$dolibarr_main_db_user='login_base_mysql';
  −
$dolibarr_main_db_pass='mot_de_passe_base_mysql';
  −
$dolibarr_main_db_type='pgsql';
  −
</source>
  −
 
  −
===Tester l'application===
  −
Vous devez retrouver une application 100% fonctionnelle et avec toutes ses données.
  −
La base de donnée MySql peut être arrêtée.
 
Retrieved from "https://wiki.dolibarr.org/index.php?title=Special:MobileDiff/25826...50778"