Digital

Page tree

European Commission Digital

Domibus 5.1.4


This page collects the resources for Domibus version 5.1.4, released in May 2024.

Download Domibus v5.1.4

Verify files integrity
Access source code

Description

We are happy to announce the release of Domibus 5.1.4 sample implementation of the eDelivery Access Point. The Domibus 5.1.4 release synchronises 5.1 series with the latest fixes implemented in 5.0.8, includes bug fixes, performance improvements and security vulnerabilities fixes and we strongly recommend the upgrade:

  • Added endpoint for refreshing DSS Trusted lists. Can be accessed with POST /ext/trustedlists/refreshoperation
  • Added domibus properties for quartz data source in Tomcat
  • Renamed edeliveryNonXA datasources to eDeliveryMysqlNonXADS and eDeliveryOracleNonXADS in wildfly standalone-full.xml file
  • Removed edeliveryNonXA datasources for weblogic from cli and properties files
  • Removed eDeliveryMysqlNonXADS and eDeliveryOracleNonXADS datasources from wildfly standalone-full.xml file
  • Improved the self sending mechanism
  • Added property for disabling the use of system default certificates (cacerts) on https downloads (CRLs)
  • Added property for logging messages that are being sent but which have been enqueued for more than a specific duration
  • Added support for special characters in message ids
  • Improved the handling/persistence of digital certificates
  • Handle receipts with the same message id
  • Upgraded Tomcat 9 to the latest version 9.0.86
  • Fix issue with duplicate messageIds in listPending messages
  • Updated default value for property "domibus.dynamicdiscovery.peppolclient.partyid.responder.role"
  • Added new property "domibus.sender.trust.dynamicReceiver.validation.expression"
  • Updated property name from "domibus.cacerts.validation.enabled" to "domibus.cacerts.download.enabled"
  • Added new property "domibus.pmode.legconfiguration.mpc.enabled"
  • Added new property "domibus.partIdType.validation.pattern"
  • Added new property "domibus.ongoingMessagesSanitizing.worker.delay.hours"
  • Added new property "domibus.logging.sendMessage.enqueued.max.minutes"
  • Updated description of property "domibus.sender.trust.validation.expression"
  • Updated description of property "domibus.database.schema"

Domibus 5.1.4 is backward compatible with 5.1.3 and the upgrade is not mandatory, but it is highly recommended.


Important known issue to note

Under certain conditions, Domibus 5.1.4 creates an incorrect application address after the user logs into the Domibus Admin Console, rendering the Admin Console unusable. This affects Domibus installations where the Admin Console is exposed through a URL that uses a different base context than /domibus. This can happen, e.g., when using a reverse proxy. In such cases, a user logging in via a URL such as https://intragate.ec.europa.eu/myapp/edelivery-admin/[...] will be incorrectly redirected to https://intragate.ec.europa.eu/domibus/[...] which will not work. The impact is limited to the Domibus Admin Console, the rest of the application functions correctly (see also EDELIVERY-13300).

Domibus 5.1.5 release planned on 17.06.2024 will address this issue.


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 8u291+: tested to run correctly with:
    • Oracle JDK 8u291+ for WebLogic, Tomcat and WildFly
    • OpenJDK 11.0.11 for WildFly and 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.

Technical Documentation


(blue star)NEW!(blue star)

Documentation in HTML

Domibus 5.1.4 documentation can now be consulted in HTML, click >here< to open.

Documentation in PDF 

Click > here < to download the Domibus technical documentation now consolidated in one PDF document.

Domibus Technical Documentation Contents Description

In the documentation site or in the distributed PDF(s) you can find the following information:

(grey lightbulb) Installation and Configuration


Quick Start Guide


Quickly get started with Domibus. Based on a common scenario, a Tomcat/MySQL environment, and by following this concise guide, you can expedite the installation of a local Domibus running instance.


Administration Guide


Detailed information on:
→ How to deploy and configure Domibus in all supported platforms.
→ Configuration support and details for multiple topics, such as: Security Configurations (Policies, Certificates, TLS Configuration), Message Filtering, PMode Configuration, Application Monitoring, etc.
→ Configuration of the registration for custom plugins and Troubleshooting.
(grey lightbulb)About Domibus


Software Architecture Document


A comprehensive architectural overview of the system, using a number of different architectural views to illustrate diverse system aspects. Portrays the significant architectural decisions underlying Domibus.


AP Offering


