docs/user-guide/atrium-user-guide.rst

   1 Atrium User Guide
   2 =================
   3
   4 Overview
   5 --------
   6
   7 Project Atrium is an open source SDN distribution - a vertically
   8 integrated set of open source components which together form a complete
   9 SDN stack. It’s goals are threefold:
  10
  11 -  Close the large integration-gap of the elements that are needed to
  12    build an SDN stack - while there are multiple choices at each layer,
  13    there are missing pieces with poor or no integration.
  14
  15 -  Overcome a massive gap in interoperability - This exists both at the
  16    switch level, where existing products from different vendors have
  17    limited compatibility, making it difficult to connect an arbitrary
  18    switch and controller and at an API level, where its difficult to
  19    write a portable application across multiple controller platforms.
  20
  21 -  Work closely with network operators on deployable use-cases, so that
  22    they could download near production quality code from one location,
  23    and get started with functioning software defined networks on real
  24    hardware.
  25
  26 Architecture
  27 ------------
  28
  29 The key components of Atrium BGP Peering Router Application are as
  30 follows:
  31
  32 -  Data Plane Switch - Data plane switch is the entity that uses flow
  33    table entries installed by BGP Routing Application through SDN
  34    controller. In the simplest form data plane switch with the installed
  35    flows act like a BGP Router.
  36
  37 -  OpenDaylight Controller - OpenDaylight SDN controller has many
  38    utility applications or plugins which are leveraged by the BGP Router
  39    application to manage the control plane information.
  40
  41 -  BGP Routing Application - An application running within the
  42    OpenDaylight runtime environment to handle I-BGP updates.
  43
  44 -  `DIDM <#_didm_user_guide>`__ - DIDM manages the drivers specific to
  45    each data plane switch connected to the controller. The drivers are
  46    created primarily to hide the underlying complexity of the devices
  47    and to expose a uniform API to applications.
  48
  49 -  Flow Objectives API - The driver implementation provides a pipeline
  50    abstraction and exposes Flow Objectives API. This means applications
  51    need to be aware of only the Flow Objectives API without worrying
  52    about the Table IDs or the pipelines.
  53
  54 -  Control Plane Switch - This component is primarily used to connect
  55    the OpenDaylight SDN controller with the Quagga Soft-Router and
  56    establish a path for forwarding E-BGP packets to and from Quagga.
  57
  58 -  Quagga soft router - An open source routing software that handles
  59    E-BGP updates.
  60
  61 Running Atrium
  62 --------------
  63
  64 -  To run the Atrium BGP Routing Application in OpenDaylight
  65    distribution, simply install the ``odl-atrium-all`` feature.
  66
  67    ::
  68
  69        feature:install odl-atrium-all
  70