Zum Hauptinhalt springen

Genereller Ablauf von Upgrades

vorsicht

Die Upgradenotizen zu den jeweiligen Versionen enthalten nur die Änderungen seit der letzten vorhergehenden Version!

vorsicht

Auf einem System mit mehreren Mandanten muss ein Update für jeden Mandanten durchgeführt werden.

Vorbereitung​

vorsicht

Vor dem Upgrade sollte ein aktuelles Backup des gesamten Systems (inkl. Datenbank ousp) vorhanden sein! Zusätzlich sollten alle Portalskripte als XML-Export gespeichert werden.

  1. Aktuell installierte Version notieren
  2. Prüfung aller Upgradenotizen (unterhalb dieses Menüpunkts), welche seit der notierten Version herausgekommen sind und daraus eine Aufgabenliste erstellen
  3. Prüfung der Installationsvoraussetzungen
tipp

Generell ist es zur Sicherheit besser, bei Upgrades keine Major-Versionen zu überspringen, d.h. es ist empfohlen, jeweils von Major-zu-Major-Version zu upgraden (und die Zwischennotizen beachten, sofern vorhanden).

Ein Sprung über mehrere Major-Versionen kann jedoch möglich sein. Die Beurteilung erfordert jedoch tiefe Produktkenntnisse. Bitte daher, sofern notwendig, eine:n Softwareentwickler:in zu Rate ziehen.

Nicht alle Versionen haben dedizierte Versionsnotizen als Upgrade-Anleitung. In diesem Fall sind nur die Schritte hier (aus der generellen Anleitung) zu befolgen.

Beispiel​

  • Aktuell installierte Version ist 1.0.0
  • Aktuellste verfügbare Version ist 1.0.3
  • Es gibt keine Upgrade-Notizen für 1.0.1, 1.0.2 und 1.0.3
  • Daher sind bei einem Upgrade von 1.0.0 auf 1.0.3 nur die generellen Schritte aus dieser Anleitung zu beachten

Upgrade On-Premise​

Aktuelles Installationspaket herunterladen und entpacken (Installationsverzeichnis)

Dateisystem​

Aus folgenden Ordnern alle Inhalte nach D:\EASY\ oder D:\otris\ kopieren:

  • Workflow-ext

Vorhandene Dateien müssen überschrieben werden. Gelöschte Dateien werden in den Upgradenotizen zu den jeweiligen Versionen erwähnt und sollten nach dem Kopieren gelöscht werden.

Datenbank​

gefahr

Ab Version 24.2.0 muss dieser Schritt übersprungen werden, die Datenbankänderungen werden dann beim XML-Import automatisch durchgeführt!

Es muss je nach DBMS ggf. ein Teil aus der Database/mssql.sql oder Database/mariadb.sql ausgeführt werden:

  1. Datei öffnen

  2. Prüfen, ob nach der aktuellen Version ein neuer Versionsblock hinzugekommen ist

    1. Beispiel: die aktuell auf dem System vorhandene Version ist 22.0.0, ein Update auf die 24.0.0 steht an
    2. In der Database/mariadb.sql suchen, ob es einen Versionsheader mit Version größer als 22.0.0 gibt
    3. Es wurden mehrere Header gefunden:
    -- Aktualisierungsskript für Version 23.3.0
    -- Aktualisierungsskript für Version 24.0.0

  3. Es müssen alle Befehle unterhalb des ältesten (am weitesten oben in der Datei) gefundenen Blocks über den Datenbankclient (je nach DBMS) ausgeführt werden - bis zum Ende der Datei!

    1. Hier im Beispiel also alles unterhalb des Blocks -- Aktualisierungsskript für Version 23.3.0 bis zum Ende der Datei

  4. Wurde kein Versionsblock gefunden, so ist hier nichts zu tun 🥳

Documents​

XML-Import​

Als letzten Schritt muss im documents-Manager die ousp-documents-update.xml importiert werden.

  • Im Documents-Manager unter Servereinstellungen / XML-Import
  • In das Installationsverzeichnis/XML wechseln und die ousp-documents-update.xml auswählen

Installer-Output prüfen​

In den documentsserver-Logs muss anschließend geprüft werden, ob das Update über den Installer erfolgreich und ohne Fehler verlief.

Überprüfung der Skript-Kompatibilität​

Im Rahmen des Upgrades muss überprüft werden, welche Ausgaben mit dem Präfix [SCRIPT-COMPATIBILITY-CHECK] im Log festgehalten werden. Dabei dürfen keine Fehler auftreten. Es kann jedoch eine Warnung auftreten, dass die alte Version nicht in den globalen Eigenschaften vorhanden ist. Dies geschieht in der Regel, wenn von einer sehr alten Version aktualisiert wird, für die die Kompatibilitätsprüfung noch nicht unterstützt wird. In diesem Fall wird die Kompatibilitätsprüfung für das aktuelle Upgrade übersprungen. Es muss dann manuell überprüft werden, welche Dateien sich geändert haben. Die entsprechenden Informationen sind in den Upgrade-Notizen festgehalten.

Die Ausgaben zeigen an, welche Skripte sich durch das Upgrade geändert haben. Gleichzeitig wird signalisiert, welche Skripte nach dem Upgrade überprüft werden müssen.

Es wird protokolliert, wenn:

  • Skripte neu hinzugekommen sind, die enthalten:

    • ou.sp und lib
    • .cust.
    • .spc.
    • Hinweis: Dient nur als Information. Keine weitere Prüfung erforderlich.

  • Skripte gelöscht wurden, die enthalten:

    • ou.sp und lib
    • .cust.
    • .spc. und zu denen ein entsprechendes cust-Skript existiert
    • Aktion: Es muss überprüft werden, ob diese Skripte noch verwendet wurden.

  • Skripte geändert wurden, die enthalten:

    • ou.sp und lib
    • .cust.
    • .spc. und zu denen ein entsprechendes cust-Skript existiert
    • Aktion: Es muss überprüft werden, ob die Änderungen Auswirkungen haben.

Abschluss​

Anschließend im Admin-Center die Aktion "clear all caches" (Kachel auf "Übersicht") ausführen.

Fertig! 🥳