Skip to Content

Installation

Eine eigene, fabriknahe IronFlock-Instanz aufzusetzen dauert nur wenige Minuten. Von einem nackten Industrie-PC zu einer voll lauffähigen Plattform — wenige Schritte, keine manuelle Konfiguration.

Voraussetzungen

  • Ein Industrie-PC (oder eine virtuelle Maschine) mit einem Linux auf Basis von Debian oder Ubuntu mit systemd und Internetzugang während der Installation.
  • Architektur ARM64 oder AMD64.
  • gpgv oder sqv auf dem Host: Das Installationsskript von ironflock prüft damit die Signatur von IronFlock. Jede Debian- und Ubuntu-Installation bringt eines davon mit. ironflock selbst prüft jedes Release der Appliance, bevor es dieses installiert.
  • SSD-Speicher, vorzugsweise NVMe. Maschinendaten liegen in einer Zeitreihendatenbank, die auf einer herkömmlichen Festplatte langsam wird.
  • CPU, RAM und Speicher gemäß der folgenden Tabelle.
EinsatzCPURAMSpeicher
Evaluierung und Tests2 Kerne4 GB64 GB SSD
Pilot mit wenigen Maschinen4 Kerne8 GB128 GB SSD
Produktion4 Kerne16 GB256–512 GB NVMe-SSD

Diese Größen gehen davon aus, dass auf dem Rechner nur die Appliance läuft. Apps, die Sie auf der Appliance selbst installieren, benötigen zusätzliche Ressourcen.

Im Leerlauf, ohne eingehende Maschinendaten, belegen die Appliance und ihr Betriebssystem etwa 2,5 GB RAM und einen kleinen Teil eines CPU-Kerns. Die Last entsteht durch Ihre Maschinendaten: wie viele Geräte wie oft Daten senden, die Transformationen und Alarme, die darauf laufen, und wie viele Personen gleichzeitig mit Dashboards arbeiten.

Der Speicherbedarf wächst mit den Daten, die Sie aufbewahren: der Historie der Maschinendaten, Dateien und den App-Images in der Registry der Appliance. Für lange Historien von Maschinendaten planen Sie mehr als 500 GB ein. Halten Sie Platz frei: Sind weniger als 3 GB frei, nimmt die Appliance keine neuen Daten mehr an, bis Sie Platz schaffen.

Die Installation passt die Datenbanken der Appliance an RAM und CPU-Kerne des Rechners an, bei der Installation und bei jedem Update. Wenn Sie später RAM oder CPU-Kerne ergänzen oder die virtuelle Maschine vergrößern, nutzen die Datenbanken diese nach dem nächsten Update auf ein neues Release, oder sofort nach sudo ironflock appliance install --version <version> mit der Version, mit der die Appliance läuft (ironflock status zeigt sie).

Zeitsynchronisation (NTP)

Richten Sie den Appliance-Host vor der Installation auf einen Zeitserver aus, den er tatsächlich erreicht. Die Systemuhr ist nicht kosmetisch: die Prüfung von TLS-Zertifikaten, die periodische Lizenz-Neuprüfung, Tokens für den Fernzugriff und der Zeitstempel jedes Datenpunkts Ihrer Maschinen hängen davon ab. Ein Host, der um Minuten abweicht, erzeugt Zertifikatsfehler, fehlgeschlagene Anmeldungen und eine Historie, die nicht mehr zu dem passt, was in der Produktion tatsächlich geschehen ist.

In einem Unternehmensnetzwerk sind die öffentlichen Zeitserver, die ein Betriebssystem mitbringt, meist nicht erreichbar, weil ausgehendes NTP auf UDP-Port 123 in der Firewall blockiert ist. Es schlägt nichts hörbar fehl — der Host synchronisiert sich einfach nie und driftet davon. Erfragen Sie den internen Zeitserver bei Ihrer IT-Abteilung und konfigurieren Sie ihn auf dem Host, oder lassen Sie ausgehendes UDP 123 freigeben.

