Getting started guide - Revision history

Javier.ferrero: Documents upload

2023-03-07T16:32:42Z

Documents upload

Javier.ferrero at 16:30, 7 March 2023

2023-03-07T16:30:01Z

Javier.ferrero at 16:27, 7 March 2023

2023-03-07T16:27:43Z

Javier.ferrero at 16:22, 7 March 2023

2023-03-07T16:22:09Z

Javier.ferrero at 16:25, 6 March 2023

2023-03-06T16:25:57Z

Javier.ferrero: Quality review

2022-08-01T16:36:41Z

Quality review

Hugo.berdon: /* DE4A Connector */

2022-07-14T15:45:23Z

DE4A Connector

Hugo.berdon: /* DE4A Connector */

2022-07-14T15:45:03Z

DE4A Connector

Javier.ferrero: Link fixed

2022-07-14T07:18:53Z

Link fixed

Hugo.berdon: /* Data Evaluator / Data Owner */

2022-07-14T07:14:46Z

Data Evaluator / Data Owner

@@ Line 9: / Line 9: @@
 The SMP must be installed, configured and populated with the right information. To install and configure the SMP, the following two documents are of help:
-* <nowiki>[[Media:2022-04-01 Setting up a Service Metadata Publisher for DE4A|Setting up a Service Metadata Publisher for DE4A.pdf]]</nowiki>
+* [[Media:Setting up a Service Metadata Publisher for DE4A.pdf|2022-04-01 Setting up a Service Metadata Publisher for DE4A]]
-* <nowiki>[[Media:Setting up a Service Metadata Publisher for DE4A|2022-04-01 Setting up a Service Metadata Publisher for DE4A.pdf]]</nowiki>
+* [[Media:Configuring the SMP for the IAL.pdf|2022-05-02 Configuring the SMP for the IAL]]
 Once the SMP is set up, the operating entity must populate it with the appropriate information of participants and evidence types that the relevant national DE4A participants are going to request and provide. Each SMP must only store and manage the information related to the participants of the same country as where the SMP is located, so that each country is only responsible for its own information.

@@ Line 10: / Line 10: @@
 The SMP must be installed, configured and populated with the right information. To install and configure the SMP, the following two documents are of help:
 * <nowiki>[[Media:2022-04-01 Setting up a Service Metadata Publisher for DE4A|Setting up a Service Metadata Publisher for DE4A.pdf]]</nowiki>
-<nowiki>[[Media:Configuring the SMP for the IAL.pdf.ogg]]</nowiki>
+* <nowiki>[[Media:Setting up a Service Metadata Publisher for DE4A|2022-04-01 Setting up a Service Metadata Publisher for DE4A.pdf]]</nowiki>
 Once the SMP is set up, the operating entity must populate it with the appropriate information of participants and evidence types that the relevant national DE4A participants are going to request and provide. Each SMP must only store and manage the information related to the participants of the same country as where the SMP is located, so that each country is only responsible for its own information.

@@ Line 9: / Line 9: @@
 The SMP must be installed, configured and populated with the right information. To install and configure the SMP, the following two documents are of help:
-* <nowiki>[[Media:Setting up a Service Metadata Publisher for DE4A.pdf.ogg]]</nowiki>
+* <nowiki>[[Media:2022-04-01 Setting up a Service Metadata Publisher for DE4A|Setting up a Service Metadata Publisher for DE4A.pdf]]</nowiki>
-* <nowiki>[[Media:Configuring the SMP for the IAL.pdf.ogg]]</nowiki>
+<nowiki>[[Media:Configuring the SMP for the IAL.pdf.ogg]]</nowiki>
 Once the SMP is set up, the operating entity must populate it with the appropriate information of participants and evidence types that the relevant national DE4A participants are going to request and provide. Each SMP must only store and manage the information related to the participants of the same country as where the SMP is located, so that each country is only responsible for its own information.

@@ Line 1: / Line 1: @@
-This guide provides a list of steps to be taken by each partner wishing to deploy and join the DE4A infrastructure of iteration 2. There are four main activities: getting eDelivery certificates, setting up an SMP for DE4A, setting up a DE4A Connector and the development and integration of the final participant. There is an additional chapter for those participants who wish to use and integrate with the DE4A Playground.
+<nowiki>[[Media:File.ogg]]</nowiki>This guide provides a list of steps to be taken by each partner wishing to deploy and join the DE4A infrastructure of iteration 2. There are four main activities: getting eDelivery certificates, setting up an SMP for DE4A, setting up a DE4A Connector and the development and integration of the final participant. There is an additional chapter for those participants who wish to use and integrate with the DE4A Playground.
 == 1. Getting eDelivery certificates ==
