Device Update Agent inrichten
De Device Update Module-agent kan naast andere systeemprocessen en IoT Edge-modules worden uitgevoerd die verbinding maken met uw IoT Hub als onderdeel van hetzelfde logische apparaat. In deze sectie wordt beschreven hoe u de Device Update-agent inricht als een module-id.
Wijzigingen in device update-agent bij algemene beschikbaarheid
Als u de versie van de Device Update-agent gebruikt, migreert u naar de nieuwste agentversie 1.0.0. Dit is de GA-versie. Raadpleeg de GA-agent voor wijzigingen en hoe u een upgrade uitvoert
U kunt de geïnstalleerde versie van de Device Update-agent en de Delivery Optimization-agent controleren in de sectie Apparaateigenschappen van uw IoT-apparaatdubbel. Meer informatie over apparaateigenschappen onder ADU Core Interface.
Module-id versus apparaat-id
In IoT Hub kunt u onder elke apparaat-id maximaal 50 module-id's maken. Elke module-id genereert impliciet een moduledubbel. Aan de apparaatzijde kunt u met de SDK's van het IoT Hub-apparaat modules maken waarbij elk apparaat een onafhankelijke verbinding met IoT Hub opent. Module-id's en moduledubbels bieden vergelijkbare mogelijkheden als apparaatidentiteit en apparaatdubbel, maar met een fijnere granulariteit. Meer informatie over module-identiteiten in IoT Hub
Als u migreert van een agent op apparaatniveau om de agent toe te voegen als een module-id op het apparaat, verwijdert u de oudere agent die via de apparaatdubbel communiceerde. Wanneer u de Device Update-agent inricht als module-id, vindt alle communicatie tussen het apparaat en de Device Update-service plaats via de moduledubbel. Vergeet dus niet om de moduledubbel van het apparaat te taggen wanneer u groepen maakt en alle communicatie moet plaatsvinden via de moduledubbel.
Ondersteuning voor Apparaatupdate
Het volgende IoT-apparaat via de air-updatetypen wordt momenteel ondersteund met Device Update:
Linux-apparaten (IoT Edge- en Niet-IoT Edge-apparaten):
Beperkte apparaten:
- Voorbeelden van Eclipse ThreadX Device Update-agent: Apparaatupdate voor Azure IoT Hub voor Azure-Realtime-besturingssysteem
Niet-verbonden apparaten:
Vereisten
Als u het IoT-apparaat/IoT Edge-apparaat instelt voor op pakketten gebaseerde updates, voegt u packages.microsoft.com toe aan de opslagplaatsen van uw computer door de volgende stappen uit te voeren:
Meld u aan bij de computer of het IoT-apparaat waarop u de Device Update-agent wilt installeren.
Open een Terminal-venster.
Installeer de opslagplaatsconfiguratie die overeenkomt met het besturingssysteem van uw apparaat.
curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list
Kopieer de gegenereerde lijst naar de map sources.list.d.
sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/
Installeer de openbare Microsoft GPG-sleutel.
curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/
De Device Update-agent inrichten als module-id
In deze sectie wordt beschreven hoe u de Device Update-agent inricht als een module-id op
- Met IoT Edge ingeschakelde apparaten of
- Niet-Edge IoT-apparaten of
- Andere IoT-apparaten.
Raadpleeg de installatie-instructies van IoT Edge om te controleren of IoT Edge is ingeschakeld op uw apparaat.
Volg alle of een van de onderstaande secties om de apparaatupdateagent toe te voegen op basis van het type IoT-apparaat dat u beheert.
Op IoT Edge-apparaten
Volg deze instructies om de Device Update-agent in te richten op apparaten met IoT Edge.
Volg de instructies voor het handmatig inrichten van één Linux IoT Edge-apparaat.
Installeer de updateagent voor de installatiekopieën van Device Update.
We bieden voorbeeldafbeeldingen in de opslagplaats Assets hier . Het swUpdate-bestand is de basisafbeelding die u kunt knipperen op een Raspberry Pi B3+ bord. Het .gz bestand is de update die u zou importeren via Device Update voor IoT Hub. Zie De afbeelding flashen naar uw IoT Hub-apparaat voor een voorbeeld.
Installeer de updateagent van het Device Update-pakket.
Voor de nieuwste agentversies van packages.microsoft.com: Werk pakketlijsten op uw apparaat bij en installeer het Device Update-agentpakket en de bijbehorende afhankelijkheden met behulp van:
sudo apt-get update
sudo apt-get install deviceupdate-agent
Voor elke 'rc' d.w.v. release kandidaat agent versies van Artifacts : Download het .deb bestand naar de computer waarop u de Device Update-agent wilt installeren, en vervolgens:
sudo apt-get install -y ./"<PATH TO FILE>"/"<.DEB FILE NAME>"
Als u een MCC instelt voor een niet-verbonden apparaatscenario, installeert u de APT-invoegtoepassing delivery optimization:
sudo apt-get install deliveryoptimization-plugin-apt
Nadat u de agent voor apparaatupdates hebt geïnstalleerd, moet u het configuratiebestand voor Device Update bewerken door de onderstaande opdracht uit te voeren.
sudo nano /etc/adu/du-config.json
Wijzig het connectionType in 'AIS' voor agents die de IoT Identity Service gebruiken voor inrichting. Het veld Verbinding maken ionData moet een lege tekenreeks zijn. Houd er rekening mee dat alle waarden met de tag Plaatswaarde hier moeten worden ingesteld. Zie Een DU-agent configureren.
U bent nu klaar om de Device Update-agent op uw IoT-apparaat te starten.
Op IoT Linux-apparaten waarop IoT Edge niet is geïnstalleerd
Volg deze instructies voor het inrichten van de Device Update-agent op uw IoT Linux-apparaten.
Installeer de IoT Identity Service en voeg de nieuwste versie toe aan uw IoT-apparaat door de instructies te volgen in De Azure IoT Identity Service installeren.
Configureer de IoT Identity Service door de instructies te volgen in het configureren van de Azure IoT Identity Service.
Installeer ten slotte de Device Update-agent. We bieden hier voorbeeldafbeeldingen in Assets, het swUpdate-bestand is de basisinstallatiekopie die u kunt flashen op een Raspberry Pi B3+ bord en het .gz bestand is de update die u zou importeren via Device Update voor IoT Hub. Zie het voorbeeld van het flashen van de afbeelding naar uw IoT Hub-apparaat.
Nadat u de agent voor apparaatupdates hebt geïnstalleerd, moet u het configuratiebestand voor Device Update bewerken door de onderstaande opdracht uit te voeren.
sudo nano /etc/adu/du-config.json
Wijzig het connectionType in 'AIS' voor agents die de IoT Identity Service gebruiken voor inrichting. Het veld Verbinding maken ionData moet een lege tekenreeks zijn. Houd er rekening mee dat alle waarden met de tag Plaatswaarde hier moeten worden ingesteld. Zie Een DU-agent configureren.
U bent nu klaar om de Device Update-agent op uw IoT-apparaat te starten.
Andere IoT-apparaten
De Device Update-agent kan ook worden geconfigureerd zonder de IoT Identity-service voor testen of op beperkte apparaten. Volg de onderstaande stappen om de Device Update-agent in te richten met behulp van een verbindingsreeks (van de module of het apparaat).
We bieden voorbeeldafbeeldingen in de opslagplaats Assets hier . Het swUpdate-bestand is de basisafbeelding die u kunt knipperen op een Raspberry Pi B3+ bord. Het .gz bestand is de update die u zou importeren via Device Update voor IoT Hub. Zie De afbeelding flashen naar uw IoT Hub-apparaat voor een voorbeeld.
Meld u aan bij de machine of het IoT Edge-apparaat/IoT-apparaat.
Een terminalvenster openen.
Voeg de verbindingsreeks toe aan het configuratiebestand voor apparaatupdates:
Voer het onderstaande in het terminalvenster in:
- Gebruik voor Ubuntu-agent : sudo nano /etc/adu/du-config.json
- Gebruik voor Yocto-referentieafbeelding : sudo nano /adu/du-config.json
De primaire verbindingsreeks kopiëren
- Als de Device Update-agent is geconfigureerd als een module, kopieert u de primaire verbindingsreeks van de module.
- Kopieer anders de primaire verbindingsreeks van het apparaat.
Voer de gekopieerde primaire verbindingsreeks in op de waarde van het veld ConnectionData in het du-config.json-bestand. Houd er rekening mee dat alle waarden met de tag Plaatswaarde hier moeten worden ingesteld. Zie Een DU-agent configureren
U bent nu klaar om de Device Update-agent op uw IoT-apparaat te starten.
De Device Update Agent starten
In deze sectie wordt beschreven hoe u de Device Update-agent start en verifieert als een module-id die wordt uitgevoerd op uw IoT-apparaat.
Meld u aan bij de computer of het apparaat waarop de Device Update-agent is geïnstalleerd.
Open een Terminal-venster en voer de onderstaande opdracht in.
sudo systemctl restart deviceupdate-agent
U kunt de status van de agent controleren met behulp van de onderstaande opdracht. Als u problemen ziet, raadpleegt u deze gids voor probleemoplossing.
sudo systemctl status deviceupdate-agent
Als het goed is, ziet u de status OK.
Ga in de IoT Hub-portal naar IoT-apparaat- of IoT Edge-apparaten om het apparaat te vinden dat u hebt geconfigureerd met de Device Update-agent. Daar ziet u dat de Device Update-agent wordt uitgevoerd als een module. Voorbeeld:
Device Update Agent bouwen en uitvoeren
U kunt ook uw eigen Device Update-agent voor klanten bouwen en wijzigen. Volg de instructies voor het bouwen van de Device Update-agent vanuit de bron.
Zodra de agent is gebouwd, is het tijd om de agent uit te voeren . Breng nu de wijzigingen aan die nodig zijn om de agent op te nemen in uw installatiekopieën. Bekijk hoe u de Device Update Agent kunt wijzigen voor hulp.
Guide voor probleemoplossing
Als u problemen ondervindt, raadpleegt u de handleiding voor het oplossen van problemen met Device Update for IoT Hub om mogelijke problemen op te heffen en de benodigde informatie te verzamelen die microsoft moet verstrekken.
Volgende stappen
U kunt de volgende zelfstudies gebruiken voor een eenvoudige demonstratie van Device Update voor IoT Hub:
Update van installatiekopie: Aan de slag met Raspberry Pi 3 B+ Reference Yocto Image uitbreidbaar via open source om uw eigen installatiekopieën voor andere architectuur te bouwen, indien nodig.
Pakketupdate: Aan de slag met Ubuntu Server 18.04 x64 Package Agent
Proxy-update: Aan de slag met de binaire agent van Device Update voor downstreamapparaten
Aan de slag met Ubuntu (18.04 x64) Simulator Reference Agent
Zelfstudie over apparaatupdate voor Azure IoT Hub voor Azure-Realtime-besturingssysteem