Use the configuration dropins folder to specify server configuration

We can specify additional configuration files in the configDropins directory without specifying include elements in server.xml. Create directories...

    LIBERTY_HOME/usr/servers/server_name/configDropins/overrides
    LIBERTY_HOME/usr/servers/server_name/configDropins/defaults

Place the server configuration files in either configDropins/overrides or configDropins/defaults. Both directories are monitored for updates. When we add, remove, or update configuration files, the runtime configuration is updated dynamically.

Precedence:

  • The configuration specified in configDropins/overrides takes precedence over the configuration in the server.xml file. Configuration specified in server.xml file takes precedence over configuration specified in the configDropins/defaults directory.

  • Configuration from files in both the configDropins/defaults and configDropins/overrides directories take precedence over any default configuration specified by a feature.

  • The configuration files in the dropins directory are processed in alphabetical order. A later configuration overrides an earlier one. As an example, if configDropins/defaults contains a.xml, b.xml and c.xml, the configuration from c.xml takes precedence over b.xml, and b.xml takes precedence over a.xml.

To maintain consistency across platforms, file names are converted to lowercase before sorting alphabetically. This means that if two files are specified in the same dropins directory that have the same name except for case variations (such as extraConfig.xml and ExtraConfig.xml), the ordering behavior is indeterminate.

Optional: Turn off configuration monitoring.


Parent topic: Use include elements, variables, and Ref tags in configuration files