Конфигурационный файл /opt/rubackup/etc/rb_module_tionix.conf

Обязательные к заполнению параметры обозначены символом .

1. Параметры файла

Таблица 1. Параметры конфигурационного файла /opt/rubackup/etc/rb_module_tionix.conf
Параметр Описание

identity_url[1]

URL-адрес для доступа к сервису Identity для идентификации пользователя

Возможные значения

<https://path>

compute_url[1]

URL-адрес для доступа к сервису Compute, предоставляющего вычислительные мощности для создания виртуальных машин и управления ими

Возможные значения

<https://path>

volume_url[1]

URL-адрес для доступа к сервису Volume для блочного хранения данных

Возможные значения

<https://path>

image_url[1]

URL-адрес для доступа к сервису Image для взаимодействия с образами

Возможные значения

<https://path>

network_url[1]

URL-адрес для доступа к сервису Network для управления сетями

Возможные значения

<https://path>

project_id[1]

Идентификатор проекта платформы TIONIX

Возможные значения

<ID_Проекта>

username[2]

Имя для авторизации пользователя на платформе виртуализации TIONIX

Возможные значения

<Логин пользователя>

password[2]

Пароль для авторизации пользователя на платформе виртуализации TIONIX

Возможные значения

<Пароль пользователя>

domain[1]

Имя домена платформы TIONIX

Возможные значения

<Имя домена>

По умолчанию

default

timeout

Максимально допустимое время выполнения REST-запросов к платформе виртуализации TIONIX в секундах

Возможные значения

1-300

По умолчанию

5

rubackup-vm-id[1]

Идентификатор виртуальной машины, на которой установлен клиент РК RuBackup

Возможные значения

<ID_ВМ>

admin_name[2]

Имя для авторизации администратора на платформе виртуализации TIONIX

Возможные значения

<Логин администратора>

Требуется для возможности запуска скриптов внутри виртуальной машины в процессе выполнения задачи резервного копирования

admin_password[2]

Пароль для авторизации администратора на платформе виртуализации TIONIX

Возможные значения

<Пароль администратора>

Требуется для возможности запуска скриптов внутри виртуальной машины в процессе выполнения задачи резервного копирования

enable_ssl

Включить проверку ssl-сертификатов для REST-запросов к платформе TIONIX

Возможные значения

yes, no

По умолчанию

no

ca_info

Путь до корневого ssl-сертификата клиента РК с установленным модулем TIONIX в формате .pem при использовании SSL соединения (требуется указать при значении yes параметра enable_ssl)

Возможные значения

<path_to_cert>

cinder_api_request_retry_number

Количество повторных REST-запросов к сервису Cinder платформы TIONIX, которые будут выполнены в случае, если от сервиса был получен ответ с ошибкой

Возможные значения

0-10

По умолчанию

0

При значении 0 повторные REST-запросы не выполняются

cinder_api_request_retry_timeout

Тайм-аут (в секундах) между повторными REST-запросами к сервису Cinder платформы TIONIX, которые будут выполнены в случае, если от сервиса был получен ответ с ошибкой

Возможные значения

1-600

По умолчанию

1

volume_creation_timeout

Время (в секундах), в течение которого модуль TIONIX ожидает создания диска (перехода диска в состояние available с момента оправки запроса на его создание) в платформе виртуализации TIONIX

Возможные значения

100-600

По умолчанию

300

Если время, заданное параметром volume_creation_timeout, истекло с момента отправки запроса на создание диска, и при этом диск не перешел в состояние available, то соответствующая задача на создание РК завершится с ошибкой

snapshot_creation_timeout

Время (в секундах), в течение которого модуль TIONIX ожидает создания снимков состояния дисков резервируемой ВМ (перехода снимков в состояние available с момента оправки запроса на их создание) в платформе TIONIX

Возможные значения

100-600

По умолчанию

300

При выполнении задачи резервного копирования ВМ модуль отправляет одновременно несколько запросов (по количеству дисков ВМ) на создание снимков состояния дисков резервируемой ВМ.

Если время, заданное параметром snapshot_creation_timeout, истекло с момента отправки запросов на создание снимков состояния, и при этом снимки не перешли в состояние available, то соответствующая задача на создание РК завершится с ошибкой

volume_attachment_timeout

Время (в секундах), в течение которого модуль TIONIX ожидает подключения диска (перехода диска в состояние in-use с момента оправки запроса на его подключение) к виртуальной машине в платформе TIONIX

Возможные значения

100-600

По умолчанию

300

Если время, заданное параметром volume_attachment_timeout, истекло с момента отправки запроса на подключение диска к ВМ, и при этом диск не перешел в состояние in-use, то соответствующая задача на создание или восстановление РК завершится с ошибкой

obsolete_vol_snap_notification_timeout

