Changes between Version 6 and Version 7 of Documentation/fSDN/aSwitchImage


Ignore:
Timestamp:
Mar 2, 2013, 9:26:12 PM (12 years ago)
Author:
akoshibe
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • Documentation/fSDN/aSwitchImage

    v6 v7  
    44== Contents ==
    55 [#install I. Installation] [[BR]]
     6  [#src 1.1 from source] [[BR]]
     7  [#bin 1.2 from binaries] [[BR]]
    68 [#run II. Running OVS] [[BR]]
     9  [#init 2.1 initialization] [[BR]]
     10  [#conf 2.2 Configuring OVS] [[BR]]
     11  [#kvm 2.3 OVS with KVM] [[BR]]
     12  [#of 2.4 OVS with OpenFlow] [[BR]]
     13 [#cite III. References] [[BR]]
    714----
    815= I Installation = #install
     
    1017
    1118=== Prerequisites ===
    12 OVS should install/work with relatively little effort on Ubuntu (or perhaps other Linuxes as well). The following installation/operation steps were done on Ubuntu 10.10 through 12.04.
     19OVS should install/work with relatively little effort on Ubuntu (or perhaps other Linuxes as well). The following installation/operation steps were successfully done on Ubuntu 10.10 through 12.04.
    1320
    1421== 1.1 Method 1: from source == #src
     
    4047    }}}
    4148
    42 === 1.2.2 Some Sanity Checks. ===
     49=== 1.1.2 Some Sanity Checks. ===
    4350If things don't go well, here are some things worth checking:
    4451
     
    7481 * In general, `dmesg` can be used to check for various anomalies when things e.g. insmod fail silently. 
    7582
    76 == 1.3 Method 2: from binaries == #bin
     83== 1.2 Method 2: from binaries == #bin
    7784Binaries are easier to set up, but lag in OVS version and support a narrower range of architectures and kernel versions.
    7885 1. Install the openvswitch packages. Do not use the Ubuntu repositories since the install the incorrect versions of the package; Download the
    79     packages that match your kernel version from [http://openvswitch.org/releases/binaries/1.2.2.10448/natty_amd64/ here] [[BR]]
     86    packages that match your kernel version from [http://openvswitch.org/releases/binaries/1.2.2.10448/ here] [[BR]]
    8087    For an x86_64 system, the following are needed (The package '''openvswitch-brcompat_1.2.2.10448_amd64.deb''' should be added if bridge compatibility is needed):
    8188    {{{
     
    9299    }}}
    93100    lsmod should also show the running openvswitch_mod.
    94 
    95 == 1.4 Section I References ==
    96 The following links were referenced but aren't relevant overall; this is just for citation.
    97 
    98  * http://www.cyberciti.biz/tips/build-linux-kernel-module-against-installed-kernel-source-tree.html
    99  * http://forums.gentoo.org/viewtopic-t-118180-highlight-bridgeutils.html?sid=4d602c9e364130609caff99aa2a40c69
    100  * https://help.ubuntu.com/community/Kernel/Compile
    101  * http://ubuntuguide.net/ubuntu-11-04-upgrade-linux-kernel-to-2-6-39-0
    102101
    103102----
     
    109108The daemon configures itself using the data provided by the database; `ovs-vsctl` is used to modify the contents of the database in order to configure the OVS switch at runtime.
    110109
    111 == 2.1 Initialization ==
     110== 2.1 Initialization == #init
    112111 1. Load openVswitch kernel module
    113112    {{{
     
    138137 The 'unix:...db.sock' specifies that the process attach to the socket opened by `ovsdb`. 
    139138
    140 == 2.2 Configuring OVS ==
     139== 2.2 Configuring OVS == #conf
    141140Once OVS is running, virtual switches may be created and configured. In general, a virtual switch is comprised of a bridge interface (usually named br''x''), and one or more interfaces associated with it. A single vswitchd can control multiple virtual switches with arbitrary number of ports each.   
    142141 
     
    172171 }}}
    173172
    174 == 2.3 OVS with KVM ==
     173== 2.3 OVS with KVM == #kvm
    175174OVS can be used with KVM. The instructions for setting this up can be found [http://openvswitch.org/cgi-bin/gitweb.cgi?p=openvswitch;a=blob_plain;f=INSTALL.KVM;hb=HEAD here], or in the root directory of the source as INSTALL.KVM. A use case is documented in this separate [http://orbit-lab.org/wiki/Internal/VMHostSetup wiki entry].     
    176175
    177 == 2.4 OVS with !OpenFlow ==
     176== 2.4 OVS with !OpenFlow == #of
    178177OVS switches may be run as !OpenFlow switches. The following steps describe how to run OVS in !OpenFlow mode.
    179178 
     
    210209}}}
    211210Once running, all typical things applicable to an !OpenFlow switch applies to the running OVS switch.
     211
     212----
     213= III References = #cite
     214The following links were referenced but aren't relevant overall; this is just for citation.
     215
     216 * http://www.cyberciti.biz/tips/build-linux-kernel-module-against-installed-kernel-source-tree.html
     217 * http://forums.gentoo.org/viewtopic-t-118180-highlight-bridgeutils.html?sid=4d602c9e364130609caff99aa2a40c69
     218 * https://help.ubuntu.com/community/Kernel/Compile
     219 * http://ubuntuguide.net/ubuntu-11-04-upgrade-linux-kernel-to-2-6-39-0