From 21f2b8f1298b120f13af10dc6fec0d905b6ba9ee Mon Sep 17 00:00:00 2001 From: Pau Espin Pedrol Date: Thu, 2 Nov 2017 17:57:58 +0100 Subject: OsmoGSMTester: Add state_dir section Change-Id: Ie12e3933747a4e698de59ff9ac57281e9f261d3d --- doc/manuals/chapters/config.adoc | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/doc/manuals/chapters/config.adoc b/doc/manuals/chapters/config.adoc index def9843..7e250e0 100644 --- a/doc/manuals/chapters/config.adoc +++ b/doc/manuals/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' -- cgit v1.2.3