Partager via

Migrer des appareils et des groupes de la préversion publique vers l’actualisation de la préversion publique

  • Article

Quand le service Device Update pour IoT Hub publie de nouvelles versions, vous pouvez mettre à jour vos appareils pour obtenir les dernières fonctionnalités et améliorations de la sécurité. Cet article fournit des informations sur la migration de la préversion publique vers l’actualisation de la préversion publique (PPR, Public Preview Refresh). Il explique également le comportement des groupes et de l’expérience utilisateur sur ces différentes versions. Si aucun de vos appareils, groupes ou déploiements n’utilise la préversion publique, vous pouvez ignorer cette page.

Pour réussir la migration, vous devez mettre à niveau l’agent DU exécuté sur vos appareils. Vous devrez également créer des groupes d’appareils pour déployer et gérer les mises à jour. Dans la mesure où la version PPR inclut des modifications majeures, nous vous recommandons de suivre attentivement les instructions pour éviter les erreurs.

Mettre à jour l’agent Device Update

Pour l’actualisation de la préversion publique, l’agent Device Update doit être mis à jour manuellement comme décrit ci-après. La mise à jour de l’agent par le biais d’un déploiement Device Update n’est pas prise en charge en raison des modifications majeures entre la préversion publique et la version PPR.

  1. Pour voir les appareils qui utilisent des agents plus anciens (versions 0.7.0/0.6.0) et les groupes créés avant le 03/02/2022, accédez au portail en préversion publique par le biais de la bannière.

    Capture d’écran d’une bannière.

  2. Créez un appareil IoT/IoT Edge sur le portail Azure. Copiez la chaîne de connexion principale de l’appareil à partir de la vue de l’appareil pour une utilisation ultérieure. Pour plus d’informations, reportez-vous à la section Ajouter un appareil à IoT Hub.

  3. Ensuite, connectez-vous avec SSH à votre appareil et supprimez l’ancien agent Device Update, le cas échéant.

    sudo apt remove deviceupdate-agent 
sudo apt remove adu-agent

  4. Supprimer l’ancien fichier de configuration

    sudo rm -f /etc/adu/adu-conf.txt

  5. Installer le nouvel agent

    sudo apt-get install deviceupdate-agent

    Vous pouvez également récupérer la ressource .deb sur GitHub et installer l’agent.

    sudo apt install <file>.deb

    Si vous tentez de mettre à niveau l’agent Device Update sans supprimer l’ancien agent et les anciens fichiers de configuration, l’erreur ci-dessous se produit.

    Capture d’écran d’une erreur de mise à jour.

  6. Entrez la chaîne de connexion principale d’appareil (ou de module selon la façon dont vous avez provisionné l’appareil avec Device Update) de votre appareil IoT dans le fichier de configuration en exécutant la commande ci-dessous.

    sudo nano /etc/adu/du-config.json

  7. Ajoutez vos modèle, fabricant, nom d’agent, type de connexion et autres détails dans le fichier de configuration

  8. Supprimez l’ancien appareil IoT/IoT Edge dans le portail en préversion publique.

Notes

Si vous essayez de mettre à jour l’agent par le biais d’un déploiement DU, Device Update ne pourra plus gérer l’appareil. L’appareil devra être reprovisionné pour être géré à partir de Device Update.

Migrer des groupes vers l’actualisation de la préversion publique

  1. Si vos appareils utilisent la version 0.6.0 ou 0.7.0 de l’agent Device Update, effectuez une mise à niveau vers la dernière version de l’agent (0.8.0) en effectuant les étapes plus haut.

  2. Supprimez les groupes existants dans le portail en préversion publique par le biais de la bannière.

  3. Ajoutez une étiquette de groupe au jumeau d’appareil pour les appareils mis à jour. Pour plus d’informations, consultez la section Ajouter une étiquette à votre appareil.

  4. Recréez les groupes dans le portail PPR en accédant à « Ajouter des groupes » et en sélectionnant l’étiquette de groupe correspondante dans la liste déroulante.

  5. Notez que vous ne pouvez pas créer dans le portail PPR un groupe portant le nom d’un groupe existant dans le portail en préversion publique tant que ce dernier n’est pas supprimé.

Comportement des groupes et des déploiements sur les différentes versions

  • Les groupes créés dans le portail en version PPR autorisent uniquement l’ajout d’appareils avec la dernière version de l’agent Device Update (0.8.0). Vous ne pouvez pas jouter d’appareils avec des agents plus anciens (0.7.0/0.6.0) à ces groupes.

  • Les nouveaux appareils utilisant l’agent le plus récent sont automatiquement ajoutés à un groupe DeviceClass par défaut sous l’onglet « Groupes et déploiements ». Si une étiquette de groupe est ajoutée aux propriétés de l’appareil, l’appareil est ajouté à ce groupe si un groupe existe pour cette étiquette.

  • Pour l’appareil qui utilise l’agent le plus récent, si une étiquette de groupe est ajoutée aux propriétés de l’appareil, mais que le groupe correspondant n’est pas encore été créé, l’appareil n’est pas visible dans l’onglet « Groupes et déploiements ».

  • Les appareils utilisant les agents plus anciens apparaissent comme non groupés dans l’ancien portail si l’étiquette de groupe n’est pas ajoutée.

Étapes suivantes

Comprendre le fichier de configuration de l’Agent de mise à jour des appareils

Vous pouvez utiliser les tutoriels suivants pour une démonstration simple de Device Update pour IoT Hub :