> Do you want to add an INSTALL.FreeBSD or similar file at top level? > Feel free to copy any applicable text from INSTALL.Linux. Or, if you > think it's better, please feel free to edit INSTALL.Linux to include > FreeBSD instructions also, and then we can rename it to just INSTALL.
The combination of INSTALL.Linux and INSTALL.userspace are very close to the installation instructions for FreeBSD, so I think renaming it makes sense - something like the diff below (as well as s/INSTALL.Linux/INSTALL/ throughout the other INSTALL docs). Also it turns out that FreeBSD's make doesn't like the Makefiles, so I just changed it to be explicit about GNU make. --- INSTALL.Linux 2012-07-10 15:11:10.000000000 -0400 +++ INSTALL 2012-07-25 10:57:31.000000000 -0400 @@ -1,9 +1,9 @@ - How to Install Open vSwitch on Linux - ==================================== + How to Install Open vSwitch on Linux and FreeBSD + ================================================ This document describes how to build and install Open vSwitch on a -generic Linux host. If you want to install Open vSwitch on a Citrix -XenServer, see INSTALL.XenServer instead. +generic Linux or FreeBSD host. If you want to install Open vSwitch on +a Citrix XenServer, see INSTALL.XenServer instead. This version of Open vSwitch may be built manually with "configure" and "make", as described below. You may also build Debian packages by @@ -15,7 +15,7 @@ To compile the userspace programs in the Open vSwitch distribution, you will need the following software: - - A make program, e.g. GNU make. BSD make should also work. + - GNU make. - The GNU C compiler. We generally test with version 4.1, 4.2, or 4.3. @@ -29,9 +29,9 @@ libssl is installed, then Open vSwitch will automatically build with support for it. -To compile the kernel module, you must also install the following. If -you cannot build or install the kernel module, you may use the -userspace-only implementation, at a cost in performance. The +To compile the kernel module on Linux, you must also install the +following. If you cannot build or install the kernel module, you may +use the userspace-only implementation, at a cost in performance. The userspace implementation may also lack some features. Refer to INSTALL.userspace for more information. @@ -119,14 +119,14 @@ - libssl compatible with the libssl used for build, if OpenSSL was used for the build. - - The Linux kernel version configured as part of the build. + - On Linux, the same kernel version configured as part of the build. - - For optional support of ingress policing, the "tc" program from - iproute2 (part of all major distributions and available at + - For optional support of ingress policing on Linux, the "tc" program + from iproute2 (part of all major distributions and available at http://www.linux-foundation.org/en/Net:Iproute2). -You should ensure that /dev/urandom exists. To support TAP devices, -you must also ensure that /dev/net/tun exists. +On Linux you should ensure that /dev/urandom exists. To support TAP +devices, you must also ensure that /dev/net/tun exists. To run the ovsdbmonitor tool, the machine must also have the following software: @@ -144,8 +144,8 @@ (On Debian "lenny" the above can be installed with "apt-get install python-json python-qt4 python-zopeinterface python-twisted-conch".) -Building and Installing Open vSwitch for Linux -============================================== +Building and Installing Open vSwitch for Linux or FreeBSD +========================================================= Once you have installed all the prerequisites listed above in the Base Prerequisites section, follow the procedure below to build. @@ -195,6 +195,8 @@ % make + On FreeBSD systems you need to use "gmake" to invoke GNU make. + For improved warnings if you installed "sparse" (see "Prerequisites"), add C=1 to the "make" command line. @@ -322,7 +324,7 @@ - If there is no important data in your database, then you may delete the database file and recreate it with ovsdb-tool, following the instructions under "Building and Installing Open - vSwitch for Linux". + vSwitch for Linux or FreeBSD". - If you want to preserve the contents of your database, back it up first, then use "ovsdb-tool convert" to upgrade it, e.g.: @@ -330,7 +332,7 @@ % ovsdb-tool convert /usr/local/etc/openvswitch/conf.db vswitchd/vswitch.ovsschema 4. Start the Open vSwitch daemons as described under "Building and - Installing Open vSwitch for Linux" above. + Installing Open vSwitch for Linux or FreeBSD" above. Bug Reporting ------------- --- a/INSTALL.userspace +++ b/INSTALL.userspace @@ -17,7 +17,7 @@ Building and Installing ----------------------- The requirements and procedure for building, installing, and -configuring Open vSwitch are the same as those given in INSTALL.Linux. +configuring Open vSwitch are the same as those given in INSTALL. You may omit configuring, building, and installing the kernel module, and the related requirements. @@ -31,6 +31,10 @@ The tun device must also exist as /dev/net/tun. If it does not exist, then create /dev/net (if necessary) with "mkdir /dev/net", then create /dev/net/tun with "mknod /dev/net/tun c 10 200". +On FreeBSD, the userspace switch additionally requires the kernel +tap(4) driver to be available, either built into the kernel or loaded +as a module. + _______________________________________________ dev mailing list dev@openvswitch.org http://openvswitch.org/mailman/listinfo/dev