[karaf] branch karaf-4.3.x updated: Add note about possible use of env variables.

[jb...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

jbonofre pushed a commit to branch karaf-4.3.x
in repository https://gitbox.apache.org/repos/asf/karaf.git


The following commit(s) were added to refs/heads/karaf-4.3.x by this push:
     new d0cbe2805a Add note about possible use of env variables.
d0cbe2805a is described below

commit d0cbe2805a00efc99d3f92f63c42ae51cd5b1d64
Author: Łukasz Dywicki <lu...@code-house.org>
AuthorDate: Thu Oct 13 21:59:29 2022 +0200

    Add note about possible use of env variables.
    
    Signed-off-by: Łukasz Dywicki <lu...@code-house.org>
    
    (cherry picked from commit 16bd2791a0fdb686a808da26556d50b16667120d)
---
 manual/src/main/asciidoc/user-guide/configuration.adoc | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/manual/src/main/asciidoc/user-guide/configuration.adoc b/manual/src/main/asciidoc/user-guide/configuration.adoc
index 30505cd03d..7143c8168e 100644
--- a/manual/src/main/asciidoc/user-guide/configuration.adoc
+++ b/manual/src/main/asciidoc/user-guide/configuration.adoc
@@ -38,6 +38,13 @@ export ORG_APACHE_KARAF_SHELL_SSHPORT=8102
 
 You can override any configuration property using this mechanism.
 
+[NOTE]
+====
+Please note that making this functionality requires OSGi configuration object to exist and have properties defined.
+It is not possible to override non-existing properties or create new entries in configuration based on environment variable.
+====
+
+
 It's possible to "append" a new value based on the content of a configuration property.
 For instance, you want to add a new features repository to the default value (define the `etc/org.apache.karaf.features.cfg` config file `featuresRepositories` property.
 You can use the following env variable: