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

Go to file

Nguyen Hai Truong 76bd7e2722 Update min tox version to 2.0 The commands used by constraints need at least tox 2.0. Update to reflect reality, which should help with local running of constraints targets. Change-Id: I2927d99acb744ce2ef9ab71940950ec954476a64		2018-11-01 23:52:50 -07:00
devstack	use . instead of source.	2018-01-29 14:25:56 +00:00
disaster_recovery	Merge "Support freezer API v2"	2018-10-30 01:13:11 +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	use . instead of source.	2018-01-29 14:25:56 +00:00
.gitignore	Add test 'node_modules' in '.gitignore'	2018-07-19 17:31:52 +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	add python 3.6 unit test job	2018-09-12 04:56:39 +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 README.rst error	2018-10-30 20:37:45 -04:00
babel-django.cfg	Correct django template pattern in babel-django.cfg	2018-02-06 01:06:30 +09: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
lower-constraints.txt	Drop nose dependencies	2018-08-17 02:06:15 +09:00
manage.py	Updated tox.ini to support new test environment	2016-09-04 18:08:50 +01:00
requirements.txt	Drop nose dependencies	2018-08-17 02:06:15 +09: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	Drop nose dependencies	2018-08-17 02:06:15 +09:00
tox.ini	Update min tox version to 2.0	2018-11-01 23:52:50 -07: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

Issue tracking and feature specifications: https://storyboard.openstack.org/#!/project/openstack/freezer-web-ui

Requirements

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

git clone https://github.com/openstack/python-freezerclient
cd python-freezerclient
python setup.py install (is important that freezer API client 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