Goobi workflow
Documentation homeGoobi workflow PluginsGoobi workflow Digests
English
English
  • Overview
    • Goobi workflow Handbook
    • Overview of documentation
    • What is Goobi?
  • Users
    • Goobi for Users
    • The basics
      • Logging in
      • Menu
      • Logging out
      • Switch between available languages
      • Help function
      • Personal settings
      • Changing your password
      • My tasks
      • Processes
      • How to find a process
      • How to create a new process
      • Edit task details
    • How different user groups work with Goobi
      • Scanning
      • Quality control
      • Manual script steps and plugin steps
      • Automatic script-run steps
      • Metadata processing
      • Export to the DMS
    • Metadata Editor
      • User interface
        • Structure tree
        • Page display
        • Menu options
      • Metadata indexing
        • Pagination
        • Structuring
          • Create new structure element
          • Moving structure elements
          • Copying structure elements from other processes
      • Modifying and verifying data
        • Subsequent changes to pagination
        • Uploading files
        • Downloading files
        • Server-based exports
        • Server-based imports
      • Edit OCR results
      • Overview of the keyboard combinations
  • Management
    • Goobi Management
    • Structure of the extended user interface
    • Rulesets
    • LDAP groups
    • Users
    • User groups
    • Processes
      • Searching processes
      • Activity
      • Activities for hit lists
      • GoobiScript
    • Variables
    • Harvester
  • Administration
    • Goobi Administration
    • File system
      • Global directory structure
        • ‘config’ sub-directory
        • ‘import’ sub-directory
        • ‘metadata’ sub-directory
        • ‘plugins’ sub-directory
        • ‘rulesets’ sub-directory
        • ‘scripts’ sub-directory
        • ‘xslt’ sub-directory
      • Directory structure of the application
      • Integrating external storage
      • Integration of S3 as storage
    • Services
      • MySQL database
      • Apache Tomcat servlet container
      • User authentication using LDAP
      • File system access using Samba
    • Exporting to digital libraries
      • Technical data
      • Mets parameters
      • Mets file groups
      • Export configuration in the Goobi configuration file
    • Working with the intranda Task Manager
    • Automatic workflow steps
      • Example combination for an automatic script task
      • Migration of technical data to METS files
      • Automatic image deletion
    • Configuration files
      • 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
    • Installation guide
      • Installation guide - Ubuntu 20.04
    • Update guide
      • Preparation of an update
      • Update steps
        • 2020
        • 2021
        • 2022
        • 2023
        • 2024
        • 2025
    • Authentication options
      • Authentication via the database
      • Authentication via HTTP header
      • Authentication via OpenID Connect
    • Use cases
      • Create thumbnails for accelerated image display
      • Handling of 3D Objects
      • Export of 3D-Objects into the Goobi viewer
  • Developer
    • Setting up a development environment
      • Preparatory work
      • Setting up Eclipse
      • Resetting the data
      • Best practice for developing Goobi and working with Eclipse
    • Using the REST API
    • Snippets for the development on Goobi workflow
      • HTML
      • JavaScript
Bereitgestellt von GitBook
Auf dieser Seite
  • 2020-09-17
  • 2020-08-09
  • 2020-07-31
  • 2020-07-29
  • 2020-07-01
  • 2020-05-08
  • 2020-03-25
  • 2020-03-05
  • 2020-02-12
  • 2020-01-30
  • 2020-01-18
Als PDF exportieren
  1. Administration
  2. Update guide
  3. Update steps

2020

2020-09-17

In the ImageQA plugin, the configuration of the rotation and deletion commands has changed. These have to be adapted.

This is the old configuration:

<deletionCommand>/opt/digiverso/goobi/scripts/deleteImage.sh IMAGE_FOLDER IMAGE_FILE</deletionCommand>
<rotationCommands>
    <left>/usr/bin/mogrify -rotate -90 IMAGE_FILE</left>
    <right>/usr/bin/mogrify -rotate 90 IMAGE_FILE</right>
</rotationCommands>

The new one looks like this:

<deletion command="/opt/digiverso/goobi/scripts/deleteImage.sh|IMAGE_FOLDER|IMAGE_FILE"/>
<rotationCommands>
    <left command="/usr/bin/mogrify|-rotate|-90|IMAGE_FILE" />
    <right command="/usr/bin/mogrify|-rotate|90|IMAGE_FILE" />
</rotationCommands>

2020-08-09

Renaming of the Excel import plugin

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.

The generic Excel import plugin has been renamed from plugin_intranda_import_generic_excel.jar to plugin_intranda_import_excel.jar This also has an effect on the configuration file. Instead of plugin_intranda_import_excel_read_headerdata.xml this file is now called plugin_intranda_import_excel.xml.

2020-07-31

New default naming scheme for the master folder

The default name of the master folder has changed from master_{processtitle}_media to {processtitle}_master Optionally you can now adjust the folder structure in all operations or stay with the previous scheme - a configuration option is added for this:

echo 'process.folder.images.master=master_{processtitle}_media' >> /opt/digiverso/goobi/config/goobi_config.properties

