summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBen Nemec <bnemec@redhat.com>2018-04-04 15:47:22 +0000
committerBen Nemec <bnemec@redhat.com>2018-04-04 15:49:42 +0000
commit8d0e5fcc95ff2a2093373c35697f1ec8a9ff113b (patch)
tree70a3a32f707cf93c890ee7a3103d84ff99214e35
parenta3ee7688646bfdaba7f40d2ab61554110f99a21d (diff)
Document workaround for AccessDenied error
On SELinux-enabled platforms it is possible for the report process to fail with an AccessDenied error when it tries to read information about the process being debugged. Per [1], the recommended solution is to temporarily disable SELinux during debugging and then turn it on again once the report has completed successfully. 1: https://bugzilla.redhat.com/show_bug.cgi?id=1292787 Change-Id: Ic12d5658858bb085448e1b437b548111d3c79583 Closes-Bug: 1756044
Notes
Notes (review): Code-Review+2: Doug Hellmann <doug@doughellmann.com> Code-Review+2: Stephen Finucane <stephenfin@redhat.com> Workflow+1: Stephen Finucane <stephenfin@redhat.com> Verified+2: Zuul Submitted-by: Zuul Submitted-at: Wed, 11 Apr 2018 10:33:11 +0000 Reviewed-on: https://review.openstack.org/558858 Project: openstack/oslo.reports Branch: refs/heads/master
-rw-r--r--doc/source/user/usage.rst6
1 files changed, 6 insertions, 0 deletions
diff --git a/doc/source/user/usage.rst b/doc/source/user/usage.rst
index b1c1790..4165935 100644
--- a/doc/source/user/usage.rst
+++ b/doc/source/user/usage.rst
@@ -28,6 +28,12 @@ To trigger the report to be generated::
28 28
29 kill -SIGUSR2 <process_id> 29 kill -SIGUSR2 <process_id>
30 30
31.. note::
32
33 On SELinux platforms the report process may fail with an AccessDenied
34 exception. If this happens, temporarily disable SELinux enforcement
35 by running ``sudo setenforce 0``, trigger the report, then turn SELinux
36 back on by running ``sudo setenforce 1``.
31 37
32Here is a sample report: 38Here is a sample report:
33 39