Page tree

Have questions? Stuck? Please check our FAQ for some common questions and answers.

Skip to end of metadata
Go to start of metadata


This page provides information on how to use and understand the PathPainter Application for the ONOS Web UI.

The PathPainter application allows the user to see the different type of paths between two entities in ONOS, regarding of their type.

The application has three different modes for three different type of paths:

  • shortest: highlights the shortest paths between the source and the destination
  • disjoint: highlights the disjoint paths between the source and the destination
  • geoPath highlights the geographically shortest path

Application Key bindings

While in the PathPainter application there are different key mappings and buttons for different functionalities.

[Set source device
]Set destination device
3Swap source and destination device
4Set the path computation to shortest
5Set the path computation to disjoint
6Set the path computation to geoData



Go to the next path in the set of paths

from source and destination



Go to the previous path in the set of paths

from source and destination


In order to use the PathPainter application you need to have onos installed and configured.

First step is to start the gui:

$: onos-gui 

Once the GUI is stated up in your browser you should activate the pathpainter app by opening the left-side panel, going to applications, finding org.onosproject.pathpainter and clicking the activate button on the upper-right side corner.

You can then return to the topology view and open the toolbar panel in the bottom left side of the screen by pressing the dot key.

Once you have the toolbar open you should see the pathPainter Icon:

Clicking on the Icon will activate the application GUI overlay.

Once you have the overlay active you can select an element and set it, through the button or the 1 key, as the source from which you want to see the paths. The selected element should now have a "Src" badge. Afterwards you should select another host and set it as the the destination. A "Dst" badge will appear and you will see some highlighted paths. If you have not changed previously the mode it will be shortest by default.

The paths will be highlited in two colors, yellow for the current primary path and green for all the others paths between the two elements. Now you can circle between the paths with the correct buttons or the keyboard arrows. 

When you select a different mode you can see that the highlighted paths change, in this case we selected disjoint paths mode.

  • No labels