Betreiben Sie eine Flotte von MiroxOS-Edge-Nodes als einen einzigen, selbstheilenden Cluster in Ihrer Anlage, wobei sich jeder Node durch einen abgesicherten Zustandsautomaten bewegt, sodass ein Gerät nie in einem ungültigen oder halb konfigurierten Zustand enden kann.
Den Aufbau eines Edge-Clusters bildet ein koordiniertes Zusammenspiel aus Aktionen, die Sie auf dem Gerät ausführen, und Aktionen, die Mirox-Mitarbeiter in der Cloud durchführen. Jeder Node durchläuft einen strikten Zustandsautomaten, und jeder Übergang prüft zunächst seine Voraussetzungen — sodass Sie beispielsweise einen Node nicht aus einem Park herauslösen können, während er noch einen aktiven Cluster bedient. Wenn ein Gerät gegenüber der Cloud zurückfällt (etwa nach einer erzwungenen Bereinigung, während es offline war), gleicht ein einziger Sync-Befehl es wieder ab.
Legende:
- Durchgezogene Pfeile: Normale Übergänge (auf dem Gerät oder durch einen Administrator der Organisation ausgeführt)
- Gestrichelte Pfeile: Erzwungene Übergänge, durchgeführt von Mirox-Mitarbeitern, mit automatischer Bereinigung
- An Park gebunden Edge-Cluster läuft Sync-Punkt
Wenn Mirox-Mitarbeiter die Force-Option verwenden, laufen alle zwischengeschalteten Bereinigungen automatisch ab:
| Erzwungene Aktion | Führt automatisch aus |
|---|
| Gerät löschen (aus CLUSTER_ACTIVE) | Cluster verlassen → Node deinitialisieren → Parkzuweisung aufheben → Organisationszuweisung aufheben → Registrierung aufheben |
| Gerät löschen (aus NODE_INITIALIZED) | Node deinitialisieren → Parkzuweisung aufheben → Organisationszuweisung aufheben → Registrierung aufheben |
| Organisationszuweisung aufheben (aus NODE_INITIALIZED) | Node deinitialisieren → Parkzuweisung aufheben → Organisationszuweisung aufheben |
| Parkzuweisung aufheben (aus NODE_INITIALIZED) | Node deinitialisieren → Parkzuweisung aufheben |
Das Gerät kann mrxcloud sync ausführen, um den aktuellen Cloud-Zustand abzurufen und seine lokale Konfiguration abzugleichen:
- Wenn die Parkzuweisung des Geräts erzwungen aufgehoben wurde → wird die lokale Node-Konfiguration gelöscht
- Wenn die Organisationszuweisung des Geräts erzwungen aufgehoben wurde → wird die lokale Organisationskonfiguration gelöscht
- Wenn das Gerät erzwungen gelöscht wurde → muss sich das Gerät neu registrieren
Legende:
- Durchgezogene Pfeile: Normale Übergänge
- Gestrichelte Pfeile: Erzwungene Übergänge, durchgeführt von Mirox-Mitarbeitern
- Wartet auf Nodes Cluster betriebsbereit
| Zustand | Beschreibung | Nächste zulässige Zustände |
|---|
UNREGISTERED | Gerät ist bei keiner Cloud registriert | REGISTERED |
REGISTERED | Gerät ist bei der Cloud registriert | ASSIGNED_ORG, UNREGISTERED |
ASSIGNED_ORG | Gerät ist einer Organisation zugewiesen | ASSIGNED_PARK, REGISTERED |
ASSIGNED_PARK | Gerät ist einem Park zugewiesen | NODE_INITIALIZED, ASSIGNED_ORG |
NODE_INITIALIZED | Gerät ist als Edge-Node initialisiert | CLUSTER_ACTIVE, ASSIGNED_PARK |
CLUSTER_ACTIVE | Edge-Cluster läuft auf dem Gerät | NODE_INITIALIZED |
| Zustand | Beschreibung |
|---|
NOT_CREATED | Für den Park existiert kein Edge-Cluster |
CREATED | Edge-Cluster erstellt, wartet auf Nodes |
ACTIVE | Mindestens ein Node ist beigetreten |
| Schritt | Aktion | Akteur | Werkzeug | Voraussetzung |
|---|
| 1 | Gerät registrieren | Gerät | mrxcloud register | - |
| 2 | Einer Organisation zuweisen | Mirox-Mitarbeiter | Cloud | Schritt 1 |
| 3 | Einem Park zuweisen | Administrator der Organisation | Cloud | Schritt 2 |
| 4 | Edge-Cluster erstellen | Mirox-Mitarbeiter | Cloud | Schritt 3 (Park existiert) |
| 5 | Node initialisieren | Gerät | mrxcloud node init | Schritte 3 + 4 |
| 6 | Cluster initialisieren | Gerät | mrxnode init | Schritt 5 |
| 7 | Workloads bereitstellen | Gerät | mrxnode bootstrap | Schritt 6 |
| Schritt | Aktion | Akteur | Werkzeug | Voraussetzung |
|---|
| 7 | Workloads stoppen | Gerät | mrxnode teardown | - |
| 6 | Cluster verlassen | Gerät | mrxnode leave | Schritt 7 |
| 5 | Node deinitialisieren | Gerät | mrxcloud node deinit | Schritt 6 |
| 4 | Edge-Cluster löschen | Mirox-Mitarbeiter | Cloud | Keine aktiven Nodes |
| 3 | Parkzuweisung aufheben | Administrator der Organisation | Cloud | Schritt 5 (Node deinitialisiert) |
| 2 | Organisationszuweisung aufheben | Mirox-Mitarbeiter | Cloud | Schritt 3 |
| 1 | Geräteregistrierung aufheben | Gerät | mrxcloud unregister | Schritt 2 |
Wenn ein Gerät als Edge-Node initialisiert wird (Schritt 5), wird das Gerät an den Park gesperrt:
| Aktion | Erlaubt wenn | Blockiert wenn |
|---|
| Parkzuweisung des Geräts aufheben | Node NICHT initialisiert | Node initialisiert |
| Organisationszuweisung des Geräts aufheben | Gerät NICHT einem Park zugewiesen | Gerät einem Park zugewiesen |
| Edge-Cluster löschen | Keine Nodes initialisiert | Beliebiger Node initialisiert |
Jede Aktion wird abgelehnt, solange eine Sperre aktiv ist, es sei denn, sie wird mit dem force-Flag ausgeführt — in diesem Fall führt die Plattform jede zwischengeschaltete Bereinigung für Sie durch:
| Aktion | Ohne Force | Mit Force |
|---|
| Parkzuweisung des Geräts aufheben | Abgelehnt, solange das Gerät ein initialisierter Node ist | Automatische Node-Deinitialisierung, dann Zuweisung aufheben |
| Organisationszuweisung des Geräts aufheben | Abgelehnt, solange das Gerät einem Park zugewiesen ist | Automatisches Aufheben der Parkzuweisung (und Node-Deinitialisierung, falls nötig) |
| Gerät löschen | Abgelehnt, solange das Gerät noch Zuweisungen hat | Automatische vollständige Bereinigungskette |
| Edge-Cluster löschen | Abgelehnt, solange Nodes initialisiert sind | Automatische Deinitialisierung aller Nodes, dann löschen |
Node initialisieren (mrxcloud node init) | Erfordert, dass das Gerät einem Park mit Edge-Cluster zugewiesen ist | - |
Cluster verlassen (mrxcloud node deinit) | Erfordert, dass das Gerät aktuell eine Node-Nummer besitzt | - |
| Befehl | Beschreibung |
|---|
mrxcloud register <domain> | Das Gerät bei der Cloud registrieren |
mrxcloud unregister | Die Geräteregistrierung aufheben |
mrxcloud sync | Den aktuellen Cloud-Zustand abrufen und abgleichen |
mrxcloud node init | Das Gerät als Edge-Node initialisieren |
mrxcloud node deinit | Den Node aus dem Cluster deinitialisieren |
mrxcloud node info | Die Node-Konfiguration des Geräts anzeigen |
| Befehl | Beschreibung |
|---|
mrxnode init | Den Edge-Cluster starten (erster Node) oder einem bestehenden beitreten |
mrxnode leave | Den Edge-Cluster verlassen |
mrxnode bootstrap | Die Workloads der Anlage auf dem Cluster bereitstellen |
mrxnode teardown | Die bereitgestellten Workloads stoppen und entfernen |
mrxnode check | Den Cluster-Status prüfen |
Diese Schritte werden in der Cloud statt auf dem Gerät durchgeführt. Das Zuweisen eines Geräts zu einem Park und dessen Verwaltung innerhalb des Parks steht den Administratoren Ihrer Organisation zur Verfügung; das Registrieren oder Zuweisen eines Geräts zu einer Organisation sowie das Erstellen oder Löschen des Edge-Clusters selbst werden von Mirox-Mitarbeitern durchgeführt.
| Aktion | Durchgeführt von | Mit Force |
|---|
| Gerät einer Organisation zuweisen | Mirox-Mitarbeiter | - |
| Organisationszuweisung des Geräts aufheben | Mirox-Mitarbeiter | Automatisches Aufheben der Parkzuweisung + Node-Deinitialisierung |
| Gerät löschen | Mirox-Mitarbeiter | Automatische vollständige Bereinigungskette |
| Gerät einem Park zuweisen / Zuweisung aufheben | Administrator der Organisation | Automatische Node-Deinitialisierung beim Aufheben der Zuweisung |
| Edge-Cluster für einen Park erstellen | Mirox-Mitarbeiter | - |
| Edge-Cluster löschen | Mirox-Mitarbeiter | Automatische Deinitialisierung aller Nodes |
mrxcloud status
mrxcloud node info
mrxnode check
mrxcloud node info meldet die aktuelle Node-Konfiguration des Geräts:
| Indikator | Bedeutung |
|---|
edge_location | Park-UID, die dieses Gerät als Node bedient |
edge_node_number | Zugewiesene Node-Nummer (1, 2, 3 ...) |
private_ip | Private Netzwerk-IP des Nodes innerhalb des Clusters |
token_to_join | Cluster-Beitritts-Token, das von zusätzlichen Nodes verwendet wird |
| Fehler | Ursache | Lösung |
|---|
| "Device is not assigned to a park" | Schritt 3 nicht abgeschlossen | Das Gerät in der Cloud einem Park zuweisen |
| "No edge cluster exists for park" | Schritt 4 nicht abgeschlossen | Den Edge-Cluster in der Cloud erstellen lassen |
| "Cannot unassign: device is initialized as edge node" | Schritt 5 abgeschlossen, Sperre aktiv | mrxcloud node deinit ausführen oder die Force-Option verwenden |
| "Cannot delete cluster: active nodes exist" | Nodes noch initialisiert | Alle Nodes deinitialisieren oder die Force-Option verwenden |
| "Cannot unassign from org: device assigned to park" | Gerät noch in einem Park | Zuerst die Parkzuweisung aufheben oder die Force-Option verwenden |
| "State mismatch: device was forcefully modified" | Cloud-Zustand wurde geändert, während das Gerät offline war | mrxcloud sync ausführen, um abzugleichen |
