In dieser Schritt-für-Schritt-Anleitung erfahren Sie, wie Sie den OPC Router von inray auf Welotec IoT Edge Devices installieren. Der Einsatz von Edge Computing Gateways bietet sowohl Kosten- als auch Zeitvorteile und ermöglicht das Deployment von Docker Containern auf dem OPC Router. Zu den vorbereitenden Schritten gehören das Einrichten und Verknüpfen des Azure IoT Hubs, das Erstellen des Device Provisioning Service und das Verknüpfen der IoT Edge Devices mit Azure.
Verbindung
Verbindung zum Welotec IoT Edge Device per SSH
Um das Gerät nutzen zu können, stellen Sie eine Verbindung per SSH her. Wir empfehlen hierfür das Programm „PuTTY“. Tragen Sie anschließend im entsprechenden Fenster die IP-Adresse und den Port ein.
- Hostname (oder IP-Adresse): IP-Adresse des Edge-Geräts (standardmäßig 192.168.2.1).
- Port: Port über den das Edge Device angesprochen wird. (Standardmäßig Port 22 für SSH-Zugriff).
- Verbindungstyp: Wählen Sie hier SSH aus.
Wenn die Verbindung erfolgreich war, geben Sie im neu geöffneten Fenster die Anmeldedaten ein.
Die Standard-Anmeldedaten lauten wie folgt:
Benutzer: admin
Passwort: 123456
Nach der ersten Verbindung muss das Passwort geändert werden.
Azure IoT Hub
Erstellen einer Ressource
Um einen Azure IoT Hub einzurichten, ist eine Azure Subscription erforderlich. Anschließend meldest du dich über https://portal.azure.com im Azure Portal an. Wähle anschließend „Ressource erstellen“ aus.
Durch Eingabe in die Suche gelangen Sie zum IoT Hub.
Ein Klick auf „Erstellen“ öffnet die Konfiguration für den IoT Hub.
Grundeinstellungen
Nehmen Sie hier die Grundeinstellungen vor. Wählen Sie hierzu das entsprechende Abonnement und eine Ressourcengruppe aus. Falls noch keine vorhanden ist, können Sie eine erstellen. Klicken Sie hierfür auf „Neues Element erstellen“. Geben Sie anschließend einen Namen für den IoT Hub ein. Wählen Sie abschließend die Region aus.
Netzwerk
Nachdem Sie die Grundeinstellungen vorgenommen haben, klicken Sie auf den Reiter „Netzwerk“.
In diesem Punkt wird die Zugriffsmöglichkeit eingestellt. Wählen Sie hier „Öffentlicher Zugriff“. Wählen Sie „Privater Zugriff“, muss vorher ein virtuelles Netzwerk eingerichtet werden.
Management
Klicken Sie nach der Netzwerkanpassung auf die Registerkarte „Verwaltung“. Hier werden die Tarifoptionen und die Zugangskontrolle ausgewählt.
Wählen Sie einen Tarif aus, der Ihnen passend erscheint. Beachten Sie dabei, dass im Tarif die Freischaltung für IoT Edge Device enthalten ist, welche notwendig ist. Zudem empfiehlt sich die Nutzung des „Defender for IoT“. Beachten Sie außerdem, dass der „IoT Hub Device Provisioning Service“, welcher in Schritt 3 erläutert wird, nur im Tarif S1 verfügbar ist.
Alle anderen Optionen können entweder beibehalten oder individuell für Sie angepasst werden.
Stichworte
Geben Sie die Tags nach Wunsch an.
Prüfen und erstellen
Wenn Sie alle Punkte gesetzt haben, klicken Sie auf „Prüfen + Anlegen“. Eine Übersicht der entsprechenden Optionen erhalten Sie hier.
Wenn alle Einstellungen korrekt sind, kann der IoT Hub erstellt werden. Das Deployment kann einen Moment dauern.
Um nach der Erstellung wieder zur Übersichtsseite zurückzukehren, klicken Sie auf „Ressource wechseln“.
Gerätebereitstellungsdienst
Erstellen des Dienstes
Nach dem Erstellen des IoT Hubs können Sie den Dienst erstellen. Geben Sie dazu in der Suchleiste „Device Provisioning Service“ ein.
Um einen Dienst zu erstellen, klicken Sie entweder auf „Device Provisioning Service erstellen“ oder auf „Erstellen“.
Grundeinstellungen
Auch hier muss die entsprechende Subscription ausgewählt werden. Anschließend kann die Resource Group festgelegt werden. Da bei der Erstellung des Hubs eine solche angelegt wurde, kann diese hier ebenfalls ausgewählt werden. Anschließend kann ein Name für den Service vergeben werden. Als Region kann nur "Europa, West" ausgewählt werden.
Netzwerk
Wählen Sie wie beim Hub „Öffentliches Netzwerk“ aus.
Für „Privates Netzwerk“ können weitere Anpassungen notwendig sein.
Management
Unter „Verwaltung“ können Sie die Kosten pro 1000 Vorgänge einsehen. Hier finden Sie auch den Hinweis, dass der „IoT Hub Device Provisioning Service“ nur im Tarif S1 verfügbar ist.
Stichworte
Geben Sie die Tags nach Wunsch an.
Überblicken und erstellen
Nach dem Einrichten des Dienstes wird die Übersicht angezeigt. Klicken Sie auf „Erstellen“, um den Vorgang abzuschließen.
IoT Hub verknüpfen
Nach Abschluss der Einrichtung gelangst du über „Ressource wechseln“ auf die Übersichtsseite des „Device Provisioning Service“. Um den Service mit dem IoT Hub zu verknüpfen, klickst du links in „Einstellungen“ auf „Verknüpfte IoT Hubs“. Wir empfehlen den ID-Bereich zu kopieren, da dieser zu einem späteren Zeitpunkt nochmal benötigt wird.
Klicken Sie auf „Hinzufügen“, um den IoT Hub im Fenster auszuwählen. Außerdem muss eine Zugriffsrichtlinie festgelegt werden, eine Standardauswahl ist Besitzer.
Wenn Sie den Link nicht sehen, klicken Sie auf „Aktualisieren“.
Anmeldung
Um die Einheit anzumelden, wähle in der Menüleiste links „Anmeldungen verwalten“ aus. Klicke anschließend im Fenster auf „Einzelanmeldung hinzufügen“.
Vom Edge Device werden zwei Parameter benötigt, der „Endorsement Key“ und die „RegistrationID“. Um diese zu erhalten, wählt man sich per SSH in das Gerät ein. Nach dem Einloggen gibt man folgenden Befehl ein: device tpm_get
Dabei wird der „Endorsement Key“ und die „RegistrationID“ ausgegeben. Wir empfehlen die RegistrationID zu kopieren, da diese zu einem späteren Zeitpunkt nochmal benötigt wird.
Anschließend tragen Sie die Daten bei der Registrierung im Azure Portal ein. Achten Sie dabei darauf, dass bei „Mechanismus“ TPM ausgewählt ist. Außerdem muss ein Name für das Gerät gewählt werden. Dieser darf keine Leerzeichen enthalten, da es sonst zu Fehlern kommt. Zudem muss der Button bei IoT Edge Device auf „True“ gesetzt und ein entsprechender IoT Hub ausgewählt werden (sofern mehrere Hubs verknüpft sind). Die restlichen Einstellungen können Sie beliebig vornehmen, oder auf Standard belassen. Sind alle Daten korrekt eingetragen, kann die Registrierung mit einem Klick auf „Speichern“ abgeschlossen werden. Anschließend wird das Gerät in der Liste angezeigt. Aktualisieren Sie es ggf.
- Mechanismus: TPM auswählen.
- Endorsement Key: Geben Sie hier den Endorsement Key ein.
- Registrierungs-ID: Geben Sie die Registrierungs-ID ein.
- IoT Edge-Gerät: Setzen Sie es hier auf „True“.
Einrichtung abschließen
Betriebssystem
Überprüfen Sie nach der Registrierung die Version des Betriebssystems. Wenn das IoT Edge-Gerät nicht über die neueste Version verfügt, empfehlen wir ein Update. Kontaktieren Sie unseren Support, um die neueste Version zu erhalten.
Wenn ein Update installiert wurde, empfehlen wir, das Gerät neu zu starten. Hierzu wird folgender Befehl verwendet: reboot
Hinweis: Die angezeigte Firmware-Version ist nicht die neuste. Die aktuellste Version ist 1.1.0 (Stand 06/2022).
Hostname (optional)
Nach der Überprüfung des Betriebssystems können Sie den Hostnamen des IoT Edge-Gerätes anpassen. Geben Sie hierfür folgenden Befehl ein: device hostname <name>.
Dieses sollte keine Großbuchstaben oder Sonderzeichen enthalten.
Hinweis: Die angezeigte Firmware-Version ist nicht die neuste. Die aktuellste Version ist 1.1.0 (Stand 06/2022).
Verknüpfen von IoT Edge-Geräten mit Azure
Geben Sie den folgenden Befehl ein, um das Gerät mit Azure zu verknüpfen:
Gerät azure_set_tpm <Bereichs-ID von DPS> <Registrierungs-ID>.
Anschließend fügen Sie den kopierten ID-Bereich aus Schritt 3.2 sowie die kopierte Registration ID vom Gerät, die bei der Registrierung vergeben wurde, ein. War die Eingabe erfolgreich, wird ein „OK“ ausgegeben.
Hinweis: Die angezeigte Firmware-Version ist nicht die neuste. Die aktuellste Version ist 1.1.0 (Stand 06/2022).
Prüfen
Prüfen Sie abschließend, ob die Einrichtung und Verknüpfung erfolgreich waren.
Nutzen Sie hierzu den Befehl „iotedge check“.
Zur ersten Initialisierung müssen Sie auf Ihrem Gerät die Module Edge Agent und Edge Hub starten, um weitere Module nutzen zu können. Gehen Sie hierfür auf den zugewiesenen IoT Hub und anschließend in die Übersicht Ihres IoT Edge Gerätes.
Für diese erstmalige Initialisierung des Edge Agent und des Edge Hub Moduls müssen Sie unter „Module festlegen“ den Start des Containers mit „prüfen + erstellen“ bestätigen.
Wenn dies erfolgreich ist, werden beide Module nach kurzer Zeit in Ihrem IoT Hub mit der Meldung „running“ angezeigt.
Sollten während des Tests Fehler auftreten, wenden Sie sich bitte an unseren Support.
OPC-Router
Die Installation des OPC Routers finden Sie hier auf der Webseite unseres Kooperationspartners inray.
