Domibus 5.0.6
Description
We are happy to announce that the release of Domibus 5.0.6 is available. Domibus is the sample implementation of an eDelivery Access Point maintained by the European Commission.
The Domibus 5.0.6 includes improvements and bug fixes, including:
- Performance improvements for message exchange with Push binding
- Simplify the Messages page of the Admin Console to improve the performance under heavy load
- eArchiving performance improvements
- Simplify the SQL migration scripts for partitioned database
- Provide an updated upgrade procedure
- Upload truststore with different password and type (original configuration in domibus.properties is maintained)
- Add validation to check there is no duplicate dependencies in the distributions (tomcat, weblogic and wildfly)
- Distribution files have a wsdl folder with wsdl for the the wsPlugin client and the backend client for the push functionality
- Removed the SQL scripts from the full distributions of Tomcat and Wildfly. The archive with these scripts can be downloaded separately
- Removed the "upgrade-info.md" from the full distributions of Tomcat and Wildfly. Upgrade instructions are available on the release page
- Improve error details
- Expose the metrics API on the /ext services with basic authentication
- Fix retention issue when using partitions and the optional retention_sent pMode attribute
- Fix issue with growing number of opened files outside of the message exchange context
Domibus 5.0.6 is backward compatible with 5.0.5 and the upgrade is not mandatory but 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.5 to 5.0.6
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.
Fixed bugs
- [EDELIVERY-11865] - Fix the database migration plans on the 5.0.6 branch
- [EDELIVERY-11846] - Payload submission is working only when compression is not active in the Pmode
- [EDELIVERY-11821] - Error received when migrating 5.0.1 partitioned database, with data, to 5.0.2
- [EDELIVERY-11819] - Error when starting Domibus after migration from 5.0.4 partitioned/non-partitioned
- [EDELIVERY-11804] - Updates needed for upgrade procedure
- [EDELIVERY-11794] - Clarification about the retry mecanism needed
- [EDELIVERY-11757] - Domibus performance investigation
- [EDELIVERY-11754] - Upload truststore with different type and/or password: propagate changes to 5.2
- [EDELIVERY-11751] - L2 cache issue in multitenancy setup
- [EDELIVERY-11747] - Simplify migration for partitioned 5.0.x
- [EDELIVERY-11667] - Fresh Domibus 5.0.5 installation partitioning fails due to wrong index name
- [EDELIVERY-11666] - Domibus/5: partition-mode retention job does not consider retention_sent mpc attribute
- [EDELIVERY-11633] - Domibus 5.0.5 and newer, upload truststore with different type and/or password
- [EDELIVERY-11599] - Fix set methods in DomibusPropertyExtServiceDelegateAbstract
- [EDELIVERY-11601] - Pmode legConfiguration is not properly identified on receiving side
- [EDELIVERY-11597] - Domibus 5.0.5/ORA-02291 during message submission
- [EDELIVERY-11595] - Upgrade scripts from 5.0.2 to 5.0.5 error ORA-01408e
- [EDELIVERY-11593] - Upgrade scripts failing 5.0.2 to 5.0.5
- [EDELIVERY-11591] - Upgrade scripts failing 5.0.2 to 5.0.3
- [EDELIVERY-11530] - Investigate the number of total consumers on weblogic queues
- [EDELIVERY-11488] - Domibus Wildfly - Resend message over Admin console issue
- [EDELIVERY-11479] - Files opened by Domibus, without sending any user messages, are not closed
- [EDELIVERY-11471] - Dynamic discovery cache is too long
- [EDELIVERY-11437] - domibus.earchive.storage.location issues
- [EDELIVERY-11433] - Null value for domibus_code in tb_earchive_batch
- [EDELIVERY-11431] - eArchiving Storage for domain [default] is null
- [EDELIVERY-11342] - Remarks about alerts for messages on an ongoing status which are not processed anymore
- [EDELIVERY-11326] - File not found in Domibus Distribution even if the name is present in Upgrade Procedure
- [EDELIVERY-11322] - EBMS error description to be redefined
- [EDELIVERY-11297] - Error reading XMLStreamReader: Unexpected EOF in prolog
- [EDELIVERY-11251] - Unable to parse class file
- [EDELIVERY-11240] - Usage of seccomp security profile with Docker
- [EDELIVERY-11236] - Alert is not getting created in alert page for "SEND_FAILURE" status of a messag
- [EDELIVERY-11225] - Could not create eArchiving structure
- [EDELIVERY-11168] - Domibus 5.0.4 parties mixing between separate domains/tenants
- [EDELIVERY-11166] - eArchiving stuck threads - performance investigation
- [EDELIVERY-11123] - Warnings displayed about mpc value
- [EDELIVERY-11074] - No error details in tb_earchive_batch
- [EDELIVERY-11072] - No checks made when changing status via API earchiving
- [EDELIVERY-10335] - To correctly update the Message state machine in Domibus
Known issues
- [EDELIVERY-11585] - Expose the metrics API on the /ext services with basic auth
- [EDELIVERY-12591] - When running the partitions scripts on Oracle 19.19 and higher, error is encountered and partitions are not created
For more information, please contact us via our portal or by e-mail: EC-EDELIVERY-SUPPORT@ec.europa.eu