9.1. Vorbereitung eines Updates
Allgemeine Hinweise
Mit einem Update von Goobi workflow sollten auch alle Plugins aktualisiert werden. Dafür sollte am besten auch die Seite Installierte Plugins
in Goobi workflow beachtet werden. Sollte diese hingegen noch nicht existieren, müssen die relevanten Dateien im Dateisystem identifiziert werden. Hierbei ist wichtig, auch die REST API nicht zu vergessen.
Befehle aus dieser Anleitung werden am besten mit einem Klick auf das entsprechende Icon kopiert. Andernfalls besteht die Gefahr ungewollte Whitespaces mit zu kopieren.
Sinnvolle Vorarbeiten vor Updatedurchführung
Überprüfung des Zustands
Für einen guten Zustand des Systems sollten vor und/oder nach dem Update die folgenden Dinge geprüft werden:
Erstellung eines Backups
Sinnvollerweise wird vor dem Backup der Tomcat ausgestellt. Allerdings ist vorher notwendig zu prüfen, dass kein Anwender mehr in Goobi workflow angemeldet ist. Neben der Anzeige der angemeldeten Benutzer in der Oberfläche können die letzten Einträge im Prozesslog oder die letzten Logins für die Bewertung der Lage hilfreich sein:
Anschließend kann der Tomcat Prozess für Goobi workflow beendet werden:
Mit den folgenden Befehlen können ein Backupverzeichnis erstellt und die Dateien dorthin kopiert werden:
Aktuellen Zustand im Goobi-Verzeichnis committen:
Aktuellen Zustand der Archive speichern:
Wenn ein Update von einer Version kleiner als 24.07 auf die aktuelle Version durchgeführt wird, müssen alle EAD-Dateien aus BaseX exportiert werden. Wenn es keine Archive gibt, kann dieser Punkt ignoriert werden. Dafür unter https://URL/basex/dba/login
einloggen. Dann unter Databases
jede Datenbank auswählen, die .xml-Datei auswählen und herunterladen.
Kopieren der neuen Dateien auf das System
Es empfiehlt sich, die Dateien auf dem zu aktualisierenden System nach /tmp/g3
zu kopieren. Die Dateien in die korrekten Ordner verschieben:
Gerade Konfigurationsdateien von Plugins können aufgrund einer Änderung des Schemas für die Benennung inzwischen einen anderen Dateinamen haben.
Nach Abschluss der Arbeiten kann über den Abgleich der Zeitstempel ermittelt werden, ob alle notwendigen Dateien aktualisiert wurden:
Plugins, die als Tar
-Paket gebaut werden:
Testen des installierten Updates
Die folgenden Dinge sollten nach einem Update geprüft werden:
Rescue im Falle von auftretenden Problemen
Manchmal kann es vorkommen, dass nach dem Update Fehler auftreten. Die folgenden Punkte helfen dabei, typische Probleme zu identifizieren und zu beheben:
Goobi startet nicht - ActiveMQ
Wenn der Tomcat nach dem Start hängen bleibt, kann der Inhalt des Ordners /opt/digiverso/goobi/activemq/
daran Schuld sein. Leeren und neu starten hilft in diesem Fall:
LayoutWizzard
Die LayoutWizzard.jar
in /opt/digiverso/{goobi,itm}/lib/
müssen gleich sein. Symbolische Links funktionieren nicht.
Durchführung des eigentlichen Updates
Nachdem alle Vorarbeiten durchgeführt wurden, kann das eigentliche Update erfolgen. Dieses ist in einzelnen Schritten detailliert hier erläutert:
https://github.com/intranda/goobi-workflow-doc-de/blob/master/admin/9/9.2Last updated