Page tree

European Commission Digital

eDelivery Services

Domibus 4.1.2


This page collects the resources for Domibus version 4.1.2, released in November 2019. 

Download Domibus v4.1.2

Verify files integrity
Access source code

Description

We are happy to announce the release of Domibus 4.1.2 sample implementation of the eDelivery Access Point.

Domibus 4.1.2 release includes a number of new features, improvements and bug fixes, including:

  • Possibility to encrypt passwords in the configuration files

  • Possibility to encrypt payloads at rest

  • Possibility to upload and download the current PMode via the managed REST services

  • JMS Queues statistics

  • FS Plugin fix to save the MessageInfo in metadata.xml

  • Test Service improvements

Domibus 4.1.2 is backwards compatible with 4.1.x and the upgrade is not mandatory.  



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.
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.

Migration from 4.1.1 to 4.1.2

In order to upgrade to Domibus 4.1.2 please execute the SQL migration script, which depends on the DB flavor used. For multi-tenancy mode, please use the provided SQL script to update the general database schema. 

Afterwards please update the domibus.properties file, install the domibus.war and replace the plugin(s) jar(s) into \domibus\conf\domibus\plugins\lib". 

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



Release note

Please find below the list of improvements and fixed bugs.

New feature

Improvement

  • [EDELIVERY-2221] - Possibility to configure keystore/truststore passwords and private key using encrypted values

  • [EDELIVERY-4459] - Domibus Logging - print metadata not payload

  • [EDELIVERY-4756] - Optimize Domibus PULL for receiver with multiple legs

  • [EDELIVERY-4795] - Possibility to upload a PMode via the managed REST services

  • [EDELIVERY-4668] - Possibility to download the current PMode via the managed REST services

  • [EDELIVERY-4809] - Expose password encrypt, decrypt to plugins to reuse Domibus encrypt key

  • [EDELIVERY-4871] - Possibility to encrypt the passwords for the FS Plugin

