freezer/doc/source/install/install_agent.rst

This section describes how to install and configure freezer-scheduler and freezer-agent, on any node in the cloud or any vm inside the cloud.

This section assumes that you already have a working OpenStack environment with at least the following components installed: - Keystone - Swift

git clone https://git.openstack.org/openstack/freezer.git
cd freezer
pip install ./

Configure the scheduler

1. Copy the configuration files to /etc/freezer/:

$ sudo cp etc/scheduler.conf.sample /etc/freezer/scheduler.conf

2. Edit the /etc/freezer/scheduler.conf file and complete the following actions:

   There are two kinds of api interface, v1 and v2.

   There are two kinds of configurations:

   notes:

   Default configuration is freezer api v2.

   Configuration1: freezer-api is started by v1 interface:

   • In the [DEFAULT] section, configure database access:

     The client_id has to be set to the hostname of the machine. It will be used as an identifier for this node to fetch its scheduled backups

     [DEFAULT]
     ...
     client_id = hostname_of_machine
     jobs_dir = /etc/freezer/scheduler/conf.d
     enable_v1_api = True

   Configuration2: freezer-api is started by v2 interface:

   • In the [DEFAULT] section, configure database access:

     The client_id has to be set to the hostname of the machine. It will be used as an identifier for this node to fetch its scheduled backups

     [DEFAULT]
     ...
     client_id = hostname_of_machine
     jobs_dir = /etc/freezer/scheduler/conf.d
     #enable_v1_api = False

3. Start freezer-scheduler

$ . admin-openrc
$ sudo freezer-scheduler --config-file /etc/freezer/scheduler.conf start