Utilisation

Ce guide décrit le processus complet de clonage d'un Dolibarr de production vers un serveur de destination.

Vue d'ensemble

Le processus de clonage comprend trois phases :

1. Préparation du serveur source -- Configuration du module DoliClone et génération de la sauvegarde SQL
2. Déploiement de l'installeur -- Installation de l'installeur autonome sur le serveur de destination
3. Exécution du clonage -- Lancement du transfert et configuration post-clonage

Phase 1 : Préparation du serveur source

Étape 1 : Activer le module

Activez le module DoliClone sur votre Dolibarr de production (voir Installation).

Étape 2 : Vérifier la clé API

Assurez-vous que votre utilisateur administrateur dispose d'une clé API. Si le champ est vide, un avertissement est affiché sur la page de configuration.

Étape 3 : Configurer la sauvegarde

1. Accédez à Accueil > Configuration > Modules > DoliClone
2. Sélectionnez la méthode de sauvegarde Système DoliClone
3. Renseignez l'adresse IP publique du serveur de destination dans le champ Adresses IP autorisées
4. Enregistrez

Étape 4 : Lancer une première sauvegarde

Cliquez sur Lancer la sauvegarde SQL pour générer la première sauvegarde de la base de données. Vérifiez que le message de confirmation apparaît.

Étape 5 : Notez les informations de connexion

Relevez les deux informations affichées en lecture seule :

• Adresse de ce serveur source -- L'URL de l'API
• Clé de sécurité -- La clé API de l'utilisateur

Phase 2 : Déploiement sur le serveur de destination

Étape 6 : Télécharger l'installeur

Sur la page de configuration DoliClone du serveur source, cliquez sur Télécharger l'installeur dans la section dédiée.

Étape 7 : Déployer l'installeur

1. Transférez le fichier ZIP sur le serveur de destination
2. Décompressez-le dans un répertoire accessible par le serveur web
3. Accédez à l'URL correspondante dans votre navigateur

Étape 8 : Configurer la connexion

Sur la page de l'installeur, renseignez :

• L'adresse de synchronisation (URL de l'API du serveur source)
• La clé d'accès à l'API
• Les informations de connexion à la base de données locale

Phase 3 : Exécution du clonage

Étape 9 : Choisir les éléments à cloner

Cochez les options souhaitées :

• Cloner la base de données -- Indispensable pour un premier clonage
• Télécharger les documents -- Recommandé pour disposer de tous les fichiers
• Télécharger les modules -- Recommandé pour avoir les mêmes modules qu'en production

Étape 10 : Choisir les actions post-clonage

• Désactiver le mode production de Stancer -- Cochez si vous utilisez Stancer pour les paiements CB
• Anonymiser les données -- Cochez si le serveur de destination est utilisé pour des tests ou des démonstrations

Étape 11 : Lancer le clonage

Cliquez sur Lancer la synchronisation. La progression s'affiche en temps réel pour chaque étape.

Étape 12 : Modifier le fichier conf.php

Après la restauration de la base de données, l'installeur affiche les valeurs à reporter dans le fichier htdocs/conf/conf.php :

$dolibarr_main_instance_unique_id = 'VALEUR_AFFICHEE';
$dolibarr_main_db_prefix = 'PREFIXE_AFFICHE';

Très important : Sauvegardez les informations affichées avant de cliquer sur le lien pour basculer sur le Dolibarr cloné. Sans la modification du fichier conf.php, aucune donnée chiffrée ne pourra être déchiffrée.

Étape 13 : Accéder au Dolibarr cloné

Une fois le fichier conf.php modifié, cliquez sur le lien J'ai sauvegardé cette page et je veux aller sur le Dolibarr cloné. Vous accédez alors à votre Dolibarr de test avec les données de production.

Indicateur sur la page de connexion

Après le clonage, la page de connexion Dolibarr affiche automatiquement un indicateur précisant si vous êtes sur le Dolibarr original ou sur le Dolibarr cloné. Ce bandeau indique également la valeur du préfixe à utiliser dans conf.php pour basculer entre les deux bases.

Resynchronisation

Pour mettre à jour le clone avec les dernières données de production :

1. Déverrouillez l'installeur (supprimez install.lock ou utilisez le token de sécurité)
2. Relancez la synchronisation avec les options souhaitées

Les fichiers déjà présents et identiques (vérification MD5) ne sont pas retéléchargés, ce qui accélère les synchronisations suivantes.