= Open vSwitch Installation on ProtoGENI hosts =

This page describes how to install Open vSwitch (OVS) on a ProtoGENI host running an Ubuntu image. There are different ways to use OVS within ProtoGENI for example experiments see the [wiki:GENIExperimenter/Tutorials/OpenFlowOVS OpenFlow OVS tutorial], which use the image created with these instructions captured on an Ubuntu 12.04 system: 

 1. Download OVS
   {{{
    wget http://openvswitch.org/releases/openvswitch-1.7.3.tar.gz
    tar xvfz openvswitch-1.7.3.tar.gz
    cd openvswitch-1.7.3
}}}

  2. Follow the instructions at `INSTALL.Linux` file. Install the prerequisets:
     {{{
     sudo apt-get update
     sudo apt-get -y install pkg-config libssl-dev libc-dev
}}}
  3. Compile and install:
     {{{
      ./boot.sh
      ./configure
      make
      sudo make install
}}}
  4. Initialize the configuration database using ovsdb-tool
       {{{
       sudo mkdir -p /usr/local/etc/openvswitch
       sudo ovsdb-tool create /usr/local/etc/openvswitch/conf.db vswitchd/vswitch.ovsschema
}}} 
  5. Startup
      {{{
      sudo ovsdb-server --remote=punix:/usr/local/var/run/openvswitch/db.sock \
                     --remote=db:Open_vSwitch,manager_options \
                     --private-key=db:SSL,private_key \
                     --certificate=db:SSL,certificate \
                     --bootstrap-ca-cert=db:SSL,ca_cert \
                     --pidfile --detach
}}}
      {{{
      sudo ovs-vsctl --no-wait init
      sudo ovs-vswitchd --pidfile --detach
}}}

  6. Your host is now ready to run Open vSwitch.