Setting up and configuring ID Builder

To set ID Builder up, please follow steps listed below.

Run an instance of ID Builder service.

Running instance for the first time will create an empty module database, with relevant tables.
Create Code Definitions, counters, counter definitions and code parts via the UI or Import an old MES Database via the UI.

Configuration of idbuilder/idb-service

Local helm variables

Variable Description Required Default

Variable	Description	Required	Default
`logging:microsoft`	The level of logging to be set for logs from microsoft libraries in all services.	No	WARN
`logging:system`	The level of logging to be set for logs from system libraries in all services.	No	WARN
`logging:dbmigration`	The level of logging to be set for logs from database entity framework migrations.	No	TRACE
`oidc:acl:refreshInterval`	How often the ACLs should be refreshed by the background service in seconds	NO	60
`oidc:introspection:enableCaching`	Whether or not caching should be enabled for results returned by the introspection endpoint.	NO	true
`oidc:introspection:cachingDuration`	How long introspection results should be cached (in seconds)	NO	30
`observability:otelAutoInjectEnvParams`	Whether or not to automatically inject OpenTelemetry environment variables into the application’s configuration.	No	false
`HostSettings__ShutdownTimeoutSeconds`	The maximum time in seconds the service will wait during graceful shutdown to complete ongoing operations before forcing exit.	No	30

logging:microsoft

The level of logging to be set for logs from microsoft libraries in all services.

WARN

logging:system

The level of logging to be set for logs from system libraries in all services.

WARN

logging:dbmigration

The level of logging to be set for logs from database entity framework migrations.

TRACE

oidc:acl:refreshInterval

How often the ACLs should be refreshed by the background service in seconds

oidc:introspection:enableCaching

Whether or not caching should be enabled for results returned by the introspection endpoint.

true

oidc:introspection:cachingDuration

How long introspection results should be cached (in seconds)

observability:otelAutoInjectEnvParams

Whether or not to automatically inject OpenTelemetry environment variables into the application’s configuration.

false

HostSettings__ShutdownTimeoutSeconds

The maximum time in seconds the service will wait during graceful shutdown to complete ongoing operations before forcing exit.

Global helm variables

Variable Description Required Default

Variable	Description	Required	Default
`secretKey`	It is used to encypt data (e.g. the connection string to the MES ID Builder database) and should be stored as a secret. It must have a length of 33 characters.	Yes	-

secretKey

It is used to encypt data (e.g. the connection string to the MES ID Builder database) and should be stored as a secret. It must have a length of 33 characters.

Yes