Systemupdates

Pulse wird als signiertes Update-Bundle ausgeliefert, das vom Hersteller erzeugt wird. Der Bildschirm Update System in der Appliance-TUI spielt ein solches Bundle in die laufende Appliance ein. Der Assistent ist immer derselbe, egal auf welchem Weg das Bundle die Appliance erreicht — nur der erste Schritt, die Quelle, unterscheidet sich.

Diese Seite ist die vollständige Anleitung. Für Datenbank-Backups und das Zurücksetzen auf eine vorherige Version siehe Betrieb.

Was ein Update-Bundle ist

Jedes Bundle ist von Pulse signiert. Die Appliance prüft die Signaturkette, bevor überhaupt etwas angezeigt wird, und verweigert die Verarbeitung, wenn das Bundle unsigniert, manipuliert oder mit einem Schlüssel signiert ist, der nicht zum öffentlichen Schlüssel des laufenden Systems passt. Es gibt keinen Weg, ein unsigniertes Bundle über die TUI einzuspielen — genau das ist der Zweck der Signaturkette.

Ein gültiges Bundle enthält ein Manifest mit Versionsangabe, Build-Zeitstempel, einer kurzen Liste der Änderungen und einem Marker, ob die neue Version einen Neustart erfordert. All das sehen Sie auf dem Bildschirm Update Available, bevor Sie sich für das Einspielen entscheiden.

Den Lieferweg wählen

Es gibt drei Wege, ein Bundle auf die Appliance zu bringen. Wählen Sie danach, wie die Appliance betrieben wird:

Betrieb	Empfohlener Weg	Warum
Virtualisiert (VMware ESXi/vSphere, Proxmox, Hyper-V, …)	CD/DVD-ROM	Hängen Sie das Update-ISO in das virtuelle optische Laufwerk der VM ein — dieselbe Geste wie bei der Installation. Kein USB-Passthrough nötig.
Physische / Bare-Metal-Appliance	USB-Stick	Kein Hypervisor, daher ist ein per Hand mitgebrachter Wechseldatenträger der einfachste Weg.
Remote / unbeaufsichtigt oder vom Support bereitgestellt	SFTP-Upload	Der Support liefert das Bundle über das Netzwerk; niemand muss zum Rack gehen.

Alle drei münden in denselben Assistenten und dasselbe unten beschriebene Sicherheitsnetz — die Tabelle betrifft die Bequemlichkeit, nicht den Funktionsumfang.

Wie ein Update eingespielt wird

Sobald Sie bestätigen, führt die Appliance eine feste Abfolge aus. Es lohnt sich zu wissen, was passiert, denn das meiste davon ist automatische Absicherung:

1. Prüfen — Signatur und Prüfsumme werden erneut kontrolliert.
2. Datenbank sichern — es wird ein frisches PostgreSQL-Backup erstellt, bevor irgendetwas angefasst wird, sodass der Zustand vor dem Update jederzeit wiederherstellbar ist.
3. Importieren und umschalten — das neue System wird entpackt und das Boot-Profil darauf umgestellt.
4. Health-Check — es wird bis zu 60 Sekunden gewartet, bis Pulse an seinem Health-Endpunkt antwortet.
5. Automatisches Rollback bei Fehler — schlägt das Umschalten oder der Health-Check fehl, setzt sich die Appliance automatisch auf die vorherige Version zurück und meldet den Fehler. Sie bleiben auf einem funktionierenden System zurück, nicht auf einem kaputten.
6. Aufräumen — die fünf neuesten Systemgenerationen werden behalten, ältere entfernt.

Wenn das Manifest einen Neustart verlangt (typischerweise eine Kernel-Änderung), teilt der Schlussbildschirm Ihnen das mit; starten Sie dann bei Gelegenheit über das Hauptmenü neu.

TIP

Weil die Appliance die Datenbank sichert und sich bei einem fehlgeschlagenen Health-Check selbst zurücksetzt, korrigiert sich ein fehlerhaftes Update weitgehend von selbst. Die manuellen Wiederherstellungswerkzeuge auf der Seite Betrieb sind für Probleme gedacht, die nach dem Einspielen im laufenden Betrieb auftreten.

Vor dem Update

