### Start Development Server

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH-angular/README.md

Run the Angular development server to serve the application. The app reloads automatically on source file changes.

```bash
ng serve
```

--------------------------------

### Skip Unit and Integration Tests during Build

Source: https://github.com/cefedelivery/domibus/blob/master/Readme.md

Use this command to perform a clean build and installation while skipping all unit and integration tests. This is useful for faster builds when tests are not required.

```bash
mvn clean install -DskipTests=true -DskipITs=true
```

--------------------------------

### Multi-tenancy Database Schema Configuration

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

For multi-tenancy, configure the general schema in the domibus.properties file. This example shows MySQL configuration.

```properties
#MySQL
domibus.datasource.xa.property.url=jdbc:mysql://${domibus.database.serverName}:${domibus.database.port}/${domibus.database.schema}?pinGlobalTxToPhysicalConnection=true
domibus.datasource.url=jdbc:mysql://${domibus.database.serverName}:${domibus.database.port}/${domibus.database.schema}?useSSL=false
```

--------------------------------

### Insert User and Roles

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

SQL statements to insert a new user and assign roles. Ensure the user ID and role IDs match your existing setup.

```sql
INSERT INTO TB_USER (ID_PK, USER_NAME, USER_PASSWORD, USER_ENABLED) VALUES ('2', 'user', '$2a$10$HApapHvDStTEwjjneMCvxuqUKVyycXZRfXMwjU0rRmaWMsjWQp/Zu', 1);

```

```sql
INSERT INTO TB_USER_ROLES (USER_ID, ROLE_ID) VALUES ('1', '1');

```

```sql
INSERT INTO TB_USER_ROLES (USER_ID, ROLE_ID) VALUES ('1', '2');

```

```sql
INSERT INTO TB_USER_ROLES (USER_ID, ROLE_ID) VALUES ('2', '2');

```

--------------------------------

### Run Domibus with Docker Compose

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH-fiware/src/main/docker/README.md

Use this command to quickly set up and run Domibus with a MySQL database using Docker Compose. Ensure you have Docker Compose installed.

```bash
cd tomcat-mysql-compose
sudo docker-compose up
```

--------------------------------

### WildFly MySQL Datasource Configuration

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Example of a non-XA datasource configuration for MySQL in WildFly. Adapt host, port, username, and password according to your database schema.

```xml
<subsystem xmlns="urn:jboss:domain:datasources:3.0">
                                <datasources>
                                    ........................
                                    <!-- MySQL -->
                                    <datasource jndi-name="java:/jdbc/cipaeDeliveryNonXADs" pool-name="eDeliveryMysqlNonXADS" enabled="true" use-ccm="true">
                                        <connection-url>jdbc:mysql://localhost:3306/domibus_schema</connection-url>
                                        <driver-class>com.mysql.jdbc.Driver</driver-class>
                                        <driver>com.mysql</driver>
                                        <security>
                                            <user-name>edelivery_username</user-name>
                                            <password>edelivery_password</password>
                                        </security>
                                        <validation>
                                            <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker"/>
                                            <background-validation>true</background-validation>
                                            <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLExceptionSorter"/>
                                        </validation>
                                    </datasource>
```

--------------------------------

### WildFly Oracle Datasource Configuration

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Example of a non-XA datasource configuration for Oracle in WildFly. Adapt host, port, username, and password according to your database schema.

```xml
<!-- Oracle -->
                                 <datasource jta="true" jndi-name="java:/jdbc/cipaeDeliveryNonXADs" pool-name="eDeliveryOracleNonXADS" enabled="true" use-ccm="true">
```

--------------------------------

### Action Buttons for JMS Queue Management

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH-angular/src/app/jms/jms.component.html

Provides examples of common action buttons used in a JMS monitoring interface, such as moving messages, deleting, cancelling, and saving operations. These buttons facilitate interaction with the JMS queues.

```HTML
move_to_inbox delete
```

```HTML
cancel Cancel save Save
```

```HTML
move_to_inbox Move delete Delete
```

