InnerWeb
Zum Inhalt springen

Checkliste Versionskonsistenz der Hosts nach Deployment

Nach einem Update muss jeder Host einen Endpunkt des Geräteprotokolls haben, und jede Uhr muss die App in derselben Version haben. Ein Host ohne Endpunkt antwortet mit 404 und bleibt blind, obwohl die Karte funktioniert. Die Checkliste führt das Deployment-Team durch die Kontrolle der Hosts, der Versionen und einen Abschlusstest.

404
Antwort eines Hosts ohne Endpunkt des Protokolls
Quelle: Karte
78 s
Abstand des Protokollversands bei einem Intervall von 26 s
Quelle: Karte

Warum die Konsistenz der Versionen nach dem Deployment zu prüfen ist

Nach einem Systemupdate muss das Deployment-Team zwei Dinge bestätigen: dass jeder Host einen Endpunkt für das Schreiben des Geräteprotokolls hat und dass die App auf den Uhren in derselben Version wie das Backend läuft. Die Funktion zum Schreiben des Protokolls arbeitet nur auf Hosts, auf denen das Backend mit diesem Endpunkt ausgerollt wurde. Ein nicht aktualisierter Host antwortet mit 404 und bleibt blind: Die Uhren senden Chargen, und der Server nimmt sie nicht an.

Einen solchen Zustand sieht man weder auf der Karte noch bei den Positionen der Beschäftigten, denn der Heartbeat arbeitet unabhängig vom Protokoll. Ohne bewusste Kontrolle kann die Abweichung daher unbemerkt bleiben, bis zum ersten Vorfall, bei dem Ereignisse im Protokoll fehlen.

Schritt 1: Kontrolle des Endpunkts des Protokolls auf jedem Host

Führen Sie für jeden Host im Deployment-Netz einen Testaufruf des Endpunkts des Protokolls mit einem Testgerät oder einem Testkonto durch. Die erwartete Antwort ist die Bestätigung der Annahme der Charge. Die Antwort 404 bedeutet, dass auf dem Host kein Backend mit dieser Funktion ausgerollt ist. Die Antwort 400 bedeutet, dass der Host den Endpunkt kennt, aber die Charge wegen eines fehlerhaften Eintrags ablehnt, denn der Server verwirft die gesamte Charge mit dem Code 400, sobald auch nur ein Eintrag fehlerhaft ist.

Tragen Sie das Ergebnis in eine Tabelle ein: Host, Antwort, Datum und Person. In einem Beispielnetz mit fünf Hosten bedeutet ein Ergebnis von 4 von 5 korrekten Hosten, dass ein Host sofort zu reparieren ist. Das Beispiel ist illustrativ und beschreibt keine konkrete Installation.

Beispielhafte Kontrolle von 5 Hosten

Beispielhafte Kontrolle von 5 HostenKreisdiagramm: 4 Hosts antworten korrekt, 1 antwortet mit 404.Antwortet korrekt: 4 Hosts (80%)Antwortet mit 404: 1 Hosts (20%)5HostsAntwortet korrekt4 Hosts (80%)Antwortet mit 4041 Hosts (20%)
Quelle: Beispielrechnung: illustratives Netz aus fünf Hosten, keine konkrete Installation

Schritt 2: Version der App auf den Geräten

Die Version der App ist oft an mehreren Stellen gespeichert und kann dabei auseinanderlaufen. Als maßgeblich gilt die Version aus dem Paketmanifest, die das Geräteverwaltungssystem meldet. Stützen Sie die Kontrolle nicht auf die Nummer, die in den Einstellungen oder in der Beschreibung des Deployments steht, wenn sie von der Meldung des Geräteverwaltungssystems abweicht.

Exportieren Sie aus dem Geräteverwaltungssystem eine Liste der Uhren mit Version und vergleichen Sie sie mit der Zielversion. Geräte mit älterer Version sind zu aktualisieren, und Geräte, die nichts melden, sind physisch zu prüfen. Halten Sie die Zahl der konformen und nicht konformen Geräte fest.

Schritt 3: Prüfung des Ergebnisses, also das Protokoll vom Gerät

Führen Sie nach der Prüfung der Hosts und Versionen einen Abschlusstest durch. Lösen Sie auf der Uhr ein Testereignis aus und warten Sie auf den Versand der Charge: Das Protokoll wird jeden dritten Heartbeat-Zyklus gesendet, also bei einem Intervall von 26 s etwa alle 78 s. Nach einer Zeit von mehr als 78 s sollte der Eintrag auf dem Server mit beiden Zeiten sichtbar sein: der des Geräts und der des Empfangs.

Beachten Sie beim Vergleich der Zeiten die Zeitzonen. Die Zeit des Geräts ist manchmal in UTC gespeichert, während ein Teil der Tabellen die Ortszeit führt. Ein Unterschied von 2 Stunden ist daher eine Verschiebung der Zeitzone und keine Verzögerung. Das Schreiben des Protokolls ist durch die Eindeutigkeit des Paars aus Benutzer und Eintrags-ID sicher gegen Wiederholungen, daher kann der Test ohne Gefahr von Dubletten wiederholt werden.

Kriterien für den Abschluss der Einführung

Die Einführung gilt als konsistent, wenn alle Hosts den Endpunkt des Protokolls korrekt beantworten, alle Uhren die Zielversion melden und der Abschlusstest einen Eintrag auf dem Server ergeben hat. Das Ergebnis ist im Abnahmeprotokoll festzuhalten, damit im Streitfall bekannt ist, wann und wer den Zustand bestätigt hat.

Das Fenster der Warteschlange auf dem Gerät beträgt etwa 2 Stunden. Nach dem Update eines Hosts, der blind war, können die Uhren daher bereits ältere Einträge verdrängt haben. Rechnen Sie nicht mit einer Nachholung der Historie durch einen rückwirkenden Versand: Das Fenster ist kein Archiv.

Checkliste

Videomaterial

Häufig gestellte Fragen

Was bedeutet die Antwort 404 auf das Protokoll?

Der Host hat kein ausgerolltes Backend mit diesem Endpunkt und bleibt für den Schreibvorgang des Protokolls blind.

Woher nehme ich die Version der App?

Aus dem Paketmanifest, das das Geräteverwaltungssystem meldet, da andere Angaben auseinanderlaufen können.

Nach welcher Zeit sollte der Testeintrag erscheinen?

Nach ca. 78 s bei einem Intervall von 26 s, denn das Protokoll wird bei jedem dritten Heartbeat gesendet.

Kann der Test wiederholt werden?

Ja. Die Eindeutigkeit des Paars aus Benutzer und Eintrags-ID verhindert Dubletten.

Planen wir die Abnahme der Einführung

Wir bereiten ein Protokoll der Kontrolle der Hosts und Versionen vor, das auf Ihr Netz zugeschnitten ist.

Sprechen wir