From patchwork Thu Jul 7 08:32:11 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Gurucharan Shetty X-Patchwork-Id: 646014 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from archives.nicira.com (archives.nicira.com [96.126.127.54]) by ozlabs.org (Postfix) with ESMTP id 3rlmQX4B62z9sxR for ; Fri, 8 Jul 2016 04:30:44 +1000 (AEST) Received: from archives.nicira.com (localhost [127.0.0.1]) by archives.nicira.com (Postfix) with ESMTP id 6593F1076B; Thu, 7 Jul 2016 11:30:43 -0700 (PDT) X-Original-To: dev@openvswitch.org Delivered-To: dev@openvswitch.org Received: from mx1e3.cudamail.com (mx1.cudamail.com [69.90.118.67]) by archives.nicira.com (Postfix) with ESMTPS id 9E2E010769 for ; Thu, 7 Jul 2016 11:30:41 -0700 (PDT) Received: from bar5.cudamail.com (localhost [127.0.0.1]) by mx1e3.cudamail.com (Postfix) with ESMTPS id 2E46042024A for ; Thu, 7 Jul 2016 12:30:41 -0600 (MDT) X-ASG-Debug-ID: 1467916240-09eadd1b182f16e0001-byXFYA Received: from mx1-pf2.cudamail.com ([192.168.24.2]) by bar5.cudamail.com with ESMTP id m7iZO8wpKG2lHRy8 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Thu, 07 Jul 2016 12:30:40 -0600 (MDT) X-Barracuda-Envelope-From: guru.ovn@gmail.com X-Barracuda-RBL-Trusted-Forwarder: 192.168.24.2 Received: from unknown (HELO mail-pa0-f67.google.com) (209.85.220.67) by mx1-pf2.cudamail.com with ESMTPS (AES128-SHA encrypted); 7 Jul 2016 18:30:40 -0000 Received-SPF: pass (mx1-pf2.cudamail.com: SPF record at _netblocks.google.com designates 209.85.220.67 as permitted sender) X-Barracuda-Apparent-Source-IP: 209.85.220.67 X-Barracuda-RBL-IP: 209.85.220.67 Received: by mail-pa0-f67.google.com with SMTP id ib6so2362920pad.3 for ; Thu, 07 Jul 2016 11:30:40 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=tafgP/OQzVa9n7kWvNS7dY6ueml2BoI3pXXJ5DI1XJA=; b=CNXjht4kCkXQFki26ohnEDYZ57sV3mNDfLWr3zNMnZH/4CK1pPsutTxXVuFt/kvsm+ 741fRY4k4aN4NmXvZu8spJKOTzVxdChWZzXdQgMJqOAELDOFy5KwzXvZG3C7z0g0F/3Q 4LfHasKK2vxKXlIHMXYzmSKNQzefzxpxc2aHwJCm/G056bFuhEkFYMM7JXxxwoSyhGI6 C1/niSIOf3s6/js8G9q2KGPOlMVGvsx+rqRAcGLxtHDoRiSXAK3M2wCZm7ZdFpylxoLL ZVrvq6+hEq6R1fcGgl/Ep9O8T7cYy4yu8HUE9ffOmdK75o+qIM2PZd97eCuqUVRKijl7 pj9Q== X-Gm-Message-State: ALyK8tIHxpziqgIoBAOOV9a0yl16c1k26p5oqcQVVL+xuS7hgulT7IaQiZG1v2ds1jD+Hg== X-Received: by 10.66.86.103 with SMTP id o7mr2694132paz.5.1467916237803; Thu, 07 Jul 2016 11:30:37 -0700 (PDT) Received: from ubuntu.eng.vmware.com ([208.91.1.34]) by smtp.gmail.com with ESMTPSA id i20sm5779199pfj.91.2016.07.07.11.30.36 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Thu, 07 Jul 2016 11:30:36 -0700 (PDT) X-CudaMail-Envelope-Sender: guru.ovn@gmail.com From: Gurucharan Shetty To: dev@openvswitch.org X-CudaMail-Whitelist-To: dev@openvswitch.org X-CudaMail-MID: CM-E2-706052792 X-CudaMail-DTE: 070716 X-CudaMail-Originating-IP: 209.85.220.67 Date: Thu, 7 Jul 2016 01:32:11 -0700 X-ASG-Orig-Subj: [##CM-E2-706052792##][PATCH] INSTALL.Docker.md: Clarify OVS python library path. Message-Id: <1467880331-27941-1-git-send-email-guru@ovn.org> X-Mailer: git-send-email 1.9.1 X-Barracuda-Connect: UNKNOWN[192.168.24.2] X-Barracuda-Start-Time: 1467916240 X-Barracuda-Encrypted: DHE-RSA-AES256-SHA X-Barracuda-URL: https://web.cudamail.com:443/cgi-mod/mark.cgi X-ASG-Whitelist: Header =?UTF-8?B?eFwtY3VkYW1haWxcLXdoaXRlbGlzdFwtdG8=?= X-Virus-Scanned: by bsmtpd at cudamail.com X-Barracuda-BRTS-Status: 1 Subject: [ovs-dev] [PATCH] INSTALL.Docker.md: Clarify OVS python library path. X-BeenThere: dev@openvswitch.org X-Mailman-Version: 2.1.16 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: dev-bounces@openvswitch.org Sender: "dev" Reported-by: Taekho Nam Signed-off-by: Gurucharan Shetty Acked-by: Russell Bryant --- AUTHORS | 1 + INSTALL.Docker.md | 23 +++++++++++++++++++---- 2 files changed, 20 insertions(+), 4 deletions(-) diff --git a/AUTHORS b/AUTHORS index 704ba40..5d86dc6 100644 --- a/AUTHORS +++ b/AUTHORS @@ -432,6 +432,7 @@ Salvatore Cambria salvatore.cambria@citrix.com Soner Sevinc sevincs@vmware.com Stephen Hemminger shemminger@vyatta.com Suganya Ramachandran suganyar@vmware.com +Taekho Nam thnam@smartx.kr Takayuki HAMA t-hama@cb.jp.nec.com Teemu Koponen koponen@nicira.com Thomas Morin thomas.morin@orange.com diff --git a/INSTALL.Docker.md b/INSTALL.Docker.md index fd082cb..4525b44 100644 --- a/INSTALL.Docker.md +++ b/INSTALL.Docker.md @@ -110,10 +110,11 @@ pip install Flask ``` Start the Open vSwitch driver on every host where you plan to create your -containers. +containers. (Please read a note on $OVS_PYTHON_LIBS_PATH that is used below +at the end of this document.) ``` -ovn-docker-overlay-driver --detach +PYTHONPATH=$OVS_PYTHON_LIBS_PATH ovn-docker-overlay-driver --detach ``` Docker has inbuilt primitives that closely match OVN's logical switches @@ -257,10 +258,12 @@ Source the openrc file. e.g.: ``` Start the network driver and provide your OpenStack tenant password -when prompted. +when prompted. (Please read a note on $OVS_PYTHON_LIBS_PATH that is used below +at the end of this document.) ``` -ovn-docker-underlay-driver --bridge breth0 --detach +PYTHONPATH=$OVS_PYTHON_LIBS_PATH ovn-docker-underlay-driver --bridge breth0 \ +--detach ``` From here-on you can use the same Docker commands as described in the @@ -269,6 +272,18 @@ section 'The "overlay" mode'. Please read 'man ovn-architecture' to understand OVN's architecture in detail. +Note on $OVS_PYTHON_LIBS_PATH +============================= + +$OVS_PYTHON_LIBS_PATH should point to the directory where Open vSwitch +python modules are installed. If you installed Open vSwitch python +modules via the debian package of 'python-openvswitch' or via pip by +running 'pip install python-openvswitch', you do not need to specify the +path. If you installed it by following the instructions in INSTALL.md, you +should specify the path. The path in that case depends on the options passed +to ./configure. (It is usually either '/usr/share/openvswitch/python' or +'/usr/local/share/openvswitch/python'.) + [INSTALL.md]: INSTALL.md [openvswitch-switch.README.Debian]: debian/openvswitch-switch.README.Debian [README.RHEL]: rhel/README.RHEL