Geräte verbinden
IronFlock unterstützt mehrere Methoden zur Verbindung von Geräten, abhängig von der Hardware und dem Betriebssystem. Keine Hardware zur Hand? Sie können in wenigen Minuten ein Gerät auf Ihrem Laptop simulieren.
Voraussetzungen
Bevor Sie ein Gerät verbinden, stellen Sie sicher, dass Sie Folgendes haben:
- Ein auf IronFlock erstelltes Projekt
- Einen Geräteeintrag innerhalb dieses Projekts (klicken Sie auf NEUES GERÄT im Bereich Einstellungen -> Geräte des Projekts.)
- Die heruntergeladene Gerätekonfigurationsdatei (
.flock)
.flock-Datei verloren? Sie können sie jederzeit erneut herunterladen: Öffnen Sie das Gerät in der Projekt-Seitenleiste, wechseln Sie zu Gerätewartung und klicken Sie auf Gerätedatei herunterladen. Es ist dieselbe Konfiguration, kein neues Gerät. Sie benötigen die Wartungs-Berechtigung für das Gerät. Siehe Gerätewartung.
Gerät in einem eingeschränkten Unternehmensnetzwerk? Planen Sie die Netzwerkeinrichtung vor der Installation — sie ist der häufigste Grund dafür, dass ein frisch installiertes Gerät offline bleibt:
- Identity-Aware Firewall oder Proxy: Die Regel, die das Gerät zulässt, muss an das Gerät selbst gebunden sein, niemals an einen angemeldeten Benutzer — sonst verliert das Gerät den Netzwerkzugang, sobald die Sitzung dieses Benutzers abläuft. Siehe Identity-Aware Firewalls und Proxys.
- Unternehmens-HTTP-Proxy: Der Agent und Docker müssen ausdrücklich darauf eingestellt werden — siehe Hinter einem Unternehmens-Proxy → Edge-Geräte.
- Verbindung zu einer On-Premises-Appliance: Das Gerät muss die Dienstports der Appliance direkt erreichen — oder, wenn die Appliance HTTPS mit Ihrem Unternehmenszertifikat verwendet, nur Port
443, wobei das Gerät Ihrer Unternehmens-Root-CA vertrauen muss. Siehe Gerätekonnektivität im Appliance-Leitfaden.- Driftende Uhr: Unternehmens-Firewalls blockieren in der Regel die öffentlichen Zeitserver, die ein frisch installiertes Betriebssystem mitbringt, sodass die Geräteuhr unbemerkt driftet — konfigurieren Sie Ihren internen NTP-Server. Siehe Zeitsynchronisation (NTP).
Identity-Aware Firewalls und Proxys
Jedes Edge-Gerät betreibt den IronFlock-Agenten als unbeaufsichtigten Systemdienst. Er startet beim Hochfahren, bleibt rund um die Uhr verbunden und installiert laufend Apps, ruft Images ab und aktualisiert sich selbst — unabhängig davon, ob jemand am Gerät angemeldet ist. Das gilt überall, wo Ihre Plattform läuft: in der IronFlock Cloud, in Ihrer privaten Cloud oder auf einer On-Premises-Appliance.
OT-Netzwerke werden zunehmend durch Identity-Aware Firewalls und Proxys geschützt, die den Zugriff anhand der Verzeichnisidentität statt anhand der Netzwerkadresse gewähren. Ist die Regel, die ein Edge-Gerät zulässt, an den Benutzer gebunden, der daran angemeldet ist, verliert das Gerät den Netzwerkzugang, sobald die Sitzung dieses Benutzers abläuft:
- Bereits offene Verbindungen laufen weiter, das Gerät wird daher weiterhin als online angezeigt.
- Jede neue Verbindung wird still verworfen — App-Installationen, Image-Abrufe, Agent-Updates und Wiederverbindungen scheitern.
- Nach dem nächsten Neustart des Agenten oder des Geräts kann es sich überhaupt nicht mehr verbinden und bleibt offline, bis sich wieder jemand am Gerät anmeldet oder die Regel geändert wird.
Bitten Sie Ihr Netzwerk-Team, die Regel an das Gerät zu binden, niemals an eine Person:
| Gerät | Identität für die Regel |
|---|---|
| Windows-Gerät, das Ihrer Domäne beigetreten ist | Sein Computerkonto — das Computerobjekt oder eine Gruppe wie IronFlock Edge Devices |
| Linux- oder IronFlockOS-Gerät oder Windows außerhalb der Domäne | Ein benanntes Host-Objekt mit reservierter IP-Adresse oder die Identität, die Ihre Netzwerkzugangskontrolle (802.1X oder MAC-Authentifizierung) vergibt |
So setzen Sie das in verbreiteten Produkten um:
- Check Point Identity Awareness: Wählen Sie in der Access Role die Maschine (Computerobjekt oder Gruppe) statt Benutzern aus. Maschinenidentitäten werden durch die eigene Domänenaktivität des Computers aufgefrischt; können sie auf Ihrem Gateway verfallen, verwenden Sie stattdessen ein Netzwerkobjekt.
- Palo Alto Networks User-ID: Computerkonten erzeugen keine Zuordnungen von IP-Adresse zu Benutzer; verwenden Sie daher ein Adressobjekt, ein Tag oder Device-ID.
- Fortinet FSSO und ähnliche verzeichnisbasierte Firewalls: Verwenden Sie ein Adressobjekt für das Gerät oder die dynamische Adresse, die Ihre Netzwerkzugangskontrolle vergibt.
- Zscaler, Prisma Access und andere Cloud-Security-Gateways: Registrieren Sie das Gerätenetz als IoT- oder Server-Standort (eine vertrauenswürdige Quelle), damit der Geräteverkehr anhand des Standorts statt anhand eines Benutzers erkannt wird.
Das ist keine Ausnahme von Ihrer Identitätsrichtlinie — das Gerät wird über die Identität erkannt, die es tatsächlich hat. Wenn Sie eine On-Premises-Appliance betreiben, gilt dasselbe für den Appliance-Host: siehe Netzwerkidentität für IronFlock-Hosts.
So erkennen Sie den Fehler. Ein Gerät, das online bleibt, während App-Installationen, Image-Abrufe oder Agent-Updates mit Timeouts scheitern — und Pings weiterhin gelingen —, deutet auf eine abgelaufene Identitätsregel hin, nicht auf ein Problem am Gerät. Starten Sie weder den Agenten noch das Gerät neu, bevor wieder eine frische Verbindung vom Gerät gelingt: Die noch offene Sitzung ist die einzige, die funktioniert, und sie hält das Gerät bis dahin aus der Ferne verwaltbar.
Erst testen: Ein Gerät auf Ihrem Laptop simulieren
Sie benötigen keine physische Hardware, um IronFlock zu erkunden. Die FlockFlasher App kann den IronFlock-Agenten direkt auf Ihrem Laptop ausführen, sodass Ihr Laptop innerhalb Ihres Projekts ein echtes Gerät verkörpert — perfekt, um Apps und Dashboards zu testen, bevor Sie sie auf echter Hardware ausrollen.
- Installieren Sie Docker Desktop (oder Docker Engine unter Linux) und stellen Sie sicher, dass es läuft.
- Laden Sie die FlockFlasher App für Ihr Betriebssystem herunter und installieren Sie sie.
- Doppelklicken Sie auf die heruntergeladene
.flock-Datei Ihres Geräts — sie öffnet sich in FlockFlasher und das Gerät erscheint in der Liste. (Alternativ öffnen Sie FlockFlasher und fügen die Datei über die +-Schaltfläche hinzu.) - Klicken Sie beim Geräteeintrag auf Gerät Testen (▶). FlockFlasher lädt den IronFlock-Agenten bei der ersten Verwendung automatisch herunter und startet ihn mit Ihrer Gerätekonfiguration.
Ihr Laptop agiert nun innerhalb Ihres IronFlock-Projekts als dieses Gerät: Er erscheint online, und Sie können Apps darauf installieren und ausführen — genau wie auf einem echten Gerät. Die Apps laufen als Docker-Container auf Ihrem Laptop.
Wenn Sie fertig sind, stoppen Sie den Test in FlockFlasher. Sie können dieselbe .flock-Datei später verwenden, um das echte Gerät einzurichten — stellen Sie nur sicher, dass eine bestimmte Gerätekonfiguration immer nur auf einem Rechner gleichzeitig läuft.
Methode 1: SD-Karte flashen
Am besten geeignet für Raspberry Pi und andere ARM-Geräte, die von SD-Karten booten.
- Laden Sie die FlockFlasher App für Ihr Betriebssystem herunter.
- Legen Sie eine SD-Karte (mindestens 16 GB) in Ihren Computer ein.
- Öffnen Sie FlockFlasher und klicken Sie auf die +-Schaltfläche, um die
.flock-Datei zu laden. - Wählen Sie das SD-Karten-Laufwerk (FlockFlasher erkennt externe Laufwerke automatisch).
- Wählen Sie das richtige Image für Ihr Gerät (Raspberry Pi 3/4, Zero usw.).
- Konfigurieren Sie optional WLAN, damit sich das Gerät an seinem Zielort verbinden kann.
- Klicken Sie auf Flash und warten Sie, bis Schreiben, Validierung und Konfiguration abgeschlossen sind.
- Legen Sie die SD-Karte in das Gerät ein und schalten Sie es ein.
Das Gerät sollte innerhalb von 20 Minuten online gehen.
Warnung: Der Flash-Vorgang löscht alle Daten auf dem ausgewählten Laufwerk. FlockFlasher blendet interne Laufwerke standardmäßig aus, aber überprüfen Sie Ihre Auswahl immer doppelt.
Methode 2: USB-Installer für Industrie-PCs
Für AMD64-Geräte mit EFI-Boot (z. B. Siemens SIMATIC Box IPC).
- Stecken Sie einen USB-Stick (mindestens 16 GB) ein und öffnen Sie FlockFlasher.
- Laden Sie die
.flock-Datei und wählen Sie das USB-Laufwerk. - Wählen Sie das Image Industrial PC x86_64 (EFI).
- Klicken Sie auf Flash und warten Sie auf den Abschluss.
- Ändern Sie bei Bedarf die Boot-Reihenfolge im BIOS des Geräts, um vom USB zu booten.
- Stecken Sie den USB-Stick ein und schalten Sie das Gerät ein.
Das Gerät sollte innerhalb von 60 Minuten online gehen.
Über die Befehlszeile flashen
Die IronFlock CLI bereitet die Laufwerke der Methoden 1 und 2 ohne die Desktop-App vor. Sie läuft unter Linux und macOS und schreibt IronFlockOS für Raspberry Pi 4, 400, 5, CM4 und CM5 sowie für PCs und ARM-Maschinen mit UEFI.
- Installieren Sie den Befehl
ironflockauf Ihrem Computer:curl -fsSL https://instance-registry.ironflock.com/dl/cli/install.sh | sudo bash - Stecken Sie die SD-Karte oder den USB-Stick ein und ermitteln Sie den Namen des Laufwerks:
ironflock os drives - Schreiben Sie IronFlockOS und die
.flock-Datei auf das Laufwerk. Ersetzen Sie/dev/sdbdurch Ihr Laufwerk:Für einen Industrie-PC fügen Siesudo ironflock os flash -c mydevice.flock -d /dev/sdb--installerhinzu. Der Stick installiert IronFlockOS dann auf der internen Festplatte des PCs, der von ihm startet:sudo ironflock os flash -c mydevice.flock -d /dev/sdb --installer
Der Befehl lädt das Image für die in der .flock-Datei genannte Hardware herunter und prüft es. Er zeigt, was er schreiben wird, und fragt, bevor er das Laufwerk löscht. Dann beschreibt er das Laufwerk und liest es zurück. Um dem Gerät ein anderes WLAN als das aus der .flock-Datei zu geben, fügen Sie --wifi-ssid und --wifi-password-file hinzu. Alle Optionen finden Sie unter IronFlockOS auf ein Laufwerk schreiben.
Die Maschine läuft bereits mit Linux und lässt sich nicht von einem Stick starten?
ironflock os installersetzt das laufende Linux auf derselben Festplatte durch IronFlockOS, auch auf einer entfernten Maschine über SSH. Alles auf dieser Festplatte geht verloren. Siehe Linux durch IronFlockOS ersetzen.
Methode 3: Benutzerdefinierte Installation
Für Geräte, die ihr bestehendes Linux-Betriebssystem behalten. Ideal für NVIDIA Jetson und spezielle Hardware.
Hinweis: Diese manuelle Installationsmethode ist für echte Produktions-Hardware wie Industrie-PCs, Gateways und Embedded-Geräte gedacht — nicht für Laptops. Wenn Sie IronFlock nur auf Ihrem Laptop ausprobieren möchten, folgen Sie stattdessen Erst testen: Ein Gerät auf Ihrem Laptop simulieren — ganz ohne manuelle Agent-Installation.
Linux / Unix-Geräte
- Verbinden Sie sich per SSH mit dem Gerät.
- Kopieren Sie die
.flock-Datei von Ihrem Computer auf das Gerät:scp mydevice.flock user@device-ip:/home/user/ - Laden Sie den Installer herunter und führen Sie ihn aus:
curl -fsSL https://instance-registry.ironflock.com/dl/cli/install.sh | sudo bash -s -- agent install -c mydevice.flockAuf einer IronFlock-Appliance? Die Befehle sind dieselben.
ironflock agent installnimmt den Geräte-Agenten vom Download-Spiegel der Appliance, den die.flock-Datei nennt, und aus dem Internet, was der Spiegel nicht hat. Das Installationsskript,ironflock, die Pakete der Distribution und Docker kommen weiterhin aus dem Internet, daher braucht das Gerät während der Installation Internetzugang. Danach muss es nur noch die Appliance erreichen (siehe Edge-Geräte). - Beantworten Sie die Fragen des Installers. Wenn er fertig ist, läuft der Agent, und das Gerät erscheint innerhalb einer Minute online in IronFlock. Ein Neustart ist nicht nötig.
Auf dem Gerät muss ein Linux auf Basis von Debian oder Ubuntu mit systemd laufen.
install.sh lädt ironflock, das Befehlszeilenwerkzeug von IronFlock, für die CPU des Geräts herunter. Es prüft die Signatur des Downloads gegen den im Skript eingebetteten IronFlock-Schlüssel, installiert das Werkzeug als /usr/local/bin/ironflock und führt es mit den übergebenen Argumenten aus. Ohne Argumente installiert es nur das Werkzeug; verbinden Sie das Gerät danach mit sudo ironflock agent install -c mydevice.flock.
ironflock agent install prüft zuerst, ob die Installation gelingen kann. Dann installiert es Docker (falls es fehlt) und den Geräte-Agenten und richtet Folgendes ein:
- einen SSH-Benutzer für den Eigentümer des Projekts — Anmeldung nur per Schlüssel (dem Geräteschlüssel) und
sudoohne Passwort; - WLAN aus der
.flock-Datei über NetworkManager; - ein Login-Banner.
Es sagt, was es installieren wird, und fragt, bevor es handelt. Automatische Sicherheitsupdates lässt es unangetastet und startet das Gerät nicht neu, es sei denn, Sie übergeben --reboot. Alles, was es ändert, wird in /opt/ironflock/device-init/installed.json festgehalten, sodass agent remove genau das wieder rückgängig macht:
sudo ironflock agent removeWeitere Optionen von ironflock agent install:
--yes— Standardwerte übernehmen, keine Rückfragen--disable-suspend— verhindert, dass das Gerät in den Ruhezustand geht--reboot— startet das Gerät nach der Installation neu--http-proxy,--https-proxy,--no-proxy,--proxy-password-file— leitet die Installation, Docker und den Agenten über einen Proxy--download-base— lädt von einem anderen Server herunter (siehe Download-Basis)
Um einem installierten Gerät eine andere .flock-Datei zu geben, führen Sie sudo ironflock agent configure -c new.flock aus. Befehle für den Geräte-Agenten beschreibt jeden Befehl und jede Option.
Auf dem Gerät liegt der Agent in /opt/ironflock/device-agent und läuft als systemd-Dienst ironflock-device-agent. Prüfen Sie ihn mit sudo ironflock status oder systemctl status ironflock-device-agent. Lesen Sie sein Log mit sudo ironflock agent logs; es steht auch in journalctl -u ironflock-device-agent und in /var/log/ironflock/device-agent.log. Die Konfiguration ist /opt/ironflock/device-agent/device-config.flock (nur für root lesbar — in /boot gibt es keine Kopie mehr), Docker legt seine Daten in /opt/ironflock/device-agent/docker-apps ab, und die Daten der Apps bleiben in /apps.
Der Agent aktualisiert sich selbst — einen separaten Update-Manager gibt es nicht. Updates sind signiert und werden geprüft, ein fehlgeschlagenes Update wird automatisch zurückgerollt. Sie werden nur beim Start des Agenten eingespielt, wenn ein Benutzer das Update in Studio startet, oder wenn Sie auf dem Gerät sudo ironflock agent update ausführen.
Vor Oktober 2026 installierte Geräte nutzten
/opt/reagentund den Dienstreagent.service. Sobald ein solches Gerät den Agent 1.3.x ausführt, wechselt es von selbst in das oben beschriebene Layout — Docker und die Apps starten dabei einmal neu — und/opt/reagentbleibt als Link bestehen.
Hinter einem Unternehmens-Proxy? Geben Sie auch dem Download des Installers den Proxy mit und ergänzen Sie in Schritt 3 die Argumente um
--http-proxy/--https-proxy, damitironflock agent installDocker und den Agenten für Sie konfiguriert. Den vollständigen Befehl und die Schritte zur Unternehmens-CA finden Sie unter Hinter einem Unternehmens-Proxy.
Von Ihrem Computer aus über SSH installieren
Ist ironflock auf Ihrem eigenen Linux- oder macOS-Computer installiert, verbinden Sie ein Gerät, ohne sich vorher daran anzumelden. --host führt den Befehl über SSH auf dem Gerät aus und nimmt die .flock-Datei mit, sodass nichts zu kopieren ist:
ironflock --host user@device-ip agent install -c mydevice.flockDer SSH-Benutzer muss root sein oder auf dem Gerät sudo verwenden dürfen. --host verwendet das ssh Ihres Computers, mit Ihren Schlüsseln und Ihrer ~/.ssh/config. Es hinterlässt kein ironflock auf dem Gerät; spätere Befehle führen Sie auf dieselbe Weise von Ihrem Computer aus, zum Beispiel ironflock --host user@device-ip status. Siehe Entfernte Maschinen über SSH.
Optional: Installer zuerst prüfen
Wenn Sie das Skript prüfen möchten, bevor es als root läuft, laden Sie es zusammen mit seiner Signatur herunter und prüfen Sie es gegen den IronFlock-Bootstrap-Schlüssel:
curl -fsSLO https://instance-registry.ironflock.com/dl/cli/install.sh
curl -fsSLO https://instance-registry.ironflock.com/dl/cli/install.sh.asc
curl -fsSL https://instance-registry.ironflock.com/dl/cli/ironflock-bootstrap.asc | gpg --import
gpg --verify install.sh.asc install.shgpg muss eine gültige Signatur von IronFlock Bootstrap <[email protected]> mit dem Fingerabdruck F6C9 4D96 CE31 5377 ACA7 C8EA 4990 5433 7321 2788 melden. Führen Sie danach das geprüfte Skript aus:
sudo bash install.sh agent install -c mydevice.flockWindows-Geräte
-
Installieren Sie Docker Desktop auf dem Gerät und aktivieren Sie in den Docker-Desktop-Einstellungen Start Docker Desktop when you sign in. Richten Sie für unbeaufsichtigte Geräte zusätzlich die automatische Windows-Anmeldung ein, damit Docker nach einem Neustart ohne Anmeldung verfügbar ist.
-
Laden Sie device-agent.exe auf dem Gerät herunter. Ihr Browser speichert die Datei im Ordner Downloads.
-
Kopieren Sie die
.flock-Datei auf das Gerät, und zwar in denselben Ordner Downloads. -
Öffnen Sie PowerShell mit Administratorrechten: Öffnen Sie das Start-Menü, tippen Sie
PowerShell, wählen Sie Als Administrator ausführen und bestätigen Sie die Abfrage der Benutzerkontensteuerung mit Ja. Der Fenstertitel muss mit Administrator: beginnen. In einem normalen PowerShell-Fenster bricht die Installation mit der Meldung this command must be run from an elevated (Administrator) prompt ab. -
Eine Administrator-PowerShell startet in
C:\Windows\System32. Wechseln Sie in Ihren Downloads-Ordner und prüfen Sie, ob beide Dateien dort liegen:cd $env:USERPROFILE\Downloads dir device-agent.exe, *.flock -
Installieren und starten Sie den Agenten als Windows-Dienst:
.\device-agent.exe service install -config .\myaccount_myproject_mydevice.flockErsetzen Sie
myaccount_myproject_mydevice.flockdurch den Namen Ihrer Datei — Studio benennt sie nach dem Projektbesitzer, dem Projekt und dem Gerät. Tippen Sie die ersten Buchstaben des Namens und drücken Sie Tab, um ihn zu vervollständigen. Lassen Sie das.\vordevice-agent.exenicht weg: Nur damit startet PowerShell ein Programm aus dem aktuellen Ordner.Der Dienst
ironflock-device-agentstartet sofort und danach bei jedem Hochfahren, startet nach Fehlern automatisch neu und hält den Agenten aktuell. Mit-noStartwird der Dienst installiert, aber nicht gestartet. Der Installer kopiertdevice-agent.exeund die.flock-Datei in den Agent-Ordner, Sie können beide danach aus Ihrem Downloads-Ordner löschen.
Auf dem Gerät liegt der Agent in %ProgramData%\IronFlock\DeviceAgent — device-agent.exe, die Konfiguration device.flock, das Log device-agent.log und die Daten der Apps unter apps\. Updates sind signiert und werden verifiziert, ein fehlgeschlagenes Update wird automatisch zurückgerollt; angewendet werden sie nur beim Start des Agents oder wenn ein Benutzer das Update in Studio startet.
Agent prüfen und Log lesen
Der Agent-Ordner ist nur für Administratoren lesbar, führen Sie diese Befehle deshalb ebenfalls in einer Administrator-PowerShell aus. Zeigen Sie an, ob der Dienst läuft:
Get-Service ironflock-device-agentStatus muss Running sein. Zeigen Sie die letzten 100 Zeilen des Agent-Logs an und geben Sie neue Zeilen fortlaufend aus, sobald der Agent sie schreibt:
Get-Content "$env:ProgramData\IronFlock\DeviceAgent\device-agent.log" -Tail 100 -WaitMit Strg+C beenden Sie die fortlaufende Ausgabe. Um im Log nur nach Fehlern zu suchen:
Select-String -Path "$env:ProgramData\IronFlock\DeviceAgent\device-agent.log" -Pattern "error" | Select-Object -Last 20Um den Agenten neu zu starten, verwenden Sie seine eigenen Befehle. Das Gerät ist offline, bis der Agent wieder läuft:
& "$env:ProgramData\IronFlock\DeviceAgent\device-agent.exe" service stop
& "$env:ProgramData\IronFlock\DeviceAgent\device-agent.exe" service startVerwenden Sie für den Agenten nicht Restart-Service. Der Agent braucht bis zu 15 Sekunden zum Beenden, und Restart-Service kann vorher aufgeben und den Dienst gestoppt zurücklassen.
Vor Agent 1.4.0 installierte Windows-Geräte nutzten
%ProgramData%\IronFlock\Reagentund den Dienstreagent. Agent 1.4.0 überführt ein solches Gerät in das oben beschriebene Layout — der Agent und seine Apps starten dabei einmal neu.
Hinter einem Unternehmens-Proxy? Ergänzen Sie
-proxy http://proxy.example.com:3128beimservice install-Befehl und konfigurieren Sie den Proxy von Docker Desktop unter Settings → Resources → Proxies. Details und die Schritte für Unternehmens-CAs finden Sie unter Hinter einem Unternehmens-Proxy.
Windows-Gerät, das Ihrer Domäne beigetreten ist? Der Agent-Dienst läuft als LocalSystem, unabhängig davon, ob jemand angemeldet ist — eine an den angemeldeten Benutzer gebundene Firewall-Regel erfasst ihn daher nicht. Lassen Sie die Regel an das Computerkonto des Geräts binden — siehe Identity-Aware Firewalls und Proxys.
Zeitsynchronisation (NTP)
Der Geräte-Agent benötigt eine genaue Uhr. Der TLS-Handshake mit der Plattform, die Tokens, die Image-Downloads autorisieren, und der Zeitstempel jedes vom Gerät veröffentlichten Datenpunkts hängen davon ab. Ein Gerät, dessen Uhr mehr als 15 Minuten abweicht, wird zudem vom Dateispeicher mit CLOCK_SKEW abgewiesen.
In einem Unternehmensnetzwerk ist das ein Einrichtungsschritt und keine Selbstverständlichkeit: Ausgehendes NTP auf UDP-Port 123 ist häufig blockiert, die mitgelieferten öffentlichen Zeitserver sind damit nicht erreichbar und die Uhr driftet ohne sichtbaren Fehler. Erfragen Sie den internen Zeitserver bei Ihrer IT-Abteilung und konfigurieren Sie ihn auf dem Gerät, oder lassen Sie ausgehendes UDP 123 für das Gerätenetz freigeben.
Linux
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 statusMit chrony:
echo "server ntp.your-company.com iburst" | sudo tee -a /etc/chrony/chrony.conf
sudo systemctl restart chrony
chronyc sourcestimedatectl status muss System clock synchronized: yes melden.
Windows
In einer Eingabeaufforderung mit Administratorrechten:
w32tm /config /manualpeerlist:"ntp.your-company.com" /syncfromflags:manual /update
w32tm /resync
w32tm /query /statusGeräte, die mit einem fertigen IronFlock-Image geflasht wurden (Methode 1 und 2), synchronisieren sich standardmäßig mit öffentlichen Zeitservern. In einem Netzwerk, das diese blockiert, geben Sie entweder ausgehendes UDP
123für das Gerätesubnetz frei, oder konfigurieren Sie den internen Zeitserver nach dem ersten Start per SSH genau so wie oben für Linux gezeigt.
Verbindung überprüfen
Überprüfen Sie nach dem Verbinden den Gerätestatus in Ihrem Projekt:
- Grüne Anzeige — Das Gerät ist online und kommuniziert mit IronFlock.
- Rote Anzeige — Das Gerät ist offline. Überprüfen Sie die Netzwerkverbindung und stellen Sie sicher, dass der Agent ausgeführt wird.
- Grüne Anzeige, aber App-Installationen, Image-Abrufe oder Agent-Updates laufen in Timeouts — Möglicherweise lässt eine Firewall-Regel keine neuen Verbindungen des Geräts mehr zu. Lesen Sie Identity-Aware Firewalls und Proxys, bevor Sie irgendetwas neu starten.
Die Kartenansicht zeigt den geografischen Standort aller Geräte im Projekt.