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

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

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

url

URL-адрес для API-запросов к серверу Базис.vControl

username

Имя пользователя, от которого будут выполняться API-запросы к серверу Базис.vControl.

Используется только вместе с параметром password.

password

Пароль пользователя, от имени которого будут выполняться API-запросы к серверу Базис.vControl.

Используется только вместе с параметром username.

vcore_user

Пользователь на узле гипервизора Базис.vCore, от имени которого будут выполняться команды.

Для возможности создания моментальных снимков состояния ВМ и экспорта логических томов пользователь должен входить в группы kvm, qemu, disk, libvirt и vcontrol.

timeout

Максимально допустимое время выполнения API-запросов к серверу Базис.vControl в секундах.

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

от 1 до 300.

По умолчанию

5

enable_ssl

Включить проверку SSL-сертификата при API-запросах на подключение к серверу Базис.vControl.

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

yes, no.

По умолчанию

no

ca_info

Полный путь до SSL-сертификата при API-запросах на подключение к серверу Базис.vControl.

По умолчанию

NONE. API-запросы будут отправляться без проверки SSL-сертификата.

Используется только если параметр enable_ssl равен yes.

curl_verbose

Использование отладки API-запросов. Позволяет просматривать подробную информацию об API-запросах и ответах.

Информация отображается в журнале модуля /opt/rubackup/log/rb_module_basis_std.log.

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

yes, no.

По умолчанию

no

Рекомендуем включать настройку (значение yes) только с целью отладки проблем при взаимодействии модуля с сервером Базис.vControl через API.

fs_storage_mount_path

Путь до примонтированного файлового хранилища РК на прокси-хосте[1].

По умолчанию

NONE. Файловое хранилище не используется
1. Виртуальная или физическая машина, на которой развернуты клиент и модуль.

allow_work_with_incompatible_versions

Разрешить модулю работать с неподдерживаемой версией Базис.vControl.

yes

Если версия Базис.vControl отличается от списка версий, с которыми взаимодействует модуль, резервное копирование и восстановление РК будет выполняться. В журнал модуля будет добавлена запись о неподдерживаемой[2] версии Базис.vControl.

no

Если версия Базис.vControl отличается от списка версий, с которыми взаимодействует модуль, резервное копирование и восстановление РК будет недоступно.

По умолчанию

no

2. За взаимодействие модуля с с неподдерживаемой версией Базис.vControl компания RuBackup ответственности не несет.

max_attempts_to_start_nbd_server

Максимальное количество попыток запуска nbd-сервера для экспорта логических томов. При каждом запуске выбирается случайный TCP-порт.

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

от 1 до 100.

По умолчанию

10

Процедура запуска nbd-сервера для экспорта логических томов актуальна только при резервном копировании и восстановлении ВМ, диски которой располагаются в LVM-хранилище.
Пример листинга конфигурационного файла /opt/rubackup/etc/rb_module_basis_std.conf
# Symbol "#" at the beginning of the line is treated as a comment
# "#" in the middle of the line is treated as a parameter value
# So please do not use comments in one line with parameter
#
# Mandatory parameters
#
# URL for API requests to the Basis Dynamix Standard platform
url https://<IP_or_FQDN>
#
# User name on behalf of which the API requests will proceed
username <user_name>
#
# Password to be used with 'username' to authenticate in API
password <user_password>
#
# User name on behalf of which 'libvirt' CLI commands will be executed on vCore host.
# Note: this user should exist on vCore host and shold be added to groups:
#       - kvm
#       - qemu
#       - disk
#       - libvirt
#       - vcontrol
vcore_user <user_name>
#
# Optional parameters
#
# REST operations timeout, seconds
# minimum 1, maximum 300, default 5
timeout 20
#
# Enable ssl connection to API server.
# Possible values: yes, no
# Default value: no (connecting to API server w/o ssl)
enable_ssl no
#
# Specify full path to a certificate for ssl connection to API server.
# For value 'NONE' the module will connect to API w/o certificate verification.
ca_info NONE
#
# Turn on debug for REST API requests.
# Possible values: yes, no
# Default value: no (debug is turned off)
curl_verbose no
#
# The path on RuBackup client host to where the Basis Dynamix Std disk storage is mounted.
# Note: applicable only for storage of type "file system".
# Value 'NONE' means that storage of type "file system" is not used for current installation
#  of virtualization platform.
fs_storage_mount_path NONE
#
# Try using the module if current version of Basis Dynamix Standard platform is not compatible with RuBackup.
# Possible values: yes, no
# Default value: no (work with incompatible version of Basis Dynamix Standard is prohibited)
allow_work_with_incompatible_versions no
#
# The number of attempts to start NBD server before returning an error.
# minimum 1, maximum 100, default 10
max_attempts_to_start_nbd_server 10