Bug 1307052 - [docs] fix Edge Load Balancer manual to reflect SDN changes in 3.1.1
Summary: [docs] fix Edge Load Balancer manual to reflect SDN changes in 3.1.1
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Deadline: 2016-05-18
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 3.1.0
Hardware: Unspecified
OS: Unspecified
urgent
urgent
Target Milestone: ---
: ---
Assignee: brice
QA Contact: Ma xiaoqiang
Vikram Goyal
URL: https://access.redhat.com/documentati...
Whiteboard:
Depends On:
Blocks: 1267746
TreeView+ depends on / blocked
 
Reported: 2016-02-12 15:01 UTC by Evgheni Dereveanchin
Modified: 2019-10-10 11:11 UTC (History)
6 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-05-18 08:32:22 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description Evgheni Dereveanchin 2016-02-12 15:01:55 UTC
Document URL: 
 https://access.redhat.com/documentation/en/openshift-enterprise/3.1/installation-and-configuration/chapter-16-routing-from-edge-load-balancers

Section Number and Name: 
 16.3. ESTABLISHING A TUNNEL USING A RAMP NODE
  On the ramp node:
   6. Modify the OVS rules for SNAT:

Describe the issue: 
 In 3.1.1 multitentant and flat SDN plugins were merged, yet documentation still says setting one of these modes during configuration which may result in wrong set of OVS flows being generated on the Ramp node.

Suggestions for improvement: 
 Update list of commands to match the current SDN implementation
Additional information: 
 upstream docs have the same issue
  https://docs.openshift.com/enterprise/3.1/install_config/routing_from_edge_lb.html

Comment 2 Timothy 2016-03-31 05:22:09 UTC
Evgheni,

Looking at this: 

https://docs.openshift.com/enterprise/3.1/install_config/routing_from_edge_lb.html#establishing-a-tunnel-using-a-ramp-node

As I understand it, step 6 "Modify the OVS rules for SNAT" is what needs the update (from the topic linked above), but I'm not sure what that update should be. 

Could you please provide the required update? The priority/severity of this BZ has been escalated to urgent.

Comment 3 Evgheni Dereveanchin 2016-03-31 06:36:12 UTC
In short, before there were two plugins, "sdn" and "multitentant" - so there were specific OVS rules needed only for the "multitentant" plugin. In 3.1.1.6 plugins were merged, so even what was "sdn" now requires all the rules to be in place.

For users who had "sdn" defined that would break the Ramp node as these now required rules would be missing.

Comment 5 Josep 'Pep' Turro Mauri 2016-05-18 08:32:22 UTC
Relevant updates to that section of the documentation were already implemented:

  https://github.com/openshift/openshift-docs/pull/1934
  https://github.com/openshift/openshift-docs/pull/1781

There's one minor additional clean up to complete 1934:

  https://github.com/openshift/openshift-docs/pull/2117

but other than that I believe this has already been addressed, so I'm closing it as currentrelease.

Comment 6 Vikram Goyal 2016-05-18 10:43:23 UTC
Thanks Pep. 

The final updated docs with the changes can be seen here [1].

[1] https://docs.openshift.com/enterprise/3.2/install_config/routing_from_edge_lb.html


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