Digital

Page tree

Skip to main content


Products

In this section:


DomiSML software


1. Current release
2. Roadmap and previous releases
3. DomiSML FAQ
4. Support arrangement

1. Current release

This page collects the resources for DomiSML version 5.0., released in May 2025.

Download DomiSML v5.0

Verify files integrity
Access source code (select tag SML_5.0)

Description

The Directorate-General for Informatics (DIGIT) is happy to announce the minor release of eDelivery Service Metadata Locator (DomiSML) version 5.0. DomiSML is the sample implementation of the SML software implementing the eDelivery SML specification as well as the PEPPOL SML specification. As the PEPPOL SML specification continues to be supported, current users of the DomiSML software should not suffer any disruption of the service.

The DomiSML 5.0 release includes a number of new features, improvements, and bug fixes, including:

  • Fixed HTTP codes for SOAP faults, ensuring all SOAP faults now return HTTP code 500 to comply with SOAP 1.1 specifications
  • Resolved the issue with the report 'expiredSMPCertificates.cron' property
  • Resolved the issue with redirection to the children pages not correctly handled

DomiSML 5.0 is fully backward compatible with DomiSML 4.3. While upgrading is not mandatory, it is highly recommended due to updated dependent libraries and resolved security vulnerabilities. 

Supported platforms:

  • Application servers:
    • Apache Tomcat 10.1
  • Databases:
    • MySQL 8 (tested version, future versions might work)
    • Oracle 19c 
  • Java21 for compile, tested to run correctly with :
    • OpenJDK21

Technical Documentation

(green star) New Format(green star) DomiSML technical documentation is now available in HTML and and in a consolidated PDF.


hammer and wrench  Guides
DomiSML Documentation

 


Documentation for eDelivery's SML implementation:

  • Interface: use cases description, provided services details, information model and services' message exchanges sequence.
  • Architecture: an overview of the solution, its different layers, and its governing software architecture principles.
  • Installation and configuration of the SML component on a Tomcat/MySQL environment.


To download the DomiSML documentation in PDF click here.


information  Service Description 
Service Offering Document (pdf)

This document described the services offered by the SML.

hammer and wrench  Service Creation Guidance
Architecture, Infrastructure, Operations and Maintenance of an SML Service

This document provides guidance for those interested to create a service similar to the eDelivery SML Service, e.g., using DomiSML.

(grey lightbulb) License
Licence (pdf)

European Union Public Licence.

Migration from DomiSML 4.3.x to DomiSML 5.0

In order to upgrade to DomiSML 5.0, please follow the steps:

  • Only Tomcat 10.1 is supported. If you are currently using WebLogic 12.2c or 14.1c, you must transition to the Tomcat 10.1 application server to deploy the DomiSML 5.0 version. 
    Imortant Note: Weblogic 12.2c and 14.1c compliant DomiSML versions are currently actively maintained, incorporating bug fixes and security updates to uphold system reliability and protect against vulnerabilities.
  • Database migration scripts are provided in setup bundle
  • Deploy the new WAR

Release notes

Please find below the list of new features, improvements, solved bugs and known limitations.

 Improvements and features

  • EDELIVERY-14289: Upgrade the Java build version to Java 21, with compatibility targeting Java 17. Additionally, as part of this task, update Java/Jakarta EE from version 8 to Jakarta EE 10
  • EDELIVERY-9738 : Upgrade the integration testing environments to Tomcat 10.1 (including Docker images and Spring Boot), and explore options for upgrading the eDelivery environment
  • EDELIVERY-14329 : Upgrade Dynamic discover client  and 2waySecLib to jakarta EE 10
  • EDELIVERY-14907 : [Admin Service] The manageServiceMetadataPublisher feature includes new action to read SMP data
  • EDELIVERY-14174 : [Admin Service] Introduce a new service: DeleteSubDomainCertificate to manage Domain certificates
  • EDELIVERY-14176 : [Admin Service] Introduce a new admin service to manage registered participants on behalf of SMP owner
  • EDELIVERY-14180 : [Admin Service] ISeparate IsAlive endpoint to a dedicated service
  • EDELIVERY-14748 : [Admin Service] Add a new feature to synchronize DNS records of the SMPs and their participants with the database data
  • EDELIVERY-14849 :Implement option to register identifiers with multiple NAPTR records
  • EDELIVERY-14929 :  Rename database DDL script names to use generic database names (e.g. mysql, oracle), and include additional comments in the scripts to describe dialect
  • EDELIVERY-14797 : Improve the Loo&Feel of DomiSML landing page
  • EDELIVERY-14761 : Remove deprecated configuration parameter: dnsClient.use.legacy.regex
  • EDELIVERY-14678 : Implement a generic eDelivery Vault API library. The library offers a factory mechanism to seamlessly support diverse vault implementations within the eDelivery components: DomiSML, DomiSMP and Domibus
  • EDELIVERY-13564 : Implement Vault services to DomiSML using DemoVault in Unit tests and Hashicorp service in the integration tests
  • EDELIVERY-14035 : Implement automatic generation of thee Software Bill of Materials for DomiSML: the Notice.md
  • EDELIVERY-14358 : Enable TSIG (Transaction Signature) support to enhance DNS integration as alternative to SIG(0). This feature ensures secure communication by providing cryptographic authentication between DomiSML and DNS server
  • EDELIVERY-12037 : Enable validation of the keystoreType and truststoreType values
  • EDELIVERY-14848 : Introduce a configuration option for custom DNS lookups, allowing the use of TemplateIdentifier to define tailored DNS domain formats. This feature provides flexibility in managing domain structures, enhancing DNS integration capabilities
  • EDELIVERY-14747 : [Code Quality] Consolidate DomiSML error messages into a single class to improve the maintainability of error message responses
  • EDELIVERY-13185 : [Code quality] Fix the build of the project for Windows OS
  • EDELIVERY-13184 : Code quality] Upgrade Junit4 platform to JUnit 5 (Jupiter)
  • EDELIVERY-13181 : [Code Quality] Address critical issues identified through static code analysis (mainly related to string literals)
  • EDELIVERY-13178 : [Code Quality] Address blocker issues identified through static code analysis
  • EDELIVERY-14705 : [Code Quality] Address blocker issues identified through static code analysis - part 2
  • EDELIVERY-13469 : [Code Quality] Consolidate DomiSML named queries into a single class to improve the maintainability of queries and parameters
  • EDELIVERY-11785 : [Code quality] Upgrade Junit4 platform to JUnit 5 (Jupiter)
  • EDELIVERY-14341 : [Code Quality] Refactor PropertyUtils.isValidProperty to use new property validation approach
  • EDELIVERY-7585 : [Code Quality] Consolidate DomiSML logger service to use parametrized log message with SLF4J API 
  • EDELIVERY-10539 : [Code Quality] Remove third party library "ma.glasnost.orika" 

Fixed bugs

  • EDELIVERY-14501: Wrong SOAP 1.1 return codes
  • EDELIVERY-12122 : The Report: "expiredSMPCertificates.cron" property is not taken account on SML
  • EDELIVERY-11905 : Redirection to the Children Pages is not Correctly Handled
  • EDELIVERY-10445 : Wrong  certificate timezone validity is being updated in SMK / SML database

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

Access the eDelivery videos

SML video tutorial

« SML software   DomiSML releases »