Generating an sosreport for Atomic Host or an OpenShift 3 master/node

Solution Verified - Updated

Environment

  • Red Hat OpenShift Container Platform (OCP) 3.x
  • Red Hat Enterprise Linux (RHEL)
  • Red Hat Enterprise Linux Atomic Host
  • sos

Note: Red Hat OpenShift Platform 4.x instructions are here: https://access.redhat.com/solutions/3820762

Issue

  • Support requested an sosreport for Atomic Host or an OpenShift Master or Node
  • What plug-ins or flags to collect OpenShift data using sosreport
  • Basic information necessary for troubleshooting or diagnosing OpenShift or Atomic Host issues

Resolution

Red Hat Enterprise Linux

A starting point for data collection from an OpenShift master or node is an sosreport that includes docker and OpenShift related information. The process to collect an sosreport is the same as with any other Red Hat Enterprise Linux (RHEL) based system:

# yum update sos
# sosreport

Red Hat Enterprise Linux Atomic Host

To collect an sosreport from RHEL Atomic Host, run the following sequence of commands, using the support-tools container. This should already be installed on the RHEL Atomic Host, however if it is not you can pull the image by following these steps:

  1. Log into Atomic Host system as root. Use the atomic command to run a support-tools super-privileged container with an interactive bash shell.

     # atomic run registry.access.redhat.com/rhel7/support-tools

Using the support-tools container to collect an sosreport is slightly different from a standard RHEL system. Please review Using the Atomic Support Tools Container Image for more details on how to run commands and save data from within a container effects tools like sosreport.

# atomic run registry.access.redhat.com/rhel7/support-tools
[root@servera /]# sosreport

Your sosreport has been generated and saved in:
/host/var/tmp/sosreport-servera.podX.example.com-20150311005408.tar.xz
The checksum is: 70cd9ddcd322028447a32fea28acabab
Please send this file to your support representative.

Once you have exited the container, your sosreport can be found in /var/tmp/sosreport-servera.podX.example.com-20150311005408.tar.xz.

SBR
Product(s)
Components
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.