Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Overlays bundled with out-of-the-box ONOS are listed here. Follow the links for more information:

...

IconKeyFunctionDefault StateComments
IShow / hide ONOS cluster instance panelshowThe instance panel is shown by default.
OShow / hide ONOS summary panelshowThe summary panel is shown by default.
DDisable / enable details panelenable

The details panel is enabled by default, and is displayed when one or more topology elements are selected. Disabling this panel keeps it hidden even when something is selected.

     
HToggle host visibilityhideShows or hides the hosts (and their links). Hosts are hidden by default.
MToggle offline visibilityshowDevices that are offline (but that ONOS still knows about) are shown by default. This toggle will hide offline devices (and any hosts/links connected to them).
PToggle port highlightingonPort highlighting is when hovering the mouse over a link will highlight the link and label the ends with the appropriate port numbers. This feature can be switched off with this toggle.
BToggle background geo maphideThe background map (hidden by default) can be shown or hidden with this toggle.
Image AddedGSelect background geo mapn/aOpens a dialog box which allows selection of a geographic region from a pre-defined set.
SToggle sprite layerhideThe sprite layer (static shapes/text injected into the view) can be shown or hidden with this toggle.

...

IconKeyDescriptionDefault StateComments
ZToggle oblique view (experimental)regular viewCreates a split-level visualization of the packet and optical layers of the network. Note that this feature is experimental and may be slightly buggy.
NCycle node layersshow all layersCycles between three view modes: show all layers, show packet layer, show optical layer.
LCycle device labelshide labelsCycles between three modes of showing labels on devices: hide labels, show friendly labels, show device ID.
RReset pan / zoom-This function restores the pan and zoom levels to default settings.
     
EEqualize mastership roles-Sends a command to ONOS to invoke a mastership equalization request.
     
 No overlay De-activates the current overlay.
 Traffic overlay(tick)Provides traffic monitoring functions.
...
 
...
 <Topology Overlays installed by ONOS Apps will appear here>

...

Additionally, pressing the 'L' key will cycle through the devices labels ("friendly", "ID", "no-label"):

Mouse Gestures

A node (device / host) may be repositioned manually (and pinned into place) by clicking and dragging it to a new location.

...

The four action buttons (with white backgrounds) are navigation buttons detailed below. The two action buttons on the right are added to the panel if the Traffic Overlay is currently active. See the Traffic Overlay page for details.

Navigation Actions
Navigate to the Device View for the selected device
Navigate to the Flow View for the selected device
Navigate to the Port View for the selected Device
Navigate to the Group View for the selected Device

...

Action buttons may also be provided if the active overlay

 

 

Warning

Page currently being re-worked... here downwards subject to change...

 

 

More Keyboard Commands

 

Details Panel

The details panel appears when something of interest is "selected". 

When a single device is selected, properties of that device are displayed, along with action buttons:

  

 

When multiple devices are selected, the details panel switches format to show the IDs of the selections and provides a single action button:

Image Removed Show Related Traffic

Image Removed

 

When a single host is selected, properties of that host are displayed, along with an action button:

Image Removed Show Related Traffic

Image Removed

 

When exactly two hosts are selected, their IDs are shown, along with the following action buttons:

Image Removed Show Related Traffic

Image Removed Create Host-to-Host Flow

Image Removed

...

has functions that operate on a multi-selection.

Port Highlighting

By default, port highlighting is enabled, which means that as the mouse hovers over a link, the link highlights and the port numbers at both ends of the link are shown:

Image Added

The port highlighting feature can be toggled on / off by pressing the 'P' (for 'Port highlighting') key.

 

 

 

 

 

Warning

The following section will be migrated to a new page real soon now!!!!

 

Traffic Overlay functions

IconKeyDescription
VShow all related intents
Right ArrowShow next related intent
Left ArrowShow previous related intent
WMonitor traffic of selected intent
AMonitor all traffic
FShow device link flows

...

A number of commands allow different visualizations of traffic on the network.(NOTE: the section on visualizing traffic will be moved to a new page soon, once the functionality has been migrated to a "Traffic Overlay")traffic on the network.

All Traffic

If there is traffic flowing on the network (for example, if reactive forwarding is active, and a pingall is run on mininet), then pressing the 'A' key will display something like the following:

...

The background map provides a geographic reference for the topology. The default map is the Continental US. The map layer's visibility can be toggled on and off with the 'B' (for background) key.See Providing Alternate Maps for the Topology View for additional details.be toggled on and off with the 'B' (for background) key.
See Providing Alternate Maps for the Topology View for additional details.

The scale of background map can be changed on demand. To do that, simply append ?mapscale=<real-number> at the end of the URL. For example,

Panel

http://localhost:8181/onos/ui/index.html#/topo?mapscale=1.5

Custom Sprites

The Topology Sprite Layer mechanism allows custom "background" elements to be displayed (above the background map, but below the topology elements). This could be used, for example, to inject labeled "subnet clouds", or the plan of an office building or campus into the topology view. Typically, one would want to hide the background map layer (press 'B') and show the sprite layer (press 'S') instead.

...