An dieser Stelle ist detailliert dokumentiert, wie die Updates von Goobi workflow ausgeführt werden müssen. Ein Update sollte dabei stets so erfolgen, dass zuvor ein Backup der wichtigen Daten durchgeführt wird. Die Erstellung eines Backups sowie weitere sinnvolle Vorarbeiten sind auf dieser Seite dokumentiert:

Nach der erfolgreichen Durchführung der Vorarbeiten kann das eigentliche Update erfolgen. Dieses ist in dieser Dokumentation so beschrieben, dass der Goobi workflow ausgehend von der installierten Version Schritt für Schritt auf die jeweils aktuellste Version gebracht werden kann.

Im folgenden werden die einzelnen Updateschritte erläutert, die durchlaufen werden müssen, um eine Goobi workflow Installation auf die gewünschte Version zu aktualisieren. Bitte beachten Sie, dass vor der Durchführung der hier dokumentierten Arbeiten zunächst ein Backup sowie gegebenenfalls auch noch weitere Vorarbeiten erfolgen müssen. Diese sind hier dokumentiert:

24.09

Namensänderung LayoutWizzard Step Plugin

Der Name des intranda_step_layoutwizzard-Plugins hat sich geändert. Er wird jetzt komplett kleingeschrieben. Dies gilt auch für die Konfigurationsdateien. Damit alles wie gewohnt funktioniert, müssen die Aufrufe der Vorgänge angepasst werden.

Dies geht am einfachsten über die Datenbank:

mysql goobi -e "update schritte set stepPlugin='intranda_step_layoutwizzard' where stepPlugin='intranda_step_LayoutWizzard';"

Umbenennung der Konfigurationsdateien:

cd /opt/digiverso/goobi/config/
mv plugin_intranda_step_LayoutWizzard_AutoAnalysis.xml plugin_intranda_step_layoutwizzard_autoanalysis.xml
mv plugin_intranda_step_LayoutWizzard_AutoSave.xml plugin_intranda_step_layoutwizzard_autosave.xml
mv plugin_intranda_step_LayoutWizzard.xml plugin_intranda_step_layoutwizzard.xml

Sicherstellen das der Ordner goobi/plugins/metadata vorhanden ist

mkdir -p /opt/digiverso/goobi/plugins/metadata

Plugin goobi-plugin-step-create-full-pdf

Das Plugin goobi-plugin-step-create-full-pdf verfügt über eine andere Konfiguration. Dieser Teil hat sich geändert und muss beim Update berücksichtigt werden:

ALT:

        <!-- If set to true, then PDF files for every single image are generated before the full PDF file. -->
        <!-- If set to false, then PDF files for every single image are generated after the full PDF file. -->
        <pagePdf enabled="true" /> 

        <!-- If enabled, a PDF file for the entire record is generated. This file includes the table of contents from the METS file if exists. -->
        <!-- The attribute pdfConfigVariant sets up which config variant in contentServerConfig.xml should be used. If not set, then use default. -->
        <fullPdf enabled="true" pdfConfigVariant="pdfa"/>

NEU:

        <!-- single page pdf files shall be generated and kept (@enabled) -->
        <singlePagePdf enabled="false" /> 

        <!-- Full PDF file is generated and kept (@enabled) 
        	- @mode controls if PDF shall be generated based on METS file ('mets') or based on singlePagePdfs ('singlepages')
        	- @pdfConfigVariant sets up which config variant in contentServerConfig.xml should be used. If not set, then use default. -->
        <fullPdf enabled="true" mode="mets" pdfConfigVariant="pdfa"/>

24.08

Java-Version

Goobi benötigt nun Java 17. Installation unter Ubuntu:

sudo apt install openjdk-17-jre-headless

Damit der Tomcat Java 17 nutzt, ist ggf. in der /etc/default/tomcat9 zu ergänzen:

export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64

Von Goobi aufgerufene Skripte sind auf Kompatibilität zu prüfen, ggf. das Default-Java des Systems anzupassen.

Vokabularserver

Der Zugriff auf den Vokabularserver wird nun über ein zusätzliches Token abgesichert. Prüfen, ob der Vokabularserver in Benutzung ist:

systemctl | grep vocabulary

In der Config-Datei application.properties muss der Token security.token=CHANGEME ergänzt werden. Der Vokabularserver muss aktualisiert werden: Download

# Update of the vocabulary server:
export VOC_TOKEN=$(</dev/urandom tr -dc '[:alnum:]' | head -c17)
cd /opt/digiverso/vocabulary/
mv vocabulary-server-core.jar{,.$(date +%s).bak}
wget https://github.com/intranda/goobi-vocabulary-server/releases/latest/download/vocabulary-server-core.jar
grep '^security.token=' application.properties || echo -e "\n#Access Token\nsecurity.token=${VOC_TOKEN}" >> application.properties

