aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPau Espin Pedrol <pespin@sysmocom.de>2017-08-28 11:58:25 +0200
committerNeels Hofmeyr <nhofmeyr@sysmocom.de>2017-09-04 16:11:29 +0000
commit37f8b7856d9e53a9d6c3438b3159358e7d7ce81c (patch)
tree816bd4c751215908d0f74a5705410973f67b385a
parentb1503f04bf109e28ea938b3a42d962d56d3fed6e (diff)
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
-rw-r--r--OsmoGSMTester/chapters/install.adoc57
1 files changed, 32 insertions, 25 deletions
diff --git a/OsmoGSMTester/chapters/install.adoc b/OsmoGSMTester/chapters/install.adoc
index f58c611..4d2b677 100644
--- a/OsmoGSMTester/chapters/install.adoc
+++ b/OsmoGSMTester/chapters/install.adoc
@@ -330,31 +330,6 @@ Details:
This assumes you have already created the jenkins user (see <<configure_build_slave>>).
-==== Allow Core Files
-
-In case a binary run for the test crashes, a core file of the crash should be
-written. This requires a limit rule. Copy the following config file from the
-osmo-gsm-tester source tree to the main unit:
-
-----
-sudo -s
-echo "@osmo-gsm-tester - core unlimited" > /etc/security/limits.d/osmo-gsm-tester_allow-core.conf
-----
-
-Re-login the user to make these changes take effect.
-
-==== Allow Realtime Priority
-
-Certain binaries should be run with real-time priority, like 'osmo-bts-trx'.
-Add this permission on the main unit:
-
-----
-sudo -s
-echo "@osmo-gsm-tester - rtprio 99" > /etc/security/limits.d/osmo-gsm-tester_allow-rtprio.conf
-----
-
-Re-login the user to make these changes take effect.
-
==== User Permissions
On the main unit, create a group for all users that should be allowed to use
@@ -467,6 +442,38 @@ testing 'tcpdump' access, make sure to have proper filter expressions in place.
TODO: allow skipping pcaps by configuration if access to tcpdump is not wanted
+==== Allow Core Files
+
+In case a binary run for the test crashes, a core file of the crash should be
+written. This requires a limit rule. Create a file with the required rule:
+
+----
+sudo -s
+echo "@osmo-gsm-tester - core unlimited" > /etc/security/limits.d/osmo-gsm-tester_allow-core.conf
+----
+
+Re-login the user to make these changes take effect.
+
+Set the *kernel.core_pattern* sysctl to *core* (usually the default). For each
+binary run by osmo-gsm-tester, a core file will then appear in the same dir that
+contains stdout and stderr for that process (because this dir is set as CWD).
+
+----
+sysctl -w kernel.core_pattern=core
+----
+
+==== Allow Realtime Priority
+
+Certain binaries should be run with real-time priority, like 'osmo-bts-trx'.
+Add this permission on the main unit:
+
+----
+sudo -s
+echo "@osmo-gsm-tester - rtprio 99" > /etc/security/limits.d/osmo-gsm-tester_allow-rtprio.conf
+----
+
+Re-login the user to make these changes take effect.
+
[[user_config_uhd]]
==== UHD