Services
Domibus 4.2.6
Description
We are happy to announce the release of Domibus 4.2.6 sample implementation of the eDelivery Access Point.
The Domibus 4.2.6 release includes a number of improvements and bug fixes, including:
Upgraded BouncyCastle
- Update the following libraries to the latest version: Apache CXF, Ehcache, Hibernate Validator
- Update Apache WSS4J to fix an issue reported in Apache Santuario
- Jmx password not read correctly if encrypted
- isAlive service is not working correctly with ActiveMQ
- Issue on the delete procedures on the MPC parameter
- Re-login button does not appear on center of screen
- Dynamic discovery fails when ebCore Partyid Type is used
- Missing sample dss-tls-sample truststore.p12
- Cannot send a message in dynamic discovery in multitenancy mode
- Null pointer in isAlive service
- Issue sending messages in dynamic discovery
- Custom plugins cannot implement custom authentication
- DOMReference exception
The upgrade from 4.2.x to Domibus 4.2.6 is strongly encouraged. Domibus 4.2.6 is backward compatible with 4.2.x versions.
Supported platforms:
Application servers:
WildFly 20.0.x
WebLogic 12.2.1.4 (tested version, future versions might work)
Apache Tomcat 9.0.xDatabase:
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)
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 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. |
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. |
REST services documentation | Documentation on the 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. |
Migration from 4.2.5 to 4.2.6
In order to upgrade to Domibus 4.2.6, please follow the steps:
- install the domibus.war;
- update the domibus.properties file
- install the DSS Extension and update the DSS extension property file
- update the ehcache configuration file
- execute the SQL migration script, depending on the DB flavor used
For a more detailed description of the Domibus upgrade, procedure click here.
Release note
Please find below the list of new features, improvements, and solved bugs.
Fixed Bugs
- EDELIVERY-8390] - jmx password is not read correctly if encrypted
- [EDELIVERY-8458] - isAlive service is not working correctly with ActiveMQ
- [EDELIVERY-8460] - Error in Domibus at startup
- [EDELIVERY-8496] - Issue on the delete procedures on the MPC parameter
- [EDELIVERY-8589] - Re-login button does not appear on the center of the screen
- [EDELIVERY-8635] - Dynamic discovery fails when ebCore Partyid Type is used
- [EDELIVERY-8649] - Missing sample dss-tls-sample truststore.p12
- [EDELIVERY-8680] - Cannot send a message in dynamic discovery in multitenancy mode
- [EDELIVERY-8716] - Null pointer in isAlive service
- [EDELIVERY-8717] - Issue sending messages in dynamic discovery
- [EDELIVERY-8728] - Custom plugins cannot implement custom authentication
- [EDELIVERY-8733] - DOMReference exception on 4.2.6
Tasks
- [EDELIVERY-8737] - Include the downgrade document in the source code on the same level as the upgrade instructions
- [EDELIVERY-8756] - Upgrade DSS version
- [EDELIVERY-8761] - Upgrade logback version
- [EDELIVERY-8628] - Issue with apache.cxf.stax.maxTextLength
Known issues and limitations
[EDELIVERY-2608] - Unable to use Admin Console in IE (not EDGE)
[EDELIVERY-3575] - UI admin console: user is logged out when logging-in in another tab
[EDELIVERY-3250] - Improve sending a message to the same Access Point
[EDELIVERY-3335] - Messages page: performance decrease when certain filters are applied on millions of messages
For more information, please contact us via our portal or by e-mail: CEF-EDELIVERY-SUPPORT@ec.europa.eu