# Add Token to the Goobi workflow config:
grep ^vocabularyServerToken= /opt/digiverso/goobi/config/goobi_config.properties || echo "vocabularyServerToken=${VOC_TOKEN}" >> /opt/digiverso/goobi/config/goobi_config.properties

24.07

Vokabulare

Falls Vokabulare verwendet werden sollen oder vor einem Update verwendet wurden, müssen hier Anpassungen vorgenommen werden. Prüfen, ob Vokabulare genutzt werden:

sudo mysql goobi -NBse 'select count(1) from vocabulary_record_data'

Wenn dieser Befehl eine Zahl >0 liefert, ist dringend empfohlen, VOR dem Goobi workflow-Update die Vokabular-Migration zu testen. Wenn keine Vokabulare genutzt werden, dann darf auch kein Verweis auf ein Vokabular in der goobi_metadataDisplayRules.xml vorhanden sein. Prüfen: grep vocabulary -i /opt/digiverso/goobi/config/goobi_metadataDisplayRules.xml

Ebenfalls vor dem Update ist der Update-Status folgender Plugins zu prüfen, die zum Zeitpunkt des Releases noch nicht fertig angepasst waren: plugin-step-flex-editor, plugin-workflow-linked-process-creation, plugin-step-metadata-replacement und plugin-workflow-project-export. Prüfen, ob eines dieser Plugins installiert ist:

find -L /opt/digiverso/goobi/{lib,plugins} | grep -i -e flex -e linked -e replacement -e project

Die Vokabularverwaltung von Goobi workflow wurde durch den Vokabularserver abgelöst. Das ist eine eigenständige Applikation, mit der Goobi workflow kommunizieren kann. Bitte lesen Sie die Details in der Dokumentation des Vokabularservers nach.

Update Archivverwaltung

Dieser Punkt betrifft Installationen, die das Archivmanagement-Plugin verwenden. Prüfen, ob dieses installiert ist:

