X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=INSTALL.Linux;h=652911865a22e6103163967fdae3a3e172866871;hb=b89d8339252cd330daca7341bbd76c7316080127;hp=38b0269a1cbc5d08ae9fd4ed45a7436fa81876f3;hpb=3fbe1d307e27ed99528d83cf866c7df497e58b77;p=openvswitch diff --git a/INSTALL.Linux b/INSTALL.Linux index 38b0269a..65291186 100644 --- a/INSTALL.Linux +++ b/INSTALL.Linux @@ -27,8 +27,15 @@ you will need the following software: connections from an Open vSwitch to an OpenFlow controller. To enable, configure with --enable-ssl=yes. -To compile the kernel module (which is required for operation), you -must also install the following: + - libpcre, the Perl Compatible Regular Expression library, is + optional but recommended. Without it, OVSDB will not be able to + validate regular-expression based contraints. + +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 +userspace implementation may also lack some features. Refer to +INSTALL.userspace for more information. - A supported Linux kernel version. Please refer to README for a list of supported versions. @@ -58,12 +65,14 @@ If you are working from a Git tree or snapshot (instead of from a distribution tarball), or if you modify the Open vSwitch build system, you will also need the following software: - - Autoconf version 2.60 or later. + - Autoconf version 2.63 or later. - Automake version 1.10 or later. - pkg-config. We test with version 0.22. + - Python 2.x, for x >= 4. + Installation Requirements ------------------------- @@ -75,6 +84,9 @@ following software: - libssl compatible with the libssl used for build, if OpenSSL was used for the build. + - libpcre compatible with the libpcre used for build, if PCRE was + used for the build. + - The Linux kernel version configured as part of the build. - For optional support of ingress policing, the "tc" program from @@ -92,7 +104,12 @@ Building and Installing Open vSwitch for Linux Once you have installed all the prerequisites listed above in the Base Prerequisites section, follow the procedure below to build. -1. In the top source directory, configure the package by running the +1. If you pulled the sources directly from an Open vSwitch Git tree, + run boot.sh in the top source directory: + + % ./boot.sh + +2. In the top source directory, configure the package by running the configure script. You can usually invoke configure without any arguments: @@ -128,16 +145,16 @@ Prerequisites section, follow the procedure below to build. additional environment variables. For a full list, invoke configure with the --help option. -2. Run make in the top source directory: +3. Run make in the top source directory: % make -3. Become root by running "su" or another program. +4. Become root by running "su" or another program. -4. Run "make install" to install the executables and manpages into the +5. Run "make install" to install the executables and manpages into the running system, by default under /usr/local. -5. If you built kernel modules, you may load them with "insmod", e.g.: +6. If you built kernel modules, you may load them with "insmod", e.g.: % insmod datapath/linux-2.6/openvswitch_mod.ko