--------------------------------

### Build Domibus with All Profiles

Source: https://github.com/cefedelivery/domibus/blob/master/Readme.md

Use this command to build Domibus for Tomcat, Wildfly, and Weblogic, including default plugins, database support, sample configuration, UI, and distribution artifacts.

```bash
mvn clean install -Ptomcat -Pweblogic -Pwildfly -Pdefault-plugins -Pdatabase -Psample-configuration -PUI -Pdistribution
```

--------------------------------

### Angular CLI Help

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH-angular/README.md

Access help information for the Angular CLI.

```bash
ng help
```

--------------------------------

### Build Project

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH-angular/README.md

Build the Angular project. Artifacts are stored in the 'dist/' directory. Use the '-prod' flag for a production build.

```bash
ng build
```

--------------------------------

### Run Unit Tests

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH-angular/README.md

Execute unit tests using Karma.

```bash
ng test
```

--------------------------------

### Deploy to GitHub Pages

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH-angular/README.md

Deploy the project to GitHub Pages using the Angular CLI.

```bash
ng github-pages:deploy
```

--------------------------------

### Configure JMS Queues for Wildfly

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Define alert and UI replication JMS queues in standalone-full.xml for Wildfly.

```xml
<jms-destinations>
    .............................
     <jms-queue name="DomibusAlertMessageQueue">
         <entry name="java:/jms/domibus.internal.alert.queue"/>
         <entry name="java:/jms/queue/DomibusAlertMessageQueue"/>
         <durable>true</durable>
     </jms-queue>
     <jms-queue name="DomibusUIReplicationQueue">
         <entry name="java:/jms/domibus.internal.ui.replication.queue"/>
         <entry name="java:/jms/queue/DomibusUIReplicationQueue"/>
         <durable>true</durable>
     </jms-queue>
    .............................
</jms-destinations>
```

--------------------------------

### Configure ActiveMQ Queues for Tomcat

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Define alert and UI replication queues in activemq.xml for Tomcat.

```xml
<destinations>
    .............................
     <queue id="alertMessageQueue"
                       physicalName="domibus.internal.alert.queue"/>
      <queue id="uiReplicationQueue"
                       physicalName="domibus.internal.ui.replication.queue"/>
     .............................
</destinations>
```

--------------------------------

### Address Setting Configuration

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Add these address-setting configurations within the <address-settings> section of the configuration file.

```xml
<address-settings>
    .............................
    <address-setting match="jms.queue.DomibusAlertMessageQueue">
       <expiry-address>jms.queue.ExpiryQueue</expiry-address>
       <max-delivery-attempts>1</max-delivery-attempts>
    </address-setting>
    <address-setting match="jms.queue.DomibusUIReplicationQueue">
        <expiry-address>jms.queue.ExpiryQueue</expiry-address>
        <redelivery-delay>1000</redelivery-delay>
        <max-delivery-attempts>1</max-delivery-attempts>
     </address-setting>
    .............................
</address-settings>
```

--------------------------------

### Build Domibus Tomcat Docker Image

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH-fiware/src/main/docker/README.md

Build a custom Docker image for Domibus Tomcat. Navigate to the 'tomcat' directory before running this command. This allows for customization of the Domibus Docker image.

```bash
cd tomcat
docker build -t domibus-tomcat .
```

--------------------------------

### Run SoapUI PRO End-to-End Tests

Source: https://github.com/cefedelivery/domibus/blob/master/Readme.md

Execute a restricted set of end-to-end tests using the soapui-pro-maven-plugin. This command requires SoapUI PRO and may not need interactivity.

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

--------------------------------

### Build Domibus MySQL Docker Image

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH-fiware/src/main/docker/README.md

Build a custom Docker image for the MySQL database used with Domibus. Navigate to the 'mysql' directory before running this command. This allows for customization of the MySQL Docker image.

```bash
cd ../mysql
docker build -t domibus-mysql .
```

--------------------------------

### Swagger UI Initialization

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH-swagger/src/main/webapp/index.html

