Digital

Page tree

European Commission Digital

eDelivery Services

Domibus v4.1


This page collects the resources for Domibus version 4.1, released in July 2019. 

Download Domibus v4.1

Verify files integrity
Access source code

Description

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

The Domibus 4.1 includes a number of new features, improvements and bug fixes, including:

  • Possibility to change the log configuration at runtime

  • EU Login Support

  • DSS library integration

  • Password Management for Plugin Users

  • Lock/Unlock functionality for Plugin Users and corresponding alert generation

  • Added statistics page

  • Improved the performance of the File System plugin

  • Support for WebLogic 12.1.3

  • Harmonisation of the context path across the supported servers

  • Support of Large files

Domibus 4.1 is backwards compatible with 4.0.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.0.2 to 4.1

In order to upgrade to Domibus 4.1 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 Features

Improvements

  • [EDELIVERY-2855] - Improve the performance of the File System plugin

  • [EDELIVERY-3811] - Plugin Users: add/update/remove operations on PluginUsers should appear in Audit

  • [EDELIVERY-3885] - Configuration of the standalone WildFly server using the WildFly configuration scripting language instead of XML manipulation

  • [EDELIVERY-3886] - UI admin console: confirmation message on the Plugin Users page

  • [EDELIVERY-3906] - UI admin console: error and confirmation messages should be hidden when doing other operations like search, new, delete, etc

  • [EDELIVERY-3989] - Alerts management properties: multiple emails receivers

  • [EDELIVERY-4106] - Domibus GUI - add the possibility to hide Domain selector for some pages

  • [EDELIVERY-4211] - User related alerts should also be sent to the user

  • [EDELIVERY-4359] - Multitenancy - Possibility to sort the list of tenants

  • [EDELIVERY-4394] - Support for WebLogic 12.2.x

  • [EDELIVERY-4464] - Improve logging for successful and failed messages

  • [EDELIVERY-4641] - Improve alert presentation and loging

  • [EDELIVERY-4750] - Replace Dozer with another library e.g. MapStruct

