Commit Graph

40 Commits

Author SHA1 Message Date
Oliver Smith 2947683c3a use autotools to add "make install" target
For reasoning why a transition to autotools is desired, see the commit
message of the previous patch in this series.

"make install" copies the "build", "common" dirs, as well as the "*.xsl"
files to $(prefix)/share/osmo-gsm-manuals. Prefix is typically
/usr/local. Also a pkg-config file gets installed, so the path of the
shared files can be looked up by autoconf scripts of the project
repositories. The check-depends script is installed to
$(prefix)/bin/osmo-gsm-manuals-check-depends and will be used by
project specific autoconf scripts, too.

All existing make targets ("make", "make check", "make upload") are
still working, users only need to run "autoreconf -fi" and
"./configure" beforehand.

Makefile.am uses custom install-data-hook and uninstall-local targets,
so we don't need to specify each file of the relevant subdirs in a
_DATA variable (no extra maintenance effort).

(moving manuals to project repositories 5/19)

Related: OS#3385
Change-Id: I8e7036fae062ee783cb132b14608827a82c5e7c7
2018-11-21 14:29:05 +01:00
Oliver Smith dec39cdea9 s/TOPDIR/OSMO_GSM_MANUALS_DIR/g
Replace TOPDIR with OSMO_GSM_MANUALS_DIR. When the project specific
manuals will be built out of this repository, we still need to refer to
the top directory of the shared content. But it will be in another
repository, so we need to rename the variable to avoid confusion.

(moving manuals to project repositories 3/19)

Related: OS#3385
Change-Id: I2af797546de048a6ab19a5cbc755e5e15575d7ab
2018-11-20 17:13:25 +01:00
Pau Espin aaeee90f0b OsmoGSMTester: Update import test->testenv
Latest changes in osmo-gsm-tester require this import change.

Depends on: osmo-gsm-tester I520bd046cb09042b5567d967f951f050e4e02e85

Change-Id: I0f7f7d0353014b7ef8a0c5a7707c91b2613be79a
2017-11-29 11:54:40 +00:00
Pau Espin 63058b1722 OsmoGsmTester: Put several permission categories under cat User Permission
Change-Id: Ie9f846af0311d768c5dd6f9da572c8f6482f4d39
2017-11-29 11:54:40 +00:00
Pau Espin 5e67f555ac OsmoGSMTester: Add state_dir section
Change-Id: Ie12e3933747a4e698de59ff9ac57281e9f261d3d
2017-11-29 11:54:40 +00:00
Pau Espin 808db8625a OsmoGSMTester: Add suites_dir section
Change-Id: Ie25fd742f484981f5e5b25397c2637eda38f0424
2017-11-29 11:54:40 +00:00
Pau Espin e357194c2e OsmoGSMTester: Add scenarios_dir section
It explains how scenario combination works

Change-Id: I3f89bd3d71400da14cda7ea8bb9c190fe80a539f
2017-11-29 11:54:40 +00:00
Pau Espin 5c6f783d60 OsmoGSMTester: Improve Trial section content
Change-Id: I8d74b02166ea33ad9ab7f987894f4f02064fbebc
2017-11-12 14:21:04 +00:00
Pau Espin 3fec854984 OsmoGSMTester: Update defaults.conf example
Change-Id: If12df88b4088ecec6d6cb20c83a693c019b8af4a
2017-11-12 14:21:04 +00:00
Pau Espin 89b555beeb OsmoGSMTester: Remove resolved TODO
Change-Id: Ie0f18293e566a690d2434d08cbaaf2fdf71d88e4
2017-11-12 14:21:04 +00:00
Pau Espin 5e641c78de OsmoGSMTester: Update resources cfg documentation
Change-Id: I6ec9fc5468ce6ead52d9c8b35d8991cac4bfa97e
2017-11-12 14:21:04 +00:00
Pau Espin 274fe3733b OsmoGSMTester: Document how to setup main unit to set CAP_NET_RAW as
non-root

Change-Id: I011beaa929efcabe9a9dc4f9c7222ba36fa2aae4
2017-11-12 14:21:04 +00:00
Pau Espin 16f5d075d1 OsmoGSMTester: Move TODO comment to a redmine task
Following task has been created: OS#2612

Change-Id: I79837e49f3e6af4254e9f0c7f53037eae66cda6d
2017-11-12 14:21:04 +00:00
Pau Espin f880d707aa OsmoGSMTester: Installation: change some confusing terminology
It's difficult to understand when it referrs to jenkins job in general
and when it talks about specific jenkins jobs that builds binaries required for
osmo-gsm-tester and the ones which run osmo-gsm-tester.

As a result, it's difficult to understand which sections apply to each
host in case more than one host is used.