JavaScript code to initialize the Swagger UI bundle with specific configurations like the API URL, DOM element, and layout presets. This is typically used in an HTML file to render the API documentation.

```javascript
window.onload = function () {
  // Build a system
  const ui = SwaggerUIBundle({
    url: "swagger.json",
    validatorUrl: null,
    dom_id: '#swagger-ui',
    deepLinking: true,
    presets: [ SwaggerUIBundle.presets.apis, SwaggerUIStandalonePreset ],
    plugins: [ SwaggerUIBundle.plugins.DownloadUrl ],
    layout: "StandaloneLayout"
  })
  window.ui = ui
}
```

--------------------------------

### Basic HTML Structure for Swagger UI

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH-swagger/src/main/webapp/index.html

Basic CSS and HTML structure for the Swagger UI. It sets up box-sizing and body margins, preparing the page to host the Swagger UI interface.

```html
html {
  box-sizing: border-box;
  overflow: -moz-scrollbars-vertical;
  overflow-y: scroll;
}

*, *:before, *:after {
  box-sizing: inherit;
}

body {
  margin: 0;
  background: #fafafa;
}
```

--------------------------------

### Configure Alert Queue for Tomcat

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Add or update properties in domibus.properties for Tomcat deployments.

```properties
domibus.jms.queue.alert=domibus.internal.alert.queue
domibus.datasource.maxLifetime=30
domibus.jms.XAConnectionFactory.maxPoolSize=100
com.atomikos.icatch.max_actives=300
```

--------------------------------

### Run Unit Tests via Maven

Source: https://github.com/cefedelivery/domibus/blob/master/Readme.md

Execute all unit tests defined in the project using Maven. This command runs tests for both Java classes ending in *Test.java and *IT.java.

```bash
mvn test
```

--------------------------------

### Configure Alert Queue for Wildfly

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Add the alert queue property to domibus.properties for Wildfly deployments.

```properties
domibus.jms.queue.alert=jms/domibus.internal.alert.queue
```

--------------------------------

### MySQL DB Migration Script for Domibus 4.0.1 Multitenancy

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Run this script for MySQL database migration for multitenancy from Domibus 4.0 to 4.0.1.

```SQL
mysql5innoDb-4.0-to-4.0.1-multi-tenancy-migration.ddl
```

--------------------------------

### Configure WS Plugin Backend Endpoint

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Replaces the existing backend interface endpoint configuration in ws-plugin.xml to enable schema validation and MTOM.

```xml
<jaxws:endpoint id="backendInterfaceEndpoint" implementor="#backendWebservice" address="/backend">

    <jaxws:properties>
        <entry key="schema-validation-enabled" value="true"/>
        <entry key="mtom-enabled" value="true"/>
    </jaxws:properties>

    <jaxws:schemaLocations>
        <jaxws:schemaLocation>schemas/domibus-submission.xsd</jaxws:schemaLocation>
        <jaxws:schemaLocation>schemas/xml.xsd</jaxws:schemaLocation>
        <jaxws:schemaLocation>schemas/domibus-backend.xsd</jaxws:schemaLocation>
        <jaxws:schemaLocation>schemas/xmlmime.xsd</jaxws:schemaLocation>
    </jaxws:schemaLocations>

</jaxws:endpoint>
```

--------------------------------

### Add Dispatch Client Cache Configuration

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

XML snippet to add to ehcache.xml for configuring the 'dispatchClient' cache. Adjust maxBytesLocalHeap and timeToLiveSeconds as needed.

```xml
<cache name="dispatchClient"
                           maxBytesLocalHeap="5m"
                           timeToLiveSeconds="3600"
                           overflowToDisk="false">
                        <sizeOfPolicy maxDepthExceededBehavior="abort"/>
                    </cache>
```

--------------------------------

### MySQL DB Migration Script for Domibus 4.0

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Run this script for MySQL database migration from Domibus 3.3.4 to 4.0.

