Interacting with the Open Daylight Controller (ODL)

The Yang UI module enables you to interact with the ODL. For more information about Yang Tools, see https://wiki.opendaylight.org/view/YANG_Tools:Main [YANG_Tools].

 

Figure 2.3. Yang UI

DLUX Yang UI Page

To use Yang UI:

  1. Select Yang UI on the left pane. The right pane is divided in two parts.
  2. The top part displays a tree of APIs and subAPIs and buttons to call possible functions (GET, POST, PUT, DELETE, …). Not every subAPIs can call every function. For example, subAPIs “operational” have GET functionality only. Inputs can be filled from ODL when existing data from ODL is displayed or can be filled by user on the page and sent to ODL. Buttons under the API tree are variable. It depends on subAPI specifications. Common buttons are:

    • GET to get data from ODL,
    • PUT and POST for sending data to ODL for saving
    • DELETE for sending data to ODL for deleting. You must specify the xpath for all these operations. This path is displayed in the same row before buttons and it can include text inputs for specific path elements identifiers.

       

      Figure 2.4. Yang API Specification

      DLUX Yang UI API Specification Page

  3. The bottom part of the right pane displays inputs according to the chosen subAPI. Every subAPI is represented by list elements of list statement. It is possible to have a many list elements of one list. + For example, a device can store multiple flows. In this case “flow” is name of the list and every list element is different by a key value. List element of list can obtain other lists. Every list element has a list name, a key name and its value, and a button for removing this list element. Usually the key of the list statement obtains an ID. Inputs can be filled from ODL using GET button from xpath part, or can be filled by user on the page and sent to ODL.

     

    Figure 2.5. Yang UI API Specification

    DLUX Yang UI Sub API Specification Page

  4. Click Show Preview button under API tree to display request that will be sent to ODL. A pane is displayed on the right side with text of request when some input is filled.


loading table of contents...