Page History

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

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
  language text
  $ /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
  language text
  $ export JAVA_HOME=$(/usr/libexec/java_home -v 1.8)

  
  

• On Ubuntu: To verify the JAVA_HOME:
  

  Code Block
  language text
  $ 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
  language text
  $ export JAVA_HOME=/usr/lib/jvm/java-8-oracle

Getting ONOS

The ONOS source can be checked out using git:

$ 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:

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.

...

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

$ 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

...