```SQL
mysql5innoDb-3.3.4-to-4.0-migration.ddl
```

--------------------------------

### MySQL DB Migration Script for Domibus 4.0.1

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Run this script for MySQL database migration from Domibus 4.0 to 4.0.1.

```SQL
mysql5innoDb-4.0-to-4.0.1-migration.ddl
```

--------------------------------

### Configure XA Connection Factory for ActiveMQ

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

For Tomcat users, this snippet shows how to replace the existing xaConnectionFactory configuration in domibus-datasources.xml to include a redeliveryPolicy.

```xml
<amq:xaConnectionFactory id="xaJmsConnectionFactory" brokerURL="tcp://localhost:61616" userName="domibus" password="changeit">
    <!-- do not remove this! otherwise the redeliveryPolicy configured in activemq.xml will be ignored -->
    <amq:redeliveryPolicy>
        <amq:redeliveryPolicy/>
    </amq:redeliveryPolicy>
</amq:xaConnectionFactory>
```

--------------------------------

### Map Keystore Password Callback Properties

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Mapping of old keystore password callback properties in domibus-security.xml to the new domibus.properties format. This ensures correct password handling for keystores.

```xml
<util:properties id="keystorePasswordCallback">
                                - "key" mapped to "domibus.security.key.private.alias"
                                - "value" mapped to "domibus.security.key.private.password"
                        
```

--------------------------------

### Run End-to-End Tests

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH-angular/README.md

Execute end-to-end tests using Protractor. Ensure the app is served via 'ng serve' before running.

```bash
ng e2e
```

--------------------------------

### Map Keystore Properties

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Mapping of old keystore properties in domibus-security.xml to the new domibus.properties format. This ensures correct security configurations are migrated.

```xml
<util:properties id="keystoreProperties">
                                - "org.apache.ws.security.crypto.merlin.keystore.type" mapped to "domibus.security.keystore.type"
                                - "org.apache.ws.security.crypto.merlin.keystore.password" mapped to "domibus.security.keystore.password"
                                - "org.apache.ws.security.crypto.merlin.keystore.alias" mapped to "domibus.security.key.private.alias"
                                - "org.apache.ws.security.crypto.merlin.file" mapped to "domibus.security.keystore.location"
                        </util:properties>
```

--------------------------------

### Configure Security for Administration GUI

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Replace the existing security configuration for the Administration GUI user credentials in domibus-security.xml. This snippet shows the structure for defining users and their authorities.

```xml
<sec:password-encoder ref="bcryptEncoder"/>
                                         <sec:user-service>
                                             <sec:user name="user" password="$2a$10$HApapHvDStTEwjjneMCvxuqUKVyycXZRfXMwjU0rRmaWMsjWQp/Zu"
                                                       authorities="ROLE_USER"/>
                                             <sec:user name="admin" password="$2a$10$5uKS72xK2ArGDgb2CwjYnOzQcOmB7CPxK6fz2MGcDBM9vJ4rUql36"
                                                       authorities="ROLE_USER, ROLE_ADMIN"/>
                                         </sec:user-service>
                                     </sec:authentication-provider>
                                 </sec:authentication-manager>
                                 <sec:global-method-security pre-post-annotations="enabled"/>
```

--------------------------------

### Configure ActiveMQ Redelivery Policies for Tomcat

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Set redelivery policies for alert and UI replication queues in activemq.xml for Tomcat.

```xml
<redeliveryPolicyEntries>
    .............................
     <redeliveryPolicy queue="domibus.internal.alert.queue" maximumRedeliveries="0"/>
      <redeliveryPolicy queue="domibus.internal.ui.replication.queue" maximumRedeliveries="1" redeliveryDelay="10000"/>
    .............................
</redeliveryPolicyEntries>
```

--------------------------------

### JSON and Date Formatting

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH-angular/src/app/jms/jms.component.html

Demonstrates the use of Angular's built-in 'json' pipe for debugging and a custom 'domibusDate' pipe for formatting dates. These are typically used for displaying complex data structures and timestamps.

