v2.0.2

[v2.0.2] - 2023-11-23

Overview

EDC 0 Bugfix Release.

Detailed Changes

Patch

• Fixed an issue with the healthcheck.

Deployment Migration Notes

No special migration steps required.

Compatible Versions

• Broker Backend Docker Image: ghcr.io/sovity/broker-server-ce:2.0.2
• Broker UI Docker Image: ghcr.io/sovity/edc-ui:2.1.0
• Sovity EDC CE: 6.0.0

v2.0.1

[v2.0.1] - 2023-11-17

Overview

EDC 0 Bugfix Release.

Detailed Changes

Patch

• Fixed an issue preventing DAPS roll-in with the broker-server-ce variant.

Deployment Migration Notes

Compatible Versions

• Broker Backend Docker Image: ghcr.io/sovity/broker-server-ce:2.0.1
• Broker UI Docker Image: ghcr.io/sovity/edc-ui:2.1.0
• Sovity EDC CE: 6.0.0

v2.0.0

[v2.0.0] - 2023-11-17

Overview

EDC 0 Release, some bugfixes.

Detailed Changes

Major

• Migrated to Eclipse EDC 0.2.1
• Migrated to edc-extensions 5.0.0
• Migrated Assets to JSON-LD

Minor

• New Filter: Organization Name
• Search now hits Organization Name

Patch

• Fixed some issues with DB Connections not released between tests.
• Fixed issue with initial sorting not being the first sorting.

Deployment Migration Notes

1. Connectors and Data Offers require an initial crawl before their metadata is filled again.
2. UI Migration Notes since the last Broker Release: https://github.com/sovity/edc-ui/releases/tag/v2.0.0
3. The Protocol Endpoint changed to https://[MY_EDC_FQDN]/backend/api/dsp, used to be https://[MY_EDC_FQDN]/backend/api/v1/ids.
4. The Management Endpoint changed to https://[MY_EDC_FQDN]/backend/api/management, used to be https://[MY_EDC_FQDN]/backend/api/v1/management.
5. The Connector Endpoint changed to https://[MY_EDC_FQDN]/backend/api/dsp, used to be https://[MY_EDC_FQDN]/backend/api/v1/ids/data.

Compatible Versions

• Broker Backend Docker Image: ghcr.io/sovity/broker-server-ce:2.0.0
• Broker UI Docker Image: ghcr.io/sovity/edc-ui:2.1.0
• Sovity EDC CE: 6.0.0

v1.2.0

Overview

Adapt to requirements of the Authority Portal - Release v2.0.0.

Detailed Changes

Minor

• Added an endpoint for getting the data offer amounts for connectors.
• Added a Connector filter to the Catalog Page.

Deployment Migration Notes

Compatible Versions

• Broker Backend Docker Image: ghcr.io/sovity/broker-server-ce:1.2.0
• Broker UI Docker Image: ghcr.io/sovity/edc-ui:0.0.1-milestone-8-sovity13
• Sovity EDC CE: 4.2.0

v1.1.1

[v1.1.1] - 2023-10-11

Overview

Bugfix release for the asset properties issue.

Detailed Changes

Patch

• Fixed a bug causing some string asset properties getting quotes around them.

Deployment Migration Notes

Compatible Versions

• Broker Backend Docker Image: ghcr.io/sovity/broker-server-ce:1.1.1
• Broker UI Docker Image: ghcr.io/sovity/edc-ui:0.0.1-milestone-8-sovity13
• Sovity EDC CE: 4.2.0

v1.1.0

[v1.1.0] - 2023-09-29

Overview

Bugfix release for the asset proprties issue. Also contains the connector delete endpoint.

Detailed Changes

Minor

• New Admin API Endpoint: Delete Connectors

Patch

• Fixed a bug causing exceptions when non-string asset properties were used.

Deployment Migration Notes

1. Connectors can now be dynamically deleted at runtime by using the following endpoint:

   # Response should be 204 No Content
   curl --request DELETE \
       --url 'http://localhost:11002/backend/api/v1/management/wrapper/broker/connectors?adminApiKey=DefaultBrokerServerAdminApiKey' \
       --header 'Content-Type: application/json' \
       --header 'X-Api-Key: ApiKeyDefaultValue' \
       --data '["https://some-connector-to-delete/api/v1/ids/data", "https://some-other-connector-to-delete/api/v1/ids/data"]'

Compatible Versions

• Broker Backend Docker Image: ghcr.io/sovity/broker-server-ce:1.1.0
• Broker UI Docker Image: ghcr.io/sovity/edc-ui:0.0.1-milestone-8-sovity13
• Sovity EDC CE: 4.2.0

v1.0.3

[v1.0.3] - 2023-09-01

Overview

Bugfix Release for the Broker MvP with MS8 (MDS 1.2).

Detailed Changes

Patch

• Fixed sorting the catalog by popularity.

Deployment Migration Notes

No configuration changes are required.

Compatible Versions

• Broker Backend Docker Image: ghcr.io/sovity/broker-server-ce:1.0.3
• Broker UI Docker Image: ghcr.io/sovity/edc-ui:0.0.1-milestone-8-sovity13
• Sovity EDC CE: 4.2.0

v1.0.2

[v1.0.2] - 2023-08-10

Overview

Bugfix Release for the Broker MvP with MS8.

Detailed Changes

Patch

• Fixed an issue where connector crawling failed when data offer limits were exceeded.
• Fixed searching data offers with capital letters didn't work.

Deployment Migration Notes

No configuration changes are required.

Compatible Versions

