Skip to content

Kitodo.Production 4.0.0

Latest

Choose a tag to compare

@solth solth released this 18 Jun 09:26
· 4 commits to main since this release
kitodo-production-4.0.0
485a3dc

What's new

Support for modern Java and Tomcat versions

With version 4.0, Kitodo adds support for Java 21 and Tomcat 10. This means this new version needs to be deployed on a different web server than previous Kitodo.Production releases and cannot simply be replaced in the same Tomcat 9 instance as before. For general installation instructions please consult the corresponding guide.

Database and search index server support has not changed since Kitodo.Production 3.9, but the database schema itself has been slightly updated and needs to be migrated when upgrading from an existing installation (see database migration notes below). Please consult the system requirements page for additional details.

See #6692 for additional details

Comprehensive XML validation

From version 4.0 onwards XML files in Kitodo.Production are validated against their resprective schema definitions upon usage. This includes metadata records imported from remote catalog search interfaces, ruleset files, internal metadata files and XSLT mapping files used for metadata import and export. When validation fails, an exception is thrown and loading of the XML file is aborted. The user is informed about the validation errors and has to fix the XML file before it can be used.

Since internal metadata files created by previous Kitodo.Production version did not contain completely valid METS structures, a new Kitodo script "resaveMetadataFile" was added to allow updating metadata files of existing processes with correct and valid METS XML. New processes created with Kitodo.Production 4.0 automatically contain valid METS structures.

This XML support is mandatory to improve the stability of Kitodo.Production, which is highly dependent on many XML files. One exception is the schema validation of metadata records from external sources, which is optional because Kitodo users normally do not have control over those external sources and therefor cannot fix causes of potential validation errors. For this reason, schema validation can be deactived in corresponding import configurations.

See #6815 for additional details.

Pagination editor improvements

This new release contains improvements to the pagination feature of the metadata editor that have been discussed during the Kitodo community meeting and implemented as part of the development fund 2025. Exemplary improvements are:

  • the layout of the pagination panel has been refactored to better make use of the available screen estate
  • alphabetic pagination types have been added
  • sheet pagination starting with verso pages has been added
  • the redundant page selection list has been removed

See #6683 for a complete list of improvements.

Bean scopes

The so-called "backing beans" in Kitodo have been refactored and their scope has been updated to the most appropriate options.

See #6456 for details.

Cyber Resilience Act

A Cyber Resilience Act document has been added to Kitodo to adhere to the corresponding new EU regulation.

See #6945 for details.

Extenionless urls

URLs in Kitodo.Production 4.0 omit the .jsf extensions (for example pages/desktop.jsf -> pages/desktop). To retain compatibility with existing bookmarks, URLs with jsf extensions will still work, but be forwarded to extensionless URLs and Kitodo itself will only navigate to URLs without extensions.

See #6773 for details.

CSV export

In addition to the already existing PDF and Excel export for the process list, a new CSV export has been added.

See #6905 for details.

Database migration

To create a fresh installation of Kitodo.Production 4.0.0 please use the SQL dump kitodo_4-0-0.sql included in this release.

To update an existing Kitodo 3.9.x installation instead, please migrate your database with the provided migration file migration_3-9-0_to_4-0-0.sql.

Configuration

Changes to hibernate.cfg.xml:

  • The property hibernate.dialect should be updated from org.hibernate.dialect.MySQL5Dialect to org.hibernate.dialect.MySQLDialect (the number 5 was removed)
  • The property hibernate.connection.driver_class should be updated to com.mysql.cj.jdbc.Driver

Changelog

Note: entries marked with a * denote changes and bug fixes since the 4.0.0.RC1 release of Kitodo.Production.

New Contributors

Full Changelog: kitodo-production-3.9.0...kitodo-production-4.0.0