```HTML
{{value | json}} {{value | domibusDate: dateFormat}}
```

--------------------------------

### Configure WS Plugin Interceptors

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

XML configuration snippet for the ws-plugin.xml file. Add the specified interceptors to the backend interface endpoint configuration.

```xml
<jaxws:endpoint id="backendInterfaceEndpoint" implementor="#backendWebservice" address="/backend">
                        ........................
                         <jaxws:outInterceptors>
                            <ref bean="clearAuthenticationMDCInterceptor"/>
                        </jaxws:outInterceptors>
                        <jaxws:outFaultInterceptors>
                            <ref bean="clearAuthenticationMDCInterceptor"/>
                        </jaxws:outFaultInterceptors>

                    </jaxws:endpoint>
```

--------------------------------

### Generate Angular Component

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH-angular/README.md

Use the Angular CLI to generate new components, directives, pipes, services, classes, or modules.

```bash
ng generate component component-name
```

--------------------------------

### Admin GUI User Credentials Configuration

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Configures Spring Security for the Administration GUI, defining user roles and passwords using BCrypt encoding.

```xml
<bean name="bcryptEncoder"
        class="org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder"/>
<sec:authentication-manager>
    <sec:authentication-provider ref="allowAllAuthenticationProvider"/>
</sec:authentication-manager>
<sec:authentication-manager id="authenticationManagerForAdminConsole">
    <sec:authentication-provider>
        <sec:password-encoder ref="bcryptEncoder"/>
        <sec:user-service>
            <sec:user name="user" password="$2a$10$HApapHvDStTEwjjneMCvxuqUKVyycXZRfXMwjU0rRmaWMsjWQp/Zu"
                    authorities="ROLE_USER"/>
            <sec:user name="admin" password="$2a$10$5uKS72xK2ArGDgb2CwjYnOzQcOmB7CPxK6fz2MGcDBM9vJ4rUql36"
                    authorities="ROLE_USER, ROLE_ADMIN"/>
        </sec:user-service>
    </sec:authentication-provider>
</sec:authentication-manager>
<sec:global-method-security pre-post-annotations="enabled"/>
```

--------------------------------

### Configure Tomcat XA Connection Factory

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Replace the existing xaConnectionFactory configuration in domibus-datasources.xml to include a redelivery policy. This ensures that the redeliveryPolicy configured in activemq.xml is not ignored.

```xml
<amq:xaConnectionFactory id="xaJmsConnectionFactory"
                                 brokerURL="tcp://localhost:61616"
                                 userName="domibus" password="changeit">
                                    <!-- do not remove this! otherwise the redeliveryPolicy configured in activemq.xml will be ignored -->
                                    <amq:redeliveryPolicy>
                                        <amq:redeliveryPolicy/>
                                    </amq:redeliveryPolicy>
                                </amq:xaConnectionFactory>
```

--------------------------------

### Oracle DB Migration Script for Domibus 4.0.1

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Run this script for Oracle database migration from Domibus 4.0 to 4.0.1.

```SQL
oracle10g-4.0-to-4.0.1-migration.ddl
```

--------------------------------

### Oracle DB Migration Script for Domibus 4.0

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Run this script for Oracle database migration from Domibus 3.3.4 to 4.0.

```SQL
oracle10g-3.3.4-to-4.0-migration.ddl
```

--------------------------------

### Add AuthenticationEntry Class to Persistence Unit

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Add the eu.domibus.plugin.webService.entity.AuthenticationEntry class to the <persistence-unit> tag in persistence.xml. This is a Tomcat-specific configuration.

```xml
<class>eu.domibus.plugin.webService.entity.AuthenticationEntry</class>
```

--------------------------------

### Oracle DB Migration Script for Domibus 4.0.1 Multitenancy

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Run this script for Oracle database migration for multitenancy from Domibus 4.0 to 4.0.1.

```SQL
oracle10g-4.0-to-4.0.1-multi-tenancy-migration.ddl
```

--------------------------------