Fixed Bugs

  • [EDELIVERY-3423] - Improve documentation (webLogic version)

  • [EDELIVERY-3813] - UI: Alerts page - minor issues

  • [EDELIVERY-3835] - Error when deleting all parties in PMode Parties page

  • [EDELIVERY-4664] - Issue when trying to setup PMode configuration with pushAndPull and pullAndPush binding

  • [EDELIVERY-4703] - Sending a message without encryption is blocked by the validation of the receiver certificate

  • [EDELIVERY-4728] - Wildfly JMSPlugin queues are not visible by remote client

  • [EDELIVERY-4742] - TestService to receiver party configured in PULL mode

  • [EDELIVERY-4797] - Sometimes character = is listed as \u003d in CSV export from JMS Monitoring page

  • [EDELIVERY-4824] - retrieveMessage does not work if the message-id is not trimmed

  • [EDELIVERY-4828] - When exporting to CSV on Firefox the downloaded file has no extension

  • [EDELIVERY-4830] - Downloading the CRL via HTTPs is not working

  • [EDELIVERY-4831] - Backup the truststore before updating it

  • [EDELIVERY-4834] - Error code form differs between UI and CSV export

  • [EDELIVERY-4835] - Users export to CSV doesn't contain column Domain on multitenancy environment

  • [EDELIVERY-4847] - Error message should be different when uploading jks file without password

  • [EDELIVERY-4849] - Audit export to CSV contains a lot of spaces at the end of each line

  • [EDELIVERY-4850] - UIReplication queue throws NPE. Data in TB_MESSAGE_UI is out of sync.

  • [EDELIVERY-4855] - Private key cannot be accessed while sending message

  • [EDELIVERY-4866] - The primary key type should be long instead of integer

  • [EDELIVERY-4876] - Error 'The test service is not properly configured' is shown if dynamic discovery is set as true

  • [EDELIVERY-4887] - Receipt message truncated at the level of the signature

  • [EDELIVERY-4888] - Weblogic DSS extension generate an exception: ERROR e.e.e.d.x.v.XAdESSignature:182

  • [EDELIVERY-4889] - Certificate revocation check is done in Domibus and not in DSS

  • [EDELIVERY-4894] - Issue parsing the Signal message under high concurrency

  • [EDELIVERY-4895] - When sorting in the Error log page the pagination is reset to 1 but the content does not correspond to the first page

  • [EDELIVERY-4916] - Liquibase scripts - clean data script

  • [EDELIVERY-4918] - Double check the registration of the localConduit

  • [EDELIVERY-4935] - UI: Alerts page sorting is not working

  • [EDELIVERY-4936] - UI: On Alert page the sorting use the previous sorting conditions

  • [EDELIVERY-4943] - Message without payloadProfile handling NPE

  • [EDELIVERY-4959] - Marking alerts as "Processed" doesn't work

  • [EDELIVERY-4969] - Unnecessary truststore update

  • [EDELIVERY-4972] - Domibus Admin console PMode validate Service/Action combination - in order to prevent NPE while sending messages

  • [EDELIVERY-4996] - Cannot delete JMS messages

  • [EDELIVERY-5000] - NullPointerException while handling reliability if the pmode has changed

  • [EDELIVERY-5009] - Filters User type and Account Disabled should be removed from the extra filters for PLUGIN_USER_ACCOUNT_DISABLED alert type

  • [EDELIVERY-5032] - Error when sending a message without payload.

  • [EDELIVERY-5380] - Domibus 4.1 (Wildfly & Tomcat) error java.lang.IllegalStateException: Local destination does not have a MessageObserver

  • [EDELIVERY-5385] - Domibus Logging - issue when stripping payload

  • [EDELIVERY-5387] - Domibus fails to send a message after CRL URL is checked.

  • [EDELIVERY-5390] - Issue while migrating from 4.0.2 to 4.1.2.

  • [EDELIVERY-5404] - User not asked if he needs to cancel changes before performing new search in JMS Monitoring and Party pages

  • [EDELIVERY-5407] - TB_COMMAND table is missing in the full DB script

  • [EDELIVERY-5414] - Issue when changing default password after migration.

  • [EDELIVERY-5416] - Certificate validation fails in case all protocols are excluded.

  • [EDELIVERY-5424] - Error while checking for temporary directory

  • [EDELIVERY-5429] - NotificationListener should be decoupled from the JMS broker

  • [EDELIVERY-5431] - NPE in the DomainPullFrequencyHelper

  • [EDELIVERY-5432] - No alert in case of blank password for plugin user for PLUGIN_USER_LOGIN_FAILURE scenario

  • [EDELIVERY-5438] - Wrong alert message on nth trial on Login page with with wrong credentials

  • [EDELIVERY-5439] - Error occurred failure message while search using Alert id on Alerts page

  • [EDELIVERY-5456] - Error when running DB script "oracle10g-VERSION-uireplication-insert.sql".

  • [EDELIVERY-5463] - ListenerExecutionFailedException when ui replication is enabled.

  • [EDELIVERY-5464] - NPE when accessing test service page if PMode legConfiguration contains incorrect Service/Action

  • [EDELIVERY-5469] - Show domain alert checkbox is missing on Alert page in case of Super admin

  • [EDELIVERY-5476] - Rest post call to upload a pmode is not working in swagger.

  • [EDELIVERY-5480] - Importing a single certificate from the UI console doesn't work

  • [EDELIVERY-5491] - Message Filtering issue

  • [EDELIVERY-5506] - It is possibly to create two plugins users with the same user name

  • [EDELIVERY-5507] - UIreplication synchronization issue.

  • [EDELIVERY-5510] - Error when change default password is executed on Oracle 12c

  • [EDELIVERY-5515] - JMS Message is consumed from all notification listeners when message is deleted

  • [EDELIVERY-5516] - Alert: Exception in logs when starting Domibus

  • [EDELIVERY-5524] - FS Plugin should save the MessageInfo in metadata.xml

  • [EDELIVERY-5545] - Improve TLSClientParameters Ehcache usage

Tasks

  • [EDELIVERY-4869] - CXF Message Logging interceptor should not truncate messages

  • [EDELIVERY-4897] - Include the thread name in the log statements

  • [EDELIVERY-4898] - Documentation - plugin encryption API + FS Plugin password encryption

  • [EDELIVERY-4997] - Update Plugin Cookbook

  • [EDELIVERY-5421] - ICD WS Plugin: improve the documentation for submitMessage

  • [EDELIVERY-5522] - Document DomibusPropertyMetadata and improve metadata creation

  • [EDELIVERY-5539] - Pull mechanism logging is too verbose on INFO level


Known issues and limitations

  • [EDELIVERY-2608] - Unable to use Admin Console in IE (not EDGE)

  • [EDELIVERY-3335] - Messages page: performance decrease when certain filters are applied on millions of messages

  • [EDELIVERY-3575] - UI admin console: user is logged out when logging-in in another tab

  • [EDELIVERY-3634] - Issue starting Tomcat/WildFly cluster the first time with an empty MySQL schema

  • [EDELIVERY-6079]- Domibus 4.1.2 with Payload Encryption fails at start on WebLogic cluster

  • [EDELIVERY-6377] - Issue on MySQL script: columns from TB_CERTIFICATE and TB_SEND_ATTEMPT tables are TIMESTAMP instead of DATETIME

  • [EDELIVERY-3250]- Improve sending a message to the same Access Point

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