Difference between revisions of "Migrer mon Dolibarr vers une offre Cloud"

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
m
Tag: 2017 source edit
(30 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<keywords content="migrer, bascule, restauration, instance, en ligne, hébergement, serveur, changement, DoliCloud, Dolibarr" />
+
<!-- BEGIN interlang links -->
 +
<!-- Do NOT edit this section
 +
    Links below are automatically managed by PolyglotBot
 +
    You can edit links on the English source page : Migrate_my_Dolibarr_To_the_Cloud -->
 +
[[en:Migrate_my_Dolibarr_To_the_Cloud]]
 +
[[es:Migrar en un servicio en la Nube (Cloud)]]
 +
<!-- END interlang links -->
 +
 
 +
<seo metak="migrer, bascule, restauration, restaurer, déplacer, instance, en ligne, hébergement, serveur, changement, DoliCloud, Dolibarr, NovaFirstCloud" />
 
[[File:Reseau.png]]  '''J'utilise Dolibarr sur un autre serveur. Comment puis-je migrer vers une offre SaaS comme [https://www.dolicloud.com DoliCloud] ou [https://www.novafirstcloud.com NovaFirstCloud] (Hébergement de Dolibarr dans le Cloud) ?'''
 
[[File:Reseau.png]]  '''J'utilise Dolibarr sur un autre serveur. Comment puis-je migrer vers une offre SaaS comme [https://www.dolicloud.com DoliCloud] ou [https://www.novafirstcloud.com NovaFirstCloud] (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 [https://www.dolicloud.com DoliCloud] (mais fonctionne aussi pour [https://www.novafirstcloud.com NovaFirstCloud] et autre. Vous devriez être en mesure de remplacer toutes les choses spécifiques à DoliCloud avec n'importe quel autre fournisseur SaaS de Dolibarr).
+
Cette page explique comment déplacer une instance existante de Dolibarr ERP & CRM vers un service d'hébergement Web à distance dans le Cloud. Ce tutoriel devrait fonctionner pour chaque installation Dolibarr utilisant une base de données MySql. L'exemple est basé sur une migration vers [https://www.dolicloud.com DoliCloud] (mais fonctionne aussi vers [https://www.novafirstcloud.com NovaFirstCloud] et autre). Vous devriez être en mesure de remplacer toutes les choses spécifiques au fournisseur SaaS pris en exemple par n'importe quel autre fournisseur SaaS de Dolibarr).
 +
 
 +
Vous pouvez exécuter le processus de migration vous-même en suivant ce tutoriel.
 +
Toutefois, si vous avez besoin de plus d'aide, vous pouvez poser vos questions par email au support de l'hébergement choisi (par exemple à '''support@dolicloud.com''' pour DoliCloud, ou '''support@novafirstcloud.com''' pour NovaFirstCloud)
 +
 
 +
 
  
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=
  
 +
*Vérifier que la version de votre Dolibarr (vous la trouverez sur la page de login) est plus faible ou égale à la version proposé en SaaS.
  
 +
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.
 +
Si votre version locale est plus récente, et uniquement dans ce cas, demandez à l'hébergeur de votre nouvelle instance Dolibarr si il peut mettre la même version que la votre, ou une version supérieure avant de dérouler la migration.
  
 +
=Etape 1 - Sauvegarder votre ancienne base de donnée=
  
= Pré-requis =
+
*La première étape est de sauvegarder la base de donnée à migrer dans le SaaS/Cloud.
* 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).
 
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.
 
  
= Etape 1 - Sauvegarder votre ancienne base de donnée =
 
* La première étape est de sauvegarder votre 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.
 
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.
  
  
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:
+
Note: Si vous rencontrez des problèmes avec cette phase (par exemple à cause de votre 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:
 
<source lang="bash">
 
<source lang="bash">
 
mysqldump -h ip_ancien_serveur_mysql -P port_ancien_serveur_mysql -u utilisateur_base -pmot_de_passe_base > monancienserveurdump.YYYYMMDD.sql
 
mysqldump -h ip_ancien_serveur_mysql -P port_ancien_serveur_mysql -u utilisateur_base -pmot_de_passe_base > monancienserveurdump.YYYYMMDD.sql
Line 26: Line 38:
  
  
* 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
+
*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
 +
 
 
<source lang="sql">
 
<source lang="sql">
 
-- Dump completed on YYYY-MM-DD HH:mm:ss
 
-- Dump completed on YYYY-MM-DD HH:mm:ss
Line 32: Line 45:
 
Si oui, enregistrez ce fichier en lieu sur. Il sera requis à l'étape 5.
 
Si oui, enregistrez ce fichier en lieu sur. Il sera requis à l'étape 5.
  
= Etape 2 - Sauvegarder le contenu de votre répertoire documents =
+
=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'''.
 
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. Remarque: rarement mais parfois, un fichier '''dolibarr.log''' se trouve à la racine de ce répertoire, vous pouvez le supprimer avant de faire votre zip pour réduire la taille du zip.
 
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. Remarque: rarement mais parfois, un fichier '''dolibarr.log''' se trouve à la racine de ce répertoire, vous pouvez le supprimer avant de faire votre zip pour réduire la taille du zip.
  
= Etape 3 - Créer une instance Cloud =
+
=Etape 3 - Créer une instance Cloud=
 
Si vous n'avez pas encore votre propre instance, inscrivez-vous pour créer votre instance privée.
 
Si vous n'avez pas encore votre propre instance, inscrivez-vous pour créer votre instance privée.
* Pour DoliCloud, cela se fait sur la page {{UrlDoliCloudRegister}}.
+
 
* Pour NovaFirstCloud, cela se fait sur la page {{UrlNovaFirstCloudRegister}}.
+
*Pour DoliCloud, cela se fait sur la page {{UrlDoliCloudRegister}}.
 +
*Pour NovaFirstCloud, cela se fait sur la page {{UrlNovaFirstCloudRegister}}.
 
   
 
   
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.
+
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 pour prendre plus de temps à vous décider à complètement basculer.
  
= Etape 4 - Recopier vos documents sur votre instance Cloud =
+
=Etape 4 - Recopier vos documents sur votre instance Cloud=
  
== Si vous n'avez pas de connaissances techniques dans l'utilisation d'un logiciel FTP ==
+
==Si vous n'avez pas de connaissances techniques dans l'utilisation d'un logiciel sFTP==
  
Envoyez simplement le fichier généré à l'étape 2 par mail (à '''support@dolicloud.com''' pour DoliCloud ou à '''support@novafirstcloud.com''' pour NovaFirstcloud). Si il est trop gros, mettez le à disposition via un système comme Google Drive, DropBox ou FileTransfer). Indiquer dans le message du mail "'''Pour migration dans ma nouvelle instance Cloud nommée xxxxx'''" (remplacer xxxxx par le nom/url de votre instance). Un technicien écrasera votre répertoire documents de votre nouvelle instance Cloud vierge avec ces fichiers de votre ancienne installation, et vous répondra par mail une fois l'opération faite (ce type de demande n'étant pas prioritaire et souvent traité de manière hebdomadaire, le délai de traitement peut varier entre 1 et 6 jours).
+
Envoyez simplement le fichier généré à l'étape 2 par mail (à '''support@dolicloud.com''' pour DoliCloud ou à '''support@novafirstcloud.com''' pour NovaFirstcloud). Si il est trop gros, mettez le à disposition via un système comme Google Drive, DropBox ou FileTransfer). Indiquer dans le message du mail "'''Pour migration dans ma nouvelle instance Cloud nommée xxxxx'''" (remplacer xxxxx par le nom/url de votre instance créée à l'étape 3). Un technicien écrasera votre répertoire documents de votre nouvelle instance Cloud vierge avec ces fichiers de votre ancienne installation, et vous répondra par mail une fois l'opération faite (ce type de demande n'étant pas prioritaire et souvent traité de manière hebdomadaire, le délai de traitement peut varier entre 1 et 6 jours).
  
== Si vous avez des connaissances dans l'utilisation de logiciel FTP ==
+
==Si vous avez des connaissances dans l'utilisation de logiciel sFTP==
  
 
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:
 
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:
Line 56: Line 70:
 
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.
 
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.
+
*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 ({{UrlDoliCloudMyAccount}}, le login est votre email d'inscription). Vous y trouverez vos identifiants d'accès SFTP.
+
*Ensuite, loguez-vous sur votre panneau de contrôle client ({{UrlDoliCloudMyAccount}}, 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 de votre instance via le protocole SFTP et ces identifiants. Copiez tous les fichiers et sous-répertoires documents que vous avez sauvegardés, vers le répertoire document de DoliCloud. Un tutoriel plus complet pour se connecter par SFTP et transférer des fichiers peut être trouvé ici: https://www.dolicloud.com/fr/faq/142-faq-how-to-setup-my-sftp
+
*Avec un logiciel sFTP (WinSCP ou FileZilla pour Windows, Nautilus pour la plupart des Linux), loguez-vous sur le serveur de votre instance via le protocole SFTP et ces identifiants. Copiez tous les fichiers et sous-répertoires documents que vous avez sauvegardés, vers le répertoire document de DoliCloud. Un tutoriel plus complet pour se connecter par SFTP et transférer des fichiers peut être trouvé ici: https://www.dolicloud.com/fr/fr-faq-how-to-setup-my-sftp.php
  
= Etape 5 - Recharger votre ancienne base de donnée sur votre instance Cloud =
+
=Etape 5 - Recharger votre ancienne base de donnée sur votre instance Cloud=
  
== Si vous n'avez pas de connaissances techniques dans le logiciel de gestion de base de donnée Mysql ==
+
==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''' pour DoliCloud ou à '''support@novafirstcloud.com''' pour NovaFirstCloud) en indiquant dans le message:
 
