Satellite 6 Capsule Server: which files to gather for debugging / troubleshooting Capsule server?

Solution Verified - Updated

Environment

  • Red Hat Satellite 6 Capsule Server

Issue

  • How to gather debug data / what information and data is needed for debugging Satellite 6 Capsule server?
  • Is there a foreman-debug or similar utility for Capsule server?

Resolution

For a Capsule 6.2 or higher:


Run `foreman-debug` like on Satellite. Optionally, run `sosreport` that will enable `foreman` plugin that collects `foreman-debug` as well. For more information here, follow KCS ["Satellite 6: What is foreman-debug and how do I run it? "](https://access.redhat.com/solutions/1177823).

For a Capsule 6.0 or 6.1:

For capsules on RHEL6, sos-3.2-28.el6 (released with This content is not included.RHBA-2015-1323) or later should be installed, which enables capturing of data required for capsule debugging. This is implemented as plugin, the work was tracked in (private) bz1135290.

For capsules on RHEL7, tar up all of the following directories and files in addition to sosreport on the Capsule server:

  • Installation logs
    • /var/log/katello-installer/
  • Pulp
    • /etc/pulp/
    • /var/log/messages
  • Qpid
    • /etc/qpidd.conf
    • /etc/qpid/
    • /var/log/messages
  • Gofer
    • /var/log/gofer/
    • /etc/gofer/
  • Katello-agent (if installed)
    • /usr/lib/yum-plugins/
    • /etc/gofer/plugins/
    • /var/log/gofer/
  • Puppet
    • /var/log/puppet/
    • /var/log/messages
    • /etc/puppet/
  • Foreman Proxy
    • /var/log/foreman-proxy/
    • /etc/foreman-proxy/
  • Apache
    • /var/log/httpd/
    • /etc/httpd/conf.d/
  • Mongodb
    • /etc/mongodb/
    • /var/log/mongodb/
  • Certificates
    • /etc/pki/katello/
  • DNS
  • DHCP
  • TFTP
  • FreeIPA

A Bugzilla (BZ # 1134109) is tracking a debug utility for Capsule server in the future, similar to foreman-debug for Satellite 6 server itself which is detected and called by default when running sosreport. Please see Satellite 6: What is foreman-debug and how do I run it?

Root Cause

  • Currently there's no foreman-debug or "sosreport -o rhn" equivalent for Satellite 6 Capsule servers.
SBR
Product(s)
Category
Tags

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.