Gitiles
Code Review Sign In
gerrit.onosproject.org / spring-open / cdb30680c0e7b3a1c7747a8d479f9645567b4cc1
commitcdb30680c0e7b3a1c7747a8d479f9645567b4cc1[log] [tgz]
authorJonathan Hart <jono@onlab.us>Sun Aug 04 01:49:59 2013 +1200
committerJonathan Hart <jono@onlab.us>Sun Aug 04 01:49:59 2013 +1200
treec4514b295525b70e111aa7de627b409c4ae7700f
parent3c3f0d0410d66e461ab8c1a2b458dbe14d21063c [diff]
parentdf6ec33a052c2d5a83edf3852a44974c86e5e872 [diff]
Merge branch 'arpchanges'
tree: c4514b295525b70e111aa7de627b409c4ae7700f
  1. .gitignore
  2. Authors
  3. Documentation/
  4. README.md
  5. cluster-mgmt/
  6. conf/
  7. demo-scripts/
  8. onos-embedded.sh
  9. pom.xml
  10. scripts/
  11. setup-eclipse.sh
  12. setup-local-maven.sh
  13. src/
  14. start-cassandra.sh
  15. start-onos-embedded.sh
  16. start-onos.sh
  17. start-rest.sh
  18. start-zk.sh
  19. test-network/
  20. testbed-ctrl-add-ext.sh
  21. testbed-ctrl-none.sh
  22. titan/
  23. web/
README.md

ONOS (Open Networking Operating System)

ONOS (Open Networking Operating System) is an experimental distributed SDN OS. ONOS is under development. ONOS was announced and demonstrated at ONS'13.

Steps to download and setup development VM

http://wiki.onlab.us/display/Eng/ONOS+Development+VM

Building ONOS

  1. Install custom jars and dependencies (Only need to be run only once)

    $ ./setup-local-maven.sh

  2. Cleanly Build ONOS

    $ mvn clean $ mvn compile

    NOTE: installing maven for the first time may switch java version from 1.7 to 1.6 causing cassandra to not run

Dependencies

  1. Zookeeper Download and install apache-zookeeper-3.4.5: http://zookeeper.apache.org/releases.html
  2. Cassandra Download and install apache-cassandra-1.2.2: http://cassandra.apache.org/download/

Running ONOS

  1. Start zookeeper

    $ cd (ONOS-INSTALL-DIR)/

    $ ./start-zk.sh

  2. Start cassandra

    $ cd (ONOS-INSTALL-DIR)/

    $ ./start-cassandra.sh start

  3. Confirm cassandra is running

    $ ./start-cassandra.sh status

  4. Start ONOS instance

    $ cd (ONOS-INSTALL-DIR)/

    $ ./start-onos.sh start

  5. Start ONOS rest apis

    $ ./start-rest.sh start

Running ONOS with Cassandra embedded (Optional)

  1. Start Zookeeper

    $ cd (ONOS-INSTALL-DIR)/

    $ ./zkServer.sh start

  2. Start ONOS and Cassandra embedded

    $ cd (ONOS-INSTALL_DIR)/

    $ ./start-onos-embedded.sh start

  3. Start ONOS rest apis

    $ ./start-rest.sh start

Running in offline mode (Optional)

Maven is used to build and run ONOS. By default, maven tries to reach the repositories. To suppress this behavior '-o' option should be given to mvn command.

To give additional option to mvn commands used in ONOS, use the MVN environment variable.

  • Example: Running in offline mode

    $ env MVN="mvn -o" ./start-onos.sh start