mrxnode Übersicht

Ihr mrxnode ist ein Edge-Gerät, das Hardware vor Ort mit der Mirox-Plattform verbindet. Diese Anleitung führt Sie durch den Zugriff auf das Gerät, die Registrierung in der Cloud, die Aktivierung von Anwendungen und den Aufbau eines Edge-Clusters.

Geräteeinrichtung

Verbindung per SSH

Um auf Ihr mrxnode-Gerät zuzugreifen, verbinden Sie sich per SSH mit der IP-Adresse des Geräts.

ssh appuser@<device-ip>

Anmeldedaten:

Benutzername	Passwort	Verwendung
`appuser`	`mirox` (nicht registriert) / Geräte-UID (registriert)	Kundenzugang
`mrxuser`	Geräte-Token	Systemadministrator-Zugang

Passwortänderung

Sobald das Gerät bei einer Mirox-Plattform registriert ist, wird das Standardpasswort von appuser aus Sicherheitsgründen automatisch durch die eindeutige UID des Geräts ersetzt.

Erste Anmeldung

Wenn Sie sich mit einem neuen oder nicht registrierten Gerät verbinden, sehen Sie folgendes Banner:

  ███╗   ███╗██╗██████╗  ██████╗ ██╗  ██╗    ██████╗ ███████╗
  ████╗ ████║██║██╔══██╗██╔═══██╗╚██╗██╔╝   ██╔═══██╗██╔════╝
  ██╔████╔██║██║██████╔╝██║   ██║ ╚███╔╝    ██║   ██║███████╗
  ██║╚██╔╝██║██║██╔══██╗██║   ██║ ██╔██╗    ██║   ██║╚════██║
  ██║ ╚═╝ ██║██║██║  ██║╚██████╔╝██╔╝ ██╗   ╚██████╔╝███████║
  ╚═╝     ╚═╝╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝    ╚═════╝ ╚══════╝

Welcome to mrxnode - an Edge-Node for the Mirox Platform

==========================================
    CLOUD REGISTRATION REQUIRED
==========================================

This device must be registered before use.

To register:
  mrxcloud register <service>.<domain>

Example:
  mrxcloud register myservice.mirox.io

After registration, reboot the device.
==========================================

Gerät registrieren

Recovery-Modus erforderlich

Die Geräteregistrierung ist nur möglich, wenn das Gerät im Recovery-Modus gestartet wurde. Neue Geräte starten standardmäßig im Recovery-Modus.

Gerät erneut registrieren

Wenn das Gerät bereits bei einer Plattform registriert ist, müssen Sie es zuerst mit mrxcloud unregister abmelden.

Wenn das Gerät zuvor registriert war, aber nicht ordnungsgemäß von der Plattform abgemeldet wurde (z. B. Gerät wurde zurückgesetzt), schlägt der Registrierungsbefehl fehl. In diesem Fall müssen Sie das Gerät zuerst von der Plattform löschen, um die Registrierung zu löschen, bevor Sie es erneut registrieren können.

Um Ihr Gerät bei der Mirox SaaS-Plattform zu registrieren:

mrxcloud register service.mirox.io

Eine vollständige Liste der mrxcloud-Befehle finden Sie im Befehls-Cheatsheet.

Nach erfolgreicher Registrierung wechseln Sie zum Haupt-System-Slot und starten neu:

mrxos switch A
sudo reboot

Das Gerät startet nun in Slot A mit der registrierten Konfiguration.

Anwendungseinrichtung

Nach der Registrierung aktivieren Sie die Generic Relay-Anwendung zur Steuerung der HAT-Hardware:

sudo mrxhat activate generic-relay

Überprüfen Sie den Aktivierungsstatus:

sudo mrxhat status

Eine vollständige Liste der mrxhat-Befehle finden Sie im Befehls-Cheatsheet.

Edge-Cluster-Einrichtung

Um einen K3s-Cluster auf Ihren mrxnode-Geräten auszuführen, ist eine zusätzliche Einrichtung erforderlich.

Voraussetzungen (SaaS)

Bevor ein Gerät als Edge-Node initialisiert werden kann, führen Sie folgende Schritte im SaaS durch:

Gerät registrieren – Das Gerät muss bei der Cloud registriert sein
Gerät einem Park zuweisen – Das Gerät muss einem Park zugewiesen werden
Edge-Cluster erstellen – Für den Park muss ein Edge-Cluster angelegt werden

Schritt 1: Node initialisieren (Recovery-Modus)

Initialisieren Sie das Gerät im Recovery-Modus als Edge-Node:

sudo mrxcloud node init

Das Gerät erhält automatisch:

Die Park-Zuweisung aus dem SaaS
Eine eindeutige Edge-Node-Nummer

Schritt 2: K3s-Cluster starten (Normal-Modus)

Initialisieren Sie nach dem Neustart in das normale System den Cluster:

sudo mrxnode init

Node 1 erstellt einen neuen Cluster. Weitere Nodes treten dem bestehenden Cluster bei.

Schritt 3: FluxCD bootstrappen

Richten Sie nach erfolgreicher Cluster-Initialisierung FluxCD ein:

sudo mrxnode bootstrap

FluxCD synchronisiert Konfigurationen automatisch aus der OCI-Registry.

Status prüfen

# Cloud-Verbindung und Registrierung prüfen
sudo mrxcloud status

# Node-Konfiguration anzeigen
sudo mrxcloud node info

# K3s- und FluxCD-Status prüfen
sudo mrxnode check

# FluxCD-Sync-Status anzeigen
sudo mrxnode flux-status