Getting ONOS

This page describes how to acquire ONOS. 

ONOS VM

A VM including ONOS is available as the basis for the Basic ONOS Tutorial, and can be downloaded [here].

ONOS Source Code

The ONOS source code may be downloaded using git. git is available via various package managers.

Crowd Registration

An account is required to access to the codebase and various developer services. An account may be created by registering here.

SSH Public Keys

An SSH key should also be uploaded to the ONOS Gerrit server.

1. 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

   
   

2. Upload the SSH public key. After logging into the Gerrit account, go to Settings > SSH Public Keys. Paste the contents of id_rsa.pub into the "Add SSH Public Key" box and hit Add:
   
   

Checking out code

The ONOS source can then 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 unspecified, the directory's name will be onos-next.