Goobi workflow
DokumentationenGoobi workflow PluginsGoobi workflow Digests
Deutsch
Deutsch
  • Übersicht
    • Goobi workflow Handbuch
    • Dokumentationsübersicht
    • Was ist Goobi?
  • Anwender
    • Goobi für Anwender
    • Allgemeines
      • Einloggen
      • Menü
      • Ausloggen
      • Sprachumschaltung
      • Hilfefunktion
      • Eigene Einstellungen
      • Passwort ändern
      • Meine Aufgaben
      • Vorgänge
      • Nach einem Vorgang suchen
      • Anlegen von Vorgängen
      • Aufgabendetails bearbeiten
    • Arbeiten mit Goobi für spezielle Benutzergruppen
      • Scannen
      • Qualitätskontrolle
      • Manuelle Skriptschritte und Pluginschritte
      • Automatische Skriptschritte
      • Metadatenbearbeitung
      • Export in das DMS
    • Metadateneditor
      • Oberfläche
        • Strukturbaum
        • Seitenanzeige
        • Menüoptionen
      • Metadaten bearbeiten
        • Paginierung
        • Strukturierung
          • Neue Strukturelemente hinzufügen
          • Strukturelemente verschieben
          • Kopieren von Strukturelementen aus anderen Vorgängen
      • Änderung und Prüfung von Daten
        • Paginierung nachträglich ändern
        • Datei hochladen
        • Datei herunterladen
        • Serverseitiges exportierten
        • Serverseitiges importieren
      • OCR Ergebnisse bearbeiten
      • Übersicht über die Tastenkombinationen
  • Verwaltung
    • Die Verwaltung von Goobi
    • Aufbau der erweiterten Nutzeroberfläche
    • Regelsätze
    • LDAP-Gruppen
    • Benutzer
    • Benutzergruppen
    • Vorgänge
      • Vorgänge suchen
      • Aktionen
      • Aktionen für Trefferlisten
      • GoobiScript
    • Variablensystem
    • Harvester
  • Administration
    • Die Administration von Goobi
    • Dateisystem
      • Globale Verzeichnisstruktur
        • Unterverzeichnis ‚config’
        • Unterverzeichnis ‚import’
        • Unterverzeichnis ‚metadata’
        • Unterverzeichnis ‚plugins’
        • Unterverzeichnis ‚rulesets’
        • Unterverzeichnis ‚scripts’
        • Unterverzeichnis ‚xslt’
      • Verzeichnisstruktur der Applikation
      • Einbindung von externem Storage
      • Einbindung von S3 als Storage
    • Dienste
      • Datenbank MySQL
      • Servlet Container Apache Tomcat
      • Authentifizierung der Nutzer mittels LDAP
      • Dateisystemzugriff mittels Samba
    • Export in digitale Bibliotheken
      • Technische Daten
      • Mets Parameter
      • Mets Dateigruppen
      • Konfiguration des Exports in der Goobi Konfigurationsdatei
    • Zusammenarbeit mit dem intranda Task Manager
    • Automatische Workflowschritte
      • Beispielkombination für einen automatischen Skript Schritt
      • Migration technischer Metadaten in METS-Dateien
      • Automatisches Löschen von Images
    • Konfigurationsdateien
      • goobi_activemq.xml
      • goobi_config.properties
      • goobi_digitalCollections.xml
      • goobi_exportXml.xml
      • goobi_mail.xml
      • goobi_metadataDisplayRules.xml
      • goobi_normdata.xml
      • goobi_opac.xml
      • goobi_opacUmlaut.txt
      • goobi_processProperties.xml
      • goobi_projects.xml
      • goobi_rest.xml
      • goobi_webapi.xml
      • messages_xx.properties
      • config_contentServer.xml
    • Installationsanleitung
      • Installationsanleitung - Ubuntu 20.04
    • Updateanleitung
      • Vorbereitung eines Updates
      • Updateschritte
        • 2020
        • 2021
        • 2022
        • 2023
        • 2024
        • 2025
    • Möglichkeiten der Authentifizierung
      • Authentifizierung über die Datenbank
      • Authentifizierung über HTTP-Header
      • Authentifizierung über OpenID Connect
    • Anwendungsszenarien
      • Thumbnails erzeugen für beschleunigte Bildanzeige
      • Umgang mit 3D Objekten
      • Export von 3D-Objekten in den Goobi viewer
  • Entwickler
    • Aufsetzen einer Entwicklungsumgebung
      • Vorbereitende Arbeiten
      • Einrichtung von Eclipse
      • Zurücksetzen der Daten
      • Best Practice für die Entwicklung von Goobi und für die Arbeit mit Eclipse
    • Nutzung der REST-API
    • Snippets für die Entwicklung an Goobi workflow
      • HTML
      • JavaScript
