openstack/tripleo-docs
Code Issues Proposed changes

Add MidoNet documentation in advanced deployment

Browse Source 
Adds a new file to document how to build the overcloud using MidoNet as
a Neutron backend driver.

Co-Authored-By: Swapnil Kulkarni <me@coolsvap.net>
Depends-On: I8c6fe9ec7028178f783e7d9c0a1cc67a1517eb3d
Change-Id: I0af150aafa6114be6472689bdcdaa709560d366e
Signed-off-by: Jaume Devesa <devvesa@gmail.com>
This commit is contained in:
Jaume Devesa 2016-01-20 17:56:21 +01:00 committed by Emilien Macchi
parent 02ff45ca69
commit e29889d025
2 changed files with 50 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
doc/source/advanced_deployment/advanced_deployment.rst
View File

@ -15,5 +15,6 @@ In this chapter you will find advanced deployment of various |project| areas.
network_isolation
deploy_manila
cinder_netapp
neutron_midonet
tripleo.sh
ssl

49
doc/source/advanced_deployment/neutron_midonet.rst Normal file
View File

@ -0,0 +1,49 @@
Configuring MidoNet as a Neutron Backend
========================================
This guide assumes that your undercloud is already installed and ready to deploy
an overcloud
Deploying the overcloud
-----------------------
.. note::
You need to build the overcloud image with the `overcloud-network-midonet`_
element to have the midonet packages installed on the ``overcloud-full.qcow2``
image. If you have that image, you won't be able to run overcloud without
MidoNet, since MidoNet packages uninstall openvswitch packages.
.. _`overcloud-network-midonet`: ../basic_deployment/basic_deployment_cli.html#build-a-single-image
#. Copy the MidoNet configuration file to your home directory::
sudo cp /usr/share/openstack-tripleo-heat-templates/environments/neutron-midonet.yaml ~
#. Edit the permissions (user is typically ``stack``)::
sudo chown $USER ~/neutron-midonet.yaml
sudo chmod 644 ~/neutron-midonet.yaml
#. Edit the file. There are several commented options that you can configure.
`DO NOT EDIT THE UNCOMMENTED ONES`
#. Continue following the TripleO instructions for deploying an overcloud.
Before entering the command to deploy the overcloud, add the environment
file that you just configured as an argument::
openstack overcloud deploy --templates -e ~/neutron-midonet.yaml
#. Wait for the completion of the overcloud deployment process.
Using Network Isolation
-----------------------
MidoNet is compatible with `network isolation`_, but you can not configure the
NICs using openvswitch, but with linux bridges. So an example of deployment with
Network Isolation could be::
openstack overcloud deploy --templates -e ~/neutron-midonet.yaml \
-e /usr/share/openstack-tripleo-heat-templates/environments/network-isolation.yaml \
-e /usr/share/openstack-tripleo-heat-templates/environments/net-single-nic-linux-bridge-with-vlans.yaml
.. _`network isolation`: ./network_isolation.html