Document URL: https://access.redhat.com/documentation/en/openshift-enterprise/version-3.0/openshift-enterprise-30-administrator-guide/chapter-14-high-availability Section Number and Name: CHAPTER 14. HIGH AVAILABILITY 14.2.1. Configuring a Highly-available Routing Service 14.2.2. Configuring a Highly-availabile Network Service Describe the issue: --virtual-ips is not described. It proposes a range "10.245.2.101-105" but does not describe if this should be a routable IP, internal IP, node's IP or something else Suggestions for improvement: remove confusion by describing what this IP range can be
This is still an issue in the current docs: 3.3 Onwards: https://access.redhat.com/documentation/en-us/openshift_container_platform/3.3/html-single/cluster_administration/#configuring-a-highly-available-routing-service
Evgheni, Seems there's a section about Virtual IPs from 3.4 onwards: https://docs.openshift.com/container-platform/3.5/admin_guide/high_availability.html#virtual-ips I can backport this into the 3.0 -> 3.3 docs. But in your opinion, is this enough information for this BZ? Would there be anything more information needed? I can also add footnotes to the procedures if you think it's needed. Much like the example in the "Deploy IP Failover Pod" section here: https://docs.openshift.com/container-platform/3.5/admin_guide/high_availability.html#configuring-a-highly-available-service (Scroll down a little). Please let me know if I'm off the mark and it requires more efforts.
Hi Brice, This looks good to me. Feel free to decide if this needs to be backported to older version documentation: it's important for new deployments and those typically use the latest version.
How far back is QE testing these procedures? IMO thats how far back we should backport this.
Eric, I'm not sure if I can answer that question. I can see why the information might be needed though. Meng Bo, do you know if this section of the docs would be tested? Wondering how far back the changes would be needed in the 3.0 -> 3.3 documentation. Thanks!
Hi, the requirements described in 3.5 doc[1] are also available for all old versions of OCP. We can backport it. [1]https://docs.openshift.com/container-platform/3.5/admin_guide/high_availability.html#virtual-ips
OK. I added a section about virtual IPs directly onto the 3.0-3.3 branches. You can see it here: https://github.com/openshift/openshift-docs/blob/enterprise-3.3/admin_guide/high_availability.adoc#virtual-ips (I added the same to all four branches, so I won't link them all.) It's essentially the paragraph from the 3.4 -> Current docs, but I added the environment variable from the table. Evgheni, is there anything more you think is needed for this BZ?
Looks OK to me, thank you for backporting it.
Great! Thanks, Evgheni. I'll move this BZ to complete. Link to released docs: https://access.redhat.com/documentation/en-us/openshift_enterprise/3.1/html-single/cluster_administration/#virtual-ips