Zum Inhalt springen
Vehistra
Dokumentationsnavigation

Updates

Die wichtigste Zusage zuerst: Ein Update löscht die Fuhrparkdatenbank niemals und erstellt sie niemals neu. Alle vorhandenen Daten bleiben vollständig erhalten.

Wie das Update funktioniert

   Entwicklung              Server                    Arbeitsplaetze
   -----------              ------                    --------------
   Releasepaket       --->  Updates\1.1.0\      --->  Meldung beim Start
                            Updates\latest.json       Update ausfuehren
                                                      Programm neu starten

Im Updateordner auf dem Server liegt die Datei latest.json. Darin steht, welche Version aktuell ist. Jeder Arbeitsplatz liest sie beim Start und meldet sich, wenn eine neuere Version bereitsteht.

Aufbau des Updateordners

D:\Fuhrpark\Updates\
    latest.json                  beschreibt die aktuelle Version
    1.1.0\
        Vehistra-Update.exe      das eigentliche Updatepaket
        release-notes.txt        was sich geändert hat
        checksums.sha256         Prüfsummen aller Dateien
        Dokumentation\           die Anleitungen dieser Version
    Archive\
        1.0.0\                   die Vorgängerversion

Die Vorgängerversion bleibt im Ordner Archive. So kommen Sie im Notfall zurück.

Eine neue Version bereitstellen

  1. Das Releasepaket in einen neuen Versionsordner entpacken.
  2. Prüfsummen vergleichen.
  3. latest.json auf die neue Version zeigen lassen.

Ab dem nächsten Programmstart melden die Arbeitsplätze das Update selbst.

Was beim Einspielen passiert

  • Vor dem Start wird die Prüfsumme des Updatepakets geprüft. Erwartet wird der Wert aus latest.json; fehlt er, gilt die Prüfsummendatei neben dem Paket. Stimmt sie nicht oder fehlt beides, startet das Update nicht. Die Prüfung sitzt im Updatedienst, nicht in der Oberfläche.

  • Unter „Updates" steht das Ergebnis im Klartext, schon bevor Sie auf „Installieren" klicken.

  • Vor jeder Datenbankänderung wird gesichert und geprüft. Schlägt die Sicherung fehl, bricht das Update ab.

  • Starten mehrere Arbeitsplätze gleichzeitig, verhindert eine Sperre in der Datenbank, dass die Migration doppelt läuft.

  • Die Migrationen sind aufeinander aufbauend; es wird nichts gelöscht und nichts neu erstellt.

Zurück zur vorherigen Version

Der Rückweg ist immer: vorherige Programmversion aus Archive installieren und die Sicherung von vor dem Update zurückspielen – siehe Sicherung und Wiederherstellung.

Deshalb ist die Sicherung vor dem Update nicht optional.

Was die Prüfsumme leistet – und was nicht

Sie erkennt ein Paket, das unvollständig kopiert oder nachträglich verändert wurde. Sie schützt nicht gegen jemanden, der auf die Updateablage schreiben darf: Wer das Paket austauscht, kann die Prüfsumme in latest.json gleich mitändern.

Dagegen helfen zwei Dinge:

  • ein Updateordner, in den nur Administratoren schreiben dürfen,
  • eine Codesignatur der Pakete.