Mit systemd-timesyncd (Standard unter Debian und 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

Mit chrony:

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

timedatectl status muss System clock synchronized: yes melden, bevor Sie die Appliance installieren.

Virtuelle Maschinen driften schneller als physische Hardware. Läuft die Appliance in einer VM, aktivieren Sie zusätzlich die Gast-Zeitsynchronisation des Hypervisors — und konfigurieren Sie NTP trotzdem im Gastsystem.

Schritte

  1. Erstellen Sie ein Konto auf ironflock.com.

  2. Erzeugen Sie einen Instance Key — Öffnen Sie in der IronFlock UI Ihr Profil → Instanzen, wählen Sie den passenden Plan für Ihren Anwendungsfall und erstellen Sie einen neuen Instance Key. Kopieren Sie den Schlüssel und speichern Sie ihn in einer Datei auf Ihrem Appliance-Host, zum Beispiel license.txt. Der Befehl ironflock nennt den Instance Key Lizenzschlüssel: Es ist derselbe Schlüssel.

  3. Installieren Sie ironflock auf Ihrem Appliance-Host. Öffnen Sie ein Terminal auf Ihrem Industrie-PC und führen Sie aus:

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

    Das installiert den Befehl ironflock als /usr/local/bin/ironflock, wo die Appliance ihn braucht. Installation des Befehlszeilenwerkzeugs beschreibt, was das Skript tut und wie Sie es prüfen, bevor es läuft (Das Installationsskript vorher prüfen).

  4. Installieren Sie die Appliance:

    # Hinter einem Unternehmens-Proxy? Lesen Sie den Hinweis unten, bevor Sie dies ausführen. sudo ironflock appliance install --license-file license.txt

    Der Befehl lädt das neueste Release herunter, prüft es gegen den Appliance-Release-Schlüssel von IronFlock, installiert Docker, wenn es fehlt, und den eigenen Geräte-Agenten des Hosts und startet die Appliance. Er wartet, bis jeder Dienst gesund ist und ironflock.com die Appliance erreicht, und zeigt dann die Admin-Anmeldung der Weboberfläche an, einmal, im Terminal. Die Appliance bewahrt den Instance Key in /opt/ironflock/license.env auf, sodass Sie license.txt danach löschen können. Hält der Befehl unterwegs an, führen Sie denselben Befehl erneut aus: Er macht dort weiter, wo er angehalten hat.

    Seine Optionen (HTTPS, der Release-Kanal, ein Proxy und mehr) beschreibt ironflock appliance install.

    Hinter einem Unternehmens-Proxy? Wenn die Appliance das Internet nur über einen Unternehmens-HTTP-Proxy erreicht, müssen Sie ihn beim Installationsbefehl angeben, damit der Docker-Daemon die Images herunterladen kann — andernfalls bricht die Installation beim Login-Schritt ab. Siehe Hinter einem Unternehmens-Proxy.

Das war’s. Sobald die Installation fertig ist, läuft die vollständige IronFlock-Plattform auf der Appliance und startet bei jedem Boot wieder.

Hinweis: Die Appliance-Befehle sind neu in Release 2.1.0 von ironflock. Sie haben einen Testlauf bestanden, von der Installation bis zum Entfernen, auf einer frischen virtuellen Maschine mit Ubuntu 24.04 (amd64); siehe Befehle für die Appliance.

Einen Modus wählen

Die Installation richtet die Appliance im Modus einfaches HTTP ein, der nichts von der Unternehmens-IT benötigt. Für vertrauenswürdige https://-Adressen — mit einer CA, die die Appliance selbst ausstellt, oder mit Ihrem Unternehmenszertifikat — siehe HTTPS & Zertifikate. Erreicht die Appliance das Internet nur über einen HTTP-Proxy, siehe Hinter einem Unternehmens-Proxy.

Last updated on