neutron-lbaas/devstack
Richard Theis e16455dfc3 LBaaS V2 service not needed with Octavia driver
The q-lbaasv2 screen service deployed by DevStack is not needed
when the Octavia driver is used. Running the service will confuse
operators and simply generate error messages in the log. The
service will still be run for other drivers, such as HAProxy, that
require the service. In addition, the README was updated to explain
how to configure other drivers and to use the correct git tags for
Octavia.

Change-Id: Icad7da99641cb0e87e51bb90999dcb44ae738ffd
Closes-Bug: #1509475
(cherry picked from commit aa951bcbc8)
2015-11-27 13:41:34 +00:00
..
samples Set Octavia as the reference LBaaSv2 driver 2015-09-22 00:48:21 +00:00
README.md LBaaS V2 service not needed with Octavia driver 2015-11-27 13:41:34 +00:00
plugin.sh LBaaS V2 service not needed with Octavia driver 2015-11-27 13:41:34 +00:00
settings LBaaS V2 service not needed with Octavia driver 2015-11-27 13:41:34 +00:00

README.md

This directory contains the neutron-lbaas devstack plugin. To configure the neutron load balancer, in the local section, you will need to enable the neutron-lbaas devstack plugin and enable the LBaaS service by editing the local section of your local.conf file.

Octavia is the LBaaS V2 reference service provider and is used in the examples below. Enabling another service provider, such as the Haproxy, is also supported. This can be done by enabling the driver plugin, if applicable, and setting the appropriate service provider value for NEUTRON_LBAAS_SERVICE_PROVIDERV2. In addition, you can enable multiple service providers by enabling the applicable driver plugins and space-delimiting the service provider values in NEUTRON_LBAAS_SERVICE_PROVIDERV2.

  1. Enable the plugins

To enable the plugin, add a line of the form:

enable_plugin neutron-lbaas <neutron-lbaas GITURL> [GITREF]
enable_plugin octavia <octavia GITURL> [GITREF]

where

<neutron-lbaas GITURL> is the URL of a neutron-lbaas repository
<octavia GITURL> is the URL of a octavia repository
[GITREF] is an optional git ref (branch/ref/tag).  The default is
         master.

For example

enable_plugin neutron-lbaas https://git.openstack.org/openstack/neutron-lbaas stable/liberty
enable_plugin octavia https://git.openstack.org/openstack/octavia 0.5.2
  1. Enable the LBaaS services

To enable the LBaaS services, add lines in the form:

ENABLED_SERVICES+=<LBAAS-FLAG>
ENABLED_SERVICES+=<OCTAVIA-FLAGS>

where

<LBAAS-FLAG> is "q-lbaasv1" for LBaaS Version 1, or "q-lbaasv2"
             for LBaaS Version 2.  "q-lbaas" is synonymous with
             "q-lbaasv1".
<OCTAVIA-FLAGS> are "octavia" the Octavia driver,
                "o-cw" the Octavia Controller Worker,
                "o-hk" the Octavia housekeeping manager,
                "o-hm" the Octavia Health Manager,
                and "o-api" the Octavia API service.

to the local section of local.conf

For example

# For LBaaS V2
ENABLED_SERVICES+=,q-lbaasv2
ENABLED_SERVICES+=,octavia,o-cw,o-hk,o-hm,o-api

For more information, see the "Externally Hosted Plugins" section of http://docs.openstack.org/developer/devstack/plugins.html.