@@ Line 9: / Line 9: @@
 The SMP must be installed, configured and populated with the right information. To install and configure the SMP, the following two documents are of help:
-* 2022-04-01 Setting up a Service Metadata Publisher for DE4A.pdf
+* <nowiki>[[Media:Setting up a Service Metadata Publisher for DE4A.pdf.ogg]]</nowiki>
-* 2022-05-02 Configuring the SMP for the IAL.pdf
+* <nowiki>[[Media:Configuring the SMP for the IAL.pdf.ogg]]</nowiki>
 Once the SMP is set up, the operating entity must populate it with the appropriate information of participants and evidence types that the relevant national DE4A participants are going to request and provide. Each SMP must only store and manage the information related to the participants of the same country as where the SMP is located, so that each country is only responsible for its own information.

@@ Line 1: / Line 1: @@
-This guide provides a list of steps to be taken by each partner wishing to deploy and join the DE4A infrastructure of iteration 2. There are three main milestones: SMP, DE4A Connector and DE/DO. Each milestone must be properly completed before moving on to the next one. This is due to the way the Playground will be used in the second iteration.
+This guide provides a list of steps to be taken by each partner wishing to deploy and join the DE4A infrastructure of iteration 2. There are four main activities: getting eDelivery certificates, setting up an SMP for DE4A, setting up a DE4A Connector and the development and integration of the final participant. There is an additional chapter for those participants who wish to use and integrate with the DE4A Playground.
-== 0. Usage of the Playground it2 ==
+== 1. Getting eDelivery certificates ==
 The Playground can only be used in two ways:
@@ Line 21: / Line 80: @@
 === URL addresses for the Playground environment ===
-The Playground environment has a cross border infrastructure. Data consumer side is deployed at University of Maribor in Slovenia where the DemoUI is acting as Data Evaluator and the Connector as Data Requestor.
+The Playground environment has a cross border infrastructure. Data consumer side is deployed at the University of Maribor in Slovenia where the DemoUI is acting as Data Evaluator and the Connector as Data Requestor.
 * DemoUI DE - https://de4a-demoui-dev.informatika.uni-mb.si/
@@ Line 51: / Line 110: @@
 |test
 |}

@@ Line 1: / Line 1: @@
 This guide provides a list of steps to be taken by each partner wishing to deploy and join the DE4A infrastructure of iteration 2. There are three main milestones: SMP, DE4A Connector and DE/DO. Each milestone must be properly completed before moving on to the next one. This is due to the way the Playground will be used in the second iteration.
-Usage of the Playground it2
+== 0. Usage of the Playground it2 ==
 The Playground can only be used in two ways:
-* By exchanging messages between the DemoUI and the Mocked DO.
+* By exchanging messages between the DemoUI and the Mocked DO as the participants involved.
-* By using the infrastructure of a partner as a Data Consumer or Data Provider.
+* By using the infrastructure of a partner to act as a Data Consumer or Data Provider.
 For the second option, it is mandatory to set up a complete interaction side: either the sender (DC) or the recipient (DP). This means that, in this second iteration, the use of only a DE or a DO to exchange messages via the Playground is not supported.
@@ Line 21: / Line 20: @@
 The Shared SMP cannot be used for participants other than the imaginary ones.
-=== URL addresses for playground environment ===
+=== URL addresses for the Playground environment ===
-The playground environment has a cross border infrastructure. Data consumer side is deployed at University of Maribor in Slovenia where DemoUI is acting as Data Evaluator and Connector as Data Requestor.
+The Playground environment has a cross border infrastructure. Data consumer side is deployed at University of Maribor in Slovenia where the DemoUI is acting as Data Evaluator and the Connector as Data Requestor.
 * DemoUI DE - https://de4a-demoui-dev.informatika.uni-mb.si/
 * Connector DR - https://de4a-connector-dev.informatika.uni-mb.si/
-The Data Provider side is deployed at SGAD in Spain where the Connector is a Data Transferor and the Data Owner is the mocked DO
+The Data Provider side is deployed at SGAD in Spain where the Connector is a Data Transferor and the Data Owner is the Mocked DO.
 * Connector DT - https://pre-as4gw-dt-de4a.redsara.es/de4a-it2-connector/
 * Mocked DO - https://pre-smp-dr-de4a.redsara.es/de4a-mock-connector/
+A Kafka tracker is available through the following URL: https://de4a.simplegob.com/package-tracker/#!detail
 For detailed traceability, these are the topics where each component is logging to Kafka.
