Bug 2166342

Summary:	Document the usage and behavior of "--foreman-proxy-registration-url" option in terms of Load-Balancing Capsule setup
Product:	Red Hat Satellite	Reporter:	Sayan Das <saydas>
Component:	Documentation	Assignee:	Zuzana Lena Ansorgova <zuansorg>
Documentation sub component:	default	QA Contact:
Status:	CLOSED NOTABUG	Docs Contact:
Severity:	medium
Priority:	medium	CC:	zuansorg
Version:	6.13.0
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-02-01 15:39:42 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 Sayan Das 2023-02-01 14:32:23 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_capsules_with_a_load_balancer/index?lb_target=preview

Section Number and Name: 

Chapter 6. Registering Clients ( or somewhere suitable )


Describe the issue: 

https://projects.theforeman.org/issues/35627 has introduced a feature to use LB\HAproxy FQDN during system registration via Global Registration method. 

But we need to ensure that this feature and the introduction of "--foreman-proxy-registration-url" installer option has been properly documented somewhere. 


Suggestions for improvement: 


A) By default --foreman-proxy-registration-url is undefined. Please mention how the value of this parameter should be mentioned. 

http://<LB-FQDN>:9090 or just LB-FQDN

B) Describe how this option works and where the users will need to execute the installer with this option ( i.e. LB capsules only but not satellite if I am not wrong )

C) Optionally mention the relation of this option with the entry of the "Capsules" dropdown in the "Register Hosts" page ( as we know we won't be seeing the entry of LB on that page but it works differently ).



Additional information: 

NA