Chapter 7. Contacting Red Hat Support Service
If the information in this guide did not help you to solve the problem, this chapter explains how you contact the Red Hat Support Service.
7.1. Providing Information to Red Hat Support Engineers
If you are unable to fix problems related to Red Hat Ceph Storage by yourself, contact the Red Hat Support Service and provide sufficient amount of information that helps the support engineers to faster troubleshoot the problem you encounter.
Procedure: Providing Information to Red Hat Support Engineers
- Open a support ticket on the Red Hat Customer Portal.
-
Ideally, attach an
sosreport
to the ticket. See the What is a sosreport and how to create one in Red Hat Enterprise Linux 4.6 and later? solution for details. - If the Ceph daemons failed with a segmentation fault, consider generating a human-readable core dump file. See Section 7.2, “Generating Readable Core Dump Files” for details.
7.2. Generating Readable Core Dump Files
When a Ceph daemon terminates unexpectedly with a segmentation fault, gather the information about its failure and provide it to the Red Hat Support Engineers.
Such information speeds up the initial investigation. Also, the Support Engineers can compare the information from the core dump files with Red Hat Ceph Storage known issues.
Before You Start
Install the
ceph-debuginfo
package if it is not installed already.Enable the repository containing the
ceph-debuginfo
package:subscription-manager repos --enable=rhel-7-server-rhceph-2-<daemon>-debug-rpms
Replace
<daemon>
withosd
ormon
depending on the type of the node.Install the
ceph-debuginfo
package:# yum install ceph-debuginfo
Ensure that the
gdb
package is installed and if it is not, install it:# yum install gdb
Procedure: Generating Readable Core Dump Files
Enable generating core dump files for Ceph.
Set the proper
ulimits
for the core dump files by adding the following parameter to the/etc/systemd/system.conf
file:DefaultLimitCORE=infinity
Comment out the
PrivateTmp=true
parameter in the Ceph daemon service file, by default located at/lib/systemd/system/<cluster-name>-<daemon>@.service
:# PrivateTmp=true
Set the
suid_dumpable
flag to2
to allow the Ceph daemons to generate dump core files:# sysctl fs.suid_dumpable=2
Adjust the core dump files location:
# sysctl kernel.core_pattern=/tmp/core
Reload the
systemd
service for the changes to take effect:# systemctl daemon-reload
Restart the Ceph daemon for the changes to take effect:
systemctl restart ceph-<daemon>@<ID>
Specify the daemon type (
osd
ormon
) and its ID (numbers for OSDs, or short host names for Monitors) for example:# systemctl restart ceph-osd@1
- Reproduce the failure, for example try to start the daemon again.
Use the GNU Debugger (GDB) to generate a readable backtrace from an application core dump file:
gdb /usr/bin/ceph-<daemon> /tmp/core.<PID>
Specify the daemon type and the PID of the failed process, for example:
$ gdb /usr/bin/ceph-osd /tmp/core.123456
In the GDB command prompt apply the
backtrace
command to all threads of the process by enteringthr a a bt
:(gdb) thr a a bt
- Copy and paste the output from the previous command into a support ticket.
See Also
- The How to use gdb to generate a readable backtrace from an application core solution on the Red Hat Customer Portal
- The How to enable core file dumps when an application crashes or segmentation faults solution on the Red Hat Customer Portal