RETIRED, Fuel plugin to deploy OVS with NSH and DPDK
Go to file
David Chou 27eaf16ac1 Fix version in README.md
Change-Id: I3659311f20afd826342c2334cbc124f4e7ebe3cd
Signed-off-by: David Chou <david.j.chou@intel.com>
2016-01-26 02:43:44 +00:00
deployment_scripts/puppet/manifests Clean up code 2015-12-22 23:44:29 +08:00
ovs-nsh Rebase to 8.0 2016-01-26 01:26:13 +08:00
ovs_package/ubuntu Implement: Fuel install OVS with NSH/DPDK 2015-12-09 18:41:13 +08:00
repositories/ubuntu Don't build dpdk/dppd in installed node 2015-12-23 01:45:59 +00:00
.gitreview Added .gitreview 2015-10-27 12:52:25 +00:00
LICENSE Implement: Fuel install OVS with NSH/DPDK 2015-11-15 21:42:01 +08:00
README.md Fix version in README.md 2016-01-26 02:43:44 +00:00
deployment_tasks.yaml Implement: Fuel install OVS with NSH/DPDK 2015-12-01 21:41:49 +08:00
environment_config.yaml Add DPDK Initialization 2015-12-18 06:01:56 +00:00
metadata.yaml Rebase to 8.0 2016-01-26 01:26:13 +08:00
pre_build_hook Don't build dpdk/dppd in installed node 2015-12-23 01:45:59 +00:00
tasks.yaml Implement: Fuel install OVS with NSH/DPDK 2015-11-15 21:42:01 +08:00

README.md

Openvswitch Plugin for Fuel

Openvswitch plugin

Overview

New fuel plugin fuel-plugin-ovs is developed to deploy OVS with NSH + DPDK in Fuel@OPNFV, which is requested by ODL project

Requirements

Requirement Version/Comment
Mirantis OpenStack compatibility 8.0

Recommendations

None.

Limitations

None.

Installation Guide

Openvswitch plugin installation

  1. Clone the fuel-plugin-ovs repo from stackforge:

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

     pip install fuel-plugin-builder
    
  3. Build Openvswitch Fuel plugin:

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

  5. Move this file to the Fuel Master node with secure copy (scp):

     scp fuel-plugin-ovs-[x.x.x].rpm root@<the_Fuel_Master_node_IP address>:/tmp
    
  6. While logged in Fuel Master install the Openvswitch plugin:

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

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

User Guide

Openvswitch plugin configuration

  1. Create a new environment with the Fuel UI wizard.
  2. Click on the Settings tab of the Fuel web UI.
  3. Scroll down the page, select the plugin checkbox.

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

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-ovs/

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

None.

Known issues

None.

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][ovs].

Reporting Bugs

Bugs should be filled on the Launchpad fuel-plugins project (not GitHub) with the tag ovs.

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