Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.
Red Hat Satellite engineering is moving the tracking of its product development work on Satellite to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "Satellite project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs will be migrated starting at the end of May. If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "Satellite project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/SAT-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.

Bug 1455737

Summary: Add a section describing host status types
Product: Red Hat Satellite Reporter: Andrew Dahms <adahms>
Component: Docs Host Configuration GuideAssignee: Sergei Petrosian <spetrosi>
Status: CLOSED CURRENTRELEASE QA Contact: Russell Dickenson <rdickens>
Severity: medium Docs Contact:
Priority: medium    
Version: 6.2.9Keywords: Reopened
Target Milestone: Unspecified   
Target Release: Unused   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-06-12 09:51:10 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Attachments:
Description Flags
Host status type icons
none
Host status type icons none

Description Andrew Dahms 2017-05-26 00:51:44 UTC
Created attachment 1282444 [details]
Host status type icons

A new section must be added to the 'Configuring Hosts' chapter after the 'Browsing Hosts' section that outlines the different host status types and what they mean.

Comment 1 Andrew Dahms 2017-05-26 00:56:50 UTC
There are three main status types -

* Error
  An error has been detected on the host. Click the host to see a more granular
  report of issues. For example, when a host is in error status, the 
  'Configuration', 'Compliance', and 'Subscription' fields appear, and show
  the status of each element.

* Warning
  The host has been configured, but no reports have been collected for that
  host during the last reporting interval.

* Ok
  There are no pending actions on the host, no pending changes, and no errors
  over the last reporting interval.

See the following section of the OSP documentation for some more details of the 'Error' and 'OK' status types, and a basic introduction -

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/5/html-single/Installer_and_Foreman_Guide/index.html#Host_Status_Types

Comment 2 Andrew Dahms 2017-05-26 00:57:17 UTC
Code snippet reference -

      if error?
        # error
        return HostStatus::Global::ERROR
      elsif out_of_sync?
        # out of sync
        return HostStatus::Global::WARN
      elsif no_reports? && (host.configuration? || Setting[:always_show_configuration_status])
        # no reports and configuration is set
        return HostStatus::Global::WARN
      else
        # active, pending, no changes, no reports (or host not setup for configuration)
        return HostStatus::Global::OK
      end

Comment 3 Andrew Dahms 2017-05-26 00:59:16 UTC
Assigning to Sergei for review.

Sergei - another piece in the puzzle for hosts. :)

We can take most of the details from the above, and it would be good to have a table with the icon in the first column, the status type in the second column, and a description of the status type in the third column.

Comment 4 Andrew Dahms 2017-05-26 01:08:11 UTC
Created attachment 1282445 [details]
Host status type icons

Comment 7 Sergei Petrosian 2017-05-29 10:27:36 UTC
These changes are now live on the Custom Portal.
Thank you

Comment 11 Sergei Petrosian 2017-06-12 09:51:10 UTC
Hello,

these changes are now live on the Custom Portal.

Thank you