Bug 2223048

Summary: Enabling Red Hat Common repository is not required while installing Satellite 6.14 on a virtual machine hosted on Red Hat Virtualization
Product: Red Hat Satellite Reporter: Jayant Bhatia <jbhatia>
Component: RepositoriesAssignee: Aneta Šteflová Petrová <apetrova>
Status: VERIFIED --- QA Contact: Satellite QE Team <sat-qe-bz-list>
Severity: low Docs Contact:
Priority: low    
Version: 6.14.0CC: apetrova, bangelic, jlenz
Target Milestone: 6.14.0Keywords: Documentation, EasyFix, Triaged
Target Release: UnusedFlags: mdolezel: needinfo? (bangelic)
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-15 01:08:40 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/installing_satellite_server_in_a_connected_network_environment/index?lb_target=preview


Section Number and Name: 

3.4. Configuring Repositories

3.4.1. Red Hat Enterprise Linux 8


Describe the issue: 

There is a Note section which says:
~~~~~
Note

If you are installing Satellite Server as a virtual machine hosted on Red Hat Virtualization, you must also enable the Red Hat Common repository, and install Red Hat Virtualization guest agents and drivers. For more information, see Installing the Guest Agents and Drivers on Red Hat Enterprise Linux in the Virtual Machine Management Guide. 
~~~~~

While clicking on the hyperlink "Installing the Guest Agents and Drivers on Red Hat Enterprise Linux" from above Note section, it redirects to a new page: https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.3/html/virtual_machine_management_guide/installing_guest_agents_and_drivers_linux#Installing_the_Guest_Agents_and_Drivers_on_Red_Hat_Enterprise_Linux and in the new page users are asked to enable repository "rhel-8-for-x86_64-appstream-rpms"

"# subscription-manager repos --enable=rhel-8-for-x86_64-appstream-rpms"


Suggestions for improvement: Satellite-6.14 can only be deployed on RHEL-8. The "rhel-8-for-x86_64-appstream-rpms" is already enabled while installing Satellite as part of command mentioned in "3.4.1. Red Hat Enterprise Linux 8" section within same documentation. Adding a Note where users are redirected to "virtual_machine_management_guide" and asking them to enable "rhel-8-for-x86_64-appstream-rpms" repository again does not make sense. As this repository should be already enabled by user beforehand.


Additional information: The mentioned NOTE section should be removed from the Satellite-6.14 documentation as it is valid only for a scenario when Satellite is being deployed on RHEL-6 and RHEL-7 machine which is not a acceptable scenario in Satellite-6.14.

Comment 3 Aneta Šteflová Petrová 2023-07-27 14:41:13 UTC
PR submitted for review: https://github.com/theforeman/foreman-documentation/pull/2314

Comment 4 Aneta Šteflová Petrová 2023-08-09 14:08:33 UTC
PR merged: https://github.com/theforeman/foreman-documentation/pull/2314#issuecomment-1657732927