Operatività
Operatività Locale
Se non vuoi mantenere l’Appliance online, puoi sempre usare un browser nella stessa rete locale e navigare all’indirizzo IP o all’hostname dell’Appliance:
http://<appliance-host>Accedi come utente admin:
- Nome utente:
admin - Password: la password admin iniziale generata per il tuo Appliance
ironflock appliance install mostra questa password una sola volta, sul terminale, alla fine dell’installazione. È inoltre salvata come APPLIANCE_ADMIN_PASSWORD in /opt/ironflock/.env sull’host dell’Appliance, un file leggibile solo da root:
sudo grep '^APPLIANCE_ADMIN_PASSWORD=' /opt/ironflock/.envCambia la password dopo il primo accesso.
Hai dimenticato la password admin? Esegui questo comando sull’host dell’Appliance per impostarne una nuova:
sudo ironflock appliance reset-admin-passwordL’Appliance deve essere in esecuzione. Il comando imposta la nuova password e termina ogni sessione attiva dell’admin. Mostra la nuova password una sola volta, e solo su un terminale; senza terminale, o con --json, dice invece dove è salvata la password. Vedi ironflock appliance reset-admin-password.
Appliance meno recenti: un Appliance installato prima che l’installazione generasse la password admin parte con la password
ironflock. Al primo accesso con questa password ti viene chiesto di impostarne una nuova.
UI Web delle App
Quando un’app su un dispositivo connesso espone un’interfaccia web, l’Appliance la rende raggiungibile attraverso il suo tunnel integrato. Pronto all’uso, non richiede nulla dall’IT aziendale — ogni UI di app viene pubblicata su HTTP semplice su una porta assegnata automaticamente dell’indirizzo dell’Appliance (http://<appliance-host>:<port>), e la IronFlock UI mostra il link. L’accesso resta protetto dal login dell’Appliance.
Per URL https:// affidabili su una rete aziendale condivisa — usando un certificato wildcard dalla tua CA o un reverse proxy che termina TLS — vedi UI delle App e HTTPS.
Collegamento degli Account
Crea account utente locali per il tuo team invitandoli via e-mail nelle impostazioni del progetto sull’Appliance. L’e-mail di invito contiene tutto ciò di cui l’invitato ha bisogno:
- Un link di connessione personale — aprendolo su ironflock.com si connette l’account ironflock.com dell’invitato all’Appliance. Se non ha ancora un account ironflock.com, deve prima crearne uno usando l’indirizzo e-mail dell’invito (la connessione viene concessa solo quando i due indirizzi e-mail corrispondono). Una volta connesso, l’Appliance compare nel suo selettore di progetti su ironflock.com e può lavorarci da remoto fin da subito — nessuna chiave manuale, nessuna registrazione locale richiesta.
- Un link di registrazione locale — opzionale: completando la registrazione locale può inoltre accedere direttamente dall’interfaccia dell’Appliance (
http://<appliance-host>).
Alcune cose da sapere:
- Gli utenti locali esistenti non hanno bisogno di un nuovo invito dal proprietario del progetto. Nell’interfaccia dell’Appliance aprono il proprio Profilo e cliccano su Inviami il link di connessione via email nella sezione Connetti a ironflock.com.
- Reinvio: invitare di nuovo lo stesso indirizzo e-mail (o cliccare di nuovo il pulsante nel profilo) genera un nuovo link di connessione. È valido solo il link dell’e-mail più recente.
- Se l’Appliance non può inviare e-mail — ad esempio su una rete aziendale con restrizioni che blocca il relay di posta — il link di connessione viene invece mostrato direttamente nell’interfaccia: chi invita lo copia e lo consegna attraverso un canale qualsiasi. Il link deve essere aperto in un browser con accesso a internet.
- Disconnessione: un utente può rimuovere la connessione in qualsiasi momento su ironflock.com in Profilo → Istanze → Istanze connesse. Riaprendo il link di connessione più recente, la connessione viene ripristinata.
Il proprietario dell’istanza — l’utente che ha creato la Instance Key su ironflock.com — viene connesso automaticamente all’account admin locale dell’istanza; per il proprietario non è necessario alcun invito.
Sincronizzazione delle App dallo Store Online
L’Appliance include un local App Store — un catalogo di app privato e un registro container che serve le app ai dispositivi sulla rete locale. Puoi popolare questo store locale sincronizzando le app dall’IronFlock Store pubblico online, a condizione che l’Appliance disponga di una connessione internet al momento della sincronizzazione. Non è richiesta una connessione internet permanente; una connessione temporanea è sufficiente per scaricare le app di cui hai bisogno.
Prerequisiti
- Un account sulla piattaforma pubblica ironflock.com.
- Il tuo account Appliance è connesso al tuo account ironflock.com (vedi Collegamento degli Account). L’account admin del proprietario dell’istanza viene connesso automaticamente.
Come Funziona la Sincronizzazione delle App
┌────────────────────┐ ┌────────────────────┐
│ Online IronFlock │ ◄──── account ─────► │ Appliance │
│ Store (cloud) │ connection │ local Store │
└────────────────────┘ └────────────────────┘
│ │
apps available to sync button shown
the connected account instead of install- Apri il local App Store — Quando l’Appliance ha una connessione internet attiva, l’App Store mostrerà tutte le app disponibili per il tuo account ironflock.com connesso sulla piattaforma online.
- Sincronizza le app di cui hai bisogno — Invece di un pulsante Install, ogni app mostra un pulsante Sync. Cliccandolo si scarica l’app — incluse le immagini dei container e i metadati — dallo store online allo store locale.
- Aggiungi i dispositivi — Una volta sincronizzata, l’app è completamente disponibile nel tuo store locale e puoi aggiungere dispositivi normalmente, senza necessità di connessione internet.
Flusso di Aggiornamento
Quando una nuova versione di un’app sincronizzata viene pubblicata nello store online, apparirà di nuovo un pulsante Sync per quell’app. Collega l’Appliance a internet per un breve periodo, sincronizza la release aggiornata, quindi distribuiscila ai tuoi dispositivi tramite il normale flusso di aggiornamento delle app.
Questo design ti dà pieno controllo su ciò che entra nella tua rete — nulla viene scaricato automaticamente e la connessione internet è necessaria solo durante la fase di sincronizzazione.
Mittente E-mail Personalizzato (SMTP)
Per impostazione predefinita, tutte le e-mail della piattaforma — verifica account, recupero password, inviti e notifiche di allarme — vengono inoltrate tramite il proxy SMTP cloud di IronFlock e appaiono come [email protected]. Per far apparire le e-mail come inviate dalla tua azienda, puoi configurare l’Appliance affinché utilizzi il tuo server SMTP.
Sull’host dell’Appliance, modifica il file di ambiente dell’Appliance in /opt/ironflock/.env e imposta le seguenti variabili:
SMTP_CONNECTION_URI=smtps://USERNAME:[email protected]:465/
SMTP_FROM_ADDRESS=[email protected]
SMTP_FROM_NAME=Your Company- Usa
smtps://per TLS implicito (in genere porta465), oppuresmtp://con STARTTLS (porta587). - Codifica in URL i caratteri speciali presenti nel nome utente o nella password (es.
@→%40). SMTP_FROM_ADDRESSeSMTP_FROM_NAMEdeterminano ciò che i destinatari vedono nell’intestazione Da di ogni e-mail della piattaforma.
Applica le modifiche riavviando l’Appliance:
sudo ironflock appliance restartDopo il riavvio, tutte le e-mail di autenticazione, le notifiche della piattaforma e le e-mail di allarme vengono inviate tramite il tuo server SMTP con l’indirizzo e il nome del mittente della tua azienda.
Se
SMTP_CONNECTION_URInon è impostato, l’Appliance continua a instradare le e-mail tramite il proxy SMTP cloud di IronFlock autenticato con la tua chiave di licenza — nessuna configurazione aggiuntiva richiesta, ma le e-mail riporteranno il branding IronFlock.
Manutenzione
Per aggiornare il sistema IronFlock sull’Appliance, l’admin può utilizzare il pulsante di aggiornamento nella sezione licenze del proprio profilo ogniqualvolta è disponibile una nuova versione. Sull’host dell’Appliance, lo stesso aggiornamento si esegue con:
sudo ironflock appliance updateL’Appliance necessita di una connessione internet per scaricare l’aggiornamento. IronFlock si riavvia automaticamente al termine dell’aggiornamento.
L’Appliance installa un aggiornamento solo se ha una firma IronFlock valida e, se un aggiornamento fallisce, torna alla versione che eseguiva in precedenza (vedi Aggiornamenti e ironflock appliance update).
Anche il pulsante di aggiornamento esegue l’ironflock in /usr/local/bin sull’host dell’Appliance. Quando una release richiede un ironflock più recente, l’aggiornamento lo installa prima, con le verifiche di ironflock self-update, e prosegue con esso (Un ironflock più recente). Un ironflock della release 2.2.0 o precedente non può farlo: esegui una volta la riga di installazione per portarlo alla release attuale (Dalla 2.2.0 e precedenti).
Gli aggiornamenti del sistema operativo Linux sono a tua responsabilità.
Connessione Cloud
L’Appliance mantiene una connessione in uscita verso ironflock.com. Attraverso di essa lavori sull’istanza da ironflock.com (vedi Accedi alla tua Istanza da ironflock.com), apri da remoto le interfacce utente e i file delle app e avvii dal cloud gli aggiornamenti e l’handover della licenza. Se l’Appliance non deve essere raggiungibile da ironflock.com, disattiva questa connessione.
Finché la connessione cloud è disattivata:
- L’Appliance non è raggiungibile da ironflock.com. L’elenco delle istanze su ironflock.com mostra l’Appliance come Connessione cloud disattivata.
- L’accesso remoto alle interfacce utente e ai file delle app tramite ironflock.com si interrompe.
- Gli aggiornamenti dell’Appliance e l’handover della licenza non possono essere avviati dal cloud. L’admin può comunque aggiornare l’Appliance localmente (vedi Manutenzione).
- I report di utilizzo restano sull’Appliance e vengono inviati non appena la connessione viene riattivata.
- I dispositivi, l’operatività locale, la sincronizzazione delle app dallo Store Online e la convalida della licenza continuano a funzionare.
L’impostazione resta valida anche dopo i riavvii e gli aggiornamenti dell’Appliance.
Attivarla e Disattivarla sull’Appliance
L’admin attiva e disattiva la connessione cloud nella sezione Connessione cloud della sezione licenze del proprio profilo, nell’interfaccia dell’Appliance (http://<appliance-host>). Solo l’account amministratore può modificarla, e solo localmente — non mentre si lavora sull’istanza da ironflock.com.
Disattivarla da ironflock.com
Il proprietario dell’istanza — l’account ironflock.com che ha creato la Instance Key — può disattivare la connessione cloud dal cloud: apri Profilo → Istanze su ironflock.com e clicca su Disattiva la connessione cloud sull’istanza. L’Appliance deve essere online.
Questa operazione non può essere annullata dal cloud. Solo l’admin dell’Appliance può riattivare la connessione, localmente sull’Appliance.
Ciclo di Vita della Licenza
La tua licenza è vincolata a un singolo Appliance fisico. La stessa licenza non può eseguire una seconda istanza IronFlock su hardware diverso contemporaneamente. Per l’operatività quotidiana, l’Appliance funziona offline — dati di produzione, dashboard, gestione delle app e controllo dei dispositivi edge restano tutti localmente sul box.
Quando l’Appliance Necessita di Internet
Una connessione internet è richiesta solo in questi momenti:
- Installazione iniziale e aggiornamenti dell’Appliance — necessaria in ogni caso per scaricare il software dai server di distribuzione IronFlock; la licenza viene attivata come parte dello stesso passaggio.
- Ricontrollo periodico della licenza — dipende dal tuo piano:
- Licenza mensile: una volta ogni 30 giorni.
- Licenza annuale: una volta ogni 365 giorni.
- Licenza perpetua: nessun ricontrollo periodico — internet serve solo all’installazione e in occasione degli aggiornamenti.
- Trasferimento della licenza a nuovo hardware (vedi sotto).
- Servizio AI Multi Agent — solo mentre è attivamente in uso.
Periodo di Grazia e Blocco
Se un ricontrollo periodico non riesce a raggiungere il cloud (interruzione di rete, errore transitorio del cloud), l’Appliance entra in un periodo di grazia di 7 giorni. Durante la grazia, l’Appliance continua a funzionare normalmente e ritenta automaticamente.
Se trascorrono sette giorni interi senza un ricontrollo riuscito, l’Appliance si blocca da solo: la maggior parte delle operazioni viene rifiutata e l’interfaccia mostra la licenza come non valida. Per ripristinare, ristabilisci la connessione internet dell’Appliance e clicca su Riconvalida ora nel pannello licenze del tuo profilo nell’interfaccia dell’Appliance (la vista locale http://<appliance-host>, oppure la tua istanza acceduta tramite ironflock.com).
Trasferire la Licenza su Nuovo Hardware (Handover)
Una licenza è vincolata all’impronta hardware di una singola macchina. Per trasferirla su una macchina diversa, avvii un handover dal tuo profilo cloud IronFlock:
- Apri Profilo → Istanze su ironflock.com.
- Clicca su Reimposta impronta hardware sull’istanza che vuoi trasferire.
L’handover richiede che l’Appliance attualmente vincolato sia online con la sua connessione cloud attiva. Il cloud si riconnette all’Appliance, gli chiede di revocarsi localmente e solo allora cancella l’impronta lato cloud. Questo handshake garantisce che il vecchio Appliance non possa continuare a funzionare mentre un nuovo Appliance si vincola — evitando l’uso doppio accidentale della stessa licenza.
Una volta riuscito lo sblocco:
- Configura il nuovo hardware seguendo i passi di Installazione, utilizzando la stessa instance key.
- Il nuovo Appliance si valida, vincola la propria impronta e diventa il dispositivo attivo.
Quando il Vecchio Hardware è Guasto o Inaccessibile
Se l’Appliance precedentemente vincolato è morto o altrimenti irraggiungibile, l’handshake andrà in timeout e l’interfaccia cloud mostra appliance_unreachable_contact_support. In tal caso, contatta il team IronFlock — possiamo cancellare il vincolo manualmente dopo aver verificato la proprietà.
Suggerimento: avvia l’handover prima di dismettere il vecchio hardware, mentre è ancora online. Il processo è molto più rapido — per te e per il nostro team di supporto — quando il vecchio Appliance è ancora raggiungibile.