Describes eDelivery's Access Point Offering.
(grey lightbulb)Testing


Testing Guide


Aimed at developers and testers wanting to perform a set of checks on their Domibus installation or to use as a starting point to create their own test cases.
(grey lightbulb) Plugins


JMS
JMS Interface Control


Outline of the JMS Data Format Exchange to be used as part of the default JMS backend plugin.


WS
WS Interface Control


Description of the WSDL and of the observable behaviour of the default WS plugin's interface.


WS (old)
WS Plugin (old) Interface Control


Description of the WSDL and of the observable behaviour of the default WS plugin's interface (older version).
FS


File System Plugin Interface Control


Outline of the file system messages exchange as part of the default File System (FS) backend integration solution for the Domibus Access Point.


File System Plugin Administration Guide


Detailed information on how to configure and deploy the File System Plugin available in Domibus 3.3 and later versions.
Plugin Cookbook

Plugin Cookbook (Development)


Describes the capabilities provided by the Domibus plugin system. A developer familiar with the AS4 protocol is able to implement a plugin to integrate an existing backoffice application into Domibus.
(grey lightbulb) Extensions


Extensions Cookbook


How to develop an Extension. Details the technical specifications of Domibus extension mechanism. Lays out applicable guidelines to support the technical implementation of an extension.


Extensions Validation Cookbook


How to validate an Extension. 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.
(grey lightbulb) API Documentation
Domibus REST services documentation
Documentation on the Domibus REST services.
Domibus eArchiving REST services documentation
Documentation on the Domibus eArchiving REST services.
 

(grey lightbulb) License

Licence (pdf)
European Union Public Licence.

Upgrade from 5.1.3 to 5.1.4

For a detailed description of the Domibus upgrade procedure, click here.

Release notes

Please find below the list of improvements and fixed bugs:

Improvements

  • [EDELIVERY-13043] - Upgrade OWASP plugin to use NVD API key 
  • [EDELIVERY-12814] - Add processingType in SoapUI project 
  • [EDELIVERY-12688] - Raise an error when there is a problem with the TL signature in DSS. Also say what the problem is.
  • [EDELIVERY-12950] - Update the docker Domibus Cluster setup documentation
  • [EDELIVERY-12505] - Remove all references of XA/NonXA datasources from domibus
  • [EDELIVERY-13069] - Propagate in 5.1.4 - Improve the performance of query used for payload handling
  • [EDELIVERY-12794] - Upgrade Angular - 5.1.x series
  • [EDELIVERY-12957] - Change the default responder role for Peppol
  • [EDELIVERY-12781] - Add quartz data source in Weblogic and Wildfly
  • [EDELIVERY-12696] - Detect duplicate libraries between Domibus core and UUMDS, DSS extension

