EUROPEAN COMMISSION DIGIT Connecting Europe Facility Access Point Administration Guide Domibus 3.3.3 Version [1.10] Status [Final] © European Union, 2018 Reuse of this document is authorised provided the source is acknowledged. The Commission's reuse policy is implemented by Commission Decision 2011/833/EU of 12 December 2011 on the reuse of Commission documents. Date: 21/06/2018 Domibus 3.3.3 Administration Guide Document Approver(s): Approver Name Role Adrien FERIAL CEF Technical Office Document Reviewers: Reviewer Name Role Cosmin BACIU CEF Technical Office Catalin-Emanuel ENACHE CEF Technical Office Summary of Changes: Version Date Created by Short Description of Changes 1.07 09/02/2018 Chaouki BERRAH Update for version 3.3.2 Caroline AEBY Information on MySQL and Oracle deletion scripts added as well as Domibus operational guidelines. 1.08 20/03/2018 Caroline AEBY Reuse notice added, links to AS4 specifications upated. 1.09 04/04/2018 Chaouki BERRAH Domibus 3.3.3 Caroline AEBY 1.10 20/06/2018 CEF Support Reference to nexus replaced by CEF Digital site Page 2 / 129 Domibus 3.3.3 Administration Guide Table of Contents 1. INTRODUCTION ................................................................................................................. 7 1.1. Purpose ...................................................................................................................................... 7 1.2. References ................................................................................................................................. 7 2. CONVENTIONS ................................................................................................................... 9 2.1. Example 1: Sample Oracle Statement ....................................................................................... 9 2.2. Example 2: Sample Configuration file ....................................................................................... 9 3. PREREQUISITES ................................................................................................................ 10 3.1. Binaries repository .................................................................................................................. 10 4. DOMIBUS DEPLOYMENT .................................................................................................. 11 4.1. Database Configuration ........................................................................................................... 11 4.1.1. MySQL and Oracle Deletion scripts ...................................................................................... 11 4.1.2. MySQL configuration ............................................................................................................ 11 4.1.3. Oracle configuration ............................................................................................................. 13 4.2. Domibus on WebLogic 12.1.3 .................................................................................................. 13 4.2.1. Single Server Deployment .................................................................................................... 13 4.2.2. Clustered Deployment .......................................................................................................... 22 4.3. Domibus on Tomcat ................................................................................................................ 33 4.3.1. Pre-Configured Single Server Deployment ........................................................................... 33 4.3.2. Single Server Deployment .................................................................................................... 36 4.3.3. Clustered Deployment .......................................................................................................... 38 4.4. Domibus on WildFly ................................................................................................................ 39 4.4.1. Pre-Configured Single Server Deployment ........................................................................... 39 4.4.2. Single Server Deployment .................................................................................................... 44 4.4.3. Clustered Deployment .......................................................................................................... 50 5. DOMIBUS CONFIGURATION ............................................................................................. 54 5.1. Security Configuration ............................................................................................................. 54 5.1.1. Security Policies .................................................................................................................... 54 5.1.2. Certificates............................................................................................................................ 54 5.2. Domibus Properties ................................................................................................................. 55 6. PLUGIN MANAGEMENT ................................................................................................... 62 6.1. Default Plugins ......................................................................................................................... 62 6.1.1. JMS Plugin............................................................................................................................. 62 6.1.2. WS Plugin .............................................................................................................................. 62 6.1.2.1. Domibus authentication .................................................................................................... 62 6.1.2.2. Domibus Authorization ..................................................................................................... 63 6.1.2.3. Enable the authentication in Domibus .............................................................................. 63 6.1.3. File System Plugin ................................................................................................................. 63 Page 3 / 129 Domibus 3.3.3 Administration Guide 6.2. Custom Plugin .......................................................................................................................... 64 6.2.1. Plugin registration ................................................................................................................ 64 6.2.1.1. Tomcat ............................................................................................................................... 64 6.2.1.2. WebLogic ........................................................................................................................... 64 6.2.1.3. WildFly ............................................................................................................................... 64 6.3. PMode Configuration .............................................................................................................. 65 6.3.1. Configuration ........................................................................................................................ 65 6.3.2. Adding a new participant ..................................................................................................... 65 6.3.3. Sample PMode file ............................................................................................................... 66 6.3.4. Domibus PMode configuration to ebMS3 PMode Mapping ................................................ 69 6.3.5. Upload new Configuration ................................................................................................... 74 6.3.5.1. Upload the PMode file ...................................................................................................... 74 6.3.5.2. Upload the Truststore ....................................................................................................... 77 7. SPECIAL SCENARIO: SENDER AND RECEIVER ARE THE SAME .............................................. 79 7.1. PMode Configuration .............................................................................................................. 79 7.2. Message structure ................................................................................................................... 79 7.3. Message ID convention ........................................................................................................... 80 8. ADMINISTRATION TOOLS ................................................................................................. 81 8.1. Administration Console ........................................................................................................... 81 8.1.1. Changing passwords ............................................................................................................. 81 8.1.2. User Account Lockout Policy ................................................................................................ 83 8.1.3. Adding new users ................................................................................................................. 85 8.1.4. Message Filtering ................................................................................................................. 86 8.2. Message Log ............................................................................................................................ 89 8.3. Application Logging ................................................................................................................