Prepare a hosts-config.yml file for a Fluid Topics Backup - Fluid Topics - 3.10 - Reference Guides

Fluid Topics Installation Guide

Product
Fluid Topics
Fluid Topics Version
3.10
Operating System
RHEL
Category
Reference Guides
Language
English
Target Audience
public

The hosts-config.yml configuration file defines many settings to run the backup and restore procedure, like the location of the backup directory or where all servers can be found according to the roles.

The pre-packaged hosts-config.yml file is only given as a template. It must be customized to suit your needs.

Some settings are specific to roles: bo, idx, front, search, um, nerada.

A role has a name and a list of datasets which defines what to backup. There are some special roles that are handled specifically, but you are free to use any string as a role name.

The following lines show an exhaustive example of hosts-config.yml file:

defaults:
backup_dir: /usr/local/afs7/backup
backup_format: tgz
tmp_dir: /tmp
ssh:
user: antidot
key: /home/antidot/.ssh/default_ssh_key_file
hosts:
- hostname: ft-bo1.hot-cluster
dst_host: ft-bo1.warm-cluster
roles:
- bo
- um
bo:
user: antidot
password: secret_password
- hostname: ft-idx01.hot-cluster
roles:
- idx
idx:
timeout_sec: 7200
service_ids:
- 123
- 789
ssh:
key: /secret/ssh_key
user: spec_user
backup_dir: /another/directory
tmp_dir: /yet/another/one
- hostname: ft-front01.hot-cluster
roles:
- search
- webapp
- hostname: ft-front02.hot-cluster
roles:
- webapp
- hostname: ft-front03.hot-cluster
roles:
- search
- hostname: ft-mongo01.hot-cluster
roles:
- nerada

The following example shows how all Fluid Topics components are backed up on a backup server:

Fluid Topics Backup mechanism

The following example shows how all Fluid Topics components are restored from a backup server:

Fluid Topics Restore mechanism

The my-hosts.yml file is created to suit this need:

defaults:
backup_dir: /usr/local/afs7/backup
backup_format: tgz
tmp_dir: /tmp

hosts:
- hostname: ft-front01
roles:
- search
- webapp
- hostname: ft-front02
roles:
- webapp
- search

- hostname: ft-bo1
roles:
- bo
- um
bo:
user: antidot
password: secret_password

- hostname: ft-idx01
roles:
- idx

- hostname: ft-mongo01
roles:
- nerada

Once the my-hosts.yml file is created, the following command is used:

afs_backup_tool --action backup --data-config /usr/local/afs7/Fluid-Topics/conf-backup/ft-data-config.yml --hosts-config my-hosts.yml