Конфигурационный файл

Данные, полученные после настройки (с помощью утилиты rb_init или rb_init_gui), сохраняются в файле:

  • для Linux-систем: /opt/rubackup/etc/config.file;

  • для Windows-систем: C:\RuBackup-win-client\etc\config.file.txt.

1. Параметры конфигурационного файла клиента

Таблица 1. Описание параметров конфигурационного файла клиента
Параметр Назначение

node

Тип узла RuBackup

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

primaryserver, secondaryserver, mediaserver, client.

who-is-primary-server

Имя узла основного сервера RuBackup

client-inet-interface

Сетевой интерфейс клиента. Используется для отображения дополнительной информации о клиенте в СРК RuBackup.

Медиасервер осуществляет связь с основным или резервным сервером, а также с утилитой rbfd через сетевой интерфейс

use-local-backup-directory

Каталог для временного хранения резервных копий. Для создания резервных копий и хранения временных файлов, которые создаются при их восстановлении, требуется определённое дисковое пространство. Рекомендуем выделить для этой цели отдельный локальный диск и примонтировать его к /backup-tmp либо к другой точке монтирования. Точку монтирования временного каталога нужно указать как значение параметра use-local-backup-directory и перезагрузить клиент RuBackup.

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

<path>.

parallel-tasks

Максимальное количество одновременно выполняемых задач

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

от 1 до 64.

По умолчанию

2

deduplication-task-memory

Исключение дублирующих копий повторяющихся данных (в байтах)

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

от 0.

По умолчанию

268435456

remote-replication

Включение удаленной репликации — копирование данных из хоста источника на удаленный хост приемника

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

yes, no.

По умолчанию

yes

centralized-recovery

Централизованное восстановление данных из резервной копии

yes

Централизованное восстановление данных из резервной копии возможно с помощью приложения «Менеджер администратора RuBackup».

no

Централизованное восстановление данных возможно только на клиенте резервного копирования с помощью утилиты командной строки rbfd или «Менеджера клиента RuBackup».

По умолчанию

yes

logfile

Расположение системного файла журнала событий

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

<path>.

rbd_algorithm

Выбор хеш функции при дедупликации

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

sha1, sha2, skein, streebog, blake2b.

По умолчанию

sha2

rbd_block_size

Размер блока данных при дедупликации (в байтах)

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

8192, 16384, 32768, 65536, 131072, 262144, 524288, 1048576.

По умолчанию

16384

rbd_hash_length

Допустимая длина хеша (в битах)

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

256, 512.

По умолчанию

256

client-shutdown_scenario

Сценарий выключения клиента

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

immediately, after-all-tasks, cancel-if-tasks.

По умолчанию

cancel-if-tasks

use-product-uuid

Для версии СРК RuBackup 2.1 и более поздней: Генерировать идентификатор hardware id узла лицензируемого сервера на основании:

  • для ОС Linux: идентификатора UUID материнской платы, установленного производителем платы, и закодированной информации в DMI BIOS;

  • для ОС Windows: имени узла hostname;

Для версии СРК RuBackup 2.0 и ранее: параметра нет, hardware id генерируется на основании идентификатора /etc/machine-id и имени узла /etc/hostname

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

false, true.

По умолчанию

false

use-ip-instead-hostname

Использовать IP-адреса вместо DNS-имён при взаимодействии компонентов СРК

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

false, true.

По умолчанию

false

reconnect-period-count

Количество периодов переподключения в рамках выполнения задач между Клиентом и Медиасервером​[1]

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

от 0.

По умолчанию

3


1. При отсутствии отдельно настроенных медиасерверов их функции выполняют основной и резервный сервера (при наличии).

reconnect-period-timeout

Таймаут (в сек) между периодами переподключения в рамках выполнения задач между Клиентом и Медиасервером​[2]

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

от 0.

По умолчанию

20


2. При отсутствии отдельно настроенных медиасерверов их функции выполняют основной и резервный сервера (при наличии).

reconnect-count

Количество попыток переподключения в рамках выполнения задач между Клиентом и Медиасервером​[3]

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

