From patchwork Fri Mar 13 22:32:23 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ben Pfaff X-Patchwork-Id: 1254702 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=openvswitch.org (client-ip=140.211.166.133; helo=hemlock.osuosl.org; envelope-from=ovs-dev-bounces@openvswitch.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=ovn.org Received: from hemlock.osuosl.org (smtp2.osuosl.org [140.211.166.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 48fL72245Pz9sPJ for ; Sat, 14 Mar 2020 09:32:46 +1100 (AEDT) Received: from localhost (localhost [127.0.0.1]) by hemlock.osuosl.org (Postfix) with ESMTP id 5651189956; Fri, 13 Mar 2020 22:32:44 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from hemlock.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id felKoKcUKrWJ; Fri, 13 Mar 2020 22:32:42 +0000 (UTC) Received: from lists.linuxfoundation.org (lf-lists.osuosl.org [140.211.9.56]) by hemlock.osuosl.org (Postfix) with ESMTP id 1008689941; Fri, 13 Mar 2020 22:32:42 +0000 (UTC) Received: from lf-lists.osuosl.org (localhost [127.0.0.1]) by lists.linuxfoundation.org (Postfix) with ESMTP id E6243C089F; Fri, 13 Mar 2020 22:32:41 +0000 (UTC) X-Original-To: dev@openvswitch.org Delivered-To: ovs-dev@lists.linuxfoundation.org Received: from silver.osuosl.org (smtp3.osuosl.org [140.211.166.136]) by lists.linuxfoundation.org (Postfix) with ESMTP id 510DDC0177 for ; Fri, 13 Mar 2020 22:32:40 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by silver.osuosl.org (Postfix) with ESMTP id 3AB1823724 for ; Fri, 13 Mar 2020 22:32:40 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from silver.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id zSJIsrSmN6aO for ; Fri, 13 Mar 2020 22:32:38 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from relay5-d.mail.gandi.net (relay5-d.mail.gandi.net [217.70.183.197]) by silver.osuosl.org (Postfix) with ESMTPS id 3B3C2235A6 for ; Fri, 13 Mar 2020 22:32:38 +0000 (UTC) X-Originating-IP: 75.54.222.30 Received: from sigfpe.attlocal.net (75-54-222-30.lightspeed.rdcyca.sbcglobal.net [75.54.222.30]) (Authenticated sender: blp@ovn.org) by relay5-d.mail.gandi.net (Postfix) with ESMTPSA id 2F7BC1C0002; Fri, 13 Mar 2020 22:32:34 +0000 (UTC) From: Ben Pfaff To: dev@openvswitch.org Date: Fri, 13 Mar 2020 15:32:23 -0700 Message-Id: <20200313223227.2914645-2-blp@ovn.org> X-Mailer: git-send-email 2.24.1 In-Reply-To: <20200313223227.2914645-1-blp@ovn.org> References: <20200313223227.2914645-1-blp@ovn.org> MIME-Version: 1.0 Cc: Ben Pfaff Subject: [ovs-dev] [PATCH 1/5] ovn-nb: Consolidate documentation of distributed gateway ports. X-BeenThere: ovs-dev@openvswitch.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: ovs-dev-bounces@openvswitch.org Sender: "dev" The documentation of distributed gateway ports was in two places: one place for the main documentation, another for the options. This puts it all in one place to make it easier to follow. Signed-off-by: Ben Pfaff --- ovn-nb.xml | 192 +++++++++++++++++++++-------------------------------- 1 file changed, 76 insertions(+), 116 deletions(-) diff --git a/ovn-nb.xml b/ovn-nb.xml index ccd9bae991af..e113a9fe3f6a 100644 --- a/ovn-nb.xml +++ b/ovn-nb.xml @@ -2038,8 +2038,9 @@

If any of these are set, this logical router port represents a distributed gateway port that connects this router to a - logical switch with a localnet port. There may be at most one - such logical router port on each logical router. + logical switch with a localnet port. There may + be at most one such logical router port on each logical + router.

@@ -2096,6 +2097,79 @@ Designates the named chassis as the gateway. + + +

+ These options apply only to distributed gateway ports. +

+ + +

+ Ordinarily, routers in OVN are fully distributed. Distributed + gateway ports directs some traffic through the gateway chassis, to + enable NAT and other processing that must be done centrally. + Setting this option to true on a distributed gateway + port directs all traffic to the gateway chassis, even the traffic + that could be handled in a distributed fashion. +

+ +

+ Setting this option to true also has the effect of + sending packets to the gateway chassis over a localnet + port rather than by encapsulating them into a tunnel. Thus, OVN + honors this option only if the peer's logical switch has a + localnet port that represents a VLAN-tagged network. +

+ + + +

+ This options dictates if a packet redirected to the gateway + chassis will be overlay encapsulated or go as a regular + packet via the localnet port: +

+ +
+
overlay
+
+ Redirected packets will be encapsulated using a tunnel port. + This is the default. +
+ +
bridged
+
+ Redirected packets will be sent via the + localnet port tagged with VLAN (if + configured). +
+
+ + + +

+ If set to true, multicast traffic (including reports) + are unconditionally forwarded to the specific port. +

+ +

+ This option applies when the port is part of a logical router which + has :mcast_relay set + to true. +

+ + + + Configures the port binding tunnel key for the port. Usually + this is not needed because ovn-northd will assign an + unique key for each port by itself. However, if it is configured, + ovn-northd honors the configured value. + + + @@ -2193,120 +2267,6 @@ - -

- Additional options for the logical router port. -

- - -

- Generally routing is distributed in OVN. The packet - from a logical port which needs to be routed hits the router pipeline - in the source chassis. For the East-West traffic, the packet is - sent directly to the destination chassis. For the outside traffic - the packet is sent to the gateway chassis. -

- -

- When this option is set, OVN considers this only if -

- -
    -
  • - The logical router to which this logical router port belongs to - has a distributed gateway port. -
    • - -
  • - The peer's logical switch has a localnet port (representing - a VLAN tagged network) -
    • -
- -

- When this option is set to true, then the packet - which needs to be routed hits the router pipeline in the chassis - hosting the distributed gateway router port. The source chassis - pushes out this traffic via the localnet port. With this the - East-West traffic is no more distributed and will always go through - the gateway chassis. -

- -

- Without this option set, for any traffic destined to outside from a - logical port which belongs to a logical switch with localnet port, - the source chassis will send the traffic to the gateway chassis via - the tunnel port instead of the localnet port and this could cause MTU - issues. -

- - - -

- This options dictates if a packet redirected to - gateway chassis will be overlay encapsulated - or go as a regular packet via the localnet port. -

- -

- Option takes following values -

- -
    -
  • - OVERLAY -
    • - -
  • - BRIDGED -
    • -
- -

- OVERLAY option will ensure that redirected packet goes out as - encapsulation via the tunnel port. -

- -

- BRIDGED option will ensure that redirected packet goes out - via the localnet port tagged with vlan (if configured). -

- -

- OVERLAY is the default redirection type. -

- -

- Option is applicable only to gateway chassis attached logical - router ports. -

- - - - -

- If set to true, multicast traffic (including reports) - are unconditionally forwarded to the specific port. -

- -

- This option applies when the port is part of a logical router which - has :mcast_relay set - to true. -

- - - - Configures the port binding tunnel key for the port. Usually - this is not needed because ovn-northd will assign an - unique key for each port by itself. However, if it is configured, - ovn-northd honors the configured value. - - - -

A given router port serves one of two purposes: From patchwork Fri Mar 13 22:32:24 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ben Pfaff X-Patchwork-Id: 1254704 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=openvswitch.org (client-ip=140.211.166.138; helo=whitealder.osuosl.org; envelope-from=ovs-dev-bounces@openvswitch.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=ovn.org Received: from whitealder.osuosl.org (smtp1.osuosl.org [140.211.166.138]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 48fL782M11z9sPF for ; Sat, 14 Mar 2020 09:32:52 +1100 (AEDT) Received: from localhost (localhost [127.0.0.1]) by whitealder.osuosl.org (Postfix) with ESMTP id 89D4D88EA4; Fri, 13 Mar 2020 22:32:50 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from whitealder.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id bCAnj-GBdh8B; Fri, 13 Mar 2020 22:32:46 +0000 (UTC) Received: from lists.linuxfoundation.org (lf-lists.osuosl.org [140.211.9.56]) by whitealder.osuosl.org (Postfix) with ESMTP id 01FF188E60; Fri, 13 Mar 2020 22:32:46 +0000 (UTC) Received: from lf-lists.osuosl.org (localhost [127.0.0.1]) by lists.linuxfoundation.org (Postfix) with ESMTP id B5614C089F; Fri, 13 Mar 2020 22:32:45 +0000 (UTC) X-Original-To: dev@openvswitch.org Delivered-To: ovs-dev@lists.linuxfoundation.org Received: from silver.osuosl.org (smtp3.osuosl.org [140.211.166.136]) by lists.linuxfoundation.org (Postfix) with ESMTP id 6069FC0177 for ; Fri, 13 Mar 2020 22:32:43 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by silver.osuosl.org (Postfix) with ESMTP id 4A6632381E for ; Fri, 13 Mar 2020 22:32:43 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from silver.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id U8Q-3lmaohaf for ; Fri, 13 Mar 2020 22:32:40 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from relay5-d.mail.gandi.net (relay5-d.mail.gandi.net [217.70.183.197]) by silver.osuosl.org (Postfix) with ESMTPS id 9153223724 for ; Fri, 13 Mar 2020 22:32:40 +0000 (UTC) X-Originating-IP: 75.54.222.30 Received: from sigfpe.attlocal.net (75-54-222-30.lightspeed.rdcyca.sbcglobal.net [75.54.222.30]) (Authenticated sender: blp@ovn.org) by relay5-d.mail.gandi.net (Postfix) with ESMTPSA id 4FB501C0004; Fri, 13 Mar 2020 22:32:36 +0000 (UTC) From: Ben Pfaff To: dev@openvswitch.org Date: Fri, 13 Mar 2020 15:32:24 -0700 Message-Id: <20200313223227.2914645-3-blp@ovn.org> X-Mailer: git-send-email 2.24.1 In-Reply-To: <20200313223227.2914645-1-blp@ovn.org> References: <20200313223227.2914645-1-blp@ovn.org> MIME-Version: 1.0 Cc: Han Zhou , Ben Pfaff Subject: [ovs-dev] [PATCH 2/5] ovn-architecture: Correct documentation of localnet ports. X-BeenThere: ovs-dev@openvswitch.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: ovs-dev-bounces@openvswitch.org Sender: "dev" Their LSes can have multiple additional LSPs, not just one. Suggested-by: Han Zhou Signed-off-by: Ben Pfaff --- ovn-architecture.7.xml | 29 ++++++++++++++++++++--------- 1 file changed, 20 insertions(+), 9 deletions(-) diff --git a/ovn-architecture.7.xml b/ovn-architecture.7.xml index 415c895e497f..3e1bb7237b2a 100644 --- a/ovn-architecture.7.xml +++ b/ovn-architecture.7.xml @@ -441,17 +441,28 @@

A localnet logical switch port bridges a logical switch to a - physical VLAN. A logical switch with a localnet LSP should - have only one other LSP. Some kinds of gateways (see Gateways - below) use a logical switch with a router port as the second LSP. On the - other hand, when the second LSP is a VIF, the logical switch is not really - a logical network, since it is bridged to the physical network rather than - insulated from it, and therefore cannot have independent but overlapping IP - address namespaces, etc. (A deployment might nevertheless choose such a - configuration to take advantage of the OVN control plane and features such - as port security and ACLs.) + physical VLAN. Any given logical switch should have no more than one + localnet port. Such a logical switch is used in two + scenarios:

+
    +
  • + With one or more router logical switch ports, to attach L3 + gateway routers and distributed gateways to a physical network. +
    • + +
  • + With one or more VIF logical switch ports, to attach VMs or containers + directly to a physical network. In this case, the logical switch is not + really logical, since it is bridged to the physical network rather than + insulated from it, and therefore cannot have independent but overlapping + IP address namespaces, etc. A deployment might nevertheless choose such + a configuration to take advantage of the OVN control plane and features + such as port security and ACLs. +
    • +
+

A localport logical switch port is a special kind of VIF logical switch port. These ports are present in every chassis, not bound From patchwork Fri Mar 13 22:32:25 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ben Pfaff X-Patchwork-Id: 1254705 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=openvswitch.org (client-ip=140.211.166.133; helo=hemlock.osuosl.org; envelope-from=ovs-dev-bounces@openvswitch.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=ovn.org Received: from hemlock.osuosl.org (smtp2.osuosl.org [140.211.166.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 48fL791cfHz9sPJ for ; Sat, 14 Mar 2020 09:32:53 +1100 (AEDT) Received: from localhost (localhost [127.0.0.1]) by hemlock.osuosl.org (Postfix) with ESMTP id 829C18995C; Fri, 13 Mar 2020 22:32:51 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from hemlock.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id TfGAQ5afn6j5; Fri, 13 Mar 2020 22:32:49 +0000 (UTC) Received: from lists.linuxfoundation.org (lf-lists.osuosl.org [140.211.9.56]) by hemlock.osuosl.org (Postfix) with ESMTP id BD9468995F; Fri, 13 Mar 2020 22:32:49 +0000 (UTC) Received: from lf-lists.osuosl.org (localhost [127.0.0.1]) by lists.linuxfoundation.org (Postfix) with ESMTP id 9F27DC089F; Fri, 13 Mar 2020 22:32:49 +0000 (UTC) X-Original-To: dev@openvswitch.org Delivered-To: ovs-dev@lists.linuxfoundation.org Received: from whitealder.osuosl.org (smtp1.osuosl.org [140.211.166.138]) by lists.linuxfoundation.org (Postfix) with ESMTP id 063DAC0177 for ; Fri, 13 Mar 2020 22:32:48 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by whitealder.osuosl.org (Postfix) with ESMTP id EAD2C88E94 for ; Fri, 13 Mar 2020 22:32:47 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from whitealder.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id R6BXuss97ema for ; Fri, 13 Mar 2020 22:32:45 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from relay5-d.mail.gandi.net (relay5-d.mail.gandi.net [217.70.183.197]) by whitealder.osuosl.org (Postfix) with ESMTPS id B4CAA88E4C for ; Fri, 13 Mar 2020 22:32:42 +0000 (UTC) X-Originating-IP: 75.54.222.30 Received: from sigfpe.attlocal.net (75-54-222-30.lightspeed.rdcyca.sbcglobal.net [75.54.222.30]) (Authenticated sender: blp@ovn.org) by relay5-d.mail.gandi.net (Postfix) with ESMTPSA id BC5F31C0002; Fri, 13 Mar 2020 22:32:39 +0000 (UTC) From: Ben Pfaff To: dev@openvswitch.org Date: Fri, 13 Mar 2020 15:32:25 -0700 Message-Id: <20200313223227.2914645-4-blp@ovn.org> X-Mailer: git-send-email 2.24.1 In-Reply-To: <20200313223227.2914645-1-blp@ovn.org> References: <20200313223227.2914645-1-blp@ovn.org> MIME-Version: 1.0 Cc: Han Zhou , Ben Pfaff Subject: [ovs-dev] [PATCH 3/5] ovn-architecture: Don't imply the wrong thing about NAT. X-BeenThere: ovs-dev@openvswitch.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: ovs-dev-bounces@openvswitch.org Sender: "dev" Suggested-by: Han Zhou Signed-off-by: Ben Pfaff --- ovn-architecture.7.xml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/ovn-architecture.7.xml b/ovn-architecture.7.xml index 3e1bb7237b2a..0dc66c8c07b1 100644 --- a/ovn-architecture.7.xml +++ b/ovn-architecture.7.xml @@ -636,7 +636,8 @@

DNAT and SNAT rules may be associated with a gateway router, which provides a central location that can handle one-to-many SNAT (aka IP - masquerading). + masquerading). Distributed gateway ports, described below, also + support NAT.

Distributed Gateway Ports

From patchwork Fri Mar 13 22:32:26 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ben Pfaff X-Patchwork-Id: 1254706 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=openvswitch.org (client-ip=140.211.166.138; helo=whitealder.osuosl.org; envelope-from=ovs-dev-bounces@openvswitch.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=ovn.org Received: from whitealder.osuosl.org (smtp1.osuosl.org [140.211.166.138]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 48fL7J3tsFz9sPF for ; Sat, 14 Mar 2020 09:33:00 +1100 (AEDT) Received: from localhost (localhost [127.0.0.1]) by whitealder.osuosl.org (Postfix) with ESMTP id BF6E388F11; Fri, 13 Mar 2020 22:32:58 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from whitealder.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id ED3zzzbc7DoS; Fri, 13 Mar 2020 22:32:55 +0000 (UTC) Received: from lists.linuxfoundation.org (lf-lists.osuosl.org [140.211.9.56]) by whitealder.osuosl.org (Postfix) with ESMTP id 0D14388EBA; Fri, 13 Mar 2020 22:32:50 +0000 (UTC) Received: from lf-lists.osuosl.org (localhost [127.0.0.1]) by lists.linuxfoundation.org (Postfix) with ESMTP id B7DC6C1D93; Fri, 13 Mar 2020 22:32:50 +0000 (UTC) X-Original-To: dev@openvswitch.org Delivered-To: ovs-dev@lists.linuxfoundation.org Received: from silver.osuosl.org (smtp3.osuosl.org [140.211.166.136]) by lists.linuxfoundation.org (Postfix) with ESMTP id 03093C089F for ; Fri, 13 Mar 2020 22:32:48 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by silver.osuosl.org (Postfix) with ESMTP id E6D80235A6 for ; Fri, 13 Mar 2020 22:32:47 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from silver.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id mlLjev+lM-WS for ; Fri, 13 Mar 2020 22:32:45 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from relay5-d.mail.gandi.net (relay5-d.mail.gandi.net [217.70.183.197]) by silver.osuosl.org (Postfix) with ESMTPS id 0D56C23E84 for ; Fri, 13 Mar 2020 22:32:44 +0000 (UTC) X-Originating-IP: 75.54.222.30 Received: from sigfpe.attlocal.net (75-54-222-30.lightspeed.rdcyca.sbcglobal.net [75.54.222.30]) (Authenticated sender: blp@ovn.org) by relay5-d.mail.gandi.net (Postfix) with ESMTPSA id 479D21C0003; Fri, 13 Mar 2020 22:32:41 +0000 (UTC) From: Ben Pfaff To: dev@openvswitch.org Date: Fri, 13 Mar 2020 15:32:26 -0700 Message-Id: <20200313223227.2914645-5-blp@ovn.org> X-Mailer: git-send-email 2.24.1 In-Reply-To: <20200313223227.2914645-1-blp@ovn.org> References: <20200313223227.2914645-1-blp@ovn.org> MIME-Version: 1.0 Cc: Han Zhou , Ben Pfaff Subject: [ovs-dev] [PATCH 4/5] ovn-architecture: Distributed gateway ports can interconnect OVNs. X-BeenThere: ovs-dev@openvswitch.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: ovs-dev-bounces@openvswitch.org Sender: "dev" Also, reduce redundancy. Suggested-by: Han Zhou Signed-off-by: Ben Pfaff --- ovn-architecture.7.xml | 29 +++++++++++------------------ 1 file changed, 11 insertions(+), 18 deletions(-) diff --git a/ovn-architecture.7.xml b/ovn-architecture.7.xml index 0dc66c8c07b1..450b40ab7a8b 100644 --- a/ovn-architecture.7.xml +++ b/ovn-architecture.7.xml @@ -643,14 +643,15 @@

Distributed Gateway Ports

- A distributed gateway port is a logical router port - that is specially configured to designate one distinguished - chassis, called the gateway chassis, for centralized - processing. A distributed gateway port should connect to a - logical switch with a localnet port. Packets to and - from the distributed gateway are processed without involving the - gateway chassis when they can be, but when needed they do take - an extra hop through it. + A distributed gateway port is a logical router port that is + specially configured to designate one distinguished chassis, called the + gateway chassis, for centralized processing. A distributed + gateway port should connect to a logical switch that has an LSP that + connects externally, that is, either a localnet LSP or a + connection to another OVN deployment (see OVN Deployments + Interconnection). Packets that traverse the distributed gateway + port are processed without involving the gateway chassis when they can be, + but when needed they do take an extra hop through it.

@@ -1487,16 +1488,8 @@

Distributed Gateway Ports

- Distributed gateway ports are logical router patch ports - that directly connect distributed logical routers to logical - switches with external connection. -

- -

- There are two types of external connections. Firstly, connection to - physical network through a localnet port. Secondly, connection to - another OVN deployment, which will be introduced in section "OVN - Deployments Interconnection". + This section provides additional details on distributed gateway ports, + outlined earlier.

From patchwork Fri Mar 13 22:32:27 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ben Pfaff X-Patchwork-Id: 1254707 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=openvswitch.org (client-ip=140.211.166.138; helo=whitealder.osuosl.org; envelope-from=ovs-dev-bounces@openvswitch.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=ovn.org Received: from whitealder.osuosl.org (smtp1.osuosl.org [140.211.166.138]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 48fL7T5PVTz9sPF for ; Sat, 14 Mar 2020 09:33:09 +1100 (AEDT) Received: from localhost (localhost [127.0.0.1]) by whitealder.osuosl.org (Postfix) with ESMTP id 406AE88E37; Fri, 13 Mar 2020 22:33:08 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from whitealder.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id vhYKuRMZa8Se; Fri, 13 Mar 2020 22:33:01 +0000 (UTC) Received: from lists.linuxfoundation.org (lf-lists.osuosl.org [140.211.9.56]) by whitealder.osuosl.org (Postfix) with ESMTP id C71EB88E4B; Fri, 13 Mar 2020 22:32:53 +0000 (UTC) Received: from lf-lists.osuosl.org (localhost [127.0.0.1]) by lists.linuxfoundation.org (Postfix) with ESMTP id BB558C1D93; Fri, 13 Mar 2020 22:32:53 +0000 (UTC) X-Original-To: dev@openvswitch.org Delivered-To: ovs-dev@lists.linuxfoundation.org Received: from hemlock.osuosl.org (smtp2.osuosl.org [140.211.166.133]) by lists.linuxfoundation.org (Postfix) with ESMTP id 0A262C1D88 for ; Fri, 13 Mar 2020 22:32:49 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by hemlock.osuosl.org (Postfix) with ESMTP id B749289947 for ; Fri, 13 Mar 2020 22:32:48 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from hemlock.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id TSqFWjtIDAAt for ; Fri, 13 Mar 2020 22:32:47 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from relay5-d.mail.gandi.net (relay5-d.mail.gandi.net [217.70.183.197]) by hemlock.osuosl.org (Postfix) with ESMTPS id 574098996B for ; Fri, 13 Mar 2020 22:32:47 +0000 (UTC) X-Originating-IP: 75.54.222.30 Received: from sigfpe.attlocal.net (75-54-222-30.lightspeed.rdcyca.sbcglobal.net [75.54.222.30]) (Authenticated sender: blp@ovn.org) by relay5-d.mail.gandi.net (Postfix) with ESMTPSA id 40A451C0002; Fri, 13 Mar 2020 22:32:43 +0000 (UTC) From: Ben Pfaff To: dev@openvswitch.org Date: Fri, 13 Mar 2020 15:32:27 -0700 Message-Id: <20200313223227.2914645-6-blp@ovn.org> X-Mailer: git-send-email 2.24.1 In-Reply-To: <20200313223227.2914645-1-blp@ovn.org> References: <20200313223227.2914645-1-blp@ovn.org> MIME-Version: 1.0 Cc: Ben Pfaff Subject: [ovs-dev] [PATCH 5/5] docs: Acknowledge in more places that localnet isn't the only option. X-BeenThere: ovs-dev@openvswitch.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: ovs-dev-bounces@openvswitch.org Sender: "dev" Signed-off-by: Ben Pfaff --- ovn-architecture.7.xml | 14 +++++++------- ovn-nb.xml | 6 +++--- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/ovn-architecture.7.xml b/ovn-architecture.7.xml index 450b40ab7a8b..810937ea92cb 100644 --- a/ovn-architecture.7.xml +++ b/ovn-architecture.7.xml @@ -1499,10 +1499,11 @@ the VM or container to the outside world should be processed completely on that VM's or container's hypervisor, eventually traversing a localnet port instance on that hypervisor to the - physical network. Whenever possible, packets from the outside - world to a VM or container should be directed through the physical - network directly to the VM's or container's hypervisor, where the - packet will enter the integration bridge through a localnet port. + physical network or a connection to a different OVN deployment. + Whenever possible, packets from the outside world to a VM or + container should be directed through the physical network directly + to the VM's or container's hypervisor, where the packet will enter + the integration bridge through a localnet port.

@@ -1788,9 +1789,8 @@

- If the logical router doesn't have a distributed gateway port connecting - to the localnet logical switch which provides external connectivity, - then this option is ignored by OVN. + OVN ignores this option if the logical router doesn't have a distributed + gateway port that provides external connectivity.

diff --git a/ovn-nb.xml b/ovn-nb.xml index e113a9fe3f6a..2b0b045ab574 100644 --- a/ovn-nb.xml +++ b/ovn-nb.xml @@ -2038,9 +2038,9 @@

If any of these are set, this logical router port represents a distributed gateway port that connects this router to a - logical switch with a localnet port. There may - be at most one such logical router port on each logical - router. + logical switch with a localnet port or a + connection to another OVN deployment. There may be at most + one such logical router port on each logical router.