Freezer Agent require following packages to be installed:
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
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
Only following components supported for Windows OS Platform:
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
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
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.