Domibus 5.0.1
Description
We are happy to announce that the release of Domibus 5.0.1 is available. Domibus is the sample implementation of an eDelivery Access Point maintained by the European Commission.
Domibus 5.0.1 includes a number of improvements and bug fixes, among which:
- Allow ActiveMQ configuration to define multiple ActiveMQ broker entries for networks of brokers or brokers in a Master-Slave setup
- Improve performance for default message deletion via Domibus
- Filter out TEST messages from earchived messages
- Updated two earchive properties default values: domibus.earchive.export.empty set to false and domibus.earchive.batch.retry.timeout set to 0
- Updated http timeouts for MSH communication
- Fixed Domibus 5.0 database migration scripts
- Fixed the properties issue for ext/messages/acknowledgments/delivered API
- Added possibility to throw a specific exception while receiving a message in the plugin
- Fixed the disabling of a domain added at runtime
- Analysed and fixed OWASP reported security vulnerabilities
Important note: there is a known issue on the Domibus 5.0.1 version with the reload keystore functionality: due to a caching issue in the reload keystore functionality, Domibus requires restart when changing the keystore.
The steps to replace the keystore are:
- change the keystore file on the disk
- press ReloadKeystore in Domibus Admin Console - the new keystore will be visible in the UI but not used for exchanging messages
- restart Domibus (to be fixed in next hotfix release)
Domibus 5.0.1 is backward compatible with 5.0 FR and the upgrade is not mandatory, but it is highly recommended.
Supported platforms:
- Application servers:
- WildFly 26.1.x
- WebLogic 12.2.1.4 (tested version, future versions might work)
- Apache Tomcat 9.0.x
- Database:
- MySQL 8 (future versions might work)
- Oracle 12c R2 and Oracle 19c
- Java 8 features / compile with Oracle JDK 8: tested to run correctly with:
- Oracle JDK 8/ WebLogic
- OpenJDK 11/ WildFly + Tomcat (tested with AdoptOpenJDK 11 version 11.0.9.1+1)
Security Note: To ensure their system’s security, users installing any of the Domibus packages labelled as “Full Distribution” have the responsibility to update the application servers to the latest version after the installation.
Documentation
Quick Start Guide (pdf) | This guide allows the user to quickly get started with Domibus. After completing this document, you will have a local Domibus instance up and running locally on a Tomcat/MySQL environment. |
Testing guide (pdf) | This document is intended for developers that want to perform a set of checks on their Domibus installation and testers that want to have a starting point to create their own test cases. |
Interface Control Document of the default JMS (pdf) | The purpose of this document is to outline the JMS Data Format Exchange to be used as part of the default JMS backend plugin. |
Interface Control Document of the default (new) WS plugin (pdf) | This document describes the WSDL and the observable behaviour of the interface provided in the default WS plugin. |
Interface Control Document of the default (old) WS plugin (pdf) | This document describes the WSDL and the observable behaviour of the interface provided in the default WS plugin. |
Interface Control Document of the File System plugin (pdf) | The purpose of this document is to outline the file system messages exchange as part of the default File System (FS) backend integration solution for the Domibus Access Point. |
Administration Guide (pdf) | The purpose of this guide is to provide detailed information on how to deploy and configure Domibus on WebLogic, Tomcat and WildFly with MySQL and Oracle. It also provides detailed descriptions of related Security Configurations (Policies, Certificates, TLS Configuration), Message Filtering, PMode Configuration, Application Monitoring, Registration of custom plugins and Troubleshooting. |
File System Plugin Administration Guide (pdf) | The purpose of this guide is to provide detailed information on how to configure and deploy the File System Plugin available in Domibus 3.3 and later versions. |
Plugin cookbook (implementation manual) (pdf) | After reading this document the reader should be aware of the capabilities provided by the Domibus plugin system. Additionally a developer familiar with the AS4 protocol will be able to implement a plugin integrating an existing back office application into Domibus. |
Extension cookbook (pdf) | This document details the technical specifications of Domibus extension mechanism. It lays out applicable guidelines to support the technical implementation of an extension. |
Validation extension cookbook (pdf) | This document details the technical specifications of Domibus Validation Extension mechanism. Its scope are the functional aspects of the extension mechanism and the technical and operational aspects of the extension mechanism. |
Domibus Software Architecture Document (pdf) | This document provides a comprehensive architectural overview of the system, using a number of different architectural views to depict individual aspects of the system. It is intended to capture and convey the significant architectural decisions that have been made on the system. |
Domibus REST services documentation | Documentation on the Domibus REST services. |
Domibus eArchiving REST services documentation | Documentation on the Domibus eArchiving REST services. |
Licence (pdf) | European Union Public Licence. |
Domibus upgrade and downgrade procedure | The purpose of this document is to describe the details of making a backup of Domibus and restore Domibus previous version if it is needed. |
Upgrade from 5.0 FR to 5.0.1
For a detailed description of the Domibus upgrade procedure, click here.
Release notes
Please find below the list of new features, improvements, solved bugs and known limitations.
Improvements
- [EDELIVERY-9720] - Performance Issues with message deletion via Domibus
- [EDELIVERY-10105] - Signal message raw not saved before deliver Event
- [EDELIVERY-10159] - Filter out TEST messages from eArchived messages
Fixed bugs
- [EDELIVERY-9255] - Split and join fails with could not rename file
- [EDELIVERY-9773] - Fix OWASP vulnerabilities
- [EDELIVERY-10045] - Domibus 5.x Tomcat with Java11 crashes with HTTPS connector
- [EDELIVERY-10079] - Signal message raw not saved
- [EDELIVERY-10153] - Plugins should be able to send EBMS3 errors while receiving a message
- [EDELIVERY-9195] - Push Plugin Scenario
- [EDELIVERY-9452] - Migration scripts for ongoing messages between 5.0 and 5.0 fails
- [EDELIVERY-9531] - Wildfly 26 Cluster Network Topology JSON differences
- [EDELIVERY-9557] - Not possible to call service ext/messages/acknowledgments/delivered
- [EDELIVERY-9608] - Exception in the JMS plugin when error collection is empty
- [EDELIVERY-9620] - Wildfly 26 cluster not starting
- [EDELIVERY-9684] - Provide support for UUM&DS X.509 identifiers in addition to EORI
- [EDELIVERY-9702] - Domibus 5.0 EU Login - User appears logged out immediately after authenticating to EU Login
- [EDELIVERY-9704] - Domibus 5.0 EU Login - bootstrap-synchronization.lock error
- [EDELIVERY-10057] - Merge 4.2.11 in 5.0.1 and development
- [EDELIVERY-10059] - Split and join does not send correctly the file
- [EDELIVERY-10072] - Update migration scripts for 5.0 and archive them
- [EDELIVERY-10124] - Not able to start domibus-weblogic122-eulogin docker container
- [EDELIVERY-10129] - Missing delta script for migration between 5.0 and 5.0.1 database schema
- [EDELIVERY-10148] - Cannot enable new domain
- [EDELIVERY-10172] - Archiving empty batches fails
- [EDELIVERY-10174] - Update http timeouts for MSH communication
- [EDELIVERY-9297] - Sometimes a message exchange with fs plugin fails
- [EDELIVERY-9475] - Domain selector visible in Domains page
- [EDELIVERY-9488] - Error checking quartz jobs for domain added at runtime
- [EDELIVERY-9692] - Domibus data migration 4.2.9 to 5.0 Fails on Oracle 12c
- [EDELIVERY-9733] - Domibus 4.2.9-5.0 Migration scripts - Error
- [EDELIVERY-9772] - Update Domibus Info Button to point to correct link
- [EDELIVERY-10036] - Missing Messages on the Message Log Page After 5.0 Data Migration
- [EDELIVERY-10123] - Change default values for earchiving mechanism
- [EDELIVERY-10125] - Analyse new Domibus 5.0.1 vulnerabilities
- [EDELIVERY-10135] - JMS Plugin cannot accept payloads via file reference
- [EDELIVERY-10175] - "Archived" notification fails for empty batches
- [EDELIVERY-9394] - Domibus not loading rest controllers defined in plugins
- [EDELIVERY-9478] - Error message in Domains page needs proper punctuation
Tasks
- [EDELIVERY-10073] - ActiveMQ master slave with Domibus 5.0.1
Known issues and limitations
- [EDELIVERY-2608] - Unable to use Admin Console in IE (not EDGE)
- [EDELIVERY-3250] - Improve sending a message to the same Access Point
- [EDELIVERY-10460] - Reload key issue: due to a caching issue in the reload keystore functionality, Domibus requires restart when changing the keystore.
For more information, please contact us via our portal or by e-mail: EC-EDELIVERY-SUPPORT@ec.europa.eu