Horizon Web interface for Freezer backup, restore and disaster recovery platform
Go to file
caihui 1fc3835933 Update devstack doc
Add a sampe "local.conf" file for freezer developer.

Change-Id: Iee12d4c186a373c5d8987dd48ece2b7a6eef446c
2019-11-15 17:26:49 -08:00
devstack Update devstack doc 2019-11-15 17:26:49 -08:00
disaster_recovery Use freezerclient.client to support v1 or v2 2018-11-06 20:33:41 -05:00
doc Sync Sphinx requirement 2019-07-04 20:47:07 +08:00
playbooks/legacy/freezer-web-ui-ubuntu OpenDev Migration Patch 2019-04-19 19:44:40 +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 OpenDev Migration Patch 2019-04-19 19:44:40 +00:00
.pylintrc Updated from global requirements 2017-06-07 12:47:55 +01:00
.zuul.yaml Use Horizon project template for django jobs 2019-10-09 17:08:04 +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 Sync Sphinx requirement 2019-07-04 20:47:07 +08: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 Add py37 and remove py35 in envlst 2019-11-15 02:21:33 -08:00
manage.py Updated tox.ini to support new test environment 2016-09-04 18:08:50 +01:00
requirements.txt Use freezerclient.client to support v1 or v2 2018-11-06 20:33:41 -05:00
run_tests.sh Updated tox.ini to support new test environment 2016-09-04 18:08:50 +01:00
setup.cfg Update mailinglist from dev to discuss 2018-12-17 06:22:44 +00:00
setup.py Updated from global requirements 2017-03-23 15:10:53 +00:00
test-requirements.txt Add py37 and remove py35 in envlst 2019-11-15 02:21:33 -08:00
tox.ini Add py37 and remove py35 in envlst 2019-11-15 02:21:33 -08:00

README.rst

Team and repository tags

image

Freezer - Horizon Dashboard

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

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

Register freezer api endpoint:

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

  1. 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

Source Code

The project source code repository is located at: https://opendev.org/openstack/freezer-web-ui/