Disabling recommendations in IoP

guides/common/assembly_monitoring-hosts-by-using-insights-in-project.adoc

@@ -19,6 +19,8 @@ include::modules/proc_examining-recommendations-for-hosts.adoc[leveloffset=+1]
 
 include::modules/proc_remediating-issues-based-on-insights-recommendations.adoc[leveloffset=+1]
 
+include::modules/proc_disabling-and-enabling-recommendations.adoc[leveloffset=+1]
+
 include::modules/proc_examining-vulnerability-of-hosts.adoc[leveloffset=+1]
 
 ifdef::satellite,orcharhino[]

guides/common/modules/proc_disabling-and-enabling-recommendations.adoc

@@ -0,0 +1,37 @@
+:_mod-docs-content-type: PROCEDURE
+
+[id="disabling-and-enabling-recommendations"]
+= Disabling and enabling recommendations
+
+You can disable recommendations per organization or per host.
+{Project} does not show disabled recommendations in dashboards or reports.
+
+.Prerequisites
+* Your {Project} account has a role that grants the `view_advisor` and `edit_advisor` permissions.
+* Ensure an organization and location are selected in the top bar of the {ProjectWebUI}.
+
+.Procedure
+. In the {ProjectWebUI}, navigate to *{Insights}* > *Recommendations*.
+. Disable the recommendation:
+* To disable the recommendation for an organization:
+.. Click the recommendation menu icon next to the recommendation you want to disable.
+.. Select *Disable recommendation*.
+.. Optional: Enter a justification for disabling the recommendation.
+.. Click *Save*.
+* To disable the recommendation for a host:
+.. Click the name of the recommendation to view affected hosts.
+.. Click the host menu icon next to the host for which you want to disable the recommendation.
+.. Select *Disable recommendation for system*.
+.. Optional: Enter a justification for disabling the recommendation.
+.. Click *Save*.
+
+[role="_additional-resources"]
+.Next steps
+* To reenable the recommendation for the organization:
+.. On the *Recommendations* page, filter recommendations to include disabled recommendations.
+.. Click the recommendation menu icon next to the recommendation you want to reenable.
+.. Select *Enable recommendation*.
+* To reenable the recommendation for a host:
+.. On the *Recommendations* page, click the name of the recommendation to view recommendation details.
+.. Under the *Recommendation is disabled for some systems* section, click *View systems*.
+.. Click *Enable* in the row next to the host for which you want to reenable the recommendation.

guides/common/modules/proc_examining-recommendations-for-hosts.adoc

@@ -12,8 +12,15 @@ ifdef::insights-in-cloud[]
 . From the menu next to the *Remediate* button, select *View in {Insights}* to navigate to the recommendations page in the {RHCloud}.
 endif::[]
 ifdef::insights-in-project[]
-. Click the arrow next to the recommendation to expand the recommendation details.
-. Click the name of the recommendation to view affected hosts.
++
+By default, {ProjectWebUI} only displays recommendations enabled for the organization.
+To view disabled recommendations, update the recommendation filter to include disabled recommendations.
+. Click the arrow next to the recommendation to expand it.
+. Click the name of the recommendation to view full details and affected hosts.
++
+If the recommendation is disabled for the organization, you might see the reason for disablement and the date thereof under the *Recommendation is disabled* section.
++
+If the recommendation is disabled for any hosts, you can inspect the reason for disablement and the date thereof under the *Recommendation is disabled for some systems* section, by clicking *View systems*.
 endif::[]
 
 ifdef::insights-in-cloud[]