aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPau Espin Pedrol <pespin@sysmocom.de>2017-11-02 17:57:58 +0100
committerHarald Welte <laforge@gnumonks.org>2017-11-29 11:54:40 +0000
commit5e67f555ac4df1ff3f8639890567bb4e0bdaa411 (patch)
tree9b190fc361270b3c1100f1781861220c19bfd0a7
parent808db8625ac2f145dec47af11220fe79fd4e6bcb (diff)
OsmoGSMTester: Add state_dir section
-rw-r--r--OsmoGSMTester/chapters/config.adoc22
1 files changed, 22 insertions, 0 deletions
diff --git a/OsmoGSMTester/chapters/config.adoc b/OsmoGSMTester/chapters/config.adoc
index def9843..7e250e0 100644
--- a/OsmoGSMTester/chapters/config.adoc
+++ b/OsmoGSMTester/chapters/config.adoc
@@ -54,10 +54,32 @@ suites_dir: '/usr/local/src/osmo-gsm-tester/suites'
scenarios_dir: './scenarios'
----
+[[state_dir]]
+==== 'state_dir'
+
+It contains global or system-wide state for osmo-gsm-tester. In a typical state
+dir you can find the following files:
+
+'last_used_msisdn.state'::
+ Contains last used msisdn number, which is automatically increased every
+ time osmo-gsm-tester needs to assign a new subscriber in a test.
+'lock'::
+ Lock file used to implement a mutual exclusion zone around the
+ 'reserved_resources.state' file.
+'reserved_resources.state'::
+ File containing a set of reserved resources by any number of
+ osmo-gsm-tester instances. Each osmo-gsm-tester instance is responsible
+ to clear its resources from the list once it is done using them and are
+ no longer reserved.
+
If you would like to set up several separate configurations (not typical), note
that the 'state_dir' is used to reserve resources, which only works when all
configurations that share resources also use the same 'state_dir'.
+This way, several concurrent users of osmo-gsm-tester (ie. several
+osmo-gsm-tester processes running in parallel) can run without interfering with
+each other (e.g. using same ARFCN, same IP or same ofono modem path).
+
[[suites_dir]]
==== 'suites_dir'