Developing OpenDaylight Apps with MD-SAL. J. Medved, E. Warnicke, A. Tkacik. R. Varga Cisco Sample App: M. Rehak, Cisco February 04, 2014

Transcription

1 Developing OpenDaylight Apps with MD-SAL J. Medved, E. Warnicke, A. Tkacik. R. Varga Cisco Sample App: M. Rehak, Cisco February 04, 2014

2 Controller Architecture Management GUI/CLI D4A Protec3on Network Applica3ons Orchestra3on & Services OpenDaylight APIs (REST) Topology Mgr Stats Mgr Base Network Service Func3ons Switch Mgr FRM Host Tracker ARP Handler Affinity Service LISP Service Controller Pla?orm Service Abstrac3on Layer (SAL) (plug- in mgr., capability abstrac3ons, flow programming, inventory, ) OpenFlow NETCONF OVSDB SNMP BGP PCEP LISP Southbound Interfaces & Protocol Plugins OpenFlow Enabled Devices Open vswitches Addi2onal Virtual & Physical Devices Data Plane Elements (Virtual Switches, Physical Device Interfaces) Example: Service Provider Edi2on

3 Hydrogen Implementation Management GUI/CLI D4A Protec3on REST LISP Service REST Affinity Service REST Topology Mgr REST Base Network Service Func3ons Stats Mgr REST Switch Mgr REST FRM REST Host Tracker REST ARP Handler NETCONF Config Subsystem NSF Adapters NSF Adapters NSF Adapters Stats Mgr Service Func3ons FRM PCEP RESTCONF Base Network Func3ons Topology Exporter Exporter Exporter Inventor Topology Exporter Exporter y Manager API- Driven SAL (AD- SAL) Model- Driven SAL (MD- SAL) OpenFlow 1.0 OVSDB LISP SNMP OpenFlow BGP- LS PCEP NETCONF OpenFlow Enabled Devices Open vswitches Addi2onal Virtual & Physical Devices Example: Service Provider Edi2on

4 MD-SAL Motivation & Requirements Flexibility, but common framework and programming model Support API governance Func2onally equivalent APIs for different language bindings Run- 2me Extensibility: Augment exis2ng func2onality Load new models (extends controller s func2onality) Avoid module/sub- system hotspots Performance & scale

5 From AD-SAL to MD-SAL SB Plugin Model NB Service Model Is generated from Is generated from Controller PlaPorm Controller PlaPorm RESTCONF REST API Service Plugin 1... REST API Service Plugin 1 Service Plugin 1 Adapta3on Plugin Service Plugin 1 Plugin NB Java API Request Rou2ng Plugin SB Java API Service NB Java API Adapta2on AD- SAL Request Rou2ng MD- SAL Modeled SB Java API Modeled Service NB Java API SB Model Data Data Store NB Model Data SB Plugin 1... SB Plugin 2 SB Plugin 1... SB Plugin 2 AD- SAL key services: Request rou2ng Service Adapta2on MD- SAL key services: Request (RPC) and no2fica2on rou2ng Data Storage

6 MD-SAL Key Tenets Summary Modeling language: YANG (rfc6020) Used also as IDL A couple of minor extensions Dynamic late binding Run2me & Compile 2me code genera2on

7 Creating the View of the Network Controller PlaPorm BGP- LS Topology Exporter Model OpenFlow Topology Exporter Model... Sta3s3cs Manager Model Flow- Capable Node Inventory Manager Model /Opera2onal /Config network- topo nodes BGPv4 nodes BGPv6 links BGP- LS prefixes OpenFlow of:1 Groups Tables of:2 Meters... Of:n Ports nc:1 nc:2 n1 n2... n x l1 l2... l x p1 p2... p x Table/1 Table/2 Table/n MD- SAL Table- stats Flow/1 Flow- stats Flow/2... Flow- stats Flow/n BGP- LS Protocol Plugin NETCONF

8 MD-SAL: Software Architecture View Network Devices App... App Network Applica3ons Orchestra3on & Services Data Plane Elements Protocol Plugin Model... Protocol Plugin Model NETCONF Config Subsystem Service/App Plugin Model RESTCONF... Service/App Plugin Model Controller Pla?orm Southbound Interfaces & Protocol Plugins Model- Driven SAL (MD- SAL) Message Bus Data Store Clustering Remote Container Instance Remote Container Instance

9 Building a Plugin/Application Model Model Yang Model Generate APIs 1 Yang Tools Java API Defini2on Java Generated API Defini2on API Defini2on Module Implementa2ons Module Plugin Implementa2ons source code Maven Build Tools Maven Build Tools Create API Bundle 2 API OSGI Bundle Plugin OSGI Bundle 3 Create Plugin Bundle Deploy 4 4 Deploy Controller

