共计 5827 个字符，预计需要花费 15 分钟才能阅读完成。
操作系统：Linux x64 / Ubuntu 14.04
研究领域：软件定义网络 SDN（Software-defined Networking）
开发组件：OpenDaylight
一、环境搭建
1. Java+Apache Maven 基本开发环境搭建。详见相应的前面两篇文档：
《Ubuntu Linux 系统下 Java 开发环境搭建》http://www.linuxidc.com/Linux/2015-12/126928.htm
《Ubuntu Linux 系统下 Apache Maven 的安装和配置》http://www.linuxidc.com/Linux/2015-12/126929.htm
2. 安装用来获取 OpenDaylight 源码的 Git 工具。
sudo apt-get install git-core
3. 针对 Opendaylight，安装好 Maven 后，需要编辑一个非常重要的文件 settings.xml。直接修改该文件，就能在机器上全局地定制 Maven 的行为。~/.m2 是默认的 maven 本地仓库。刚装好 maven 的后~/.m2 下是没有 settings.xml 的文件的。在 /etc/maven 下有 settings.xml 的原型，一般情况下，我们更偏向于复制该文件至 home 目录下的.m2/ 目录下（这里~ 表示用户目录），然后修改该文件，在用户范围定制 Maven 的行为。前者又被叫做全局配置，后者被称为用户配置。如果两者都存在，它们的内容将被合并，并且用户范围的 settings.xml 优先。在这里要在~/ 目录下创建.m2 文件夹，然后执行修改命令（详见官网：https://wiki.opendaylight.org/view/GettingStarted:Development_Environment_Setup）：
sudo mkdir .m2
sudo cp -n ~/.m2/settings.xml{,.orig} ; \wget -q -O – https://raw.githubusercontent.com/opendaylight/odlparent/master/settings.xml > ~/.m2/settings.xml
完成后输入“sudo gedit /.m2/settings.xml”查看 settings.xml 内容，应该显示如下：
# Shortcut command for grabbing settings.xml
cp -n ~/.m2/settings.xml{,.orig} ; \
wget -q -O – https://raw.githubusercontent.com/opendaylight/odlparent/master/settings.xml > ~/.m2/settings.xml
<settings xmlns=”http://maven.apache.org/SETTINGS/1.0.0″
xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”
xsi:schemaLocation=”http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd”>
<profiles>
<profile>
<id>opendaylight-release</id>
<repositories>
<repository>
<id>opendaylight-mirror</id>
<name>opendaylight-mirror</name>
<url>http://nexus.opendaylight.org/content/repositories/public/</url>
<releases>
<enabled>true</enabled>
<updatePolicy>never</updatePolicy>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>opendaylight-mirror</id>
<name>opendaylight-mirror</name>
<url>http://nexus.opendaylight.org/content/repositories/public/</url>
<releases>
<enabled>true</enabled>
<updatePolicy>never</updatePolicy>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>
</profile>
<profile>
<id>opendaylight-snapshots</id>
<repositories>
<repository>
<id>opendaylight-snapshot</id>
<name>opendaylight-snapshot</name>
<url>http://nexus.opendaylight.org/content/repositories/opendaylight.snapshot/</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>opendaylight-snapshot</id>
<name>opendaylight-snapshot</name>
<url>http://nexus.opendaylight.org/content/repositories/opendaylight.snapshot/</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>
</profile>
</profiles>
<activeProfiles>
<activeProfile>opendaylight-release</activeProfile>
<activeProfile>opendaylight-snapshots</activeProfile>
</activeProfiles>
</settings>
二、OpenDaylight 源码获取、编译和安装
1. 新建项目文件夹，获取 OpenDaylight 源码：
sudo mkdir openDayLight
cd openDayLight
sudo git clone https://git.opendaylight.org/gerrit/p/controller.git
2. 指定编译 ODL 的版本（以 Lithium 锂版本为例）并查看确认：
cd controller
sudo git checkout stable/lithium
git branch
3. 联网编译 Controller（确认之前的 settings.xml 文件已经修改好）：
mvn clean install
* 如果编译过程中出现 Test 编译错误，可以加上 -DskipTests 跳过测试加快编译速度，其他编译错误和尝试解决方案：
目前遇到两种：
a. 指定目录不能创建或访问：更改文件夹读写权限，进入 sudo 模式重新编译
b. pom.xml 相关错误：将~/.m2 下的 settings.xml 复制到 /root/.m2 目录下：sudo cp ~/.m2/settings.xml /root/.m2，重新编译
编译成功！
4. 控制器验证运行。
旧版本的目录结构是“controller/opendaylight/distribution”，在新版本的目录结构中不再存在“distribution”这个子文件夹，这就是很多朋友参照以前的指南却找不到 distribution 子文件夹来启动控制器的原因。在这里应该 cd 进入“controller/karaf/opendaylight-karaf”文件夹，输入：
./target/assembly/bin/karaf
这时将启动控制器进入 opendaylight-user@root> 模式。这个时候，Opendaylight 的 controller 项目初步安装就完成了！
* 三、TEST：Integration 项目源码的编译安装
* 之前编译好的 Controller 项目是没有 WebGUI（DLUX）等丰富 Feature 的核心控制器。Integration 是一个框架性的工程，所有自己开发和修改的部分（包括 controller、openflowPlugin&Java 三个工程）编译为包后，都可以放在该工程的目录下一起执行。注意，如果是自己开发的包，则可以直接放到该目录下。但是如果是修改的原本工程，然后编译的包要替换掉上面目录中原来的包，这里有个问题是 integration 的 plugin 目录下的包名和 controller，openflowplugin，openflowjava 中编译出来的包命名方式有点小差别，复制过去之前先重命名下，使之和目录下的原来包文件名一致，再复制替换。（参考自 @jason-zhou 童鞋的《OpenDaylight 开发学习笔记基础之 Controller 篇》）。将各个工程的 jar 包 copy 到 integration 里后，运用 mvn clean install 编译 integration。工程所在目录：
username@ubuntu:~/developApps/openDayLight/integration/distributions/karaf/target/assembly/system/org/opendaylight$ ls
aaa integration neutron sdninterfaceapp usc
bgpcep iotdm nic sfc vpnservice
capwap l2switch odlparent snmp vtn
<strong><span style=”color:#ff0000;”>controller</span></strong> lacp <strong><span style=”color:#ff0000;”>openflowjava</span></strong> sxp yangtools
coretutorials lispflowmapping <span style=”color:#ff0000;”><strong>openflowplugin</strong></span> tcpmd5
didm mdsal ovsdb topoprocessing
dlux nemo packetcable tsdr
groupbasedpolicy netconf reservation ttp
* 这里仅给出基本的 Integration 项目的编译安装步骤，Openflowplugin 和 Openflowjava 工程将另文详述。
1. 下载并编译 Integration。
回到 openDaylight 根目录，输入如下命令获取 Integration 源码：
git clone https://git.opendaylight.org/gerrit/p/integration.git
操作完成后可以看到目录下多出了 integration 目录，进入 integration 目录，指定版本（checkout）为 stable/lithium，进行编译：
cd integration
git checkout stable/lithium
mvn clean install -DskipTests（或者 cd 进入子目录 /distributions/karaf 下执行此命令）
2. 编译完成后，进入 integration/distributions/karaf/target/assembly 目录，运行如下命令启动 ODL：
bin/karaf
此时进入 ODL 命令行界面，通过“feature:list -i”命令可以查看已经安装的功能模块，通过“feature:install <feature>”命令可以安装想要的 feature。
* Karaf module 会把控制器的 Plugin 制作成 Karaf Feature，然后打包成可以导入到 Apache karaf 的 kar 文件。Karaf 基于 OSGI 的运行环境，做为 OSGI 应用的管理容器提供各种管理 utility。
到这里，一个可供开发和安装丰富 Feature 功能模块的 OpenDaylight 控制器已经基本搭建完成。
本文永久更新链接地址：http://www.linuxidc.com/Linux/2015-12/1269.30htm
