From patchwork Sun Oct 30 13:30:04 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Finucane X-Patchwork-Id: 688942 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 3t6JPz4rJZz9t1T for ; Mon, 31 Oct 2016 00:34:47 +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=QCJMBcmU; dkim-atps=neutral Received: from archives.nicira.com (localhost [127.0.0.1]) by archives.nicira.com (Postfix) with ESMTP id 7C875105CD; Sun, 30 Oct 2016 06:34:31 -0700 (PDT) X-Original-To: dev@openvswitch.org Delivered-To: dev@openvswitch.org Received: from mx1e4.cudamail.com (mx1.cudamail.com [69.90.118.67]) by archives.nicira.com (Postfix) with ESMTPS id AD300105DD for ; Sun, 30 Oct 2016 06:34:29 -0700 (PDT) Received: from bar5.cudamail.com (unknown [192.168.21.12]) by mx1e4.cudamail.com (Postfix) with ESMTPS id 3F9571E00C2 for ; Sun, 30 Oct 2016 07:34:29 -0600 (MDT) X-ASG-Debug-ID: 1477834468-09eadd0f98243500001-byXFYA Received: from mx1-pf2.cudamail.com ([192.168.24.2]) by bar5.cudamail.com with ESMTP id EGRBASOF3lGBYAgw (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Sun, 30 Oct 2016 07:34:28 -0600 (MDT) X-Barracuda-Envelope-From: stephen@that.guru X-Barracuda-RBL-Trusted-Forwarder: 192.168.24.2 Received: from unknown (HELO bongo.birch.relay.mailchannels.net) (23.83.209.21) by mx1-pf2.cudamail.com with ESMTPS (DHE-RSA-AES256-SHA encrypted); 30 Oct 2016 13:34:27 -0000 Received-SPF: none (mx1-pf2.cudamail.com: domain at that.guru does not designate permitted sender hosts) X-Barracuda-Apparent-Source-IP: 23.83.209.21 X-Barracuda-RBL-IP: 23.83.209.21 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 A2421100C24 for ; Sun, 30 Oct 2016 13:34:26 +0000 (UTC) Received: from one.mxroute.com (ip-10-27-139-41.us-west-2.compute.internal [10.27.139.41]) by relay.mailchannels.net (Postfix) with ESMTPA id 43707101342 for ; Sun, 30 Oct 2016 13:34:25 +0000 (UTC) X-Sender-Id: mxroute|x-authuser|stephen@that.guru Received: from one.mxroute.com ([UNAVAILABLE]. [10.102.194.57]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384) by 0.0.0.0:2500 (trex/5.7.8); Sun, 30 Oct 2016 13:34:26 +0000 X-MC-Relay: Neutral X-MailChannels-SenderId: mxroute|x-authuser|stephen@that.guru X-MailChannels-Auth-Id: mxroute X-MC-Loop-Signature: 1477834466487:2687779242 X-MC-Ingress-Time: 1477834466486 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=eSAA0T5saG46RnmLwoymXoleSn2TimG+A5WnHh3cSn0=; b=QCJMBcmUxdhzdDf0E6M6tPjYUS WpaOMYAz6teTcR0l29r8+qCTPr2fY5+BsF/iNepnYtwcb5iuNmO0SkWUb8oyMHHZzA2E0kclN2UyY 12Tmr6YaaFsvEQMsxuHY5YK72J6IZtha72herr0gYEo+8iua+gt7nkbSO+IK65T45KKKwlWKTa0+9 lwDK5ztpreFo8Wc3p0CdD3+8tIw5be6I6itbYL+gXmRaSttrc8hL8NUTs3hNKgzb39IkxrCp6B4Je LGrndeK/J0hImo+2UEGES8CkfZnpIehcACyc71uf92vN0fX5HAQy11ON3oMZq2Y1txk51bM9LKhqM VIrxPNEg==; X-CudaMail-Envelope-Sender: stephen@that.guru From: Stephen Finucane To: dev@openvswitch.org X-CudaMail-MID: CM-E2-1029006463 X-CudaMail-DTE: 103016 X-CudaMail-Originating-IP: 23.83.209.21 Date: Sun, 30 Oct 2016 13:30:04 +0000 X-ASG-Orig-Subj: [##CM-E2-1029006463##][PATCH 18/23] doc: Update windows/README Message-Id: <1477834209-11414-19-git-send-email-stephen@that.guru> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1477834209-11414-1-git-send-email-stephen@that.guru> References: <1477834209-11414-1-git-send-email-stephen@that.guru> X-OutGoing-Spam-Status: No, score=-10.0 X-AuthUser: stephen@that.guru X-GBUdb-Analysis: 0, 23.83.209.21, Ugly c=0.142858 p=0 Source Normal X-MessageSniffer-Rules: 0-0-0-10230-c X-Barracuda-Connect: UNKNOWN[192.168.24.2] X-Barracuda-Start-Time: 1477834468 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.34168 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 18/23] doc: Update windows/README 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" This is already in rST (whut?), but we should add a license and make the formatting a little more consistent. Signed-off-by: Stephen Finucane --- windows/README.rst | 72 +++++++++++++++++++++++++++++++++++++----------------- 1 file changed, 50 insertions(+), 22 deletions(-) diff --git a/windows/README.rst b/windows/README.rst index 37fb98d..bdf063a 100644 --- a/windows/README.rst +++ b/windows/README.rst @@ -1,48 +1,76 @@ -Open vSwitch Windows installer -============================== +.. + 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 -This project generates a MSI installer for Open vSwitch on Windows, including -CLI executables, services and the Hyper-V vswitch forwarding extension. + 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. + +============== +Windows README +============== + +This directory contains tooling to generate an MSI installer for Open vSwitch +on Windows, including CLI executables, services and the Hyper-V vswitch +forwarding extension. Requirements ------------ -Visual Studio 2013 community, professional, premium or ultimate edition -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +* Visual Studio 2013 + + Community, Professional, Premium or Ultimate editions can be used. -Visual Studio Community 2013 is freely available at: -https://www.visualstudio.com/en-us/products/visual-studio-community-vs.aspx + Visual Studio Community 2013 is freely available from `visualstudio.com + `__ -WiX Toolset 3.9 -^^^^^^^^^^^^^^^ +* WiX Toolset 3.9 -Download and install from: -http://wixtoolset.org/releases/v3.9/stable + Download and install from `wixtoolset.org + `__ -Microsoft_VC120_CRT_x86.msm -^^^^^^^^^^^^^^^^^^^^^^^^^^^ +* ``Microsoft_VC120_CRT_x86.msm`` -This Windows merge module is available with Visual Studio and contains the -Visual C++ 2013 x86 runtime redistributables files. -Copy the file in the *Redist* directory. + This Windows merge module is available with Visual Studio and contains the + Visual C++ 2013 x86 runtime redistributables files. Copy the file in the + ``Redist`` directory. Open vSwitch installer ---------------------- -The installer will be generated under the following path: -* windows\ovs-windows-installer\bin\Release\OpenvSwitch.msi +The installer will be generated under the following path:: -Note: the kernel driver needs to be signed. + windows\ovs-windows-installer\bin\Release\OpenvSwitch.msi +.. note:: -Build instructions + The kernel driver needs to be signed. + +Build Instructions ------------------ -Build the solution in the Visual Studio IDE or via command line: +Build the solution in the Visual Studio IDE or via command line:: msbuild ovs-windows-installer.sln /p:Platform=x86 /p:Configuration=Release Silent installation ------------------- +:: + msiexec /i OpenvSwitch.msi ADDLOCAL=OpenvSwitchCLI,OpenvSwitchDriver /l*v log.txt