Zum Inhalt springen
JelinaJelina DocumentationTechnische Dokumentation
Zur Website

Geräteregistrierung und Verbindung

Die Geräteregistrierung ist Voraussetzung für die Nutzung der Cloud-Funktionen von JelinaOS. Je nach Einsatzumgebung stehen zwei Wege zur Verfügung:

Weg Geeignete Umgebung Vorgehensweise
Cloud-Registrierung Netzwerkverbindung mit JelinaCloud-Anbindung Image einschließlich Konfiguration schreiben; das Gerät registriert sich nach dem Start automatisch
Lizenzregistrierung Ohne Netzwerk / internes Netzwerk / lokale Lizenzierung erforderlich Manuelle Registrierung, Registrierungsserver im lokalen Netzwerk oder Offline-Massenlizenzierung

Geeignet für Bereitstellungen mit Netzwerkverbindung und JelinaCloud-Anbindung. Sobald das Gerät mit dem Netzwerk verbunden ist, registriert es sich automatisch und erscheint gewöhnlich innerhalb von 30 Sekunden online.

  1. Erstellen oder wählen Sie die Flotte, zu der das Gerät gehören soll;
  2. Öffnen Sie die Flotte, wählen Sie „Gerät hinzufügen“, den zur Hardware passenden Gerätetyp und die OS-Version;
  3. Laden Sie das System-Image und die Gerätekonfigurationsdatei herunter. Letztere ist für jedes Gerät eindeutig.

Hinweis: Der gewählte Gerätetyp kann nicht geändert werden. Stellen Sie sicher, dass er zur Hardware passt. Der Gerätetyp sollte dem Standardgerätetyp der Flotte entsprechen; andernfalls kann das Gerät möglicherweise nicht an den Systemupdates der Flotte teilnehmen.

Die genauen Schritte in der Cloud finden Sie in der Anleitung Geräte in JelinaCloud registrieren und anbinden.

Auf dem Gerät: Image schreiben und automatisch registrieren

Abschnitt betitelt „Auf dem Gerät: Image schreiben und automatisch registrieren“
  1. Wählen Sie in JelinaFlasher „System + Konfiguration schreiben“, um das Image und die Konfigurationsdatei auf das Bootmedium zu schreiben;
  2. Starten Sie das Gerät vom Bootmedium und schließen Sie die Systeminstallation ab;
  3. Nach dem Herstellen der Netzwerkverbindung registriert sich das Gerät anhand der integrierten Konfiguration automatisch in JelinaCloud – gewöhnlich innerhalb von 30 Sekunden.

Nach der Registrierung können Sie in der JelinaCloud-Geräteliste überprüfen, ob das Gerät online ist. Auf der Gerätedetailseite sehen Sie den Gerätestatus, laufende Dienste und Protokolle.

Der Registrierungsschlüssel ist nur einmal verwendbar. Wurde ein bereits registriertes Gerät gelöscht, sind für die erneute Registrierung folgende Schritte erforderlich:

  1. Konfigurationsdatei oder System-Image erneut herunterladen;
  2. Betriebssystem erneut aufspielen;
  3. Das Gerät registriert sich erneut und geht online.

Geeignet für Bereitstellungen ohne Verbindung zum öffentlichen Netzwerk oder mit lokaler Lizenzverwaltung. Das Gerät wird über einen Registrierungscode lizenziert und ist nicht auf eine Online-Registrierung in der Cloud angewiesen.

  • Jedes Gerät wird über einen Registrierungscode lizenziert. Der Code ist an die eindeutige Gerätekennung gebunden, um Manipulation und Übertragung auf andere Geräte zu verhindern;
  • Der geräteseitige Registrierungsdienst verwaltet den Registrierungsstatus kontinuierlich und gibt einen Alarm aus, wenn das Gerät längere Zeit nicht registriert ist;
  • Gerätetyp und Seriennummer können nach der Registrierung nicht geändert werden, damit die Verwaltungsgrenzen eindeutig bleiben.

Bei Geräten, deren Image keine Konfiguration enthält, setzen Sie zunächst mit dem Gerätewerkzeug die Seriennummer und starten die Registrierung. Die Seriennummer wird von Advantech bereitgestellt und besteht aus 32 alphanumerischen Zeichen:

Terminal window
jelina-manual-register --check # Registrierungsstatus: 0=registriert / 1=nicht registriert / 2=Registrierung läuft
jelina-manual-register <Seriennummer> # Seriennummer setzen und Registrierung starten

Der Registrierungsstatus kann auch mit dem Gerätestatusbefehl jelina-info --get registration.status abgefragt werden.

Stellen Sie im lokalen Netzwerk einen Registrierungsserver bereit. Das Gerät fordert bei diesem Server die Registrierung an und wird lizenziert. Dies eignet sich für interne Netzwerke und die gleichzeitige Inbetriebnahme vieler Geräte.

In Umgebungen ohne Server ist eine Offline-Lizenzierung möglich:

Methode Beschreibung
Offline-Massenregistrierung Mehrere Geräte mithilfe einer Positivliste offline registrieren
Offline-Signierung Registrierungssignaturen in einer vernetzten Umgebung vorab erzeugen und offline auf die Geräte anwenden

Über die Lizenzregistrierung registrierte Geräte können nach Wiederherstellung der Netzwerkverbindung ihre Lizenzdaten mit JelinaCloud synchronisieren und weiterhin die Cloud-Verwaltungsfunktionen nutzen.

Das Gerät unterstützt einen Offline-Betriebsmodus: Die Cloud-Konfiguration bleibt erhalten, während Netzwerkaktivitäten wie Statusmeldungen und Update-Abfragen ausgesetzt werden. Dies eignet sich bei vorübergehenden Netzunterbrechungen oder für Szenarien mit strikter Isolation. Der Status lässt sich mit einem Gerätebefehl überprüfen:

Terminal window
jelina-offline --state # Status des Offline-Modus anzeigen

Der Wechsel in den Offline-Modus beeinträchtigt die Cloud-Verwaltungsfunktionen. Nehmen Sie ihn nur bei einem konkreten Bedarf vor und stellen Sie sicher, dass Sie wissen, wie Sie den vorherigen Zustand wiederherstellen.

Das Gerät erscheint längere Zeit nicht online? Prüfen Sie die Netzwerkverbindung, ob beim Schreiben des Images die richtige Konfigurationsdatei verwendet wurde und ob der Gerätetyp zur Hardware passt.

Was tun, wenn der falsche Gerätetyp gewählt wurde? Nach der Registrierung kann der Gerätetyp nicht geändert werden. Laden Sie die Konfiguration erneut herunter, schreiben Sie das Image erneut und registrieren Sie das Gerät mit dem richtigen Gerätetyp.

Wie werden Geräte in einer Umgebung ohne Netzwerk registriert? Verwenden Sie die Lizenzregistrierung: Setzen Sie die Seriennummer manuell und schließen Sie die Lizenzierung über einen Registrierungsserver im lokalen Netzwerk oder per Offline-Massenregistrierung ab.