Difference between revisions of "Backups"

Revision as of 15:12, 26 August 2009

To be safe if a bad event or actions occurs, or simply to prepare an upgrade and have possibility to go back after, it is recommended to make backup of all its Dolibarr data.

What to save ?

Dolibarr save its data in 3 different spaces. They all must be saved before each version upgrade to be sure to be able to get back its data if a problem occurs or if you want to go back on previous version. This is the 3 kind of data you need to save to be sure to loose nothing.

The configuration file

The configuration file should not be modified by upgrade process, but it is more prudent to save it also when you do an upgrade. The configuration file is called conf.php and you can find it into directory dolibarrdir/htdocs/conf/. Make a copy of this file into the dedicated area of your backup. This backup is however optional as you can still rebuild this file if you know all your connexion id (this file contains only parameters to connect to database and directory where you Dolibarr is installed). When making a restore, it is still possible to rebuild this file by an installation from scratch.

The database

The database contains all data you have added from Dolibarr screens (except the attached files that are presented in next chapter). Saving the database must be done in a global way (all content). See the chapter "How" later in this document.

Documents

All documents related to your Dolibarr instance are saved into directory defined into your config file dolibarrdir/htdocs/conf/conf.php. If you kept the choice by default during first installation, it should be something like dolibarrdir/documents. This directory must be completely saved. When making an upgrade, the upgrade process should not change this directory, however this directory can be read and write by web server at any time, it might be altered by a bad action or a bug. To be sure to keep all your joined files and be able to restore them if they are accidentally deleted or altered, just make a copy of all content of this directory.

When

Page waiting for translation. To translate, create an account, go back and clic on "Modify".
Page en attente de traduction. Pour traduire, créez un compte, revenez et cliquez sur "Modifier".
Página a traducir. Para traducirla, cree una cuenta, vuelva a la página y haga clic en "editar".
Pagina da tradurre. Per tradurla, crea un utente, torna indietro e clicca su "modifica".
Página a aguardar por tradução. Para traduzir, crie uma conta, volte atrás e clique em "Modificar".
Seite wartet auf Übersetzung. Um Übersetzung zu erstellen, richte einen Account ein, geh zurück und klicke auf "bearbeiten".
页面等待翻译。若要翻译本页，先创建一个帐户、登录并返回本页后单击“编辑”。

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 puis Sauvegardes. Choisissez alors les options de sauvegardes (prendre tout par défaut si possible).

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

Les documents

Une copie du répertoire des documents (dolibarr/documents par défaut) dans un répertoire de sauvegarde dédié suffit. Si vous avez réalisez la sauvegarde de la base via l'outil système de Dolibarr, le fichier dump base de donnée se trouve également inclus dans cette copie.

Restauration

Ce sujet est traité dans la page Restaurations

@@ Line 1: / Line 1: @@
 [[Category:Admin]]
 {{TemplateDocUser}}
-{{ToTranslate}}
-Afin de se prémunir d'un sinistre, d'une fausse manipulation, ou tout simplement en prévision d'une mise à jour afin de pouvoir faire un retour arrière, il est recommandé de réaliser des sauvegardes des données propres à Dolibarr.
+To be safe if a bad event or actions occurs, or simply to prepare an upgrade and have possibility to go back after, it is recommended to make backup of all its Dolibarr data.
-= Quoi sauvegarder =
+= What to save ? =
-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 save its data in 3 different spaces. They all must be saved before each version upgrade to be sure to be able to get back its data if a problem occurs or if you want to go back on previous version. This is the 3 kind of data you need to save to be sure to loose nothing.
-Voici les 3 typologies de données qu'il est nécessaire de sauvegarder pour une restauration sans perte.
-== Le fichier de configuration ==
+== The configuration file ==
-Bien que les fichiers de configuration ne soient normalement jamais modifiés par le processus de mise-à-jour, il vaut mieux parer à toute éventualité.
+The configuration file should not be modified by upgrade process, but it is more prudent to save it also when you do an upgrade.
-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 par ailleurs. En cas de restauration, le fichier peut être recréé par une installation vierge.
+The configuration file is called ''conf.php'' and you can find it into directory ''dolibarrdir/htdocs/conf/''.
+Make a copy of this file into the dedicated area of your backup. This backup is however optional as you can still rebuild this file if you know all your connexion id (this file contains only parameters to connect to database and directory where you Dolibarr is installed). When making a restore, it is still possible to rebuild this file by an installation from scratch.
-== La base de données ==
+== The database ==
-La base de données contient toutes les données que vous avez saisies (hors documents pièces jointes évoqué dans le paragraphe suivant).
+The database contains all data you have added from Dolibarr screens (except the attached files that are presented in next chapter).
-Sa sauvegarde doit être faite de manière globale. Voir la suite pour le comment.
+Saving the database must be done in a global way (all content). See the chapter "How" later in this  document.
-== Les documents ==
+== Documents ==
-Tous les documents relatifs à votre instance Dolibarr sont conservés dans le répertoire indiqué 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 sauvé.
+All documents related to your Dolibarr instance are saved into directory defined into your config file ''dolibarrdir/htdocs/conf/conf.php''. If you kept the choice by default during first installation, it should be something like ''dolibarrdir/documents''. This directory must be completely saved.
-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érer par une fausse manipulation ou un bug. Pour vous assurer la conservation des documents officiels et leur récupération, faites une copie de sauvegarde de ce répertoire.
+When making an upgrade, the upgrade process should not change this directory, however this directory can be read and write by web server at any time, it might be altered by a bad action or a bug. To be sure to keep all your joined files and be able to restore them if they are accidentally deleted or altered, just make a copy of all content of this directory.
-= Quand =
+= When =
+{{ToTranslate}}
 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.