ls -ahl /opt/digiverso/goobi/plugins/administration/*archive*management*jar

Die Daten der Archivverwaltung werden nicht mehr in einer BaseX-Datenbank gespeichert, sondern in die Goobi workflow-Datenbank migriert. Beim Update müssen die folgenden Punkte abgearbeitet werden:

1. Der aktuelle Zustand der Archive muss gesichert werden. Dafür unter https://URL/basex/dba/login einloggen. Dann unter Databases jede Datenbank auswählen, die .xml-Dateien auswählen und herunterladen.

2. BaseX stoppen:

systemctl stop basexhttp.service

1. Konfiguration anpassen: Öffnen Sie die Datei /opt/digiverso/goobi/config/plugin_intranda_administration_archive_management.xml und entfernen Sie die folgenden Zeilen:

<basexUrl>http://localhost:8984/</basexUrl>
<eadExportFolder>/opt/digiverso/basex/import</eadExportFolder>

Fügen Sie stattdessen die folgenden Blöcke hinzu:

    <export>
        <!-- examples -->
        <!--
        <file name="archive1.xml">
            <folder>/opt/digiverso/viewer/hotfolder/</folder>
        </file>
        <file name="archive2.xml">
            <folder>/opt/digiverso/viewer01/hotfolder/</folder>
            <folder>/opt/digiverso/viewer02/hotfolder/</folder>
        </file>
        -->
    </export>
    <backup>
        <!-- backup folder -->
        <folder>/tmp/</folder>
        <!-- number of backups for each inventory -->
        <numberOfFiles>10</numberOfFiles>
        <!-- tool to create the backup files -->
        <tool>/usr/bin/mysqldump</tool>
        <!-- database password. The user name, database name, tables etc. can be recognised automatically, but the password must be entered.-->
        <!-- Leave empty if access is possible without authentication (e.g. configured in ~/.my.cnf)  -->
        <password></password>
    </backup>

1. Rechte anpassen: Nach dem Update müssen die folgenden Rechte für den vollständigen Zugriff vorhanden sein:

Plugin_Administration_Archive_Management
Plugin_Administration_Archive_Management_Write
Plugin_Administration_Archive_Management_Upload
Plugin_Administration_Archive_Management_New
Plugin_Administration_Archive_Management_Vocabulary
Plugin_Administration_Archive_Management_All_Inventories
Plugin_Administration_Archive_Management_Delete

1. Archiv-Plugin öffnen und EAD-Dateien importieren.

2. Optional: Export für den Viewer konfigurieren: Ob schon EAD Dateien im Viewer vorhanden sind, kann unter VIEWERURL/archives/ nachgeschaut werden. Falls die EAD-Dateien auch im Viewer sichtbar sein sollen, konfigurieren Sie den <export>-Bereich. Zu exportierende Dateien und der Hotfolder müssen dort angegeben werden.

3. Automatische Aufgaben einrichten: Führen Sie folgenden Befehl aus, um automatische Exporte zu konfigurieren:

echo -e "\n#Automatic export archive\nintranda_quartz_exportEadFile=0 0 0 * * ?" >> /opt/digiverso/goobi/config/goobi_config.properties

1. BaseX deinstallieren: Nachdem das Goobi workflow-Update erfolgreich getestet wurde und die Archive wie gewünscht funktionieren, kann BaseX deinstalliert werden:

BAK=/home/intranda/BACKUP/$(date -I) && mkdir $BAK -p
mv /etc/systemd/system/basexhttp.service $BAK
mv /opt/digiverso/basex/ $BAK
systemctl daemon-reload

Entfernen Sie zusätzlich den folgenden Block aus der Apache-Konfiguration:

    redirect 301 /basex http://example.com/basex/
    <Location /basex/>
            Require ip 1.2.3.4
            ProxyPass http://localhost:8984/ retry=0
            ProxyPassReverse http://localhost:8984/
    </Location>

Anpassungen an der Konfiguration des goobi-plugin-export-configurable-Plugins

Einige Tag-Namen und Typen haben sich geändert, z.B. ist <folder> jetzt <includeFolders>, and <includeMedia>true</includeMedia> ändert sich zu <media enabled="true"/>. Die Referenz-Config findet sich hier.

24.04

Anpassungen an der Konfiguration des newspaperRecognizer-Plugins

Die Config Datei plugin_intranda_step_newspaperRecognizer.xml muss der folgende Block vorhanden sein:

<config_plugin>
	<defaultDepth>1</defaultDepth>
	<loadAllImages>true</loadAllImages>
	<showWriteMetsButton>true</showWriteMetsButton>
    <showDeletePageButton>false</showDeletePageButton>
	<dateFormatDelimiter>.</dateFormatDelimiter>
	<writePageTitle>true</writePageTitle>
    
	<pagination>
		<createNewPagination>true</createNewPagination>
		<type>1</type>
		<useFakePagination>false</useFakePagination>
	</pagination>
</config_plugin>

Dabei muss die vorhandene Konfiguration übernommen werden.

Anpassungen an der Archive Management Config

Wenn in /opt/digiverso/goobi/config/plugin_intranda_administration_archive_management.xml folgendes steht:

<useShelfmark>true</useShelfmark>

muss dies durch das folgende Ersetzt werden:

<title name="shelfmarksource" type="NORMAL" />
<title name="TitleDocMain" type="CAMEL_CASE" />

Wenn useShelfmark auf false steht, muss nichts angepasst werden.

24.02

Config Editor im Core

Mit der neuen Version ist das Plugin für den Konfigurationseditor in den Goobi workflow core integriert worden. Dazu müssen bei einem Update einige Punkte beachtet werden: Das alte Plugin muss gelöscht werden, und die Konfigurationsdatei muss umbenannt werden.

rm /opt/digiverso/goobi/plugins/administration/plugin_intranda_administration_config_file_editor.jar
rm /opt/digiverso/goobi/plugins/GUI/plugin_intranda_administration_config_file_editor-GUI.jar
cd /opt/digiverso/goobi/config/
if [ -f "plugin_intranda_administration_config_file_editor.xml" ]; then
    mv -i plugin_intranda_administration_config_file_editor.xml goobi_configeditor.xml
else
    if [ ! -f "goobi_configeditor.xml" ]; then
        wget https://raw.githubusercontent.com/intranda/goobi-workflow/master/install/config/goobi_configeditor.xml
    fi
fi

Korrektur des Berechtigungsnamens:

mysql goobi -NBse "update benutzergruppen set roles=REPLACE(roles,'Plugin_administration_config_file_editor','Admin_config_file_editor') where roles regexp 'Plugin_administration_config_file_editor'"

Anpassungen an plugin_step_rename_files

In dem Plugin wurde Funktionalität zum Konfigurieren ergänzt. Damit sich das Plugin nach dem Update gleich verhält, muss auch der folgende Block in jedem <config>...</config> ergänzt werden:

	<namepart type="counter">
        0000
        <condition value="{originalfilename}" matches="^(?!.*barcode).*$" />
    </namepart>
    <namepart type="static">
        0000
        <condition value="{originalfilename}" matches="^.*barcode.*$" />
    </namepart>

22.12

Konfigurationsanpassung für das "Generischer XML Import"-Plugin

Dieser Punkt kann ignoriert werden, wenn der Plugin nicht in Verwendung und damit der Output dieses Befehls leer ist:

Falls ja: In der goobi_opac.xml wurde die gesuchte ID bisher der Katalogadresse einfach angehängt, jetzt muss bei einem Katalog mit dem opacType="intranda_opac_xml" dafür {pv.id} geschrieben werden. Beispiel:

Die Änderung ermöglicht die Suche in XML-Dateien (address="file:///import/hotfolder/{pv.id}.xml").

22.11

WebAPI ist deprecated

Die WebAPI ist veraltet, stattdessen wird die Nutzung der REST-API empfohlen. Die WebAPI ist nun per Default deaktiviert, bei Bedarf lässt sie sich wieder einschalten:

Änderung der Konfigurationsdatei des Plugins goobi_plugin_administration_data_poller

Durch ein Update des Plugins muss ein type="" für jede <rule> gesetzt werden. Der Typ von bestehenden Regeln ist immer filter. Dafür muss in der Config-Datei plugin_intranda_administration_data_poller.xml in jedem <rule>-Tag type="filter" gesetzt werden. Dabei hat sich der Name der Config Datei von plugin_intranda_administration_catalogue_poller.xml auf plugin_intranda_administration_data_poller.xml geändert.

22.10

Umbenennung vom Data Poller

Das Goobi workflow Plugin: Catalogue Poller wurde zu Data Poller umbenannt. Statt plugin_intranda_administration_catalogue-poller.jar heisst die Datei jetzt plugin_intranda_administration_data-poller.jar und ist aus GitHub downloadbar: https://github.com/intranda/goobi-plugin-administration-catalogue-poller Gleichzeitig hat sich auch der Name der Config Datei geändert von plugin_intranda_administration_catalogue_poller.xml zu plugin_intranda_administration_data_poller.xml

Neue Configdatei: goobi_exportValidation.xml

Mit der neuen Version muss goobi_exportValidation.xml als neue Konfigurationsdatei hinterlegt werden.

22.09

Der Schalter für Proxy-Nutzung wurde umbenannt

Statt http_useProxy heißt es nun http_proxyEnabled. Neu ist die Option http_proxyIgnoreHost mit dem Default:

Änderung per Kommandozeile:

Änderung der Konfigurationsdatei für goobi-plugin-step-createfullpdf

Bitte die Datei plugin_intranda_step_createfullpdf.xml entsprechend anpassen. Alt:

Neu:

Änderung am Escaping für LDAP User

Im Hintergrund hat sich etwas am Escaping geändert. Dies muss in der DB angepasst werden.

22.08

Tomcat

Prüfen, dass der tomcat-lib Ordner nicht mehr als PreResources eingebunden ist in:

• /etc/tomcat9/Catalina/localhost/{goobi,itm}.xml

Update des URN-Generators nötig

Sofern verwendet, muss die urn-generator.jar aktualisiert werden.

Konfigurationsänderung für das goobi-plugin-export-configurable

Die Optionen exportFolder und useSubFolderPerProcess werden nun direkt aus der Projektkonfiguration (Administration -> Projekte -> Projekt bearbeiten > Technische Daten) gelesen und sollten aus der Konfigurationsdatei plugin_intranda_export_configurable.xml gelöscht werden. Die Projektkonfiguration ist anzupassen: "Export-Verzeichnis für XML-Datei" und "Export-Verzeichnis für die Bilder" an Stelle von exportFolder, "Erzeuge Vorgangsverzeichnis" an Stelle von useSubFolderPerProcess.

Außerdem wurde die Option includeDerivate umbenannt in includeMedia:

22.07

Geänderte Bildanzeige in Laufzetteln

Diesen Punkt nur anwenden, wenn diese Funktion verwendet wird. Wenn die folgende SQL-Query keine Ergebnisse liefert, wird diese Funktion nicht genutzt: mysql goobi -NBse 'select * from journal where type="file" limit 10'

In der Konfigurationsdatei goobi_rest.xml muss dieser Block vorhanden sein, um die Bilder auf Laufzetteln anzeigen zu können:

Die Änderung mit xmlstarlet vornehmen:

Bildkommentare umziehen

Diesen Punkt nur anwenden, wenn diese Funktion verwendet wird. Bildkommentare sind nur in Verwendung, wenn MetsEditorShowImageComments oder ShowImageComments in der goobi_config.properties aktiv (true) ist. Damit eventuell vorhandene Bildkommentare vom bisherigen Ort an den neuen Ort bewegt werden, kann das folgende Script aufgerufen werden (Ordnernamen ggf. anpassen):

Warteschlangen-Dateien löschen

Für ein Versionsupdate von ActiveMQ sollten die Dateien für die Goobi Warteschlangen gelöscht werden (wenn sie leer sind, einsehbar in Administration > Warteschlangen):

22.06

2022-06-29

In der Apache-Config finden sich ggf. noch veraltete Optionen, die das Funktionieren von Websockets unter Umständen verhinden. Diese beiden Zeilen löschen:

22.05.7

2022-06-12

Der MySQL-Connector wurde noch einmal aktualisiert. Das zieht folgende Änderung nach sich:

2022-05-05

Der MySQL-Connector wurde aktualisiert. Das zieht folgende Änderung nach sich:

2022-05-04

Das Delivery-Plugin für die Universitätsbibliothek Leiden wurde umbenannt. Statt plugin_intranda_step_file-delivery.jar heisst die Datei jetzt plugin_intranda_step_leiden_file_delivery.jar und ist aus GitHub downloadbar: https://github.com/intranda/goobi-plugin-step-leiden-file-delivery

2022-05-03

Für die Verwendung von Bildkoordinaten müssen die Regelsätze angepasst werden. Die folgenden Metadatenelemente müssen erzeugt werden:

Dieses Strukturelement muss erzeugt werden:

Und abschließend muss dieses Element noch innerhalb von page erlaubt werden:

Möglicherweise fehlt auch das Metadatum _dateDigitization im Regelsatz für manche Dokumententypen. Alles zusammen lässt sich so automatisieren:

2022-05-02

Für das Archiv-Management (sofern installiert) muss eine zusätzliche xq-Datei an der richtigen Stelle vorhanden sein. Diese kann so heruntergeladen werden:

2022-04-19

Zeilenumbrüche in der goobi_projects.xml können sich auf das Genererieren des Prozesstitels beim Anlegen neuer Prozesse auswirken. Die XML-Datei kann man so neu formatieren (dabei geht die Formatierung insbesondere mehrzeiliger Kommentare verloren):

2022-03-21

2022-02-25

goobi-plugin-import-excel: config angepasst:

Die alte Version:

Wird ersetzt durch:

Skript dafür:

2022-02-16

Database und Tomcat Systemanforderungen

Goobi workflow benötigt nun Tomcat 9 und MariaDB >= 10.1

Metadata editor: Dateimanipulation nun per Default deaktiviert

Falls "Reihenfolge der Seiten" unter "Paginierung" vermisst wird:

Plugin umbenannt: Sword export

• Die Plugin-Jar-Datei hat sich geändert von plugin_intranda_export_mycore.jar zu plugin_intranda_export_sword.jar.

• Die Plugin-Konfigurationsdatei ändert sich entsprechend:
• Der Pluginname ändert sich von plugin_intranda_mycore_export zu intranda_export_sword:

2022-02-09

Seit einiger Zeit unterstützt Goobi workflow WebSockets. Dafür muss dessen Unterstützung in dem Apache Webserver in die Konfiguration mit aufgenommen werden:

Anschließend das benötigte Modul aktivieren und den Dienst neu starten:

2022-02-09

Die Datei docket_metadata.xsl muss ausgetauscht werden:

23.10

Änderung der Konfigurationsdatei des Plugins goobi_plugin_workflow_fileupload_processcreation

Mit dem Update hat sich das Naming Schema geändert. In der Config Datei plugin_intranda_workflow_fileUploadProcessCreation.xml müssen die / am Anfang und Ende im <namingSchema> Tag entfernt werden. Vorher:

Nachher:

activemq soll nicht von außen Erreichbar sein

Wenn grep -e '0.0.0.0' -e ':::61613' -e '0.0.0.0:61613' /opt/digiverso/goobi/config/goobi_activemq.xml && netstat -tulpn | grep -e ':::61613' -e '0.0.0.0:61613' nichts anzeigt muss hier nichts gemacht werden.

In /opt/digiverso/goobi/config/goobi_activemq.xml müssen die beiden folgenden Zeilen auf localhost gestellt werden:

Es kann bei einigen Anwendungsfällen vorkommen, dass eine offene activemq gewünscht ist.

Umbenennung vom Plugin Barcode Scanner

Das Goobi workflow Plugin: Barcode Scanner wurde umbenannt damit, es in unser Benennungsschema passt. Statt plugin_intranda_step-barcode_scanner.jarheisst die Datei jetzt plugin_intranda_step_barcode_scanner.jar.

23.05

Neue Configdatei: goobi_mail.xml

Mit der neuen Version wird der Mailversand an einer zentralen Stelle konfiguriert, dafür muss goobi_mail.xml als neue Konfigurationsdatei hinterlegt werden und die Konfiguration für das Versenden von Mails in die Config überführt werden. Die folgenden Plugins versenden Mails: goobi-plugin-step-sendMail und goobi-plugin-step-leiden-file-delivery

23.04

Bildkommentare werden als Prozesseigenschaft gespeichert

Bildkommentare wurden bisher im images/-Ordner als Datei comments_*.json gespeichert. Stattdessen werden sie nun als Prozesseigenschaft image comments * gespeichert. Soll auf die bisherigen Kommentare weiter zugegriffen werden können, sind diese zu migrieren. Dieser Punkt kann ignoriert werden, wenn die Anzeige der Bildkommentare nicht explizit auf true gesetzt wurde:

23.03

Änderung von Parametern in goobi_config.properties

Durch das Update haben sich die Parameter dailyDelayJob, dailyVocabJob und dailyHistoryAnalyser verändert. Diese wurden vorher durch Sekunden nach Mitternacht angegeben und wurden jetzt durch eine Cron Syntax ersetzt. Dies sieht z.B. wie folgt aus:

Dabei steht keine Angabe für nicht aktiviert was vorher -1 war.

Wenn der folgende Befehl nichts ausgibt, muss nichts gemacht werden:

23.02

Änderung der Konfigurationsdatei des Plugins goobi_plugin_administration_data_poller

Durch ein Update des Plugins gibt es eine neue Konfigurationsmöglichkeit zum Aktivieren und Deaktivieren einzelner Aufträge. Diese Option muss bei einem Update hinzugefügt werden. Dafür muss in der Config-Datei plugin_intranda_administration_data_poller.xml in jedem <rule>-Tag enabled="false" oder enabled="true" ergänzt werden.

Zusätzlich gibt es jetzt die Option Metadaten mit einer White- oder Blacklist zu filtern. Dies war vorher nur über <skipField> möglich. Bestehende Configs müssen in die neuen Listen überführt werden. Dazu müssen die <skipField> in <field> umgewandelt und zusätzlich der Tag <fieldList mode="blacklist"> </fieldList> um die <field>-Tags ergänzt werden.

Mit dem folgenden können die <skipField>-Tags einfach umbenannt werden:

23.01

Änderung der Konfigurationsdatei des Plugins intranda_step_pdf-extraction

Im typischen Anwendungsfall möchte man den als CropBox bezeichneten Bereich einer PDF-Seite extrahieren. Da ohne weitere Konfiguration die MediaBox genutzt wird, sollte man die Option <generatorParameter>-cropbox</generatorParameter> im images-Block setzen. Zum Beispiel so:

2020-09-17

Im imageQA Plugin hat sich die Konfiguration der Rotations- und Löschbefehle geändert. Diese müssen angepasst werden.

Dies ist die alte Konfiguration:

Die neue sieht folgendermaßen aus:

2020-08-09

Umbenennung des Excel-Import-Plugins

Das generische Excel-Import-Plugin wurde von plugin_intranda_import_generic_excel.jar zu plugin_intranda_import_excel.jar umbenannt. Dies hat ebenso einen Einfluß auf die Konfigurationsdatei. Diese heisst statt plugin_intranda_import_excel_read_headerdata.xml von nun an plugin_intranda_import_excel.xml.

2020-07-31

Neues Default-Namensschema für den Master-Ordner

Der Default-Name des Masterordners hat sich von master_{processtitle}_media zu {processtitle}_master geändert. Wahlweise kann man nun die Ordnerstruktur in allen Vorgängen anpassen, oder bei dem bisherigen Schema bleiben - dafür wird eine Konfigurationsoption hinzugefügt:

Wurden bisher beispielsweise die Ordner orig_{processtitle}_tif und {processtitle}_tif für Master und Derivate verwendet, also die Einstellung

Dann muss dieses nun durch folgendes in /opt/digiverso/goobi/config/goobi_config.properties ersetzt werden:

Wurde weiterhin bisher die Option MetsEditorDefaultSuffix=jpeg verwendet, so muss dies nun wie folgt ersetzt werden:

2020-07-29

intranda_step_changeWorkflow

Mit dieser Datei lässt sich das automatisieren:

Ausführen:

Umbenennung des XMP-Plugins

Das Plugin goobi-plugin-step-xmp-header wurde intern umbenannt von write-xmp zu intranda_step_xmp_header. Dafür ist diese Datenbankanpassung nötig:

2020-07-01

Escaping in Configdateien

Der Konfigurations-Parser wurde so umgestellt, dass die Kommata und Backslashes nicht mehr escaped werden müssen. Es müssen alle Vorkommnisse von \, durch , und \\ durch \ersetzt werden. Stattdessen werden nun | in xml-Attributen escaped. Betroffen sind die folgenden Dateien unterhalb von /opt/digiverso/goobi/config/:

• plugin_*.xml

• goobi_projects.xml

• plugin_metadata_easydb.xml

• goobi_opac.xml

• goobi_exportXml.xml

• goobi_metadataDisplayRules.xml

• goobi_mail.xml

• goobi_rest.xml

• goobi_webapi.xml

• goobi_hotfolder.xml

• goobi_processProperties.xml

Betroffene Dateien finden (Backslashes) - bitte manuell anpassen:

Betroffene Dateien finden (Pipezeichen):

Betroffen ist hier vermutlich nur die goobi_projects.xml, die man so anpassen kann:

Für das Plugin goobi-plugin-step-xmpheader ändert sich, wie die Parameter für das exiftool angegeben werden:

ImageQA-Plugin

Die Ordner-Benennung hat sich geändert:

2020-05-08

Sofern das Plugin für den Generischen Excel Import verwendet wird, muss in der Konfigurationsdatei das Mapping der Metadaten angepasst werden. Das Attribut name wurde umbenannt zu property:

2020-03-25

Sofern das Plugin LayoutWizzard installiert ist, muss in dessen Konfigurationsdatei der Abschnitt ab <contentBorder> bis </preview> durch folgenden Abschnitt ersetzt werden:

2020-03-05

Laufzettel

Das Styling der Laufzettel wurde angepasst und eine Unterstützung für hebräische Schriftzeichen hinzugefügt. Sofern die Laufzettel nicht individuell angepasst wurden, können die Dateien 1:1 ersetzt werden. Dafür sollte die Generierung vorher einmal in der Oberfläche probiert werden. Die folgenden Schritte sind defensiver formuliert, um ein versehentliches automatisches Überschreiben zu verhindern:

Die vorherigen Standard XSLT Dateien haben den folgenden MD5 Hash:

Nach Abschluss der Arbeiten sollte die Generierung der Laufzettel erneut überprüft werden.

LDAP-Konfiguration

Die Konfiguration des LDAPs wurde aus der Konfigurationsdatei in die Datenbank migriert. Nach dem Update kann der entsprechende Block aus der Datei goobi_config.properties entfernt werden.

2020-02-12

Für die ActiveMQ Schnittstelle müssen die zur Verfügung stehenden Ressourcen angegeben werden:

2020-01-30

Da man nur als Superadmin andere Nutzer zum Superadmin machen kann, sollte ein Account beim Update von Hand in der Datenbank gesetzt werden. Anschließend können weitere Accounts per Checkbox in der Benutzerverwaltung angepasst werden.

Dabei helfen die folgenden SQL Statements:

2020-01-18

Goobi workflow verwendet nun log4j2 und bringt dafür eine eigene Konfigurationsdatei mit. Deshalb müssen die überschreibenden Einträge aus der /etc/default/tomcat8 entfernt werden:

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.

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:

• Konfigurationsdateien auf XML-Fehler prüfen:

• Es kann vorkommen, dass in der Datenbank Benutzeraccounts ohne Authentifizierungsart stehen. Diese können mit dem folgenden SQL Statement zur Korrektur ermittelt werden. Sofern das Kommando etwas ausgibt, müssen die entsprechenden Benutzer in der Datenbanktabelle gesucht und korrigiert werden:

• Für alle Datenbanktabellen verwendet Goobi workflow InnoDB:

• goobi_opac.xml: Bei mehrbändigen Werken muss der rulesetChildType gesetzt sein ().

• goobi_projects.xml: Es darf kein BoundBook mehr auftauchen ().

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:

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:

• Annehmen und Abgeben von Aufgaben, insbesondere das Verlinken (gegebenenfalls Mounten) des Image-Ordners ins Homeverzeichnis

• Bildanzeige im ImageQA Plugin

• Bild- und Thumbnailanzeige im Metadateneditor

• Bildanzeige im LayoutWizzard Plugin

• Generierung von Laufzetteln

• Übergabe von Jobs an den intranda TaskManager sowie eine Rückmeldung im Vorgangslog wenn ein Job im TaskManager abgebrochen wird (bei Änderungen an der Kommunikation zwischen Goobi workflow und dem TaskManager)

• Katalogabfragen

• Alle Plugins sind aktuell in: Administration -> Installierte Plugins

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:

2021-12-16

Das Statistics-Plugin exportiert nun XLSX statt XLS, dafür wird die Template-Datei getausch. Zu ersetzen ist /opt/digiverso/goobi/plugins/statistics/statistics_template.xls durch https://github.com/intranda/goobi-plugin-statistics-intranda/releases/latest/download/statistics_template.xlsx.

2021-12-13

Die Konfiguration für konfigurierbare Delay-Plugin wurde auf das gleiche Schema angepasst wie die anderen Step-Plugins. Dazu muss die Konfigurationsdatei plugin_intranda_delay_configurable.xml beispielhaft wie folgt angepasst werden:

2021-11-25

Die Konfiguration für das generateIdentifier-Plugin muss um ein <type> ergänzt werden in der plugin_intranda_step_generateIdentifier.xml, da sich der Default von random zu uuid geändert hat:

2021-11-11

Die kompilierte Datei für das Plugin plugin_intranda_step_move_folder_to_master wurde so umbenannt, wie das Plugin heisst. Für die Installation heisst das dass die bisher installierte Plugindatei nun durch eine neue ersetzt wird:

2021-11-06

Für das Catalogue-Poller-Plugin gab es eine ähnliche Änderung in der Konfigurationsdatei plugin_intranda_administration_catalogue_poller.xml wie beim Catalogue-Request-Plugin. Hier ist der Feldname nun ebenfalls konfigurierbar:

2021-11-06

Für das Catalogue-Request-Plugin gab es eine Änderung in der Konfigurationsdatei plugin_intranda_step_catalogue_request.xml, so dass Parameter zusammengelegt wurden. Hier muss natürlich auf die jeweilige Konfiguration der Installation geachtet werden:

2021-10-12

Falls noch Datenbank-Tabellen das Row Format Compact nutzen, sollte dies auf Dynamic geändert werden. Beispielsweise so (ggf. Datenbanknamen anpassen):

2021-09-28

Innerhalb der Konfiguration für das xmp-header Plugin ist die Definition der Ordner anders. Hierzu muss in der Konfigurationsdatei plugin_intranda_step_xmp_header.xml folgende Änderung vorgenommen werden:

2021-09-23

Innerhalb der Konfigurationsdatei goobi_opac.xml ist ein eventueller Tippfehler zu korrigieren. Statt MultivolumeWork muss es hier MultiVolumeWork heissen:

2021-09-09

Die Speicherung der Keystore-Informationen erfolgt nun nicht mehr aus der Nutzeroberfläche von Goobi workflow sondern über eine Konfiguration innerhalb der Konfigurationsdatei goobi_config.properties. Dort kann nun der Keystore wie folgt definiert werden:

2021-09-03

Es wurden einige Änderungen an den SQL-Queries in Goobi workflow vorgenommen, die vor einem Update diese statements nötig machen:

Außerdem sollten noch alte Daten gelöscht werden, die in der Vergangenheit nicht automatisch gelöscht wurden.

2021-09-01

Ab dem 1.9.2021 läuft Goobi worflow nur noch mit Java 11. Das Paket openjdk-11-jre-headless ist für Ubuntu-Nutzer eine gute Wahl.

Falls die Workflow runnable Jars enthält (z.B. urn-generator.jar), müssen diese auch aktualisiert werden.

2021-07-16

Das Import-Plugin plugin_intranda_import_mab_file wurde umbenannt zu plugin_intranda_import_sisis_sunrise_file. Entsprechend müssen die folgenden Dateien durch neue Versionen ersetzt werden und die Konfigurationsdatei entsprechend umbenannt werden:

2021-07-12

In der Konfigurationsdatei plugin_intranda_step_changeWorkflow.xml muss der Name der zu prüfenden Eigenschaft angepasst werden, weil hier der Variablen-Replacer zum Einsatz kommt. Die verwendeten Werte müssen entsprechend geprüft und in Anlehnung an dieses Beispiel angepasst werden:

2021-06-23

Für eine bessere Performance bei Datenbankabfragen (z.B. beim Aufruf der Prozessliste) folgende Statements ausführen:

Das Erstellen der Indexe und Ändern der Datenbanktabellen kann für große Datenbestände mehrere Minuten dauern, und wird deshalb hier händisch und nicht automatisch beim Update ausgeführt.

2021-03-24

Für die Laufzettel wurde der Ausdruck für die Anzeige des Anlegedatums für den Vorgang geändert, um ihn zu zu homogenisieren. Statt des bisherigen Ausdrucks goobi:time muss innerhalb der xsl-Dateien zu dem Ausdruck goobi:creationDate geändert werden. Dies betrifft üblicherweise die Laufzettel-Dateien unter folgenden Pfaden:

Hier noch einmal eine die detaillierte Änderung am Beispiel:

2021-01-09

Das Plugin intranda_dashboard_example wurde umbenannt zu intranda_dashboard_extended. Auf dem System müssen daher beim Update die bisherigen Dateien durch die Dateien mit neuen Namen ersetzt werden:

Die bereits auf den Systemen vorhandene Konfigurationsdatei plugin_intranda_dashboard_extended.xml kann so unverändert weiter vorhanden bleiben.

Für künftige Updates und Installationen ist zu beachten, dass das Git-Repository und das das Maven-Artefakt aus Jenkins ebenfalls an den neuen Namen plugin_intranda_dashboard_extended angepasst wurden.

2021-01-03

Das Plugin intranda_statistics_sudan_activity_by_user wurde umbenannt zu intranda_statistics_sudan_memory_activity_by_user. Auf dem System müssen daher beim Update die bisherigen Dateien durch die Dateien mit neuen Namen ersetzt werden: