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

Timestamp:

Oct 18, 2013, 10:50:49 PM (11 years ago)

Author:

ssugrim

Comment:

—

Documentation/fSDN/aSwitchImage

@@ -1 @@
-= Installation and Usage of Open vSwitch =
+== Installation and Usage of Open vSwitch ==
 This page describes how to install and use OpenVSwitch (OVS). OVS is a software switch implementation designed to run on Linux. More information about Open vSwitch can be found at their [http://openvswitch.org/ website]. 
 
-== Contents ==
+=== Contents ===
  [#install I. Installation] [[BR]]
   [#src 1.1 from source] [[BR]]
@@ -13 +13 @@
  [#cite III. References] [[BR]]
 ----
-= I Installation = #install 
+=== I Installation === #install 
 OVS can be installed either from source or from binaries. [#src Section 1.1] covers how to build from source, and [#bin section 1.2] covers install from binaries.   
 
-=== Prerequisites ===
+==== Prerequisites ====
 OVS 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. 
 
-== 1.1 Method 1: from source == #src
+=== 1.1 Method 1: from source === #src
 The steps followed in this section are based on the contents of INSTALL.Linux, included with the OVS tarball and also found [http://openvswitch.org/cgi-bin/gitweb.cgi?p=openvswitch;a=blob_plain;f=INSTALL;hb=HEAD here](also attached at the end of this page for your convenience). It should be found under the OVS root directory.     
 
-== 1.1.1 Getting the source and dependencies ==
+==== 1.1.1 Getting the source and dependencies ====
  1. If your Ubuntu install is still fresh, run 'apt-get update'. If this fails, repeat after replacing all instances of 'apt:9999' with 'us.archive.ubuntu.com' in /etc/apt/sources.list . 
  1. Install dependencies:
@@ -47 +47 @@
     }}}
 
-=== 1.1.2 Some Sanity Checks. ===
+==== 1.1.2 Some Sanity Checks. ====
 If things don't go well, here are some things worth checking: 
 
@@ -81 +81 @@
  * In general, `dmesg` can be used to check for various anomalies when things e.g. insmod fail silently.  
 
-== 1.2 Method 2: from binaries == #bin
+=== 1.2 Method 2: from binaries === #bin
 Binaries are easier to set up, but lag in OVS version and support a narrower range of architectures and kernel versions. 
  1. Install the openvswitch packages. Do not use the Ubuntu repositories since the install the incorrect versions of the package; Download the 
@@ -101 +101 @@
 
 ----
-= II Running OVS. = #run
+=== II Running OVS. === #run
 OVS has three main components that must be initialized:
  * openvswitch_mod.ko, the OVS kernel module 
@@ -108 +108 @@
 The 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.
 
-== 2.1 Initialization == #init
+=== 2.1 Initialization === #init
  1. Load openVswitch kernel module
     {{{
@@ -137 +137 @@
  The 'unix:...db.sock' specifies that the process attach to the socket opened by `ovsdb`.  
 
-== 2.2 Configuring OVS == #conf
+=== 2.2 Configuring OVS === #conf
 Once 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.   
   
-=== 2.2.1 Creating virtual switches ===
+==== 2.2.1 Creating virtual switches ====
 The following steps create a bridge interface (br0) and associate an interface to it:
 {{{ 
@@ -155 +155 @@
  ovs-vsctl add-port br0 eth0.222 tag=222
 }}}
-=== 2.2.2 Network configuration ===
+==== 2.2.2 Network configuration ====
 For an OVS switch to behave as a plain vanilla switch, both bridge interface and associated network interfaces must be up and configured with IP layer information. The bridge interface can be configured with tools such as `ifconfig` (or even DHCP) like any other *nic interface. Its configurations may even be stored in /etc/network/interfaces for persistence:
  {{{
@@ -171 +171 @@
  }}} 
 
-== 2.3 OVS with KVM == #kvm
+=== 2.3 OVS with KVM === #kvm
 OVS 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].     
 
-== 2.4 OVS with !OpenFlow == #of
+=== 2.4 OVS with !OpenFlow === #of
 OVS switches may be run as !OpenFlow switches. The following steps describe how to run OVS in !OpenFlow mode.
  
@@ -211 +211 @@
 
 ----
-= III References = #cite
+== III References == #cite
 The following links were referenced but aren't relevant overall; this is just for citation.