VMware-NSX: update documentation to reference VMware-NSX

Change files copied from Neutron to have the VMware NSX references.

Change-Id: I3cf8b3d37e045cb8efb0cac31efa30b93cc88d09
This commit is contained in:
Gary Kotton 2014-12-29 00:38:31 -08:00
parent b2c391c2c3
commit 0c3177235e
4 changed files with 25 additions and 44 deletions

View File

@ -13,4 +13,4 @@ Pull requests submitted through GitHub will be ignored.
Bugs should be filed on Launchpad, not GitHub:
https://bugs.launchpad.net/neutron
https://bugs.launchpad.net/vmware-nsx

View File

@ -1,12 +1,12 @@
Neutron Style Commandments
=======================
VMware-NSX Style Commandments
=============================
- Step 1: Read the OpenStack Style Commandments
http://docs.openstack.org/developer/hacking/
- Step 2: Read on
Neutron Specific Commandments
--------------------------
VMware-NSX Specific Commandments
--------------------------------
- [N319] Validate that debug level logs are not translated
- [N320] Validate that LOG messages, except debug ones, have translations

View File

@ -1,30 +1,17 @@
Welcome!
========
You have come across a cloud computing network fabric controller. It has
identified itself as "Neutron." It aims to tame your (cloud) networking!
You have come across the VMware-NSX family of driver for Neutron.
External Resources:
===================
The homepage for Neutron is: http://launchpad.net/neutron. Use this
The homepage for VMware-NSX is: http://launchpad.net/vmware-nsx. Use this
site for asking for help, and filing bugs. Code is available on
git.openstack.org at <http://git.openstack.org/cgit/openstack/neutron>.
git.openstack.org at <https://github.com/stackforge/vmware-nsx>.
The latest and most in-depth documentation on how to use Neutron is
available at: <http://docs.openstack.org>. This includes:
Neutron Administrator Guide
http://docs.openstack.org/admin-guide-cloud/content/ch_networking.html
Neutron API Reference:
http://docs.openstack.org/api/openstack-network/2.0/content/
Current Neutron developer documentation is available at:
http://wiki.openstack.org/NeutronDevelopment
For help on usage and hacking of Neutron, please send mail to
For help on usage and hacking of VMware-NSX, please send mail to
<mailto:openstack-dev@lists.openstack.org>.
For information on how to contribute to Neutron, please see the
For information on how to contribute to VMware-NSX, please see the
contents of the CONTRIBUTING.rst file.

View File

@ -1,19 +1,13 @@
Testing Neutron
=============================================================
Testing VMware-NSX
==================
Overview
--------
The unit tests (neutron/test/unit/) are meant to cover as much code as
possible and should be executed without the service running. They are
designed to test the various pieces of the neutron tree to make sure
any new changes don't break existing functionality.
The functional tests (neutron/tests/functional/) are intended to
validate actual system interaction. Mocks should be used sparingly,
if at all. Care should be taken to ensure that existing system
resources are not modified and that resources created in tests are
properly cleaned up.
The unit tests (vmware_nsx/neutron/test/unit/) are meant to cover as much
code as possible and should be executed without the service running. They
are designed to test the various pieces of the neutron and VMware NSX tree
to make sure any new changes don't break existing functionality.
Development process
-------------------
@ -85,12 +79,12 @@ interactive debugging session while using testr.
With `tox`
~~~~~~~~~~
Neutron, like other OpenStack projects, uses `tox`_ for managing the virtual
VMware NSX, like other OpenStack projects, uses `tox`_ for managing the virtual
environments for running test cases. It uses `Testr`_ for managing the running
of the test cases.
Tox handles the creation of a series of `virtualenvs`_ that target specific
versions of Python (2.6, 2.7, 3.3, etc).
versions of Python (2.7, 3.3, etc).
Testr handles the parallel execution of series of test cases as well as
the tracking of long-running tests and other things.
@ -130,19 +124,19 @@ the dot-separated path to the module you want as an argument to it.
For executing a specific test case, specify the name of the test case
class separating it from the module path with a colon.
For example, the following would run only the JSONV2TestCase tests from
neutron/tests/unit/test_api_v2.py::
For example, the following would run only the TestSubnetsV2 tests from
vmware_nsx/neutron/tests/unit/vmware/test_nsx_v_plugin.py::
$ ./run_tests.sh neutron.tests.unit.test_api_v2.JSONV2TestCase
$ ./run_tests.sh vmware_nsx.neutron.tests.unit.vmware.test_nsx_v_plugin.TestSubnetsV2
or::
$ tox -e py27 neutron.tests.unit.test_api_v2.JSONV2TestCase
$ tox -e py27 vmware_nsx.neutron.tests.unit.vmware.test_nsx_v_plugin.TestSubnetsV2
Adding more tests
~~~~~~~~~~~~~~~~~
Neutron has a fast growing code base and there is plenty of areas that
VMware NSX has a fast growing code base and there is plenty of areas that
need to be covered by unit and functional tests.
To get a grasp of the areas where tests are needed, you can check
@ -169,7 +163,7 @@ after a tox run and reused for debugging::
$ . .tox/venv/bin/activate
$ python -m testtools.run [test module path]
Tox packages and installs the neutron source tree in a given venv
Tox packages and installs the vmware-nsx source tree in a given venv
on every invocation, but if modifications need to be made between
invocation (e.g. adding more pdb statements), it is recommended
that the source tree be installed in the venv in editable mode::