Integration Daemon Services Section¶

This section is only relevant when configuring an integration daemon.

The Integration Daemon Services are configured with a list of integration group names. Each integration group name identifies an integration group stored in the open metadata repositories. Linked from the integration group are definitions of the integration connectors that are part of the group. When an integration daemon is configured with the name of the integration group, it reads the definition of the integration group from the open metadata repositories and runs the connectors that are part of the group.

The integration daemon constantly monitors the integration groups, adjusting the running integration connectors as the definitions change. The integration daemon also monitors the running integration connectors themselves, restarting them if they fail or if their configuration changes. This ensures that the integration daemon is always running the latest and most up-to-date integration connectors.

Configuring integration groups

Configure integration groups¶

An integration group identifies a list of integration connectors that an integration daemon should run. These integration connectors are defined and maintained as open metadata elements stored in the open metadata repositories. Changes can be made to these integration connectors at any time using the Governance Server OMAS. The integration daemon is monitoring for changes and updates the integration connectors it is running in line with the changes it discovers. This approach allows changes to be made to the integration daemon's configuration without needing access to the administration commands, nor a restart of the integration daemon.

Configure an integration group¶

Each integration group is configured with the network location of a metadata access server running the appropriate Open Metadata Access Services (OMASs) along with the qualified name of the IntegrationGroup open metadata entity that represents the integration group.

POST - configure an integration group

{{platformURLRoot}}/open-metadata/admin-services/servers/{{serverName}}/integration-groups/configuration

With a request body like the following:

{
  "class": "IntegrationGroupConfig",
  "omagserverPlatformRootURL": "{MDServerURLRoot}",
  "omagserverName": "{MDServerName}",
  "integrationGroupQualifiedName": {qualifiedName}
}

Configure all integration groups in one command¶

POST - configure all integration groups

{{platformURLRoot}}/open-metadata/admin-services/servers/{{serverName}}/integration-groups/configuration/all

With a request body like the following:

[
  {
    "class": "IntegrationGroupConfig",
    "omagserverPlatformRootURL": "{MDServerURLRoot}",
    "omagserverName": "{MDServerName}",
    "integrationGroupQualifiedName": {qualifiedName}
  },
  {
    "class": "IntegrationGroupConfig",
    "omagserverPlatformRootURL": "{MDServerURLRoot}",
    "omagserverName": "{MDServerName}",
    "integrationGroupQualifiedName": {qualifiedName}
  },
]

Retrieve configured integration groups¶

GET - all configured integration groups

{{platformURLRoot}}/open-metadata/admin-services/servers/{{serverName}}/integration-groups/configuration

Remove all configured integration groups¶

DELETE - all configured integration groups

{{platformURLRoot}}/open-metadata/admin-services/servers/{{serverName}}/integration-groups

Remove a specific configured integration group¶

DELETE - a configured integration group

{{platformURLRoot}}/open-metadata/admin-services/servers/{{serverName}}/integration-groups/{{qualifiedName}}

Raise an issue or comment below