Envoyez simplement le fichier généré à l'étape 1 par mail (à '''support@dolicloud.com''' pour DoliCloud ou à '''support@novafirstcloud.com''' pour NovaFirstCloud) en indiquant dans le message:
Line 72: Line 86:
 
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 (ce type de demande n'étant pas prioritaire et souvent traité de manière hebdomadaire, le délai de traitement peut varier entre 1 et 6 jours).
 
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 (ce type de demande n'étant pas prioritaire et souvent traité de manière hebdomadaire, le délai de traitement peut varier entre 1 et 6 jours).
  
== Si vous avez des connaissances dans le logiciel de gestion de base de donnée Mysql ==
+
==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.
 
Vous pouvez suivre la procédure suivante pour remplacer la base de donnée de votre instance DoliCloud par celle de votre ancienne installation.
  
* Loguez-vous à votre panneau de contrôle client à nouveau. Vous trouverez un espace donnant vos identifiants MySql.
+
*Loguez-vous à votre panneau de contrôle client à nouveau. Vous trouverez un espace donnant vos identifiants MySql.
Aller sur n'importe quel ordinateur sur lequel MySql a été installé. Lancer la commande suivante pour sauvegarder votre base de donnée DoliCloud telle qu'elle est actuellement avant l'import de vos anciennes données (au cas ou, pour la restaurer plus tard si quelquechose se passe mal).
+
 
 +
Aller sur n'importe quel ordinateur sur lequel MySql a été installé. Lancer la commande suivante pour sauvegarder votre base de donnée DoliCloud telle qu'elle est actuellement, avant l'import de vos anciennes données (au cas , pour la restaurer plus tard si quelque chose se passe mal).
 
<source lang="bash">
 
<source lang="bash">
 
mysqldump -h yourinstance.with.dolicloud.com -P 3306 -u doliclouduser -pdolicloudpassword doliclouddatabase > dolicloud.YYYYMMDD.sql
 
mysqldump -h yourinstance.with.dolicloud.com -P 3306 -u doliclouduser -pdolicloudpassword doliclouddatabase > dolicloud.YYYYMMDD.sql
 
</source>
 
</source>
avec toutes les informations yourinstance.with.dolicloud.com ,doliclouduser, dolicloudpassword et doliclouddatabase qui sont les identifiants Mysql trouvés sur votre panneau de contrôle clients DoliCloud.
+
avec toutes les informations yourinstance.with.dolicloud.com, doliclouduser, dolicloudpassword et doliclouddatabase qui sont les identifiants Mysql trouvés sur votre espace client.
 +
 
 +
*Lancez la commande suivante pour remplacer les données de votre base DoliCloud avec les données de votre ancienne base.
  
* Lancez la commande suivante pour remplacer les données de votre base DoliCloud avec les données de votre ancienne base.
 
 
<source lang="bash">
 
<source lang="bash">
 
mysql -h yourinstance.with.dolicloud.com -P 3306 -D doliclouddatabase -u doliclouduser -pdolicloudpassword < monancienserveurdump.YYYYMMDD.sql
 
mysql -h yourinstance.with.dolicloud.com -P 3306 -D doliclouddatabase -u doliclouduser -pdolicloudpassword < monancienserveurdump.YYYYMMDD.sql
 
</source>
 
</source>
  
Remarque: Si vous obtenez une erreur de type ''"ERROR 1005 (HY000) at line 25: Can't create table `...`.`llx_accounting_account` (errno: 150 "Foreign key constraint is incorrectly formed")"'', alors effacez les 4 tables suivantes, si elles existent, manuellement: llx_accounting_account, llx_accounting_system, llx_accountingaccount, llx_accountingsystem
+
[[Image:Warning.png]] Remarque: Si vous obtenez une erreur de type ''"ERROR 1005 (HY000) at line 25: Can't create table `...`.`llx_accounting_account` (errno: 150 "Foreign key constraint is incorrectly formed")"'', alors effacez les 4 tables suivantes, si elles existent, manuellement: llx_accounting_account, llx_accounting_system, llx_accountingaccount, llx_accountingsystem.
 
Puis retenter la commande de chargement.
 
Puis retenter la commande de chargement.
  
= Tester =
+
[[Image:Warning.png]] Remarque: Si vous obtenez une erreur de type ''"ERROR 1064 (42000) at line 18: You have an error in your SQL syntax; check the manual that corresponds to your MariaDB server version for the right syntax to use near 'TYPE=InnoDb...' at line ..."'', remplacer alors les chaines "TYPE=InnoDB" par "ENGINE=InnoDb" dans le fichier dump. Puis retenter la commande de chargement.
Maintenant, appeler la page de login de votre Dolibarr de votre nouvelle instance.  
+
 
 +
 
 +
=Tester=
 +
Maintenant, appelez la page de login de votre Dolibarr de votre nouvelle instance.
 +
 
 +
Si votre ancienne version de Dolibarr était plus ancienne que la version de votre nouvel hébergeur Cloud, 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ée, ou si votre version était la même que celle de votre nouvel hébergeur Cloud, vous arrivez sur la page de login et vous pouvez vous connecter à votre Dolibarr en utilisant n'importe quel utilisateur qui existait dans votre ancienne installation, avec le même mot de passe qu'anciennement. Notez que votre login/mot de passe admin, qui avait été fourni lors de la génération de votre instance chez votre nouvel hébergeur Cloud, n'existe plus car il a été écrasé par le chargement de votre ancienne base de donnée à l'étape précédente. Ce sont donc vos anciens comptes qui sont maintenant à utiliser pour accéder à l'application.
  
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'''.
+
Si vous aviez des modules externes activés sur votre ancienne instance, il vous faudra aussi les redéployer sur la nouvelle instance (depuis le menu Accueil - Configuration - Modules - Déployer module externe).
  
