Bug 2168207

Summary:	The 'Chapter 2. Creating an Activation Key for Virtual Machines' and 'Chapter 3. Attaching a Host-based Subscription to Hypervisors' within 'Configuring Virtual Machine Subscriptions in Red Hat Satellite' doc is no more valid as Satellite has SCA enabled
Product:	Red Hat Satellite	Reporter:	Jayant Bhatia <jbhatia>
Component:	Documentation	Assignee:	Adam Lazik <alazik>
Documentation sub component:	default	QA Contact:
Status:	CLOSED CURRENTRELEASE	Docs Contact:
Severity:	medium
Priority:	medium	CC:	alazik, bangelic
Version:	6.13.0	Keywords:	Triaged
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:	2023-05-03 21:05:12 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:

Description Jayant Bhatia 2023-02-08 13:03:28 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.13/html-single/configuring_virtual_machine_subscriptions_in_red_hat_satellite/index?lb_target=preview

Section Number and Name:

Chapter 2. Creating an Activation Key for Virtual Machines

Chapter 3. Attaching a Host-based Subscription to Hypervisors

Describe the issue:

Satellite 6.13 has by default SCA enabled on it. If SCA is enabled, then there is no option to add Subscriptions to the Activation Key and to attach subscriptions to the hosts/hypervisors on Content Hosts page. Hence the steps mentioned in above 2 Chapters are not valid since Satellite has SCA enabled.

Suggestions for improvement:

There should be a disclaimer or a note added for both of these chapters which should mention that these chapters/steps are valid only if SCA is disabled on Satellite and Satellite has by default SCA enabled on it.

Additional information: "Chapter 6. Registering Virtual Machines to use a Host-based Subscription" in same documentation is also only valid if SCA is disabled on Satellite. If SCA is enabled, user should always prefer registering client to Satellite using Global Registration feature mentioned in 'Chapter 3. Registering Hosts to Satellite' in 'Managing Hosts' documentation. And not using the subscription-manager command mentioned in "Chapter 6. Registering Virtual Machines to use a Host-based Subscription" as this is a deprecated method.

Comment 2 Adam Lazik 2023-02-15 15:08:03 UTC

Hello!
Taking over this ticket after agreement with Marie Hornickova and Brian Angelica.
Created PR: https://gitlab.cee.redhat.com/satellite-6-documentation/docs-Red_Hat_Satellite_6/-/merge_requests/1659
Currently verifying the documentation changes with SMEs.

Comment 3 Adam Lazik 2023-02-20 17:42:46 UTC

The documentation has been updated:
https://dxp-docp-prod.apps.ext-waf.spoke.prod.us-west-2.aws.paas.redhat.com/documentation/en-us/red_hat_satellite/6.13/html-single/configuring_virtual_machine_subscriptions_in_red_hat_satellite/index?lb_target=preview#creating-an-activation-key-for-virtual-machines_vm-subs-satellite
https://dxp-docp-prod.apps.ext-waf.spoke.prod.us-west-2.aws.paas.redhat.com/documentation/en-us/red_hat_satellite/6.13/html-single/configuring_virtual_machine_subscriptions_in_red_hat_satellite/index?lb_target=preview#attaching-a-host-based-subscription-to-hypervisors_vm-subs-satellite
https://dxp-docp-prod.apps.ext-waf.spoke.prod.us-west-2.aws.paas.redhat.com/documentation/en-us/red_hat_satellite/6.13/html-single/configuring_virtual_machine_subscriptions_in_red_hat_satellite/index?lb_target=preview#registering-virtual-machines-to-use-a-host-based-subscription_vm-subs-satellite

Comment 4 Jayant Bhatia 2023-02-21 12:42:45 UTC

Thank you Adam! The updated doc looks perfect

Comment 5 Marie Hornickova 2023-05-03 21:05:12 UTC

The documentation for 6.13 is now live on Red Hat Customer Portal:

https://access.redhat.com/documentation/en-us/red_hat_satellite/6.13/html-single/configuring_virtual_machine_subscriptions_in_red_hat_satellite/index#creating-an-activation-key-for-virtual-machines_vm-subs-satellite


https://access.redhat.com/documentation/en-us/red_hat_satellite/6.13/html-single/configuring_virtual_machine_subscriptions_in_red_hat_satellite/index#attaching-a-host-based-subscription-to-hypervisors_vm-subs-satellite


https://access.redhat.com/documentation/en-us/red_hat_satellite/6.13/html-single/configuring_virtual_machine_subscriptions_in_red_hat_satellite/index#registering-virtual-machines-to-use-a-host-based-subscription_vm-subs-satellite