Note: This page applies almost equally to the legacy GUI and its replacement GUI2. Any new enhancements are added to GUI2 only. See GUI Release Notes for details of new features

GUI Overview

The ONOS GUI is a single-page web-application, providing a visual interface to the ONOS controller (or cluster of controllers).

...

• The onos-gui feature must be installed in ONOS.
• The GUI listens on port 8181.
• The base URL is /onos/ui; for example, to access the GUI on localhost, use: http://localhost:8181/onos/ui
• The GUI has been developed to work on Google Chrome. The GUI has been tested on Safari and Firefox and minor compatibility adjustments have been made; these and other browsers may work, but have not been extensively tested, and are not actively supported, at this time.
• The key bindings associated with any view will work on any keyboard. The "Cmd" (⌘) key on an Apple keyboard is bound to the same key as the "Windows" or "Alt" keys on Windows or other keyboards.

...

On launching the GUI you should see the login screen: 

If ONOS has been run in local mode (typically used during development), the username and password karaf/karaf can be used to log into the UI.

If ONOS is running as a cluster using a 'test cell', the username and password should be defined in $ONOS_WEB_USER and $ONOS_WEB_PASS for that cell.

Default username and password are onos/rocks.

If ONOS was installed via onos-install and configured by onos-secure-ssh (developer/test tools), then the passwords may be different; examine the $ONOS_WEB_USERQ: Suggested usernames are not working in my case. I am stuck with GUI login page. I tried using karaf/karaf and $ONOS_WEB_USER(=onos) and $ONOS_WEB_PASS (=rocks) but credentials failed. Please advise.environment variables.

After a successful login, you should see a screen that looks something like this:

Image RemovedImage Added

The gray dark bar at the top is the Masthead, which provides a location for general GUI controls. In the current version (1.4.0 "Emu") the masthead contains Items shown with red text / arrows are always present:

• the Navigation Menu Buttonbutton
• the ONOS logo and title
• the Context Help button (click to open web URL specific to current view)
• the User Name (click to access logout link)

 (In future versions, the masthead may include session controls , such as user ID, user preferences, global search, etc.)

The remainder of the screen is the "view", which defaults to the Topology View when the GUI is first loaded (items shown with purple text / arrows) – a cluster-wide view of the network topology.

• The ONOS Cluster Node Panel indicates the controllers cluster members (controller instances) in the cluster.
• The Summary Panel gives a brief summary of properties of the network topology.
• The Topology Toolbar (initially hidden) provides push-button / toggle-button actions that interact with the topology view.

For more detailed information about this view, see the Topology View page.

Image RemovedImage Added

GUI Views

The GUI is capable of supporting multiple views. As new views are added to the base release, they will be documented here.

...

The views currently included in the base release are:

...

*Tabular Views: The GUI has multiple "tabular views" that are similar in look and interaction, but display different information. For a general overview of tabular usage, see the Tabular View page. For specifics on each view, follow the links in the above table.

...

ONOS applications may contain Web UI components – either custom views, or topology overlay behaviors. For documentation on application-specific behavior, please see the Web UI Application Index.

Release Notes

This section provides a See the reverse-chronological summary of changes to the GUI for each release.

Hummingbird – 1.7.0

• <TBD>

Goldeneye – 1.6.0

• Overhaul of the "Look-n-Feel" (re-skinned).
• Applications View:
  • Drag-n-drop of .oar files to install and activate, now supported.
  • Auto-prompt user to refresh the UI when components are added/removed
• Topology View:
  • "Cluster node ready" checkmark indicator added.
  • Geo-map selection dialog ('G' keystroke) added.
  • Support for topology overlays to provide custom link data.
• Dialog Service
  • Support for chained dialog operations added.
• Chart Service added.
• User preferences now persisted server side.
• Logged-in user name displayed in masthead.

Falcon – 1.5.0

• Topology View:
  • "Reset Node Locations" command ('X' keystroke) added.
  • Topology Overlay selection with F1, F2, F3... keystrokes added.
• Applications View
  • Confirmation dialog added for application activate/deactivate/uninstall.
  • Application model enhancements supported:
    • columns added for additional application attributes
    • details panel displayed when application row selected
  • Note: applications can now define custom icon and custom URL (link to documentation).
• Dialog Service:
  • Enter and Escape keys bound to OK and Cancel buttons.

Emu – 1.4.0

• Device View:
  
  • Friendly name can be set on a device from the device detail panel.
• Intent View:
  • Button added to navigate to Topology View and display the selected intent.
• Topology View:
  • Traffic Overlay now selected as default.
  • Topology overlays can now highlight devices and hosts with badges (small number/text/glyph).
  • Topology overlays can invoke a dialog box to interact with the user.
• ONOS-Branded "Loading..." animation.
• Sample application (org.onosproject.uiref) featuring UI content injection techniques.
• GUI Archetypes (ui, uitab, uitopo) facilitating rapid development of applications with custom UI content.

Drake – 1.3.0

• Authentication Enabled by default (Login screen; logout action)
• More tabular views added:
  • Settings
  • Tunnels
• Changes to Topology View:
  • Traffic re-implemented as an "overlay"
  • Overlay mechanism now programmable from ONOS Apps
    • highlighting/labeling topology links
    • full control over summary panel content
    • full control over details panel content

Cardinal – 1.2.0

...

• Links
• Hosts
• Intents
• Applications
• Cluster Nodes
• Device Flows (hidden view)
• Device Ports (hidden view)
• Device Groups (hidden view)

...

.

...

• node layer buttons moved from masthead to toolbar

...

• slide out details panel appears when a device is clicked on

...

• glyphs next to links for navigation
• views organized into categories

...

...

Blackbird – 1.1.0

...

• View-agnostic features refactored as Angular Services.

...

• Topology source code broken out into multiple source files.
• Port Highlighting on links added.

...

• Implemented as a simple table for now; one device per row, sortable by column header clicks.

...

• Skeletal example code.

...

• Press the 'T' key to toggle theme.

...

• By default, the Avocet GUI is launched; the base URL http://localhost:8181/onos/ui is mapped to http://localhost:8181/onos/ui/legacy/index.html#topo.
• The new Angular-based GUI can be launched by manually adjusting the URL to be:  http://localhost:8181/onos/ui/index.html#topo, (that is, remove "legacy/"). 

Avocet – 1.0.0

• GUI implemented using a home-grown framework. 
• Single view (Topology View) implemented, displaying network topology and providing a certain level of interaction to show traffic & flow information.
• Although the 'T' key-binding (toggle theme) is present, the "dark" theme has not been implemented.

Previous : The ONOS CLI
Next : Distributed ONOS

...

...