> 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
