引言
1.编写目的
编写ONOS编译部署文档，是为了指引ONOS相关人员能够正确在系统中编译安装部署ONOS以及提供在部署过程中出现的一些问题的解决方案，方便ONOS相关人员能有针对性的解决在编译安装部署过程中遇到的一些问题。
本手册适宜阅读者：ONOS开发人员，ONOS维护人员
要求：熟悉Linux操作系统
2.主要内容
本手册主要内容：安装部署ONOS的操作步骤
安装前准备
1.硬件配置：
| 操作系统 | Ubuntu Server 14.04 LTS 64-bit 或者Ubuntu Desktop 14.04 64-bit |
| CPU数目 | 至少2个CPU |
| 系统内存 | 至少2G内存 |
2.软件要求
需要在系统中安装如下软件：
| JDK 8 |
| Apache Maven 3.3.9 |
| git |
| Apache Karaf 3.0.5 |
安装部署
本手册使用ubuntu-14.04 desktop作为部署环境,默认用户为onos
1.更新源
1.1 进入系统，打开终端，运行： sudo apt-get update
1.2 运行sudo apt-get upgrade
2.安装jdk
在jdk官网下载jdk
http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
1.1 选择Java SE Development Kit 8u91，点击Accept License Agreement
1.2 选择安装包：jdk-8u91-linux-x64.tar.gz，点击下载，默认下载到Downloads
1.3 解压文件，修改文件名
$ sudo mkdir /usr/lib/jvm
$ sudo tar zxvf jdk-8u91-linux-x64.tar.gz -C /usr/lib/jvm
$ cd /usr/lib/jvm
$ sudo mv jdk1.8.0_91 java
1.4 添加环境变量
$ sudo vi ~/.bashrc
加入如下内容：
export JAVA_HOME=/usr/lib/jvm/java
export JRE_HOME=${JAVA_HOME}/jre
export CLASSPATH=.:${JAVA_HOME}/lib:${JRE_HOME}/lib
export PATH=${JAVA_HOME}/bin:$PATH
执行如下命令，使生效
source ~/.bashrc
1.5 配置JDK版本
sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/java/bin/java 300
sudo update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/java/bin/javac 300
sudo update-alternatives --install /usr/bin/jar jar /usr/lib/jvm/java/bin/jar 300
sudo update-alternatives --install /usr/bin/javah javah /usr/lib/jvm/java/bin/javah 300
sudo update-alternatives --install /usr/bin/javap javap /usr/lib/jvm/java/bin/javap 300
然后执行
sudo update-alternatives --config java
若是初次安装 JDK， 将提示
无需配置。
1.6 测试
2 下载Git工具
$sudo apt-get install git
3 下载ONOS代码
链接地址： https://gerrit.onosproject.org/onos
1.1 下载代码
$ cd
$ git clone https://gerrit.onosproject.org/onos
1.2 配置ONOS环境变量
$ sudo vi /etc/profile
加入如下内容：
export ONOS_ROOT=~/onos
source $ONOS_ROOT/tools/dev/bash_profile
执行如下命令，使生效
source /etc/profile
4 安装Karaf和Maven
1.1 下载Karaf和Maven
$cd;
$mkdir Applications
$cd Downloads
$wget http://archive.apache.org/dist/karaf/3.0.5/apache-karaf-3.0.5.tar.gz
$wget http://archive.apache.org/dist/maven/maven-3/3.3.9/binaries/apache-maven-3.3.9-bin.tar.g
$ tar -zxvf apache-karaf-3.0.5.tar.gz -C ../Applications/
$ tar -zxvf apache-maven-3.3.9-bin.tar.gz -C ../Applications/
1.2 将$KARAF_ROOT/bin增加到PATH路径中
$ sudo vi /etc/profile
加入如下内容：
export PATH=${KARAF_ROOT}/bin:$PATH
执行如下命令，使生效
source /etc/profile
5 编译打包ONOS
1.1 使用Maven编译ONOS
$ cd ~/onos
$ mvn clean install -DskipTests
1.2 生成ONOS包,打包也可以使用”onos-package”命令
$ op
运行ONOS
1. 在本地开发机运行ONOS
这一部分主要描述在本地开发机运行ONOS，onos源代码的tool开发了onos-karaf命令，确保在启动ONOS之前，Apache Karaf能被安装和配置
1.1 设置ONOS_IP
export ONOS_IP=192.168.212.199
1.2 配置ONOS默认启动的服务
export ONOS_APPS=drivers,openflow,proxyarp,mobility,fwd
1.3 启动ONOS
2. 使用ONOS工具远程部署ONOS
目标主机要求：Maven和jdk1.8需要提前安装
1.1 设置目标主机sudo权限无密码
$ sudo visudo
原始为：%sudo ALL=(ALL:ALL) ALL
#修改为：
%sudo ALL=(ALL:ALL) NOPASSWD:ALL
1.2 设置无密码登陆目标本机
$cd ~/.ssh
$ssh-keygen -t rsa
$cp id_rsa.pub authorized_keys
1.3 onos打包
1.4 安装onos到目标主机：如果要重复打包，在执行onos-install之前，将onos-install文件中的以rm开头行注释掉
1.5 在目标主机启动onos
3. 使用ONOS安装包部署ONOS
1.1 解压ONOS tar包
$sudo tar –xzvf onos-1.6.0.onos.tar.gz
1.2 启动onos
$cd onos-1.6.0.onos
$cd apache-karaf-3.0.5/bin
$./karaf clean
4. 部署ONOS集群
1.1 修改local文件
$cd
$cd onos/tools/test/cells
$vi local
$source ../../dev/bash_profile
注意：ONOS_NIC:表示集群网段
OC1， OC2表示集群中某一实例所在的IP地址
OCN表示mininet启动所在的节点IP
查询环境变量是否修改
1.2 向OC1安装ONOS
注意：如果一次性安装集群中所有实例，执行如下命令
$ onos-group install -f
如果重启所有的ONOS实例：执行如下命令
onos-service --cell restart
如果直接使用ONOS包部署集群，按照3步骤，解压安装包之后，执行如下命令
$cd onos-1.6.0.onos/bin
$bin/onos-form-cluster IP1 IP2 IP3
本文作者：路凯
