Bug 2223886

Summary:	Improvisations needed in Red Hat Satellite documentation where puppet is referenced as puppet is by default disabled on Satellite 6.14
Product:	Red Hat Satellite	Reporter:	Jayant Bhatia <jbhatia>
Component:	Puppet	Assignee:	Zuzana Lena Ansorgova <zuansorg>
Status:	RELEASE_PENDING ---	QA Contact:	Satellite QE Team <sat-qe-bz-list>
Severity:	low	Docs Contact:
Priority:	low
Version:	6.14.0	CC:	zuansorg
Target Milestone:	6.14.0	Keywords:	Documentation, Triaged
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:		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:

Description Jayant Bhatia 2023-07-19 07:57:19 UTC

Document URL: 

https://dxp-docp-prod.apps.ext-waf.spoke.prod.us-west-2.aws.paas.redhat.com/documentation/en-us/red_hat_satellite/6.14/html-single/administering_red_hat_satellite/index?lb_target=preview#Monitoring_Puppet_admin


Section Number and Name: 

16.4.3. Monitoring Puppet


Describe the issue:  

With Satellite-6.14, the puppet is by default disabled and there is no service called "puppetserver" running on Satellite and Capsule. The user needs to explicitly enable the puppet service on both Satellite and Capsule if needed. 

(i) The steps mentioned in Section 16.4.3. Monitoring Puppet are not valid because there is no Puppet tab within ' Satellite WebUI -> Infrastructure -> Capsules ' page.

(ii) The steps mentioned in Section 15.2.12. Increasing the Logging Level For Puppet Server are also not valid because there is no service called "puppetserver" running on Satellite or Capsule.


Suggestions for improvement: There should be a NOTE mentioning that the puppet is by default disabled and needs to be manually enabled.


Additional information: The NOTE should also be added to the Section "3.8. Installing and Configuring Puppet Agent Manually" in documentation: https://dxp-docp-prod.apps.ext-waf.spoke.prod.us-west-2.aws.paas.redhat.com/documentation/en-us/red_hat_satellite/6.14/html-single/managing_hosts/index?lb_target=preview#Installing_and_Configuring_Puppet_Agent_Manually_managing-hosts

Comment 5 Zuzana Lena Ansorgova 2023-07-25 17:12:26 UTC

https://github.com/theforeman/foreman-documentation/pull/2308
https://github.com/theforeman/foreman-documentation/pull/2309