PHYSEC SEAL Host Installationsanleitung
Dieses Python-Skript kommuniziert über USB mit SEAL-ATR-Nodes und über einen Uplink (z. B. MQTT) mit dem SIoT-Backend.
Beachten Sie, dass der Host selbst keine SIoT-Sitzung aufbaut, sondern lediglich verschlüsselte Nutzdaten zwischen dem Uplink und dem USB-Anschluss weiterleitet.
Quick-Start
Falls Sie diese Datei als ZIP-Datei erhalten haben, entpacken Sie bitte den gesamten Inhalt in ein Verzeichnis auf dem Zielgerät.
Neben diesem Verzeichnis wurde Ihnen eine config.json zur Verfügung gestellt, die die MQTT-Anmeldedaten sowie die Seriennummern ihrer Nodes enthält.
Für den allgemeinen Gebrauch sollten keine Änderungen an der Konfiguration erforderlich sein, es liegt jedoch auch eine Konfigurationsanleitung bei.
Betreiben Sie nicht mehrere Hosts mit identischer MQTT-Konfiguration, da es sonst zu Konflikten zwischen den MQTT-Clients kommt.
Bei Bedarf werden auf Anfrage zusätzliche Konfigurationen bereitgestellt.
Option 1: Als Docker-Container ausführen
Dazu müssen Docker und Docker Compose installiert sein, siehe https://docs.docker.com/engine/install/.
Für Raspberry Pi OS befolgen Sie bitte die Debian-Anweisungen.
Es wird empfohlen, auch die Schritte nach der Installation durchzuführen (Docker-Gruppe und systemd-Autostart).
Sie können die mitgelieferten Dateien Dockerfile und docker-compose.yml verwenden, um einen Docker-Container zu erstellen und zu starten:
Führen Sie in diesem Verzeichnis den Befehl docker compose up --wait aus.
Anschließend können Sie mit docker compose logs -f auf die Protokolle zugreifen und mit docker compose down den Container beenden.
In der Compose-Datei ist restart: unless-stopped festgelegt, sodass der Container nach einem Neustart automatisch neu gestartet wird, sofern Docker automatisch startet (z.B. systemd autostart).
Der Container bindet die config.json aus dem aktuellen Verzeichnis ein.
Option 2: Als Python-Paket ausführen
Der SEAL-Host kann als Python-Paket installiert werden. Dazu muss Python installiert sein.
Es wird empfohlen, eine virtuelle Umgebung einzurichten.
Führen Sie die Installation mit MQTT-Unterstützung über pip3 install .[mqtt] aus diesem Verzeichnis durch.
Anschließend können Sie das Programm über seal_host config.json ausführen.
Um das Programm im Hintergrund auszuführen, richten Sie einen Dienst ein, für systemd können Sie die Datei resources/seal_host.service anpassen und nutzen.
Option 3: Als Windows-Programm ausführen
Sie können einfach die mitgelieferte Datei seal_host.exe ausführen.
Alternativ können Sie Ihre eigene .exe aus dem Quellcode erstellen, indem Sie build_exe.bat ausführen (für die Erstellung muss Python installiert sein).
Die Konfiguration wird aus der Datei config.json im selben Verzeichnis geladen. Dort wird außerdem eine Datei seal_host.log erstellt.
Hinweis: Die Protokollkonsole verschwindet, wenn ein schwerwiegender Fehler auftritt. Um diesen Fehler anzuzeigen, führen Sie die .exe über die Eingabeaufforderung aus:
- Navigieren Sie im Windows-Datei-Explorer zu
.exe - Klicken Sie oben in die Pfadleiste.
- Ersetzen Sie den Pfad durch
cmd /K seal_host - Drücken Sie die Eingabetaste.
Beachten Sie, dass die Ausführung unter Windows auf diese Weise ausschließlich zu Evaluierungs- und Demonstrationszwecken gedacht ist.