Обновление MariaDB на AlmaLinux

Предупреждение

Перед обновлением резервные копии администратора панели, пользователей панели и их баз данных должны быть настроены и успешно созданы в панели.

Также крайне рекомендуется свериться с официальной документацией MariaDB указанных версий до выполнения обновления для проверки совместимости директив, их значений и параметров данных баз данных.

Подготовка

Убедитесь, что на диске свободно как минимум 2 ГБайта + место для полной резервной копии всех баз данных :

df -h /

Убедитесь, что свободно не менее 2 ГБайт оперативной памяти:

free -mh

Обновите все пакеты системы:

dnf update

Отключите мониторинг службы mariadb в панели в разделе Службы через кнопку Мониторинг.

Остановите работу панели ispmanager 6:

/usr/local/mgr5/sbin/mgrctl -m core --lock

Убедитесь выводом пустого результата этой команды, что процессы панели остановлены:

ps aux | grep -i "bin/core ispmgr" | grep -v grep

Скопируйте root-пароль СУБД из /root/.my.cnf и создайте резервную копию (дамп) всех баз данных нативной СУБД:

mysqldump -u root -p<пароль> --all-databases --single-transaction --quick --lock-tables=false > full-backup-$(date +%F).sql

Проверьте наличие строки "Dump completed" в дампе - она укажет на успешное создание дампа:

tail <имя_дампа>

Если необходимо запустить панель после её остановки ранее, смотрите раздел Запуск и проверка.

Обновление

Остановите службу MariaDB:

systemctl stop mysqld

Отключите модули mariadb и mysql из AppStream:

dnf module disable mariadb -y
dnf module disable mysql -y

Сгенерируйте зеркало репозитория на официальном сайте MariaDB:

• Откройте вкладку MariaDB Server Repositories
• Выберите дистрибутив Red Hat Enterprise Linux X, где X - номер версии вашей ОС
• Выберите версию MariaDB 11.4
• Выберите ближайшее к вам зеркало

Подключите репозиторий новой версии MariaDB, вставив сгенерированное содержимое между командами EOF, например:

tee /etc/yum.repos.d/MariaDB.repo << EOF
[mariadb]
name = MariaDB
baseurl = https://rpm.mariadb.org/11.4/rhel/\$releasever/\$basearch
module_hotfixes=1
gpgkey=https://rpm.mariadb.org/RPM-GPG-KEY-MariaDB
gpgcheck=1
enabled=1
EOF

Подключите репозиторий с зависимостями:

tee /etc/yum.repos.d/mysql-community.repo << EOF
[mysql-8.4-lts-community]
name=MySQL 8.4 LTS Community Server
baseurl=http://repo.mysql.com/yum/mysql-8.4-community/el/\$releasever/\$basearch/
enabled=1
gpgcheck=1
gpgkey=https://repo.mysql.com/RPM-GPG-KEY-mysql-2025
EOF

Ссылка на GPG-ключ может измениться. Проверить актуальный файл с ключом можно в самом репозитории.

Очистите и пересоздайте кэш пакетов:

dnf clean all
dnf makecache

Удалите старые пакеты MariaDB:

rpm -e mariadb-server mariadb-common mariadb mariadb-backup mariadb-errmsg mariadb-gssapi-server mariadb-server-utils mariadb-connector-c mariadb-connector-c-config --nodeps

Установите пакеты новой версии MariaDB:

dnf install MariaDB-server MariaDB-client

Запуск и проверка

Проверьте конфигурационный файл на ошибки:

mariadbd --defaults-file='/etc/my.cnf.d/mariadb-server.cnf.rpmsave' --verbose --help | grep 'ERROR\]'

Если ошибки отсутствуют, восстановите его для работы:

cp -ar /etc/my.cnf.d/mariadb-server.cnf.rpmsave /etc/my.cnf.d/mariadb-server.cnf

Если вы используете собственные дополнительные конфигурационные файлы, проверьте, исправьте и восстановите их с помощью приведенных выше команд, указав вместо mariadb-server.cnf.rpmsave и mariadb-server.cnf имена ваших конфигураций.

Проверьте версию MariaDB:

rpm -qa | grep -iE "(mysql|mariadb)" | grep -i server

Запустите и проверьте статус службы MariaDB:

systemctl start mariadb
systemctl status mariadb

Если служба не запускается, убедитесь что в конфигурационном файле назначен журнал для директивы log_error. По умолчанию, журнал расположен по пути /var/log/mysql/error.log . Посмотреть последние записи можно через команду:

tail -n 50 /var/log/mysql/error.log

Если ошибки отсутствуют, обновите структуру баз данных:

mariadb-upgrade

Удалите следующие символические ссылки:

rm /lib/systemd/system/mysqld.service /lib/systemd/system/mysql.service /usr/lib/systemd/system/mysqld.service /usr/lib/systemd/system/mysql.service -f; systemctl daemon-reload

Включите службу в автозагрузку:

systemctl enable mariadb

Перезагрузите службу СУБД:

systemctl restart mariadb

Установите новый путь до исполняемого файла для панели ispmanager 6:

sed -i "s/\/usr\/libexec\/mysqld/\/usr\/sbin\/mariadbd/g" /usr/local/mgr5/etc/ispmgr.conf.d/mysql.conf

Проверьте авторизацию в СУБД:

mariadb -u root -p

Запустите панель:

/usr/local/mgr5/sbin/mgrctl -m core --unlock

Перейдите в раздел Уведомления и удалите уведомления о решении проблемы службы mariadb, если оно есть.

Действия после обновления

• У сайтов работающих на PHP-FPM возможно появление ошибки 404 - это связано с отсутствием поддержки ЧПУ у сайта. Вы можете включить поддержку ЧПУ в настройках каждого конкретного сайта в разделе Сайты.
• В AlmaLinux 8 для корректной работы phpMyAdmin потребуется по инструкции изменить системный PHP на версию 7.4, поскольку нативная версия 7.2 не поддерживает работу плагина caching_sha2_password и phpMyAdmin не сможет выполнять авторизацию на новый сервер баз данных.
• Включите мониторинг службы mariadb в панели в разделе Службы через кнопку Мониторинг.