Fixed bugs

  • [EDELIVERY-12654] - Activemq container not starting for Domibus 5.1.2
  • [EDELIVERY-12833] - Multitenancy sending using FS Plugin
  • [EDELIVERY-12922] - Pull changes from 5.0.8
  • [EDELIVERY-12644] - Custom properties not preserved
  • [EDELIVERY-12730] - Create upgrade instructions for the Docker images
  • [EDELIVERY-11793] - Issue with the ongoing messages sanitizer.
  • [EDELIVERY-13228] - In multitenancy, some messages submitted via fsplugin are skipped with several errors
  • [EDELIVERY-12988]  - Handling upgrade-info.md
  • [EDELIVERY-13019] - Ongoing alerts are sent for messages being processed
  • [EDELIVERY-13068] - Replace usage of apache commons-configuration with commons-configuration2
  • [EDELIVERY-12953] - Domibus Docker Cluster set up error logs
  • [EDELIVERY-13152] - Domain page is not available during Ecas login to domibus in MT enviroment.
  • [EDELIVERY-12966] - Limit on the size of Domibus messages
  • [EDELIVERY-12785] - Domibus GUI validation bug for the party ID value
  • [EDELIVERY-12942] - Domibus primary key generator can generate an invalid primary key
  • [EDELIVERY-12954] - Errors related to cleanup jobs
  • [EDELIVERY-13045] - Domibus 5.1.2 Alert email does not correspond with real status
  • [EDELIVERY-13097] - Audit: Deleting a JMS message is not creating a delete event in audit
  • [EDELIVERY-13033] - Not possible to update property "domibus.sender.trust.dynamicReceiver.validation.expression" at runtime
  • [EDELIVERY-12868] - Domibus 5.1.2 UI bug in Properties menu
  • [EDELIVERY-12547] - WS Plugin retrieveMessageResponse missing Content-Type
  • [EDELIVERY-12853] - No visual indication for on UI' Connection Monitoring
  • [EDELIVERY-12986] - Domibus 5.1.2 SEND_ENQUEUED stuck for >1h
  • [EDELIVERY-12956] - In multitenancy, sometimes, messages submitted via fsplugin are skipped
  • [EDELIVERY-12643] - NPE to investigate - related to Alerts
  • [EDELIVERY-12623] - EBMS_0103 error after Upgrade to domibus 5.1.1 then to 5.1.2
  • [EDELIVERY-12763] - Logger org.apache.cxf not working in multitenant environment
  • [EDELIVERY-12806] - Dynamic discovery: the cleanup job deletes the Access Point own party from the Pmode
  • [EDELIVERY-12851] - Domibus 5.1.2 Connection Monitoring broken for some domains
  • [EDELIVERY-12929] - Domibus webservicePlugin-header.xsd attribute 'mustUnderstand' from the wrong namespace
  • [EDELIVERY-12931] - Propagate angular bug fixes from 5.0.8 to 5.1.3
  • [EDELIVERY-12951] - Domibus 5.1.2 printing certificate details, issue with Alias
  • [EDELIVERY-12997] - Domibus 5.1.2 WS Plugin PUSH messages not marked as Downloaded
  • [EDELIVERY-13042] - Domibus 5.1.4 EU Login role USER with multiple domains cannot switch domain
  • [EDELIVERY-13120] - Update Tomcat and httpd
  • [EDELIVERY-13243] - Retry mechanism does not work as expected
  • [EDELIVERY-13145] - Investigate OWASP vulnerabilities for all versions (207)
  • [EDELIVERY-13629] - OK button is invisible in the new user creation page.
  • [EDELIVERY-12577] - Domibus 5.1.1 metadata deletion not happening
  • [EDELIVERY-12758] - Domibus 5.1.2 WS Plugin Misbehaviour - INC00802472
  • [EDELIVERY-12810] - domibus.properties mistake in multitenancy configuration 
  • [EDELIVERY-12845] - [Docker] domibus-tomcat9:5.1.2 Non-cluster Issue with domibus-activemq Master-Slave
  • [EDELIVERY-12959] - An error is logged when security profiles are not used
  • [EDELIVERY-12962] - Sending a message with dynamic discovery generates a warning message 
  • [EDELIVERY-12963] - ErrorHandlerService should log stacktraces when an error occurs
  • [EDELIVERY-12987] - Domibus cannot send a Signal with an error when it receives a request for an invalid domain
  • [EDELIVERY-13147] - Investigate and fix Domibus v5.1.4 10. Tomcat9 (Oracle) - Domibus Plugin Compatibility
  • [EDELIVERY-13164] - In multitenancy, some messages submitted via FSPlugin are skipped with several errors
  • [EDELIVERY-13174] - Domibus 5.1 oracle delete scripts fail
  • [EDELIVERY-13182] - Issue with the ongoing messages sanitizer
  • [EDELIVERY-13210] - Issue with retry mechanism and IDPK
  • [EDELIVERY-13245] - Errors shown when trying to run DB upgrade scripts
  • [EDELIVERY-12961] - DSS ehcache configuration file is missing
  • [EDELIVERY-12914] - Tomcat ConstraintViolationException FK_SIGNAL_MSG_RAW_SIGNAL_MSG
  • [EDELIVERY-12960] - Dynamic email properties we should not logged with warning
  • [EDELIVERY-12967] - When Domibus Quartz jobs are throwing an exception, the logged error does not contain anymore the domain information
  • [EDELIVERY-13240] - Oracle deletion script fails sometimes
  • [EDELIVERY-13241] - Fix authentication-dss-extension.properties property description
  • [EDELIVERY-12920] - DSS property update at runtime not working.
  • [EDELIVERY-12977] - TB_COMMAND_PROPERTY: the PROPERTY_VALUE field should be larger
  • [EDELIVERY-13233] - ConcurrentModificationException in fsPluginSendMessagesWorkerJob
  • [EDELIVERY-12771] - DSS does not log correctly the default cacert location when this location is used

Known Issue

For more information, please contact us via our portal or by e-mail: EC-EDELIVERY-SUPPORT@ec.europa.eu