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

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »


onos-install [-f] [-n] [<node-ip>]

Installs ONOS bits on the designated cell machine.


  • -f  : forces an uninstall. Presently, install also includes onos-push-bits and onos-config within. 
  • -n : installation of onos.conf upstart configuration file will be suppressed and ONOS will not be started. Otherwise, if the option is not specified, ONOS will be ignited as a Linux daemon as the last step of the installation process.

onos-uninstall [<node-ip>]

Uninstall ONOS from the designated cell machine, stopping it if needed.

onos-push-bits [<node-ip>]

Pushes bits produced by onos-package to the designated cell machine.


  • This is not yet available as a separate command.

onos-config [<node-ip>]

Configures the specified ONOS instance according to the cell definition. This command is part of onos-install, but is provided separately should reconfiguration be needed.


Remote CLI Monitoring

onos [-w] [<node-ip> [<onos-cli-command>]]

Attaches to the Command-line client to ONOS from a shell on the development machine.


  • -w : Executes onos-wait-for-start. This option only applies to Linux cell machines. 


  • Presently, this requires Apache Karaf to be installated the development machine; this requirement should go away eventually.

onos-watch [<node-ip> [<onos-cli-command>,<onos-cli-command>,...]]

Continuously executes the specified ONOS CLI commands using the system watch command. Default commands are summary,intents,flows,hosts.

onos-batch [<node-ip> [<onos-cli-command>,<onos-cli-command>,...]]

Executes the specified ONOS CLI commands using the Karaf console batch mode. Default commands are summary,intents,flows,hosts.


Process Management

onos-service [<node-ip | --cell> [stop|start|restart|status]]

Allows remote management of the ONOS upstart daemon on the designated cell machine or all cell machines.

onos-wait-for-start [<node-ip>]

Waits for ONOS instance to reach run-level 100, i.e. to be fully started.

onos-kill [<node-ip>]

Remotely, and unceremoniously, kills the ONOS instance running on the specified cell machine.

onos-log [<node-ip>]

Remotely watches the ONOS log on the specified cell machine. It operates through re-installs where the entire ONOS directory is removed. Also available under short-cut ol.

onos-check-logs [<node-ip>]

Remotely checks the ONOS logs to make sure they contain no ERROR or Exception messages.

onos-push-update-bundle <bundle-name-pattern>

Remotely copies the bundle with matching name to all of the cell’s machines and triggers its dynamic update without restarting Apache Karaf container. Also available under short-cut pub, e.g. pub cli.

onos-start-network [<mininet-topo>]

Remotely starts the specified topology on the cell’s mininet machine against all controllers configured in the cell.


  • mininet-topo : the Mininet topology to launch. The default is the Solar topology. 


Remotely checks that passwordless access via ssh/scp works against all machines within the cell.

onos-push-keys [<node-ip>]

Pushes user’s .ssh/ key to the remote cell machine and installs it for enabling password-less access. This may require the user to enter the password twice; once to copy and the second time to install the keys. Once installed, passwordless access should be enabled.


Fetches the stock ONOS test and Mininet VMs from the local ON.Lab share and to the user’s ~/Download directory.


onos-patch-vm <node-ip> <hostname>

Patches the hostname and /etc/hosts of the cell machine specified by <node-ip> to be set to <hostname>.


  • if your machine appears to have a funky hostname, this is due to an old defect in this tool. To fix the hostname, simply repatch the VM using this same tool.

onos-ssh [<node-ip> <command>]]

Logs in via ssh to the remote cell machine using the standard user (sdn). This is intended primarily for troubleshooting and diagnostics. Most of the testing should be done directly from the developer’s machine or test driver machine.


onos-gui  [<node-ip>]

Launches the ONOS gui in the default browser. The current GUI is onos-app-tvue, which listens on http://<node-ip>:8181/onos/tvue .


  • Presently, this depends on the use of open command on OS/X, but it can be made to work using gnome-open to work on Ubuntu/Debian as well. 
  • In the future this command will launch the main ONOS GUI.


  • No labels