CORDA-2756 - Node configuration doc change (#5550)

* Added note to the node configuration docs regarding duplicate keys.

* Added explanation about override priority.

* Grammar change according to PR review.
This commit is contained in:
Stefan Iliev 2019-10-08 12:57:51 +01:00 committed by Anthony Keenan
parent efa01410ec
commit ca0c7e02ae

View File

@ -28,6 +28,11 @@ This prevents configuration errors when mixing keys containing ``.`` wrapped wit
``"dataSourceProperties.dataSourceClassName" = "val"`` in `Reference.conf`_ would be not overwritten by the property ``"dataSourceProperties.dataSourceClassName" = "val"`` in `Reference.conf`_ would be not overwritten by the property
``dataSourceProperties.dataSourceClassName = "val2"`` in *node.conf*. ``dataSourceProperties.dataSourceClassName = "val2"`` in *node.conf*.
.. warning:: If a property is defined twice the last one will take precedence. The library currently used for parsing HOCON
currently does not provide a way to catch duplicates when parsing files and will silently override values for the same key.
For example having ``key=initialValue`` defined first in node.conf and later on down the
lines ``key=overridingValue`` will result into the value being ``overridingValue``.
By default the node will fail to start in presence of unknown property keys. By default the node will fail to start in presence of unknown property keys.
To alter this behaviour, the ``on-unknown-config-keys`` command-line argument can be set to ``IGNORE`` (default is ``FAIL``). To alter this behaviour, the ``on-unknown-config-keys`` command-line argument can be set to ``IGNORE`` (default is ``FAIL``).
@ -46,6 +51,9 @@ JVM options
java -Dcorda.rpcSettings.ssl.keyStorePassword=mypassword -jar node.jar java -Dcorda.rpcSettings.ssl.keyStorePassword=mypassword -jar node.jar
.. note:: If the same field is overriden by both an environment variable and system property, the system property
takes precedence.
Configuration file fields Configuration file fields
------------------------- -------------------------