{{tag>tutoriel}}

====== Dolibarr : restauration ======

===== Pré-requis =====

  * une sauvegarde de votre base de donnée (dans un fichier dump)
  * une sauvegarde du répertoire documents
  * connaître le login et mot de passe d'un utilisateur administrateur pour le Dolibarr qui a été sauvegardé

===== Première étape - Réinstaller le logiciel Dolibarr =====

Installez Dolibarr comme si vous vouliez l'utiliser pour la première fois avec des données fraiches :
  * **Installez exactement la même version** (vX.Y) que celle utilisée lors de la sauvegarde (normalement incluse dans le nom du fichier de sauvegarde de la base de données).
  * **Utilisez le même type de base de données** qu'auparavant (Mysql, PostgreSQL...).

===== Autres étapes =====

<WRAP list-deep>
  - **Restaurez les fichiers documents** sur votre nouvelle installation de Dolibarr :
    - **Connectez-vous** avec un compte administrateur
    - **Cliquez sur <key>Accueil</key>** (en haut)
    - Cliquez sur **Outils d'administration -> Restauration** Dolibarr montre l'emplacement du répertoire des fichiers documents
    - **Videz ce répertoire**
    - **Copiez-y le contenu de la sauvegarde** de vos anciens fichiers (éventuellement dé-zippée si vous l'avez compressée)
  - **Restaurer la base de données** :((Alternative : utiliser **Adminer** ou **phpMyAdmin**, onglet **Importer**, pour restaurer votre fichier de sauvegarde - normalement, vous n'aurez à cocher aucune option en particulier))
    - Si votre sauvegarde est une archive compressée, **décompresser** le fichier, par exemple :<cli prompt='$ '>...@...:~ $ bunzip nomdufichier.bz2</cli> -> nomdufichier.sql
    - Sur votre nouvelle installation de Dolibarr, **connectez-vous** avec un compte administrateur
    - **Cliquez sur <key>Accueil</key>** (en haut)
    - Cliquez sur **Outils d'administration -> Restauration**
    - **Méthode d'importation** : choisissez MySQL. Dolibarr affiche une commande à lancer pour restaurer de la base de données.
    - Cliquez sur **Afficher commande réelle avec mot de passe en clair**
    - Allez dans le répertoire où est enregistré le fichier de sauvegarde à restaurer
    - Lancez la commande affichée, par exemple :<cli prompt='$ '>...@...:~ $ /usr/bin/mysql base_de_données -h nom_ou_ip_serveur -P 3306 -u utilisateur -pMotDePasse < monfichiersauvegarde.sql</cli>
      * **base_de_données** : nom de la base de données MySQL qui contiendra vos données Dolibarr
      * **nom_ou_ip_serveur** : machine sur laquelle sera restaurée la base de données (localhost)
      * **-P 3306** : port TCP/IP utilisé par MySQL (facultatif)
      * **utilisateur** : utilisateur MySQL que Dolibarr utilise pour se connecter à la base de données
      * **MotDePasse** : mot de passe du compte utilisateur MySQL (attention pas d'espaces entre le p et le mot de passe)
      * **monfichiersauvegarde.sql** : nom du fichier dump
  - **Utiliser votre Dolibarr restauré** : Une fois la commande de restauration de base terminée, vous pouvez vous reconnecter sous Dolibarr avec un login qui existait lorsque la sauvegarde a été faite. Toutes les données sont celles datant de la sauvegarde.
</WRAP>

===== Conclusion =====

===== Problèmes connus =====

??? ERROR 1005 (HY000) at line 20: Can't create table `dolibarr`.`llx_accounting_account` (errno: 150 "Foreign key constraint is incorrectly formed")
!!! Si vous avez cette erreur, vous devez manuellement détruire la table llx_accounting_account et llx_accounting_system, avant de recommencer la tentative de chargement.

??? Erreur au chargement de table sur des foreign keys.
!!! Votre dump sql doit désactiver les vérifications de Foreign Keys pendant la restauration, sinon votre backup sql ne pourra pas être restauré à cause des clashs entre les Foreign Keys!
!!! Ce devrait être le cas par défaut si vous avez effectué votre sauvegarde correctement. Exemple: Ajouter FOREIGN_KEY_CHECKS au tout début et à la fin du fichier sql:<code - >
-- SQL Dump
-- Server version: 5.5.8

SET FOREIGN_KEY_CHECKS=0;
SET SQL_MODE="NO_AUTO_VALUE_ON_ZERO";

/*!40101 SET @OLD_CHARACTER_SET_CLIENT=@@CHARACTER_SET_CLIENT */;
/*!40101 SET @OLD_CHARACTER_SET_RESULTS=@@CHARACTER_SET_RESULTS */;
/*!40101 SET @OLD_COLLATION_CONNECTION=@@COLLATION_CONNECTION */;
/*!40101 SET NAMES utf8 */;

CREATE TABLE IF NOT EXISTS `llx_accountingaccount` (

INSERT INTO ...

CREATE TABLE ...

INSERT INTO ...
...
SET FOREIGN_KEY_CHECKS=1;</code>

===== Voir aussi =====

  * **(fr)** [[https://wiki.dolibarr.org/index.php/Restaurations]]

----
//Basé sur << [[https://wiki.dolibarr.org/index.php/Restaurations|Restaurations]] >> par Dolibarr.//