How do I view the merged Liberty server configuration after includes and configDropins are combined with the original server.xml?

Question

QUESTION

How can I see the "merged" server.xml that the runtime sees after all relevant config is combined according to Liberty precedence rules?

Background

My project's server.xml has a number of includes and potentially some configDropins files adding to the original server.xml, with build logic copying different sources into place.

server.xml with includes

<server>
    <include location="dev.xml" optional="true"/>
    <include location="common.xml" />
    <!-- ... -->
</server>

configDropins

/target/liberty/wlp/usr/servers/defaultServer/server.xml
/target/liberty/wlp/usr/servers/defaultServer/configDropins/defaults/quick-start-security.xml
/target/liberty/wlp/usr/servers/defaultServer/configDropins/overrides/liberty-plugin-variable-config.xml

Example

E.g. take a config element like applicationMonitor.

<applicationMonitor dropinsEnabled="false" updateTrigger="mbean"/>

If this element appears more than once across the various config files with different attribute values in each, how can I see the final "merged" value?

Scott Kurz · Accepted Answer · 2023-06-13T19:09:12.280

SOLUTION

Use the config REST endpoint provided by the Liberty restConnector-2.0 feature.

STEPS

Configure the restConnector-2.0 feature.

<server description="my server">
    <featureManager>
        <feature>restConnector-2.0</feature>
    </featureManager>
</server>

Configure administrator access

<server description="my server">
  
  <quickStartSecurity userName="bob" userPassword="bobpassword" />

  <keyStore id="defaultKeyStore" password="keystorePassword"/>

</server description="my server">

Start the server and access the https://<host>:<port>/ibm/api/config endpoint, e.g.: https://localhost:9443/ibm/api/config and login with the configured user:password = bob:bobpassword.
Look at the JSON response, e.g. for applicationMonitor something like:

   {
      "configElementName": "applicationMonitor",
      "dropins": "dropins",
      "dropinsEnabled": false,
      "pollingRate": 500,
      "updateTrigger": "mbean"
   },

More Options

See the restConnector-2.0 feature documentation for additional options.