98 lines
4.1 KiB
ReStructuredText
98 lines
4.1 KiB
ReStructuredText
========================
|
|
Team and repository tags
|
|
========================
|
|
|
|
.. image:: https://governance.openstack.org/tc/badges/octavia-dashboard.svg
|
|
:target: https://governance.openstack.org/tc/reference/tags/index.html
|
|
|
|
.. Change things from this point on
|
|
|
|
=================
|
|
octavia-dashboard
|
|
=================
|
|
|
|
Horizon panels for Octavia
|
|
|
|
* Free software: Apache license
|
|
* Documentation: https://docs.openstack.org/developer/octavia-dashboard
|
|
* Source: https://git.openstack.org/cgit/openstack/octavia-dashboard
|
|
* Bugs: https://storyboard.openstack.org/#!/project/909
|
|
|
|
Features
|
|
--------
|
|
|
|
* Please see octavia repository
|
|
|
|
|
|
Howto
|
|
-----
|
|
|
|
1. Package the octavia_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 ``_1482_project_load_balancer_panel.py`` in
|
|
``octavia_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``::
|
|
|
|
'octavia': 'octavia_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 octavia-dashboard
|
|
in your Horizon::
|
|
|
|
$ sudo service apache2 restart
|
|
|
|
Enabling octavia-dashboard and neutron-lbaas-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 | Configuration | neutron-lbaas- | octavia- | Notes |
|
|
| neutron-lbaas | Octavia | dashboard | dashboard | |
|
|
| | | enabled | enabled | |
|
|
+---------------+-----------------+----------------+-----------+--------------+
|
|
| not installed | v2 API enabled | not supported | preferred | |
|
|
+---------------+-----------------+----------------+-----------+--------------+
|
|
| octavia-driver| v2 API disabled | supported | not | sync |
|
|
| | v1 API enabled | | supported | required |
|
|
+---------------+-----------------+----------------+-----------+--------------+
|
|
| octavia-driver| v2 API enabled | supported | preferred | sync |
|
|
| | v1 API enabled | | | required |
|
|
+---------------+-----------------+----------------+-----------+--------------+
|
|
| octavia-proxy | v1 API disabled | Supported (but | preferred | |
|
|
| plugin | v2 API enabled | not | | |
|
|
| | | recommended) | | |
|
|
+---------------+-----------------+----------------+-----------+--------------+
|
|
| no octavia | not installed | preferred | not | |
|
|
| driver but | | | supported | |
|
|
| other drivers | | | | |
|
|
+---------------+-----------------+----------------+-----------+--------------+
|
|
| no octavia | v2 API enabled | preferred | preferred | independent |
|
|
| driver but | v1 API disabled | | | services |
|
|
| other drivers | | | | |
|
|
+---------------+-----------------+----------------+-----------+--------------+ |