### Oracle Datasource Configuration

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Configure an Oracle datasource connection for Domibus. Ensure the driver class and connection URL are correctly set for your Oracle instance.

```xml
<datasource jndi-name="java:jboss/datasources/domibusDS" pool-name="domibusDS" enabled="true">
                                    <connection-url>jdbc:oracle:thin:@localhost:1521:xe</connection-url>
                                    <driver-class>oracle.jdbc.OracleDriver</driver-class>
                                    <driver>com.oracle</driver>
                                    <security>
                                        <user-name>edelivery_username</user-name>
                                        <password>edelivery_password</password>
                                    </security>
                                    <validation>
                                        <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleValidConnectionChecker"/>
                                        <background-validation>true</background-validation>
                                        <stale-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleStaleConnectionChecker"/>
                                        <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleExceptionSorter"/>
                                    </validation>
                                </datasource>
```

--------------------------------

### Domibus 3.3.4 Standard Datasource Property

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Configure the standard datasource URL for Domibus 3.3.4.

```properties
domibus.datasource.url=jdbc:mysql://${domibus.database.serverName}:${domibus.database.port}/${domibus.database.general.schema}?useSSL=false
```

--------------------------------

### Update domibus-configuration.xml for PMode Provider and Certificate Validation

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Modifies domibus-configuration.xml to update the PMode provider class and enable certificate validation.

```xml
<prop key="domibus.certificate.validation.enabled">true</prop>
```

--------------------------------

### Add EHCache Configuration for Lookup Info

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Add this EHCache configuration to conf/domibus/internal/ehcache.xml to manage the 'lookupInfo' cache. This is relevant for Domibus 3.2.2.

```xml
<cache name="lookupInfo"
maxBytesLocalHeap="5m"
timeToLiveSeconds="3600"
overflowToDisk="false">
</cache>
```

--------------------------------

### Set Default Schema Charset (MySQL)

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

MySQL specific command to set the default character set and collation for a schema. Replace `your_domibus_schema_name` with your actual schema name.

```sql
alter schema `your_domibus_schema_name` default charset=utf8 collate=utf8_bin;
```

--------------------------------

### Quartz Executor Service Configuration

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Configure a managed executor service specifically for Quartz scheduling. This allows for long-running tasks and defines thread pool settings.

```xml
<managed-executor-service name="quartzExecutorService" jndi-name="java:jboss/ee/concurrency/executor/QuartzExecutorService" context-service="default" hung-task-threshold="0" long-running-tasks="true" core-threads="5" max-threads="25" keepalive-time="5000"/>
```

--------------------------------

### Domibus 3.2.1 WebLogic WLST Script

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Execute WLST API scripts for WebLogic single server or cluster deployments during the Domibus 3.2.1 upgrade.

```shell
3.2-to-3.2.1-WeblogicSingleServer.properties
```

```shell
3.2-to-3.2.1-WeblogicCluster.properties
```

--------------------------------

### Address Setting for DomibusNotifyBackendFileSystemQueue

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Define address settings for the Domibus notification queue, including dead-letter and expiry addresses, and redelivery delay.

```xml
<address-setting match="jms.queue.DomibusNotifyBackendFileSystemQueue">
                                            <dead-letter-address>jms.queue.DomibusDLQ</dead-letter-address>
                                            <expiry-address>jms.queue.ExpiryQueue</expiry-address>
                                            <redelivery-delay>1000</redelivery-delay>
                                            <max-delivery-attempts>1</max-delivery-attempts>
                                        </address-setting>
```

--------------------------------

### Update Maven Dependencies for Logging

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Modify your custom plugin's pom.xml to switch from Commons Logging to Domibus's SLF4J-based logger. This involves removing one dependency and adding another.

```xml
<dependency>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
<scope>provided</scope>
</dependency>
```

```xml
<dependency>
<groupId>eu.domibus</groupId>
<artifactId>domibus-logging</artifactId>
</dependency>
```

--------------------------------

