Horizon Web interface for Freezer backup, restore and disaster recovery platform

Go to file

memo d4c7b4d2f0 Fix minor bugs in freezer dashboard freezer dashboard now handles slashes in the dynamic urls improve resilience of backup table updated backup_id encoding when it contains slash or back slash Change-Id: I66e6973e5b55cd8845ec90413867fe5694f1433a		2015-10-16 17:39:54 +01:00
freezer_ui	Fix minor bugs in freezer dashboard	2015-10-16 17:39:54 +01:00
tests	Prepare UI for split	2015-08-28 17:14:19 +01:00
_50_freezer.py	Prepare UI for split	2015-08-28 17:14:19 +01:00
.gitignore	Update dashboard for new freezer apiclient new version	2015-10-07 15:54:27 +01:00
.pylintrc	Update dashboard for new freezer apiclient new version	2015-10-07 15:54:27 +01:00
MANIFEST.in	First version of setup.py	2015-06-21 18:10:07 +00:00
README.rst	Improve REAMDE file	2015-10-09 14:07:15 +01:00
requirements.txt	Fix minor bugs in freezer dashboard	2015-10-16 17:39:54 +01:00
setup.cfg	First version of setup.py	2015-06-21 18:10:07 +00:00
setup.py	First version of setup.py	2015-06-21 18:10:07 +00:00
test-requirements.txt	Prepare UI for split	2015-08-28 17:14:19 +01:00
tox.ini	Prepare UI for split	2015-08-28 17:14:19 +01:00

README.rst

Freezer - Horizon Dashboard

Requirements

Freezer Freezer Dashboard requires a freezer API client to be installed in the same environment as horizon:

git clone https://github.com/stackforge/freezer
cd freezer
python setup.py install (is important that freezer is installed from source and not with pip)

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

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

API registration

https://github.com/stackforge/freezer-api/blob/master/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-web-ui

# cd freezer-web-ui

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

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

# cd /opt/stack/horizon/

# pip install -r requirements.txt

# make sure freezer is installed from source as detailed in the first step

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

Production Installation

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

# git clone https://github.com/stackforge/freezer-web-ui

# cd freezer-web-ui

# cp _50_freezer.py  /opt/stack/horizon/openstack_dashboard/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

Create a virtual environment:

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

Activate the virtual environment:
```
. ./.venv/bin/activate
```
Install the requirements:
```
pip install -r test-requirements.txt
```

Run the tests:

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

Test coverage

Collect coverage information:

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

View coverage report:
```
coverage report
```

Tox

Run tox:
```
tox -v
```

Development under proxy

If you are developing or deploying under proxies remember to set no_proxies for:

freezer-api endpoint
keystone endpoint