aboutsummaryrefslogtreecommitdiffstats
path: root/doc
AgeCommit message (Collapse)AuthorFilesLines
2020-11-11resource: Support waiting for reserved resources until availablePau Espin Pedrol1-0/+1
Before this patch, almost everything was in place to support concurrent osmo-gsm-tester instances sharing a common state dir. However, during resource reservation, if the reservation couldn't be done due to too many resources being in use, osmo-gsm-tester would fail and skip the test suite. With this patch, OGT will wait until some reserved resources are released and then try requesting the reservation again. Change-Id: I938602ee890712fda82fd3f812d8edb1bcd05e08
2020-06-16doc/manuals: Fix callout definition in code blockPau Espin Pedrol1-4/+4
Currently osmo-gsm-tester master jenkins build fails while building manual due to errors like: "asciidoc: WARNING: test_api.adoc: line 42: no callouts refer to list item 1" According to asciidoc documentation in [1], code examples can be annotated with callouts, but callouts need to be put inside source code comments. [1] http://www.methods.co.nz/asciidoc/chunked/ch20.html Change-Id: I2213874592342b12adf7440b25edc706abfc78ba
2020-06-15Implement per-test timeout guardPau Espin Pedrol1-0/+11
Timeout value can be specified by test in suite.conf: config: suite: <suite_name>: <test_name>: timeout: 2 # 2 seconds timeout Change-Id: I522f51f77f8be64ebfdb5d5e07ba92baf82d7706
2020-06-12Remove all references to defaults: timeout: from suite.confPau Espin Pedrol2-8/+0
This feature is not really implemented and maybe never was. In any case, it makes sense to have that working per-test so we can specify different values per test in case it's needed. Change-Id: I3c1b95c10e974da87ec9abd25578d8bcc0bc55a3
2020-06-10tests: Replace is_connected() with is_registered()Pau Espin Pedrol4-5/+5
API was renamed and old name deprecated, let's use it everywhere. Change-Id: Ic91dddcfd1a5a17c35d15a8a14628b3923229523
2020-06-10doc/manual: Fix links to nonexistent sectionsPau Espin Pedrol2-7/+7
Change-Id: I8742fa9c41d3ab95d41e299179df19c3d1e0a65b
2020-06-04doc: manual: Write initial Test API sectionPau Espin Pedrol1-2/+105
Change-Id: I86bc9a8a0b5ff50e72c21a4bd8a857830bd84c4c
2020-05-28ms_{srs,amarisoft}: Reuse run_node to hold run infoPau Espin Pedrol1-4/+10
Change-Id: Ifdea48fed0bfc152131c53b87c34b4514c632917
2020-05-28enb: Reuse run_node to hold run infoPau Espin Pedrol1-4/+10
Change-Id: If396940f154813d42ff3d3364c44b8979179127f
2020-05-28Support identifying different tgz files based on run_label attributePau Espin Pedrol1-1/+13
tgz files in trials can be categorized in subdirectories, allowing to select different bianry files at runtime based on the target run node which is going to run them. This way for instance one can have a binary linked against libs for eg. CentOS under run_label "centos/" or an ARM target under "arm", and then use "run_label: arm" on the resource using it. Change-Id: Iaf2e97da3aff693395f44f0e93b184d4846cf6da
2020-05-254g: Pass max bitrate to iperf3Pau Espin Pedrol2-4/+6
Otherwise bitrate 0 (unlimited) does weird stuff, like iperf3 hanging forever in DL. Change-Id: I631243cce132923d9024f8161cf96161c51cdae5
2020-05-25iperf3: Support runing test with bidirectional dataPau Espin Pedrol2-2/+2
Change-Id: Ia6f12c65fd3ea26d412997741cb8685a9646af43
2020-05-25config: suites_dir and scenarios_dir are now a list of pathsPau Espin Pedrol3-8/+14
This allows inheriting suites or scenarios from eg. sysmocom/ dir, while still allowing to apply new suites and scenarios on top. Change-Id: Icecdae32d400a6b6da2ebf167c1c795f7a74ae96
2020-05-22iperf3: Support using configuring UDP protocolPau Espin Pedrol2-24/+6
Change-Id: I0b3545847b01ae3d029881f243fea276f0fa39de
2020-05-12config: Allow setting trial directory in main.confPau Espin Pedrol1-0/+2
Change-Id: Ia4141001d084f690897dbdff5eae6c69ff2e521c
2020-05-12doc/manuals: Swap order of schemas and config filesPau Espin Pedrol1-211/+211
First explain the different config files and directories, later describe the schemas used in each of them. Change-Id: Iaf31808a655a5c77a1dfaa155e86d42585130820
2020-05-12Cmdline arg -c sets main configuration file (old paths.conf) instead of dir ↵Pau Espin Pedrol7-79/+137
containing it It has been notified that current configuration system is difficult to understand and to use, so it has been envisioned to refactor it a bit. The idea is that the user passes a -c path/to/main.conf file, which in turn contains whatever osmo-gsm-tester main settings supports (basically what old paths.conf used to be, plus some files harcoded to the same -c directory are now configurable through the main configuration file). Change-Id: Ieca65b71b543c44cfcec8e83efd0fe053c432e55
2020-05-07Deprecate envvar OSMO_GSM_TESTER_CONF and remove other onesPau Espin Pedrol5-62/+47
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
2020-05-07Allow suites to dynamically register schemas so tests can receive parametersPau Espin Pedrol1-4/+51
Change-Id: Idbe99a35993d193cd97059feb980e61ff14c67ad
2020-05-05Rework README filePau Espin Pedrol1-116/+0
Drop old one in doc/ which contains lots of outadated stuff already placed in the User Manual. Write a new markdown README in the root directory with pointers to places in the repo and the issue tracket, ansible setup, etc. Change-Id: I9febe56223eaeadc9d31291dd0110a11470e3ab1
2020-05-05doc: install.adoc: Correctly split optional dependenciesPau Espin Pedrol1-18/+59
Change-Id: Id8b5dcd15fd86c670915b928112699d831e6e7b0
2020-05-05doc: Drop redundant app-name in install sectionPau Espin Pedrol1-1/+1
Change-Id: I6ec3c42efd3eb958f832ff9a797ddaa3dae4a99a
2020-05-05tests: Replace 'suite' with 'tenv'Pau Espin Pedrol4-20/+20
Change-Id: I777ec59ffd83b861ddc09e85e52d7a8896264b8c
2020-04-10Introduce doc/examples/ directoryPau Espin Pedrol31-0/+498
It contains simple usual setups to get started with osmo-gsm-tester, such as creating a 4G network using srsLTE or a 2G network using the osmocom stack (+ ofono modems). Change-Id: I55d5b1152da201799af21a77ef6c562f97bd94fc
2020-04-07srs/amarisoft{ue,enb}: Fix b200 specific rf_dev_argsPau Espin Pedrol2-4/+5
Commit 12ae6d79a5b53a213f619999ef0230c1dae88bb7 switched the rf_dev_type to be in lowercase but forgot to change these conditions. Change-Id: I91d3877381b4e6343dc4aa0465e699341ed6648d
2020-04-07Move suites/ dir inside example/Pau Espin Pedrol2-2/+2
example/paths.conf and documentation are updated accordingly. Test suites should have been moved a long time ago, since the they are user or setup-specific based on what needs to be tested. Change-Id: I154b19979b545deba8b232b60172903f63fd9e28
2020-03-17doc/manuals: Introduce chapter explaining config data manglingPau Espin Pedrol2-0/+338
Explains how configurations bits are arranged and mangled to provide a last config set. Change-Id: I5c8f136e743b6beb02956b3436aa3d1010205141
2020-03-16doc/manuals: Several format and styles fixes for config.adocPau Espin Pedrol1-7/+11
Change-Id: I6371e09d6d88f137e7611bd60ac97b86414d8c47
2020-03-16doc/manuals: Add proper content for Debugging sectionPau Espin Pedrol1-1/+64
Change-Id: Iaed2544d59f7c5dd69eef3ddfade544b35c837cd
2020-03-16doc/manuals: Introduce Troubleshooting section about SIGKILL fixPau Espin Pedrol1-0/+39
Add a section describing how to clean up and recover osmo-gsm-tester state after a sigkill is used. Change-Id: I4841ab6d44a122140e6352df1fb6543418adc033
2020-03-14doc/manuals: Fix title out of sequencePau Espin Pedrol1-4/+4
asciidoc: WARNING: install.adoc: line 450: section title out of sequence: expected level 3, got level 4 Change-Id: I0c881405e66cc6815533bb884016db20cfdff3dc
2020-03-12doc/manuals: Write section explaining parametrized scenariosPau Espin Pedrol1-0/+43
Change-Id: I04b7fa46c2a282095bbb8f6d69ade87ff86f910c
2020-03-12doc/manuals: Write proper content for Ansible Setup sectionPau Espin Pedrol1-2/+52
Change-Id: Iffd3beefa50dd5f18908b4c3f7e4deb169feca62
2020-03-12doc/manuals: Write proper content for Docker Setup sectionPau Espin Pedrol1-2/+52
Change-Id: Ie883adbf03a3b5c9a852182c01d15a212749ce04
2020-03-12doc/manual: Refactor, rewrite, improve and update most of the User ManualPau Espin Pedrol11-766/+929
* Some TODOs are added as comments which actually require code changes. These are details which showed up as incongruences or missing bits while writing the documentation for them. * Some sections are introduced but still waiting to be writen soon: ** Debugging section ** Docker Setup section ** Ansible Setup section ** Troubleshooting (add jenkins red cross button sending kill -9) ** resources.conf attribute list needs to be converted to a table * Device related setup needs to be updated and extended * Parametrized scenarios need to be documented * 4G resources documentation needs to be added. Change-Id: Ifc2a3c74d45336cc988b76c0ff68a85311e4dd40
2019-02-19doc: Update list of dependencies and add pysispm oneHolger Hans Peter Freyther1-1/+3
Change-Id: I05cc63bfd627bfec83b50fe89fe8004d130384e6
2018-11-29doc/manuals: integrate into this repositoryOliver Smith2-4/+28
Update .gitignore and make the manuals build without a toplevel configure.ac file from autotools: $ cd doc/manuals $ make Related: OS#3385 Change-Id: I5916bc7e656b508fc74917e79841ce7e1ee4981b
2018-11-28build manuals moved here from osmo-gsm-manuals.gitOliver Smith3-13/+16
Moved to doc/manuals/, with full commit history, in preceding merge commit. Now incorporate in the build system. Build with: $ autoreconf -fi $ ./configure --enable-manuals $ make Shared files from osmo-gsm-manuals.git are found automatically if - the repository is checked out in ../osmo-gsm-manuals; or - if it osmo-gsm-manuals was installed with "make install"; or - OSMO_GSM_MANUALS_DIR is set. Related: OS#3385 Change-Id: I8a34871948425ea40f40dbb11a59806905e4bed1
2018-11-28Merge history from osmo-gsm-manuals.gitNeels Hofmeyr9-0/+1538
2018-11-28OsmoGSMTester: Update import test->testenvPau Espin Pedrol1-1/+1
Latest changes in osmo-gsm-tester require this import change. Depends on: osmo-gsm-tester I520bd046cb09042b5567d967f951f050e4e02e85 Change-Id: I0f7f7d0353014b7ef8a0c5a7707c91b2613be79a
2018-11-28OsmoGsmTester: Put several permission categories under cat User PermissionPau Espin Pedrol1-4/+4
Change-Id: Ie9f846af0311d768c5dd6f9da572c8f6482f4d39
2018-11-28OsmoGSMTester: Add state_dir sectionPau Espin Pedrol1-0/+22
Change-Id: Ie12e3933747a4e698de59ff9ac57281e9f261d3d
2018-11-28OsmoGSMTester: Add suites_dir sectionPau Espin Pedrol1-0/+10
Change-Id: Ie25fd742f484981f5e5b25397c2637eda38f0424
2018-11-28OsmoGSMTester: Add scenarios_dir sectionPau Espin Pedrol1-0/+55
It explains how scenario combination works Change-Id: I3f89bd3d71400da14cda7ea8bb9c190fe80a539f
2018-11-28OsmoGSMTester: Improve Trial section contentPau Espin Pedrol1-1/+10
Change-Id: I8d74b02166ea33ad9ab7f987894f4f02064fbebc
2018-11-28OsmoGSMTester: Update defaults.conf examplePau Espin Pedrol1-14/+31
Change-Id: If12df88b4088ecec6d6cb20c83a693c019b8af4a
2018-11-28OsmoGSMTester: Remove resolved TODOPau Espin Pedrol1-2/+0
Change-Id: Ie0f18293e566a690d2434d08cbaaf2fdf71d88e4
2018-11-28OsmoGSMTester: Update resources cfg documentationPau Espin Pedrol1-11/+38
Change-Id: I6ec9fc5468ce6ead52d9c8b35d8991cac4bfa97e
2018-11-28OsmoGSMTester: Document how to setup main unit to set CAP_NET_RAW asPau Espin Pedrol1-0/+30
non-root Change-Id: I011beaa929efcabe9a9dc4f9c7222ba36fa2aae4
2018-11-28OsmoGSMTester: Move TODO comment to a redmine taskPau Espin Pedrol1-2/+0
Following task has been created: OS#2612 Change-Id: I79837e49f3e6af4254e9f0c7f53037eae66cda6d