IoT Platform:Consulter le statut de la mise à jour

Prérequis

Vous avez créé une tâche de mise à jour par lot pour vos appareils. Pour plus d'informations, consultez

Créer une tâche de mise à jour par lot

.

Procédure

1. Connectez-vous à la console IoT Platform.

2. Sur la page Overview, repérez l'instance que vous souhaitez gérer et cliquez sur son ID ou son nom.

3. Dans le volet de navigation de gauche, sélectionnez Maintenance > OTA Update.

   Remarque

   Afin d'améliorer la qualité des services, IoT Platform a optimisé la fonctionnalité de mise à jour OTA et ajouté des statistiques sur les versions des packages de mise à jour. Lors de votre première utilisation de la nouvelle fonctionnalité de mise à jour OTA dans la console, vous devez associer les packages de mise à jour téléchargés à des produits. Un package de mise à jour ne peut être associé qu'à un seul produit. Pour savoir comment associer des packages de mise à jour à des produits, reportez-vous aux instructions affichées dans la console.

4. Dans la liste des packages de mise à jour, repérez le package cible, cliquez sur View dans la colonne Actions, puis sélectionnez l'un des onglets suivants :

   • Batch management

     • Consultez les types de lots de mise à jour, tels que Verify update package et Batch update.

     • Cliquez sur View dans la colonne Actions du lot de mise à jour cible. Sur la page Batch details, cliquez sur l'onglet Device list pour afficher les appareils de ce lot, regroupés selon leur statut de mise à jour.Edit tagOK

       Status	Description
       Pending Confirmation	La mise à jour OTA est en attente de confirmation dans l'application mobile. Ce statut s'applique uniquement si vous avez défini l'option App confirm upgrade sur Yes lors de la création de la tâche de mise à jour par lot.
       To Be Pushed	Le système n'a pas encore envoyé la notification de mise à jour OTA à l'appareil. Cet état peut se produire lorsque l'appareil est hors ligne, que la mise à jour est planifiée ou qu'une limitation de débit est en vigueur. Le statut spécifique s'affiche comme suit : To Be Pushed (Device Offline) To Be Pushed (Scheduled: YYYY/MM/DD hh:mm:ss) To Be Pushed
       Pushed	La notification de mise à jour OTA a été envoyée à l'appareil, mais celui-ci n'a pas encore signalé sa progression.
       Upgrading	L'appareil a reçu la notification de mise à jour et a commencé à signaler sa progression.
       Updated	L'appareil a terminé la mise à jour avec succès et a signalé le nouveau numéro de version. Remarque Une fois la mise à jour terminée, l'appareil doit immédiatement signaler le nouveau numéro de version. Sinon, la mise à jour peut expirer et être marquée comme ayant échoué.
       update failed	Une mise à jour peut échouer pour plusieurs raisons : Vous lancez une nouvelle tâche de mise à jour par lot pour un appareil avant que la précédente ne soit terminée et choisissez de ne pas écraser la tâche précédente. Dans ce cas, la nouvelle tâche échoue. Effectuez l'une des opérations suivantes : Attendez que la mise à jour précédente soit terminée avant d'en lancer une nouvelle. Lors du lancement de la nouvelle mise à jour, choisissez d'écraser la tâche précédente. Remarque Une tâche de mise à jour ne peut pas être écrasée si l'appareil se trouve dans l'état Upgrading. L'appareil signale un code d'échec (-1, -2, -3 ou -4) à IoT Platform via la rubrique de rapport de progression. Les codes indiquent les informations suivantes : -1 : Échec de la mise à jour. -2 : Échec du téléchargement. -3 : Échec de la vérification. -4 : Échec du flashage. Expiration du délai de la mise à jour. Le système démarre un minuteur lorsque l'appareil signale sa progression pour la première fois. Si l'appareil ne signale pas le numéro de version cible avant la fin du délai imparti, la mise à jour échoue. L'appareil signale un numéro de version qui n'est ni la version source ni la version cible alors qu'il se trouve dans l'état Upgrading. Si vous avez spécifié une version à mettre à jour et activé les nouvelles tentatives lors de la création de la tâche de mise à jour par lot, le système relance automatiquement la mise à jour dans les scénarios d'échec suivants : La mise à jour a échoué car l'appareil a signalé un numéro de version qui n'était ni la version source ni la version cible alors qu'il se trouvait dans l'état Upgrading. La mise à jour a échoué car l'appareil a activement signalé un échec en envoyant une valeur de -1, -2, -3 ou -4 via la rubrique de rapport de progression. Lors d'une nouvelle tentative automatique, le statut de mise à jour de l'appareil dans la console IoT Platform ne change pas. Par exemple, si une nouvelle tentative est déclenchée alors que l'appareil se trouve dans l'état Pushed, son statut reste Pushed. Si une nouvelle tentative est déclenchée alors que l'appareil se trouve dans l'état Upgrading, son statut reste Upgrading. Remarque IoT Platform ne déclenche pas de nouvelles tentatives automatiques dans les cas suivants : La mise à jour a échoué en raison d'une expiration du délai. La raison de l'échec est timeout. Vous avez annulé manuellement la mise à jour.
       Canceled	La mise à jour de cet appareil a été annulée.

       Si un lot de mise à jour est dans l'état Upgrading, un bouton Edit apparaît dans la colonne Actions. Cliquez sur Edit pour modifier le Update package push rate dans la section Update policy configuration, par exemple les valeurs constant rate ou variable rate, ou pour modifier et ajouter des tags. Pour plus d'informations, consultez Créer une tâche de mise à jour par lot.

       Vous pouvez également cliquer sur l'onglet Batch information pour afficher les informations de base concernant la tâche de mise à jour par lot. Si le lot de mise à jour se trouve dans l'état Upgrading, un bouton Edit apparaît à côté de Tag information. Cliquez sur Edit pour modifier ou ajouter des tags.

       Dans la boîte de dialogue, saisissez la clé et la valeur du tag pour le lot, puis cliquez sur OK. Les notifications envoyées aux appareils utiliseront les nouveaux tags dans un délai d'une minute.

     • Cliquez sur Cancel dans la colonne Actions du lot de mise à jour cible :

       • Pour un lot de mise à jour statique, cette action annule par défaut le lot ainsi que toutes les tâches de mise à jour associées, y compris celles dont le statut est Pending Confirmation, To Be Pushed, Pushed ou Upgrading.

       • Pour un lot de mise à jour dynamique, cette action annule par défaut uniquement la stratégie de mise à jour dynamique. Vous pouvez choisir d'annuler également toutes les tâches en cours, y compris celles dont le statut est To Be Pushed, Pushed ou Upgrading.

       Vous pouvez annuler toutes les tâches de mise à jour dont le statut est Pending Confirmation, To Be Pushed ou Pushed au sein d'un lot.

   • Device list

     Consultez les appareils cibles pour le package de mise à jour, leurs statuts de mise à jour ainsi que les statistiques relatives aux tâches mises à jour, échouées et annulées.

     Repérez un appareil cible et cliquez sur View dans la colonne Actions. Sur la page Batch details, vous pouvez annuler la tâche de mise à jour pour un seul appareil ou pour plusieurs appareils.

   • Update package information

     • Consultez les informations de base concernant le package de mise à jour, telles que son ID, son nom, sa signature, l'algorithme de signature, son numéro de version, son statut et son module.

     • Pour télécharger le fichier du package de mise à jour, cliquez sur Download à côté de Update package signature.

Étapes suivantes

Consulter les versions des packages de mise à jour et les taux de réussite : Une fois les mises à jour OTA terminées, utilisez l'analyse des données pour consulter la répartition des versions des packages de mise à jour et les statistiques sur les taux de réussite des mises à jour.

Référence API

Pour plus d'informations sur les opérations API liées à la fonctionnalité de mise à jour OTA, consultez API de mise à jour OTA.