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

Go to file

qiaomin 4756f541dd Add hyperlink for the "API registration" This patch use the link markup to provide hyperlink for the "API registration". This makes reader life easier. Change-Id: I7471417a9f967611cb7944bf446a873025366176		2017-01-17 22:26:34 +08:00
devstack	Run normal tests instead of tempest tests in gate jobs	2016-10-21 09:35:46 +00:00
disaster_recovery	Merge "Replace LOG.warn with LOG.warning"	2017-01-12 13:21:25 +00:00
doc	Add Sphinx doc build	2016-02-09 15:02:05 +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	Add hyperlink for the "API registration"	2017-01-17 22:26:34 +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	2016-12-07 21:21:45 +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
<https://github.com/openstack/freezer-api/blob/master/README.rst>`_

API registration

`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