From 018e1048b46434e8a87cd654da970b27ae3d22db Mon Sep 17 00:00:00 2001 From: Pau Espin Pedrol Date: Mon, 28 Aug 2017 11:58:25 +0200 Subject: 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 --- doc/manuals/chapters/install.adoc | 57 ++++++++++++++++++++++----------------- 1 file changed, 32 insertions(+), 25 deletions(-) diff --git a/doc/manuals/chapters/install.adoc b/doc/manuals/chapters/install.adoc index f58c611..4d2b677 100644 --- a/doc/manuals/chapters/install.adoc +++ b/doc/manuals/chapters/install.adoc @@ -330,31 +330,6 @@ Details: This assumes you have already created the jenkins user (see <>). -==== 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 -- cgit v1.2.3