ONOS-LISP-Management-Plane

This tool is developed to configure OOR (Open Overay Router, a dataplane implementation of LISP) through NetConf/Yang. Ths tool is working as an application of ONOS SDN controller.

For more information for ONOS, please see the ONOS wiki.

https://wiki.onosproject.org/display/ONOS/Wiki+Home

The implementation of LISP mapping system is already contained on ONOS source tree. You can find out LISP mapping system implementation at org.onosproject.onos-lisp package.

https://github.com/opennetworkinglab/onos/tree/master/protocols/lisp

#Functions

• Connect to OOR device using NetConf/Yang
• Add/remove map resolver on ITR
• Add/remove local database(EID) on ETR
• REST API support
• REST API JSON support to configure multiple locators
• IPv6 support

#Usage through ONOS CLI All commands are excuted on ONOS CLI.

• Connect to OOR device through NetConf

  onos> lisp-connect {username} {password} {address} {port}

  Example) lisp-connect foo bar 192.168.10.1 830

• Get map configured map resolvers of a device

  onos> lisp-get-map-resolver {deviceId}

  Exmaple) lisp-get-map-resolver netconf:192.168.10.1:830

• Add Map resover to the device

  onos> lisp-add-map-resolver {deviceId} {resolver-address}

  Note) deviceId can be referred using ONOS devices command.

  Example) lisp-add-map-resolver netconf:192.168.10.1:830 10.10.10.10

• Remove Map resover to the device

  onos> lisp-remove-map-resolver {deviceId} {resolver-address}

  Example) lisp-remove-map-resolver netconf:192.168.10.1:830 10.10.10.10

• Add local Eid database

  onos> lisp-add-local-eid {deviceId} {EID} {netmask} {RLOC} {Priority} {Weight}

  Example) lisp-add-local-eid netconf:192.168.10.1:830 1.1.1.1 32 192.168.10.1 1 94

• Remove local Eid database

  onos> lisp-remove-local-eid {deviceId} {EID} {netmask} {RLOC} {Priority} {Weight}

  Example) lisp-remove-local-eid netconf:192.168.10.1:830 1.1.1.1 32 192.168.10.1 1 94

• Get configured local db of a device

  onos> lisp-get-local-db {deviceId}

  Exmaple) lisp-get-local-db" netconf:192.168.10.1:830

#Usage through ONOS REST APIs The default web path for rest apis is "/onos/lispconfig". If you are running ONOS in localhost, then, the APIs can called throguh "127.0.0.1:8181/onos/lispconfig/".

To test the app is sucessfully installed, you can try with "127.0.0.1:8181/onos/lispconfig/hello". You will see the following result.

{     
    "AppName": "Lispconfig",    
     "Version": "1.0.0",    
     "Description": "This tool is developed to configure OOR (Open Overay Router, a dataplane implementation of LISP) through NetConf/Yang"    
}    

• Get list of connected OOR devices

  GET onos/lispconfig/devices

  exmaple) 127.0.0.1:8181/onos/lispconfig/devices

• Connect to OOR device through NetConf

  POST onos/lispconfig/devices?username={id}&password={password}&address={address}&port={port}

  exmaple) 127.0.0.1:8181/onos/lispconfig/devices?username=foo&password=bar&address=192.168.10.1&port=830

• Get added map resover from the device

  GET onos/lispconfig/{deviceId}/map-resolver

  exmaple) ```127.0.0.1:8181/onos/lispconfig/netconf:192.168.56.10:830/map-resolver

• Add Map resover to the device

  POST onos/lispconfig/{deviceId}/map-resolver?address={address}

  exmaple) ```127.0.0.1:8181/onos/lispconfig/netconf:192.168.56.10:830/map-resolver?address=10.10.10.10

• Remove Map resover to the device

  DELETE onos/lispconfig/{deviceId}/map-resolver?address={address}

  exmaple) ```127.0.0.1:8181/onos/lispconfig/netconf:192.168.56.10:830/map-resolver?address=10.10.10.10

• Get configured local db of a device

  GET onos/lispconfig/{deviceId}/local-db

  exmaple) 127.0.0.1:8181/onos/lispconfig/netconf:192.168.56.10:830/local-db

• Add local db of a device

  POST onos/lispconfig/{deviceId}/local-db?eid={eid}&eid_mask={eid_mask}&rloc={rloc}&priority={prioriry}&weight={weight}

  exmpale) 127.0.0.1:8181/onos/lispconfig/netconf:192.168.56.10:830/local-db?eid=1.1.1.1&eid_maks=32&rloc=192.168.56.10&priority=1&weight=100

• Remove local db of a device

  DELETE onos/lispconfig/{deviceId}/local-db?eid={eid}&eid_mask={eid_mask}&rloc={rloc}&priority={prioriry}&weight={weight}

  exmpale) 127.0.0.1:8181/onos/lispconfig/netconf:192.168.56.10:830/local-db?eid=1.1.1.1&eid_maks=32&rloc=192.168.56.10&priority=1&weight=100