========================
Team and repository tags
========================
.. image:: https://governance.openstack.org/tc/badges/networking-hyperv.svg
:target: https://governance.openstack.org/tc/reference/tags/index.html
.. Change things from this point on
=================
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.
* Free software: Apache license
* Documentation: http://docs.openstack.org/developer/networking-hyperv
* Source: https://opendev.org/openstack/networking-hyperv
* Bugs: https://bugs.launchpad.net/networking-hyperv
* Release notes: https://docs.openstack.org/releasenotes/networking-hyperv/index.html
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 networking_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 -v``.
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 -v``.
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.
Raw data
{
"_id": null,
"home_page": "https://github.com/openstack/networking-hyperv",
"name": "networking-hyperv",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "openstack neutron hyper-v networking",
"author": "OpenStack",
"author_email": "openstack-discuss@lists.openstack.org",
"download_url": "https://files.pythonhosted.org/packages/02/ee/f4f2c55b2cdb77938858b7c51401ed15854a8f5a8d0c0ee85d8f4e8be2b0/networking-hyperv-14.0.0.tar.gz",
"platform": null,
"description": "========================\nTeam and repository tags\n========================\n\n.. image:: https://governance.openstack.org/tc/badges/networking-hyperv.svg\n :target: https://governance.openstack.org/tc/reference/tags/index.html\n\n.. Change things from this point on\n\n=================\nnetworking-hyperv\n=================\n\nThis project tracks the work to integrate the Hyper-V networking with Neutron.\nThis project contains the Hyper-V Neutron Agent, Security Groups Driver, and\nML2 Mechanism Driver, which are used to properly bind neutron ports on a\nHyper-V host.\n\nThis project resulted from the neutron core vendor decomposition.\n\nSupports Python 2.7, Python 3.3, Python 3.4, and Python 3.5.\n\n* Free software: Apache license\n* Documentation: http://docs.openstack.org/developer/networking-hyperv\n* Source: https://opendev.org/openstack/networking-hyperv\n* Bugs: https://bugs.launchpad.net/networking-hyperv\n* Release notes: https://docs.openstack.org/releasenotes/networking-hyperv/index.html\n\nHow to Install\n--------------\n\nRun the following command to install the agent on the system:\n\n::\n\n C:\\networking-hyperv> python setup.py install\n\nTo use the ``neutron-hyperv-agent``, the Neutron Controller will have to be\nproperly configured. For this, the config option ``core_plugin`` in the\n``/etc/neutron/neutron.conf`` file must be set as follows:\n\n::\n\n core_plugin = neutron.plugins.ml2.plugin.Ml2Plugin\n\nAdditionally, ``hyperv`` will have to be added as a mechanism driver in the\n``/etc/neutron/plugins/ml2/ml2_conf.ini`` configuration file:\n\n::\n\n mechanism_drivers = openvswitch,hyperv\n\nIn order for these changes to take effect, the ``neutron-server`` service will\nhave to be restarted.\n\nFinally, make sure the ``tenant_network_types`` field contains network types\nsupported by Hyper-V: local, flat, vlan, gre.\n\n\nTests\n-----\n\nYou will have to install the test dependencies first to be able to run the\ntests.\n\n::\n\n C:\\networking-hyperv> pip install -r requirements.txt\n C:\\networking-hyperv> pip install -r test-requirements.txt\n\nYou can run the unit tests with the following command.\n\n::\n\n C:\\networking-hyperv> nosetests networking_hyperv\\tests\n\n\nHow to contribute\n-----------------\n\nTo contribute to this project, please go through the following steps.\n\n1. Clone the project and keep your working tree updated.\n2. Make modifications on your working tree.\n3. Run unit tests.\n4. If the tests pass, commit your code.\n5. Submit your code via ``git review -v``.\n6. Check that Jenkins and the Microsoft Hyper-V CI pass on your patch.\n7. If there are issues with your commit, amend, and submit it again via\n ``git review -v``.\n8. Wait for the patch to be reviewed.\n\n\nFeatures\n--------\n\n* Supports Flat, VLAN, GRE / NVGRE network types.\n* Supports Neutron Security Groups.\n* Contains ML2 Mechanism Driver.\n* Parallel port processing.\n\n\n\n",
"bugtrack_url": null,
"license": "Apache License, Version 2.0",
"summary": "This project tracks the work to integrate the Hyper-V networking with Neutron. This project contains the Hyper-V Neutron Agent Mixin, Security Groups Driver, ML2 Mechanism Driver and the utils modules they use in order to properly bind neutron ports on a Hyper-V host. This project resulted from the neutron core vendor decomposition.",
"version": "14.0.0",
"split_keywords": [
"openstack",
"neutron",
"hyper-v",
"networking"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "86a027cd6b87a433545452c168ebdebbcb4b6db0fedfaf3bd7240ad60bee0a56",
"md5": "a834a61f4fd7130954415decdc1203c5",
"sha256": "ae4b5e5cfcf5cb01bfa2a5e7336bf248c16370e5b40a2e6770a9783e2e65cf1e"
},
"downloads": -1,
"filename": "networking_hyperv-14.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a834a61f4fd7130954415decdc1203c5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 82572,
"upload_time": "2023-03-22T12:27:10",
"upload_time_iso_8601": "2023-03-22T12:27:10.791716Z",
"url": "https://files.pythonhosted.org/packages/86/a0/27cd6b87a433545452c168ebdebbcb4b6db0fedfaf3bd7240ad60bee0a56/networking_hyperv-14.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "02eef4f2c55b2cdb77938858b7c51401ed15854a8f5a8d0c0ee85d8f4e8be2b0",
"md5": "32e2aa409ae30965fa1d447d268599a8",
"sha256": "7718b0025affcc10ace81e6c49d203eaea1ece2773510d14be5ae41cc4497ff9"
},
"downloads": -1,
"filename": "networking-hyperv-14.0.0.tar.gz",
"has_sig": false,
"md5_digest": "32e2aa409ae30965fa1d447d268599a8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 75563,
"upload_time": "2023-03-22T12:27:12",
"upload_time_iso_8601": "2023-03-22T12:27:12.682773Z",
"url": "https://files.pythonhosted.org/packages/02/ee/f4f2c55b2cdb77938858b7c51401ed15854a8f5a8d0c0ee85d8f4e8be2b0/networking-hyperv-14.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-22 12:27:12",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "openstack",
"github_project": "networking-hyperv",
"travis_ci": false,
"coveralls": true,
"github_actions": false,
"requirements": [],
"tox": true,
"lcname": "networking-hyperv"
}
JSON
