Metadata-Version: 1.1
Name: octavia-dashboard
Version: 2.0.3.dev1
Summary: Horizon panels for Octavia
Home-page: https://docs.openstack.org/octavia-dashboard/latest/
Author: OpenStack
Author-email: openstack-dev@lists.openstack.org
License: UNKNOWN
Description: ========================
        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
        * 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 |                 |                |           |              |
        +---------------+-----------------+----------------+-----------+--------------+
        
        
Platform: UNKNOWN
Classifier: Environment :: OpenStack
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
