Bug 2105995

Summary: Need Proper Registration method in Load-balancing capsule setup for a clients
Product: Red Hat Satellite Reporter: Ganesh Payelkar <gpayelka>
Component: DocumentationAssignee: Sagar Dubewar <sdubewar>
Documentation sub component: default QA Contact:
Status: CLOSED CURRENTRELEASE Docs Contact:
Severity: high    
Priority: unspecified CC: ehelms, sdubewar, vferschm
Version: 6.11.0   
Target Milestone: Unspecified   
Target Release: Unused   
Hardware: x86_64   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2022-08-02 09:13:44 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 Ganesh Payelkar 2022-07-11 13:43:16 UTC 
Document URL: 

https://access.redhat.com/documentation/en-us/red_hat_satellite/6.11/html-single/configuring_capsules_with_a_load_balancer/index#registering-clients-using-the-host-registration

Section Number and Name: 

6.1. Red Hat Satellite host registration

6.2. (Deprecated) Registering Clients Using the Bootstrap Script

6.3. (Deprecated) Registering Clients Manually with katello-ca-consumer rpm


Describe the issue: 
Need Proper Registration method in Load-balancing capsule setup for a clients 

We would like to explore using the methods detailed in Section 6.1 (6.1. Red Hat Satellite host registration) but we can't seem to use our load balancer FQDN in making a successful registration. We tried using the --smart-proxy option and attached the load balancer FQDN as the value for it but it failed. It somehow defaults to being registered directly to the Satellite server.


Suggestions for improvement: 

If the commands or the tools/options are not applicable then we need to remove them from the documentation. 

Even if it is Deprecated but is useful then there has to be a clear instruction that we can use it. 




Additional information:
Comment 3 Eric Helms 2022-07-26 13:51:13 UTC 
To have a proper load-balanced Capsule support documentation for Global Registration method, https://bugzilla.redhat.com/show_bug.cgi?id=1963266 needs to be fixed first.

That being said, for now, we can update the "6.1. Red Hat Satellite host registration" section to include the following command that must be manually performed by the user after hitting the registration API:


subscription-manager config \
  --rhsm.baseurl=https://loadbalancer.example.com/pulp/content \
  --server.hostname=loadbalancer.example.com
Comment 4 Sagar Dubewar 2022-07-27 12:58:47 UTC 
PR created: https://github.com/theforeman/foreman-documentation/pull/1493
Comment 5 Sagar Dubewar 2022-08-02 09:13:44 UTC 
PR merged into master. Here are the published docs links for refernce:
Downstream docs:
https://access.redhat.com/documentation/en-us/red_hat_satellite/6.11/html-single/configuring_capsules_with_a_load_balancer/index#registering-clients-using-the-host-registration

Upstream docs:
https://theforeman-foreman-documentation-preview-pr-1493.surge.sh/nightly/Configuring_Load_Balancer/index-satellite.html#registering-clients-using-the-host-registration

no more updates are pending on this issue, hence closing this one. In case any more updates are required in this issue, feel free to reopen this issue or create a new one.

Thank you :)