RETIRED, Horizon UI support for Neutron LBaaS
Go to file
manchandavishal 06233c60fa Fix sphinx-docs job for sphinx >1.7
Upper requirements recently bumped sphinx from 1.6.5 to 1.7.4 which
breaks our docs job. This switches the apidocs build to use
sphinxcontrib.apidoc.

Change-Id: I1df20c2de6523c46e8bd0facbc5f7404d20a9bf2
2019-04-10 05:57:43 +00:00
devstack Fix devstack plugin clean-up 2016-07-05 15:41:29 +03:00
doc Fix sphinx-docs job for sphinx >1.7 2019-04-10 05:57:43 +00:00
neutron_lbaas_dashboard Fix neutron-lbaas-dashboard and octavia-dashboard 2019-03-18 17:19:44 +00:00
releasenotes/notes Mark neutron-lbaas-dashboard as deprecated 2018-02-03 21:28:35 +00:00
.coveragerc Change ignore-errors to ignore_errors 2015-09-21 14:32:11 +00:00
.eslintrc Update npm dependencies 2016-01-26 22:49:38 +00:00
.gitignore Updating for new sphinx docs jobs 2018-01-19 12:18:55 +08:00
.gitreview Added .gitreview 2015-07-28 18:36:21 +00:00
.mailmap Initial cookiecutter commit 2015-08-07 15:41:49 -06:00
.zuul.yaml Add nodejs10 jobs on bionic. 2019-03-18 08:46:23 +00:00
CONTRIBUTING.rst Mark neutron-lbaas-dashboard as deprecated 2018-02-03 21:28:35 +00:00
HACKING.rst Update the hacking to latest 2018-10-07 11:33:00 -04:00
LICENSE Initial cookiecutter commit 2015-08-07 15:41:49 -06:00
README.rst Merge "Update links in README" 2018-03-26 21:03:02 +00:00
babel-django.cfg Translation preparation for neutron-lbaas-dashboard 2016-09-20 03:19:59 +09:00
babel-djangojs.cfg Translation preparation for neutron-lbaas-dashboard 2016-09-20 03:19:59 +09:00
lower-constraints.txt Fix sphinx-docs job for sphinx >1.7 2019-04-10 05:57:43 +00:00
manage.py Make sure django env var is set 2015-10-01 14:24:12 +00:00
package.json Mark neutron-lbaas-dashboard as deprecated 2018-02-03 21:28:35 +00:00
requirements.txt Drop nose dependencies 2018-08-18 04:21:03 +09:00
setup.cfg Update home-page 2019-01-12 09:38:06 +00:00
setup.py Updated from global requirements 2017-03-02 11:49:09 +00:00
test-requirements.txt Drop nose dependencies 2018-08-18 04:21:03 +09:00
tox.ini Update min tox version to 2.0 2018-11-10 03:18:29 +00:00

README.rst

Team and repository tags

image

Warning

Neutron-lbaas-dashboard is now deprecated. Please see the FAQ: https://wiki.openstack.org/wiki/Neutron/LBaaS/Deprecation

neutron-lbaas-dashboard

Horizon panels for Neutron LBaaS v2

Features

  • Please see neutron-lbaas repository

Howto

  1. Package the neutron_lbaas_dashboard by running:

    python setup.py sdist

    This will create a python egg in the dist folder, which can be used to install on the horizon machine or within horizon's python virtual environment.

  2. Copy _1481_project_ng_loadbalancersv2_panel.py in neutron_lbaas_dashboard/enabled directory to openstack_dashboard/local/enabled.

  3. (Optional) Copy the policy file into horizon's policy files folder, and add this config POLICY_FILES:

    'neutron_lbaas': 'neutron_lbaas_policy.json',
  4. Django has a compressor feature that performs many enhancements for the delivery of static files. If the compressor feature is enabled in your environment (COMPRESS_OFFLINE = True), run the following commands:

    $ ./manage.py collectstatic
    $ ./manage.py compress
  5. Finally restart your web server to enable neutron-lbaas-dashboard in your Horizon:

    $ sudo service apache2 restart

Enabling neutron-lbaas-dashboard and octavia-dashboard

In general we advise against having both dashboards running at the same time to avoid confusing users, which is exaggerated since the dashboards will have the same label.

In rare circumstances, e.g. as part of a migration strategy, it might be necessary to do so. The main issue to watch out for is to avoid neutron-lbaas and Octavia getting out of sync and neutron-lbaas-dashboard showing phantom load balancers - this can be avoided if the sync between Octavia and neutron-lbaas is fully enabled.

Here is a table to show some cases:

Configuration neutron-lbaas Configuration Octavia neutron-lbaas-dashboard enabled octavia-dashboard enabled Notes
not installed v2 API enabled not supported preferred
octavia-driver v2 API disabled v1 API enabled supported not supported sync required
octavia-driver v2 API enabled v1 API enabled supported preferred sync required
octavia-proxy plugin v1 API disabled v2 API enabled Supported (but not recommended) preferred
no octavia driver but other drivers not installed preferred not supported
no octavia driver but other drivers v2 API enabled v1 API disabled preferred preferred independent services