From patchwork Thu Oct 22 03:54:13 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ben Pfaff X-Patchwork-Id: 1385919 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 4CGtm94N1qz9sSn for ; Thu, 22 Oct 2020 14:54:49 +1100 (AEDT) Received: from localhost (localhost [127.0.0.1]) by fraxinus.osuosl.org (Postfix) with ESMTP id 1259386F50; Thu, 22 Oct 2020 03:54:47 +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 SEOS3d5cMWUO; Thu, 22 Oct 2020 03:54:45 +0000 (UTC) Received: from lists.linuxfoundation.org (lf-lists.osuosl.org [140.211.9.56]) by fraxinus.osuosl.org (Postfix) with ESMTP id D096D86D4D; Thu, 22 Oct 2020 03:54:39 +0000 (UTC) Received: from lf-lists.osuosl.org (localhost [127.0.0.1]) by lists.linuxfoundation.org (Postfix) with ESMTP id A3F4BC1ADA; Thu, 22 Oct 2020 03:54:39 +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 12532C08A1 for ; Thu, 22 Oct 2020 03:54:36 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by whitealder.osuosl.org (Postfix) with ESMTP id EC23986C7B for ; Thu, 22 Oct 2020 03:54:35 +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 dB4QZuEhnO83 for ; Thu, 22 Oct 2020 03:54:35 +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 whitealder.osuosl.org (Postfix) with ESMTPS id C53A086C74 for ; Thu, 22 Oct 2020 03:54:34 +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 87932240006; Thu, 22 Oct 2020 03:54:32 +0000 (UTC) From: Ben Pfaff To: dev@openvswitch.org Date: Wed, 21 Oct 2020 20:54:13 -0700 Message-Id: <20201022035415.33541-6-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 6/8] ovn-sb: Update Service_Monitor documentation. 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-sb.xml | 102 +++++++++++++++++++++++++++++------------------------ 1 file changed, 56 insertions(+), 46 deletions(-) diff --git a/ovn-sb.xml b/ovn-sb.xml index cdfca499274d..c78984fc867a 100644 --- a/ovn-sb.xml +++ b/ovn-sb.xml @@ -4033,62 +4033,50 @@ tcp.flags = RST;

- This table montiors a service for its liveliness. The service - can be an IPv4 tcp or a udp service. ovn-controller - periodically sends out service monitor packets and updates the - status of the service. Service monitoring for IPv6 services is - not supported. + Each row in this table configures monitoring a service for its liveness. + The service can be an IPv4 TCP or UDP + service. ovn-controller periodically sends out service + monitor packets and updates the status of the service. Service monitoring + for IPv6 services is not supported.

- - IP of the service to be monitored. Only IPv4 is supported. - - - - The protocol of the service. It can be either tcp or - udp. - - - - The tcp or udp port of the service. - - - - The VIF of logical port on which the service is running. The - ovn-controller which binds this logical_port - monitors the service by sending periodic monitor packets. - +

+ ovn-northd uses this feature to implement the load balancer + health check feature offered to the CMS through the northbound database. +

- +

- The ovn-controller which binds the - logical_port updates the status to online - offline or error. + ovn-northd sets these columns and values to configure the + service monitor.

-

- For tcp service, ovn-controller sends a - TCP SYN packet to the service and expects a - TCP ACK response to consider the service to be - online. -

+ + IP of the service to be monitored. Only IPv4 is supported. + -

- For udp service, ovn-controller sends a udp - packet to the service and doesn't expect any reply. If it receives - ICMP reply, then it considers the service to be offline. -

- + + The protocol of the service. + - - Source Ethernet address to use in the service monitor packet. - + + The TCP or UDP port of the service. + - - Source IPv4 address to use in the service monitor packet. - + + The VIF of the logical port on which the service is running. The + ovn-controller that binds this logical_port + monitors the service by sending periodic monitor packets. + + + + Source Ethernet address to use in the service monitor packet. + + + + Source IPv4 address to use in the service monitor packet. + - The interval, in seconds, between service monitor checks. @@ -4109,6 +4097,28 @@ tcp.flags = RST; + +

+ The ovn-controller on the chassis that hosts the updates this column to report the service's + status. +

+ + +

+ For TCP service, ovn-controller sends a SYN to the + service and expects an ACK response to consider the service to be + online. +

+ +

+ For UDP service, ovn-controller sends a UDP packet to + the service and doesn't expect any reply. If it receives an ICMP + reply, then it considers the service to be offline. +

+ + + See External IDs at the beginning of this document.