From patchwork Thu Oct 22 03:54:10 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ben Pfaff X-Patchwork-Id: 1385914 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.137; helo=fraxinus.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 fraxinus.osuosl.org (smtp4.osuosl.org [140.211.166.137]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 4CGtm20m3cz9sSn for ; Thu, 22 Oct 2020 14:54:42 +1100 (AEDT) Received: from localhost (localhost [127.0.0.1]) by fraxinus.osuosl.org (Postfix) with ESMTP id 49E2986992; Thu, 22 Oct 2020 03:54:39 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from fraxinus.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id KNXeNx7euFIN; Thu, 22 Oct 2020 03:54:36 +0000 (UTC) Received: from lists.linuxfoundation.org (lf-lists.osuosl.org [140.211.9.56]) by fraxinus.osuosl.org (Postfix) with ESMTP id EBAF18690E; Thu, 22 Oct 2020 03:54:34 +0000 (UTC) Received: from lf-lists.osuosl.org (localhost [127.0.0.1]) by lists.linuxfoundation.org (Postfix) with ESMTP id 99BC1C1AD6; Thu, 22 Oct 2020 03:54:34 +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 535E1C0052 for ; Thu, 22 Oct 2020 03:54:32 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by silver.osuosl.org (Postfix) with ESMTP id 428EF204DB for ; Thu, 22 Oct 2020 03:54:32 +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 6qH79lBXoD9P for ; Thu, 22 Oct 2020 03:54:31 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from relay1-d.mail.gandi.net (relay1-d.mail.gandi.net [217.70.183.193]) by silver.osuosl.org (Postfix) with ESMTPS id CA888204E2 for ; Thu, 22 Oct 2020 03:54:30 +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 relay1-d.mail.gandi.net (Postfix) with ESMTPSA id 8E3DF240006; Thu, 22 Oct 2020 03:54:28 +0000 (UTC) From: Ben Pfaff To: dev@openvswitch.org Date: Wed, 21 Oct 2020 20:54:10 -0700 Message-Id: <20201022035415.33541-3-blp@ovn.org> X-Mailer: git-send-email 2.26.2 In-Reply-To: <20201022035415.33541-1-blp@ovn.org> References: <20201022035415.33541-1-blp@ovn.org> MIME-Version: 1.0 Cc: Ben Pfaff Subject: [ovs-dev] [PATCH ovn 3/8] ovn-nb: Improve documentation of health checks. 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-nb.xml | 59 +++++++++++++++++++++++++++++++----------------------- 1 file changed, 34 insertions(+), 25 deletions(-) diff --git a/ovn-nb.xml b/ovn-nb.xml index 5a8ac4a0d0e0..27d6d056e508 100644 --- a/ovn-nb.xml +++ b/ovn-nb.xml @@ -1510,36 +1510,45 @@

- - Load balancer health checks associated with this load balancer. - If health check is desired for a vip's endpoints defined in - the - column, then a row in the table - should - be created and referenced here and L4 port should be defined - for the vip and it's endpoints. Health checks are supported only - for IPv4 load balancers. - - - +

- This column is used if load balancer health checks are enabled. - This keeps a mapping of endpoint IP to the logical port name. - The source ip to be used for health checks is also expected to be - defined. The key of the mapping is the endpoint IP and the value - is in the format : port_name:SRC_IP + OVN supports health checks for load balancer endpoints, for IPv4 load + balancers only. When health checks are enabled, the load balancer uses + only healthy endpoints.

- Eg. If there is a VIP entry: - "10.0.0.10:80=10.0.0.4:8080,20.0.0.4:8080", - then the IP to port mappings should be defined as: - "10.0.0.4"="sw0-p1:10.0.0.2" and - "20.0.0.4"="sw1-p1:20.0.0.2". 10.0.0.2 - and 20.0.0.2 will be used by ovn-controller - as source ip when it sends out health check packets. + Suppose that contains a key-value pair + 10.0.0.10:80=10.0.0.4:8080,20.0.0.4:8080. To + enable health checks for this virtual's endpoints, add two key-value + pairs to , with keys + 10.0.0.4 and 20.0.0.4, and add to a reference to a row whose is set to + 10.0.0.10.

- + + + Load balancer health checks associated with this load balancer. + + + +

+ Maps from endpoint IP to a colon-separated pair of logical port name + and source IP, + e.g. port_name:sourc_ip. Health + checks are sent to this port with the specified source IP. +

+ +

+ For example, in the example above, IP to port mappings might be + defined as 10.0.0.4=sw0-p1:10.0.0.2 and + 20.0.0.4=sw1-p1:20.0.0.2, if the values + given were suitable ports and IP addresses. +

+ +