RETIRED, further work has moved to Debian project infrastructure
Go to file
Claudiu Belu bad3da0d60 Fixes HyperVSecurityGroupsDriver for ports without security groups
If a port has security groups disabled, it might not have the
'port_security_enabled' key.

Change-Id: Ib0152b6b413e60a664bfb1cd4b485490b2c7482f
Closes-Bug: #1659527
2017-01-26 12:54:21 +02:00
doc Removes unnecessary utf-8 coding 2016-12-27 10:30:20 +08:00
hyperv Fixes HyperVSecurityGroupsDriver for ports without security groups 2017-01-26 12:54:21 +02:00
tools Add Constraints support 2016-12-23 09:49:24 +11:00
.coveragerc Change ignore-errors to ignore_errors 2015-09-21 15:00:53 +00:00
.gitignore Adds cookiecutter template 2015-02-12 15:25:21 +02:00
.gitreview Updates project repo to openstack 2015-10-19 01:13:44 +03:00
.mailmap Adds cookiecutter template 2015-02-12 15:25:21 +02:00
.testr.conf Adds cookiecutter template 2015-02-12 15:25:21 +02:00
CONTRIBUTING.rst Adds cookiecutter template 2015-02-12 15:25:21 +02:00
HACKING.rst Adds cookiecutter template 2015-02-12 15:25:21 +02:00
LICENSE Adds cookiecutter template 2015-02-12 15:25:21 +02:00
MANIFEST.in Adds cookiecutter template 2015-02-12 15:25:21 +02:00
README.rst Show team and repo badges on README 2016-11-25 17:13:05 +01:00
babel.cfg Adds cookiecutter template 2015-02-12 15:25:21 +02:00
requirements.txt Updated from global requirements 2017-01-20 00:14:23 +00:00
setup.cfg Merge "Adds QoS support" 2017-01-23 10:09:13 +00:00
setup.py Manual global-requirements sync 2015-12-15 15:58:43 +11:00
test-requirements.txt Updated from global requirements 2016-12-20 15:59:46 +00:00
tox.ini Add Constraints support 2016-12-23 09:49:24 +11:00

README.rst

Team and repository tags

image

networking-hyperv

This project tracks the work to integrate the Hyper-V networking with Neutron. This project contains the Hyper-V Neutron Agent, Security Groups Driver, and ML2 Mechanism Driver, which are used to properly bind neutron ports on a Hyper-V host.

This project resulted from the neutron core vendor decomposition.

Supports Python 2.7, Python 3.3, Python 3.4, and Python 3.5.

How to Install

Run the following command to install the agent on the system:

C:\networking-hyperv> python setup.py install

To use the neutron-hyperv-agent, the Neutron Controller will have to be properly configured. For this, the config option core_plugin in the /etc/neutron/neutron.conf file must be set as follows:

core_plugin = neutron.plugins.ml2.plugin.Ml2Plugin

Additionally, hyperv will have to be added as a mechanism driver in the /etc/neutron/plugins/ml2/ml2_conf.ini configuration file:

mechanism_drivers = openvswitch,hyperv

In order for these changes to take effect, the neutron-server service will have to be restarted.

Finally, make sure the tenant_network_types field contains network types supported by Hyper-V: local, flat, vlan, gre.

Tests

You will have to install the test dependencies first to be able to run the tests.

C:\networking-hyperv> pip install -r requirements.txt
C:\networking-hyperv> pip install -r test-requirements.txt

You can run the unit tests with the following command.

C:\networking-hyperv> nosetests hyperv\tests

How to contribute

To contribute to this project, please go through the following steps.

  1. Clone the project and keep your working tree updated.
  2. Make modifications on your working tree.
  3. Run unit tests.
  4. If the tests pass, commit your code.
  5. Submit your code via git review.
  6. Check that Jenkins and the Microsoft Hyper-V CI pass on your patch.
  7. If there are issues with your commit, amend, and submit it again via git review.
  8. Wait for the patch to be reviewed.

Features

  • Supports Flat, VLAN, GRE / NVGRE network types.
  • Supports Neutron Security Groups.
  • Contains ML2 Mechanism Driver.
  • Parallel port processing.