Page tree

Versions Compared

Key

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

 

This section covers the details involved in getting, installing, and running ONOS. Both single- and multi-instance cases are described. 

Table of Contents
maxLevel3

 

Info
This section assumes that the reader has already checked out the latest source by following Getting ONOS - ONOS Source Code.

Prerequisites

ONOS and its test scripts are developed and tested on OS X (Mavericks and later) and Ubuntu (14.04 64-bit), with focus on the latter. 

...

  • On OS X: The current JAVA_HOME may be verified with:

    Code Block
    languagetext
    $ /usr/libexec/java_home
    /Library/Java/JavaVirtualMachines/jdk1.8.0_25.jdk/Contents/Home

    To set the version, either run or add the following to the shell profile:

    Code Block
    languagetext
    $ export JAVA_HOME=$(/usr/libexec/java_home -v 1.8)


  • On Ubuntu: To verify the JAVA_HOME:

    Code Block
    languagetext
    $ env | grep JAVA_HOME
    JAVA_HOME=/usr/lib/jvm/java-8-oracle

    If JAVA_HOME is not set or incorrect, either run or add the following to the shell profile:

    Code Block
    languagetext
    $ export JAVA_HOME=/usr/lib/jvm/java-8-oracle

Getting ONOS

The ONOS source can be checked out using git:

Code Block
languagetext
$ git clone ssh://<user>@gerrit.onlab.us:29418/onos-next ~/onos

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

...

If the above generates the following error:

Code Block
languagetext
Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

make sure that a public key has been uploaded to the ONOS Gerrit by following the steps in the dropdown below.

...

titleSSH key generation (click to expand)

Generate a key. Keep the default file name and location. This will generate an id_rsa and id_rsa.pub file in ~/.ssh:

Code Block
languagetext
$ ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/home/onosuser/.ssh/id_rsa): 
Enter passphrase (empty for no passphrase): 
Enter same passphrase again: 
Your identification has been saved in /home/onosuser/.ssh/id_rsa.
Your public key has been saved in /home/onosuser/.ssh/id_rsa.pub.

...
$ ls ~/.ssh
id_rsa  id_rsa.pub  known_hosts

...


Installing ONOS

Environment Setup

...