Vue d'ensemble de mrxnode

Votre mrxnode est un appareil edge qui connecte le matériel sur site à la plateforme Mirox. Ce guide vous accompagne dans l'accès à l'appareil, son enregistrement auprès du cloud, l'activation des applications et la création d'un cluster edge.

Configuration de l'appareil

Se connecter via SSH

Pour accéder à votre appareil mrxnode, connectez-vous via SSH en utilisant l'adresse IP de l'appareil.

ssh appuser@<device-ip>

Identifiants de connexion :

Nom d'utilisateurMot de passeObjet
appusermirox (non enregistré) / UID de l'appareil (enregistré)Accès client
mrxuserJeton de l'appareilAccès administrateur système

Changement de mot de passe

Une fois l'appareil enregistré auprès d'une plateforme Mirox, le mot de passe par défaut de appuser est automatiquement remplacé par l'UID unique de l'appareil pour des raisons de sécurité.

Première connexion

Lorsque vous vous connectez à un appareil neuf ou non enregistré, vous verrez la bannière suivante :

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

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.
==========================================

Enregistrement de l'appareil

Mode recovery requis

L'enregistrement de l'appareil n'est possible que lorsqu'il est démarré en mode recovery. Les appareils neufs démarrent en mode recovery par défaut.

Réenregistrer un appareil

Si l'appareil est déjà enregistré auprès d'une plateforme, vous devez d'abord le désenregistrer en utilisant mrxcloud unregister.

Si l'appareil a été précédemment enregistré mais n'a pas été correctement désenregistré de la plateforme (par ex. l'appareil a été réinitialisé), la commande d'enregistrement échouera. Dans ce cas, vous devez d'abord supprimer l'appareil de la plateforme pour effacer son enregistrement avant de le réenregistrer.

Pour enregistrer votre appareil auprès de la plateforme SaaS Mirox :

mrxcloud register service.mirox.io

Pour une liste complète des commandes mrxcloud, voir l'Aide-mémoire des commandes.

Après un enregistrement réussi, basculez vers le slot système principal et redémarrez :

mrxos switch A
sudo reboot

L'appareil démarrera maintenant dans le Slot A avec la configuration enregistrée.

Configuration de l'utilisation de l'application

Après l'enregistrement, activez l'application Generic Relay pour contrôler le matériel HAT :

sudo mrxhat activate generic-relay

Vérifiez le statut d'activation :

sudo mrxhat status

Pour une liste complète des commandes mrxhat, voir l'Aide-mémoire des commandes.

Configuration du cluster edge

Pour exécuter un cluster K3s sur vos appareils mrxnode, une configuration supplémentaire est requise.

Prérequis (SaaS)

Avant d'initialiser un appareil en tant que nœud edge, effectuez ces étapes dans le SaaS :

  1. Enregistrer l'appareil - L'appareil doit être enregistré auprès du cloud
  2. Affecter l'appareil à un parc - L'appareil doit être affecté à un parc
  3. Créer un cluster edge - Un cluster edge doit être créé pour le parc

Étape 1 : Initialiser le nœud (mode recovery)

En mode recovery, initialisez l'appareil en tant que nœud edge :

sudo mrxcloud node init

L'appareil reçoit automatiquement :

  • L'affectation au parc depuis le SaaS
  • Un numéro de nœud edge unique

Étape 2 : Démarrer le cluster K3s (mode normal)

Après le redémarrage dans le système normal, initialisez le cluster :

sudo mrxnode init

Le nœud 1 crée un nouveau cluster. Les nœuds supplémentaires rejoignent le cluster existant.

Étape 3 : Bootstrap FluxCD

Après une initialisation réussie du cluster, configurez FluxCD :

sudo mrxnode bootstrap

FluxCD synchronise automatiquement les configurations depuis le registre OCI.

Vérifier le statut

# Vérifier la connexion cloud et l'enregistrement
sudo mrxcloud status

# Afficher la configuration du nœud
sudo mrxcloud node info

# Vérifier le statut K3s et FluxCD
sudo mrxnode check

# Afficher le statut de synchronisation FluxCD
sudo mrxnode flux-status

Fonctionnalités associées

MIT Licensed | Copyright 2026 Mirox Verwaltungs GmbH