10 The Learning Switch Application Inspired by OpenDaylight Applica2on Developers Tutorial: hdp://sdnhub.org/tutorials/opendaylight/ ODL Wiki: TBD. Func2onality: Create a HashMap called mac_to_port On packet_in, Pprse packet to get src and dst MAC address Store in a hashmap mapping between src_mac and in_port Lookup dst_mac in mac_to_port map to find next hop If next hop is found, create flow_mod and send Else, flood like hub.

11 Under the Hood: How it Works Flow- capable Node Model (Flow programming) Controller PlaPorm RESTCONF 3 MD- SAL No2fica2on Delivery The Learning Switch Applica3on 4 Request Rou2ng 5 N 8 Flow 9 /config FRM 10 Request Rou2ng 11 NoBficaBon RPC RPC Openflow Protocol Model (Pkt in,pkt out) 2 OpenFlow 1.0/1.3 Plugin 6 OpenFlow Java Library PktIn PktOut FlowMod 1 Switch

12 Building the Sample Application Prerequisites: Java 7, Maven or later, Linux or Mac Mininet 2.1 with OpenFlow 1.3 virtual switches or CPQD (pointers) OpenDaylight Base Edi2on (download & installa2on instruc2ons) Download the applica2on code from ODL OpenFlow Plugin repo: > git clone Build the applica2on: > cd openflowplugin/samples/learning- switch/ > mvn clean install The build creates the learning- switch SNAPSHOT.jar bundle in openflowplugin/samples/learning- switch/target Analyzing code in Eclipse: Prerequisites: Install maven plugin for Eclipse More informa2on: hdps://wiki.opendaylight.org/view/opendaylight_controller:hydrogen_developer_guide:md- SAL_App_Tutorial

13 Starting the Environment Prequisites: Java 7, Maven or later, on Linux or Mac Mininet 2.1 with OpenFlow 1.3 virtual switches: or CPQD Download OpenDaylight Base Edi2on: hdps://nexus.opendaylight.org/content/ repositories/opendaylight.release/org/opendaylight/integra2on/distribu2ons- base/0.1.1/ Prepare the controller & applica2on: Unzip the downloaded controller package Delete the Simple Forwarding Applica2on bundle from the distribu2on: > rm opendaylight/plugins/ org.opendaylight.controller.samples.simpleforwarding jar Upload the created bundle: Put the learning- switch SNAPSHOT.jar bundle into the opendaylight/plugins folder Update logger configura2on: Op2onally, add the following line to configura2on/logback.xml file: <logger name="org.opendaylight.openflowplugin.learningswitch" level="trace"/>

14 Starting the Environment (Continued) Run the controller: >./run.sh - of13 Check that the applica2on bundle is ac2ve. On the controller console, type: osgi > lb learn You should see something like: START LEVEL 6 ID State Level Name 103 Active 4 learning- switch (0.0.3.SNAPSHOT) osgi> Op2onally, check that the controller is listening on Ports 6633 and On a Linux console, type: > netstat - lnp grep 'java On a Mac OSX console, type: > lsof - i grep LISTEN grep java Start Mininet: > sudo mn - - topo single, controller 'remote,ip=<controller- ip- address>,port=6633' - - switch ovsk,protocols=openflow13

15 Core Concepts: Instance Identifier Unique iden2fier of an element (loca2on) in the yang data tree; Basically, the path to the node that uniquely iden2fies all the node's parent nodes Examples: Java: InstanceIdentifier<Node> identifier = InstanceIdentifier.builder(Nodes.class).child(Node.class,new NodeKey("foo")).build(); REST:

16 Running & Troubleshooting the App Use RESTCONF to validate that the app started and installed the ini2al flow into the switch: On a REST console, issue: GET ip- address>:8080/restconf/operational/ opendaylight- inventory:nodes/node/openflow:1/table/0 Accept Header: application/xml There should be one flow on the switch forwarding all packets to the controller On Mininet, issue pings between each pair of hosts: mininet> pingall 6 more flows should be installed in the host.

17 Other Things to Explore Try a network of switches; start Mininet with: sudo mn - - topo tree,3 - - controller 'remote,ip= :6653' - - switch ovsk,protocols=openflow13

18 Summary OpenDaylight: Controller PlaPorm Model- Driven Applica2on Development Environment

19 Backup

20 BGP-LS Flow Flow- capable Node Model (Flow programming) RESTCONF Controller PlaPorm BGP- LS Topology Exporter MD- SAL NoBficaBon MD- SAL Set MD- SAL BGP- RIB /oper N /oper BGP- LS Topology 3 Openflow Protocol Model (Pkt in,pkt out) MD- SAL Set BGP PDU BGP- LS Plugin 1

21 BGP-LS System Flow

22 [Sub-Section Title]