Page History

...

This clones the repository to your home directory, under a directory named 'onos'.

Installation

Environment Setup

To get the most from the tools and instructions discussed in the following sections,  it is highly recommended that the ONOS_ROOT environment variable is exported in your shell profile (.bash_aliases, .profile, etc.) to refer to the top of the ONOS source tree. For example:

...

$ export PATH=”$PATH:~/onos/dev/bin:~/onos/tools/build:~/onos/tools/test/bin”

Building ONOS 

Anchor
#build-onos #build-onos

ONOS uses Maven for managing the build process. To build the ONOS code-base from the top-most level, and from scratch, simply type the following:

...

Remote installations are useful when one wishes to run multiple ONOS instances as in a cluster. This section demonstrates remote installation on a single remote target machine.

Overview

The ONOS build process produces a number of OSGi bundles, which are essentially Java jar files.  One could simply deploy these bundles in any OSGi container to run ONOS, but this would require that such container be installed, properly configured, and that the bundles be collected and properly staged. The ONOS utility scripts, onos-package and onos-install, simplifies this task by packaging the ONOS binaries into a distributable compressed tar. 

...

• The Apache Karaf binaries (either .zip or .tar.gz format) are available in ~/Downloads of the build machine
• The ONOS source has been built
• The install target has a Java 8 JRE installed

Additionally, onos-install install relies on ssh to deploy the package to the target machine. It is recommended thatTherefore:

1. Either the target machine should have a user named 'sdn', or on the build machine, the ONOS_USER environment variable is should be exported with the username used in the target machine
2. And passwordPassword-less (e.g. key-based) login should be enabled on the target. 

...

$ onos-install 192.168.56.20onos20
onos start/running, process 9513

...