Pourquoi migrer un élément mesurable ?
Vous pouvez être amené à migrer les données d’un élément mesurable d’une instance Matomo source vers une instance de Matomo cible dans les situations suivantes :
- Votre instance Matomo comprend des sites web de différents clients et vous souhaitez déplacer les données d’analyse web d’un client spécifique vers une instance dédiée à ce dernier ;
- Vous avez plusieurs instances Matomo en gestion et vous souhaitez fusionner en une instance Matomo principale pour faciliter la maintenance ;
- Vous déléguez ou reprenez la maintenance d’un site et la gestion des statistiques Matomo fait aussi partie des éléments à transférer.
Dans cet article, nous allons voir comment faire une migration entre deux instances de Matomo On-Premise.
Pré-requis
Pour migrer un site d’un Matomo vers un autre, il faudra pouvoir s’affranchir des pré-requis suivants.
Instance de Matomo source
Tous ces pré-requis sont obligatoires :
- Installer l’extension Migration ;
- Avoir un accès en ligne de commande sur l’instance de Matomo source ;
- Lister les extensions installées ;
Instance de Matomo cible
Tous ces pré-requis sont obligatoires :
- Avoir les informations pour se connecter à la base de données de l’instance de Matomo ;
- S’assurer que le port MySQL est ouvert (par défaut : 3306) ;
- S’assurer que la version de Matomo cible est la même que la version du Matomo source ;
- S’assurer que toutes les extensions installées sur l’instance de Matomo source soient aussi présentes sur l’instance de Matomo cible.
La présence de l’extension Migration n’est pas requise sur l’instance cible.
Détails des configurations
Cet article est basé sur une migration effectuée pour un élément mesurable d’une instance Matomo source hébergée chez O2Switch vers une instance de Matomo cible hébergée chez Infomaniak.
| Matomo source | Matomo cible | |
|---|---|---|
| Version de Matomo | 4.15.1 | 4.15.1 |
| Nombre d’extensions actives | 52 | 53 |
| Extensions officielles en extra |
|
|
Migration d’un élément mesurable
L’outil de migration créera un nouvel élément site Web dans le Matomo cible, en utilisant le prochain ID de site disponible (idSite), Ensuite, il copiera toutes les données du site Web source vers ce site Web cible nouvellement créé.
Commande en ligne
Avant de lancer une migration, il est bien sûr recommandé de faire une mise à jour de la base de données de l’instance cible. La commande de migration est migration:measureable. Il convient alors d’indiquer les paramètres nécessaires :
Allez dans le répertoire où est installé Matomo.
/usr/bin/php console migration:measurable --source-idsite=IDSITE --target-db-host=TARGET_MYSQL_HOST --target-db-username=TARGET_MYSQL_USERNAME --target-db-password=TARGET_MYSQL_PASSWORD --target-db-name=TARGET_MYSQL_DBNAME --target-db-prefix=matomo_
- /usr/bin/php console : Instruction pour appeler la commande de migration ;
- migration:measurable : Commande de migration d’un élément mesurable ;
- –source-idsite : L’identifiant numérique de l’élément mesurable à migrer ;
- –target-db-host : L’hôte de la base de données cible ;
- –target-db-username : L’utilisateur ayant accès à la base de données cible ;
- –target-db-password : Le mot de passe de l’utilisateur ayant accès à la base de données cible.
Options de commande
- –target-db-prefix=matomo_ : Précisez si nécéssaire le préfixe des tables de la base de données ;
- –target-db-port=3306 : Précisez le port pour la base de données (par défaut : « 3306 ») ;
- –skip-logs : Ignorer la migration des journaux ;
- –skip-archives : Ignorer la migration des archives ;
- –dry-run : Permet de tester avant migration définitive ;
Si vous rencontrez des problèmes lors de la migration, vous pouvez vous référez à la documentation officielle qui aborde notamment la création d’un tunnel SSH entre les deux serveurs et les privilèges utilisateurs.
N’oubliez pas de mettre à jour le code de suivi au niveau du site Internet afin qu’il corresponde au nouveau domaine Matomo et au nouveau idSite.
