Migrez les données d'une ancienne instance publique vers une instance Enterprise Edition cible en créant une tâche de migration, en procédant à une migration par étapes, puis en lançant une migration complète.
Prérequis
Prenez connaissance du processus global et des considérations liées à la migration d'instance. Pour plus d'informations, consultez la rubrique Flux de migration global.
Réalisez l'évaluation métier et appliquez les modifications système nécessaires. Pour plus d'informations, consultez la rubrique Préparatifs avant la migration.
Étape 1 : Créer une tâche de migration
Créez une tâche de migration pour un produit spécifique au sein de votre instance publique. Le statut initial de la tâche est To be Migrated, ce qui indique que la migration n'a pas débuté et n'affecte pas vos services.
Connectez-vous à la console IoT Platform.
-
Dans le coin supérieur gauche de la console, sélectionnez la région où IoT Platform est activé. Dans l'onglet Instance Overview, cliquez sur Public Instance.
ImportantLa fonctionnalité de migration d'instance prend uniquement en charge la migration des données d'une ancienne instance publique vers une instance Enterprise Standard. Pour plus d'informations sur les instances, consultez la rubrique Présentation des instances.
Dans le volet de navigation de gauche, choisissez . Dans l'onglet Migration List, cliquez sur Create Migration Task.
-
Dans la boîte de dialogue, sélectionnez l'Target Instance ID et le Product de l'instance publique à migrer, puis cliquez sur OK.
La création d'une tâche de migration ne déclenche pas automatiquement la migration. Avant de poursuivre, assurez-vous que l'instance cible dispose d'un quota de périphériques suffisant pour le produit sélectionné et examinez la documentation relative à la migration.
Une fois la tâche de migration créée, son statut passe à To be Migrated, indiquant que la migration n'a pas encore commencé.
Facultatif : Afficher les détails de la migration : Sur la page Migration Details, consultez les informations relatives à la tâche de migration.
-
Facultatif : Activer la synchronisation des données : La synchronisation des données pour le modèle TSL (Thing Specification Language) des périphériques est désactivée par défaut. Activez-la immédiatement après la création de la tâche de migration afin d'éviter toute interruption de service pendant la migration.
RemarqueSi votre activité ne nécessite pas la synchronisation des données des périphériques, vous pouvez ignorer cette étape.
Étape 2 : Migration par étapes
Procédez à une migration par étapes en commençant par un petit lot de périphériques. Surveillez le processus pour vérifier que vos services ne sont pas affectés avant de lancer une migration complète.
Nous vous recommandons de créer de nouveaux périphériques sous le produit concerné pour réaliser la migration par étapes.
Si vous avez configuré un abonnement côté serveur AMQP ou un transfert de messages vers AMQP, vous devez copier l'ID du groupe de consommateurs mis à jour et redémarrer le SDK client AMQP pour recevoir les données une fois la migration par étapes terminée.
Démarrage de la migration par étapes
Dans l'onglet Migration List, repérez la tâche dont le statut est To be Migrated et cliquez sur Start Migration dans la colonne Actions.
-
Dans la boîte de dialogue Start Migration Task, sélectionnez une méthode pour spécifier les périphériques à inclure dans la migration par étapes.
ImportantLe nombre de périphériques à migrer ne doit pas dépasser le quota de périphériques restant de l'instance cible. Dans le cas contraire, le système affiche le message d'erreur suivant :
The total number of devices in the target instance exceeds the maximum limit.Sélection manuelle
ImportantCette méthode permet de sélectionner jusqu'à 100 périphériques par tâche de migration par étapes.
Cliquez sur la liste déroulante des périphériques canaris (canary devices) et, dans le panneau des périphériques qui s'affiche à droite, cochez les cases correspondant aux périphériques souhaités.
Cliquez sur OK.
Téléchargement de fichier
ImportantCette méthode permet d'ajouter jusqu'à 10 000 périphériques par tâche de migration par étapes.
Cliquez sur Download Template. Dans le fichier téléchargé, saisissez les noms des périphériques dans la colonne DeviceNames, puis enregistrez le fichier.
Cliquez sur Upload File pour téléverser le fichier enregistré dans la console IoT Platform.
-
Confirmez que vous avez effectué toutes les opérations préalables à la migration, cochez les cases correspondantes, puis cliquez sur Start Now.
Les trois cases à cocher sont I have read the migration documentation, Server-side modifications are complete et I have verified the process with test devices.
Version canari en cours
Dans l'onglet Migration List, le statut de la tâche de migration passe à Canary release in progress.
Pendant cette phase, vous pouvez uniquement consulter les détails de la migration. Cliquez sur View dans la colonne Actions pour ouvrir la page Migration Details et afficher les informations relatives à la tâche. Pour plus d'informations, consultez la rubrique Facultatif : Afficher les détails de la migration.
Version canari terminée
Lorsque la tâche de migration atteint l'état Canary Release Completed, les périphériques spécifiés ont été migrés. Vous pouvez alors procéder à une migration complète ou annuler la migration si nécessaire. Pour plus d'informations, consultez les rubriques suivantes :
Étape 3 : Migration complète
Une fois la migration par étapes terminée, lancez la migration complète pour le produit spécifié.
Assurez-vous que la refonte du système est achevée et déployée. Par exemple, les appels API cloud doivent inclure l'ID de l'instance Enterprise et l'ID du groupe de consommateurs dans le SDK client AMQP doit être mis à jour. Pour plus d'informations, consultez la rubrique Préparatifs avant la migration.
Démarrage de la migration complète
Dans l'onglet Migration List, repérez la tâche dont le statut est Canary Release Completed et cliquez sur Start Migration dans la colonne Actions.
-
Dans la boîte de dialogue Start Migration Task, cliquez sur Full Migration. Confirmez que vous avez effectué toutes les opérations préalables à la migration, cochez les cases correspondantes, puis cliquez sur Start Now.
ImportantLe nombre de périphériques à migrer ne doit pas dépasser le quota de périphériques restant de l'instance cible. Dans le cas contraire, le système affiche le message d'erreur suivant :
The total number of devices in the target instance exceeds the maximum limit.Les trois cases à cocher sont I have read the migration documentation, Server-side modifications are complete et I have verified the process with test devices.
Migration en cours
Dans l'onglet Migration List, le statut de la tâche de migration passe à Migrating.
Pendant cette phase, vous pouvez afficher les détails, mettre la tâche en pause ou l'annuler :
Migration terminée
Lorsque le statut de la tâche de migration passe à Migration Completed, le produit spécifié et ses périphériques ont été migrés depuis l'instance publique. Si la migration des données rapportées par les périphériques est également terminée, vous pouvez désactiver manuellement la synchronisation des données. Pour plus de détails, consultez la rubrique Facultatif : Désactiver la synchronisation des données.
Facultatif : Annuler une tâche de migration
Vous ne pouvez pas annuler une tâche dont le statut est Canary release in progress.
Avant d'initier une annulation, assurez-vous que le produit correspondant n'a pas été supprimé de l'instance publique. Si le produit a été supprimé, l'annulation échouera.
Une annulation ne supprime pas les données d'abonnement côté serveur et de moteur de règles migrées de l'instance Enterprise Edition cible.
Démarrage de l'annulation
Selon les besoins de votre activité, vous pouvez annuler les tâches de migration dont le statut est Canary Release Completed, Migrating, Pause Migration, Continue Migration ou Migration Completed :
Dans l'onglet Migration List, cliquez sur Rollback dans la colonne Actions de la tâche de migration.
-
Dans la boîte de dialogue Start Rollback Task, sélectionnez un type d'annulation pour revenir en arrière sur la migration des périphériques.
Périphériques spécifiques
Choisissez l'une des méthodes suivantes pour sélectionner les périphériques à annuler, puis cliquez sur Start Now.
ImportantCette méthode permet de sélectionner jusqu'à 10 000 périphériques par tâche d'annulation.
Sélection manuelle
Cliquez sur la liste déroulante des périphériques à annuler et, dans le panneau des périphériques qui s'affiche à droite, cochez les cases correspondant aux périphériques souhaités.
Cliquez sur OK.
Dans la boîte de dialogue Start Rollback Task, définissez Rollback Type sur Specific Devices et Device Selection Method sur Manual Selection. Après avoir sélectionné les périphériques, cliquez sur Start Now.
Téléchargement de fichier
Cliquez sur Download Template. Dans le fichier téléchargé, saisissez les noms des périphériques dans la colonne DeviceNames, puis enregistrez le fichier.
Cliquez sur Upload File pour téléverser le fichier enregistré dans la console IoT Platform.
Dans la boîte de dialogue Start Rollback Task, définissez Rollback Type sur Specific Devices et Device Selection Method sur Upload File, puis cliquez sur Start Now.
Annulation en cours
Pour les tâches dont le statut est Canary Release Completed, Migrating, Pause Migration ou Continue Migration, le lancement d'une annulation fait passer leur statut à Rolling Back. Vous pouvez mettre en pause une tâche dans cet état. Pour plus d'informations, consultez la rubrique Facultatif : Mettre en pause une tâche de migration.
Pour une tâche dont le statut est Migration Completed, le lancement d'une annulation fait passer son statut à Batch Rollback. Vous ne pouvez pas mettre en pause une tâche dans cet état.
Annulation terminée
Une fois l'annulation terminée, toutes les données de périphérique migrées pour la tâche sont invalidées et le statut de la tâche de migration revient à To be Migrated.
Après une annulation réussie, si vous devez à nouveau migrer les données du produit :
Si l'instance cible reste la même, suivez les procédures décrites dans les rubriques Étape 2 : Effectuer une migration par étapes et Étape 3 : Effectuer une migration complète.
Si l'instance cible change, suivez les procédures décrites dans les rubriques Étape 1 : Créer une tâche de migration, Étape 2 : Effectuer une migration par étapes et Étape 3 : Effectuer une migration complète.
Facultatif : Mettre en pause une tâche de migration
Vous pouvez mettre en pause une tâche de migration dont le statut est Migrating ou Rolling Back. Dans l'onglet Migration List, cliquez sur Pause dans la colonne Actions de la tâche de migration , puis cliquez sur Confirm.
Le résultat de cette opération dépend du statut précédent de la tâche :
|
Statut précédent |
Résultat |
|
Migrating |
Le statut de la tâche passe à Pause Migration et la migration des données du produit vers l'instance cible s'arrête. Vous pouvez cliquer sur Continue Migration pour reprendre la tâche de migration complète. |
|
Rolling Back |
Le statut de la tâche passe à Pause Rollback. Vous pouvez cliquer sur Continue Rollback pour terminer l'annulation de la tâche de migration. |
Cliquez sur Start Now.
Dans la boîte de dialogue Start Rollback Task, définissez Rollback Type sur Specific Devices ou All Devices. Une annulation complète permet de restaurer tous les périphériques migrés dans la tâche vers l'instance publique.
Facultatif : Afficher les détails de la migration
Dans l'onglet Migration List, cliquez sur View dans la colonne Actions de la tâche de migration.
-
Sur la page Migration Details, consultez les informations relatives à la tâche, notamment le ProductKey, le statut de migration, le nombre total de périphériques, l'ID de l'instance cible, l'heure de création, l'heure de début de la synchronisation des données et la liste des périphériques sélectionnés pour la migration.
Vous pouvez filtrer les périphériques par statut de migration (Not Migrated, Migrated ou Migration Failed) ou rechercher un périphérique spécifique pour vérifier sa progression de migration.
Si la migration d'un périphérique échoue, .
Le haut de la page Migration Details affiche le statut de la tâche comme étant Canary release in progress.
-
Facultatif : Revenez à la page Instance Migration et cliquez sur Migration Monitoring pour afficher les statistiques en temps réel des métriques de données de migration. Pour plus d'informations, consultez la rubrique Afficher les métriques de données de migration.
Les métriques de surveillance de la migration incluent Online Device Count et Message Volume Sent to Platform. Vous pouvez utiliser la liste déroulante Time pour filtrer les statistiques par plage horaire.
Facultatif : Activer la synchronisation des données
La synchronisation des données pour le modèle TSL des périphériques est désactivée par défaut. Vous pouvez l'activer après avoir créé une tâche de migration afin d'éviter toute interruption de service pendant la migration.
Dans l'onglet Migration List, cliquez sur View dans la colonne Actions de la tâche de migration.
-
Dans le coin supérieur droit de la page Migration Details, cliquez sur Enable Data Synchronization.
À ce stade, la page affiche « - » pour le Data Migration Status et le Data Synchronization Start Time, ce qui indique que la synchronisation des données n'est pas activée.
Une fois la synchronisation des données activée, les données rapportées par les périphériques du produit spécifié dans l'instance publique sont synchronisées avec l'instance Enterprise Edition cible. La synchronisation démarre dans la minute qui suit l'activation.
Sur la page Migration Details, vous pouvez consulter l'Data Synchronization Start Time spécifique et le Data Migration Status.
Facultatif : Désactiver la synchronisation des données
Le système désactive automatiquement la synchronisation des données 30 jours après son activation. Vous pouvez également la désactiver manuellement :
Avant de désactiver la synchronisation des données, assurez-vous que la migration de l'instance est terminée afin d'éviter toute interruption de service.
Dans l'onglet Migration List, cliquez sur View dans la colonne Actions de la tâche de migration.
-
Dans le coin supérieur droit de la page Migration Details, cliquez sur Disable Data Synchronization.
ImportantAprès avoir désactivé manuellement la synchronisation des données, vous ne pouvez pas la réactiver si la tâche de migration est terminée. Si la tâche n'est pas terminée, vous pouvez réactiver la synchronisation des données.
Résultats
Lorsque le statut de la tâche passe à Migration Completed, les données du produit ont été migrées vers l'instance cible.