от 0.

По умолчанию

3


3. При отсутствии отдельно настроенных медиасерверов их функции выполняют основной и резервный сервера (при наличии).

reconnect-timeout

Таймаут (в сек) между попытками переподключения в рамках выполнения задач между Клиентом и Медиасервером​[4]

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

от 0.

По умолчанию

5


4. При отсутствии отдельно настроенных медиасерверов их функции выполняют основной и резервный сервера (при наличии).

digital-signature

Использовать электронно-цифровую подпись для аутентификации и защиты данных в СРК

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

yes, no.

По умолчанию

yes

parallelizm

Число потоков для обработки сообщений от клиентов на главном сервере

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

от 1 до 4096.

По умолчанию

8

parallelizm_media

Число потоков для обработки сообщений от клиентов на медиа сервере

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

от 1 до 4096.

По умолчанию

8

monitoring-client

Включить отправку метрик мониторинга хоста на главный сервер

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

yes, no.

По умолчанию

yes

used-ip-version

Версия IP-протокола для сетевого взаимодействия компонентов СРК

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

ipv4, ipv6, both.

digital-sign-hash

Хеш-функция для электронно-цифровой подписи. В соответствии с командами группы OpenSSL Message Digest

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

blake2b512, blake2s256, gost, md4, md5, rmd160, sha1, sha224, sha256, sha384, sha512.

По умолчанию

sha1

memory-threshold

Верхняя граница использования оперативной памяти (в гигабайтах) при создании полной резервной копии. Для хранения уникальных хешей и обеспечения дедупликации нужно выделить на диске дополнительное место ≈ 0,3% от размера ресурса.

Ограничения

При использовании параметра в кластерной группе убедитесь, что все клиенты группы имеют одну версию СРК.

Параметр используется только для создания полной резервной копии

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

По умолчанию

0

2. Параметры конфигурационного файла сервера

Таблица 2. Описание параметров конфигурационного файла сервера
Параметр Назначение

node

Тип узла RuBackup

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

primaryserver, secondaryserver, mediaserver, client.

server-inet-interfaces

Список сетевых интерфейсов сервера в одну строку через пробел, через которые серверу резервного копирования разрешено взаимодействовать с клиентами

dbname

Имя служебной базы данных

По умолчанию

rubackup

user

Пользователь служебной базы данных

По умолчанию

rubackup

password crypted

Закодированное значение пароля пользователя служебной базы данных

host

FQDN или IP адрес сервера, на котором расположена служебная база данных

port

Порт подключения служебной базы данных

По умолчанию

5432

server-shutdown_scenario

Сценарий выключения сервера

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

immediately, after-all-tasks, cancel-if-tasks.

По умолчанию

cancel-if-tasks

s3-fuse-type

Тип FUSE-драйвера для монтирования S3 бакетов

По умолчанию

geesefs

geesefs-memory-limit

Лимит оперативной памяти (в мегабайтах) для кэширования данных и метаданных

По умолчанию

4000

geesefs-max-flushers

Максимальное количество фоновых потоков для асинхронной записи данных в S3

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

от 0.

По умолчанию

16

geesefs-read-retry-attempts

Максимальное количество повторных попыток при ошибках чтения из S3

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

от 0.

По умолчанию

3

geesefs-no-specials

Отключение поддержки специальных файлов

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

yes, no.

По умолчанию

no

geesefs-list-type

Тип листинга объектов

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

0, 1.

По умолчанию

1

geesefs-http-timeout

Таймаут (в сек) HTTP-запросов к S3

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

от 0.

По умолчанию

30

geesefs-fsync-on-close

Ожидание подтверждения записи данных на сервер S3 при закрытии файла

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

yes, no.

По умолчанию

no

geesefs-no-preload-dir

Отключение предварительной загрузки листинга директории при открытии отдельных файлов.

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

yes, no.

По умолчанию

no

geesefs-no-implicit-dir

Предполагать существование всех объектов-директорий без проверки

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

yes, no.

По умолчанию

