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

Go to file

Jenkins 308b8c4d67 Merge "Remove link to modindex"		2017-02-02 16:26:20 +00:00
devstack	Run normal tests instead of tempest tests in gate jobs	2016-10-21 09:35:46 +00:00
disaster_recovery	Merge "Use 'trimmed' for blocktrans in html page"	2017-02-02 16:17:23 +00:00
doc	Merge "Remove link to modindex"	2017-02-02 16:26:20 +00:00
tools	Updated tox.ini to support new test environment	2016-09-04 18:08:50 +01:00
.gitignore	Fixed freezer-web-ui directory when install	2016-03-16 05:27:24 -04:00
.gitreview	Add .gitreview	2015-10-19 09:44:41 +01:00
.pylintrc	Remove empty tabs in freezer dashboard	2015-12-08 13:58:08 +00:00
LICENSE	Added LICENSE file to freezer dashboard	2015-11-09 17:10:00 +00:00
MANIFEST.in	First version of setup.py	2015-06-21 18:10:07 +00:00
README.rst	Fix some synctactic markup errors	2017-01-20 14:15:15 +08:00
babel-django.cfg	i18n translation support	2016-04-01 11:58:50 +03:00
babel-djangojs.cfg	i18n translation support	2016-04-01 11:58:50 +03:00
manage.py	Updated tox.ini to support new test environment	2016-09-04 18:08:50 +01:00
requirements.txt	Switch to python-freezerclient	2016-11-30 16:29:07 +03:00
run_tests.sh	Updated tox.ini to support new test environment	2016-09-04 18:08:50 +01:00
setup.cfg	Fix jenkins failed	2016-08-03 05:56:26 +00:00
setup.py	Updated from global requirements	2016-09-13 09:35:49 +00:00
test-requirements.txt	Updated from global requirements	2017-01-25 20:20:01 +00:00
tox.ini	Don't include openstack/common in flake8 exclude list	2016-10-28 19:59:14 +05:30

README.rst

Team and repository tags

Freezer - Horizon Dashboard

freezer-web-ui is a horizon plugin based in django aimed at providing an interaction with freezer

Release management: https://launchpad.net/freezer
Blueprints and feature specifications: https://blueprints.launchpad.net/freezer
Issue tracking: https://bugs.launchpad.net/freezer

Requirements

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

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

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

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

API registration

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

# cd freezer-web-ui

# cp freezer-web-ui/disaster_recovery/enabled/_5050_freezer.py  /opt/stack/horizon/openstack_dashboard/enabled/_5050_freezer.py

# to disable the panel just copy the following file

# cp freezer-web-ui/disaster_recovery/enabled/_7050_freezer.py  /opt/stack/horizon/openstack_dashboard/enabled/_7050_freezer.py

# 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/openstack/freezer-web-ui

# cd freezer-web-ui

# cp freezer-web-ui/disaster_recovery/enabled/_5050_freezer.py  /opt/stack/horizon/openstack_dashboard/enabled/_5050_freezer.py

# to disable the panel just copy the following file

# cp freezer-web-ui/disaster_recovery/enabled/_7050_freezer.py  /opt/stack/horizon/openstack_dashboard/enabled/_7050_freezer.py

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

# restart apache2 service

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

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