De Dolibarr Wiki.

Pourquoi sauvegarder

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.
• 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.

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. Voici les 3 typologies de données qu'il est nécessaire de sauvegarder pour une restauration sans perte.

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é. 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.

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). Sa sauvegarde doit être faite de manière globale. Voir la suite pour le comment.

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é. En cas de mise à jour, bien que le processus de mise-à-jour n'intervienne normalement pas sur ce répertoire, ce dernier étant accessible en écriture par le serveur web en tout temps, il pourrait se retrouver altéré par une fausse manipulation ou un bug. Pour vous assurer de la conservation des documents officiels et leur récupération, faites une copie de sauvegarde de ce répertoire.

Les évolutions

Enfin, toute évolution de modules, c'est à dire les fichiers php ou autre du logiciel modifiés pour prendre en compte des évolutions propres, doivent également être sauvegardés.

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.

Comment

Le fichier de configuration

Une simple copie du fichier conf/conf.php dans un répertoire dédié à la sauvegarde suffit.

La base de données

Si vous utilisez une version récente de Dolibarr, connectez vous avec le compte administrateur Dolibarr. Puis aller dans Accueil - Outils systemes - Sauvegardes. Choisissez alors les options de sauvegardes (garder les options par défaut reste le plus simple).

Attention: Certains utilisateurs ont reporté que les sauvegardes sont parfois incomplètes (certaines tables manquantes) quand la compression est activée. Bien que ce problème n'ait pu être reproduit, pensez à vérifier le contenu de votre sauvegarde ou à ne pas activer la compression si vous voulez être prudent.

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:

mysqldump -u utilisateur -pvotremotdepasse --result-file=dolibarr.date.sql base_de_données

où :

• utilisateur est l'utilisateur privilégié MySQL que Dolibarr utilise pour se connecter à la base de données,
• votremotdepasse est le mot de passe du compte utilisateur MySQL (attention pas d'espaces entre le p et le mot de passe),
• date est une date que vous pouvez indiquer dans le nom du fichier de destination (ça vous aidera à vous y retrouver, plus tard, si vous avez plusieurs versions de sauvegardes), et
• base de données 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

Le fichier résultant, ici baptisé "fichier dump", est nommé dolibarr.date.sql, où 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é dolibarr.20110518.sql.

Les documents

Une copie du répertoire des documents (dolibarr/documents par défaut) dans un répertoire de sauvegarde dédié suffit.

Rem: Si vous avez réalisez la sauvegarde de la base via l'outil système de Dolibarr (voir paragraphe précédent), le fichier dump base de donnée se trouve également inclus dans cette copie (dans le sous répertoire dolibarr/documents/admin/backup).

Restauration

Ce sujet est traité dans la page Restaurations