Migrer vers DoliCloud

 '''J'utilise Dolibarr sur un autre serveur. Comment puis-je migrer vers DoliCloud (Hébergement de Dolibarr dans le Cloud) ?'''

Cette page explique comment déplacer une instance existante de Dolibarr ERP & CRM dans un service d'hébergement Web à distance dans le Cloud. Ce tutorial devrait fonctionner pour chaque installation Dolibarr utilisant une base de données MySql. L'exemple est basé sur DoliCloud (mais vous devriez être en mesure de remplacer toutes les choses spécifiques à DoliCloud avec n'importe quel autre fournisseur SaaS de Dolibarr).

Vous pouvez exécuter le processus de migration vous-même en suivant ce tutorial. Toutefois, si vous avez besoin de plus d'aide, vous pouvez poser vos questions à support@dolicloud.com (le support à la migration est inclus dans toutes les offres, y compris l'offre Basic).

= Pré-requis = Si votre version locale est plus ancienne, vous pouvez réaliser une mise à jour localement mais ce n'est pas obligatoire, la mise à jour pourra aussi se faire après migration vers DoliCloud.
 * Vérifier que la version de votre Dolibarr (vous la trouverez sur la page de login) est plus faible ou égale à la version de DoliCloud (Dans la plupart des cas, cela doit être vrai car les offres DoliCloud se basent sur la dernière version stable).

= Etape 1 - Sauvegarder votre ancienne base de donnée = Pour cela, aller dans le menu Accueil - Outils systèmes - Sauvegardes. Cliquer sur Générer le fichier backup (avec la méthode mysqldump de préférence si plusieurs méthodes sont proposées). Ceci lancera la commande de sauvegarde et affichera le fichier de sauvegarde généré qu'il sera possible de télécharger en cliquant dessus.
 * La première étape est de sauvegarder votre base de donnée.

