Versions Compared

Key

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

...

The ONOS CLI is an extension of Karaf's CLI. As a result, it is capable of leveraging features such as programmatic extensibility, the ability to load and unload bundles (among others), and SSH access.

Accessing the CLI

For local installations of ONOS, the ONOS CLI can be accessed with karaf clean. For remote installations, e.g. ONOS instances deployed with onos-package and onos-install, the onos command can be used to attach to the remote running instance. For example, to access the CLI of an ONOS instance running at 192.168.56.30:

 

Code Block
languagetext
$ onos 192.168.56.30

Both Ctrl-D and logout exits the CLI.

Note, in the case that karaf clean was used to start the CLI, exiting the CLI will cause the ONOS instance to terminate.

ONOS Commands

ONOS supplies a set of its own commands. help onos lists the available commands: 

...

Code Block
languagetext
onos> help onos:add-flows
DESCRIPTION
        onos:add-flows

	    Installs a flow rules

SYNTAX
        onos:add-flows [options] flowPerDevice numOfRuns 

ARGUMENTS
        flowPerDevice
                Number of flows to add per device
        numOfRuns
                Number of iterations
OPTIONS
        --help
                Display this help message
        -j, --json
                Output JSON
Info

Appendix A provides a listing of the currently available CLI commands. 

 

...

Previous : Interacting with ONOS
Next : The ONOS Web GUI

...