Установка

1. Подготовка к установке модуля

Pictures/100000010000034E0000034E4816A52DED4742B6Проверьте выполнение требований, указанных на странице Общие сведения.

1.1. Подготовка клиента РК

  • На узле с установленной СУБД MySQL, развёрнут и настроен клиент резервного копирования, который подключен к основному серверу СРК RuBackup в соответствии с документом «Система резервного копирования и восстановления данных RuBackup. Руководство по установке и обновлению»;

  • На клиенте резервного копирования рекомендуется активировать функцию централизованного восстановления в тех случаях, когда предполагается восстановление СУБД посредством Менеджера администратора RuBackup (RBM). Управление функцией централизованного восстановления данных обеспечивается значением параметра centralizedrecovery конфигурационного файла /opt/rubackup/etc/config.file текущего клиента резервного копирования RuBackup.

1.2. Подготовка данных для подключения к СУБД

  • Предварительно подготовьте следующие данные для настройки подключения к СУБД MySQL:

  • получите у администратора СУБД MySQL учётные данные пользователя для авторизации в СУБД MySQL и правами доступа[1] для выполнения резервного копирования с помощью утилиты xtrabackup или утилиты innobackupex (в зависимости от используемой версии СУБД MySQL);

  • предварительно подготовьте авторизационный файл с помощью утилиты mysql_config_editor;

  • зафиксируйте следующие данные для подключения модуля к СУБД MySQL:

    • путь до утилиты xtrabackup или innobackupex (в зависимости от используемой версии СУБД MySQL);

    • имя сервиса СУБД MySQL (в зависимости от используемой операционной системы);

    • имя пользователя ОС, от имени которого происходит запуск сервиса СУБД MySQL.

2. Установка модуля

  1. На подготовленном узле клиента РК произведите установку модуля СУБД MySQL СРК RuBackup rb_module_mysql из пакета rubackup-mysql-<version>, выполнив команду:

    Astra Linux, Debian, Ubuntu

    sudo apt install ./rubackup-mysql-<version>_amd64_signed.deb

    Альт

    sudo apt-get install ./rubackup-mysql-<version>.x86_64_signed.rpm

    Rosa Cobalt, RHEL

    sudo yum install ./rubackup-mysql-<version>_x86_64_signed.rpm

    RedOS, CentOS, Rosa Chrome

    sudo dnf install ./rubackup-mysql-<version>.x86_64_signed.rpm

    где <version> — номер версии модуля СУБД MySQL СРК RuBackup.

  2. После запуска команды установки модуля выполняются:

    • распаковка пакета модуля СУБД MySQL СРК RuBackup;

    • настройка пакета rubackup-mysq.

  3. В результате установки пакета модуля СУБД MySQL созданы:

    /opt/rubackup/etc/rb_module_mysql.conf

    Конфигурационный файл модуля СУБД MySQL для настроек доступа СРК RuBackup к СУБД MySQL

    /opt/rubackup/modules/rb_module_mysql

    Утилита резервного копирования и восстановления данных СУБД MySQL

3. Настройка параметров конфигурационного файла модуля

  1. Определите значения параметров конфигурационного файла opt/rubackup/etc/rb_module_mysql.conf, приведенных в таблице Таблица 1. Для этого отредактируйте конфигурационный файл, выполнив команду:

    sudo nano /opt/rubackup/etc/rb_module_mysql.conf
    Таблица 1. Параметры конфигурационного файла /opt/rubackup/etc/rb_module_mysql.conf

    username

    Имя для авторизации пользователя СУБД MySQL, от имени которого будет выполнено резервное копирование с соответствующими правами[1] на данные операции

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

    password

    Пароль для авторизации пользователя СУБД MySQL, от имени которого будет выполнено резервное копирование с соответствующими правами[1] на данные операции

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

    port

    Порт для соединения с сервером баз данных MySQL по протоколу TCP/IP

    <порт> (по умолчанию — 3306)

    direct_restore

    Управление процессом развёртывания/обновления модуля на целевом ресурсе. Параметр используется для поддержки обратной совместимости при обновлении СРК RuBackup

    yes, no (по умолчанию — yes)

    mysql_admin

    Учетная запись пользователя операционной системы, от имени которого осуществляется запуск сервиса СУБД MySQL

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

    use_memory

    Максимальный объём буферной памяти, используемый утилитой xtrabackup или innobackupex при создании резервной копии, в мегабайтах

    Целое число (по умолчанию — 100 М)

    mysql_service

    Фактическое имя сервиса MySQL для запуска

    (по умолчанию — mysqld)

    mysqladmin_path

    Путь к утилите mysqladmin

    <path>

    innobackupex_path[2]

    Путь к утилите innobackupex

    <path>

    xtrabackup_path[3]

    Путь к утилите xtrabackup

    <path>

  2. Для применения настроек перезапустите сервис клиента РК RuBackup на узле, на котором установлен клиент РК и модуль СУБД MySQL, выполнив команду:

    sudo systemctl restart rubackup_client

4. Критерий успешности установки модуля

  • Критерием успешности установки и настройки модуля СУБД MySQL будет являться запись о его успешной проверке клиентом резервного копирования («… module 'MySQL was checked successfully») в журнале событий /opt/rubackup/log/RuBackup.log.

  • В случае, если в журнале событий /opt/rubackup/log/RuBackup.log Администратор СРК видит ошибку о неправильной конфигурации модуля MySQL, то необходимо проверить настройки конфигурационного файла /opt/rubackup/etc/rb_module_mysql.conf в ручном режиме, выполнив в терминале клиента РК команду:

    /opt/rubackup/modules/rb_module_mysql -t

Если ошибка не поддается анализу, то администратору СРК следует создать инцидент в сервисе технической поддержки RuBackup с предоставлением всей необходимой информации по возникшей проблеме на официальном сайте https://support.rubackup.ru/bugzilla/.

1. Подробнее о необходимых правах пользователя https://docs.percona.com/percona-xtrabackup/8.4/privileges.html?h=privi
2. Необходимо указать только при резервном копировании СУБД MySQL версии 5.
3. Необходимо указать только при резервном копировании СУБД MySQL версии 8.