Bereitgestellt von GitBook
Auf dieser Seite
  • 24.11
  • Artist Dictionary
  • Anpassung an goobi-plugin-workflow-mass-upload
  • Jhove Namespaceänderung in goobi-plugin-step-tif-validation
  • 24.10
  • Update des Vokabularservers
  • 24.09
  • Namensänderung LayoutWizzard Step Plugin
  • Sicherstellen das der Ordner goobi/plugins/metadata vorhanden ist
  • Plugin goobi-plugin-step-create-full-pdf
  • Archivmanagement: Neues Recht erforderlich
  • 24.08
  • Java-Version
  • Vokabularserver
  • 24.07
  • Vokabulare
  • Update Archivverwaltung
  • Anpassungen an der Konfiguration des goobi-plugin-export-configurable-Plugins
  • 24.04
  • Anpassungen an der Konfiguration des newspaperRecognizer-Plugins
  • Anpassungen an der Archive Management Config
  • 24.02
  • Config Editor im Core
  • Anpassungen an plugin_step_rename_files
Als PDF exportieren
  1. Administration
  2. Updateanleitung
  3. Updateschritte

2024

24.11

Artist Dictionary

Wenn folgende Plugins verwendet werden, müssen nach dem Update manuelle Schritte durchgeführt werden:

plugin-dashboard-entity
plugin-export-luxembourg-artist-dictionary
plugin-workflow-entity-editor

Diese Plugins verwenden Vokabulare, um Relationen zwischen Entitäten zu verwalten. Zuvor gab es zwei Relationen R03a Relationship Person - Collective agent und R03b Relationship Collective agent - Person, die zusammen die Relation zwischen Personen und Agenten beschrieben haben. Alle anderen Relationen waren nur in einem Vokabular vertreten.

Die neuen Versionen der Plugins erwarten nur noch ein einziges Vokabular R03 Relationship Person - Collective agent. Alle Einträge in R03b Relationship Collective agent - Person, die nicht bereits (invertiert) im Vokabular R03a Relationship Person - Collective agent vorhanden sind, müssen manuell übertragen werden. Danach ist das Vokabular R03b Relationship Collective agent - Person zu entfernen (temporär umzubenennen) und das Vokabular R03a Relationship Person - Collective agent in R03 Relationship Person - Collective agent umzubenennen.

Alle Konfigurationsdateien müssen entsprechend angepasst werden. Die Vokabularverweise in den Mets Dateien müssen anschließend korrigiert werden. Hierzu gibt es das Mets-Migrationsscript im Vokabularserver, der mit den Optionen --trust Value --enable-relation-vocabulary-column-logic -f gestartet werden kann.

Anpassung an goobi-plugin-workflow-mass-upload

Das Plugin wurde angepasst damit der Benutzer die Erkennungsmethode selber auswählen kann.

<use-barcodes>false</use-barcodes>

muss durch das folgende ersetzt werden:

<detection-type>filename</detection-type>

Wenn use-barcodes auf true gesetzt ist, muss der detection-type auf barcode gesetzt werden:

<detection-type>barcode</detection-type>

Jhove Namespaceänderung in goobi-plugin-step-tif-validation

In plugin_intranda_step_tif_validation.xml ändern:

-        <namespace uri="http://hul.harvard.edu/ois/xml/ns/jhove" name="jhove" />
+        <namespace uri="http://schema.openpreservation.org/ois/xml/ns/jhove" name="jhove" />

24.10

Update des Vokabularservers

Der Vokabularserver muss mindestens auf Version 1.1.9 geupdated werden.

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"/>

Archivmanagement: Neues Recht erforderlich

Für das Erstellen von Vorgängen aus dem Archivmanagemnet heraus wird nun das folgende Recht benötigt: Plugin_Administration_Archive_Management_Process

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
# 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

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

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

Dieser Punkt betrifft nur Installationen, in denen dieser Befehl einen Output hat:

xmlstarlet sel -t -c '//detection-type[.="barcode"]' -n /opt/digiverso/goobi/config/plugin_intranda_workflow_massupload.xml

Wird das barcode-Feature genutzt, muss 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>
Vorherige2023Nächste2025

Zuletzt aktualisiert vor 2 Monaten

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

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

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"/>.

Download
Dokumentation des Vokabularservers
Die Referenz-Config findet sich hier.