emailconfirmed, Administrators
123
edits
Sauvegardes: Difference between revisions
Jump to navigation
Jump to search
→Par les outils de sauvegarde de Dolibarr (recommandé si disponible)
Tag: 2017 source edit |
|||
| Line 11: | Line 11: | ||
{{TemplateDocUtil}} | {{TemplateDocUtil}} | ||
= [[File:Who.png]] Pourquoi sauvegarder = | =[[File:Who.png]] Pourquoi sauvegarder= | ||
Il existe plusieurs raisons pour lesquels il est très important de pouvoir "sauvegarder" une instance complète de Dolibarr. Par exemple: | Il existe plusieurs raisons pour lesquels il est très important de pouvoir "sauvegarder" une instance complète de Dolibarr. Par exemple: | ||
* En prévision d'une mise à jour afin de pouvoir faire un retour arrière. | |||
* Pour faire un déplacement de son Dolibarr d'un serveur à un autre. | *En prévision d'une mise à jour afin de pouvoir faire un retour arrière. | ||
* Enfin et surtout, afin de pouvoir réaliser une restauration pour se prémunir d'un sinistre, d'une fausse manipulation. | *Pour faire un déplacement de son Dolibarr d'un serveur à un autre. | ||
*Enfin et surtout, afin de pouvoir réaliser une restauration pour se prémunir d'un sinistre, d'une fausse manipulation. | |||
Pour toutes ces raisons, il est recommandé de réaliser des sauvegardes des données propres à Dolibarr. | Pour toutes ces raisons, il est recommandé de réaliser des sauvegardes des données propres à Dolibarr. | ||
= [[File:Who.png]] Quoi sauvegarder = | =[[File:Who.png]] Quoi sauvegarder= | ||
Dolibarr stocke des données à 3 endroits. Ces 3 endroits devraient être sauvegardés avant chaque mise-à-jour afin de s'assurer que, si un problème survient, les données peuvent être récupérées, ou tout simplement régulièrement pour être capable de restaurer son travail en cas de problème. | Dolibarr stocke des données à 3 endroits. Ces 3 endroits devraient être sauvegardés avant chaque mise-à-jour afin de s'assurer que, si un problème survient, les données peuvent être récupérées, ou tout simplement régulièrement pour être capable de restaurer son travail en cas de problème. | ||
Voici les 3 typologies de données qu'il est nécessaire de sauvegarder pour une restauration sans perte. | Voici les 3 typologies de données qu'il est nécessaire de sauvegarder pour une restauration sans perte. | ||
== A) La base de données == | ==A) La base de données== | ||
La base de données contient toutes les données que vous avez saisies (hors documents pièces jointes évoqués dans le paragraphe suivant). | La base de données contient toutes les données que vous avez saisies (hors documents pièces jointes évoqués dans le paragraphe suivant). | ||
Sa sauvegarde doit être faite de manière globale. Voir la suite pour le comment. | Sa sauvegarde doit être faite de manière globale. Voir la suite pour le comment. | ||
== B) Les documents == | ==B) Les documents== | ||
Tous les documents relatifs à votre instance Dolibarr sont conservés dans le répertoire indiqué par la variable ''$dolibarr_main_document_root'' dans votre fichier de configuration ''dolibarr/htdocs/conf/conf.php''. Si vous avez laissé le choix par défaut, il s'agit de ''dolibarr/documents''. Ce répertoire doit impérativement être sauvegardé car contient toutes les pièces jointes que vous avez éventuellement téléversées dans l'application (comme les photos des employés ou des produis) ainsi que tous les documents générés par l'applications, comme les PDF. | Tous les documents relatifs à votre instance Dolibarr sont conservés dans le répertoire indiqué par la variable ''$dolibarr_main_document_root'' dans votre fichier de configuration ''dolibarr/htdocs/conf/conf.php''. Si vous avez laissé le choix par défaut, il s'agit de ''dolibarr/documents''. Ce répertoire doit impérativement être sauvegardé car contient toutes les pièces jointes que vous avez éventuellement téléversées dans l'application (comme les photos des employés ou des produis) ainsi que tous les documents générés par l'applications, comme les PDF. | ||
== C) Le fichier de configuration == | ==C) Le fichier de configuration== | ||
Bien que les fichiers de configuration ne soient normalement jamais modifiés par le processus de mise-à-jour, il vaut mieux parer à toute éventualité. | Bien que les fichiers de configuration ne soient normalement jamais modifiés par le processus de mise-à-jour, il vaut mieux parer à toute éventualité. | ||
Le fichier de configuration s'appelle ''conf.php'' et se trouvent dans ''dolibarr/htdocs/conf/''. Faire une copie de ce fichier dans un espace dédiée à la sauvegarde. Cette sauvegarde peut toutefois ne pas être réalisée si vous connaissez vos identifiant de connexion (et tout autre paramètre non standard) par ailleurs. En cas de restauration, le fichier peut être recréé par une installation vierge. | Le fichier de configuration s'appelle ''conf.php'' et se trouvent dans ''dolibarr/htdocs/conf/''. Faire une copie de ce fichier dans un espace dédiée à la sauvegarde. Cette sauvegarde peut toutefois ne pas être réalisée si vous connaissez vos identifiant de connexion (et tout autre paramètre non standard) par ailleurs. En cas de restauration, le fichier peut être recréé par une installation vierge. | ||
== D) Les modifications de code == | ==D) Les modifications de code== | ||
Enfin, toute évolution de modules, c'est à dire tous fichiers php (ou autre) qui aurait été ajouté ou modifié pour prendre en compte des évolutions spécifiques, doivent également être sauvegardés. | Enfin, toute évolution de modules, c'est à dire tous fichiers php (ou autre) qui aurait été ajouté ou modifié pour prendre en compte des évolutions spécifiques, doivent également être sauvegardés. | ||
Dans la plupart des cas, vous n'êtes pas concernés par ce point. | Dans la plupart des cas, vous n'êtes pas concernés par ce point. | ||
= [[File:Who.png]] Quand = | =[[File:Who.png]] Quand= | ||
La fréquence conseillée dépend de l'intensité de l'utilisation que vous faites de Dolibarr et de la tolérance en terme de donnée perdu que vous acceptez. Plus la fréquence est élevé, moins, en cas de restauration, vous n'aurez de données perdues. | La fréquence conseillée dépend de l'intensité de l'utilisation que vous faites de Dolibarr et de la tolérance en terme de donnée perdu que vous acceptez. Plus la fréquence est élevé, moins, en cas de restauration, vous n'aurez de données perdues. | ||
= [[File:Who.png]] Comment = | =[[File:Who.png]] Comment= | ||
== A) La base de données == | ==A) La base de données== | ||
Il y a 4 méthodes pour sauvegarder votre base de données: | Il y a 4 méthodes pour sauvegarder votre base de données: | ||
=== Par les outils de sauvegarde de Dolibarr (recommandé si disponible) === | ===Par les outils de sauvegarde de Dolibarr (recommandé si disponible)=== | ||
Il s'agit de la façon la plus simple pour faire de votre sauvegarde, et en plus toutes vos sauvegardes seront stockées sur le serveur et seront listées, de sorte que vous pouvez récupérer n'importe quelle ancienne version n'importe quand. | Il s'agit de la façon la plus simple pour faire de votre sauvegarde, et en plus toutes vos sauvegardes seront stockées sur le serveur et seront listées, de sorte que vous pouvez récupérer n'importe quelle ancienne version n'importe quand. | ||
| Line 52: | Line 54: | ||
Si vous utilisez une version assez récente de Dolibarr, connectez-vous dans Dolibarr avec un compte administrateur (seuls les administrateurs peuvent utiliser les outils système). | Si vous utilisez une version assez récente de Dolibarr, connectez-vous dans Dolibarr avec un compte administrateur (seuls les administrateurs peuvent utiliser les outils système). | ||
Ensuite, allez à '''Accueil -> Outils | Ensuite, allez à '''Accueil -> Outils d'administration -> Sauvegarde'''. | ||
Choisissez ensuite vos options pour votre sauvegarde (vous pouvez conserver toutes les valeurs par défaut). | Choisissez ensuite vos options pour votre sauvegarde (vous pouvez conserver toutes les valeurs par défaut). | ||
| Line 60: | Line 62: | ||
''Alternative'': la méthode par défaut '''MySQL Dump (mysqldump)''' nécessite d'avoir un accès au fichier binaire mysqldump en exécution sur votre serveur. Si vous êtes sur un hébergement mutualisé qui désactive cet accès, vous pouvez essayer une autre méthode en définissant MAIN_FEATURES_LEVEL = 1, ce qui fera apparaître une nouvelle méthode '''Dump MySQL (php)'''. Cette méthode est encore expérimentale, donc s'il vous plaît essayez d'abord par vous-même en faisaint une sauvegarde puis en la restaurant sur une base locale de test pour vérifier que vos données sont correctement enregistrées et restaurées. | ''Alternative'': la méthode par défaut '''MySQL Dump (mysqldump)''' nécessite d'avoir un accès au fichier binaire mysqldump en exécution sur votre serveur. Si vous êtes sur un hébergement mutualisé qui désactive cet accès, vous pouvez essayer une autre méthode en définissant MAIN_FEATURES_LEVEL = 1, ce qui fera apparaître une nouvelle méthode '''Dump MySQL (php)'''. Cette méthode est encore expérimentale, donc s'il vous plaît essayez d'abord par vous-même en faisaint une sauvegarde puis en la restaurant sur une base locale de test pour vérifier que vos données sont correctement enregistrées et restaurées. | ||
=== Par l'outil mysqldump (pour les experts) === | ===Par l'outil mysqldump (pour les experts)=== | ||
Si vous préferez le mode manuel, vous pouvez utiliser directement l'outil de sauvegarde de votre base. | Si vous préferez le mode manuel, vous pouvez utiliser directement l'outil de sauvegarde de votre base. | ||
Avec MySQL, la commande pour sauvegarder votre base de données dans un fichier est: | Avec MySQL, la commande pour sauvegarder votre base de données dans un fichier est: | ||
| Line 67: | Line 69: | ||
</source> | </source> | ||
où : | où : | ||
* ''utilisateur'' est l'utilisateur privilégié MySQL que Dolibarr utilise pour se connecter à la base de données, | |||
* ''motdepasse'' est le mot de passe du compte utilisateur MySQL (attention pas d'espaces entre le p et le mot de passe), | *''utilisateur'' est l'utilisateur privilégié MySQL que Dolibarr utilise pour se connecter à la base de données, | ||
* ''nomserveur'' est le nom ou l'ip du serveur de base de donnée. | *''motdepasse'' est le mot de passe du compte utilisateur MySQL (attention pas d'espaces entre le p et le mot de passe), | ||
* ''nombase'' est le nom de la base de données que Dolibarr utilise. | *''nomserveur'' est le nom ou l'ip du serveur de base de donnée. | ||
*''nombase'' est le nom de la base de données que Dolibarr utilise. | |||
Ces informations (utilisateur, mot de passe et base de données) sont disponibles dans votre fichier de configuration ''dolibarr/htdocs/conf/conf.php'' | Ces informations (utilisateur, mot de passe et base de données) sont disponibles dans votre fichier de configuration ''dolibarr/htdocs/conf/conf.php'' | ||
Le fichier résultant (appelé "fichier dump"), est nommé mysqldump_nombase_version_date.sql, où | Le fichier résultant (appelé "fichier dump"), est nommé mysqldump_nombase_version_date.sql, où | ||
* ''version'' est la version en cours de votre dolibarr (ex: 3.7) | |||
* ''date'' peut-être remplacé par une date, par exemple au format AAAAMMJJ, avec AAAA l'année (ex. 2011), MM le numéro du mois (ex. 05) et JJ le jour dans le mois (ex. 18). | *''version'' est la version en cours de votre dolibarr (ex: 3.7) | ||
*''date'' peut-être remplacé par une date, par exemple au format AAAAMMJJ, avec AAAA l'année (ex. 2011), MM le numéro du mois (ex. 05) et JJ le jour dans le mois (ex. 18). | |||
Pour reprendre les valeurs données en exemple, le fichier dump sera baptisé ''mysqldump_nombase_3.7_20110518.sql''. | Pour reprendre les valeurs données en exemple, le fichier dump sera baptisé ''mysqldump_nombase_3.7_20110518.sql''. | ||
| Line 92: | Line 98: | ||
</source> | </source> | ||
=== Par phpMyAdmin === | ===Par phpMyAdmin=== | ||
Vous pouvez également utiliser phpMyAdmin pour sauvegarder votre base de données, mais il est nécessaire d'activer une option afin que vous puissiez restaurer le backup plus tard (si vous avez oublié de le faire, lisez la note à propos des FOREIGN_KEY_CHECKS plus bas). | Vous pouvez également utiliser phpMyAdmin pour sauvegarder votre base de données, mais il est nécessaire d'activer une option afin que vous puissiez restaurer le backup plus tard (si vous avez oublié de le faire, lisez la note à propos des FOREIGN_KEY_CHECKS plus bas). | ||
| Line 98: | Line 104: | ||
Dans phpMyAdmin, cliquez sur l'onglet '''Exporter''', puis sélection votre base de données Dolibarr ou les tables de Dolibarr (suivant la fenêtre dans laquelle vous étiez - vue base de données ou vue tables), et cochez '''Désactiver la vérification des clés étrangères''', et enfin vérifiez quand même que le résultat sera au format SQL, et vous pouvez valider l'exportation. | Dans phpMyAdmin, cliquez sur l'onglet '''Exporter''', puis sélection votre base de données Dolibarr ou les tables de Dolibarr (suivant la fenêtre dans laquelle vous étiez - vue base de données ou vue tables), et cochez '''Désactiver la vérification des clés étrangères''', et enfin vérifiez quand même que le résultat sera au format SQL, et vous pouvez valider l'exportation. | ||
=== Par un autre Logiciels tiers === | ===Par un autre Logiciels tiers=== | ||
Vous pouvez également utiliser des logiciels tiers de sauvegarde de bases de données, comme les scripts PHP que vous pouvez uploader (téléverser) sur votre serveur (comme DB2SQL par Howard Yeend ou BigDump), ou encore utiliser un concepteur de base de données / workbench qui offrent généralement la possibilité de se connecter à distance à votre base de données et vous permettra de faire une sauvegarde complète. | Vous pouvez également utiliser des logiciels tiers de sauvegarde de bases de données, comme les scripts PHP que vous pouvez uploader (téléverser) sur votre serveur (comme DB2SQL par Howard Yeend ou BigDump), ou encore utiliser un concepteur de base de données / workbench qui offrent généralement la possibilité de se connecter à distance à votre base de données et vous permettra de faire une sauvegarde complète. | ||
| Line 143: | Line 149: | ||
[[File:Warning.png]] Mysqldump (que ce soit par l'outil en ligne de commande ou par la fonction Sauvegarde de Dolibarr) est le moyen le plus sûr de sauvegarder vos données, car il est développé par les même développeurs que MySQL et est donc toujours à jour. '''PhpMyAdmin''' et les logiciels tiers peuvent générer un dump SQL valide, mais le code SQL résultant peut être obsolète ou manquer de certaines fonctionnalités (en fonction des options que vous choisissez). | [[File:Warning.png]] Mysqldump (que ce soit par l'outil en ligne de commande ou par la fonction Sauvegarde de Dolibarr) est le moyen le plus sûr de sauvegarder vos données, car il est développé par les même développeurs que MySQL et est donc toujours à jour. '''PhpMyAdmin''' et les logiciels tiers peuvent générer un dump SQL valide, mais le code SQL résultant peut être obsolète ou manquer de certaines fonctionnalités (en fonction des options que vous choisissez). | ||
== B) Les documents == | ==B) Les documents== | ||
Une copie de l'intégralité du répertoire des documents dans un répertoire/disque de sauvegarde dédié suffit. Voici comment savoir où se trouve ce répertoire: | Une copie de l'intégralité du répertoire des documents dans un répertoire/disque de sauvegarde dédié suffit. Voici comment savoir où se trouve ce répertoire: | ||
Ce répertoire s'appelle par défaut ''dolibarr/documents'' mais vous trouverez le chemin complet en allant dans le fichier '''conf.php''' au niveau de la variable '''$dolibarr_main_data_root'''. Vous pouvez aussi trouvez l'information du chemin complet de ce répertoire depuis le menu '''Accueil - Outils d'administration - Sauvegarde - étape 2'''. | Ce répertoire s'appelle par défaut ''dolibarr/documents'' mais vous trouverez le chemin complet en allant dans le fichier '''conf.php''' au niveau de la variable '''$dolibarr_main_data_root'''. Vous pouvez aussi trouvez l'information du chemin complet de ce répertoire depuis le menu '''Accueil - Outils d'administration - Sauvegarde - étape 2'''. | ||
| Line 150: | Line 156: | ||
Il vous faut réaliser une archive zip de ce répertoire. Pour cela, il y a 2 solutions: | Il vous faut réaliser une archive zip de ce répertoire. Pour cela, il y a 2 solutions: | ||
=== Par les outils de sauvegarde de Dolibarr (recommandé si disponible) === | ===Par les outils de sauvegarde de Dolibarr (recommandé si disponible)=== | ||
Si vous utilisez une version assez récente de Dolibarr, connectez-vous dans Dolibarr avec un compte administrateur (seuls les administrateurs peuvent utiliser les outils système). | Si vous utilisez une version assez récente de Dolibarr, connectez-vous dans Dolibarr avec un compte administrateur (seuls les administrateurs peuvent utiliser les outils système). | ||
Ensuite, allez à '''Accueil -> Outils Système -> Sauvegarde''' et cliquez sur le bouton "Générer sauvegarde" de l'étape 2. | Ensuite, allez à '''Accueil -> Outils Système -> Sauvegarde''' et cliquez sur le bouton "Générer sauvegarde" de l'étape 2. | ||
=== Par votre outil de zip habituel === | ===Par votre outil de zip habituel=== | ||
Aller dans votre gestionnaire de fichier, aller sur le répertoire identifié précédemment. Faire un clic droit sur ce répertoire et choisissez dans le menu contextuel "Compresser" ou "Zipper" ou "Créer un package zip" ou "Créer archive" ou quelque chose de similaire pour fabriquer le fichier zip. | Aller dans votre gestionnaire de fichier, aller sur le répertoire identifié précédemment. Faire un clic droit sur ce répertoire et choisissez dans le menu contextuel "Compresser" ou "Zipper" ou "Créer un package zip" ou "Créer archive" ou quelque chose de similaire pour fabriquer le fichier zip. | ||
| Line 163: | Line 169: | ||
Bon à savoir: Si vous avez réalisez la sauvegarde de la base de donnée via l'outil système de Dolibarr et son étape 1 (voir paragraphe précédent), le fichier dump base de donnée se trouvera également inclus dans cette archive (dans le sous répertoire ''dolibarr/documents/admin/backup''). | Bon à savoir: Si vous avez réalisez la sauvegarde de la base de donnée via l'outil système de Dolibarr et son étape 1 (voir paragraphe précédent), le fichier dump base de donnée se trouvera également inclus dans cette archive (dans le sous répertoire ''dolibarr/documents/admin/backup''). | ||
== C) Le fichier de configuration == | ==C) Le fichier de configuration== | ||
C'est mieux si vous l'avez (cela peut aider à du dépannage), mais sa conservation n'est pas obligatoire si il faut restaurer un jour votre sauvegarde. | C'est mieux si vous l'avez (cela peut aider à du dépannage), mais sa conservation n'est pas obligatoire si il faut restaurer un jour votre sauvegarde. | ||
Une simple copie du fichier ''conf/conf.php'' dans un répertoire dédié à la sauvegarde suffit. | Une simple copie du fichier ''conf/conf.php'' dans un répertoire dédié à la sauvegarde suffit. | ||
= [[File:Astuces.png]] Restauration = | =[[File:Astuces.png]] Restauration= | ||
Ce sujet est traité dans la page [[Restaurations]] | Ce sujet est traité dans la page [[Restaurations]] | ||