Change-Id: I5c882e77b469629028b8d773053783e18f3d1737
2017-11-12 14:21:04 +00:00
Pau Espin 7650547ec5 OsmoGSMTester: Add deps required for osmo-bts-octphy support
Change-Id: I384ec8cd55cfaa68ee1f461de99ceac78c5d8414
2017-11-12 14:21:04 +00:00
Pau Espin 1ca6d8543e OSmoGsmTester: Specify group in Main unit intro
Change-Id: I132bf7681a1a435c161c4048e41c28dc75c1fa28
2017-11-12 14:21:04 +00:00
Pau Espin e924c2fce4 OsmoGSMTester: Explain patchelf is used sometimes to modify RPATH
Change-Id: I7bb811bc984c8d576984b038b391cf8130cc465e
2017-11-12 14:21:04 +00:00
Pau Espin 88ad5ed0df OsmoGSMTester: Update suite.conf example
This is the one we are usig nowadays in suite.conf, which explicitly
asks to be run with modems supporting sms features.

Change-Id: If5dbc3b4689b282db6fae4668e2838be59e88da8
2017-11-12 14:21:03 +00:00
Pau Espin d8802e7b99 OsmoGSMTester: Use a more up-to-date resources.conf example
It showcases new features such as osmo-trx support, cipher support,
modem features support, etc.

Change-Id: I66bbcd028f03290797c2c467271d0f0982698b47
2017-11-12 14:21:03 +00:00
Pau Espin 48092ec2a8 OsmoGSMTester: Improve Resource Resolution section content
Change-Id: Ice37093dc9f8e03a2a9f5e3f7df79d1b589b6991
2017-11-12 14:21:03 +00:00
Pau Espin 80f4380d91 OsmoGSMTester: Update sample test script with an AoIP example
Change-Id: I7978c7e96c8f1d43837271c94dd64893649974e0
2017-11-12 14:21:03 +00:00
Pau Espin c3d12c6b55 OsmoGSMTester: Update trial graph with current data
The osmo-bts-trx tgz doesn't exist anymore and it does not contain
osmo-trx, which comes in its own tgz.

Change-Id: Id803eca3791137b04bc24d195119d5c511fcfc49
2017-11-12 14:21:03 +00:00
Pau Espin 74b87c1e0d OsmoGSMTester: Improve setup graph
* Add sysmocell5000
* Remove 1 modem, showing 2 of them is enough
* Split osmo-bts-trx from osmo-trx node as sysmocell500 doesn't use the
later.
* Update OsmoNITB node to show we also support split openbsc.git
components.

Change-Id: I893beb114d47edd3f67183dd9ea5acc19462496c
2017-11-12 14:21:03 +00:00
Neels Hofmeyr c481a988e3 refactor Makefile build rules, don't use the FORCE
The initial goal was to make sure we don't have overall FORCE rules causing
unnecessary rebuilds -- annoying while writing documentation. As I looked
through possible dependencies, I finally understood what's going on here.

Remove code dup and nicely sort which belongs where in build/Makefile.*.inc. In
each, describe in a top comment how to use it, and also unify how they are
used:

- Rename Makefile.inc to Makefile.docbook.inc and refactor
- Add Makefile.vty-reference.inc
- Add Makefile.common.inc

Make sure that we accurately pick up all dependencies.

Drop use of the macro called 'command', that silenced the actual command lines
invoked and replaced them with short strings: it obscures what is actually
going on and makes the Makefiles hard to read and understand.

Each manual's makefile is greatly reduced to few definitions and a Makefile
include, e.g. one for asciidoc, one for VTY reference.

Move common/bsc_vty_additions.xml to OsmoBSC/vty/libbsc_vty_additions.xml, link
from OsmoNITB. It applies only to OsmoBSC and OsmoNITB.

Add a script that combines a VTY reference file with *all* additions files
found in a manual's vty/ dir. Call this from Makefile.vty-reference.inc.

Change-Id: I9758e04162a480e28c7dc83475b514cf7fd25ec0
2017-10-25 16:51:55 +00:00
Neels Hofmeyr 565a9dc3de OsmoGSMTester: document logrotate maxsize
Change-Id: Ib3e7143eb5d90eea4860a0a334da25efe926a231
2017-10-11 00:04:02 +00:00
Pau Espin 37f8b7856d OsmoGsmTester: Move coredump section and add reference to kernel.core_pattern sysctl
This section is moved further below in order to have it after section
which explains how to create user jenkins and osmo-gsm-tester group, as
we need this group already created anyway for the config to work
correctly.

