CrossBorder-Gateway/Domibus/Server-setup-guide.md

@@ -34,6 +34,10 @@ Provision a Linux server with the Docker engine, including Docker Compose. As a
 
 Ensure your server is publicly accessible from the internet through a public IP. The instructions are demonstrated on an `Ubuntu 22.04 Jammy Jellyfish` server, but other Linux distributions are also compatible.
 
+To begin the setup, ensure you have the following:
+- The capability to generate a `Java KeyStore`
+- Access to the files within the [eu-Domibus](https://drive.google.com/drive/folders/1rj7ezhFDjrxZS_CZG6ZKApU57-htG0zA?usp=drive_link) folder.
+
 ## Sources
 - [Domibus official documentation](https://ec.europa.eu/digital-building-blocks/wikis/display/DIGITAL/Domibus)
 - [eDelivery repository](https://code.europa.eu/edelivery)
@@ -126,6 +130,7 @@ Make sure you have the Java KeyStore/TrustStore located in  **`{DOMIBUS_DOCKER_D
 - `gateway_truststore.jks` store the public keys of other eDelivery Access Points for message exchange.
 
 To ensure a minimal installation for managing keys and using the `keytool` command, it's recommended to install the headless version of `OpenJDK-17`, such as `OpenJDK-17-jre-headless`.
+But you can use other means to generate a `Java KeyStore`.
 
 In the **`keystores`** folder, remove existing KeyStore/TrustStore with the following command:
 ```shell
@@ -218,7 +223,7 @@ For the French-Connector, you might create a user named `frc_user`.
 
 ## 5 - Processing Modes
 Processing Modes _PModes_ are used to configure Access Points. The PMode parameters are loaded into the Access Point via an XML file.
-Begin by downloading the PMode template file [pmode.xml](uploads/domibus/pmode-2023-11-24.xml) and replacing the variables with the appropriate placeholder values. Upload the modified file under:
+Begin by downloading the PMode template file [pmode.xml](https://drive.google.com/file/d/1onmrwqKYcVeTwSZLzzD0WrYd9ndJbLxW/view?usp=drive_link) and replacing the variables with the appropriate placeholder values. Upload the modified file under:
 
 **`PMode` → `Current`**
 
@@ -242,7 +247,7 @@ http://51.159.133.186:8080/domibus/services/msh
 >**Note**:
 The host `51.159.133.186:8080` is the EU Domibus server's address. If you add another Access Point, include the address of that Domibus server.
 
-Import the [EU Access Point Certificate](/uploads/domibus/europe_ap.cer)
+Import the [EU Access Point Certificate](https://drive.google.com/file/d/1jduYescq5XkJ8PPoMamWBDjOFoAY9GNO/view?usp=drive_link)
 
 Scroll down to the `Identifiers` section, click on `+ New`, and add the Access Point name, which is `europe_ap` for the EU Access Point and set this for the following properties:
 
@@ -269,4 +274,71 @@ Navigate to the `Connection Monitoring` section and try sending a message to you
 ![monitoring](/img/domibus/image6.png)
 
 ### SoapUI test
-# :construction: Working in progress :construction:
\ No newline at end of file
+To perform testing with SoapUI, follow these steps:
+
+##### 1 - Install SoapUI:
+- Ensure you have the latest version of [SoapUI](https://www.soapui.org/) installed.
+
+##### 2 - Download Domibus Sample:
+- Download the Domibus sample configuration for testing from [here](https://ec.europa.eu/digital-building-blocks/wikis/display/DIGITAL/Domibus).
+- Click on `View all binaries` and download the **Domibus Sample Configuration and Testing**.
+- Extract the downloaded file.
+
+##### 3 - Import SoapUI Project:
+- Open `SoapUI` and right-click on `Projects`.
+- Select `Import Project` and import the XML file named `AS4-test-guide-soapui-project.xml`. Find this file in the following location within the extracted folder:
+```
+domibus-msh-distribution-x.x.x-sample-configuration-and-testing/test/soapui
+```
+
+##### 4 - Configure SoapUI:
+- Navigate to either the `submitMessage` request for manual envelope building or go to `Web Service Submission` and look for `sendMessage` for a quick test.
+
+![sendmessage](/img/soapui/image1.png)
+
+- Add your **`{DOMBIS_HOSTNAME}`** and **`{DOMIBUS_PORT}`** to the `URL`. Click the scroll-down arrow on the `URL`, then `[add new endpoint..]`.
+Ensure the path remains as follows:
+```http
+http://{DOMBIS_HOSTNAME}:{DOMIBUS_PORT}/domibus/services/wsplugin
+```
+![endpoint](/img/soapui/image2.png)
+
+- Add your user plugin credentials by clicking on `Auth` at the bottom left, choosing `Basic`, and entering your plugin `Username` and `Password`.
+
+- It's crucial to check the checkbox `Authenticate pre-emptively`.
+
+![auth](/img/soapui/image3.png)
+
+
+- Modify the XML by setting the `Sender` Access Point and the `Recipient` Access Point:
+```xml
+<ns:From>
+  <ns:PartyId type="urn:oasis:names:tc:ebcore:partyid-type:unregistered">{DOMIBUS_ACCESS_POINT}</ns:PartyId>
+```
+For the `Recipient`, we can set the `europe_ap`:
+
+```xml
+<ns:To>
+  <ns:PartyId type="urn:oasis:names:tc:ebcore:partyid-type:unregistered">europe_ap</ns:PartyId>
+```
+
+##### 5 - Send the eDelivery Message:
+- Click on the green arrow on the top left to send your eDelivery message.
+- Confirm a status code of 200 on the right.
+
+![send](/img/soapui/image4.png)
+
+- Click on the XML tab on the right to view the XML results in a readable format.
+
+```xml
+<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
+   <soap:Body>
+      <ns2:submitResponse xmlns:ns2="http://eu.domibus.wsplugin/" xmlns:ns3="http://docs.oasis-open.org/ebxml-msg/ebms/v3.0/ns/core/200704/" xmlns:xmime="http://www.w3.org/2005/05/xmlmime" xmlns:ns5="http://www.w3.org/2003/05/soap-envelope">
+         <messageID>00000000-0000-0000-0000-000000000000@domibus.eu</messageID>
+      </ns2:submitResponse>
+   </soap:Body>
+</soap:Envelope>
+```
+- Verify your sent/received messages in the `Messages` section of your Domibus Console.
+
+![messages](/img/domibus/image7.png)