2. Обзор приложений¶

2.2.1. Controller¶

Controller – основное приложение, отвечающие за регистрацию остальных приложений и предоставление им доступ к управления сетью.

ИМЯ : controller

Controller предоставляет два способа управления сетью :

• Реактивный

  Возможность определить функцию обработчик PacketIn’ов.

  Каждое приложение имеет возможность зарегистрировать неограниченное число обработчиков. Они будут вызываться по очереди в соответствии с network-settings.json. Порядок определен в controller { pipeline = [] }.

  Предупреждение

  Каждый обработчик может прервать очередь выполнения. Поэтому важен порядок имен в network-settings.json.

  Для больших подробностей см. PacketMissHandler.

• Проактивный

  Приложению выделяется канал для общения с коммутаторами. Приложения могут отправлять запросы на коммутатор и получать ответы. (См. StaticTransaction).

Настройки :

• address [“0-255.0-255.0-255.0-255”] : ip адрес на котором работает контроллер.
• port [number] : TCP порт, который слушает контроллер, и по которому к нему подключаются коммутаторы.
• nthreads [number] : количество нитей на которых выполняется pipeline.
• secure [true|false] : Использовать TLS для соединения с коммутаторами.

2.2.2. SwitchManager¶

Dependes of : Controller, RestListener.

Приложение предоставляет интерфейс к работе с абстракциями коммутаторов.

ИМЯ : switch-manager. REST ИМЯ : switch-manager. Displaed Name : Switch Manager.

switch-manager управляет объектами Switch, которые являются абстракцией коммутатора. Он позволяет получить объект Switch по dpid, или вектор Switch.

SwitchManager поддерживает Rest интерфейс :

Request : GET /api/switch-manager/switches/all

Reply : Информация о коммутаторах в сети.

SwitchManager поддерживает модель событий :

Коммутатор появился в сети, изменил состояние, исчез.

SwitchManager имеет свою web страницу

Web Страница : http://ControllerIp:8000/switch.html

2.2.3. LinkDiscovery¶

Dependes of : Controller, SwitchManager.

Приложение исследует соединения в сети.

Данное приложение необходимо для поддержания информации о топологии. Периодически отправляя LLDP пакеты, оно следит за состоянием соединений между коммутаторами.

LinkDiscovery работает в ControllerPipeline под именем link-discovery.

Обрабатывает LLDP пакеты и останавливает выполнение конвеера.

Остальные пакеты проходят LinkDiscovery без изменений.

Настройки :

• poll-intervall [number] : Интервал (в секундах) через который отправляются LLDP пакеты.

2.2.4. STP¶

Dependes of : Controller, SwitchManager, LinkDiscovery, Topology

Предотвращает широковещательный шторм в сети, используя логику Spanning Tree протокола.

STP подменяет broadcast правило в конвеере контроллера.

2.2.5. RestListener¶

Dependes of : Controller.

Обеспечивает Rest интерфейс для приложений.

Это приложение необходимо вам, если вы хотите добавить Rest интерфейс к вашему приложению.

ИМЯ : rest-listener.

RestListener позволяет вам зарагестрировать свое приложение c обработкой REST запросов, после которого вы сможете обращаться с запросами к своему приложение по адресу /api/your-application.

По умолчанию RestListener слушает 8000 порт.

Подробнее см. В работе с REST интерфейсом.

RestListener так же реализует модель событий. Подробнее см модель событий.

RestListener поддерживает некоторые встроенные запросы:

• GET /apps # получить список всех приложений, которые поддерживают REST интерфейс

• GET /timeout/<app_lsit>/<last_event>

  Получить события, которые зарегистрировали приложения с некоторого момента.

  • <app_list> = app_1&app_2&...&app_n список приложений, чьи события будут показываться.
  • <last_event> = unsinged integer, номер события, после которого нас интересуют новые события.

Настройки :

• port [number] – порт который слушает RestListener.
• web-dir [path-to-dir] – путь к директории, в которой расположены web страницы приложений.

2.3.1. Topology¶

Dependes of : LinkDiscovery, RestListener.

ИМЯ : topology REST ИМЯ : topology

Представление топологии сети.

Поддерживает REST интерфей:

GET /api/topology/links получить представление сети.

Имеет свою Web страницу : topology.html.

2.3.2. SimpleLearingSwitch¶

Dependes of : Controller.

ИМЯ : simple-learning-switch.

Реализация простого LearningL2Switch, где каждый коммутатор работает независимо от остальных, и содержит свою таблицу mac-port.

SimpleLearningSwitch обеспечивает доставку пакетов до адресатов.

Его основное преимущество, то что он не зависит от остальных приложений.

SimpleLearningSwitch Работает в controller pipeline под именем forwarding.

2.3.3. LearningSwitch¶

Dependes of : Controller, Topology.

ИМЯ : learning-switch.

Реализация усовершенствованного L2Switch, который знает топологию сети и отправляет пакет по кратчайшему пути, он обеспечивает доставку пактов до адресатов.

LearningSwitch работает в controller pipeline под именем forwarding и должен выполняться последним.

2.3.4. SwitchStats¶

Dependes of : Controller, SwitchManager, RestListener.

Собирает статистику с коммутаторов.

ИМЯ : switch-stats.

Настройки :

• poll-interval [number] - период сбора статистики

2.3.5. ArpHandler¶

Dependes of : Controller, SwitchManager, HostManager.

ИМЯ : arp-handler.

ArpHandler обрабатывает arp-request, и если он знает mac-адрес хоста, отправляет arp-reply, если не знает – передает управление дальше по pipeline.

ArpHandler работает в controller pipeline под именем arp-handler.

2.3.6. StaticFlowPusher¶

Dependes of : Controller, SwitchManager, RestListener.

ИМЯ : static-flow-pusher

Статическая установка правил на коммутаторы.

Возможна установка правил через REST интерфейс и из network-settings.json.

REST интерфейс :

POST /api/static-flow-pusher/newflow/<switch_id> {Json of new_flow}

Json поддерживает :

• “in_port”
• eth_src, eth_dst
• eth_type
• ip_src, ip_dst
• out_port

Настройки

В настройках можно описывать правила следующим образом:

"flows" : [
  {
    "dpid": <switch>,
    "flows" : [

      ...

      {
        <set_of_match>
        <set_of_action>
        <set_of_config>
      }

      ...

    ]
  }
]

Где :

• <switch> = “all” или dpid коммутатора в формате “0000000000001”.
• <set_of_match> – Набор строк, указывающие поля пакета.
  • in_port : [number]
  • eth_src : [“ethernet_address”]
  • eth_dst : [“ethernet_address”]
  • ip_src : [“ip adress”]
  • ip_dst : [“ip_adress”]
• <set_of_action> – действия с пакетом :
  • out_port : [number | “to-controller”] – отправить на указанный порт
• <set_of_config> : набор конфигураций потока.
  • priority : [number] – приоритет потока
  • “idle” : [number] – тайм-аут простоя потока
  • “hard” : [number] – тайм-аут потока

2.4.1. REST 2.0¶

2.4.2. REST 1.0 (deprecated)¶