Change-Id: I5bdde0a9960f9806f081e9a876b8b66db9e7f37c
2017-09-04 16:11:29 +00:00
Max e4a9602d4d OsmoGSMTester: use proper systemd service names
* use osmo-bts-sysmo for sysmoBTS systemd service name which is available
  since 114293a414bd5b7c86622ec8c293c4034c80d243
* use osmo-pcu for OsmoPCU systemd service name which is available since
  241f5bcb00f9c6fee4200a3aea9aa497bf0d3eee

Change-Id: Ie017946b9099460ac6758ff84ec7a10df13390a1
2017-08-18 18:08:00 +00:00
Neels Hofmeyr bed4162c70 osmo-gsm-tester: jenkins fixes: install JDK, SSH instructions
Add instructions to install Java JDK for jenkins build slave.
Minor fixes to SSH key instructions.

Change-Id: Ib2c1adc2ddee3be016e4d253451593b19dbe133a
2017-07-17 14:43:10 +02:00
Neels Hofmeyr 7bb183580d OsmoGSMTester: update run-job post-build artifact archiving rule
Change-Id: I73c1a6793369604cbe494c83b595a4130a44adc9
2017-06-18 02:31:54 +02:00
Pau Espin ae2f278fac OsmoGsmTester: install.adoc: Remove trailing whitespace
My editor is removing it automatically.

Change-Id: I25c8d179a21c66ab3424204e12215f8e1ddd8e54
2017-06-14 22:38:19 +00:00
Pau Espin 4ca4ca90d5 OsmoGsmTester: Add missing dependency python-smpplib
Change-Id: I9a6ad33d41c8a90317d079ff0d1f9640c48a2353
2017-06-14 22:38:07 +00:00
Pau Espin 4c5e2863f3 OsmoGsmTester: Update sample test script
Copied from newest mo_mt_sms.py test.

Change-Id: I49644f6f8223d45bccbcbb3aa8325c20c06dcdbe
2017-06-14 22:37:11 +00:00
Neels Hofmeyr f60efb528c OsmoGSMTester: tweak sysmobts: systemctl, ssh, limits, reboot
Simpler systemctl rule to disable stock services.

Fix the limits config, which was not the right way for sysmoBTS.

SSH access: apparently no need to create an ssh key at all, login is permitted
right away.

Add hint to reboot at the right time.

Change-Id: I8e686383318ee2eece908a4e690e5061ade0cd02
2017-06-03 15:36:39 +02:00
Neels Hofmeyr 6afa4ce698 OsmoGSMTester: add sqlite3 as dependency
Needed to setup the initial hlr db using the hlr.sql file from osmo-hlr
since osmo-gsm-tester commit 798e592fd642a1dd86380c412a9501931b9048e1
"MSC+BSC: add test api to run OsmoMSC and OsmoBSC with AoIP"

Change-Id: Ic19f93a69df4062364da8523b5d30a1611a0eb77
2017-06-03 15:35:50 +02:00
Neels Hofmeyr 724bb5166f OsmoGSMTester: add rtprio conf, tweak core dump conf
Change-Id: I284c3bfb15e914f1f6ab00f15874fe5ea6190c5c
2017-05-28 22:25:01 +00:00
Neels Hofmeyr f3981f44bd apply rename of resource nitb_iface to ip_address
See osmo-gsm-tester change-id I829903d7b2111ab5ee106bce52d6121204a5a401

Change-Id: Icbbb7d921e7340739883650f778d5a7341840875
2017-05-22 23:59:21 +02:00
Neels Hofmeyr 97d64d1282 OsmoGSMTester: say 'modems', not 'modem' (sounds like it supports only one)
Change-Id: Ib59788a50754ea5290e665a9f9376d70e01c9be5
2017-05-15 15:28:52 +02:00
Neels Hofmeyr 9cb9cd49ca OsmoGSMTester: add install docs; fixes and tweaks
Change-Id: I574937dbf31bce49cfb7523f91041c20fecb421e
2017-05-14 20:09:35 +02:00
Neels Hofmeyr 1e93b9fc55 OsmoGSMTester: add / tweak overview graphs
Some mistakes fixed (missing osmo-trx, B200 pointing at NITB instead of
osmo-bts-trx)

Add graph showing resource selection.

Add graph showing a trial dir.

Change-Id: I1cfcd99ee11b851095a75107246cb156ede7f4cf
2017-05-05 02:51:23 +02:00
Neels Hofmeyr a6436b9280 cosmetic: OsmoGSMTester: fix dir name
All other subdirs are without dashes, but I added Osmo-GSM-Tester with dashes.
Comply with the naming scheme and remove dashes.

Change-Id: I36d0c94dde5deffba04b27436ae499a42c519bec
2017-04-23 15:04:39 +02:00