Freezer-installation
Note If you want to install an specific branch, make sure to do the following steps for each repo:
git clone -b stable/mitaka https://github.com/openstack/freezer
Contents
API
Elasticsearch
on ubuntu/debian, install openjdk
sudo apt-get install openjdk-7-jre
download elasticsearch from https://www.elastic.co/downloads/elasticsearch and make sure the version is <2.0
and the install elasticsearch
sudo dpkg -i elasticsearch.deb
start elasticsearch
sudo service elasticsearch start
Install freezer api
It is recommended to install the api in a virtual environment
git clone https://github.com/openstack/freezer-api.git cd freezer-api virtualenv .venv source .venv/bin/activate pip install -e .
Edit configuration file
sudo cp etc/freezer-api.conf /etc/freezer-api.conf
edit parameters to your environment
sudo vi /etc/freezer-api.conf
Mappings for elasticsearch
Elasticsearch needs to know what type of data each document's field contains. This information is contained in the "mapping", or schema definition. Elasticsearch will use dynamic mapping to try to guess the field type from the basic datatypes available in JSON, but some field's properties have to be explicitly declared to tune the indexing engine. To do that, use the freezer-db-init command:
freezer-db-init [db-host]
The url of the db-host is optional and can be automatically guessed from /etc/freezer-api.conf
API Registration
openstack user create --password-prompt freezer openstack role add --project <tenant> --user freezer admin openstack service create --name freezer --description "Freezer Backup Service" backup openstack endpoint create \ --publicurl http://freezer_api_publicurl:port \ --internalurl http://freezer_api_internalurl:port \ --adminurl http://freezer_api_adminurl:port \ --region regionOne \ backup
Run the API
in kilo
freezer-api <ip_host>
liberty onwards
freezer-api --bind-host <ip_host>