• Broker Backend Docker Image: ghcr.io/sovity/broker-server-ce:1.0.2
• Broker UI Docker Image: ghcr.io/sovity/edc-ui:0.0.1-milestone-8-sovity12
• Sovity EDC CE: 4.1.0

v1.0.1 Broker MvP Bugfix / Feature Release

[v1.0.1] Broker MvP Bugfix / Feature Release - 2023-07-12

Overview

Bugfix / Feature Release for the Broker MvP with MS8: Connectors can now be added at runtime.

Detailed Changes

Major

• Broker Server API now generates into its own Broker Server Client Typescript Library.

Minor

• Broker Server API is now part of this repository.
• Dead Connectors are now deleted periodically.
• Connector Online Status is now visualized.

Patch

• Fixed Backend Docker Healthcheck

Deployment Migration Notes

1. Added new required configuration properties:

   # Broker Server Admin Api Key (required)                                            
   # This is a stopgap until we have IAM
   EDC_BROKER_SERVER_ADMIN_API_KEY: DefaultBrokerServerAdminApiKey

2. Added new optional configuration properties:

   # CRON interval for crawling ONLINE connectors
   EDC_BROKER_SERVER_CRON_ONLINE_CONNECTOR_REFRESH: "*/20 * * ? * *" # every 20s
   
   # CRON interval for crawling OFFLINE connectors
   EDC_BROKER_SERVER_CRON_OFFLINE_CONNECTOR_REFRESH: "0 */5 * ? * *" # every 5 minutes
   
   # CRON interval for crawling DEAD connectors
   EDC_BROKER_SERVER_CRON_DEAD_CONNECTOR_REFRESH: "0 0 * ? * *" # every hour
   
   # CRON interval for marking connectors as DEAD
   EDC_BROKER_SERVER_SCHEDULED_KILL_OFFLINE_CONNECTORS: "0 0 2 ? * *" # every day at 2am
   
   # Delete data offers / mark as dead after connector has been offline for:
   EDC_BROKER_SERVER_KILL_OFFLINE_CONNECTORS_AFTER: "P5D"
   
   # Hide data offers after connector has been offline for:
   EDC_BROKER_SERVER_HIDE_OFFLINE_DATA_OFFERS_AFTER: "P1D"

3. Removed optional configuration properties:

   # (Removed) CRON interval for crawling connectors
   EDC_BROKER_SERVER_CRON_CONNECTOR_REFRESH: "0 */5 * ? * *"

4. Connectors can now be dynamically added at runtime by using the following endpoint:

   # Response should be 204 No Content
   curl --request PUT \
       --url 'http://localhost:11002/backend/api/v1/management/wrapper/broker/connectors?adminApiKey=DefaultBrokerServerAdminApiKey' \
       --header 'Content-Type: application/json' \
       --header 'X-Api-Key: ApiKeyDefaultValue' \
       --data '["https://some-new-connector/api/v1/ids/data", "https://some-other-new-connector/api/v1/ids/data"]'

Compatible Versions

• Broker Backend Docker Image: ghcr.io/sovity/broker-server-ce:1.0.1
• Broker UI Docker Image: ghcr.io/sovity/edc-ui:0.0.1-milestone-8-sovity12
• Sovity EDC CE: 4.0.1

[v1.0.0]

Release was deleted in favor of above release. There was a bug, and we just decided to re-do the release.

v0.1.0 MvP with MS8

[v0.1.0] Broker MvP Release - 2023-06-23

Overview

Broker MvP using Core EDC MS8.

Detailed Changes

Minor

• Implemented Catalog Page Filters:
  • Data Space Filter
  • Data Category
  • Data Subcategory
  • Data Model
  • Transport Mode
  • Geo Reference Method
• Implemented Catalog Page Sorting:
  • Most Recent
  • By Title
  • By Connector
• Implemented Catalog Page Pagination.

Patch

• Fix: Data Offer Filter available values are no longer limited to the selected value if a value is selected.
• Fix: Missing file system vault prevented data space login.
• Fix: Parallel crawling was not actually parallel

Deployment Migration Notes

1. There are new required configuration properties:

   # List of Data Space Names for special Connectors (default: '')
   EDC_BROKER_SERVER_KNOWN_DATASPACE_CONNECTORS: "Mobilithek=https://some-connector/ids/data,OtherDataspace=https://some-other-connector/ids/data"

2. There are new optional configuration properties available for overriding:

   # Parallelization for Crawling (default: 3)
   EDC_BROKER_SERVER_NUM_THREADS: 16
   
   # Default Data Space Name (default: MDS)
   EDC_BROKER_SERVER_DEFAULT_DATASPACE: MDS
   
   # Maximum number of Data Offers per Connector (default: 50)
   EDC_BROKER_SERVER_MAX_DATA_OFFERS_PER_CONNECTOR: 50
   
   # Maximum number of Contract Offers per Data Offer (default: 10)
   EDC_BROKER_SERVER_MAX_CONTRACT_OFFERS_PER_DATA_OFFER: 10
   
   # Pagination Configuration: Catalog Page Size (default: 20)
   EDC_BROKER_SERVER_CATALOG_PAGE_PAGE_SIZE: 20

3. An issue prevented the keystore file from being read, preventing a successful data space log in.
4. Added a reference to connector/.env as source for other possible broker server configuration
   options, that have defaults, but might have use cases for overriding.

Compatible Versions

• Broker Backend Docker Image: ghcr.io/sovity/broker-server-ce:0.1.0
• Broker UI Docker Image: ghcr.io/sovity/edc-ui:0.0.1-milestone-8-sovity8
• Sovity EDC CE: 3.3.0