Administration Guide
Total Page:16
File Type:pdf, Size:1020Kb
EUROPEAN COMMISSION DIGIT Connecting Europe Facility Access Point Administration Guide Domibus 3.2.4 Version [1.01] Status [Validated] Date: 11/10/2017 Domibus 3.2.4 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 12/04/2017 CEF Support Creation of the document 1.01 11/10/2017 Chaouki BERRAH Update. Access Point Page 2 / 112 Domibus 3.2.4 Administration Guide Table of Contents 1. INTRODUCTION ................................................................................................................. 6 1.1. Purpose ...................................................................................................................................... 6 1.2. References ................................................................................................................................. 6 1.3. Acronyms ................................................................................................................................... 7 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 .......................................................................................................... 23 4.3. Domibus on Tomcat ................................................................................................................ 34 4.3.1. Pre-Configured Single Server Deployment ........................................................................... 34 4.3.2. Single Server Deployment .................................................................................................... 38 4.3.3. Clustered Deployment .......................................................................................................... 40 4.4. Domibus on WildFly ................................................................................................................ 42 4.4.1. Pre-Configured Single Server Deployment ........................................................................... 42 4.4.2. Single Server Deployment .................................................................................................... 47 4.4.3. Clustered Deployment .......................................................................................................... 53 5. DOMIBUS CONFIGURATION ............................................................................................. 56 5.1. Security Configuration ............................................................................................................. 57 5.1.1. Policies .................................................................................................................................. 57 5.1.2. Certificates............................................................................................................................ 57 5.2. Domibus Properties ................................................................................................................. 58 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 Access Point Page 3 / 112 Domibus 3.2.4 Administration Guide 6.2.1. Plugin registration ................................................................................................................ 63 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.4. Administration Tools ............................................................................................................... 77 6.4.1. Administration Dashboard ................................................................................................... 77 6.4.2. Application Logging .............................................................................................................. 79 6.4.2.1. Domibus log file ................................................................................................................. 79 6.4.2.2. Logging properties ............................................................................................................. 80 6.4.2.3. Error Log page ................................................................................................................... 81 6.4.3. Queue Monitoring ................................................................................................................ 82 6.4.4. Configuration of the queues ................................................................................................ 88 6.4.4.1. Tomcat ............................................................................................................................... 88 6.4.4.2. WebLogic ........................................................................................................................... 88 6.4.4.3. WildFly ............................................................................................................................... 89 6.4.5. Message Filtering ................................................................................................................. 89 7. DATA ARCHIVING ............................................................................................................ 91 7.1. What's archiving? .................................................................................................................... 91 7.2. Data Retention Policy .............................................................................................................. 91 7.3. Data Extraction ........................................................................................................................ 91 8. TROUBLESHOOTING ......................................................................................................... 92 8.1. Failed to obtain DB connection from datasource ..................................................................