Chapter 12. Logging and Reporting Problems

Procedure

1. Edit the /etc/foreman/settings.yaml file.

   1. Change the logging level to "debug":

      :logging:
        :level: debug

   2. Select individual logging types:

      :loggers:
        :ldap:
          :enabled: true
        :permissions:
          :enabled: true
        :sql:
          :enabled: true

      For more information about loggers, see Section 12.1.2, “List of Loggers and Default Values”.

2. Restart Satellite services:

   # foreman-maintain service restart

Procedure

1. In the upper right, click Red Hat Access > Search.
2. If necessary, log in to the Red Hat Customer Portal. In the main panel on the upper right, click Log In.
3. In the Red Hat Search field, enter your search query. Search results display in the left-hand Recommendations list.
4. In the Recommendations list, click a solution. The solution article displays in the main panel.

Procedure

1. In the upper right, click Red Hat Access > Logs.
2. If necessary, log in to the Red Hat Customer Portal. In the main panel on the upper right, click Log In.
3. In the left file tree, select a log file and click the file name.
4. Click Select File. A pop-up window displays the log file contents.
5. In the log file, highlight any text sections you want to be diagnosed. The Red Hat Diagnose button displays.
6. Click Red Hat Diagnose. The system sends the highlighted information to the Red Hat Customer Portal, and provides solutions that closely match the provided log information.
7. If the solution does not match the problem, click Open a New Support Case. The support case is populated with the highlighted text from the log file. See Section 12.2.1, “Searching for Solutions”.

Procedure

1. In the upper right, click Red Hat Access > Support > New Case.
2. If necessary, log in to the Red Hat Customer Portal. In the main panel on the upper right, click Log In.

3. The Product and Product Version fields are automatically populated. Complete the other relevant fields, as follows:

   • Summary — Provide a brief summary of the issue.

   • Description — Write a detailed description of the issue.

     Based on the summary provided, recommendations for possible solutions display in the main panel.

4. Click Next.

5. Choose the appropriate options, as follows:

   • Severity — Select the ticket urgency as 4 (low), 3 (normal), 2 (high), or 1 (urgent).
   • Case Group — Based on who needs to be notified, create case groups associated with the support case. Select Case Groups in Red Hat Satellite. Create Case Groups within the Customer Portal.

6. Attach the output of sosreport and any required files. Add a file description and click Attach.

   Note
   • If you have large log files or many Satellite tasks, it is recommended to also attach the output of foreman-debug.
   • File names must be less than 80 characters and the maximum file size for attachments uploaded using the web UI is 250 MB. Use FTP for larger files.
7. Click Submit. The system uploads the case to the Customer Portal, and provides a case number for your reference.

Procedure

1. In the upper right, click Red Hat Access > Support > My Cases.
2. If necessary, log in to the Red Hat Customer Portal. In the main panel on the upper right, click Log In.

3. To search for a specific support case from existing cases, do any of the following:

   • In the Search field, provide a keyword or phrase.
   • From the drop-down list, choose a specific Case Group. Your organization has defined Case Groups inside the Red Hat Customer Portal.
   • Choose a Case Status.
4. From the results, choose a specific support case and click the Case ID. The support case is ready to view.

Procedure

1. Complete the instructions from Section 12.2.4, “Viewing Support Cases”

2. In the support case, scroll down to the marked sections to do the following:

   • Attachments: - Attach a local file from the system. Add a file name to make it easier to identify.

     Note

     File names must be less than 80 characters and the maximum file size for attachments uploaded using the web UI is 250 MB. Use FTP for larger files.

   • Case Discussion: - Add any updated information about the case you wish to discuss with Global Support Services. After adding information, click Add Comment.