If other folder names have been used, either adjust the above setting as necessary or perform all operations and steps.

For example, if the orig_{processtitle}_tif and {processtitle}_tif folders were previously used for master and derivatives, i.e. the setting

DIRECTORY_SUFFIX=tif
DIRECTORY_PREFIX=orig

Then this must now be replaced by the following in /opt/digiverso/goobi/config/goobi_config.properties

process.folder.images.master=orig_{processtitle}_tif
process.folder.images.main={processtitle}_tif

If the option MetsEditorDefaultSuffix=jpeg was previously used, this must now be replaced as follows:

process.folder.images.fallback={processtitle}_jpeg

2020-07-29

intranda_step_changeWorkflow

With this file this can be automated:

/tmp/addChangeElement.xsl
<?xml version="1.0" ?>
<xsl:stylesheet version="1.0" encoding="UTF-8" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
    <xsl:output encoding="UTF-8" version="1.0" indent="yes"/>

    <xsl:template match="config">
        <xsl:copy>
            <xsl:apply-templates select="comment() | @* | *[not(self::steps|self::propertyName|self::propertyValue)]" />
            <change><xsl:copy-of select="steps|propertyName|propertyValue"/></change>
        </xsl:copy>
    </xsl:template>

    <!-- IdentityTransform -->
    <xsl:template match="/ | @* | node()">
        <xsl:copy>
            <xsl:apply-templates select="@* | node()" />
        </xsl:copy>
    </xsl:template>

</xsl:stylesheet>

Execute:

file=/opt/digiverso/goobi/config/plugin_intranda_step_changeWorkflow.xml; xmlstarlet tr /tmp/addChangeElement.xsl ${file} | xmlstarlet fo -e utf-8 -s 4 >${file}.tmp; mv ${file}.tmp ${file}

The XMP plugin has been renamed

The plugin goobi-plugin-step-xmp-header has been renamed from write-xmp to intranda_step_xmp_header. Adjust the database:

mysql goobi -e 'update schritte set stepplugin="intranda_step_xmp_header" where stepplugin="write-xmp"'

2020-07-01

Escaping in configuration files

The configuration parser was changed so that the commas and backslashes no longer need to be escaped. All occurrences of \, must be replaced by , and \\ by \. Instead | in xml-attributes are now escaped. The following files under /opt/digiverso/goobi/config/ are affected:

Find affected files (backslashes) - please adjust manually:

grep -F -l -e '\\' -e '\,' /opt/digiverso/goobi/config/*.xml

Find affected files (pipe sign):

for i in /opt/digiverso/goobi/config/*.xml; do j=$(xmlstarlet sel -t -v '//@*[contains(.,"|")]' $i | grep -P '[^\\]\|'); test -n "$j" && echo -e "\n\n==> $i <==\n$j"; done

Probably only the goobi_projects.xml is affected here, which can be adapted as follows:

file=/opt/digiverso/goobi/config/goobi_projects.xml; xmlstarlet sel -t -v '//@*[contains(.,"|")]' -n "$file" | sort -u | perl -e 'print sort { length $b <=> length $a } <>' | while read i; do sed -i -e "s+${i}+${i//|/\\\\|}+g" "$file"; done

For the plugin goobi-plugin-step-xmpheader changes how the parameters for the exiftool are specified:

plugin:write-xmp.xml
-        <parameter>-overwrite_original, -q, -q, -m, {PARAM}, {FILE}</parameter>
+        <parameter>-overwrite_original</parameter>
+        <parameter>-q</parameter>
+        <parameter>-q</parameter>
+        <parameter>-m</parameter>
+        <parameter>{PARAM}</parameter>
+        <parameter>{FILE}</parameter>

ImageQA-Plugin

The folder name has changed:

plugin:intranda:step:imageQA.xml
-        <useOrigFolder>true</useOrigFolder>
+        <!-- which images to use , possible values are master|main|jpeg|source|... -->
+        <foldername>master</foldername>

2020-05-08

If the plugin is used for Generic Excel import, the mapping of the metadata must be adjusted in the configuration file. The attribute name was renamed to property:

plugin:intranda:import:excel:read:headerdata.xml
<!-- Old -->
<metadata headerName="XXX" docType="child" name="YYY"/>
<!-- New -->
<metadata headerName="XXX" docType="child" property="YYY"/>

2020-03-25

If the LayoutWizzard plugin is installed, the section from <contentBorder> to </preview> in its configuration file must be replaced by the following section

plugin:intranda:step:LayoutWizzard.xml
<!-- Config for appearance of single/large image -->
<singleImage>
    <cropFrame>
        <linewidth>2</linewidth>
        <linecolor>#00fa9a</linecolor>
        <fillcolor>#ffffff</fillcolor>
        <clickradius>20</clickradius>
        <fillcolor>#ffffff</fillcolor>
    </cropFrame>
    <spineMarker>
        <linewidth>2</linewidth>
        <linecolor>#ff0000</linecolor>
        <fillcolor>#ffffff</fillcolor>
        <clickradius>20</clickradius>
    </spineMarker>
</singleImage>

<!-- Config for appearance of images in preview mode -->
<preview>
    <cropFrame>
        <linewidth>2</linewidth>
        <linecolor>#368EE0</linecolor>
        <fillcolor>#f1f2f3</fillcolor>
        <clickradius>20</clickradius>
        <fillcolor>#f1f2f3</fillcolor>
    </cropFrame>
    <spineMarker>
        <linewidth>2</linewidth>
        <linecolor>#ff0000</linecolor>
        <fillcolor>#f1f2f3</fillcolor>
        <clickradius>10</clickradius>
    </spineMarker>
</preview>

2020-03-05

Dockets

The style of the dockets was adapted and support for Hebrew characters was added. If the routing slips have not been individually adapted, the files can be replaced 1:1. For this purpose, the generation should be tried out in the user interface before. The following steps are more defensively formulated to prevent accidental automatic overwriting:

TMPDIR=$(mktemp -d)
cd $TMPDIR
wget -q https://raw.githubusercontent.com/intranda/goobi/master/Goobi/install/xslt/config.xml
wget -q https://raw.githubusercontent.com/intranda/goobi/master/Goobi/install/xslt/docket.xsl
wget -q https://raw.githubusercontent.com/intranda/goobi/master/Goobi/install/xslt/docket_english.xsl
wget -q https://raw.githubusercontent.com/intranda/goobi/master/Goobi/install/xslt/docket_metadata.xsl
wget -q https://raw.githubusercontent.com/intranda/goobi/master/Goobi/install/xslt/docket_multipage.xsl
wget -q https://raw.githubusercontent.com/intranda/goobi/master/Goobi/install/xslt/font_OpenSans-Regular.ttf
wget -q https://raw.githubusercontent.com/intranda/goobi/master/Goobi/install/xslt/font_OpenSans-Semibold.ttf
wget -q https://raw.githubusercontent.com/intranda/goobi/master/Goobi/install/xslt/font_OpenSansHebrew-Bold.ttf
wget -q https://raw.githubusercontent.com/intranda/goobi/master/Goobi/install/xslt/font_OpenSansHebrew-Regular.ttf
wget -q https://raw.githubusercontent.com/intranda/goobi/master/Goobi/install/xslt/logo.png
wget -q https://raw.githubusercontent.com/intranda/goobi/master/Goobi/install/xslt/placeholder.png
cp -i * /opt/digiverso/goobi/xslt/ # do not overwrite things

The previous standard XSLT files have the following MD5 hash:

28157e2d48053d4700034372e91a3210  docket_english.xsl
47a9846db78ae8df9b517ee8ef1a2216  docket_multipage.xsl
b55280e1d70b66d66d5a1f801cf3db14  docket.xsl

After completion of the work, the generation of the dockets should be checked again.

LDAP-Konfiguration

Before removing the LDAP configuration from the Goobi workflow config file, it is important to start with the new goobi.war so that the migration to the database takes place.

The LDAP configuration was migrated from the configuration file to the database. After the update, the corresponding block can be removed from the goobi_config.properties file.

2020-02-12

For the ActiveMQ interface the available resources must be specified:

goobi:activemq.xml
<beans>
    <broker>
        <systemUsage>
            <systemUsage>
                <memoryUsage>
                    <memoryUsage limit="64 mb"/>
                </memoryUsage>
                <storeUsage>
                    <storeUsage limit="512 mb"/>
                </storeUsage>
                <tempUsage>
                    <tempUsage limit="128 mb"/>
                </tempUsage>
            </systemUsage>
        </systemUsage>
    </broker>
</beans>

2020-01-30

Before these points are processed, Goobi workflow must be started once with the new goobi.war to update the database schema.

Since you can only make other users super-administrators as super-administrators, an account should be set manually in the database when updating. Subsequently, further accounts can be adjusted by means of a checkbox in the user administration.

The following SQL statements will help here:

mysql goobi -Nbse'SELECT benutzerid, login FROM benutzer WHERE login REGEXP "admin|intranda"'
# mysql goobi -e 'UPDATE benutzer SET superadmin = true WHERE benutzerid =XXXX'

2020-01-18

Goobi workflow now uses log4j2 and comes with its own configuration file. You will therefore need to remove the overwriting entries from /etc/default/tomcat8:

patch /etc/default/tomcat8 <<"EOF"
@@ -26,2 +25,0 @@
-JAVA_OPTS="${JAVA_OPTS} -Dlog4j.configuration=file:///opt/digiverso/config/log4j.properties"
-JAVA_OPTS="${JAVA_OPTS} -Dlog4j.configurationFile=/opt/digiverso/config/log4j2.xml"
EOF
VorherigeUpdate stepsNächste2021

Zuletzt aktualisiert vor 5 Monaten

In this plugin it is now possible to define several changes for each depending on different process properties. Therefore a new XML element was introduced, which has to be added to the config file, see also:

https://docs.goobi.io/workflow-plugins/step/goobi-plugin-step-change-workflow