ryanbnl / domibus

Mirror of the EC Domibus system (reference implementation for NCPeH)

Domibus

Sample implementation, open source project of the eDelivery AS4 Access Point.

• Introduction
• GEi overall description
• Build
  • Tomcat 9.x
  • Wildfly 26.x
  • Weblogic 12.2.1.x
  • Weblogic 12.2.1.x with EU Login Support
• Install and run
• Testing
  • Ent-to-end tests
  • Unit Tests
• Default plugins
• License
• Support

Introduction

This is the code repository for Domibus, the sample implementation, open source project of the European Commission AS4 Access Point.

Any feedback on this documentation is highly welcome, including bugs, typos or things you think should be included but aren't. You can use JIRA to provide feedback.

Following documents are available on the Domibus release page:

• Quick Start Guide
• Administration Guide
• Testing guide
• Interface Control Documents of the default plugins
• Plugin cookbook
• Software Architecture Document

Top

GEi overall description

The CEF eDelivery Access Point (AP) implements a standardised message exchange protocol that ensures interoperable, secure and reliable data exchange. Domibus is the Open Source project of the AS4 Access Point maintained by the European Commission.

If this is your first contact with the CEF eDelivery Access Point, it is highly recommended to check the CEF eDelivery Access Point Component offering description available on the Access Point Software page.

Top

Build

Tomcat 9.x

In order to build Domibus for Tomcat including all release artifacts use the following profiles:

mvn clean install -Ptomcat,default-plugins,database,sample-configuration,UI,distribution

Top

Wildfly 26.x

In order to build Domibus for Tomcat including all release artifacts use the following profiles:

mvn clean install -Pwildfly,default-plugins,database,sample-configuration,UI,distribution

Top

Weblogic 12.2.1.x

In order to build Domibus for Weblogic including all release artifacts, you must first import the required Weblogic 12.2.1.x libraries as dependencies into your local Maven repository. You must first change your working directory to the modules directory inside your <WL_HOME> (i.e. the root directory of your WebLogic installation or the wlserver directory inside the directory where you installed Weblogic).

cd <WL_HOME>

cd modules

To install the Weblogic dependencies into your local Maven repository please run the following from within the modules directory inside your <WL_HOME>:

mvn install:install-file -Dfile=com.bea.core.weblogic.workmanager.jar -DgroupId=com.oracle.weblogic -DartifactId=com.bea.core.weblogic.workmanager -Dversion=12.2.1.4.0 -Dpackaging=jar

mvn install:install-file -Dfile=com.oracle.weblogic.security.encryption.jar -DgroupId=com.oracle.weblogic -DartifactId=com.oracle.weblogic.security.encryption -Dversion=12.2.1.4.0 -Dpackaging=jar

mvn install:install-file -Dfile=com.oracle.weblogic.security.jar -DgroupId=com.oracle.weblogic -DartifactId=com.oracle.weblogic.security -Dversion=12.2.1.4.0 -Dpackaging=jar

mvn install:install-file -Dfile=com.oracle.weblogic.jms.jar -DgroupId=com.oracle.weblogic -DartifactId=com.oracle.weblogic.jms -Dversion=12.2.1.4.0 -Dpackaging=jar

Finally, build Domibus for Weblogic including all release artifacts using the following profiles:

mvn clean install -Pweblogic,default-plugins,database,sample-configuration,UI,distribution

Top

Weblogic 12.2.1.x with EU Login Support

In order to build Domibus for Weblogic with EU-Login support including all release artifacts, follow the steps you would normally take to build Domibus for Weblogic above, but use the following profiles instead when running the last maven clean install build command:

mvn clean install -Pweblogic-ecas,default-plugins,database,sample-configuration,UI,distribution

Top

Install and run

How to install and run Domibus can be read in the Quick Start Guide and more advanced documentation is available in the Administration Guide, both available on the Domibus Release Page.

Top

Testing

Ent-to-end tests

The end-to-end tests are manually performed by the testing team using SoapUI PRO. For further information please check the Testing Guide available on the Domibus Release Page.

A restricted set of tests that do not require any interactivity may run with the soapui-pro-maven-plugin from com.smartbear.soapui. The maven command to run the tests is:

mvn com.smartbear.soapui:soapui-pro-maven-plugin:5.1.2:test

Unit Tests

To run unit test via Maven, issue this command :

mvn test

In Domibus there are two types of tests implemented using JUnit: unit tests (java classes ending in *Test.java) and integration tests (java classes ending in *IT.java) To skip the unit tests from the build process:

mvn clean install -DskipTests=true -DskipITs=true

Top

Default plugins

The purpose of Domibus is to facilitate B2B communication. To achieve this goal it provides a very flexible plugin model which allows the integration with nearly all back office applications. Domibus offers three default plugins, available with the Domibus distribution:

• Web Service plugin
• JMS plugin
• File System plugin

The Interface Control Document (ICD) of the default JMS plugin outlines the JMS Data Format Exchange to be used as part of the default JMS backend plugin. The Interface Control Document (ICD) of the default WS plugin describes the WSDL and the observable behaviour of the interface provided in the default WS plugin Both documents are available on the Domibus Release Page

Top

License

Domibus is licensed under European Union Public Licence (EUPL) version 1.2.

Top

Support

Have questions? Consult our Q&A section. Ask your thorough programming questions using stackoverflow. Please use the tag context.domibus.

Still have questions? Contact eDelivery support.

Top