Note: Si vous rencontrez des problèmes avec cette phase (par exemple à cause de votre ancien hébergeur qui bride votre hébergement ne permettant pas l'exécution de cette commande mysqldump), vous pouvez lancer la commande de sauvegarde depuis n'importe quel autre ordinateur équipé du logiciel MySql installé. Pour cela, il faut lancer la commande suivante:

Si oui, enregistrez ce fichier en lieu sur. Il sera requis à l'étape 5.
 * Ouvrez le fichier dump/sauvegarde généré (son nom est du genre mysqldump_A.B.C_YYYYMMDDHHMMSS.sql) pour voir si ce fichier est bien complet: Le fichier doit se terminer par une ligne du genre

= Etape 2 - Sauvegarder le contenu de votre répertoire documents = Tous les fichiers envoyés ou générés sur Dolibarr de votre ancienne instance sont stockés dans un répertoire, nommé en général documents ou dolibar_documents. Pour savoir quel est le nom complet exact de ce répertoire pour votre cas, aller sur l'instance à sauvegarder, dans le menu Accueil - Infos Systèmes - Dolibarr - Tous les paramètres. Le chemin complet ou sont stockés vos fichiers est visible sur la ligne commençant par dolibarr_main_data_root. Sauvez ce répertoire et tout son contenu (sous-répertoires et fichiers), en réalisant un fichier zip du répertoire et sous répertoire, ou en recopiant toute l'arborescence sur un autre emplacement du disque dur.

= Etape 3 - Créer une instance DoliCloud = Si vous n'avez pas encore votre propre instance sur DoliCloud, aller sur le site http://www.dolicloud.com et inscrivez-vous pour créer votre instance privée (en cliquant sur le bouton "Créer votre instance..."). Notez que la création d'une instance est gratuite (pour 15 jours) mais vous pouvez demander une prolongation si vous avez besoin de plus de temps pour tester votre migration ou vous décider à complètement basculer.

= Etape 4 - Recopier vos documents sur DoliCloud =

Si vous n'avez pas de connaissances techniques dans l'utilisation d'un logiciel FTP
Envoyez simplement le fichier généré à l'étape 2 par mail à support@dolicloud.com (ou si il est trop gros, en le mettant à disposition via un système comme Google Drive ou DropBox) et en indiquant dans le message du mail "Pour migration dans ma nouvelle instance Dolicloud nommée xxx.on.dolicloud.com" (remplacé xxx par le nom de votre instance). Un technicien écrasera votre répertoire documents de votre nouvelle instance DoliCloud vierge avec ces fichiers de votre ancienne installation, et vous répondra par mail une fois l'opération faite.

Si vous avez des connaissances dans l'utilisation de logiciel FTP
Vous pouvez réaliser cette étape vous-même en suivant la procédure suivante pour remplacer les fichiers documents de votre instance DoliCloud par ceux de votre ancienne installation:

Une fois l'instance DoliCloud créée, vous avez du recevoir un mail avec les identifiants pour vos logguer à votre Dolibarr ainsi qu'à votre panneau de contrôle client.


 * D'abord, connectez-vous sur votre nouvelle instance Dolibarr sur DoliCloud (le login est admin par défaut). Aller dans le menu Accueil - Infos systèmes - Dolibarr - Tous les paramètres. Vous trouverez sur la ligne commençant par dolibarr_main_data_root, le chemin complet du répertoire ou sont stockés les documents de votre nouvelle instance sur DoliCloud.


 * Ensuite, loguez-vous sur votre panneau de contrôle client (http://www.on.dolicloud.com, le login est votre email d'inscription). Vous y trouverez vos identifiants d'accès SFTP.


 * Avec un logiciel SFTP (WinSCP ou FileZilla pour Windows, Nautilus pour la plupart des Linux), loguez-vous sur le serveur DoliCloud via le protocole SFTP et ces identifiants. Copiez tous les fichiers et sous-répertoires documents que vous avez sauvegardés, vers dans le répertoire document de DoliCloud. Un tutoriel plus complet pour se connecter par SFTP et transférer des fichiers peut être trouvé ici: http://dolicloud.com/fr/faq/142-faq-how-to-setup-my-sftp

= Etape 5 - Recharger votre ancienne base de donnée sur DoliCloud =

Si vous n'avez pas de connaissances techniques dans le logiciel de gestion de base de donnée Mysql
Envoyez simplement le fichier généré à l'étape 1 par mail à support@dolicloud.com en indiquant dans le message "Pour migration dans ma nouvelle instance Dolicloud nommée xxx.on.dolicloud.com". Un technicien écrasera votre nouvelle base DoliCloud vierge avec les données de votre ancienne installation, et vous répondra par mail une fois l'opération faite.

Si vous avez des connaissances dans le logiciel de gestion de base de donnée Mysql
Vous pouvez suivre la procédure suivante pour remplacer la base de donnée de votre instance DoliCloud par celle de votre ancienne installation.

Aller sur n'importe quel ordinateur surlequel MySql a été installé. Lancer la commande suivante pour sauvegarder votre base de donnée DoliCloud telle qu'elle avant l'import de vos anciennes données (au cas ou, pour la restaurer plus tard si quelquechose se passe mal). avec toutes les informations yourinstance.on.dolicloud.com ,doliclouduser, dolicloudpassword et doliclouddatabase qui sont les identifiants Mysql trouvés sur votre panneau de contrôle clients DoliCloud.
 * Loguez-vous à votre panneau de contrôle client DoliCloud à nouveau. Vous trouverez un espace donnant vos identifiants MySql.


 * Lancez la commande suivante pour remplacer les données de votre base DoliCloud avec les données de votre ancienne base.

= Tester = Maintenant, appeler la page de login de votre Dolibarr dans DoliCloud.

Si votre ancienne version de Dolibarr était plus ancienne que la version de DoliCloud, vous devriez avoir un message vous invitant à lancer le processus de migration de données. Choisissez simplement le choix proposé recommandé par l'assistant. Si vous recevez un message disant que le processus de mise à jour est "vérrouillé" par le fichier install.lock, lancez à nouveau votre client SFTP et supprimer le fichier documents/install.lock.

Une fois la mise à jour réalisé, ou si votre version était la même que celle de DoliCloud, vous pouvez vous connecter à votre Dolibarr en utilisant un utilisateur qui existait dans votre ancienne installation, avec le même mot de passe. Notez que votre login/mot de passe admin qui avait été fourni après la génération de votre instance DoliCloud n'existe plus car il a été écrasé par le chargement de votre ancienne base de donnée à l'étape précédente.