Время жизни (в днях) дисков и снимков состояния дисков, созданных модулем TIONIX в платформе TIONIX

Возможные значения

1-100

По умолчанию

5

Если диск, созданный модулем TIONIX и подключенный к прокси-хосту, остается в платформе виртуализации дольше установленного времени жизни, то модуль TIONIX зафиксирует предупреждение в журнале.

Если снимок диска, созданный модулем TIONIX, остается в платформе виртуализации дольше установленного времени жизни, то модуль TIONIX зафиксирует предупреждение в журнале.

Завершенной задаче на резервное копирование/восстановление будет присвоен статус Done_with_Defect (см. Раздел «Задачи»)

max_attached_volumes

Максимальное количество дисков, которое можно подключить к прокси-хосту

Возможные значения

2-26

По умолчанию

26

Если количество подключённых к прокси-хосту дисков достигло установленного значения, то задача на резервное копирование/восстановление будет завершена с ошибкой

attached_volumes_notification_threshold

Количество подключенных к прокси-хосту дисков, при превышении которого модуль TIONIX зафиксирует предупреждение в журнале

Возможные значения

2-26

По умолчанию

20

Завершенной задаче на резервное копирование/восстановление будут присвоен статус Done_with_Defect (см. Раздел «Задачи»)

2. Листинг файла

Пример листинга конфигурационного файла /opt/rubackup/etc/rb_module_tionix.conf
# Symbol "#" at the beginning of the line treats as a comment
# "#" in the middle of the line treats as a parameter value
# So please do not use comments in one line with parameter

# Mandatory parameters
# Get config URLs at https://<TIONIX_WEBUI_IP>/dashboard/project/api_access/
identity_url http://public.rubackup.test:5000/v3/
compute_url http://public.rubackup.test:8774/v2.1/6adb8160d0b840878211992d0d2fa0e4
volume_url http://internal.rubackup.test:8776/v3/6adb8160d0b840878211992d0d2fa0e4
# Image URL must be provided without version in path
image_url http://public.lab.lan:9292
# Network URL must be provided without version in path
network_url http://public.rubackup.test:9696
project_id 6adb8160d0b840878211992d0d2fa0e4
# User name on behalf of which the API requests will proceed
username dsafonov
# Password to be used with 'username' to authenticate in API
password 1q2w3e4r
# Domain name to be used with 'username' and 'password' to authenticate in API
domain default
# minimum 1, maximum 300, default 5
timeout 20
# ID of VM in TIONIX platform where current module is deployed - can be obtained from instance info in WEB GUI
rubackup-vm-id 67d27881-f666-4525-84d0-bed3f2330a22
##
## Optional parameters:
#  Admin user account info of TIONIX is required to run scripts inside the target VM
admin_name admin
admin_password 123456
# If certificate info is not specified the module will connect to API w/o certificate verification
enable_ssl no
ca_info <path to cert>
# Turn on debug of REST requests
#curl_verbose no
## Number of retry attempts for cinder API requests in case of negative response from API
# minimum 0, maximum 10, default 0
cinder_api_request_retry_number 0
## Value of a timeout in seconds to wait for between retry requests to cinder API in case of negative response from API
# minimum 1, maximum 600, default 1
cinder_api_request_retry_timeout 1
## Timeout for creating volumes in openstack platform, seconds
# minimum 100, maximum 600, default 300
volume_creation_timeout 300
## Timeout for creating snapshots in openstack platform, seconds
# minimum 100, maximum 600, default 300
snapshot_creation_timeout 300
## Timeout for attaching and detaching volumes in openstack platform, seconds
# minimum 100, maximum 600, default 300
volume_attachment_timeout 300
## Period of time (in days) which is related to volumes and snapshots created by the RuBackup module during backup/restore tasks.
# If such a created volume exists and attached to client VM longer tnan the specified value of time a Warning is raised.
# If such a created snapshot exists longer tnan the specified value of time a Warning is raised.
# If such a Warning is raised corresponding backup/restore task will get status "Done_with_Defect".
# Minimum: 1, Maximum: 100, Default: 5
obsolete_vol_snap_notification_timeout 5
## Maximum number of attached volumes to a client VM.
# If real number of attached volumes reached the specified value corresponding backup/restore task will end with Error.
# Minimum: 2, Maximum: 26, Default: 26
max_attached_volumes 26
## Maximum number of attached volumes to a client VM, reaching which will raise a Warning.
# If such a Warning is raised corresponding backup/restore task will get status "Done_with_Defect".
# Minimum: 2, Maximum: 26, Default: 20
attached_volumes_notification_threshold 20

1. Для получения данных воспользуйтесь веб-интерфейсом платформы виртуализации TIONIX.
2. Запросите данные у администратора платформы виртуализации TIONIX.