===========================
Freezer - Horizon Dashboard
===========================

Requirements
============

Freezer Dashboard requires a freezer API endpoint which you can install following this steps::

    https://github.com/stackforge/freezer/blob/master/freezer_api/README.rst

API registration
================

Register freezer api endpoint::

    https://github.com/stackforge/freezer/blob/master/freezer_api/README.rst#3-api-registration

If keystone service-create and endpoint-create are not available you can set as a fallback the following on::

    # vim /opt/stack/horizon/openstack_dashboard/local/local_settings.py

    # add FREEZER_API_URL = http://<api_url>:<port>


Dev Installation
================

In the installation procedure we'll assume your main Horizon dashboard
directory is /opt/stack/horizon/openstack_dashboard/dashboards/.


To install freezer dashboard for development you need to do the following::

    # git clone https://github.com/stackforge/freezer

    # cd freezer/horizon_web_ui

    # cp _50_freezer.py  /opt/stack/horizon/openstack_dashboard/local/enabled/
    
    # modify _50_freezer.py (line 9) and point the path to the freezer repo.

    # cd /opt/stack/horizon/

    # ./run_tests.sh --runserver 0.0.0.0:8000

    # pip install -r requirements.txt


Production Installation
=======================

To deploy freezer dashboard in production you need to do the following::

    # git clone https://github.com/stackforge/freezer

    # cd freezer/horizon_web_ui

    # cp _50_freezer.py  /opt/stack/horizon/openstack_dashboard/local/enabled/

    # modify _50_freezer.py (line 9) and point the path to the freezer repo.

    # restart apache2 service


A new tab called "Disaster Recovery" will be on your panels.


Running the unit tests
======================

1. Create a virtual environment::

    virtualenv --no-site-packages -p /usr/bin/python2.7 .venv

2. Activate the virtual environment::

    . ./.venv/bin/activate

3. Install the requirements::

    pip install -r test-requirements.txt

4. Run the tests::

    python manage.py test . --settings=freezer_ui.tests.settings

Test coverage
-------------

1. Collect coverage information::

    coverage run --source='.' --omit='.venv/*' manage.py test . --settings=freezer_ui.tests.settings

2. View coverage report::

    coverage report