From patchwork Sat Oct 8 16:30:26 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Finucane X-Patchwork-Id: 679916 X-Patchwork-Delegate: rbryant@redhat.com 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 3srsMW2MHZz9s3T for ; Sun, 9 Oct 2016 03:31:03 +1100 (AEDT) Authentication-Results: ozlabs.org; dkim=fail reason="key not found in DNS" (0-bit key; unprotected) header.d=that.guru header.i=@that.guru header.b=Bf2MjgRR; dkim-atps=neutral Received: from archives.nicira.com (localhost [127.0.0.1]) by archives.nicira.com (Postfix) with ESMTP id 5F3B110A8E; Sat, 8 Oct 2016 09:30:54 -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 0575010A6A for ; Sat, 8 Oct 2016 09:30:53 -0700 (PDT) Received: from bar5.cudamail.com (localhost [127.0.0.1]) by mx1e3.cudamail.com (Postfix) with ESMTPS id 958184207EC for ; Sat, 8 Oct 2016 10:30:52 -0600 (MDT) X-ASG-Debug-ID: 1475944248-09eadd7328023e0001-byXFYA Received: from mx3-pf2.cudamail.com ([192.168.14.1]) by bar5.cudamail.com with ESMTP id txHB1t7ErPvTar2e (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Sat, 08 Oct 2016 10:30:48 -0600 (MDT) X-Barracuda-Envelope-From: stephen@that.guru X-Barracuda-RBL-Trusted-Forwarder: 192.168.14.1 Received: from unknown (HELO butterfly.birch.relay.mailchannels.net) (23.83.209.27) by mx3-pf2.cudamail.com with ESMTPS (DHE-RSA-AES256-SHA encrypted); 8 Oct 2016 16:30:47 -0000 Received-SPF: none (mx3-pf2.cudamail.com: domain at that.guru does not designate permitted sender hosts) X-Barracuda-Apparent-Source-IP: 23.83.209.27 X-Barracuda-RBL-IP: 23.83.209.27 X-Sender-Id: mxroute|x-authuser|stephen@that.guru Received: from relay.mailchannels.net (localhost [127.0.0.1]) by relay.mailchannels.net (Postfix) with ESMTP id 36F201BD37D for ; Sat, 8 Oct 2016 16:30:46 +0000 (UTC) Received: from one.mxroute.com (ip-10-107-69-155.us-west-2.compute.internal [10.107.69.155]) by relay.mailchannels.net (Postfix) with ESMTPA id A8A031BCC69 for ; Sat, 8 Oct 2016 16:30:45 +0000 (UTC) X-Sender-Id: mxroute|x-authuser|stephen@that.guru Received: from one.mxroute.com ([UNAVAILABLE]. [10.135.9.54]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384) by 0.0.0.0:2500 (trex/5.7.8); Sat, 08 Oct 2016 16:30:46 +0000 X-MC-Relay: Neutral X-MailChannels-SenderId: mxroute|x-authuser|stephen@that.guru X-MailChannels-Auth-Id: mxroute X-MC-Loop-Signature: 1475944246020:692550737 X-MC-Ingress-Time: 1475944246020 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=that.guru; s=default; h=References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From: Sender:Reply-To:MIME-Version:Content-Type:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=PP38oMvRx2CQEJ0Y6H8X6DaTcF7YceeteWNhXfuWOSA=; b=Bf2MjgRRWdmOQ1FjthDEE7xrdQ XI9+l1pD7aARAGHdQOVVH7SAQqYhAI9ueDEaCVqML3evt23sn0ePHAoihr79eiGSTetEwVzyTinPW Y7akPlifysdWCDeHd/zVwv64tk/Ie/NMlQJUWzLo+x+UIo4dr1pJuP5UfiRaM4MvU3BS+tA4BlqFH cWItzDkIha4YjGAUsHpTwGQ2WdrWQyqOCuO0DN0iVkJsUtdnnURKmjHYjcb2HM15hHdLMUHWjGRMu Hrd4/Ep7xlEx7rPSX3le7ZcrhErrQSFTM63oF/wS5Kn25LVCE4RwHr+9Gzu5azqvh6Ag63Dm1Y2va fY+0gvEA==; X-CudaMail-Envelope-Sender: stephen@that.guru From: Stephen Finucane To: dev@openvswitch.org X-CudaMail-MID: CM-V2-1007010154 X-CudaMail-DTE: 100816 X-CudaMail-Originating-IP: 23.83.209.27 Date: Sat, 8 Oct 2016 17:30:26 +0100 X-ASG-Orig-Subj: [##CM-V2-1007010154##][PATCH 4/9] doc: Convert INSTALL.Debian to rST Message-Id: <1475944231-25192-5-git-send-email-stephen@that.guru> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1475944231-25192-1-git-send-email-stephen@that.guru> References: <1475944231-25192-1-git-send-email-stephen@that.guru> X-AuthUser: stephen@that.guru X-GBUdb-Analysis: 0, 23.83.209.27, Ugly c=0.303425 p=-0.157895 Source Normal X-MessageSniffer-Rules: 0-0-0-24775-c X-Barracuda-Connect: UNKNOWN[192.168.14.1] X-Barracuda-Start-Time: 1475944248 X-Barracuda-Encrypted: DHE-RSA-AES256-SHA X-Barracuda-URL: https://web.cudamail.com:443/cgi-mod/mark.cgi X-Virus-Scanned: by bsmtpd at cudamail.com X-Barracuda-BRTS-Status: 1 X-Barracuda-Spam-Score: 1.10 X-Barracuda-Spam-Status: No, SCORE=1.10 using global scores of TAG_LEVEL=3.5 QUARANTINE_LEVEL=1000.0 KILL_LEVEL=4.0 tests=BSF_SC0_MV0713, BSF_SC5_MJ1963, DKIM_SIGNED, RDNS_NONE X-Barracuda-Spam-Report: Code version 3.2, rules version 3.2.3.33577 Rule breakdown below pts rule name description ---- ---------------------- -------------------------------------------------- 0.00 DKIM_SIGNED Domain Keys Identified Mail: message has a signature 0.10 RDNS_NONE Delivered to trusted network by a host with no rDNS 0.50 BSF_SC0_MV0713 Custom rule MV0713 0.50 BSF_SC5_MJ1963 Custom Rule MJ1963 Subject: [ovs-dev] [PATCH 4/9] doc: Convert INSTALL.Debian to rST 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" Signed-off-by: Stephen Finucane --- INSTALL.Debian.md | 101 ----------------------------------------- INSTALL.Debian.rst | 117 ++++++++++++++++++++++++++++++++++++++++++++++++ INSTALL.rst | 2 +- Makefile.am | 2 +- README.md | 4 +- vtep/README.ovs-vtep.md | 2 +- 6 files changed, 122 insertions(+), 106 deletions(-) delete mode 100644 INSTALL.Debian.md create mode 100644 INSTALL.Debian.rst diff --git a/INSTALL.Debian.md b/INSTALL.Debian.md deleted file mode 100644 index e8a6392..0000000 --- a/INSTALL.Debian.md +++ /dev/null @@ -1,101 +0,0 @@ -How to Build Debian Packages for Open vSwitch -============================================= - -This document describes how to build Debian packages for Open vSwitch. -To install Open vSwitch on Debian without building Debian packages, -see [INSTALL.rst] instead. - -These instructions should also work on Ubuntu and other Debian -derivative distributions. - - -Before You Begin ----------------- - -Before you begin, consider whether you really need to build packages -yourself. Debian "wheezy" and "sid", as well as recent versions of -Ubuntu, contain pre-built Debian packages for Open vSwitch. It is -easier to install these than to build your own. To use packages from -your distribution, skip ahead to "Installing .deb Packages", below. - - -Building Open vSwitch Debian packages -------------------------------------- - -You may build from an Open vSwitch distribution tarball or from an -Open vSwitch Git tree with these instructions. - -You do not need to be the superuser to build the Debian packages. - -1. Install the "build-essential" and "fakeroot" packages, e.g. with - `apt-get install build-essential fakeroot`. - -2. Obtain and unpack an Open vSwitch source distribution and `cd` into - its top level directory. - -3. Install the build dependencies listed under "Build-Depends:" near - the top of debian/control. You can install these any way you like, - e.g. with `apt-get install`. - - Check your work by running `dpkg-checkbuilddeps` in the top level of - your ovs directory. If you've installed all the dependencies - properly, dpkg-checkbuilddeps will exit without printing anything. - If you forgot to install some dependencies, it will tell you which ones. - -4. Run: - - `fakeroot debian/rules binary` - - This will do a serial build that runs the unit tests. This will take - approximately 8 to 10 minutes. If you prefer, you can run a faster - parallel build, e.g.: - - `DEB_BUILD_OPTIONS='parallel=8' fakeroot debian/rules binary` - - If you are in a big hurry, you can even skip the unit tests: - - `DEB_BUILD_OPTIONS='parallel=8 nocheck' fakeroot debian/rules binary` - - (There are a few pitfalls in the Debian packaging building system - so that, occasionally, you may find that in a tree that you have - using for a while, the build command above exits immediately - without actually building anything. To fix the problem, run - - `fakeroot debian/rules clean` - - or start over from a fresh copy of the source tree.) - -5. The generated .deb files will be in the parent directory of the - Open vSwitch source distribution. - - -Installing .deb Packages ------------------------- - -These instructions apply to installing from Debian packages that you -built yourself, as described in the previous section, or from packages -provided by Debian or a Debian derivative distribution such as Ubuntu. -In the former case, use a command such as `dpkg -i` to install the -.deb files that you build, and in the latter case use a program such -as `apt-get` or `aptitude` to download and install the provided -packages. - -You must be superuser to install Debian packages. - -1. Start by installing an Open vSwitch kernel module. See - debian/openvswitch-switch.README.Debian for the available options. - -2. Install the "openvswitch-switch" and "openvswitch-common" packages. - These packages include the core userspace components of the switch. - -Open vSwitch .deb packages not mentioned above are rarely useful. -Please refer to their individual package descriptions to find out -whether any of them are useful to you. - - -Bug Reporting -------------- - -Please report problems to bugs@openvswitch.org. - -[INSTALL.rst]:INSTALL.rst diff --git a/INSTALL.Debian.rst b/INSTALL.Debian.rst new file mode 100644 index 0000000..a073158 --- /dev/null +++ b/INSTALL.Debian.rst @@ -0,0 +1,117 @@ +.. + Licensed under the Apache License, Version 2.0 (the "License"); you may + not use this file except in compliance with the License. You may obtain + a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, WITHOUT + WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the + License for the specific language governing permissions and limitations + under the License. + + Convention for heading levels in Open vSwitch documentation: + + ======= Heading 0 (reserved for the title in a document) + ------- Heading 1 + ~~~~~~~ Heading 2 + +++++++ Heading 3 + ''''''' Heading 4 + + Avoid deeper levels because they do not render well. + +Building Debian Packages for Open vSwitch +========================================= + +This document describes how to build Debian packages for Open vSwitch. To +install Open vSwitch on Debian without building Debian packages, see the +`installation guide `__ instead. + +.. note:: + These instructions should also work on Ubuntu and other Debian derivative + distributions. + +Before You Begin +---------------- + +Before you begin, consider whether you really need to build packages yourself. +Debian "wheezy" and "sid", as well as recent versions of Ubuntu, contain +pre-built Debian packages for Open vSwitch. It is easier to install these than +to build your own. To use packages from your distribution, skip ahead to +"Installing .deb Packages", below. + +Building Open vSwitch Debian packages +------------------------------------- + +You may build from an Open vSwitch distribution tarball or from an Open vSwitch +Git tree with these instructions. + +You do not need to be the superuser to build the Debian packages. + +1. Install the "build-essential" and "fakeroot" packages. For example::: + + $ apt-get install build-essential fakeroot + +2. Obtain and unpack an Open vSwitch source distribution and ``cd`` into its + top level directory. + +3. Install the build dependencies listed under "Build-Depends:" near the top of + ``debian/control``. You can install these any way you like, e.g. with + ``apt-get install``. + +Check your work by running ``dpkg-checkbuilddeps`` in the top level of your ovs +directory. If you've installed all the dependencies properly, +``dpkg-checkbuilddeps`` will exit without printing anything. If you forgot to +install some dependencies, it will tell you which ones. + +4. Build the package::: + + $ fakeroot debian/rules binary + + This will do a serial build that runs the unit tests. This will take + approximately 8 to 10 minutes. If you prefer, you can run a faster parallel + build::: + + $ DEB_BUILD_OPTIONS='parallel=8' fakeroot debian/rules binary + + If you are in a big hurry, you can even skip the unit tests::: + + $ DEB_BUILD_OPTIONS='parallel=8 nocheck' fakeroot debian/rules binary + +.. note:: + + There are a few pitfalls in the Debian packaging building system so that, + occasionally, you may find that in a tree that you have using for a while, + the build command above exits immediately without actually building anything. + To fix the problem, run::: + + $ fakeroot debian/rules clean + + or start over from a fresh copy of the source tree. + +5. The generated .deb files will be in the parent directory of the Open vSwitch + source distribution. + +Installing .deb Packages +------------------------ + +These instructions apply to installing from Debian packages that you built +yourself, as described in the previous section, or from packages provided by +Debian or a Debian derivative distribution such as Ubuntu. In the former case, +use a command such as ``dpkg -i`` to install the .deb files that you build, and +in the latter case use a program such as ``apt-get`` or ``aptitude`` to +download and install the provided packages. + +.. important:: + You must be superuser to install Debian packages. + +1. Start by installing an Open vSwitch kernel module. See + ``debian/openvswitch-switch.README.Debian`` for the available options. + +2. Install the ``openvswitch-switch`` and ``openvswitch-common`` packages. + These packages include the core userspace components of the switch. + +Open vSwitch ``.deb`` packages not mentioned above are rarely useful. Refer to +their individual package descriptions to find out whether any of them are +useful to you. diff --git a/INSTALL.rst b/INSTALL.rst index 2093d84..612b36d 100644 --- a/INSTALL.rst +++ b/INSTALL.rst @@ -29,7 +29,7 @@ This document describes how to build and install Open vSwitch on a generic Linux, FreeBSD, or NetBSD host. For specifics around installation on a specific platform, refer to one of these installation guides: -- `Debian `__ +- `Debian `__ - `Fedora `__ - `RHEL `__ - `XenServer `__ diff --git a/Makefile.am b/Makefile.am index f10d552..4cd5ece 100644 --- a/Makefile.am +++ b/Makefile.am @@ -71,7 +71,7 @@ docs = \ DESIGN.md \ FAQ.md \ INSTALL.rst \ - INSTALL.Debian.md \ + INSTALL.Debian.rst \ INSTALL.Docker.md \ INSTALL.DPDK-ADVANCED.md \ INSTALL.DPDK.rst \ diff --git a/README.md b/README.md index 2f79833..ff23ee9 100644 --- a/README.md +++ b/README.md @@ -79,7 +79,7 @@ To install Open vSwitch on a regular Linux or FreeBSD host, please read [INSTALL.rst]. For specifics around installation on a specific platform, please see one of these files: -- [INSTALL.Debian.md] +- [INSTALL.Debian.rst] - [INSTALL.Fedora.md] - [INSTALL.RHEL.md] - [INSTALL.XenServer.md] @@ -116,7 +116,7 @@ Contact bugs@openvswitch.org [INSTALL.rst]:INSTALL.rst -[INSTALL.Debian.md]:INSTALL.Debian.md +[INSTALL.Debian.rst]:INSTALL.Debian.rst [INSTALL.Docker.md]:INSTALL.Docker.md [INSTALL.DPDK.rst]:INSTALL.DPDK.rst [INSTALL.Fedora.md]:INSTALL.Fedora.md diff --git a/vtep/README.ovs-vtep.md b/vtep/README.ovs-vtep.md index 13d4e1d..e08c8e6 100644 --- a/vtep/README.ovs-vtep.md +++ b/vtep/README.ovs-vtep.md @@ -15,7 +15,7 @@ can be done by either of the following methods. 1. Follow the instructions in the INSTALL.md file of the Open vSwitch repository (don't start any daemons yet). -2. Follow the instructions in INSTALL.Debian.md file and then install the +2. Follow the instructions in INSTALL.Debian.rst file and then install the "openvswitch-vtep" package (if operating on a debian based machine). This will automatically start the daemons.