This local workflow is simple, quick to start up, and recommended for developers who wish to run a single instance of ONOS, locally on a development machine.
Running ONOS locally
To run ONOS locally on the development machine, simply run the following command:
cd $ONOS_ROOT bazel run onos-local clean debug |
The above command will create local installation from the onos.tar.gz
file and will start it in the background. In the foreground, it will display a continuous view of the ONOS (Apache Karaf) log file. Options following the double-dash (–) are passed through to the ONOS Apache Karaf and can be omitted. Here, the clean
option forces a clean installation of ONOS and the debug
option means that the default debug port 5005 will be available for attaching a remote debugger.
To attach to the ONOS CLI console, run:
$ONOS_ROOT/tools/test/bin/onos localhost |
Once connected, you can run various ONOS CLI and Apache Karaf commands.
To open your default browser on the ONOS GUI page, simply type:
$ONOS_ROOT/tools/test/bin/onos-gui localhost |
or alternatively visit http://localhost:8181/onos/ui