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

Go to file

Sean McGinnis 6b78e6ddba Remove mox from requirements Mox and mox3 were listed in test-requirements, but neither is actually used anywhere. Since we are trying to remove the use of mox from OpenStack, this clears them from the requirements so it does not look like they are being used. Change-Id: I954e97202ed62e17d31993a57c3891a1f6903799		2018-01-09 15:03:48 -06:00
devstack	Remove unused code about FREEZER_WEB_UI_DIR in devstack plugin	2017-08-31 10:06:09 +08:00
disaster_recovery	Imported Translations from Zanata	2017-10-15 08:50:30 +00:00
doc	Merge "Remove link to modindex"	2017-02-02 16:26:20 +00:00
playbooks/legacy/freezer-web-ui-ubuntu-xenial	Move legacy freezer-web-ui jobs to project	2017-12-05 02:05:18 +00:00
tools	Updated tox.ini to support new test environment	2016-09-04 18:08:50 +01:00
.gitignore	Modify the '.gitignore' file	2017-08-18 17:16:50 +08:00
.gitreview	Add .gitreview	2015-10-19 09:44:41 +01:00
.pylintrc	Updated from global requirements	2017-06-07 12:47:55 +01:00
.zuul.yaml	Move legacy freezer-web-ui jobs to project	2017-12-05 02:05:18 +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 installation freezer dashboard	2017-02-05 20:46:21 +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
bindep.txt	Use bindep to define binary deps	2017-04-04 23:32:31 +00:00
manage.py	Updated tox.ini to support new test environment	2016-09-04 18:08:50 +01:00
requirements.txt	Updated from global requirements	2017-08-11 02:29:57 +00:00
run_tests.sh	Updated tox.ini to support new test environment	2016-09-04 18:08:50 +01:00
setup.cfg	Remove warning-is-error from setup.cfg to fix release	2017-08-10 11:11:23 +01:00
setup.py	Updated from global requirements	2017-03-23 15:10:53 +00:00
test-requirements.txt	Remove mox from requirements	2018-01-09 15:03:48 -06:00
tox.ini	Replace python version for tox	2017-04-05 12:51:03 +00:00

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_remove_panel_.py  /opt/stack/horizon/openstack_dashboard/enabled/_7050_freezer_remove_panel_.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_remove_panel_.py  /opt/stack/horizon/openstack_dashboard/enabled/_7050_freezer_remove_panel_.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