Diese Seite hilft, wenn ein Firmware-Update ein Gerät nicht erreicht, nicht abgeschlossen wird oder wenn ein Rollout in Wellen anhält. Beginnen Sie auf der Seite des Pakets (Firmware > das Paket): Die Liste Devices zeigt für jedes Gerät den State, den Progress, die Tries und das Problem. Der Reiter Firmware des Geräts zeigt, was es Runs, sein Update und seine History.
Das Gerät erhält das Image nicht
Wählen Sie vor der Zuweisung Check: What happens listet die Geräte auf, die das Paket nicht annehmen, mit dem Grund.
| Grund | Lösung |
|---|---|
| Updates sind für dessen Profil deaktiviert | Aktivieren Sie auf dem Reiter Firmware des Profils Allow firmware updates for this profile (für ein neues Profil deaktiviert) |
| Anderes Hardwaremodell | Das Paket listet Hardware models; das Gerät meldet ein anderes Modell |
| Für ein anderes Profil erstellt | Das Paket ist auf ein Profil beschränkt (Only for devices of this profile) |
| Unsigniert nicht erlaubt | Das Paket ist Not signed, und das Profil erlaubt Allow unsigned images nicht (nur für Testgeräte verwenden) |
| Aktuelle Version zu alt | Das Gerät ist älter als Lowest version it can update from |
| Aktuelle Version noch unbekannt | Das Gerät hat current_fw_version nicht gemeldet. Es muss den Wert nach jedem Verbinden senden. |
| Eine spezifischere Zuweisung gewinnt | Eine Gerätezuweisung hat Vorrang vor einer Geräteliste, und eine Liste vor einem Profil |
| Es wartet auf seine Welle | Bei einem Rollout erhält ein Gerät einer späteren Welle nichts, bis seine Welle startet: Waits for wave n |
Das Paket ist nicht bereit
| State | Bedeutung |
|---|---|
| Being checked | Die Datei wird auf Viren geprüft; sie wird Ready, wenn die Prüfung sauber ist |
| Rejected | Die Prüfsumme, die Signatur oder der Scan ist fehlgeschlagen; die Datei wurde gelöscht. Laden Sie sie erneut hoch. |
| Nach Retire | Es wird für neue Zuweisungen nicht mehr angeboten; laufende Updates werden fortgesetzt |
| Nach Revoke | Es darf nicht installiert werden: Updates, die noch nicht mit der Installation begonnen haben, wurden gestoppt |
Eine Signatur wird gegen Ihre registrierten Signing keys geprüft. Das Widerrufen eines Schlüssels widerruft jedes damit signierte Paket.
Den Update-Status lesen
| State | Bedeutung | Was zu tun ist |
|---|---|---|
| Queued | Zugewiesen; wird gesendet, sobald das Gerät online ist | Bringen Sie das Gerät online |
| Sent to the device | Dem Gerät mitgeteilt; es sollte mit dem Download beginnen | Bleibt dieser Zustand bestehen, verarbeitet das Gerät die fw_*-Shared-Attribute auf v1/attributes/set nicht |
| Downloading, Downloaded, Checked, Installing | Vom Gerät gemeldeter Fortschritt | Warten |
| Waiting | Das Gerät hält das Update zurück: über eine getaktete Verbindung, ohne mobiles Datenvolumen oder weil es auf dem Gerät selbst auf Freigabe wartet | Kein Fehler. Siehe unten. |
| Failed | Das Gerät hat FAILED mit dem Code fw_error gemeldet | Lesen Sie Problem; nach Behebung der Ursache Try again verwenden |
| No answer in time | Das Gerät hat innerhalb von Download may take (minutes) (standardmäßig 60) oder Installing may take (minutes) (standardmäßig 20) nicht mehr gemeldet | Prüfen Sie die Verbindung und das Gerät; erhöhen Sie die Zeiten im Profil bei langsamen Verbindungen oder großen Images |
| Auf die alte Version zurückgesetzt | Die neue Version ist nicht ordnungsgemäß gestartet, und das Gerät ist mit der alten Version neu hochgefahren | Testen Sie das Image auf einem erreichbaren Gerät; prüfen Sie die Boot-Logs |
| Not for this device | Das Paket passt nicht zu diesem Gerät | Siehe die erste Tabelle |
| Cancelled | Vor der Installation gestoppt |
Tries per update (standardmäßig 3, 1 bis 10 auf dem Reiter Firmware des Profils) legt fest, wie viele Versuche ein Update erhält. Für fehlgeschlagene, zeitlich abgelaufene oder zurückgesetzte Geräte bietet die Seite des Pakets Try again an.
Warten auf einer getakteten Verbindung
Ein Gerät über eine mobile (LTE-)Verbindung meldet fw_wait: metered und wartet, weil Allow updates over LTE (mobile data) standardmäßig deaktiviert ist. Damit es aktualisiert:
- aktivieren Sie die Einstellung für das Profil, oder
- setzen Sie Updates over LTE auf dem Reiter Firmware des Geräts auf Allowed for this device.
fw_wait: quota_exhausted bedeutet, dass das mobile Datenvolumen des Geräts aufgebraucht ist; approval bedeutet, dass jemand auf dem Gerät freigeben muss. Wartende Geräte zählen beim Abschluss einer Welle nicht als Fehler.
Probleme bei Download und Installation
| Symptom | Ursache |
|---|---|
| Der Download schlägt nach 15 Minuten fehl | fw_url ist 15 Minuten gültig. Das Gerät muss fw_url erneut anfordern und mit einer HTTP-Range-Anfrage fortsetzen. |
| Die Prüfsumme stimmt, aber das Gerät lehnt das Image ab | Die Signatur ist nicht gültig. Das Gerät handelt richtig, wenn es das Image ablehnt: Signieren Sie das Image mit einem registrierten Schlüssel neu. |
| Das Gerät meldet Updated, aber der Status ändert sich nicht | UPDATED ohne die neue current_fw_version wird nicht allein akzeptiert. Melden Sie die laufende Version nach dem Neustart. |
| Firmware wird nie angeboten | Firmware wird über unverschlüsseltes MQTT nie angeboten: Das Gerät muss TLS verwenden |
Siehe Firmware updates (OTA), was das Gerät empfängt und meldet.
Ein Rollout hat sich selbst pausiert
Ein Rollout in Wellen pausiert automatisch, wenn eine Welle:
| Angezeigter Grund | Bedeutung | Was zu tun ist |
|---|---|---|
| zu viele Geräte sind fehlgeschlagen | Mehr Fehlschläge als das Maximum At most failed (%) der Welle | Prüfen Sie das Problem der fehlgeschlagenen Geräte, beheben Sie die Ursache und wählen Sie dann Resume oder Abort |
| zu wenige Geräte wurden aktualisiert | Die Welle wurde mit weniger aktualisierten Geräten als erforderlich abgeschlossen | Oft sind Geräte offline. Prüfen Sie sie und setzen Sie dann fort. |
| kein Gerät wurde rechtzeitig fertig | Die Welle wurde abgeschlossen, ohne dass ein Gerät fertig wurde | Die Geräte sind möglicherweise offline oder können nicht herunterladen |
„Geräte, die bereits begonnen haben, schließen ihr Update ab; kein anderes Gerät erhält es, bis jemand den Rollout fortsetzt.“ Administratoren erhalten einen Hinweis in der Anwendung. Resume übernimmt den bisherigen Verlauf: Nur neue Fehler zählen gegen das Limit. Abort entfernt die Zuweisung und kann nicht rückgängig gemacht werden.
Der übliche Plan: 1 % Canary (1 bis 10 Geräte), dann 10 %, 50 % und der Rest; jede Welle benötigt 90 % ihrer fertigen Geräte im aktualisierten Zustand, pausiert bei mehr als 5 % Fehlern und wird spätestens nach 240 Minuten abgeschlossen. Siehe Rolling out firmware in waves.
Wer was darf
| Aktion | Standardrolle |
|---|---|
| Paketen und Update-Status anzeigen | User |
| Pakete hochladen, zurückziehen, widerrufen, löschen; zuweisen; OTA-Einstellungen ändern; erneut versuchen | Admin |
| Signing keys registrieren und widerrufen | Owner |