Update LBaaS docs/config to use simple plugin names

This patch adds a release note for the update to the neutron
plugin_base configuration and ensures that LBaaS and Horizon
are appropriately set to use the updated configuration.

Change-Id: I7d49b9d417a1efe7f196f772123645cb6e0dec71
Depends-On: I32ff704f51b472e422be8c39a4534b1c13e43bf3

doc/source/install-guide/configure-lbaas.rst

@@ -37,9 +37,9 @@ Deploying LBaaS v1
    .. code-block:: yaml
 
       neutron_plugin_base:
-        - neutron.services.l3_router.l3_router_plugin.L3RouterPlugin
-        - neutron.services.metering.metering_plugin.MeteringPlugin
-        - neutron_lbaas.services.loadbalancer.plugin.LoadBalancerPlugin
+        - router
+        - metering
+        - lbaas
 
    Ensure that ``neutron_plugin_base`` includes all of the plugins that you
    want to deploy with Neutron **in addition** to the LBaaS plugin.
@@ -62,9 +62,9 @@ Deploying LBaaS v2
    .. code-block:: yaml
 
       neutron_plugin_base:
-        - neutron.services.l3_router.l3_router_plugin.L3RouterPlugin
-        - neutron.services.metering.metering_plugin.MeteringPlugin
-        - neutron_lbaas.services.loadbalancer.plugin.LoadBalancerPluginv2
+        - router
+        - metering
+        - lbaasv2
 
    Ensure that ``neutron_plugin_base`` includes all of the plugins that you
    want to deploy with Neutron **in addition** to the LBaaS plugin.

playbooks/inventory/group_vars/hosts.yml

@@ -227,7 +227,8 @@ keystone_service_in_ldap: "{{ service_ldap_backend_enabled }}"
 horizon_service_region: "{{ service_region }}"
 horizon_enable_cinder_backup: "{% if cinder_service_backup_program_enabled is defined and cinder_service_backup_program_enabled | bool %}True{% else %}False{% endif %}"
 # LBaaS panels are working only for LBaaS v1 at this time.
-horizon_enable_neutron_lbaas: "{% if neutron_plugin_base is defined and 'neutron_lbaas.services.loadbalancer.plugin.LoadBalancerPlugin' in neutron_plugin_base %}True{% else %}False{% endif %}"
+#TODO(odyssey4me): Remove the classpath from this conditional in the Newton cycle.
+horizon_enable_neutron_lbaas: "{% if neutron_plugin_base is defined and ('lbaas' in neutron_plugin_base or 'neutron_lbaas.services.loadbalancer.plugin.LoadBalancerPlugin' in neutron_plugin_base) %}True{% else %}False{% endif %}"
 horizon_rabbitmq_userid: horizon
 horizon_rabbitmq_vhost: /horizon
 

releasenotes/notes/updated-neutron-plugin_base-25b5dcacc87acd0f.yaml

@@ -0,0 +1,11 @@
+---
+upgrade:
+  - The ``neutron_plugin_base`` variable has been modifed to use the friendly
+    names. Deployers should change any customisations to this variable to
+    ensure that the customisation makes use of the short names instead of
+    the full class path.
+  - Database migration tasks have been added for the LBaaS neutron plugins.
+deprecations:
+  - The old class path names used within the ``neutron_plugin_base``
+    have been deprecated in favor of the friendly names. Support for the use
+    of the class path plugins will be removed in the OpenStack Newton cycle.