Delen via

Apparaten en groepen migreren van openbare preview naar openbare preview vernieuwen

  • Artikel

Wanneer de Device Update voor IoT Hub-service nieuwe versies uitbrengt, wilt u uw apparaten bijwerken voor de nieuwste functies en beveiligingsverbeteringen. Dit artikel bevat informatie over het migreren van de openbare preview-versie naar de huidige PPR-release (Public Preview Refresh). In dit artikel wordt ook het groeps- en UX-gedrag in deze releases uitgelegd. Als u geen apparaten, groepen en implementaties hebt die gebruikmaken van de openbare preview-versie, kunt u deze pagina negeren.

Als u wilt migreren, moet u de DU-agent upgraden die wordt uitgevoerd op uw apparaten. U moet ook nieuwe apparaatgroepen maken om updates te implementeren en beheren. Houd er rekening mee dat omdat er grote wijzigingen zijn in de PPR-release, u wordt aangeraden de instructies nauwkeurig te volgen om fouten te voorkomen.

De agent voor apparaatupdates bijwerken

Voor de openbare preview-versie vernieuwen moet de Device Update-agent handmatig worden bijgewerkt, zoals hieronder wordt beschreven. Het bijwerken van de agent via een Device Update-implementatie wordt niet ondersteund vanwege grote wijzigingen in de openbare preview- en PPR-release.

  1. Als u apparaten wilt weergeven met oudere agents (versies 0.7.0/0.6.0) en groepen die vóór 02/03/2022 zijn gemaakt, gaat u naar de openbare preview-portal, die toegankelijk is via de banner.

    Schermopname van banner.

  2. Maak een nieuw IoT/IoT Edge-apparaat op de Azure Portal. Kopieer de primaire connection string voor het apparaat vanuit de apparaatweergave voor later. Raadpleeg de sectie Apparaat toevoegen aan IoT Hub voor meer informatie.

  3. Vervolgens voert u SSH in op uw apparaat en verwijdert u een oude Device Update-agent.

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

  4. Het oude configuratiebestand verwijderen

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

  5. De nieuwe agent installeren

    sudo apt-get install deviceupdate-agent

    U kunt ook de .deb-asset ophalen uit GitHub en de agent installeren

    sudo apt install <file>.deb

    Als u probeert de Device Update-agent bij te werken zonder de oude agent en configuratiebestanden te verwijderen, resulteert dit in de onderstaande fout.

    Schermopname van updatefout.

  6. Voer het primaire connection string van uw IoT-apparaat (of module, afhankelijk van hoe u het apparaat hebt ingericht met Device Update) in het configuratiebestand in door de onderstaande opdracht uit te voeren.

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

  7. Voeg uw model, fabrikant, agentnaam, verbindingstype en andere gegevens toe aan het configuratiebestand

  8. Verwijder het oude IoT/IoT Edge-apparaat uit de openbare preview-portal.

Notitie

Als u probeert de agent bij te werken via een DU-implementatie, kan het apparaat niet meer worden beheerd door Device Update. Het apparaat moet opnieuw worden ingericht om te worden beheerd vanuit Device Update.

Groepen migreren naar openbare preview vernieuwen

  1. Als uw apparaten gebruikmaken van Device Update-agentversies 0.6.0 of 0.7.0, voert u de bovenstaande stappen uit naar de nieuwste agentversie 0.8.0.

  2. Verwijder de bestaande groepen in de openbare preview-portal door door de banner te navigeren.

  3. Voeg een groepstag toe aan de apparaatdubbel voor de bijgewerkte apparaten. Raadpleeg de sectie Een tag toevoegen aan uw apparaat voor meer informatie.

  4. Maak de groepen opnieuw in de PPR-portal door naar Groepen toevoegen te gaan en de bijbehorende groepstag te selecteren in de vervolgkeuzelijst.

  5. Houd er rekening mee dat een groep met dezelfde naam niet kan worden gemaakt in de PPR-portal als de groep in de openbare preview-portal niet wordt verwijderd.

Groeps- en implementatiegedrag tussen releases

  • Groepen die zijn gemaakt in de openbare preview-releaseportal voor vernieuwen, staan alleen apparaten toe met de meest recente Device Update Agent (0.8.0). Apparaten met oudere agents (0.7.0/0.6.0) kunnen niet aan deze groepen worden toegevoegd.

  • Nieuwe apparaten die gebruikmaken van de nieuwste agent, worden automatisch toegevoegd aan een standaardgroep DeviceClass op het tabblad Groepen en implementaties. Als er een groepstag wordt toegevoegd aan de apparaateigenschappen, wordt het apparaat aan die groep toegevoegd als er een groep voor die tag bestaat.

  • Als voor het apparaat dat de meest recente agent gebruikt, een groepstag wordt toegevoegd aan de apparaateigenschappen, maar de bijbehorende groep nog niet is gemaakt, is het apparaat niet zichtbaar op het tabblad Groepen en implementaties.

  • Apparaten die de oudere agents gebruiken, worden weergegeven als niet-gegroepeerd in de oude portal als de groepstag niet wordt toegevoegd.

Volgende stappen

Meer informatie over het configuratiebestand van de Device Update-agent

U kunt de volgende zelfstudies gebruiken voor een eenvoudige demonstratie van Device Update voor IoT Hub: