bc428a4f00
Change-Id: I65b341b265638d80fbacdf550f9a92b42def8c95 |
||
---|---|---|
deployment_scripts | ||
figures | ||
odl_package | ||
repositories | ||
.gitreview | ||
LICENSE | ||
README.md | ||
environment_config.yaml | ||
metadata.yaml | ||
pre_build_hook | ||
tasks.yaml |
README.md
OpenDaylight Plugin for Fuel
OpenDaylight plugin
Overview
This is a proof of concept of the plugin which will install OpenDaylight controller and set it as manager for OVS using ovsdb plugin.
- OpenDaylight controller is a SDN controller.
- OVSDB plugin implement the Open vSwitch Database management protocol.
Requirements
Requirement | Version/Comment |
---|---|
Mirantis OpenStack compatibility | 6.1 |
Recommendations
None.
Limitations
- Supports only environments with Neutron
- HA for ovsdb feature is not implemented in Lithium release - one instance of ODL controller runs on primary OpenStack controller.
- L3 traffic managed by neutron agent - lack of drivers in OpenStack Juno.
Installation Guide
OpenDaylight plugin installation
-
Clone the fuel-plugin-opendaylight repo from stackforge:
git clone https://github.com/stackforge/fuel-plugin-opendaylight
-
Install the Fuel Plugin Builder:
pip install fuel-plugin-builder
-
Install the fpm gem:
gem install fpm
-
Build OpenDaylight Fuel plugin:
fpb --build fuel-plugin-opendaylight/
-
The opendaylight-[x.x.x].rpm plugin package will be created in the plugin folder.
-
Move this file to the Fuel Master node with secure copy (scp):
scp opendaylight-[x.x.x].rpm root@<the_Fuel_Master_node_IP address>:/tmp
-
While logged in Fuel Master install the OpenDaylight plugin:
fuel plugins --install opendaylight-[x.x.x].rpm
-
Check if the plugin was installed successfully:
fuel plugins id | name | version | package_version ---|--------------|---------|---------------- 1 | opendaylight | 0.5.2 | 2.0.0
-
Plugin is ready to use and can be enabled on the Settings tab of the Fuel web UI.
User Guide
OpenDaylight plugin configuration
- Create a new environment with the Fuel UI wizard.
- Click on the Settings tab of the Fuel web UI.
- Scroll down the page, select the "OpenDaylight plugin" checkbox. Rest of configuration is optional
Build options
It is possible to modify process of building plugin by setting environment variables. Look into pre_build_hook file for more details.
Dependencies
OpenDaylight controller require Java Runtime Environment. If you plan to use plugin in environment without internet access or/and CentOS environment modify build command:
INCLUDE_DEPENDENCIES=true fpb --build fuel-plugin-opendaylight/
Pre build script will try download required dependencies so it become part of the compiled plugin.
Note: List of packages for ubuntu and centos may need to be modified if packages in centos or ubuntu repositories will change.
Testing
Use the same IP address as for OpenStack Horizon panel and port 8181 to reach dlux web ui and apidoc explorer:
OpenDaylight files are stored on primary controller inside /opt/opendaylight directory.
To log in to OpenDayligt shell run /opt/opendaylight/bin/client
Known issues
- VM live migration not supported by ODL ovsdb
- ODL ignore MTU size from Neutron and create tap devices for VMs with MTU 1500. Things like Jumbo frames will not work on VMs side.
Release Notes
0.5.2
- Initial release of the plugin. This is a beta version.
0.6.0
- Integrate Lithium release with OpenStack Juno.
0.6.1
- Integrate Lithium SR1 with OpenStack Juno.
0.6.2
- Fix MTU for vxlan segmentation type.
Development
The OpenStack Development Mailing List is the preferred way to communicate,
emails should be sent to openstack-dev@lists.openstack.org
with the subject
prefixed by [fuel][plugins][odl]
.
Reporting Bugs
Bugs should be filled on the Launchpad fuel-plugins project (not GitHub) with the tag odl
.
Contributing
If you would like to contribute to the development of this Fuel plugin you must follow the OpenStack development workflow.
Patch reviews take place on the OpenStack gerrit system.
Contributors
- Michal Skalski mskalski@mirantis.com