Une fois la mise à jour réalisée, ou si votre version était la même que celle de DoliCloud, vous pouvez vous connecter à votre Dolibarr en utilisant n'importe quel utilisateur qui existait dans votre ancienne installation, avec le même mot de passe qu'anciennement. 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. Ce sont vos anciens comptes qui sont maintenant valides.
+
Votre instance privée est en ligne et opérationnelle pour un usage en production, avec toutes vos données et configurations retrouvées.  
  
Votre instance privée est en ligne et opérationnelle pour un usage en production. Vous recevrez un mail peu avant la fin de la période de test pour savoir si vous désirez continuer sur une offre payante...
+
Vous recevrez un mail peu avant la fin de la période de test pour savoir si vous désirez continuer sur une offre payante (il suffit de ne pas y répondre si vous n'êtes pas intéressé, la désinstallation et suppression des données se fera alors automatiquement quelques jours après la fin de l'échéance)...

Revision as of 19:37, 29 May 2020


Reseau.png J'utilise Dolibarr sur un autre serveur. Comment puis-je migrer vers une offre SaaS comme DoliCloud ou NovaFirstCloud (Hébergement de Dolibarr dans le Cloud) ?

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

Vous pouvez exécuter le processus de migration vous-même en suivant ce tutoriel. Toutefois, si vous avez besoin de plus d'aide, vous pouvez poser vos questions par email au support de l'hébergement choisi (par exemple à support@dolicloud.com pour DoliCloud, ou support@novafirstcloud.com pour NovaFirstCloud)