no

geesefs-no-checksum

Отключение проверки MD5 и SHA256 контрольных сумм для повышения производительности

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

yes, no.

По умолчанию

no

geesefs-max-parallel-parts

Количество параллельных запросов из общего числа, используемых для многокомпонентной загрузки крупных частей.

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

от 0.

По умолчанию

0

geesefs-part-sizes

Размеры частей (в мегабайтах) для многокомпонентной загрузки.

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

от 0.

По умолчанию

0

geesefs-no-verify-ssl

Отключение проверки SSL-сертификатов

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

yes, no

По умолчанию

no

geesefs-ignore-fsync

Не ожидать сохранения изменений на сервере

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

yes, no

По умолчанию

no

geesefs-read-ahead-large

Размер буфера предварительного чтения (в килобайтах) для файлов

По умолчанию

102400

geesefs-read-ahead-parallel

Размер (в килобайтах) для параллельных блоков предварительного чтения при работе с большими файлами

По умолчанию

20480

s3-cloud-http-version

Тип HTTP-протокола для S3 бакетов. Параметр является опциональным

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

best-possible, http_1_0, http_1_1, http2, http2_tls, http2_prior, http3.

s3-cloud-http-request-timeout

Таймаут (в сек) ожидания ответа от S3 сервера для каждого HTTP-запроса. При отсутствии ответа в течение указанного времени задача завершится с ошибкой.

Таймаут отключен при значении по умолчанию

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

от 0.

По умолчанию

0

s3-cloud-http-debug

Параметр отвечает за печать лога HTTP трафика с S3 сервера в Debug лог медиасервера

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

true, false.

keepalives

Использование сообщений keepalive протокола TCP на стороне клиента

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

0, 1.

По умолчанию

0

keepalives_idle

Управление длительностью периода отсутствия активности (в сек)

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

от 0.

По умолчанию

7200

keepalives_interval

Интервал (в сек) между отправкой повторных сообщений при отсутствии ответа

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

от 0.

По умолчанию

75

keepalives_count

Количество последовательно потерянных проверочных сообщений перед разрывом соединения

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

от 0.

По умолчанию

9

copy-move-parallelizm

Число параллельных потоков для копирования или перемещения РК в другой пул

Параметр применяется только для копирования и перемещения РК в пулы типа Ленточная библиотека, LTFS и Ленточная библиотека, Native.

Подробнее о сценариях копирования и перемещения РК см. Пулы.

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

от 0.

По умолчанию

8

copy-move-sequential-read

Включить последовательное чтение исходной РК при копировании или перемещении в другой пул

Параметр применяется только для копирования и перемещения РК в пулы типа Ленточная библиотека, LTFS и Ленточная библиотека, Native.

Подробнее о сценариях копирования и перемещения РК см. Пулы.

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

yes, no.

По умолчанию

yes

who-is-primary-server

Имя узла основного сервера RuBackup

who-is-secondary-server

Имя узла резервного сервера RuBackup

client-inet-interface

Сетевой интерфейс клиента. Используется для отображения дополнительной информации о клиенте в СРК RuBackup.

Медиасервер осуществляет связь с основным или резервным сервером, а также с утилитой rbfd через сетевой интерфейс

use-local-backup-directory

Каталог для временного хранения резервных копий. Для создания резервных копий и хранения временных файлов, которые создаются при их восстановлении, требуется определённое дисковое пространство. Рекомендуем выделить для этой цели отдельный локальный диск и примонтировать его к /backup-tmp либо к другой точке монтирования. Точку монтирования временного каталога нужно указать как значение параметра use-local-backup-directory и перезагрузить клиент RuBackup.

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

<path>.

parallel-tasks

Максимальное количество одновременно выполняемых задач

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

от 1 до 64.

По умолчанию

2

deduplication-task-memory

Исключение дублирующих копий повторяющихся данных (в байтах)

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

от 0.

По умолчанию

268435456

remote-replication

Включение удаленной репликации — копирование данных из хоста источника на удаленный хост приемника

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

yes, no.

