EUROPEAN COMMISSION DIGIT Connecting Europe Facility Access Point Administration Guide Domibus 3.3 RC1 Version [0.03] Status [Validated] Date: 18/07/2017 Domibus 3.3 RC1 Administration Guide Document Approver(s): Approver Name Role Adrien FERIAL CEF Technical Office Document Reviewers: Reviewer Name Role Yves ADAM CEF Technical Office Summary of Changes: Version Date Created by Short Description of Changes 0.01 30/05/2017 Yves ADAM Initial Document 0.02 26/06/2017 Chaouki BERRAH Draft (Merged Documents) Ioana DRAGUSANU Thomas DUSSART Tiago MIGUEL Cosmin BACIU 0.03 06/07/2017 Chaouki BERRAH Mysql Schema line added for Tomcat Page 2 / 128 Domibus 3.3 RC1 Administration Guide Table of Contents 1. INTRODUCTION ................................................................................................................. 6 1.1. Purpose ...................................................................................................................................... 6 1.2. References ................................................................................................................................. 6 2. CONVENTIONS ................................................................................................................... 8 2.1. Example 1: Sample Oracle Statement ....................................................................................... 8 2.2. Example 2: Sample Configuration file ....................................................................................... 8 3. PREREQUISITES .................................................................................................................. 9 3.1. Binaries repository .................................................................................................................... 9 4. DOMIBUS DEPLOYMENT .................................................................................................. 10 4.1. Database Configuration ........................................................................................................... 10 4.1.1. MySQL configuration ............................................................................................................ 10 4.1.2. Oracle configuration ............................................................................................................. 11 4.2. Domibus on WebLogic 12.1.3 .................................................................................................. 12 4.2.1. Single Server Deployment .................................................................................................... 12 4.2.2. Clustered Deployment .......................................................................................................... 22 4.3. Domibus on Tomcat ................................................................................................................ 32 4.3.1. Pre-Configured Single Server Deployment ........................................................................... 32 4.3.2. Single Server Deployment .................................................................................................... 35 4.3.3. Clustered Deployment .......................................................................................................... 37 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 ............................................................................................. 53 5.1. Security Configuration ............................................................................................................. 54 5.1.1. Security Policies .................................................................................................................... 54 5.1.2. Certificates............................................................................................................................ 54 5.2. Domibus Properties ................................................................................................................. 55 6. PLUGIN MANAGEMENT ................................................................................................... 61 6.1. Default Plugins ......................................................................................................................... 61 6.1.1. JMS Plugin............................................................................................................................. 61 6.1.2. WS Plugin .............................................................................................................................. 61 6.1.2.1. Domibus authentication .................................................................................................... 61 6.1.2.2. Domibus Authorization ..................................................................................................... 62 6.1.2.3. Enable the authentication in Domibus .............................................................................. 62 6.2. Custom Plugin .......................................................................................................................... 63 6.2.1. Plugin registration ................................................................................................................ 63 Page 3 / 128 Domibus 3.3 RC1 Administration Guide 6.2.1.1. Tomcat ............................................................................................................................... 63 6.2.1.2. WebLogic ........................................................................................................................... 63 6.2.1.3. WildFly ............................................................................................................................... 63 6.3. PMode Configuration .............................................................................................................. 64 6.3.1. Configuration ........................................................................................................................ 64 6.3.2. Adding a new participant ..................................................................................................... 65 6.3.3. Sample PMode file ............................................................................................................... 65 6.3.4. Domibus PMode configuration to ebMS3 PMode Mapping ................................................ 69 6.3.5. Upload new Configuration ................................................................................................... 75 6.3.5.1. Upload the PMode file ...................................................................................................... 75 6.3.5.2. Upload the Truststore ....................................................................................................... 79 6.4. Administration Tools ............................................................................................................... 81 6.4.1. Administration Console ........................................................................................................ 81 6.4.1.1. Changing passwords .......................................................................................................... 81 6.4.1.2. Adding new users .............................................................................................................. 82 6.4.1.3. Message Filtering .............................................................................................................. 82 6.4.2. Message Log ......................................................................................................................... 86 6.4.3. Application Logging .............................................................................................................. 87 6.4.3.1. Domibus log files ............................................................................................................... 87 6.4.3.2. Logging properties ............................................................................................................. 87 6.4.3.3. Error Log page ................................................................................................................... 89 6.4.4. Queue Monitoring ................................................................................................................ 89 6.4.5. Configuration of the queues ................................................................................................ 98 6.4.5.1. Tomcat ............................................................................................................................... 98 6.4.5.2. WebLogic ........................................................................................................................... 98 6.4.5.3. WildFly ............................................................................................................................... 98 7. DATA ARCHIVING ...........................................................................................................