From 06c82aee5ce007a2c5ba12cd59d3db158c593ee8 Mon Sep 17 00:00:00 2001 From: Pau Espin Pedrol Date: Thu, 7 May 2020 18:15:53 +0200 Subject: Deprecate envvar OSMO_GSM_TESTER_CONF and remove other ones Environment variable OSMO_GSM_TESTER_CONF is marked as deprecated and an error is logged each time it's used. Same feature is available through "-c" command line parameters, so having the envvar only makes things more complex for no good reason. It cannot yet be completely dropped since some environemnt still make use of it. Give some time to users to adapt their setups. Other environment variables setting some config apths can be dropped since they are not being really used in any setup. Change-Id: I7eb69f870d0dcb5906d45ae067d6bed1aabf5862 --- doc/examples/2g_osmocom/README.md | 22 ++++++++++++++++++++++ doc/examples/2g_osmocom/README.txt | 30 ------------------------------ doc/examples/4g_srsLTE/README.md | 22 ++++++++++++++++++++++ doc/examples/4g_srsLTE/README.txt | 30 ------------------------------ doc/manuals/chapters/config.adoc | 5 +++-- 5 files changed, 47 insertions(+), 62 deletions(-) create mode 100644 doc/examples/2g_osmocom/README.md delete mode 100644 doc/examples/2g_osmocom/README.txt create mode 100644 doc/examples/4g_srsLTE/README.md delete mode 100644 doc/examples/4g_srsLTE/README.txt (limited to 'doc') diff --git a/doc/examples/2g_osmocom/README.md b/doc/examples/2g_osmocom/README.md new file mode 100644 index 0000000..47b0737 --- /dev/null +++ b/doc/examples/2g_osmocom/README.md @@ -0,0 +1,22 @@ +This a sample 2G test suite configured and ready to use. +The only thing missing is a trial dir containing binaries. + +You can point osmo-gsm-tester.py at this config using the '-c $DIR' command line +argument, where DIR is the directory path where this README file resides. + +If you have your trial with binary tar archives in ~/my_trial +you can run the suite for example like this: +``` +osmo-gsm-tester.py -c $DIR ~/my_trial +``` + +Alternatively you can setup this example as default config for your user by +doing something like: +``` +mkdir -p ~/.config +ln -s "$DIR" ~/.config/osmo-gsm-tester +``` + +A ./state dir will be created to store the current osmo-gsm-tester state. If +you prefer not to write to $DIR, set up an own configuration pointing at a +different path (see paths.conf: 'state_dir'). diff --git a/doc/examples/2g_osmocom/README.txt b/doc/examples/2g_osmocom/README.txt deleted file mode 100644 index 4c869ca..0000000 --- a/doc/examples/2g_osmocom/README.txt +++ /dev/null @@ -1,30 +0,0 @@ -This a sample gsm test suite configured and ready to use. -The only thing missing is a trial dir containing binaries. - -You can point osmo-gsm-tester.py at this config using the OSMO_GSM_TESTER_CONF -environment variable: - - export OSMO_GSM_TESTER_CONF="$PWD" - -When there is no OSMO_GSM_TESTER_CONF set, osmo-gsm-tester will instead look -for conf files in several locations like ~/.config/osmo-gsm-tester, -/usr/local/etc/osmo-gsm-tester, /etc/osmo-gsm-tester. - -If you have your trial with binary tar archives in ~/my_trial -you can run the suite for example like this: - - osmo-gsm-tester.py ~/my_trial - -Specifically, from this dir: - - OSMO_GSM_TESTER_CONF="$PWD" ../src/osmo-gsm-tester.py ~/my_trial - -Alternatively you can setup this example as permanent config using something -like: - - mkdir -p ~/.config - ln -s "$PWD" ~/.config/osmo-gsm-tester - -A ./state dir will be created to store the current osmo-gsm-tester state. If -you prefer not to write to $PWD, set up an own configuration pointing at a -different path (see paths.conf: 'state_dir'). diff --git a/doc/examples/4g_srsLTE/README.md b/doc/examples/4g_srsLTE/README.md new file mode 100644 index 0000000..b577035 --- /dev/null +++ b/doc/examples/4g_srsLTE/README.md @@ -0,0 +1,22 @@ +This a sample 4G test suite configured and ready to use srsLTE stack. +The only thing missing is a trial dir containing binaries. + +You can point osmo-gsm-tester.py at this config using the '-c $DIR' command line +argument, where DIR is the directory path where this README file resides. + +If you have your trial with binary tar archives in ~/my_trial +you can run the suite for example like this: +``` +osmo-gsm-tester.py -c $DIR ~/my_trial +``` + +Alternatively you can setup this example as default config for your user by +doing something like: +``` +mkdir -p ~/.config +ln -s "$DIR" ~/.config/osmo-gsm-tester +``` + +A ./state dir will be created to store the current osmo-gsm-tester state. If +you prefer not to write to $DIR, set up an own configuration pointing at a +different path (see paths.conf: 'state_dir'). diff --git a/doc/examples/4g_srsLTE/README.txt b/doc/examples/4g_srsLTE/README.txt deleted file mode 100644 index 6840801..0000000 --- a/doc/examples/4g_srsLTE/README.txt +++ /dev/null @@ -1,30 +0,0 @@ -This a sample 4G test suite configured and ready to use srsLTE stack. -The only thing missing is a trial dir containing binaries. - -You can point osmo-gsm-tester.py at this config using the OSMO_GSM_TESTER_CONF -environment variable: - - export OSMO_GSM_TESTER_CONF="$PWD" - -When there is no OSMO_GSM_TESTER_CONF set, osmo-gsm-tester will instead look -for conf files in several locations like ~/.config/osmo-gsm-tester, -/usr/local/etc/osmo-gsm-tester, /etc/osmo-gsm-tester. - -If you have your trial with binary tar archives in ~/my_trial -you can run the suite for example like this: - - osmo-gsm-tester.py ~/my_trial - -Specifically, from this dir: - - OSMO_GSM_TESTER_CONF="$PWD" ../../src/osmo-gsm-tester.py ~/my_trial - -Alternatively you can setup this example as permanent config using something -like: - - mkdir -p ~/.config - ln -s "$PWD" ~/.config/osmo-gsm-tester - -A ./state dir will be created to store the current osmo-gsm-tester state. If -you prefer not to write to $PWD, set up an own configuration pointing at a -different path (see paths.conf: 'state_dir'). diff --git a/doc/manuals/chapters/config.adoc b/doc/manuals/chapters/config.adoc index 483fd8c..3f4bde1 100644 --- a/doc/manuals/chapters/config.adoc +++ b/doc/manuals/chapters/config.adoc @@ -185,12 +185,13 @@ This schema is used by <> and <