Bug 1836864 - instructions to configure the load balancer for HA setups are incomplete
Summary: instructions to configure the load balancer for HA setups are incomplete
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat CloudForms Management Engine
Classification: Red Hat
Component: Documentation
Version: 5.11.5
Hardware: All
OS: All
high
medium
Target Milestone: GA
: 5.11.7
Assignee: Joan Hoyt
QA Contact: Red Hat CloudForms Documentation
Red Hat CloudForms Documentation
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2020-05-18 11:24 UTC by Felix Dewaleyne
Modified: 2023-10-06 20:05 UTC (History)
7 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2020-07-24 12:33:36 UTC
Category: ---
Cloudforms Team: Documentation
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Bugzilla 1836158 0 high CLOSED the url setting for ui is nil in central region if set to https in a sub region 2023-10-06 20:04:03 UTC
Red Hat Knowledge Base (Solution) 5084941 0 None None None 2020-05-18 11:24:25 UTC

Description Felix Dewaleyne 2020-05-18 11:24:25 UTC
Document URL: https://access.redhat.com/documentation/en-us/red_hat_cloudforms/5.0/html-single/high_availability_guide/index#configuring_HAProxy

Section Number and Name: Chapter 4. Configuring the HAProxy Load Balancer

Describe the issue: There needs to be a section to set on the appliances the advanced configuration setting "url" in the "ui" section



Suggestions for improvement: 
To make sure links to the interface use the load balancer, you can configure the url override in the advance section of each appliance in the region by going to the regional settings, opening zone > appliance > advanced and looking for the url setting under the ui component like so :

:ui:
  :custom_menu: 
  :mark_translated_strings: false
  :display_ops_database: false
  :url: http://loadbalancer.example.com

in this example, replace loadbalancer.example.com by the fullly qualified domain name for your load balancer and it will be used for all links.

Additional information: 
this setting and configuration seems to be shared as a knowledge through emails with consulting and has never been added to the documentation. 

because of bz#1836158 you need to make sure that it is http and not https that is used so I put http instead of https in the example. It shouldn't be too much of a problem, cloudforms redirects http connections to https.

Comment 2 dmetzger 2020-05-21 13:55:18 UTC
Adding needinfo to ensure visibility to the Doc team.

Comment 3 Karie 2020-05-21 20:28:42 UTC
Assigning to Joan Hoyt. She will review and get back with any questions next week.


Note You need to log in before you can comment on or make changes to this bug.