### Domibus Notify Backend FileSystem Queue Configuration

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Configure a JMS queue for Domibus file system notifications. It is set as durable and includes specific JNDI entries.

```xml
<jms-queue name="DomibusNotifyBackendFileSystemQueue">
                                        <entry name="java:/jms/domibus.notification.filesystem"/>
                                        <entry name="java:/jms/queue/DomibusNotifyBackendFileSystemQueue"/>
                                        <durable>true</durable>
                                     </jms-queue>
```

--------------------------------

### Domibus 3.3.2 Logback Marker Replacement

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Replace log markers in logback.xml for Domibus 3.3.2.

```xml
<marker>LOGGED_MARKER</marker>
                        with
                        <marker>SECURITY</marker>
                        <marker>BUSINESS</marker>
```

--------------------------------

### Update Discarding DLQ Broker Plugin for Tomcat

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Modify the 'dropOnly' parameter in discardingDLQBrokerPlugin for Tomcat.

```xml
<discardingDLQBrokerPlugin dropAll="false" dropOnly="domibus.internal.dispatch.queue domibus.internal.pull.queue domibus.internal.alert.queue" reportInterval="10000"/>
```

--------------------------------

### Update commons-lang Dependency to commons-lang3

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Replace the Maven dependency 'commons-lang' with 'commons-lang3' for compatibility.

```XML
<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-lang3</artifactId>
    <scope>provided</scope>
</dependency>
```

--------------------------------

### Add Cert Validation Cache to ehcache.xml

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Adds a new cache configuration for 'certValidationByAlias' to ehcache.xml to manage certificate validation caching.

```xml
<cache name="certValidationByAlias" maxBytesLocalHeap="5m" timeToLiveSeconds="3600" overflowToDisk="false"/>
```

--------------------------------

### Map Truststore Properties

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Mapping of old truststore properties in domibus-security.xml to the new domibus.properties format. This ensures correct truststore configurations are migrated.

```xml
<util:properties id="trustStoreProperties">
                                - "org.apache.ws.security.crypto.merlin.trustStore.type" mapped to "domibus.security.truststore.type"
                                
```

--------------------------------

### Domibus Properties Configuration

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Modify the domibus.properties file by adding, updating, or deleting specific properties as indicated for different environments.

```properties
domibus.dynamicdiscovery.useDynamicDiscovery=true
```

```properties
domibus.entityManagerFactory.jpaProperty.hibernate.transaction.manager_lookup_class
```

```properties
domibus.entityManagerFactory.jpaProperty.hibernate.transaction.jta.platform=org.hibernate.engine.transaction.jta.platform.internal.WeblogicJtaPlatform
```

```properties
domibus.entityManagerFactory.jpaProperty.hibernate.transaction.jta.platform=com.atomikos.icatch.jta.hibernate4.AtomikosJ2eePlatform
```

```properties
domibus.entityManagerFactory.jpaProperty.hibernate.transaction.jta.platform=org.hibernate.engine.transaction.jta.platform.internal.JBossAppServerJtaPlatform
```

```properties
domibus.entityManagerFactory.jpaProperty.hibernate.id.new_generator_mappings=false
```

```properties
#MySQL
domibus.datasource.xa.property.url=jdbc:mysql://${domibus.database.serverName}:${domibus.database.port}/${domibus.database.schema}?pinGlobalTxToPhysicalConnection=true
domibus.datasource.url=jdbc:mysql://${domibus.database.serverName}:${domibus.database.port}/${domibus.database.schema}?useSSL=false
```

```properties
domibus.backend.jmsInQueue
```

```properties
domibus.pmode.dao.implementation
```

--------------------------------

### OAuth2 Redirect Logic

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH-swagger/src/main/webapp/oauth2-redirect.html

This JavaScript code runs on the redirect page to parse the URL hash or query parameters, extract OAuth2 authorization code or tokens, validate the state, and call back to the opener window with the authentication result. It handles errors and closes the redirect window upon completion.

