Configuring an OMAG Server

An OMAG Server is a configured set of services and connectors that support the integration of a particular type of technology.

There are different types of OMAG Server for each type of technology. Each are configured separately and then linked together to form a connected ecosystem.

Figure 1 shows the different types of OMAG Servers. The hierarchy in the diagram groups these servers according to their role in the ecosystem.

Figure 1

Figure 1: The different types of OMAG Servers organized into a hierarchy that shows the types of roles they perform and how they integrate together

The way to understand the diagram is that the arrows should be read as IS A. For example, the Repository Proxy IS A Cohort Member and the Cohort Member IS A OMAG Server. This means that everything documented about a particular type of server is also true for all server types that point to it through the IS A arrow, all of the way down the hierarchy.

Object-oriented software engineers would know of this type of relationship as behavior inheritance.

The configuration document for the OMAG Server determines which OMAG subsystems (and hence the types of open metadata and governance services) that should be activated in the OMAG Server. For example:

Each of the configuration commands builds up sections in the configuration document. This document is stored in the configuration store after each configuration request so it is immediately available for use each time the open metadata services are activated in the OMAG Server.

Many of the configuration values are connections to allow the server to create the connectors to the resources it needs.

Figure 2 shows the different types of connectors and the OMAG Servers that use them. The integration daemons each have their own type of connectors and so they are shown as a group.

Figure 2

Figure 2: the connector types supported by the OMAG Servers

These connectors enable Egeria to run in different container types, or deployment environments and to connect to different third party technology.

In the descriptions of the configuration commands, there are placeholders for the specific configuration values. They are names of the value in double curly braces. For example:

Below are the links to the configuration tasks for each type of server.

Advanced Configuration Topics

Querying the contents of a configuration document

It is possible to query the configuration document for a specific OMAG server using the following command.

GET {platformURLRoot}/open-metadata/admin-services/users/{adminUserId}/servers/{serverName}/configuration

It is also possible to query the origin of the server supporting the open metadata services. For the Egeria OMAG Server Platform, the response is “Egeria OMAG Server Platform (version 3.3-SNAPSHOT)”.

GET {platformURLRoot}/open-metadata/platform-services/users/{adminUserId}/servers/{serverName}/server-platform-origin

License: CC BY 4.0, Copyright Contributors to the ODPi Egeria project.