6f438d633d
Modify the wrong document url in README.rst Change-Id: I53ffd81ab169557a65212cd5355a865d617ce2a2
116 lines
4.9 KiB
ReStructuredText
116 lines
4.9 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/octavia-dashboard/latest/
|
|
* Source: https://git.openstack.org/cgit/openstack/octavia-dashboard
|
|
* Release notes: https://docs.openstack.org/releasenotes/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``::
|
|
|
|
$ cp -a \
|
|
${OCTAVIA_DASHBOARD_DIR}/octavia_dashboard/enabled/_1482_*.py \
|
|
${HORIZON_DIR}/openstack_dashboard/local/enabled/
|
|
|
|
3. (Optional) Generate the policy file and copy into horizon's policy files
|
|
folder, and copy ``_1499_load_balancer_settings.py`` in
|
|
``octavia_dashboard/local_settings.d`` directory
|
|
to ``openstack_dashboard/local/local_settings.d``::
|
|
|
|
$ oslopolicy-policy-generator \
|
|
--config-file \
|
|
${OCTAVIA_DIR}/etc/policy/octavia-policy-generator.conf \
|
|
--output-file \
|
|
${OCTAVIA_DASHBOARD_DIR}/octavia_dashboard/conf/octavia_policy.yaml
|
|
$ cp -a \
|
|
${OCTAVIA_DASHBOARD_DIR}/octavia_dashboard/conf/octavia_policy.yaml \
|
|
${HORIZON_DIR}/openstack_dashboard/conf/
|
|
$ cp -a \
|
|
${OCTAVIA_DASHBOARD_DIR}/octavia_dashboard/local_settings.d/_1499_*.py \
|
|
${HORIZON_DIR}/openstack_dashboard/local/local_settings.d/
|
|
|
|
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 | | | | |
|
|
+---------------+-----------------+----------------+-----------+--------------+
|