```javascript
"use strict"; function run () { var oauth2 = window.opener.swaggerUIRedirectOauth2; var sentState = oauth2.state; var redirectUrl = oauth2.redirectUrl; var isValid, qp, arr; qp = (window.location.hash || location.search).substring(1); arr = qp.split("&") arr.forEach(function (v,i,
_arr) { 
_arr[i] = '"' + v.replace('=', '":"') + '"';}) qp = qp ? JSON.parse('{\' + arr.join() + '\'}', function (key, value) { return key === "" ? value : decodeURIComponent(value) } ) : {} isValid = qp.state === sentState if (oauth2.auth.schema.get("flow") === "accessCode" && !oauth2.auth.code) { if (!isValid) { oauth2.errCb({ authId: oauth2.auth.name, source: "auth", level: "warning", message: "Authorization may be unsafe, passed state was changed in server Passed state wasn\'t returned from auth server" }); } if (qp.code) { delete oauth2.state; oauth2.auth.code = qp.code; oauth2.callback({auth: oauth2.auth, redirectUrl: redirectUrl}); } else { oauth2.errCb({ authId: oauth2.auth.name, source: "auth", level: "error", message: "Authorization failed: no accessCode received from the server" }); } } else { oauth2.callback({auth: oauth2.auth, token: qp, isValid: isValid, redirectUrl: redirectUrl}); } window.close(); }
```

--------------------------------

### Domibus 3.3.4 MySQL Datasource Property

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Configure the MySQL datasource URL with XA properties for Domibus 3.3.4.

```properties
domibus.datasource.xa.property.url=jdbc:mysql://${domibus.database.serverName}:${domibus.database.port}/${domibus.database.general.schema}?pinGlobalTxToPhysicalConnection=true
```

--------------------------------

### Domibus 3.2 Configuration File Updates

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Update domibus-configuration.xml for Domibus 3.2 upgrade, including PMode provider class, certificate validation, and JMS internal queue expression. Includes a specific property for Tomcat users regarding ActiveMQ JMX URL.

```xml
<prop key="domibus.certificate.validation.enabled">true</prop>
```

```xml
<prop key="domibus.jms.internalQueue.expression">.*domibus\.(internal|DLQ|backend\.jms|notification\.jms|notification\.webservice|notification\.kerkovi).*</prop>
```

```xml
<prop key="activeMQ.JMXURL">service:jmx:rmi://localhost:1198/jndi/rmi://localhost:1199/jmxrmi</prop>
```

--------------------------------

### Add CRL Cache Configuration to Ehcache

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Add a new cache named 'crlByCert' to the ehcache.xml configuration file. This cache is configured with specific heap size, time-to-live, and overflow settings.

```xml
<cache name="crlByCert"
                                                maxBytesLocalHeap="5m"
                                                timeToLiveSeconds="3600"
                                                overflowToDisk="false">

</cache>
```

--------------------------------

### Address Setting for DomibusPullMessageQueue

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Configure address settings for the Domibus pull message queue, specifying dead-letter and expiry addresses, and redelivery attempts.

```xml
<address-setting match="jms.queue.DomibusPullMessageQueue">
                                            <dead-letter-address>jms.queue.DomibusDLQ</dead-letter-address>
                                            <expiry-address>jms.queue.ExpiryQueue</expiry-address>
                                            <redelivery-delay>1000</redelivery-delay>
                                            <max-delivery-attempts>1</max-delivery-attempts>
                                        </address-setting>
```

--------------------------------

### Domibus 3.2 Ehcache Configuration Update

Source: https://github.com/cefedelivery/domibus/blob/master/Domibus-MSH/upgrade-info.txt

Add new cache configurations for 'certValidationByAlias' and 'crlByAlias' in ehcache.xml for Domibus 3.2 upgrade.

```xml
<cache name="certValidationByAlias" maxBytesLocalHeap="5m" timeToLiveSeconds="3600" overflowToDisk="false"/>
```

```xml
<cache name="crlByCert" maxBytesLocalHeap="5m" timeToLiveSeconds="3600" overflowToDisk="false"/>
```