Eine kurze Checkliste hält ein Update unspektakulär:

• Stellen Sie sicher, dass die Appliance jetzt gesund ist — die Weboberfläche lädt und das System verhält sich normal. Ein Update auf einem kranken System erschwert die Fehlersuche.
• Sorgen Sie für Konsolenzugang — lokaler Monitor und Tastatur oder SSH als pulse-Benutzer. Sie möchten den Fortschritt verfolgen und bei Bedarf neu starten.
• Planen Sie einen möglichen Neustart ein — manche Updates erfordern einen. Wählen Sie ein Zeitfenster, in dem ein kurzer Neustart vertretbar ist.
• Halten Sie das Bundle am richtigen Ort bereit für den gewählten Weg (siehe die einzelnen Wege unten).
• (Optional) Erstellen Sie ein manuelles Backup über den Bildschirm Backup / Restore. Das Update erstellt zwar automatisch eines, aber ein zusätzlicher bekannter guter Stand ist vor einem großen Sprung eine günstige Absicherung.

Lieferwege im Detail

Virtualisierte Appliance — CD/DVD-ROM

Das ist der empfohlene Weg für jede Appliance, die als VM läuft.

1. Kopieren Sie das Update-ISO (pulse-update-<version>.iso) in den Datastore Ihres Hypervisors.
2. Bearbeiten Sie die Einstellungen der VM und richten Sie deren CD/DVD-Laufwerk auf dieses ISO. In VMware vSphere/ESXi setzen Sie das Laufwerk auf Datastore ISO File, wählen das ISO aus und — diesen Schritt übersieht man leicht — setzen den Haken bei Connected (und Connect At Power On). Andere Hypervisoren haben dieselben zwei Punkte: das ISO auswählen und sicherstellen, dass das Laufwerk tatsächlich verbunden ist.
3. Öffnen Sie auf der Appliance Update System → CD/DVD-ROM. Die TUI hängt das virtuelle Laufwerk ein, findet das Bundle und prüft es.

WARNING

Meldet die TUI keinen Datenträger, ist das Laufwerk fast immer angehängt, aber nicht Connected. Die Erkennung richtet sich danach, ob der Datenträger tatsächlich eingehängt ist, nicht nur danach, ob er in der VM-Konfiguration vorhanden ist. Setzen Sie den Haken bei Connected und wiederholen Sie den Vorgang.

Trennen Sie den Datenträger nicht, während das Update läuft — der Bildschirm Updating... weist in Gelb darauf hin. Das Laufwerk wird nach Abschluss des Updates automatisch ausgehängt.

Physische Appliance — USB-Stick

1. Formatieren Sie einen USB-Stick als FAT32 oder ext4.
2. Kopieren Sie die Bundle-Dateien in das Wurzelverzeichnis des Sticks (ein einzelnes Unterverzeichnis wie updates/ funktioniert ebenfalls). Legen Sie sie nicht tiefer ab.
3. Stecken Sie ihn in die Appliance und öffnen Sie Update System → USB Drive. Die TUI sucht nach Wechseldatenträgern:
   • Ein Laufwerk gefunden → es wird automatisch eingehängt und durchsucht.
   • Mehrere gefunden → der Schritt Select USB Device lässt Sie das richtige auswählen.
   • Keines gefunden → es meldet no USB drive found (format must be FAT32 or ext4) und wartet.

Ziehen Sie den Stick nicht ab, während das Update läuft — das Bundle wird während des Einspielens davon gelesen, und der Bildschirm Updating... weist in Gelb darauf hin. Er wird nach Abschluss automatisch ausgehängt.

Remote / vom Support bereitgestellt — SFTP-Upload

1. Die Gegenseite, die das Bundle liefert, muss bereits ein autorisierter SFTP-Benutzer sein — siehe SFTP-Zugang, wie Sie sie autorisieren, per SSH-Schlüssel oder mit dem Passwort der Appliance.
2. Sie lädt das Bundle in das Austauschverzeichnis unter uploads/updates/ hoch.
3. Öffnen Sie auf der Appliance Update System → SFTP Upload. Die TUI durchsucht das Austauschverzeichnis und prüft das Gefundene.

Ein erfolgreich eingespieltes SFTP-Bundle wird danach aus dem Austauschverzeichnis entfernt, damit es nicht zweimal eingespielt werden kann.

