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 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
• 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.

Documents

XML-Import

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

• Im Documents-Manager unter Servereinstellungen / XML-Import
• In das Installationsverzeichnis/XML wechseln und die library-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.

DiffViewer in den Upgrade-Notizen

In den Upgrade-Notizen zu den jeweiligen Versionen wird ein DiffViewer angezeigt, der die Dateiänderungen des Upgrades darstellt. Es werden dabei nicht alle geänderten Dateien angezeigt, sondern nur die für das Customizing relevanten Skripttypen: spc-, tmpl-, cust- und sp.*.lib-Dateien.

Die Kopfzeile zeigt z. B. Files changed (32) (5 relevant) – die erste Zahl ist die Gesamtanzahl der im DiffViewer enthaltenen Dateien, die zweite Zahl die Anzahl der Dateien, bei denen in jedem Fall Handlungsbedarf besteht.

Über den show-Button in der Kopfzeile kann eine Übersicht aller im DiffViewer enthaltenen Dateien ein- und ausgeklappt werden.

Bedienung

• Der DiffViewer ist standardmäßig ausgeklappt. Über den Pfeil neben der Überschrift kann der gesamte DiffViewer ein- und ausgeblendet werden.
• Einzelne Dateien können über die Viewed-Checkbox ein- und ausgeblendet werden.
• Die Ansicht kann zwischen Line-by-Line und Side-by-Side gewechselt werden.
• Über das Vollbild-Symbol kann der DiffViewer im Vollbildmodus geöffnet werden.

Kennzeichnung von Änderungen

• Dateien, die ausschließlich Formatierungsänderungen enthalten, sind mit ONLY FORMAT CHANGES gekennzeichnet und werden standardmäßig ausgeblendet.
• Neue Dateien werden ebenfalls standardmäßig ausgeblendet. Diese sollten eigenständig geprüft werden, wenn die Zusammenfassung auf der jeweiligen Upgrade-Seite Handlungsbedarf beschreibt.
• Dateien mit einer inhaltlichen Beschreibung oberhalb des Diffs erfordern besondere Aufmerksamkeit – die Beschreibung erläutert, welche Änderungen vorgenommen wurden und was ggf. zu tun ist.

Abschluss

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

Fertig! 🥳