По умолчанию

yes

centralized-recovery

Централизованное восстановление данных из резервной копии

yes

Централизованное восстановление данных из резервной копии возможно с помощью приложения «Менеджер администратора RuBackup».

no

Централизованное восстановление данных возможно только на клиенте резервного копирования с помощью утилиты командной строки rbfd или «Менеджера клиента RuBackup».

По умолчанию

yes

logfile

Расположение системного файла журнала событий

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

<path>.

rbd_algorithm

Выбор хеш функции при дедупликации

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

sha1, sha2, skein, streebog, blake2b.

По умолчанию

sha2

rbd_block_size

Размер блока данных при дедупликации (в байтах)

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

8192, 16384, 32768, 65536, 131072, 262144, 524288, 1048576.

По умолчанию

16384

rbd_hash_length

Допустимая длина хеша (в битах)

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

256, 512.

По умолчанию

256

client-shutdown_scenario

Сценарий выключения клиента

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

immediately, after-all-tasks, cancel-if-tasks.

По умолчанию

cancel-if-tasks

use-product-uuid

Для версии СРК RuBackup 2.1 и более поздней: Генерировать идентификатор hardware id узла лицензируемого сервера на основании:

  • для ОС Linux: идентификатора UUID материнской платы, установленного производителем платы, и закодированной информации в DMI BIOS;

  • для ОС Windows: имени узла hostname;

Для версии СРК RuBackup 2.0 и ранее: параметра нет, hardware id генерируется на основании идентификатора /etc/machine-id и имени узла /etc/hostname

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

false, true.

По умолчанию

false

use-ip-instead-hostname

Использовать IP-адреса вместо DNS-имён при взаимодействии компонентов СРК

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

false, true.

По умолчанию

false

reconnect-period-count

Количество периодов переподключения в рамках выполнения задач между Клиентом и Медиасервером​[5]

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

от 0.

По умолчанию

3


5. При отсутствии отдельно настроенных медиасерверов их функции выполняют основной и резервный сервера (при наличии).

reconnect-period-timeout

Таймаут (в сек) между периодами переподключения в рамках выполнения задач между Клиентом и Медиасервером​[6]

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

от 0.

По умолчанию

20


6. При отсутствии отдельно настроенных медиасерверов их функции выполняют основной и резервный сервера (при наличии).

reconnect-count

Количество попыток переподключения в рамках выполнения задач между Клиентом и Медиасервером​[7]

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

от 0.

По умолчанию

3


7. При отсутствии отдельно настроенных медиасерверов их функции выполняют основной и резервный сервера (при наличии).

reconnect-timeout

Таймаут (в сек) между попытками переподключения в рамках выполнения задач между Клиентом и Медиасервером​[8]

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

от 0.

По умолчанию

5


8. При отсутствии отдельно настроенных медиасерверов их функции выполняют основной и резервный сервера (при наличии).

digital-signature

Использовать электронно-цифровую подпись для аутентификации и защиты данных в СРК

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

yes, no.

По умолчанию

yes

parallelizm

Число потоков для обработки сообщений от клиентов на главном сервере

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

от 1 до 4096.

По умолчанию

8

parallelizm_media

Число потоков для обработки сообщений от клиентов на медиа сервере

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

от 1 до 4096.

По умолчанию

8

monitoring-client

Включить отправку метрик мониторинга хоста на главный сервер

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

yes, no.

По умолчанию

yes

used-ip-version

Версия IP-протокола для сетевого взаимодействия компонентов СРК

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

ipv4, ipv6, both.

client-hello-timeout

Таймаут (в сек) на получение ClientHello от клиента после установки TCP-соединения

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

от 0.

По умолчанию

60

client-ping-timeout

Время ожидания (в сек) ответа на ping-запрос

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

от 0.

По умолчанию

1

client-alive-timeout

Общее время (в сек) для поддержания неактивного соединения

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

от 0.

По умолчанию

60

client-request-timeout

Время (в сек) на получение полного запроса после подключения

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

от 0.

По умолчанию

60