@@ Line 57: / Line 52: @@
 |}
-=== SMP ===
+== 1. SMP ==
 ''This section only applies for those participants required to install an SMP instance.''
-Setup your own national SMP. The SMP must be installed, configured and populated with the right information. To install and configure the SMP, two documents are available on the OwnCloud:
+Setup your own national SMP. The SMP must be installed, configured and populated with the right information. To install and configure the SMP, two documents are available on the [https://newrepository.atosresearch.eu/index.php/apps/files?dir=/DE4A-Project/06%20Workpackages/WP5%20Components%20design/Setup%20documents/Setting%20up%20a%20SMP&fileid=1145283 OwnCloud of DE4A]:
 * 2022-04-01 Setting up a Service Metadata Publisher for DE4A.pdf
 * 2022-05-02 Configuring the SMP for the IAL.pdf
 To populate the SMP with the appropriate information, each partner must know the participants and evidence their national SMP should store. The Wiki page [[Useful information on pilots and participants]] may help in this task.
-==== Governance procedure ====
+=== Governance procedure ===
 When populating/updating the information in the SMP, the [[Useful information on pilots and participants]] wiki page should also be updated to stay aligned. After that, both ATOS (Ana María Piñuela, Alberto Crespo, Javier Presa) / WP5 (Javier Ferrero, Javier Baena, Eduardo Moreno, Hugo Berdón) should also be informed about these changes.
-==== TIP ====
+=== TIP ===
 What information needs to be added?
@@ Line 93: / Line 86: @@
 For this example, the endpoint URL should be: <nowiki>https://de4a.simplegob.com/de4a-it2-connector/phase4</nowiki>
-=== DE4A Connector ===
+== 2. DE4A Connector ==
 ''This section only applies for those participants required to install a Connector instance.''
-Deploy the release version of the Connector from the [https://github.com/de4a-wp5/de4a/releases GitHub of WP5]. To do so, follow the DE4A [[Installation and configuration guide of the DE4A Connector it2]].
+Deploy the latest release version of the Connector from the [https://github.com/de4a-wp5/de4a/releases GitHub of WP5]. To do so, follow the DE4A [[Installation and configuration guide of the DE4A Connector it2]].
-=== Data Evaluator / Data Owner ===
+== 3. Data Evaluator / Data Owner ==
-In order to understand the common specifications each partner needs to follow to properly exchange messages with the rest of the DE4A components, the following resources are available within the Common specifications section:
+In order to understand the common specifications each partner needs to follow to properly exchange messages with the rest of the DE4A components, the following resources are available within the Common specifications section of the WP5 part of the DE4A Wiki:
-* [[Common behaviour and interactions between components]]
+*[[Common behaviour and interactions between components]]
-** Description of the interaction patterns of the second iteration through communication diagrams. Data structures used during exchanges are also descripted there.
+** Description of the interaction patterns of the second iteration through communication diagrams. Data structures used during exchanges are also described there.
-* [[Summary of software interfaces.|Summary of software interfaces]]
+*[[Summary of software interfaces.|Summary of software interfaces]]
 ** Reference information on the software interfaces of the DE4A components.
-* [[DE4A Logs and error messages it2|DE4A Logs and error messages]]
+*[[DE4A Logs and error messages it2|DE4A Logs and error messages]]
 ** Updated version for the second iteration of the specification of the common error and logs messages used during exchanges.
 USI and IM patterns have been updated compared to iteration 1. Subscription, notification and lookup patterns are new for this iteration 2.
-==== DE/DO Certificates ====
+=== DE/DO Certificates ===
-The certifcates used by these components must be same used before for production environment in iteration 1.
+In the second iteration of the project, DE and DO components must only use production certificates, while in iteration 1 pre-production and production certificates were used depending on the domain. New certificates from Certification Authority '''CommisSign-2''' must be requested for iteration 2 by all DE4A partners.

@@ Line 96: / Line 96: @@
 ''This section only applies for those participants required to install a Connector instance.''
-Deploy the release version of the Connector from the [https://github.com/de4a-wp5/de4a/releases GitHub of WP5]. To do so, follow the DE4A [[Connector iteration 2 installation and configuration guide]].
+Deploy the release version of the Connector from the [https://github.com/de4a-wp5/de4a/releases GitHub of WP5]. To do so, follow the DE4A [[Connector iteration 2 installation and configuration guide|Installation and configuration guide of the DE4A Connector it2]].
 === Data Evaluator / Data Owner ===