Bookmark this page

Guided Exercise: Troubleshooting with Red Hat Resources

Generate and inspect an sos report on your servera system.

Outcomes

You should be able to generate an sos report to aid Red Hat Support in resolving an issue.

As the student user on the workstation machine, use the lab command to prepare your system for this exercise.

[student@workstation ~]$ lab start strategy-redhatresources

This command ensures that your systems are reachable from the workstation machine.

Instructions

While troubleshooting an issue on the servera machine, you contacted Red Hat Support for assistance. Support requested that you generate an sos report for only the xfs plugin.

For the purpose of this exercise, your case number is 123456.

  1. Log in to servera and switch to the root user.

    [student@workstation ~]$ ssh student@servera
    ...output omitted...
    [student@servera ~]$ sudo -i
    [sudo] password for student: student
    [root@servera ~]#
  2. Verify that the sos package is installed on your servera system, and install it if necessary.

    1. Verify that the sos package is installed.

      [root@servera ~]# rpm -q sos
      sos-4.0-11.el8.noarch
    2. If the previous command returned package sos is not installed, then install the sos package.

      [root@servera ~]# yum install sos
  3. View the available options, plug-ins, and plug-in options for sos report.

    1. View the available options for the sos report command.

      [root@servera ~]# sos report --help | less
    2. View the available plug-ins and plug-in options for the sos report command.

      [root@servera ~]# sos report -l | less
  4. Generate an sos report on servera. Enable only the xfs plug-in.

    1. Run the sos report tool with the -o xfs option. Use the interactive prompts to enter all required information.

      [root@servera ~]# sos report -o xfs
      
      sosreport (version 4.0)
      
      This command will collect diagnostic and configuration information from
      this Red Hat Enterprise Linux system and installed applications.
      
      An archive containing the collected information will be generated in
      /var/tmp/sos.og2eg7gq and may be provided to a Red Hat support
      representative.
      
      Any information provided to Red Hat will be treated in accordance with
      the published support policies at:
      
        https://access.redhat.com/support/
      
      The generated archive may contain data considered sensitive and its
      content should be reviewed by the originating organization before being
      passed to any third party.
      
      No changes will be made to system configuration.
      
      Press ENTER to continue, or CTRL-C to quit. Enter
      
      Please enter the case id that you are generating this report for []: 123456
      
       Setting up archive ...
       Setting up plugins ...
       Running plugins. Please wait ...
      
        Starting 1/1   xfs             [Running: xfs]
        Finished running plugins
      Creating compressed archive...
      
      Your sosreport has been generated and saved in:
      	/var/tmp/sosreport-servera-123456-2021-08-30-pgstdzb.tar.xz
      
       Size	3.76KiB
       Owner	root
       md5	8d66fd763d397ce8de263bfdd042b7aa
      
      Please send this file to your support representative.
    2. Return to workstation as the student user.

      [root@servera ~]# exit
      [student@servera ~]$ exit
      [student@workstation ~]$
  5. Copy the generated file to the student user's home directory on workstation, and extract it. The file name used in this exercise is an example, and yours will be different.

    1. Copy the generated file to the student user's home directory on workstation.

      [student@workstation ~]$ scp root@servera:/var/tmp/sosreport-servera-123456*.tar.xz .
    2. Extract the generated file.

      [student@workstation ~]$ tar xvf sosreport-servera-123456-2021-09-02-ytgpkbx.tar.xz
  6. Inspect the extracted sos report and validate that the xfs plug-in was used.

    1. Inspect the extracted sos report by listing its contents.

      [student@workstation ~]$ cd sosreport-servera-123456-2021-09-02-ytgpkbx
      [student@workstation ~]$ ls -l
    2. Confirm the use of xfs plug-in inspecting the xfs configuration of servera.

      [student@workstation ~]$ cat sos_commands/xfs/xfs_info

Finish

On the workstation machine, use the lab command to complete this exercise. This is important to ensure that resources from previous exercises do not impact upcoming exercises.

[student@workstation ~]$ lab finish strategy-redhatresources

Revision: rh342-8.4-6dd89bd