X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=INSTALL.Linux;h=e950c05197b868ee69fa02ec2796c6f490ce0b43;hb=6e11a6a15519561d932a018b2ca19dc3acee87c2;hp=8ae7aaca72b0d8004c3aa3e091ba08d50185e2c7;hpb=90a249dc93ccabd398b64092121b07e5af2d8c2d;p=openvswitch diff --git a/INSTALL.Linux b/INSTALL.Linux index 8ae7aaca..e950c051 100644 --- a/INSTALL.Linux +++ b/INSTALL.Linux @@ -20,6 +20,8 @@ you will need the following software: - The GNU C compiler. We generally test with version 4.1, 4.2, or 4.3. + - pkg-config. We test with version 0.22. + - libssl, from OpenSSL, is optional but recommended if you plan to connect the Open vSwitch to an OpenFlow controller. libssl is required to establish confidentiality and authenticity in the @@ -72,8 +74,6 @@ you will also need the following software: - Automake version 1.10 or later. - - pkg-config. We test with version 0.22. - - Python 2.x, for x >= 4. If you modify the ovsdbmonitor tool, then you will also need the @@ -247,7 +247,8 @@ configuration in the database: --remote=db:Open_vSwitch,managers \ --private-key=db:SSL,private_key \ --certificate=db:SSL,certificate \ - --bootstrap-ca-cert=db:SSL,ca_cert + --bootstrap-ca-cert=db:SSL,ca_cert \ + --pidfile --detach Then initialize the database using ovs-vsctl. This is only necessary the first time after you create the database with @@ -258,7 +259,8 @@ ovsdb-tool (but running it at any time is harmless): Then start the main Open vSwitch daemon, telling it to connect to the same Unix domain socket: - % ovs-vswitchd unix:/usr/local/var/run/openvswitch/db.sock + % ovs-vswitchd unix:/usr/local/var/run/openvswitch/db.sock \ + --pidfile --detach 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 @@ -270,6 +272,33 @@ eth0 and vif1.0 to it: Please refer to ovs-vsctl(8) for more details. +Upgrading +========= + +When you upgrade Open vSwitch from one version to another, you should +also upgrade the database schema: + +1. Stop the Open vSwitch daemons, e.g.: + + % ovs-kill ovsdb-server.pid ovs-vswitchd.pid + +2. Install the new Open vSwitch release. + +3. Upgrade the database, in one of the following two ways: + + - 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". + + - If you want to preserve the contents of your database, back it + up first, then use "ovsdb-tool convert" to upgrade it, e.g.: + + % ovsdb-tool convert /usr/local/etc/ovs-vswitchd.conf.db vswitchd/vswitch.ovsschema + +4. Start the Open vSwitch daemons as described under "Building and + Installing Open vSwitch for Linux" above. + Bug Reporting -------------