Pré-requis

  • Vérifier que la version de votre Dolibarr (vous la trouverez sur la page de login) est plus faible ou égale à la version proposé en SaaS.

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. Si votre version locale est plus récente, et uniquement dans ce cas, demandez à l'hébergeur de votre nouvelle instance Dolibarr si il peut mettre la même version que la votre, ou une version supérieure avant de dérouler la migration.

Etape 1 - Sauvegarder votre ancienne base de donnée

  • La première étape est de sauvegarder la base de donnée à migrer dans le SaaS/Cloud.

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.


Note: Si vous rencontrez des problèmes avec cette phase (par exemple à cause de votre 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:

mysqldump -h ip_ancien_serveur_mysql -P port_ancien_serveur_mysql -u utilisateur_base -pmot_de_passe_base > monancienserveurdump.YYYYMMDD.sql


  • 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
-- Dump completed on YYYY-MM-DD HH:mm:ss

Si oui, enregistrez ce fichier en lieu sur. Il sera requis à l'étape 5.

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. Remarque: rarement mais parfois, un fichier dolibarr.log se trouve à la racine de ce répertoire, vous pouvez le supprimer avant de faire votre zip pour réduire la taille du zip.

Etape 3 - Créer une instance Cloud

Si vous n'avez pas encore votre propre instance, inscrivez-vous pour créer votre instance privée.

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 pour prendre plus de temps à vous décider à complètement basculer.

Etape 4 - Recopier vos documents sur votre instance Cloud

Si vous n'avez pas de connaissances techniques dans l'utilisation d'un logiciel sFTP

Envoyez simplement le fichier généré à l'étape 2 par mail (à support@dolicloud.com pour DoliCloud ou à support@novafirstcloud.com pour NovaFirstcloud). Si il est trop gros, mettez le à disposition via un système comme Google Drive, DropBox ou FileTransfer). Indiquer dans le message du mail "Pour migration dans ma nouvelle instance Cloud nommée xxxxx" (remplacer xxxxx par le nom/url de votre instance créée à l'étape 3). Un technicien écrasera votre répertoire documents de votre nouvelle instance Cloud vierge avec ces fichiers de votre ancienne installation, et vous répondra par mail une fois l'opération faite (ce type de demande n'étant pas prioritaire et souvent traité de manière hebdomadaire, le délai de traitement peut varier entre 1 et 6 jours).

