Skip to Content

Installazione

Avviare la tua istanza IronFlock locale di fabbrica richiede pochi minuti. Da un PC industriale nudo a una piattaforma completamente funzionante — pochi passi, nessuna configurazione manuale.

Requisiti

  • Un PC industriale (o una macchina virtuale) con un Linux basato su Debian o Ubuntu con systemd, e accesso a internet durante l’installazione.
  • Architettura ARM64 o AMD64.
  • gpgv o sqv sull’host: lo script di installazione di ironflock lo usa per verificare la firma di IronFlock. Ogni installazione Debian e Ubuntu ne include uno. ironflock stesso verifica ogni release dell’appliance prima di installarla.
  • Storage SSD, preferibilmente NVMe. I dati delle macchine sono conservati in un database di serie temporali, che diventa lento su un disco rigido meccanico.
  • CPU, RAM e storage come nella tabella seguente.
UsoCPURAMStorage
Valutazione e test2 core4 GB64 GB SSD
Pilota con poche macchine4 core8 GB128 GB SSD
Produzione4 core16 GB256–512 GB SSD NVMe

Queste dimensioni presuppongono che sulla macchina giri solo l’appliance. Le app che installi sull’appliance stessa richiedono risorse aggiuntive.

A riposo, senza dati in arrivo dalle macchine, l’appliance e il suo sistema operativo usano circa 2,5 GB di RAM e una piccola parte di un core CPU. Il carico deriva dai dati delle tue macchine: quanti dispositivi inviano dati e con quale frequenza, le trasformazioni e gli allarmi eseguiti su di essi e quante persone usano le dashboard contemporaneamente.

Lo storage cresce con i dati che conservi: lo storico dei dati delle macchine, i file e le immagini delle app nel registry dell’appliance. Per storici lunghi dei dati delle macchine, prevedi più di 500 GB. Mantieni spazio libero: quando restano meno di 3 GB liberi, l’appliance smette di accettare nuovi dati finché non liberi spazio.

L’installazione adatta i database dell’appliance alla RAM e ai core CPU della macchina, durante l’installazione e a ogni aggiornamento. Se in seguito aggiungi RAM o core CPU, o ingrandisci la macchina virtuale, i database li usano dopo il prossimo aggiornamento a una nuova release, oppure subito dopo sudo ironflock appliance install --version <version> con la versione che l’appliance esegue (ironflock status la mostra).

Sincronizzazione oraria (NTP)

Punta l’host dell’appliance a un server orario che riesca davvero a raggiungere prima di installare. L’orologio di sistema non è un dettaglio estetico: la validazione dei certificati TLS, il ricontrollo periodico della licenza, i token di accesso remoto e il timestamp di ogni punto dati prodotto dalle tue macchine dipendono da esso. Un host sfasato di minuti produce errori di certificato, accessi rifiutati e uno storico che non corrisponde più a quanto è accaduto in officina.

In una rete aziendale i server orari pubblici forniti con il sistema operativo sono di norma irraggiungibili, perché l’NTP in uscita sulla porta UDP 123 è bloccato dal firewall. Nulla fallisce in modo evidente: semplicemente l’host non si sincronizza mai e va alla deriva. Chiedi al reparto IT il server orario interno e configuralo sull’host, oppure fai abilitare l’UDP 123 in uscita.

Con systemd-timesyncd (predefinito su Debian e Ubuntu):

sudo mkdir -p /etc/systemd/timesyncd.conf.d sudo tee /etc/systemd/timesyncd.conf.d/corporate.conf > /dev/null <<'EOF' [Time] NTP=ntp.your-company.com EOF sudo systemctl restart systemd-timesyncd timedatectl status

Con chrony:

echo "server ntp.your-company.com iburst" | sudo tee -a /etc/chrony/chrony.conf sudo systemctl restart chrony chronyc sources

timedatectl status deve riportare System clock synchronized: yes prima di installare l’appliance.

Le macchine virtuali vanno alla deriva più in fretta dell’hardware fisico. Se l’appliance gira in una VM, abilita anche la sincronizzazione oraria guest dell’hypervisor, e configura comunque l’NTP dentro il guest.

Passi

  1. Crea un account su ironflock.com.

  2. Genera una Instance Key — nell’interfaccia IronFlock, apri il tuo Profilo → Istanze, scegli il piano più adatto al tuo caso d’uso e crea una nuova Instance Key. Copia la chiave e salvala in un file sull’host dell’Appliance, ad esempio license.txt. Il comando ironflock chiama la Instance Key chiave di licenza: è la stessa chiave.

  3. Installa ironflock sull’host dell’Appliance. Apri un terminale sul tuo PC industriale ed esegui:

    curl -fsSL https://instance-registry.ironflock.com/dl/cli/install.sh | sudo bash

    Così il comando ironflock viene installato come /usr/local/bin/ironflock, dove l’Appliance ne ha bisogno. Installazione dello strumento a riga di comando descrive cosa fa lo script e come verificarlo prima che venga eseguito (Verificare prima lo script di installazione).

  4. Installa l’Appliance:

    # Dietro un proxy aziendale? Consulta la nota qui sotto prima di eseguire questo comando. sudo ironflock appliance install --license-file license.txt

    Il comando scarica la release più recente, la verifica con la chiave di release dell’Appliance di IronFlock, installa Docker se manca e l’agent del dispositivo dell’host stesso, e avvia l’Appliance. Attende che ogni servizio sia integro e che ironflock.com raggiunga l’Appliance, poi mostra il login di amministratore dell’interfaccia web, una sola volta, sul terminale. L’Appliance conserva la Instance Key in /opt/ironflock/license.env, quindi in seguito puoi eliminare license.txt. Se il comando si ferma a metà, esegui di nuovo lo stesso comando: riprende da dove si era fermato.

    Le sue opzioni (HTTPS, il canale di release, un proxy e altro) sono descritte in ironflock appliance install.

    Dietro un proxy aziendale? Se l’Appliance raggiunge internet solo attraverso un proxy HTTP aziendale, devi fornirlo nel comando di installazione affinché il daemon Docker possa scaricare le immagini — altrimenti l’installazione si blocca al passo di login. Consulta Dietro un Proxy Aziendale.

Tutto qui. Una volta terminata l’installazione, la piattaforma IronFlock completa è in esecuzione sull’Appliance e si avvia di nuovo a ogni boot.

Nota: I comandi dell’Appliance sono nuovi nella release 2.1.0 di ironflock. Hanno superato un’esecuzione di test, dall’installazione alla rimozione, su una macchina virtuale Ubuntu 24.04 appena installata (amd64); vedi Comandi dell’Appliance.

Scegliere una Modalità

L’installazione configura l’Appliance in modalità HTTP semplice, che non richiede nulla all’IT aziendale. Per indirizzi https:// fidati — con una CA che l’Appliance genera da sé o con il tuo certificato aziendale — consulta HTTPS e certificati. Se l’Appliance raggiunge internet solo attraverso un proxy HTTP, consulta Dietro un Proxy Aziendale.

Last updated on