From 5b9acd57bce555781f738cecf877a541fc02352c Mon Sep 17 00:00:00 2001
From: Elena Ezhova <eezhova@mirantis.com>
Date: Tue, 7 Feb 2017 19:56:23 +0400
Subject: [PATCH] Document Neutron tenant network types configuration

Change-Id: Ifa275c1590426301dc0619968801fc1203e5959d
---
 doc/source/index.rst                 |  1 +
 doc/source/neutron_configuration.rst | 57 ++++++++++++++++++++++++++++
 2 files changed, 58 insertions(+)
 create mode 100644 doc/source/neutron_configuration.rst

diff --git a/doc/source/index.rst b/doc/source/index.rst
index 945fcfe5..2cf99761 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -32,6 +32,7 @@ Advanced topics
    using_calico_instead_of_ovs
    ironic
    known_issues
+   neutron_configuration
 
 Service plugins docs
 --------------------
diff --git a/doc/source/neutron_configuration.rst b/doc/source/neutron_configuration.rst
new file mode 100644
index 00000000..b4d3fcbc
--- /dev/null
+++ b/doc/source/neutron_configuration.rst
@@ -0,0 +1,57 @@
+.. _neutron_configuration:
+
+=====================
+Neutron Configuration
+=====================
+
+This guide provides instructions on configuring Neutron with Fuel-CCP.
+
+Tenant network types
+====================
+
+By default Neutron is configured to use VxLAN segmentation but it is possible
+to specify other network types like VLAN or flat.
+
+To do so add the following lines to the ``configs.neutron`` section of the CCP
+configuration file:
+
+::
+
+    ml2:
+      tenant_network_types:
+        - "vlan"
+        - "vxlan"
+
+Here ``tenant_network_types`` is an ordered list of network types to allocate as
+tenant networks. Enabling several network types allows creating networks with
+``--provider:network_type`` equalling one of these types, if ``--provider:network_type``
+is not specified then the first type from the ``tenant_network_types`` list will
+be used.
+
+It is also possible to specify VxLAN VNI and VLAN ID ranges.
+
+VxLAN VNI ranges are configured in ``configs.neutron.ml2`` section with default range
+being "1:1000".
+
+::
+
+    ml2:
+      tenant_network_types:
+        - "vxlan"
+      vni_ranges:
+        - "1000:5000"
+
+VLAN ranges are configured per each physical network in the ``configs.neutron.physnets`` section:
+
+::
+
+    physnets:
+      - name: "physnet1"
+        bridge_name: "br-ex"
+        interface: "eno2"
+        flat: false
+        vlan_range: "1050:2050"
+
+For more information on configuring physical networks refer to the `QuickStart Guide`_.
+
+.. _QuickStart Guide: http://fuel-ccp.readthedocs.io/en/latest/quickstart.html