Fixed Bugs

  • [EDELIVERY-2886] - GetStatus request not handling additional spaces at the end of messageID for Oracle installation

  • [EDELIVERY-4635] - DB inconsistency in Domibus 3.3.4 to 4.0.2 migration

  • [EDELIVERY-2956] - UI: JMS Monitoring: Queues order seems random

  • [EDELIVERY-3191] - When C3 receives a message, check that the sender certificate used for the signature belongs to the party present in the from field

  • [EDELIVERY-3203] - UI: JMS Monitoring page on Firefox issue when clicking Export button fast

  • [EDELIVERY-3544] - Align the WS Plugin/FS Plugin XSDs with the ebMS3 XSD

  • [EDELIVERY-3583] - UI: Double click in Message Filter row doesn't always open the Edit window

  • [EDELIVERY-3700] - 500 error when trying to download message

  • [EDELIVERY-3721] - Sidebar disappears when user presses Esc

  • [EDELIVERY-3725] - Test button should be initially disabled

  • [EDELIVERY-3726] - Update button should be disabled until a test was initiated

  • [EDELIVERY-3734] - Identifiers section is not marked as mandatory to have a valid PMode party definition

  • [EDELIVERY-3735] - UI: Pmode - Parties: Endpoint should be validated as a URL

  • [EDELIVERY-3738] - Changing page submits search

  • [EDELIVERY-3753] - Domain Name not reuse user screen

  • [EDELIVERY-3757] - Property domibus.pull.queue.concurency not overwritten for specific domain

  • [EDELIVERY-3759] - Possibility to upload a PKCS12 truststore

  • [EDELIVERY-3761] - Change Domain 403 Forbidden: no redirection to login page

  • [EDELIVERY-3768] - Alerts management for super users

  • [EDELIVERY-3775] - Remove the retry tolerance mechanism

  • [EDELIVERY-3782] - UI admin console: the 'fourcornerenabled' setting is retrieved too early

  • [EDELIVERY-3807] - Messages/JMS: order of column is not the same as the CSV/column definition

  • [EDELIVERY-3820] - UI: Pmode Archive - Page is reset after restoring a pmode from another page

  • [EDELIVERY-3830] - System should not allow admin to delete party from PMode which describes current party

  • [EDELIVERY-3834] - Wrong error message in Test service page

  • [EDELIVERY-3838] - Wrong error message in Users page

  • [EDELIVERY-3842] - Load new TrustStore: old certificate still present in DB

  • [EDELIVERY-3847] - No sorting on PMode Archive and Plugin User

  • [EDELIVERY-3849] - UI - Users - Error trying to save a user after quickly changing the domain ( or after saving another before him)

  • [EDELIVERY-3887] - Customize the Connection header in HTTP connection between C2 and C3

  • [EDELIVERY-3897] - Comment out most of the properties in domibus.properties configuration file

  • [EDELIVERY-3908] - getStatus request not truncate spaces before message ID

  • [EDELIVERY-3913] - UI: PMode - Parties - Save button active to long

  • [EDELIVERY-3917] - Investigate failing tests on Weblogic cluster

  • [EDELIVERY-3921] - JTA transaction timeout for more than 7900 messages in the pending messages queue

  • [EDELIVERY-3926] - PMode and Truststore update not working properly on a WebLogic cluster

  • [EDELIVERY-3930] - SQL script error on MySQL 5.6 and lower

  • [EDELIVERY-3938] - Fix - Segregate the Domibus logs per domain

  • [EDELIVERY-3940] - Messages are not displayed when originalSender and finalRecipient are not present in the message

  • [EDELIVERY-3941] - Increase timeout for ListPendingMessages operation

  • [EDELIVERY-3942] - Allow empty "ConversationID" in the message sent by C1

  • [EDELIVERY-3953] - Message stuck in WAITING_FOR_RETRY state

  • [EDELIVERY-3957] - UI:CSV import: Import with new lines character in values

  • [EDELIVERY-3960] - Number of message in pull request queue is not limited for Multitenancy

  • [EDELIVERY-3975] - Update domibus-client-example to work for https endpoints

  • [EDELIVERY-3978] - Domibus does not retry when receiving 503 after delay

  • [EDELIVERY-3986] - domibus-client-example- Submitting multiple messages in parallel raises exception

  • [EDELIVERY-3988] - Alert stuck in SEND_ENQUEUED state

  • [EDELIVERY-3990] - Original Sender and Final Recipient should not be required in the message if not required in PMode

  • [EDELIVERY-4032] - Tomcat with Oracle DB: Default JMS Plugin is not working in Multitenancy

  • [EDELIVERY-4074] - Messages stuck in SEND_ENQUEUED state

  • [EDELIVERY-4079] - Domibus Multitenancy - SQL error should point to correct schema name

  • [EDELIVERY-4081] - Delete-db and multi-tenancy-rights are not present in the distribution

  • [EDELIVERY-4116] - The request path contains undefined segment at index 0 error message appears

  • [EDELIVERY-4135] - Wrong user in edit popup if order was changed

  • [EDELIVERY-4142] - Duplicate ID in sidebar for User and Plugin Users links

  • [EDELIVERY-4162] - Confirmation dialog doesn't appear on save on Plugin Users page

  • [EDELIVERY-4163] - Wrong message on Save on Plugin Users page

  • [EDELIVERY-4180] - Filters not reset when switching from Advanced to Basic filters

  • [EDELIVERY-4184] - Marking an alert as processed and pressing save does not disable the Save and Cancel buttons

  • [EDELIVERY-4185] - Alerts related to super user cannot be marked as processed

  • [EDELIVERY-4187] - "Super alerts" cannot be downloaded

  • [EDELIVERY-4193] - Sorting doesn't reset page shown in alerts grid

  • [EDELIVERY-4202] - Allow proxy configuration without user/password

  • [EDELIVERY-4225] - Issue with the retry number for domibus

  • [EDELIVERY-4229] - No information about password expiration in day "0"

  • [EDELIVERY-4232] - UI: Weblogic: New user row not presented on users list until save

  • [EDELIVERY-4236] - Default password minimum complexity rule is incorrect

  • [EDELIVERY-4246] - Error on Certificate Imminent Expiration Alerts

  • [EDELIVERY-4255] - WebLogic console is not working if Domibus fails to start

  • [EDELIVERY-4257] - Enable security in XStream

  • [EDELIVERY-4276] - Null pointer exception in Pull flow, when the ACK receipt is blocked

  • [EDELIVERY-4280] - Wrong Change password on existing Multidomain installation / Redundancy in SQL scripts on new single-domain installation

  • [EDELIVERY-4286] - Conversation id field data is removed after clicking search button

  • [EDELIVERY-4287] - User is not allowed to add Message Filter by keeping one field as blank and rest have value same as any existing Message Filter

  • [EDELIVERY-4298] - Wrong domain is shown in error message when admin try to add user with username same as plugin user/user for some other domain

  • [EDELIVERY-4318] - Retention worker issue with large number of messages

  • [EDELIVERY-4351] - Metadata.xml file incomplete when FS Plugin used at receiver

  • [EDELIVERY-4364] - UI: JMS Monitoring - Tomcat - totalNumberOfPayloads property in "Custom prop" column is not present

  • [EDELIVERY-4366] - UI: JMS Monitoring - Wildfly - Many properties not shown in UI property in "Custom prop" column

  • [EDELIVERY-4377] - File System Plugin sends files while being copied

  • [EDELIVERY-4378] - Default properties not overwrite correctly

  • [EDELIVERY-4379] - Can't log in to Domibus with default passwords next day

  • [EDELIVERY-4382] - UI: "Change password" options disappeared from sandwich menu

  • [EDELIVERY-4384] - Can't deploy new Domibus version via Weblogic Console

  • [EDELIVERY-4385] - FS Plugin: Possibility to configure the cid and part info properties

  • [EDELIVERY-4389] - Change password feature is accepting one among 5 previous passwords from Edit user pop up

  • [EDELIVERY-4390] - Help document is not present for available Domibus 4.1 build

  • [EDELIVERY-4396] - Sending large files with the JMS Plugin is not possible

  • [EDELIVERY-4397] - "Could not execute task" error is shown when one super user try to change password for another super admin

  • [EDELIVERY-4400] - Wrong error message when loading a different keystore type.

  • [EDELIVERY-4403] - User remains on login page after entering credentials

  • [EDELIVERY-4421] - Update the BouncyCastle in the jboss-deployment-structure.xml

  • [EDELIVERY-4425] - ECAS authenticated user that is not a member of any Domibus groups has access to Messages and Error Log pages

  • [EDELIVERY-4435] - Domibus ECAS:Error found while accessing authorized page by appending page name in url by Domibus Admin user

  • [EDELIVERY-4455] - UI: Help icon disappeared from Logging page

  • [EDELIVERY-4456] - File system plugin should detect the files being copied not using a .lock file

  • [EDELIVERY-4462] - Domibus ECAS: Unable to add new plugin user for Domain2

  • [EDELIVERY-4505] - Infinite loop when user information in browser session storage is missing

  • [EDELIVERY-4508] - Error message appears when session expires

  • [EDELIVERY-4510] - Messages in status "SEND_FAILURE" after pull load test.

  • [EDELIVERY-4528] - FSPlugin Multitenancy while sending large files - fix

  • [EDELIVERY-4529] - When server is down FE shows an error with message "false"

  • [EDELIVERY-4531] - Weblogic 12.2.1.3 - Error when trying to send a message

  • [EDELIVERY-4532] - Pull connection failure

  • [EDELIVERY-4533] - Message pull fails in case domibus.sender.trust.validation.onreceiving is set to true

  • [EDELIVERY-4543] - Pmode caching issue for party processes

  • [EDELIVERY-4544] - Clarify certificate validation properties

  • [EDELIVERY-4549] - Domibus fails to start with empty proxy properties in the dss extension

  • [EDELIVERY-4551] - Custom trusted list not retrieved during dss validation process

  • [EDELIVERY-4564] - Transaction timeout when FS Plugin downloads large files

  • [EDELIVERY-4569] - Test service is not working

  • [EDELIVERY-4587] - Missing message ID information in some Domibus logs

  • [EDELIVERY-4198] - Count listed next to JMS Queue in Move menu for domain admins is always -1

  • [EDELIVERY-4347] - Admin can add duplicate plugin user if authentication type is Certificate

  • [EDELIVERY-4399] - Domibus on Tomcat with ActiveMQ cluster issues

  • [EDELIVERY-4553] - FS plugin - Windows - Sending the file that is being extracted from archive log errors

  • [EDELIVERY-4626] - User is able to add duplicate message filters

  • [EDELIVERY-4636] - Additional column headers appear in downloaded CSV on Messages page

  • [EDELIVERY-4666] - Analyse the Domibus logs (runtime and compilation) and tackle the warnings

  • [EDELIVERY-4713] - In tomcat server the get unique name changes between each restart

  • [EDELIVERY-4741] - Blocker: Year 2038 problem

  • [EDELIVERY-4752] - Error when sending messages with fs plugin and security enabled

  • [EDELIVERY-4765] - Domibus JMS listeners do not reconnect after ActiveMQ broker restart

  • [EDELIVERY-4801] - Domibus 4.1_RC1 DB differences between scratch install and upgrade from 3.3

  • [EDELIVERY-4829] - Re-sent messages via admin console are stuck in status "READY_TO_PULL"

Tasks

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-4894] - Issue parsing the Signal message under high concurrency

  • [EDELIVERY-4914] - Alerts for password and certificate imminent expiration are not sent

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