Page History

...

Alternatively, pointing a browser at http://<onos-ip>:8181/onos/ui will display the ONOS Web GUI.

Deploying from onos.tar.gz only

For deployers who just want to install ONOS software from the distributable onos.tar.gz file, they can follow these simple steps to get ONOS up and running.

First, untar the onos.tar.gz via the following command

tar zxf onos-1.2.0*.tar.gz

After that change to the newly created directory and configure the network interface that ONOS should use for clustering using the onos-config tool, for example:

bin/onos-config MyONOS 10.128.11.*

Note: If you are installing on multiple machines which you intend to cluster, make sure you use the same command to configure them.

At this point, you are ready to run the ONOS as a standalone instance. To do that, you can use the onos-service tool as follows.

bin/onos-service server &

Alternatively, you can integrate the onos-service into your Linux init daemon of choice. Note that etc/onos.conf can be copied to the system /etc/init directory to use the Linux upstart deamon.

If you wish to form a cluster from individually installed ONOS instances, use the onos-form-cluster tool with the IP addresses of all the ONOS instances, as in the following example:

bin/onos-form-cluster 10.128.11.1 10.128.11.2 10.128.11.3

This tool generates a cluster configuration and uploads it to all the ONOS instances via ONOS REST API. Note that this request will trigger all ONOS instances to restart. When they finish the restart process, they will all be part of the same cluster.

To attach a console to the local instance, you can use the bin/onos tool or you can remotely ssh on port 8181 as in the following example:

ssh -p 8101 karaf@10.128.11.1

To setup password-less login via SSH keys, please follow documentation on Apache Karaf 3.0.3 web pages.

Handling multiple remote targets

...