Ein Firmware-Update, das Geräte beschädigt, sollte nur wenige davon treffen. Ein Rollout in Wellen sendet ein Paket zuerst an eine kleine Gruppe, prüft, wie es gelaufen ist, wartet und geht erst dann zu größeren Gruppen über. Er stoppt von selbst, wenn eine Welle schlechter verläuft, als Sie es zulassen. Diese Seite erklärt, wie Sie ihn einrichten und verfolgen. Die Grundlagen zu Paketen und Zuweisungen finden Sie unter Firmware-Updates (OTA).
Wann Sie Wellen verwenden können
Wellen gelten für eine Zuweisung an Alle Geräte eines Profils oder Einige Geräte (eine Geräteliste). Eine Zuweisung an Ein Gerät wird sofort gesendet. Sie benötigen die Berechtigung zum Zuweisen von Firmware (Administratoren).
Rollout einrichten
- Öffnen Sie das Paket unter Firmware und wählen Sie Zuweisen (oder verwenden Sie den Reiter Firmware eines Profils).
- Wählen Sie Alle Geräte eines Profils oder Einige Geräte und legen Sie die Ziele fest.
- Aktivieren Sie In Wellen senden („Eine kleine erste Welle Online-Geräte, dann größere. Der Rollout stoppt von selbst, wenn eine Welle schlechter verläuft, als Sie es zulassen.“).
- Belassen Sie Den üblichen Plan verwenden oder bearbeiten Sie die Wellen (siehe unten).
- Wählen Sie Prüfen. Was passiert zeigt die Gerätezahlen und „In Wellen: …“ mit der Größe jeder Welle.
- Wählen Sie Zuweisen und bestätigen Sie.
Der übliche Plan
| Welle | Größe | Wartezeit nach Abschluss |
|---|---|---|
| 1 | 1 % der Geräte, mindestens 1 und höchstens 10 (der Canary) | 30 Minuten |
| 2 | 10 % | 30 Minuten |
| 3 | 50 % | 15 Minuten |
| 4 | der Rest | — |
Jede Welle des üblichen Plans benötigt mindestens 90 % ihrer abgeschlossenen Geräte mit aktualisierter Firmware, pausiert bei mehr als 5 % Fehlern und schließt spätestens nach 240 Minuten.
Eigene Wellen
Unter Wellen: „Die Größen werden über die Geräte gezählt, die aktualisiert werden. Die letzte Welle übernimmt alle verbleibenden Geräte.“ Für jede Welle:
| Feld | Bedeutung | Bereich |
|---|---|---|
| Größe als | Anzahl der Geräte oder Anteil der Geräte (%) | Eine Größe über 0; ein Anteil höchstens 100 % |
| Wartezeit nach Abschluss (Minuten) | Die Einwirkzeit vor dem Start der nächsten Welle | 0 bis 10.080 (7 Tage) |
| Mindestens aktualisiert (%) | Die Erfolgsschwelle über die abgeschlossenen Geräte der Welle | 0 bis 100 |
| Höchstens fehlgeschlagen (%) | Die Fehlerschwelle | 0 bis 100 |
| Höchstens fehlgeschlagen (Geräte) | Optionale absolute Obergrenze. „Leer lassen, um nur den Anteil zu zählen.“ | — |
| Schließen nach (Minuten) | Wie lange die Welle geöffnet bleibt. „Bis dahin noch offline oder wartende Geräte werden übernommen und zählen nicht als Fehler.“ | 5 bis 43.200 |
Welle hinzufügen und Welle n entfernen ändern die Liste; Der Rest markiert die letzte Welle. Ein Rollout hat höchstens 20 Wellen.
Wie Geräte auf Wellen verteilt werden
- Die Reihenfolge der Geräte ist für einen Rollout stabil, sodass ein Gerät beim erneuten Ansehen nicht zwischen Wellen wechselt.
- Online-Geräte kommen zuerst, sodass die Canary-Welle schnell Ergebnisse liefert.
- Ein Gerät einer späteren Welle erhält nichts (keine
fw_*-Attribute), bis seine Welle startet. Auf seiner Seite wird Wartet auf Welle n angezeigt.
Während ein Rollout läuft
Die Paketseite zeigt den Rollout in Wellen: jede Welle mit ihrem Status (Nicht gestartet, Wird aktualisiert, Bestanden, wartet, Bestanden, Pausiert, Nicht gesendet), ihren Geräten und ihrem Fortschritt („aktualisiert von geplant aktualisiert, fehlgeschlagen fehlgeschlagen“) sowie die aktuelle Schwelle („Jetzt: … fehlgeschlagen (… %), … % der abgeschlossenen aktualisiert.“). „Diese Welle schließt spätestens …“ und „Die nächste Welle startet …“ zeigen die Zeitpunkte.
Der Status des Rollouts ist Läuft, Pausiert, Abgeschlossen oder Abgebrochen.
Automatische Pause
Der Rollout pausiert von selbst, wenn eine Welle:
| Grund | Angezeigt als |
|---|---|
| mehr Fehler hat als erlaubt | zu viele Geräte fehlgeschlagen |
| schließt mit weniger aktualisierten Geräten als erforderlich | zu wenige Geräte aktualisiert |
| schließt, ohne dass ein Gerät fertig wurde | kein Gerät rechtzeitig fertig |
„Geräte, die bereits begonnen haben, schließen ihre Aktualisierung ab; kein anderes Gerät erhält sie, bis jemand den Rollout fortsetzt.“ Ihre Administratoren erhalten eine Hinweismeldung in der App („Paket: der Rollout ist pausiert“).
Pausieren, Fortsetzen, Abbrechen
| Aktion | Wirkung |
|---|---|
| Pausieren | „Kein anderes Gerät erhält die Aktualisierung, bis Sie fortsetzen. Geräte, die bereits begonnen haben, schließen ihre Aktualisierung ab; eine Aktualisierung kann auf halbem Weg nicht sicher gestoppt werden.“ |
| Fortsetzen | „Der Rollout läuft mit Welle n weiter.“ Nach einer automatischen Pause: „Das Fortsetzen übernimmt, was bisher geschehen ist: nur neue Fehler zählen gegen die Schwelle, und eine am Ende gestoppte Welle gilt als bestanden.“ |
| Abbrechen | „Die Zuweisung wird entfernt. Geräte, die noch nicht mit der Installation begonnen haben, erhalten dieses Update nicht; Geräte, die von einer anderen Zuweisung abgedeckt werden, wechseln zu dieser. Dies kann nicht rückgängig gemacht werden.“ |
Ein Rollout endet außerdem, wenn das Paket zurückgezogen wird, wenn seine Zuweisung entfernt wird oder wenn eine neuere Zuweisung sie ersetzt.
Meldungen, Audit und Webhooks
| Ereignis | Webhook | Meldung in der App |
|---|---|---|
| Eine Welle bestanden | ota.rollout.wave_completed | „Genügend Geräte der Welle n wurden aktualisiert. Die nächste Welle startet nach ihrer Wartezeit.“ |
| Pausiert | ota.rollout.paused | ja |
| Fortgesetzt | ota.rollout.resumed | — |
| Abgeschlossen | ota.rollout.completed | „Alle n Wellen bestanden. Geräte, die offline waren, aktualisieren sich, sobald sie zurückkehren.“ |
| Abgebrochen | ota.rollout.aborted | — |
Jede Pause, Fortsetzung und jeder Abbruch wird mit Angabe der handelnden Person im Audit-Log protokolliert.
Tipps
- Testen Sie das Paket vor einem Rollout auf wenigen Geräten, die Sie physisch erreichen können, mit Zuweisungen an Ein Gerät.
- Wählen Sie die Einwirkzeit lang genug, damit sich Probleme zeigen: Ein Gerät, das in einer Schleife neu startet, braucht Zeit, um zu scheitern.
- Geräte in Verbindungen mit Volumenabrechnung können warten (Wartet), statt sich zu aktualisieren; sie werden übernommen und zählen beim Schließen der Welle nicht als Fehler.