Der Assistent, Schritt für Schritt

Welche Quelle Sie auch wählen, der Rest ist identisch:

1. Quelle — wählen Sie USB Drive, SFTP Upload oder CD/DVD-ROM. Die TUI sucht, hängt ein (USB und CD/DVD-ROM) und prüft das Bundle.
2. Manifest-Prüfung — der Bildschirm Update Available zeigt Version, Build-Zeitstempel, Änderungen und ob ein Neustart erforderlich ist. Lesen Sie das. Drücken Sie Esc, um sauber abzubrechen, ohne etwas einzuspielen.
3. Bestätigung — drücken Sie auf dem Manifest-Bildschirm Enter, um zu starten. Es folgt keine zweite Ja/Nein-Abfrage; der Manifest-Bildschirm ist die Bestätigung.
4. Fortschritt — der Bildschirm Updating... zeigt den Fortschritt, während das Bundle geprüft, gesichert, importiert und aktiviert wird. Solange ein Wechseldatenträger noch eingehängt ist, weist er in Gelb darauf hin, diesen nicht zu entfernen.
5. Fertig — der Schlussbildschirm zeigt Update Successful! (grün) oder Update Failed (rot) mit der zugrunde liegenden Fehlermeldung. Drücken Sie Esc, um ins Hauptmenü zurückzukehren.

Nach dem Update

• Hat das Manifest einen Neustart angezeigt, starten Sie über den Eintrag Reboot System im Hauptmenü neu.
• Prüfen Sie, dass die Weboberfläche wieder erscheint und die Version die erwartete ist.
• Wenn Sie zufrieden sind, erstellen Sie über Backup / Restore ein frisches Backup, damit Ihr nächster bekannter guter Stand nach dem Update liegt.

Fehlerbehebung

Was Sie sehen	Wahrscheinliche Ursache	Was zu tun ist
no USB drive found (format must be FAT32 or ext4)	Stick ist nicht FAT32/ext4 oder wurde nicht erkannt	Als FAT32 oder ext4 neu formatieren, Stick neu einstecken, erneut versuchen
USB wird eingehängt, aber kein Bundle gefunden	Bundle liegt nicht im Wurzelverzeichnis oder Dateien unvollständig	manifest.json + system.tar (und die .sha256 / .sig-Dateien) ins Wurzelverzeichnis oder einen einzelnen Unterordner direkt im Wurzelverzeichnis (z. B. updates/) legen — nicht tiefer verschachteln
CD/DVD-ROM: kein Datenträger erkannt	ISO nicht angehängt oder angehängt, aber nicht Connected	ISO anhängen, Haken bei Connected / Connect At Power On setzen, erneut versuchen
SFTP: kein Bundle gefunden	Nicht nach uploads/updates/ hochgeladen oder Absender nicht autorisiert	Upload-Pfad prüfen; Absender (SSH-Schlüssel oder Passwort) über SFTP-Zugang autorisieren
Prüf-/Signaturfehler	Bundle ist unsigniert, beschädigt oder mit falschem Schlüssel signiert	Ein korrekt signiertes Bundle von Pulse anfordern; dieselbe Datei erneut einzuspielen hilft nicht
Update Failed während des Einspielens	Umschalten oder Health-Check fehlgeschlagen — die Appliance hat bereits automatisch zurückgesetzt	Sie sind zurück auf der vorherigen Version. Fehler festhalten und damit den Support kontaktieren
Web-App nach einem Neustart nicht erreichbar	Neue Version ist nicht gesund	Auf die vorherige Generation zurücksetzen, danach bei Bedarf ein Backup wiederherstellen

Wenn ein Update schiefgeht

Ein fehlgeschlagenes Update setzt sich während des Einspielens automatisch zurück (siehe die Tabelle zur Fehlerbehebung oben). Tritt ein Problem erst im laufenden Betrieb der neuen Version auf, verwenden Sie Rollback, um auf die vorherige Systemgeneration zurückzukehren. Rollback wirkt nur auf Systemebene — die Datenbank und andere Daten unter /var bleiben unberührt. Siehe Betrieb für Backups, Wiederherstellung und Rollback in voller Länge.