From patchwork Mon Aug 24 23:05:04 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alin Serdean X-Patchwork-Id: 1350735 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.138; helo=whitealder.osuosl.org; envelope-from=ovs-dev-bounces@openvswitch.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=cloudbasesolutions.com Received: from whitealder.osuosl.org (smtp1.osuosl.org [140.211.166.138]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 4Bb75V25TFz9sTX for ; Tue, 25 Aug 2020 09:05:48 +1000 (AEST) Received: from localhost (localhost [127.0.0.1]) by whitealder.osuosl.org (Postfix) with ESMTP id CCD1F86614; Mon, 24 Aug 2020 23:05:45 +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 sD1bgJ0KovFz; Mon, 24 Aug 2020 23:05:42 +0000 (UTC) Received: from lists.linuxfoundation.org (lf-lists.osuosl.org [140.211.9.56]) by whitealder.osuosl.org (Postfix) with ESMTP id 75C508651E; Mon, 24 Aug 2020 23:05:42 +0000 (UTC) Received: from lf-lists.osuosl.org (localhost [127.0.0.1]) by lists.linuxfoundation.org (Postfix) with ESMTP id 58E7EC016F; Mon, 24 Aug 2020 23:05:42 +0000 (UTC) X-Original-To: dev@openvswitch.org Delivered-To: ovs-dev@lists.linuxfoundation.org Received: from fraxinus.osuosl.org (smtp4.osuosl.org [140.211.166.137]) by lists.linuxfoundation.org (Postfix) with ESMTP id 61D5EC0051 for ; Mon, 24 Aug 2020 23:05:41 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by fraxinus.osuosl.org (Postfix) with ESMTP id 4A25284CF4 for ; Mon, 24 Aug 2020 23:05:41 +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 2PIz1M_bCprd for ; Mon, 24 Aug 2020 23:05:38 +0000 (UTC) X-Greylist: delayed 06:53:47 by SQLgrey-1.7.6 Received: from relay5-d.mail.gandi.net (relay5-d.mail.gandi.net [217.70.183.197]) by fraxinus.osuosl.org (Postfix) with ESMTPS id 1BBCF84D24 for ; Mon, 24 Aug 2020 23:05:34 +0000 (UTC) X-Originating-IP: 89.137.184.67 Received: from localhost.localdomain (unknown [89.137.184.67]) (Authenticated sender: aserdean@ovn.org) by relay5-d.mail.gandi.net (Postfix) with ESMTPSA id BFD191C0003; Mon, 24 Aug 2020 23:05:20 +0000 (UTC) From: Alin Gabriel Serdean To: dev@openvswitch.org Date: Tue, 25 Aug 2020 02:05:04 +0300 Message-Id: <20200824230504.672-1-aserdean@cloudbasesolutions.com> X-Mailer: git-send-email 2.27.0.windows.1 MIME-Version: 1.0 Subject: [ovs-dev] [PATCH] Documentation, windows: Document how to generate the Windows installer 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" This patch adds information on how to generate the Windows installer which can be used to easily deploy the userspace binaries, kernel module and create services on new environments. Signed-off-by: Alin Gabriel Serdean --- Documentation/intro/install/windows.rst | 23 ++++++++++++++++++++--- 1 file changed, 20 insertions(+), 3 deletions(-) diff --git a/Documentation/intro/install/windows.rst b/Documentation/intro/install/windows.rst index 394572f00..e7b97e31c 100644 --- a/Documentation/intro/install/windows.rst +++ b/Documentation/intro/install/windows.rst @@ -71,7 +71,10 @@ The following explains the steps in some detail. You will need at least Visual Studio 2013 (update 4) to compile userspace binaries. In addition to that, if you want to compile the kernel module you - will also need to install Windows Driver Kit (WDK) 8.1 Update. + will also need to install Windows Driver Kit (WDK) 8.1 Update or later. + To generate the Windows installer you need + `WiX Toolset `__ and also be able to build the kernel + module. It is important to get the Visual Studio related environment variables and to have the $PATH inside the bash to point to the proper compiler and linker. @@ -319,6 +322,21 @@ An alternative way to do the same is to run the following command: seconds has been observed for the change to be reflected in the UI. This is not a bug in Open vSwitch. +Generate the Windows installer +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +To generate the Windows installler run the following command from the top source +directory: + +:: + + $ make windows_installer + +.. note:: + This will generate the Windows installer in the following location (relative to + the top source directory): + windows/ovs-windows-installer/bin/Release/OpenvSwitch.msi + Starting -------- @@ -797,5 +815,4 @@ TODO * Investigate and add the feature to provide QoS. -* Sign the driver & create an MSI for installing the different Open vSwitch - components on Windows. +* Sign the driver.