RETIRED, Fuel plugin for OpenDaylight integration
Go to file
Ferenc Cserepkei c3e77f6abf SFC classifier feature set updated
From now on One can choose between 'NetVirt' and 'GBP' classifier.
The default is 'NetVirt'

Change-Id: Ibdcd455f0f43d8ca5364cab60ac2f28860c40916
Signed-off-by: Ferenc Cserepkei <ferenc.cserepkei@ericsson.com>
2016-04-12 15:32:51 +02:00
deployment_scripts/puppet SFC classifier feature set updated 2016-04-12 15:32:51 +02:00
odl_package Provide possibility to build plugin with openjdk-8 2016-02-14 14:36:23 +01:00
repositories Import code from personal repo 2015-06-25 09:31:50 +02:00
.gitignore Enable BGPVPN_extension/SDNVPN_feature 2016-03-10 14:47:24 +01:00
.gitreview Easier way to define karaf features 2015-10-22 17:22:18 +02:00
CHANGELOG.md Support MOS 8.0. 2016-01-19 00:53:39 +01:00
LICENSE Support MOS 8.0. 2016-01-19 00:53:39 +01:00
README.md Provide possibility to build plugin with openjdk-8 2016-02-14 14:36:23 +01:00
deployment_tasks.yaml Stop use deprecated method to fetch nodes info 2016-03-07 10:49:36 +01:00
environment_config.yaml SFC classifier feature set updated 2016-04-12 15:32:51 +02:00
metadata.yaml Enable BGPVPN_extension/SDNVPN_feature 2016-03-10 14:47:24 +01:00
node_roles.yaml Support for MOS 7.0 2015-11-09 12:50:40 +00:00
pre_build_hook Use OpenDaylight Be SR1 2016-04-04 14:36:39 +02:00
volumes.yaml Support for MOS 7.0 2015-11-09 12:50:40 +00:00

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.

Requirements

Requirement Version/Comment
Mirantis OpenStack compatibility 8.0

Limitations

  • HA for ODL controller is not implemented yet.

Installation Guide

OpenDaylight plugin installation

  1. Clone the fuel-plugin-opendaylight repo from github:

     git clone https://github.com/openstack/fuel-plugin-opendaylight
    
  2. Install the Fuel Plugin Builder:

     pip install fuel-plugin-builder
    
  3. Install the fpm gem:

     gem install fpm
    
  4. Build OpenDaylight Fuel plugin:

     fpb --build fuel-plugin-opendaylight/
    
  5. The opendaylight-[x.x.x].rpm plugin package will be created in the plugin folder.

  6. 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
    
  7. While logged in Fuel Master install the OpenDaylight plugin:

     fuel plugins --install opendaylight-[x.x.x].rpm
    
  8. Check if the plugin was installed successfully:

     fuel plugins
    
     id | name         | version | package_version
     ---|--------------|---------|----------------
     1  | opendaylight | 0.5.2   | 2.0.0
    
  9. Plugin is ready to use and can be enabled on the Settings tab of the Fuel web UI.

User Guide

OpenDaylight plugin configuration

  1. Create a new environment with the Fuel UI wizard.
  2. Click on the Settings tab of the Fuel web UI.
  3. Select "OpenDaylight plugin" section.
  4. Tick the checkbox and click "Save Settings" button.
  5. Assign role OPENDAYLIGHT to one of the node.

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 use Java Runtime Environment, required packages will be downloaded from ubuntu repositores. Ubuntu trusty provides openjdk-7, export USE_JAVA8=true environment variable during plugin compilation to fetch openjdk-8. JAVA8_URL variable points to the localization of openjdk-8 deb package, default value is defined in pre_build_hook file file and can be overwritten by environment variable.

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 node with 'OpenDaylight' role assigned inside /opt/opendaylight directory.

To log in to OpenDayligt shell run /opt/opendaylight/bin/client -u karaf

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.

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