Chapter 9. Configuration

Table of Contents

Application
Logging

Application

The application server is configured using a standard java properties or YAML file.

A typical java properties file has the following general form;

# Comment
key1=value1
key2=value2

There are a number of possible keys which are described in a file ".../support/deployment/config.properties". Keys which are for HDS specifically are prefixed with "hds.". Keys which are for Spring Boot are prefixed with "spring.".

To avoid the HDS application server from failing to health check connectivity to a mail service you may wish to configure the configuration property "management.health.mail.enabled" to "false".

Logging

The application logging uses the SLF4J logging framework. This is backed by the Logback logging system. When formatting log lines, it is possible to add additional meta data from the application server. This is known as the "MDC". Presently supported;

KeyDescription
authUserNicknameThe nickname of the presently authenticated user
userAgentThe User-Agent HTTP header related to the current request
userAgentCodeThis is a short code to describe the user agent in brief