X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=INSTALL.Linux;h=177a9cd13b7d2eb4df426a2f41be5e13949543d7;hb=fb0d597fb64308c60001e3afc9b31eb295dedb6b;hp=652911865a22e6103163967fdae3a3e172866871;hpb=02dd3123a0e312f1d33403e744af52dd6096f12d;p=openvswitch diff --git a/INSTALL.Linux b/INSTALL.Linux index 65291186..177a9cd1 100644 --- a/INSTALL.Linux +++ b/INSTALL.Linux @@ -27,10 +27,6 @@ you will need the following software: connections from an Open vSwitch to an OpenFlow controller. To enable, configure with --enable-ssl=yes. - - 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 @@ -65,7 +61,7 @@ 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.63 or later. + - Autoconf version 2.64 or later. - Automake version 1.10 or later. @@ -84,9 +80,6 @@ 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 @@ -162,23 +155,40 @@ Prerequisites section, follow the procedure below to build. To verify that the modules have been loaded, run "/sbin/lsmod" and check that openvswitch_mod is listed. -Configuration -============= +7. Initialize the configuration database using ovsdb-tool, e.g.: + + % ovsdb-tool create /usr/local/etc/ovs-vswitchd.conf.db vswitchd/vswitch.ovsschema + +Startup +======= + +Before starting ovs-vswitchd itself, you need to start its +configuration database, ovsdb-server. Configure it to use the +database you created during step 7 of installation, above, and to +listen on a Unix domain socket, e.g.: + + % ovsdb-server /usr/local/etc/ovs-vswitchd.conf.db --remote=punix:/usr/local/var/run/openvswitch/db.sock + +Then initialize the database with "ovs-vsctl init". This is only +necessary the first time after you create the database with +ovsdb-tool (but running it at any time is harmless): + + % ovs-vsctl init + +Then start the main Open vSwitch daemon, telling it to connect to the +same Unix domain socket: -Open vSwitch is configured primarily through a configuration file, -whose name is specified on the ovs-vswitchd command line. Please -refer to ovs-vswitchd(8) and ovs-vswitchd.conf(5) for information on -how to start ovs-vswitchd and the syntax of its configuration file, -respectively. + % ovs-vswitchd unix:/usr/local/var/run/openvswitch/db.sock -At runtime, you may make ovs-vswitchd reload its configuration file -and update its configuration accordingly by sending it a SIGHUP -signal. The ovs-appctl utility can also be used to do this: +Now you may use ovs-vsctl to set up bridges and other Open vSwitch +features. For example, to create a bridge named br0 and add ports +eth0 and vif1.0 to it: - % ovs-appctl vswitchd/reload + % ovs-vsctl add-br br0 + % ovs-vsctl add-port br0 eth0 + % ovs-vsctl add-port br0 vif1.0 -In the latter case, ovs-appctl will wait for ovs-vswitchd to finish -reloading before it exits. +Please refer to ovs-vsctl(8) for more details. Bug Reporting -------------