Panoramica di mrxnode

Il tuo mrxnode è un dispositivo edge che collega l'hardware in sito alla piattaforma Mirox. Questa guida ti accompagna nell'accesso al dispositivo, nella sua registrazione con il cloud, nell'attivazione delle applicazioni e nella creazione di un cluster edge.

Setup del dispositivo

Connessione via SSH

Per accedere al tuo dispositivo mrxnode, connettiti tramite SSH usando l'indirizzo IP del dispositivo.

ssh appuser@<device-ip>

Credenziali di login:

Username	Password	Scopo
`appuser`	`mirox` (non registrato) / UID del dispositivo (registrato)	Accesso cliente
`mrxuser`	Token del dispositivo	Accesso amministratore di sistema

Cambio password

Una volta che il dispositivo è registrato con una piattaforma Mirox, la password predefinita di appuser viene sostituita automaticamente con l'UID univoco del dispositivo per sicurezza.

Quando ti connetti a un dispositivo nuovo o non registrato, vedrai il seguente 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.
==========================================

Registrazione del dispositivo

Modalità Recovery richiesta

La registrazione del dispositivo è possibile solo quando si è avviati in modalità recovery. I dispositivi nuovi si avviano in recovery per impostazione predefinita.

Registrare nuovamente un dispositivo

Se il dispositivo è già registrato a una piattaforma, devi prima deregistrarlo usando mrxcloud unregister.

Se il dispositivo è stato registrato in precedenza ma non è stato deregistrato correttamente dalla piattaforma (per esempio perché è stato resettato), il comando di registrazione fallirà. In questo caso devi prima eliminare il dispositivo dalla piattaforma per cancellarne la registrazione, e poi registrarlo di nuovo.

Per registrare il tuo dispositivo con la piattaforma SaaS Mirox:

mrxcloud register service.mirox.io

Per una lista completa dei comandi mrxcloud, consulta il Cheatsheet dei comandi.

Dopo una registrazione riuscita, passa allo slot di sistema principale e riavvia:

mrxos switch A
sudo reboot

Il dispositivo si avvierà ora nello Slot A con la configurazione registrata.

Setup dell'uso dell'applicazione

Dopo la registrazione, attiva l'applicazione Generic Relay per controllare l'hardware HAT:

sudo mrxhat activate generic-relay

Verifica lo stato di attivazione:

sudo mrxhat status

Per una lista completa dei comandi mrxhat, consulta il Cheatsheet dei comandi.

Setup del cluster edge

Per eseguire un cluster K3s sui tuoi dispositivi mrxnode, è richiesto un setup aggiuntivo.

Prerequisiti (SaaS)

Prima di inizializzare un dispositivo come nodo edge, completa questi passaggi nel SaaS:

Registra il dispositivo - Il dispositivo deve essere registrato con il cloud
Assegna il dispositivo a un parco - Il dispositivo deve essere assegnato a un parco
Crea il cluster edge - Un cluster edge deve essere creato per il parco

Passo 1: Inizializza il nodo (modalità Recovery)

In modalità recovery, inizializza il dispositivo come nodo edge:

sudo mrxcloud node init

Il dispositivo riceve automaticamente:

L'assegnazione del parco dal SaaS
Un numero univoco di nodo edge

Passo 2: Avvia il cluster K3s (modalità normale)

Dopo aver riavviato nel sistema normale, inizializza il cluster:

sudo mrxnode init

Il Nodo 1 crea un nuovo cluster. I nodi aggiuntivi si uniscono al cluster esistente.

Passo 3: Bootstrap di FluxCD

Dopo un'inizializzazione del cluster riuscita, configura FluxCD:

sudo mrxnode bootstrap

FluxCD sincronizza automaticamente le configurazioni dal registry OCI.

Verifica dello stato

# Controlla la connessione cloud e la registrazione
sudo mrxcloud status

# Mostra la configurazione del nodo
sudo mrxcloud node info

# Controlla lo stato di K3s e FluxCD
sudo mrxnode check

# Mostra lo stato di sync FluxCD
sudo mrxnode flux-status

Funzionalità correlate

Cheatsheet dei comandi — riferimento completo per mrxcloud, mrxos, mrxnode e mrxhat
Guida pratica — attività di configurazione di rete e disco per il tuo dispositivo
Deployment dei container — distribuisci e gestisci i container sul dispositivo
Risoluzione dei problemi — ripristino tramite pulsante di accensione e correzioni comuni
Orchestrazione del cluster edge — come i dispositivi vengono gestiti come cluster edge dalla piattaforma
Generic Relay — controlla l'hardware relè HAT da un dispositivo registrato