Configuration Documents¶

A configuration document provides the configuration properties for a single OMAG Server. It defines which subsystems are activated in the server and which connector implementations it should use.

Configuration document structure¶

An OMAG Server's configuration document is structured into elements that each describe the configuration properties for each of its desired capabilities.

Structure of the configuration document

The sections are as follows:

Default values to use when creating other configuration elements. These values need to be set up first.
Basic properties of any OMAG Server.
Specific subsystem configurations that provide the key capabilities for different types of OMAG Servers.
Audit trail that documents the changes that have been made to the configuration document.

It is possible to retrieve the configuration document for a server using the following command:

GET - retrieve configuration document for a server

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

When the server is running, the following command returns the configuration document that was used to start it (since it may have changed in the configuration document store since the server was started):

GET - retrieve configuration document used to start a server

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

Default values¶

At the top of the configuration document are:

Local server URL root, which defines the root of the network address for the OMAG Server Platform where the OMAG Server will run.
Event bus config, which provides the configuration of the event bus (Apache Kafka or similar) where all the event topics that the server will use are located.

Both of these elements provide default values for other configuration elements.

If they are changed, their new values do not affect existing definitions in the configuration document.

Basic properties¶

The basic properties of the OMAG Server are used in logging, events handing and security. They help to document the purpose of the server (which helps with problem determination) and enable performance improvements by allowing the server to ignore activity or metadata that is not relevant to its operation.

Find more information on configuring each through the sub-sections of the configuring an OMAG Server portion of the administration guide.

Specific subsystem configurations¶

Different types of servers can be configured with other specific subsystems, such as a local metadata repository, registering with a cohort, configuring access services or others.

Since these vary depending on the type of OMAG Server, find more details in the sub-sections under the configuring an OMAG Server portion of the administration guide.

Audit trail¶

The audit trail allows you to keep track of changes to the configuration document. This is helpful to audit what any recent changes might have been - particularly if a working server suddenly stops working - the first question is always, "what has changed recently?"

It also acts as a nice summary of how the server has been configured.

Example of an audit trail

{
 "auditTrail" : [
    "Thu Jan 30 22:37:12 GMT 2020 garygeeke updated configuration for local server's URL root to https://localhost:9444.",
    "Thu Jan 30 22:37:12 GMT 2020 garygeeke updated configuration for maximum page size to 100.",
    "Thu Jan 30 22:37:12 GMT 2020 garygeeke updated configuration for local server type name to Open Metadata Server.",
    "Thu Jan 30 22:37:12 GMT 2020 garygeeke updated configuration for local server's owning organization's name to Coco Pharmaceuticals.",
    "Thu Jan 30 22:37:12 GMT 2020 garygeeke updated configuration for local server's userId to cocoMDS1npa.",
    "Thu Jan 30 22:37:12 GMT 2020 garygeeke updated configuration for local server's password to cocoMDS1passw0rd.",
    "Thu Jan 30 22:37:12 GMT 2020 garygeeke added configuration for an Open Metadata Server Security Connector",
    "Thu Jan 30 22:37:12 GMT 2020 garygeeke updated configuration for default event bus.",
    "Thu Jan 30 22:37:12 GMT 2020 garygeeke updated configuration for the local repository.",
    "Thu Jan 30 22:37:12 GMT 2020 garygeeke updated configuration for the local repository.",
    "Thu Jan 30 22:37:12 GMT 2020 garygeeke preserving local metadata collection id bfdfdc61-01bb-4564-9c29-6b81c0fb79f8.",
    "Thu Jan 30 22:37:12 GMT 2020 garygeeke updated configuration for cohort cocoCohort.",
    "Thu Jan 30 22:37:12 GMT 2020 garygeeke updated configuration for access services.",
    "Thu Jan 30 22:37:12 GMT 2020 garygeeke updated configuration for enterprise repository services (used by access services).",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for access services.",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for enterprise repository services (used by access services).",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for access services.",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for enterprise repository services (used by access services).",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for access services.",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for enterprise repository services (used by access services).",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for access services.",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for enterprise repository services (used by access services).",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for access services.",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for enterprise repository services (used by access services).",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for access services.",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for enterprise repository services (used by access services).",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for access services.",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for enterprise repository services (used by access services).",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for access services.",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for enterprise repository services (used by access services).",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for access services.",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for enterprise repository services (used by access services).",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for access services.",
    "Thu Jan 30 22:37:13 GMT 2020 garygeeke updated configuration for enterprise repository services (used by access services).",
    "Thu Jan 30 22:44:10 GMT 2020 garygeeke deployed configuration for server."
 ]
}

Storage¶

The configuration document-store-connector manages the storage of the configuration documents.

Further information

Configuring an OMAG Server provides more detail on the process of creating a configuration document for various types of OMAG Servers.

Raise an issue or comment below