Esegui una flotta di nodi edge MiroxOS come un unico cluster auto-riparante presso il tuo impianto, con ogni nodo che attraversa una macchina a stati protetta, in modo che un dispositivo non possa mai finire in uno stato non valido o configurato a metà.
L'avvio di un cluster edge è un handshake coordinato tra le azioni che esegui sul dispositivo e quelle che il personale Mirox esegue nel cloud. Ogni nodo avanza attraverso una rigorosa macchina a stati e ogni transizione verifica prima i propri prerequisiti — così non puoi, ad esempio, rimuovere un nodo da un parco mentre sta ancora servendo un cluster attivo. Quando un dispositivo resta indietro rispetto al cloud (ad esempio dopo una pulizia forzata mentre era offline), un singolo comando di sincronizzazione lo riconcilia.
Legenda:
- Frecce continue: transizioni normali (eseguite sul dispositivo o da un amministratore dell'organizzazione)
- Frecce tratteggiate: transizioni forzate eseguite dal personale Mirox, con pulizia automatica
- Bloccato al parco Cluster edge in esecuzione Punto di sincronizzazione
Quando il personale Mirox utilizza l'opzione di forzatura, tutte le pulizie intermedie vengono eseguite automaticamente:
| Azione forzata | Esegue automaticamente |
|---|
| Elimina dispositivo (da CLUSTER_ACTIVE) | abbandona cluster → deinizializza nodo → annulla assegnazione parco → annulla assegnazione org → annulla registrazione |
| Elimina dispositivo (da NODE_INITIALIZED) | deinizializza nodo → annulla assegnazione parco → annulla assegnazione org → annulla registrazione |
| Annulla assegnazione dall'org (da NODE_INITIALIZED) | deinizializza nodo → annulla assegnazione parco → annulla assegnazione org |
| Annulla assegnazione dal parco (da NODE_INITIALIZED) | deinizializza nodo → annulla assegnazione parco |
Il dispositivo può eseguire mrxcloud sync per recuperare lo stato attuale del cloud e riconciliare la propria configurazione locale:
- Se il dispositivo è stato forzatamente rimosso dal parco → la configurazione locale del nodo viene cancellata
- Se il dispositivo è stato forzatamente rimosso dall'organizzazione → la configurazione locale dell'org viene cancellata
- Se il dispositivo è stato forzatamente eliminato → il dispositivo deve registrarsi nuovamente
Legenda:
- Frecce continue: transizioni normali
- Frecce tratteggiate: transizioni forzate eseguite dal personale Mirox
- In attesa dei nodi Cluster operativo
| Stato | Descrizione | Stati successivi consentiti |
|---|
UNREGISTERED | Il dispositivo non è registrato presso alcun cloud | REGISTERED |
REGISTERED | Il dispositivo è registrato presso il cloud | ASSIGNED_ORG, UNREGISTERED |
ASSIGNED_ORG | Il dispositivo è assegnato a un'organizzazione | ASSIGNED_PARK, REGISTERED |
ASSIGNED_PARK | Il dispositivo è assegnato a un parco | NODE_INITIALIZED, ASSIGNED_ORG |
NODE_INITIALIZED | Il dispositivo è inizializzato come nodo edge | CLUSTER_ACTIVE, ASSIGNED_PARK |
CLUSTER_ACTIVE | Il cluster edge è in esecuzione sul dispositivo | NODE_INITIALIZED |
| Stato | Descrizione |
|---|
NOT_CREATED | Non esiste alcun cluster edge per il parco |
CREATED | Cluster edge creato, in attesa dei nodi |
ACTIVE | Almeno un nodo si è unito |
| Fase | Azione | Attore | Strumento | Prerequisito |
|---|
| 1 | Registra dispositivo | Dispositivo | mrxcloud register | - |
| 2 | Assegna all'organizzazione | Personale Mirox | Cloud | Fase 1 |
| 3 | Assegna al parco | Amministratore dell'organizzazione | Cloud | Fase 2 |
| 4 | Crea cluster edge | Personale Mirox | Cloud | Fase 3 (il parco esiste) |
| 5 | Inizializza nodo | Dispositivo | mrxcloud node init | Fasi 3 + 4 |
| 6 | Inizializza cluster | Dispositivo | mrxnode init | Fase 5 |
| 7 | Distribuisci i carichi di lavoro | Dispositivo | mrxnode bootstrap | Fase 6 |
| Fase | Azione | Attore | Strumento | Prerequisito |
|---|
| 7 | Arresta i carichi di lavoro | Dispositivo | mrxnode teardown | - |
| 6 | Abbandona il cluster | Dispositivo | mrxnode leave | Fase 7 |
| 5 | Deinizializza nodo | Dispositivo | mrxcloud node deinit | Fase 6 |
| 4 | Elimina cluster edge | Personale Mirox | Cloud | Nessun nodo attivo |
| 3 | Annulla assegnazione dal parco | Amministratore dell'organizzazione | Cloud | Fase 5 (nodo deinizializzato) |
| 2 | Annulla assegnazione dall'org | Personale Mirox | Cloud | Fase 3 |
| 1 | Annulla registrazione dispositivo | Dispositivo | mrxcloud unregister | Fase 2 |
Quando un dispositivo viene inizializzato come nodo edge (Fase 5), il dispositivo viene bloccato al parco:
| Azione | Consentita quando | Bloccata quando |
|---|
| Annulla assegnazione dispositivo dal parco | Nodo NON inizializzato | Nodo inizializzato |
| Annulla assegnazione dispositivo dall'org | Dispositivo NON assegnato al parco | Dispositivo assegnato al parco |
| Elimina cluster edge | Nessun nodo inizializzato | Qualsiasi nodo inizializzato |
Ogni azione viene rifiutata mentre un blocco è attivo, a meno che non venga eseguita con il flag force — nel qual caso la piattaforma esegue per te ogni pulizia intermedia:
| Azione | Senza Force | Con Force |
|---|
| Annulla assegnazione dispositivo dal parco | Rifiutata mentre il dispositivo è un nodo inizializzato | Deinizializzazione automatica del nodo, poi annullamento assegnazione |
| Annulla assegnazione dispositivo dall'organizzazione | Rifiutata mentre il dispositivo è assegnato a un parco | Annullamento automatico assegnazione parco (e deinizializzazione nodo se necessario) |
| Elimina dispositivo | Rifiutata mentre il dispositivo ha qualsiasi assegnazione | Catena di pulizia completa automatica |
| Elimina cluster edge | Rifiutata mentre qualsiasi nodo è inizializzato | Deinizializzazione automatica di tutti i nodi, poi eliminazione |
Inizializza nodo (mrxcloud node init) | Richiede che il dispositivo sia assegnato a un parco con un cluster edge | - |
Abbandona cluster (mrxcloud node deinit) | Richiede che il dispositivo detenga attualmente un numero di nodo | - |
| Comando | Descrizione |
|---|
mrxcloud register <domain> | Registra il dispositivo presso il cloud |
mrxcloud unregister | Annulla la registrazione del dispositivo |
mrxcloud sync | Recupera e riconcilia lo stato attuale del cloud |
mrxcloud node init | Inizializza il dispositivo come nodo edge |
mrxcloud node deinit | Deinizializza il nodo dal cluster |
mrxcloud node info | Mostra la configurazione del nodo del dispositivo |
| Comando | Descrizione |
|---|
mrxnode init | Avvia il cluster edge (primo nodo) o unisciti a uno esistente |
mrxnode leave | Abbandona il cluster edge |
mrxnode bootstrap | Distribuisci i carichi di lavoro dell'impianto sul cluster |
mrxnode teardown | Arresta e rimuovi i carichi di lavoro distribuiti |
mrxnode check | Controlla lo stato del cluster |
Queste fasi vengono eseguite nel cloud anziché sul dispositivo. L'assegnazione di un dispositivo a un parco e la sua gestione all'interno del parco sono disponibili per gli amministratori della tua organizzazione; la registrazione o l'assegnazione di un dispositivo a un'organizzazione, e la creazione o l'eliminazione del cluster edge stesso, vengono eseguite dal personale Mirox.
| Azione | Eseguita da | Con Force |
|---|
| Assegna dispositivo all'organizzazione | Personale Mirox | - |
| Annulla assegnazione dispositivo dall'organizzazione | Personale Mirox | Annullamento automatico assegnazione parco + deinizializzazione nodo |
| Elimina dispositivo | Personale Mirox | Catena di pulizia completa automatica |
| Assegna / annulla assegnazione dispositivo a un parco | Amministratore dell'organizzazione | Deinizializzazione automatica del nodo all'annullamento assegnazione |
| Crea cluster edge per un parco | Personale Mirox | - |
| Elimina cluster edge | Personale Mirox | Deinizializzazione automatica di tutti i nodi |
mrxcloud status
mrxcloud node info
mrxnode check
mrxcloud node info riporta la configurazione attuale del nodo del dispositivo:
| Indicatore | Significato |
|---|
edge_location | UID del parco che questo dispositivo serve come nodo |
edge_node_number | Numero di nodo assegnato (1, 2, 3...) |
private_ip | IP di rete privata del nodo all'interno del cluster |
token_to_join | Token di adesione al cluster usato dai nodi aggiuntivi |
| Errore | Causa | Risoluzione |
|---|
| "Device is not assigned to a park" | Fase 3 non completata | Assegna il dispositivo a un parco nel cloud |
| "No edge cluster exists for park" | Fase 4 non completata | Fai creare il cluster edge nel cloud |
| "Cannot unassign: device is initialized as edge node" | Fase 5 completata, blocco attivo | Esegui mrxcloud node deinit, oppure usa l'opzione force |
| "Cannot delete cluster: active nodes exist" | Nodi ancora inizializzati | Deinizializza tutti i nodi, oppure usa l'opzione force |
| "Cannot unassign from org: device assigned to park" | Dispositivo ancora nel parco | Annulla prima l'assegnazione dal parco, oppure usa l'opzione force |
| "State mismatch: device was forcefully modified" | Lo stato del cloud è cambiato mentre il dispositivo era offline | Esegui mrxcloud sync per riconciliare |
