NSX: Add devstack.rst to contain all devstack config
Combine all README files into one devstack configuration file. Change-Id: I361242c9c582db7f11478e0f03dfdc9578d96d3d
This commit is contained in:
Gary Kotton
parent
1b907ce521
commit
0843feda82
155
doc/source/devstack.rst
Normal file
155
doc/source/devstack.rst
Normal file
@ -0,0 +1,155 @@
|
|||||||
|
NSX DevStack Configurations
|
||||||
|
===========================
|
||||||
|
|
||||||
|
Below are the options for configuring the NSX plugin with DevStack. Prior
|
||||||
|
to doing this DevStack needs to be downloaded. After updating the relevant
|
||||||
|
configuration file(s) run ./stack.sh
|
||||||
|
|
||||||
|
NSXv
|
||||||
|
----
|
||||||
|
|
||||||
|
LBaaS v2 Driver
|
||||||
|
~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
Add lbaas repo as an external repository and configure following flags in ``local.conf``::
|
||||||
|
|
||||||
|
[[local]|[localrc]]
|
||||||
|
enable_plugin neutron-lbaas https://git.openstack.org/openstack/neutron-lbaas
|
||||||
|
enable_service q-lbaasv2
|
||||||
|
|
||||||
|
Configure the service provider::
|
||||||
|
[[post-config|$NEUTRON_LBAAS_CONF]]
|
||||||
|
[service_providers]
|
||||||
|
service_provider = LOADBALANCERV2:VMWareEdge:neutron_lbaas.drivers.vmware.edge_driver_v2.EdgeLoadBalancerDriverV2:default
|
||||||
|
|
||||||
|
QoS Driver
|
||||||
|
~~~~~~~~~~
|
||||||
|
|
||||||
|
Enable the qos in ``local.conf``::
|
||||||
|
|
||||||
|
[[local|localrc]]
|
||||||
|
ENABLED_SERVICES=q-qos
|
||||||
|
|
||||||
|
For NSXv set the service plugin in ``local.conf``, and enable the dvs features::
|
||||||
|
|
||||||
|
[[post-config|$NEUTRON_CONF]]
|
||||||
|
[DEFAULT]
|
||||||
|
service_plugins = vmware_nsxv_qos
|
||||||
|
|
||||||
|
[[local|localrc]]
|
||||||
|
NSXV_USE_DVS_FEATURES = True
|
||||||
|
|
||||||
|
Optional: Update the nsx qos_peak_bw_multiplier in nsx.ini (default value is 2.0)::
|
||||||
|
|
||||||
|
[NSX]
|
||||||
|
qos_peak_bw_multiplier = <i.e 10.0>
|
||||||
|
|
||||||
|
L2GW Driver
|
||||||
|
~~~~~~~~~~~
|
||||||
|
|
||||||
|
Add networking-l2gw repo as an external repository and configure following flags in ``local.conf``::
|
||||||
|
|
||||||
|
[[local|localrc]]
|
||||||
|
enable_plugin networking-l2gw https://github.com/openstack/networking-l2gw
|
||||||
|
ENABLED_SERVICES+=l2gw-plugin
|
||||||
|
NETWORKING_L2GW_SERVICE_DRIVER=L2GW:vmware-nsx-l2gw:vmware_nsx.services.l2gateway.nsx_v.driver.NsxvL2GatewayDriver:default
|
||||||
|
|
||||||
|
IPAM Driver
|
||||||
|
~~~~~~~~~~~
|
||||||
|
|
||||||
|
Update the ``local.conf`` file::
|
||||||
|
|
||||||
|
[[post-config|$NEUTRON_CONF]]
|
||||||
|
[DEFAULT]
|
||||||
|
ipam_driver = vmware_nsxv_ipam
|
||||||
|
|
||||||
|
Flow Classifier
|
||||||
|
~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
Update the ``local.conf`` file::
|
||||||
|
|
||||||
|
[[local|localrc]]
|
||||||
|
enable_plugin networking-sfc https://git.openstack.org/openstack/networking-sfc master
|
||||||
|
|
||||||
|
[[post-config|$NEUTRON_CONF]]
|
||||||
|
[DEFAULT]
|
||||||
|
service_plugins = networking_sfc.services.flowclassifier.plugin.FlowClassifierPlugin
|
||||||
|
|
||||||
|
[flowclassifier]
|
||||||
|
drivers = vmware-nsxv-sfc
|
||||||
|
|
||||||
|
[nsxv]
|
||||||
|
service_insertion_profile_id = <service profile id. i.e. serviceprofile-1>
|
||||||
|
|
||||||
|
In order to prevent tenants from changing the flow classifier, please add the following
|
||||||
|
lines to the policy.json file::
|
||||||
|
|
||||||
|
"create_flow_classifier": "rule:admin_only",
|
||||||
|
"update_flow_classifier": "rule:admin_only",
|
||||||
|
"delete_flow_classifier": "rule:admin_only",
|
||||||
|
"get_flow_classifier": "rule:admin_only"
|
||||||
|
|
||||||
|
NSXv3
|
||||||
|
-----
|
||||||
|
|
||||||
|
QoS Driver
|
||||||
|
~~~~~~~~~~
|
||||||
|
|
||||||
|
Enable the qos in ``local.conf``::
|
||||||
|
|
||||||
|
[[local|localrc]]
|
||||||
|
ENABLED_SERVICES=q-qos
|
||||||
|
|
||||||
|
[[post-config|$NEUTRON_CONF]]
|
||||||
|
[DEFAULT]
|
||||||
|
service_plugins = neutron.services.qos.qos_plugin.QoSPlugin
|
||||||
|
|
||||||
|
[qos]
|
||||||
|
notification_drivers = vmware_nsxv3_message_queue
|
||||||
|
|
||||||
|
Optional: Update the nsx qos_peak_bw_multiplier in nsx.ini (default value is 2.0)::
|
||||||
|
|
||||||
|
[NSX]
|
||||||
|
qos_peak_bw_multiplier = <i.e 10.0>
|
||||||
|
|
||||||
|
L2GW Driver
|
||||||
|
~~~~~~~~~~~
|
||||||
|
|
||||||
|
Add networking-l2gw repo as an external repository and configure following flags in ``local.conf``::
|
||||||
|
|
||||||
|
[[local|localrc]]
|
||||||
|
enable_plugin networking-l2gw https://github.com/openstack/networking-l2gw
|
||||||
|
ENABLED_SERVICES+=l2gw-plugin
|
||||||
|
NETWORKING_L2GW_SERVICE_DRIVER=L2GW:vmware-nsx-l2gw:vmware_nsx.services.l2gateway.nsx_v3.driver.NsxV3Driver:default
|
||||||
|
DEFAULT_BRIDGE_CLUSTER_UUID=
|
||||||
|
|
||||||
|
IPAM Driver
|
||||||
|
~~~~~~~~~~~
|
||||||
|
|
||||||
|
Update the ``local.conf`` file::
|
||||||
|
|
||||||
|
[[post-config|$NEUTRON_CONF]]
|
||||||
|
[DEFAULT]
|
||||||
|
ipam_driver = vmware_nsxv3_ipam
|
||||||
|
|
||||||
|
Trunk Driver
|
||||||
|
~~~~~~~~~~~~
|
||||||
|
|
||||||
|
Enable trunk service and configure following flags in ``local.conf``::
|
||||||
|
|
||||||
|
[[local]|[localrc]]
|
||||||
|
# Trunk plugin NSXv3 driver config
|
||||||
|
ENABLED_SERVICES+=,q-trunk
|
||||||
|
Q_SERVICE_PLUGIN_CLASSES=trunk
|
||||||
|
|
||||||
|
TaaS Driver
|
||||||
|
~~~~~~~~~~~
|
||||||
|
|
||||||
|
Add tap-as-a-service repo as an external repository and configure following flags in ``local.conf``::
|
||||||
|
|
||||||
|
[[local]|[localrc]]
|
||||||
|
# TaaS plugin NSXv3 driver config
|
||||||
|
enable_plugin tap-as-a-service https://github.com/openstack/tap-as-a-service
|
||||||
|
enable_service taas
|
||||||
|
TAAS_SERVICE_DRIVER=TAAS:vmware_nsx_taas:vmware_nsx.services.neutron_taas.nsx_v3.driver.NsxV3Driver:default
|
||||||
|
|
||||||
@ -1,30 +0,0 @@
|
|||||||
===============================================================
|
|
||||||
Enabling NSX Flow Classifier for service insertion in DevStack
|
|
||||||
===============================================================
|
|
||||||
|
|
||||||
1. Download DevStack
|
|
||||||
|
|
||||||
2. Update the ``local.conf`` file::
|
|
||||||
|
|
||||||
[[local|localrc]]
|
|
||||||
enable_plugin networking-sfc https://git.openstack.org/openstack/networking-sfc master
|
|
||||||
|
|
||||||
[[post-config|$NEUTRON_CONF]]
|
|
||||||
[DEFAULT]
|
|
||||||
service_plugins = networking_sfc.services.flowclassifier.plugin.FlowClassifierPlugin
|
|
||||||
|
|
||||||
[flowclassifier]
|
|
||||||
drivers = vmware-nsxv-sfc
|
|
||||||
|
|
||||||
[nsxv]
|
|
||||||
service_insertion_profile_id = <service profile id. i.e. serviceprofile-1>
|
|
||||||
|
|
||||||
3. In order to prevent tenants from changing the flow classifier, please add the following
|
|
||||||
lines to the policy.json file:
|
|
||||||
|
|
||||||
"create_flow_classifier": "rule:admin_only",
|
|
||||||
"update_flow_classifier": "rule:admin_only",
|
|
||||||
"delete_flow_classifier": "rule:admin_only",
|
|
||||||
"get_flow_classifier": "rule:admin_only"
|
|
||||||
|
|
||||||
4. run ``stack.sh``
|
|
||||||
@ -1,13 +0,0 @@
|
|||||||
================================================================
|
|
||||||
Enabling NSXv IPAM for external & provider networks in Devstack
|
|
||||||
================================================================
|
|
||||||
|
|
||||||
1. Download DevStack
|
|
||||||
|
|
||||||
2. Update the ``local.conf`` file::
|
|
||||||
|
|
||||||
[[post-config|$NEUTRON_CONF]]
|
|
||||||
[DEFAULT]
|
|
||||||
ipam_driver = vmware_nsxv_ipam
|
|
||||||
|
|
||||||
3. run ``stack.sh``
|
|
||||||
@ -1,13 +0,0 @@
|
|||||||
=================================================================
|
|
||||||
Enabling NSXv3 IPAM for external & provider networks in Devstack
|
|
||||||
=================================================================
|
|
||||||
|
|
||||||
1. Download DevStack
|
|
||||||
|
|
||||||
2. Update the ``local.conf`` file::
|
|
||||||
|
|
||||||
[[post-config|$NEUTRON_CONF]]
|
|
||||||
[DEFAULT]
|
|
||||||
ipam_driver = vmware_nsxv3_ipam
|
|
||||||
|
|
||||||
3. run ``stack.sh``
|
|
||||||
@ -1,35 +0,0 @@
|
|||||||
============================================
|
|
||||||
Enabling NSX L2 Gateway Plugin in DevStack
|
|
||||||
============================================
|
|
||||||
|
|
||||||
Following steps are meant for L2GW service in neutron for stable/mitaka* release onwards.
|
|
||||||
|
|
||||||
- Download DevStack
|
|
||||||
|
|
||||||
- Add networking-l2gw repo as an external repository and configure following flags in ``local.conf``::
|
|
||||||
|
|
||||||
[[local|localrc]]
|
|
||||||
enable_plugin networking-l2gw https://github.com/openstack/networking-l2gw
|
|
||||||
ENABLED_SERVICES+=l2gw-plugin
|
|
||||||
|
|
||||||
- For NSX|v3 include the following additional flags in ``local.conf``::
|
|
||||||
|
|
||||||
[[local|localrc]]
|
|
||||||
NETWORKING_L2GW_SERVICE_DRIVER=L2GW:vmware-nsx-l2gw:vmware_nsx.services.l2gateway.nsx_v3.driver.NsxV3Driver:default
|
|
||||||
DEFAULT_BRIDGE_CLUSTER_UUID=
|
|
||||||
|
|
||||||
- For NSX|V include the following additional flags in ``local.conf``::
|
|
||||||
|
|
||||||
[[local|localrc]]
|
|
||||||
NETWORKING_L2GW_SERVICE_DRIVER=L2GW:vmware-nsx-l2gw:vmware_nsx.services.l2gateway.nsx_v.driver.NsxvL2GatewayDriver:default
|
|
||||||
|
|
||||||
- Run ``stack.sh``
|
|
||||||
|
|
||||||
\* Configuration for stable/liberty release in ``local.conf``::
|
|
||||||
|
|
||||||
[[local|localrc]]
|
|
||||||
enable_plugin networking-l2gw https://github.com/openstack/networking-l2gw
|
|
||||||
NSX_L2GW_DRIVER='vmware_nsx.services.l2gateway.nsx_v3.driver.NsxV3Driver' # NSXv3 driver
|
|
||||||
NSX_L2GW_DRIVER='vmware_nsx.services.l2gateway.nsx_v.driver.NsxvL2GatewayDriver' # NSX|V driver
|
|
||||||
Q_SERVICE_PLUGIN_CLASSES=vmware_nsx_l2gw
|
|
||||||
DEFAULT_BRIDGE_CLUSTER_UUID=
|
|
||||||
@ -1,13 +0,0 @@
|
|||||||
=================================================
|
|
||||||
Enabling NSX Tap-as-a-Service Plugin in DevStack
|
|
||||||
=================================================
|
|
||||||
|
|
||||||
1. Download DevStack
|
|
||||||
|
|
||||||
2. Add tap-as-a-service repo as an external repository and configure following flags in ``local.conf``::
|
|
||||||
|
|
||||||
[[local]|[localrc]]
|
|
||||||
# TaaS plugin NSXv3 driver config
|
|
||||||
enable_plugin tap-as-a-service https://github.com/openstack/tap-as-a-service
|
|
||||||
enable_service taas
|
|
||||||
TAAS_SERVICE_DRIVER=TAAS:vmware_nsx_taas:vmware_nsx.services.neutron_taas.nsx_v3.driver.NsxV3Driver:default
|
|
||||||
@ -1,35 +0,0 @@
|
|||||||
============================================
|
|
||||||
Enabling NSX QoS in DevStack
|
|
||||||
============================================
|
|
||||||
|
|
||||||
1. Download DevStack
|
|
||||||
|
|
||||||
2. Enable the qos in ``local.conf``::
|
|
||||||
|
|
||||||
[[local|localrc]]
|
|
||||||
ENABLED_SERVICES=q-qos
|
|
||||||
|
|
||||||
3. For NSXv set the service plugin in ``local.conf``, and enable the dvs features::
|
|
||||||
|
|
||||||
[[post-config|$NEUTRON_CONF]]
|
|
||||||
[DEFAULT]
|
|
||||||
service_plugins = vmware_nsxv_qos
|
|
||||||
|
|
||||||
[[local|localrc]]
|
|
||||||
NSXV_USE_DVS_FEATURES = True
|
|
||||||
|
|
||||||
4. For NSXv3 set the service plugin and notification_driver in ``local.conf``::
|
|
||||||
|
|
||||||
[[post-config|$NEUTRON_CONF]]
|
|
||||||
[DEFAULT]
|
|
||||||
service_plugins = neutron.services.qos.qos_plugin.QoSPlugin
|
|
||||||
|
|
||||||
[qos]
|
|
||||||
notification_drivers = vmware_nsxv3_message_queue
|
|
||||||
|
|
||||||
5. Optional: Update the nsx qos_peak_bw_multiplier in nsx.ini (default value is 2.0)::
|
|
||||||
|
|
||||||
[NSX]
|
|
||||||
qos_peak_bw_multiplier = <i.e 10.0>
|
|
||||||
|
|
||||||
6. run ``stack.sh``
|
|
||||||
@ -1,12 +0,0 @@
|
|||||||
=========================================
|
|
||||||
Enabling NSX trunk driver using DevStack
|
|
||||||
=========================================
|
|
||||||
|
|
||||||
1. Download DevStack
|
|
||||||
|
|
||||||
2. Enable trunk service and configure following flags in ``local.conf``::
|
|
||||||
|
|
||||||
[[local]|[localrc]]
|
|
||||||
# Trunk plugin NSXv3 driver config
|
|
||||||
ENABLED_SERVICES+=,q-trunk
|
|
||||||
Q_SERVICE_PLUGIN_CLASSES=trunk
|
|
||||||
Loading…
x
Reference in New Issue
Block a user