From patchwork Fri Apr 26 20:34:27 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ihar Hrachyshka X-Patchwork-Id: 1928391 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@legolas.ozlabs.org Authentication-Results: legolas.ozlabs.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256 header.s=mimecast20190719 header.b=gD12W0bm; dkim-atps=neutral Authentication-Results: legolas.ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=openvswitch.org (client-ip=2605:bc80:3010::137; helo=smtp4.osuosl.org; envelope-from=ovs-dev-bounces@openvswitch.org; receiver=patchwork.ozlabs.org) Received: from smtp4.osuosl.org (smtp4.osuosl.org [IPv6:2605:bc80:3010::137]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (secp384r1) server-digest SHA384) (No client certificate requested) by legolas.ozlabs.org (Postfix) with ESMTPS id 4VR4GC6RxSz23rB for ; Sat, 27 Apr 2024 06:34:43 +1000 (AEST) Received: from localhost (localhost [127.0.0.1]) by smtp4.osuosl.org (Postfix) with ESMTP id 05BB441FDB; Fri, 26 Apr 2024 20:34:42 +0000 (UTC) X-Virus-Scanned: amavis at osuosl.org Received: from smtp4.osuosl.org ([127.0.0.1]) by localhost (smtp4.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP id vMRoPu9mznOP; Fri, 26 Apr 2024 20:34:40 +0000 (UTC) X-Comment: SPF check N/A for local connections - client-ip=2605:bc80:3010:104::8cd3:938; helo=lists.linuxfoundation.org; envelope-from=ovs-dev-bounces@openvswitch.org; receiver= DKIM-Filter: OpenDKIM Filter v2.11.0 smtp4.osuosl.org 4F62741F55 Authentication-Results: smtp4.osuosl.org; dkim=fail reason="signature verification failed" (1024-bit key) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256 header.s=mimecast20190719 header.b=gD12W0bm Received: from lists.linuxfoundation.org (lf-lists.osuosl.org [IPv6:2605:bc80:3010:104::8cd3:938]) by smtp4.osuosl.org (Postfix) with ESMTPS id 4F62741F55; Fri, 26 Apr 2024 20:34:40 +0000 (UTC) Received: from lf-lists.osuosl.org (localhost [127.0.0.1]) by lists.linuxfoundation.org (Postfix) with ESMTP id EDD0FC007C; Fri, 26 Apr 2024 20:34:39 +0000 (UTC) X-Original-To: dev@openvswitch.org Delivered-To: ovs-dev@lists.linuxfoundation.org Received: from smtp1.osuosl.org (smtp1.osuosl.org [IPv6:2605:bc80:3010::138]) by lists.linuxfoundation.org (Postfix) with ESMTP id 15E7AC0037 for ; Fri, 26 Apr 2024 20:34:39 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by smtp1.osuosl.org (Postfix) with ESMTP id 08C97822B3 for ; Fri, 26 Apr 2024 20:34:39 +0000 (UTC) X-Virus-Scanned: amavis at osuosl.org Received: from smtp1.osuosl.org ([127.0.0.1]) by localhost (smtp1.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP id aE4JjuPwARFM for ; Fri, 26 Apr 2024 20:34:38 +0000 (UTC) Received-SPF: Pass (mailfrom) identity=mailfrom; client-ip=170.10.133.124; helo=us-smtp-delivery-124.mimecast.com; envelope-from=ihrachys@redhat.com; receiver= DMARC-Filter: OpenDMARC Filter v1.4.2 smtp1.osuosl.org 430A982287 Authentication-Results: smtp1.osuosl.org; dmarc=pass (p=none dis=none) header.from=redhat.com DKIM-Filter: OpenDKIM Filter v2.11.0 smtp1.osuosl.org 430A982287 Authentication-Results: smtp1.osuosl.org; dkim=pass (1024-bit key) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256 header.s=mimecast20190719 header.b=gD12W0bm Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by smtp1.osuosl.org (Postfix) with ESMTPS id 430A982287 for ; Fri, 26 Apr 2024 20:34:38 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1714163677; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=kPNTpgA6NrEDWI/jESJbjTEsbXOmJvjGMijIUV7tIN0=; b=gD12W0bmTa1Bnsc1L1qHUO5jx3sB/7jl6rYHHzRvaCrehVRvHT0x8GIBpobQNlxn9dLJKy xA/xwBOK3ALYC8n+d+p91ZjVf1knvxObaiwZZpDGgCkzAK4ykAGOS+8LMBezDLSb30xNzr zJu/q07fQD+wX7HA2de3d5VhBGqfXsY= Received: from mail-oi1-f199.google.com (mail-oi1-f199.google.com [209.85.167.199]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-544--vnV-m7WNVS4ZWaFb_Q-4Q-1; Fri, 26 Apr 2024 16:34:35 -0400 X-MC-Unique: -vnV-m7WNVS4ZWaFb_Q-4Q-1 Received: by mail-oi1-f199.google.com with SMTP id 5614622812f47-3c70758104dso3540363b6e.2 for ; Fri, 26 Apr 2024 13:34:35 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1714163674; x=1714768474; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=kPNTpgA6NrEDWI/jESJbjTEsbXOmJvjGMijIUV7tIN0=; b=ea6tztaAcg7Z4cWq307DbO95vklmrp2Mzs8EAfJLty6EOjWTXnx8hpFM6PM1/Zr1aW VvGa7eGn/G422o68S4clDeLn9cu65tDvylB0/VYRRKXhVHupeZNerrgOAwGRCrhtGafJ GRX+EVTB67R9cfzIM1BaXMI5N7jkosEtysQRF1vTsIWsckAab+2snrd1Y1dHAp43YnvI qZUGTUwbtXuYktIXy0Q9FVxBj6UCbl4uCXtf+0QWqWT0PnbUZyiiNhHJpBI62p1aL9I1 Zuif6GgItxzi0CpRZ0nNV6HUscdWi5YJ0BqcNxFXXiiFr+acyRZ8SHYLCde7cxvkKle4 Hesw== X-Gm-Message-State: AOJu0YwznboMU2g0rvOxY1E8q4vyc7gWWWKeCdR/WlT4Qshsx1CvZsDN YUQwL7PdQMVlPipK3BYtbgljBQy7Lgy/6gfyvNHJCsUcYU0ULyzvI5960K9tTa7IdfB33Ds9jtH xt7LLuuLFhcjHVKP5T2H91inPCxM5poehY5q34dcQlORVldvulyhVnXgcSK3CdMSH5Quydk+/xU o+CBwfyNoCugvxpEKorNMXe6wDnfS6cd/ufA== X-Received: by 2002:a05:6808:299:b0:3c7:1786:abab with SMTP id z25-20020a056808029900b003c71786ababmr4486065oic.51.1714163674424; Fri, 26 Apr 2024 13:34:34 -0700 (PDT) X-Google-Smtp-Source: AGHT+IFStQP5Nv1uTy5yED8AEuFXWsek1PRbTjYah4zi52KIJTlbCnjZDAcQ5j1gDremphc00nmXSA== X-Received: by 2002:a05:6808:299:b0:3c7:1786:abab with SMTP id z25-20020a056808029900b003c71786ababmr4486047oic.51.1714163674049; Fri, 26 Apr 2024 13:34:34 -0700 (PDT) Received: from fedora38.localdomain.com ([172.73.180.250]) by smtp.gmail.com with ESMTPSA id m2-20020ae9f202000000b0078d5d9cdc9esm8252463qkg.21.2024.04.26.13.34.31 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 26 Apr 2024 13:34:32 -0700 (PDT) From: Ihar Hrachyshka To: dev@openvswitch.org Date: Fri, 26 Apr 2024 20:34:27 +0000 Message-ID: <20240426203427.955318-1-ihrachys@redhat.com> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Subject: [ovs-dev] [PATCH ovn] docs: Explain nature of ovs dependency. 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 dependency is during build time, not runtime. Signed-off-by: Ihar Hrachyshka Acked-by: Ales Musil --- Documentation/intro/install/ovn-upgrades.rst | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/Documentation/intro/install/ovn-upgrades.rst b/Documentation/intro/install/ovn-upgrades.rst index bb387e2f8..1f99a86ec 100644 --- a/Documentation/intro/install/ovn-upgrades.rst +++ b/Documentation/intro/install/ovn-upgrades.rst @@ -40,13 +40,19 @@ Release Notes You should always check the OVS and OVN release notes (NEWS file) for any release specific notes on upgrades. -OVS ---- +Open vSwitch +------------ -OVN depends on and is included with OVS. It's expected that OVS and OVN are -upgraded together, partly for convenience. OVN is included in OVS releases -so it's easiest to upgrade them together. OVN may also make use of new -features of OVS only available in that release. +OVN compiles with a particular version of Open vSwitch. This is a build-time +dependency. + +In runtime, OVN should be able to work with any reasonably fresh version of +Open vSwitch (not necessarily the version that it was compiled against.) + +OVN may make use of new runtime features of Open vSwitch that are only +available in a particular release. OVN is expected to test for an Open vSwitch +feature presence before using it, and gracefully handle scenarios where Open +vSwitch doesn't support a particular optional feature, yet. Upgrade procedures ------------------