Update docs
- Start using OSC instead of neutron CLI - Fix description of speaker scheduling - Increase readability - Fix some minor issues Change-Id: I354c33bb825a8ec58e46a13a0a9e9f412ec01541 Closes-Bug: 1750562
This commit is contained in:
parent
3e10853df1
commit
1e5d33f80e
@ -10,7 +10,8 @@
|
|||||||
additions are following::
|
additions are following::
|
||||||
|
|
||||||
cd devstack
|
cd devstack
|
||||||
cat << EOF >> local.conf
|
cat << EOF > local.conf
|
||||||
|
> [[local|localrc]]
|
||||||
> enable_plugin neutron-dynamic-routing https://git.openstack.org/openstack/neutron-dynamic-routing
|
> enable_plugin neutron-dynamic-routing https://git.openstack.org/openstack/neutron-dynamic-routing
|
||||||
> EOF
|
> EOF
|
||||||
|
|
||||||
@ -20,21 +21,23 @@
|
|||||||
|
|
||||||
Notes:
|
Notes:
|
||||||
|
|
||||||
1. In default case, neutron-dynamic-routing is installed in allinone mode.
|
1. In the default case, neutron-dynamic-routing is installed in allinone mode.
|
||||||
In multiple nodes environment, for controller node::
|
In multiple nodes environment, for controller node::
|
||||||
cd devstack
|
cd devstack
|
||||||
cat << EOF >> local.conf
|
cat << EOF > local.conf
|
||||||
|
> [[local|localrc]]
|
||||||
> enable_plugin neutron-dynamic-routing https://git.openstack.org/openstack/neutron-dynamic-routing
|
> enable_plugin neutron-dynamic-routing https://git.openstack.org/openstack/neutron-dynamic-routing
|
||||||
> DR_MODE=dr_plugin
|
> DR_MODE=dr_plugin
|
||||||
> EOF
|
> EOF
|
||||||
|
|
||||||
For the nodes where you want to run dr-agent::
|
For the nodes where you want to run dr-agent::
|
||||||
cd devstack
|
cd devstack
|
||||||
cat << EOF >> local.conf
|
cat << EOF > local.conf
|
||||||
|
> [[local|localrc]]
|
||||||
> enable_plugin neutron-dynamic-routing https://git.openstack.org/openstack/neutron-dynamic-routing
|
> enable_plugin neutron-dynamic-routing https://git.openstack.org/openstack/neutron-dynamic-routing
|
||||||
> DR_MODE=dr_agent
|
> DR_MODE=dr_agent
|
||||||
> EOF
|
> EOF
|
||||||
|
|
||||||
2. In default case, protocol BGP is enabled for neutron-dynamic-routing.
|
2. In the default case, protocol BGP is enabled for neutron-dynamic-routing.
|
||||||
You can change "DR_SUPPORTED_PROTOCOLS" in "devstack/settings" to protocols wanted.
|
You can change "DR_SUPPORTED_PROTOCOLS" in "devstack/settings" to protocols wanted.
|
||||||
|
|
||||||
|
@ -26,8 +26,8 @@ Testing
|
|||||||
=======
|
=======
|
||||||
|
|
||||||
Dynamic routing enables advertisement of self-service network prefixes to physical network
|
Dynamic routing enables advertisement of self-service network prefixes to physical network
|
||||||
devices that support dynamic routing protocol such as routers. Neutron dynamic routing project that
|
devices that support a dynamic routing protocol, such as routers. The Neutron dynamic routing project
|
||||||
consists of a service plugin-in and agent can advertise neutron private network to outside of
|
consists of a service plugin-in and an agent that can advertise Neutron private network to outside of
|
||||||
OpenStack. This document will describe how to test the Dynamic Routing functionalities, introduce
|
OpenStack. This document will describe how to test the Dynamic Routing functionalities, introduce
|
||||||
what the environment architecture is for dynamic routing test and show how to setup dynamic routing
|
what the environment architecture is for dynamic routing test and show how to setup dynamic routing
|
||||||
environment using Devstack.
|
environment using Devstack.
|
||||||
@ -35,9 +35,9 @@ environment using Devstack.
|
|||||||
Environment Architecture
|
Environment Architecture
|
||||||
-------------------------
|
-------------------------
|
||||||
|
|
||||||
Using the following example architecture as a test environment to deploy neutron-dynamic-routing in
|
Use the following example architecture as a test environment to deploy neutron-dynamic-routing in
|
||||||
your environment. The example architecture will deploy an all-in-one OpenStack and pick up an Ubuntu
|
your environment. The example architecture will deploy an all-in-one OpenStack and connect to an Ubuntu
|
||||||
VM running Quagga as a router outside of OpenStack . See following::
|
VM running Quagga as a router outside of OpenStack. See following::
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@ -49,11 +49,12 @@ VM running Quagga as a router outside of OpenStack . See following::
|
|||||||
| +--------------+
|
| +--------------+
|
||||||
| |
|
| |
|
||||||
|10.156.18.21 | External Network(172.24.4.0/24)
|
|10.156.18.21 | External Network(172.24.4.0/24)
|
||||||
-------------------------------------------------------------------------------------------------- |ETH0 |br-ex
|
--------------------------------------------------------------------------------------------------
|
||||||
|
|eth0
|
||||||
+---------------------------------------+
|
+---------------------------------------+
|
||||||
| | | |
|
| | |
|
||||||
| | | |
|
| | br-ex |
|
||||||
| | +-------+ |
|
| +----------------+ |
|
||||||
| | |172.24.4.1 |
|
| | |172.24.4.1 |
|
||||||
| +------------+ +-------+ |
|
| +------------+ +-------+ |
|
||||||
| | | |Router | |
|
| | | |Router | |
|
||||||
@ -75,7 +76,7 @@ Devstack Setup
|
|||||||
|
|
||||||
git clone https://git.openstack.org/openstack-dev/devstack.git
|
git clone https://git.openstack.org/openstack-dev/devstack.git
|
||||||
|
|
||||||
2. Enable neutron-dynamic-routing::
|
2. Enable neutron-dynamic-routing by including this in your local.conf file::
|
||||||
|
|
||||||
[[local|localrc]]
|
[[local|localrc]]
|
||||||
enable_plugin neutron-dynamic-routing https://git.openstack.org/openstack/neutron-dynamic-routing
|
enable_plugin neutron-dynamic-routing https://git.openstack.org/openstack/neutron-dynamic-routing
|
||||||
@ -103,9 +104,9 @@ it on Ubuntu Linux.
|
|||||||
$ sudo chown quagga.quagga /etc/quagga/zebra.conf
|
$ sudo chown quagga.quagga /etc/quagga/zebra.conf
|
||||||
$ sudo chmod 640 /etc/quagga/zebra.conf
|
$ sudo chmod 640 /etc/quagga/zebra.conf
|
||||||
|
|
||||||
3. Update quagga deamon file.
|
3. Update quagga daemon file.
|
||||||
|
|
||||||
You can enable/disable the daemons routing in the /etc/quagga/daemons file. Update /etc/quagga/deamons to enable zebra and bgp::
|
You can enable/disable the daemons routing in the /etc/quagga/daemons file. Update /etc/quagga/daemons to enable zebra and bgp::
|
||||||
|
|
||||||
zebra=yes
|
zebra=yes
|
||||||
bgpd=yes
|
bgpd=yes
|
||||||
@ -160,17 +161,17 @@ Service Test
|
|||||||
|
|
||||||
$ . devstack/openrc admin admin
|
$ . devstack/openrc admin admin
|
||||||
|
|
||||||
2. Verify the neutron dynamic routing agent is running.
|
2. Verify that the neutron dynamic routing agent is running.
|
||||||
|
|
||||||
.. code-block:: console
|
.. code-block:: console
|
||||||
|
|
||||||
$ neutron agent-list --agent-type 'BGP dynamic routing agent'
|
$ openstack network agent list --agent-type bgp
|
||||||
+--------------------+--------------------+--------------------+-------------------+-------+----------------+---------------------+
|
+--------------------+--------------------+--------------------+-------------------+-------+-------+---------------------+
|
||||||
| id | agent_type | host | availability_zone | alive | admin_state_up | binary |
|
| ID | Agent Type | Host | Availability Zone | Alive | State | Binary |
|
||||||
+--------------------+--------------------+--------------------+-------------------+-------+----------------+---------------------+
|
+--------------------+--------------------+--------------------+-------------------+-------+-------+---------------------+
|
||||||
| 69ad386f-e055-4284 | BGP dynamic | yang-devstack- | | :-) | True | neutron-bgp-dragent |
|
| 69ad386f-e055-4284 | BGP dynamic | yang-devstack- | | :-) | UP | neutron-bgp-dragent |
|
||||||
| -8c8e-ef9bd540705c | routing agent | ubuntu-1604 | | | | |
|
| -8c8e-ef9bd540705c | routing agent | ubuntu-1604 | | | | |
|
||||||
+--------------------+--------------------+--------------------+-------------------+-------+----------------+---------------------+
|
+--------------------+--------------------+--------------------+-------------------+-------+-------+---------------------+
|
||||||
|
|
||||||
|
|
||||||
3. Create an address scope.
|
3. Create an address scope.
|
||||||
@ -180,16 +181,15 @@ Service Test
|
|||||||
|
|
||||||
.. code-block:: console
|
.. code-block:: console
|
||||||
|
|
||||||
$ neutron address-scope-create --shared public 4
|
$ openstack address scope create --ip-version 4 --share public
|
||||||
Created a new address_scope:
|
|
||||||
+------------+--------------------------------------+
|
+------------+--------------------------------------+
|
||||||
| Field | Value |
|
| Field | Value |
|
||||||
+------------+--------------------------------------+
|
+------------+--------------------------------------+
|
||||||
| id | c02c358a-9d35-43ea-8313-986b3e4a91c0 |
|
| id | c02c358a-9d35-43ea-8313-986b3e4a91c0 |
|
||||||
| ip_version | 4 |
|
| ip_version | 4 |
|
||||||
| name | public |
|
| name | public |
|
||||||
|
| project_id | b3ac05ef10bf441fbf4aa17f16ae1e6d |
|
||||||
| shared | True |
|
| shared | True |
|
||||||
| tenant_id | b3ac05ef10bf441fbf4aa17f16ae1e6d |
|
|
||||||
+------------+--------------------------------------+
|
+------------+--------------------------------------+
|
||||||
|
|
||||||
4. Create subnet pools. The provider and tenant networks use different pools.
|
4. Create subnet pools. The provider and tenant networks use different pools.
|
||||||
@ -521,12 +521,8 @@ Service Test
|
|||||||
|
|
||||||
* Schedule the BGP speaker to ``BGP dynamic routing agent``
|
* Schedule the BGP speaker to ``BGP dynamic routing agent``
|
||||||
|
|
||||||
BGP speakers require manual scheduling to an agent. BGP speakers only form peering sessions.
|
The first BGP speaker is scheduled to the first dynamic routing agent automatically.
|
||||||
|
So for a simple setup, there is nothing to be done here.
|
||||||
.. code-block:: console
|
|
||||||
|
|
||||||
$ neutron bgp-speaker-network-add bgp-speaker provider
|
|
||||||
Added network provider to BGP speaker bgpspeaker.
|
|
||||||
|
|
||||||
* Verify scheduling of the BGP speaker to the agent.
|
* Verify scheduling of the BGP speaker to the agent.
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user