Merge "Update documentation for Contrail installation"
This commit is contained in:
commit
0d9ad1373c
27
CONTRAIL.md
27
CONTRAIL.md
|
@ -1,27 +0,0 @@
|
||||||
Installation
|
|
||||||
============
|
|
||||||
|
|
||||||
Deploy Contrail Mechanism Driver
|
|
||||||
--------------------------------
|
|
||||||
Contrail Mechanism Driver code is available here: https://github.com/codilime/ContrailMechanismDriver.
|
|
||||||
Please follow the instructions there to deploy Contrail Mechanism Driver.
|
|
||||||
|
|
||||||
Install Dependencies
|
|
||||||
--------------------
|
|
||||||
* https://github.com/Juniper/contrail-python-api
|
|
||||||
```bash
|
|
||||||
git clone https://github.com/Juniper/contrail-python-api
|
|
||||||
cd contrail-python-api
|
|
||||||
sudo python setup.py install
|
|
||||||
```
|
|
||||||
|
|
||||||
Configure Contrail Mechanism Driver
|
|
||||||
-----------------------------------
|
|
||||||
* In file `/etc/neutron/plugins/ml2/ml2_conf.ini`
|
|
||||||
* Make sure that in section *ml2* key *mechanism_drivers* have value **contrail_driver** in list
|
|
||||||
* In file `/opt/stack/neutron/neutron.egg-info/entry_points.txt`
|
|
||||||
* In section *neutron.ml2.mechanism_drivers* set key *contrail_driver* to **neutron.plugins.ml2.drivers.contrail_driver:ContrailMechanismDriver**
|
|
||||||
|
|
||||||
Running
|
|
||||||
=======
|
|
||||||
Neutron service need to be restarted
|
|
|
@ -21,42 +21,54 @@
|
||||||
''''''' Heading 4
|
''''''' Heading 4
|
||||||
(Avoid deeper levels because they do not render well.)
|
(Avoid deeper levels because they do not render well.)
|
||||||
|
|
||||||
============
|
=====================
|
||||||
Installation
|
Contrail Installation
|
||||||
============
|
=====================
|
||||||
|
|
||||||
Deploy Contrail Mechanism Driver
|
Recommended way of having Contrail working with gluon is to install Contrail
|
||||||
--------------------------------
|
on a separate node and configure it to use Keystone from Gluon's OpenStack.
|
||||||
|
Then deploy ContrailMechanismDriver on Gluon node.
|
||||||
Contrail Mechanism Driver code is available here:
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
|
This documment is instruction of how to configure ContrailMechanismDriver and
|
||||||
|
a summary of Contrail installation. Whole instruction is available here:
|
||||||
https://github.com/codilime/ContrailMechanismDriver.
|
https://github.com/codilime/ContrailMechanismDriver.
|
||||||
|
|
||||||
Please follow the instructions there to deploy Contrail Mechanism Driver.
|
#. Deploy Contrail Mechanism Driver
|
||||||
|
Contrail Mechanism Driver code is available here:
|
||||||
Install Dependencies
|
https://github.com/codilime/ContrailMechanismDriver. Clone repository
|
||||||
--------------------
|
|
||||||
|
|
||||||
Contrail dependency is required: ``https://github.com/Juniper/contrail-python-api``
|
|
||||||
|
|
||||||
.. code-block:: bash
|
.. code-block:: bash
|
||||||
|
|
||||||
git clone https://github.com/Juniper/contrail-python-api
|
git clone https://github.com/codilime/ContrailMechanismDriver
|
||||||
cd contrail-python-api
|
|
||||||
sudo python setup.py install
|
|
||||||
|
|
||||||
Configure Contrail Mechanism Driver
|
.. end
|
||||||
-----------------------------------
|
|
||||||
|
|
||||||
* In file ``/etc/neutron/plugins/ml2/ml2_conf.ini``:
|
then copy directory ``ContrailMechanismDriver/neutron`` into
|
||||||
* Make sure that in section **ml2** key ``mechanism_drivers`` have value **contrail_driver** in list
|
``/usr/lib/python2.7/dist-packages/``.
|
||||||
|
#. Install Dependencies
|
||||||
|
|
||||||
* In file ``/opt/stack/neutron/neutron.egg-info/entry_points.txt``
|
* https://github.com/Juniper/contrail-python-api
|
||||||
* In section **neutron.ml2.mechanism_drivers** set key ``contrail_driver`` to **neutron.plugins.ml2.drivers.contrail_driver:ContrailMechanismDriver**
|
#. Configure Contrail Mechanism Driver
|
||||||
|
|
||||||
Running
|
* In file ``/etc/neutron/plugins/ml2/ml2_conf.ini``
|
||||||
-------
|
- Make sure that in section ``[ml2]`` key ``mechanism_drivers`` have
|
||||||
|
value **contrail_driver** in list
|
||||||
|
- Add section ``[ml2_driver_contrail]`` and point to contrail controller
|
||||||
|
node
|
||||||
|
- In section ``[ml2_driver_contrail]`` key *controller* should contain
|
||||||
|
Contrail controller address (default is 127.0.0.1)
|
||||||
|
- In section ``[ml2_driver_contrail]`` key *port* should point to
|
||||||
|
Contrail controller listen port (default is 8082)
|
||||||
|
* Make sure that neutron-server reads ``ml2_conf.ini`` file during startup
|
||||||
|
(this might require to modify ``/etc/init.d/neutron-server`` file and
|
||||||
|
add ``--config-file=/etc/neutron/plugins/ml2/ml2_conf.ini`` to
|
||||||
|
:samp:`{DAEMON_ARGS}` variable
|
||||||
|
* In file ``entry_points.txt`` (location depends on neutron version and
|
||||||
|
OpenStack installation method) in section
|
||||||
|
*neutron.ml2.mechanism_drivers*
|
||||||
|
set key *contrail_driver* to
|
||||||
|
**neutron.plugins.ml2.drivers.contrail_driver:ContrailMechanismDriver**
|
||||||
|
* For Fuel based installations: ``/usr/lib/python2.7/dist-packages/neutron-<version>.egg-info/entry_points.txt``
|
||||||
|
* For devstack based installations: ``/opt/stack/neutron/neutron.egg-info/entry_points.txt``
|
||||||
|
#. Neutron service need to be restarted.
|
||||||
|
|
||||||
Neutron service need to be restarted
|
|
||||||
|
|
Loading…
Reference in New Issue