Bookmark this page

Guided Exercise: Create a Diagnostics Report

Generate a diagnostics report that you could submit to the Red Hat Customer Portal as part of a support case, by using the web console.

Outcomes

  • Generate a diagnostics report that you could submit as part of a support case to the Red Hat Customer Portal.

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

This command prepares your environment and ensures that all required resources are available.

[student@workstation ~]$ lab start support-portal

Instructions

  1. Log in to the servera machine as the student user.

    [student@workstation ~]$ ssh student@servera
    Warning: Permanently added 'servera' (ED25519) to the list of known hosts.
    Activate the web console with: systemctl enable --now cockpit.socket
    ...output omitted...
    [student@servera ~]$
  2. Start the cockpit service.

    [student@servera ~]$ systemctl start cockpit.socket
    ==== AUTHENTICATING FOR org.freedesktop.systemd1.manage-units ====
    Authentication is required to start 'cockpit.socket'.
    Authenticating as: Student User (student)
    Password: student
    ==== AUTHENTICATION COMPLETE ====
  3. Verify the status of the cockpit service.

    [student@servera ~]$ systemctl status cockpit.socket
    ● cockpit.socket - Cockpit Web Service Socket
         Loaded: loaded (/usr/lib/systemd/system/cockpit.socket; disabled; vendor preset: disabled)
         Active: active (listening) since Mon 2022-03-28 01:41:13 EDT; 1min 27s ago
          Until: Mon 2022-03-28 01:41:13 EDT; 1min 27s ago
       Triggers: ● cockpit.service
           Docs: man:cockpit-ws(8)
         Listen: [::]:9090 (Stream)
    ...output omitted...
    Mar 28 01:41:13 servera.lab.example.com systemd[1]: Starting Cockpit Web Service Socket...
    Mar 28 01:41:13 servera.lab.example.com systemd[1]: Listening on Cockpit Web Service Socket.
  4. Return to the workstation machine as the student user.

    [student@servera ~]$ exit
    logout
    Connection to servera closed.
    [student@workstation ~]$
  5. On the workstation machine, open the Firefox web browser and log in to the web console interface that is running at the servera.lab.example.com address. Log in as the student user with student as the password.

    1. Open the Firefox web browser and go to the https://servera.lab.example.com:9090 address.

    2. When prompted, accept the self-signed certificate by adding it as an exception.

    3. Log in as the student user with student as the password.

    4. Click the Limited access button to switch to administrative access. Use student as the student user's password and click the Authenticate button. The web console replaces the Limited access button with the Administrative access button.

    5. Click the Diagnostic Reports menu on the left navigation bar. Click the Run report button.

    6. Enter student in the Report label field.

    7. Click Run report. The report takes a few minutes to build.

  6. When the report is ready, download the file.

    1. Click the Download button. The diagnostic report is downloaded.

    2. Log out from the web console session and close the Firefox web browser.

Finish

On the workstation machine, change to the student user home directory and use the lab command to complete this exercise. This step is important to ensure that resources from previous exercises do not impact upcoming exercises.

[student@workstation ~]$ lab finish support-portal

Revision: rh199-9.3-8dd73db