fixeria has uploaded this change for review.

View Change

doc/manuals: add a NOTE on ERL_FLAGS="-config ..."

Change-Id: I4052aed0bbb2fab1b0cf6bad6b8d513830183d56
Related: osmo-ttcn3-hacks.git Ibf4d0d068ca2f12f4d04dd696e6eaa46f67c2e0b
Related: OS#6671
---
M doc/manuals/chapters/running.adoc
1 file changed, 13 insertions(+), 0 deletions(-)

git pull ssh://gerrit.osmocom.org:29418/erlang/osmo-s1gw refs/changes/42/44042/1
diff --git a/doc/manuals/chapters/running.adoc b/doc/manuals/chapters/running.adoc
index 32981fa..6d711bb 100644
--- a/doc/manuals/chapters/running.adoc
+++ b/doc/manuals/chapters/running.adoc
@@ -144,6 +144,19 @@
Start with an interactive Erlang shell instead of running headless.
Useful for debugging on a deployed system.

+[NOTE]
+====
+Do not supply a configuration file via `ERL_FLAGS="-config ..."`.
+Earlier OsmoS1GW versions (0.3.x and older) were packaged as an Erlang
+escript, where that `ERL_FLAGS` file was the sole configuration source.
+Since 0.4.0 OsmoS1GW ships as a full OTP release with a bootstrap script
+that always loads a base `-config` (the `-c` file, or the default), so
+an `ERL_FLAGS` `-config` no longer stands alone: it is *merged on top of*
+that base, per individual application parameter rather than wholesale.
+Any parameter not restated in the `ERL_FLAGS` file keeps the value from
+the base file, which can silently mix two configurations.
+====
+
[[running_systemd]]
==== Running Under systemd


To view, visit change 44042. To unsubscribe, or for help writing mail filters, visit settings.

Gerrit-MessageType: newchange
Gerrit-Project: erlang/osmo-s1gw
Gerrit-Branch: master
Gerrit-Change-Id: I4052aed0bbb2fab1b0cf6bad6b8d513830183d56
Gerrit-Change-Number: 44042
Gerrit-PatchSet: 1
Gerrit-Owner: fixeria <vyanitskiy@sysmocom.de>