Freezer Agent Installation

Before Installation

  • Freezer contains two component: Freezer Agent (freezer-agent) and Freezer Scheduler (freezer-scheduler).

  • Install Freezer Agent from source (It is not hard).

  • Chose correct version of Freezer Agent that corresponds other Freezer components and your OpenStack version.

  • Freezer Scheduler stable/Liberty and stable/Kilo releases only works with Keystone API 2.0.

Requirements

Freezer Agent require following packages to be installed:

  • python

  • python-dev

  • GNU Tar >= 1.26

  • gzip, bzip2, xz

  • OpenSSL

  • python-swiftclient

  • python-keystoneclient

  • pymongo

  • PyMySQL

  • libmysqlclient-dev

  • sync

  • At least 128 MB of memory reserved for Freezer

Ubuntu / Debian Installation

Follow these instructions for Ubuntu or Debian bases Linux distros

Install required packages first:

sudo apt-get install python-dev python-pip git openssl gcc make automake

For python3:

sudo apt-get install python3-dev git openssl openssl-devel gcc make automake

Clone proper branch of Freezer Client with git:

git clone -b [branch] https://github.com/openstack/freezer.git

Install requirements with pip:

cd freezer/

sudo pip install -r requirements.txt

Install freezer from source:

sudo python setup.py install

Create ENV file:

sudo nano ~/freezer.env

# tenant user name
OS_TENANT_NAME='[tenant_name]'

# project name
OS_PROJECT_NAME='[project_name]'

# tenan user name
OS_USERNAME='[user_name]'

#tenant user password
OS_PASSWORD='[user_password]'

# API version v2.0 is very important
# freezer does not work with API version 3
OS_AUTH_URL='http://[keystone_uri]:[keystone_port]/v2.0'

# API endpoint type. this is usually 'publicURL'
OS_ENDPOINT_TYPE='publicURL'

Source the newly created ENV file:

. ~/freezer.env

Check if you have successfully authenticated by Keystone:

freezer-agent --action info

If you do not see any error messages, you have successfully installed Freezer Agent

RHEL / Centos Installation

Follow these instructions for RHEL or Centos bases Linux distros

Install required packages first:

sudo yum install python-devel python-pip git openssl \
openssl-devel gcc make automake

For python3:

sudo apt-get install python3-devel git openssl \
openssl-devel gcc make automake

Clone proper branch of Freezer Client with git:

git clone -b [branch] https://github.com/openstack/freezer.git

Install requirements with pip:

cd freezer/

sudo pip install -r requirements.txt

Install freezer from source:

sudo python setup.py install

Create ENV file:

sudo vi ~/freezer.env

# tenant user name
OS_TENANT_NAME='[tenant_name]'

# project name
OS_PROJECT_NAME='[project_name]'

# tenan user name
OS_USERNAME='[user_name]'

#tenant user password
OS_PASSWORD='[user_password]'

# API version v2.0 is very important
# freezer does not work with API version 3
OS_AUTH_URL='http://[keystone_uri]:[keystone_port]/v2.0'

# API endpoint type. this is usually 'publicURL'
OS_ENDPOINT_TYPE='publicURL'

Source the newly created ENV file:

. ~/freezer.env

Check if you have successfully authenticated by Keystone:

freezer-agent --action info

If you do not see any error messages, you have successfully installed Freezer Agent

Windows Installation

Only following components supported for Windows OS Platform:

  • freezer-agent

  • freezer-scheduler

For windows following software must be installed prior to Freezer Agent installation

After you have installed required packages install pip:

Do not forget to ppen “cmd” as Administrator

easy_install -U pip
pip install freezer

Freezer scheduler on windows run as a windows service and it needs to be installed as a user service:

Do not forget to ppen “cmd” as Administrator

whoami

cd C:\Python27\Lib\site-packages\freezer\scheduler

python win_service.py --username {whoami} --password {pc-password} install

Unofficial Installer for Windows

There is a unofficial Windows installation script. The script is developed and supported by community.

Windows Installer: https://github.com/openstack-freezer-utils/freezer-windows-installer#windows-freezer-installer