For distributed platforms

Specifying the Liberty configuration with dropins files by using developer tools

You can specify the server configuration for Liberty by creating configuration dropins files and placing these files in the configDropins directory.

About this task

You can use the dropins files to set a default configuration, or override configurations that are set in the server.xml file or included files. The server configuration validator includes configuration dropins files as part of the overall server configuration validation. The server configuration editor shows variables and references that are defined in dropins files in the appropriate content assistance and drop-down lists.

You can place configuration dropins files in either the ${server.config.dir}/configDropins/defaults directory or in the ${server.config.dir}/configDropins/overrides directory.

  • If you place these files in the defaults directory, then the configuration is applied before the server configuration. In this case, the files provide default values, which you can override in the main server.xml file or the included files.
  • If you place the configuration dropins files in the overrides directory, then the configuration is applied after the server configuration. In this case, the files override the main server.xml or included files.

For more information about configuration dropins files, see: Using the configuration dropins folder to specify server configuration.

Procedure

  1. To create a configuration dropins file, right-click your server in the Servers view.
  2. Complete one of the following options:
    1. To create a configuration dropins file in the defaults directory, select New > Configuration Dropins File > Defaults
    2. To create a configuration dropins file in the overrides directory, select New > Configuration Dropins File > Overrides.
  3. Enter the name of the file that you want to create.
  4. Click OK.

    The new file is displayed.

  5. To see the merged configuration, complete one of the following options:
    1. Right-click the server.xml file in the Enterprise Explorer or Project Explorer view, and then select Liberty > Open Merged View.
    2. In the Servers view, right-click on Server Configuration and select Open Merged View.

    The merged view of the server configuration shows the defaults at the beginning of the merged configuration. It also shows the overrides at the end of the merged configuration.