Si vous avez des connaissances dans l'utilisation de logiciel sFTP

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 (https://myaccount.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 de votre instance via le protocole SFTP et ces identifiants. Copiez tous les fichiers et sous-répertoires documents que vous avez sauvegardés, vers le répertoire document de DoliCloud. Un tutoriel plus complet pour se connecter par SFTP et transférer des fichiers peut être trouvé ici: https://www.dolicloud.com/fr/fr-faq-how-to-setup-my-sftp.php

Etape 5 - Recharger votre ancienne base de donnée sur votre instance Cloud

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 pour DoliCloud ou à support@novafirstcloud.com pour NovaFirstCloud) en indiquant dans le message:

"Pour migration dans ma nouvelle instance dont l'url est __a_completer__".

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 (ce type de demande n'étant pas prioritaire et souvent traité de manière hebdomadaire, le délai de traitement peut varier entre 1 et 6 jours).

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.

  • Loguez-vous à votre panneau de contrôle client à nouveau. Vous trouverez un espace donnant vos identifiants MySql.

Aller sur n'importe quel ordinateur sur lequel MySql a été installé. Lancer la commande suivante pour sauvegarder votre base de donnée DoliCloud telle qu'elle est actuellement, avant l'import de vos anciennes données (au cas où, pour la restaurer plus tard si quelque chose se passe mal).

mysqldump -h yourinstance.with.dolicloud.com -P 3306 -u doliclouduser -pdolicloudpassword doliclouddatabase > dolicloud.YYYYMMDD.sql

avec toutes les informations yourinstance.with.dolicloud.com, doliclouduser, dolicloudpassword et doliclouddatabase qui sont les identifiants Mysql trouvés sur votre espace client.

  • Lancez la commande suivante pour remplacer les données de votre base DoliCloud avec les données de votre ancienne base.
mysql -h yourinstance.with.dolicloud.com -P 3306 -D doliclouddatabase -u doliclouduser -pdolicloudpassword < monancienserveurdump.YYYYMMDD.sql

Warning.png Remarque: Si vous obtenez une erreur de type "ERROR 1005 (HY000) at line 25: Can't create table `...`.`llx_accounting_account` (errno: 150 "Foreign key constraint is incorrectly formed")", alors effacez les 4 tables suivantes, si elles existent, manuellement: llx_accounting_account, llx_accounting_system, llx_accountingaccount, llx_accountingsystem. Puis retenter la commande de chargement.

Warning.png Remarque: Si vous obtenez une erreur de type "ERROR 1064 (42000) at line 18: You have an error in your SQL syntax; check the manual that corresponds to your MariaDB server version for the right syntax to use near 'TYPE=InnoDb...' at line ...", remplacer alors les chaines "TYPE=InnoDB" par "ENGINE=InnoDb" dans le fichier dump. Puis retenter la commande de chargement.


Tester

Maintenant, appelez la page de login de votre Dolibarr de votre nouvelle instance.

Si votre ancienne version de Dolibarr était plus ancienne que la version de votre nouvel hébergeur Cloud, 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ée, ou si votre version était la même que celle de votre nouvel hébergeur Cloud, vous arrivez sur la page de login et vous pouvez vous connecter à votre Dolibarr en utilisant n'importe quel utilisateur qui existait dans votre ancienne installation, avec le même mot de passe qu'anciennement. Notez que votre login/mot de passe admin, qui avait été fourni lors de la génération de votre instance chez votre nouvel hébergeur Cloud, n'existe plus car il a été écrasé par le chargement de votre ancienne base de donnée à l'étape précédente. Ce sont donc vos anciens comptes qui sont maintenant à utiliser pour accéder à l'application.

Si vous aviez des modules externes activés sur votre ancienne instance, il vous faudra aussi les redéployer sur la nouvelle instance (depuis le menu Accueil - Configuration - Modules - Déployer module externe).

Votre instance privée est en ligne et opérationnelle pour un usage en production, avec toutes vos données et configurations retrouvées.

Vous recevrez un mail peu avant la fin de la période de test pour savoir si vous désirez continuer sur une offre payante (il suffit de ne pas y répondre si vous n'êtes pas intéressé, la désinstallation et suppression des données se fera alors automatiquement quelques jours après la fin de l'échéance)...