Миграция с CentOS 7 на AlmaLinux 8

Для чего это нужно

С 30.07.2024 года завершилась поддержка ОС CentOS 7. Установка и работа панели управления ispmanager 6 на сервере с CentOS 7 в ближайшее время не будет поддерживаться.

Для получения актуальных обновлений, а также корректной работы самой панели ispmanager 6, вы можете конвертировать систему в AlmaLinux.

Инструкции

Обратите внимание!

Конвертация выполняется с помощью специального скрипта и инструмента Elevate.

Резервное копирование

Перед началом конвертации обязательно создайте снапшот системы и резервную копию баз данных. Это необходимо, так как последствия конвертации могут быть непредсказуемы, вплоть до полной неработоспособности сервера.

Убедитесь, что у вас есть возможность восстановить работоспособность сервера до запуска конвертации.

Подготовка

Перед запуском скрипта и конвертации, необходимо убедиться, что сервер соответствует требованиям конвертации.

Требования к ОС

Убедитесь, что используется последняя доступная версия CentOS 7, выполнив команду:

cat /etc/centos-release

Вывод должен выглядеть следующим образом:

CentOS Linux release 7.9.2009 (Core)

Если версия ОС в выводе ниже, чем указано в примере, необходимо выполнить обновление системных пакетов с помощью команды:

yum update

Поскольку пакеты CentOS 7 были перемещены в архивные репозитории, может потребоваться изменить ссылки на системные репозитории, выполнив следующие две команды:

sed -i 's/mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-*
sed -i 's|#baseurl=http://mirror.centos.org|baseurl=https://vault.centos.org|g' /etc/yum.repos.d/CentOS-*

После этого повторите команду для обновления пакетов.

Требования к панели

Убедитесь, что на сервере установлена панель версии не ниже 6.95.0. Проверить версию можно в разделе О программе, а также выполнив команду в консоли:

/usr/local/mgr5/bin/core ispmgr -i

Требования к серверу

Для корректной конвертации соблюдайте следующие требования к ресурсам сервера:

Оперативная память - не менее 4ГБайт;
Свободное дисковое пространство - не менее 5ГБайт.

Также на сервере должны быть установлены пакеты grub, screen и python3.

Прочие требования к системе

Также конвертации могут помешать определенные настройки системы, а также установленные пакеты:

Убедитесь, что отключены все сторонние репозитории;
Версии PHP, установленные из репозиториев «remi», «rhel» и «sci» могут перестать работать;
Конвертация баз данных MySQL версии ниже 8.0.36 или MariaDB версии ниже 5.5.68 приведет к повреждению этих баз данных;
Использование зашифрованных разделов приведет к ошибке конвертации;
Использование параметра xfc ftype=0 приведет к ошибке конвертации;
Убедитесь, что удалены драйверы floppy, pata_acpi и sata_via.

Процесс конвертации

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

Скрипт выполнит проверку требований, которые описаны выше, после чего будет запущена конвертация.

Скачайте и разархивируйте скрипт, выполнив следующие команды:

curl -o centos7-to-alma8.tgz "http://download.ispmanager.com/tools/centos7-to-alma8.tgz"
tar -xzvf centos7-to-alma8.tgz
cd centos7-to-alma8

Сам скрипт рекомендуется запускать в отдельной виртуальной вкладке утилиты screen:

screen
python3 main.py --reboot

Перед запуском процесса проверки и конвертации, скрипт выведет предупреждение:

Если вы готовы запустить процесс, введите yes;
Если в данный момент скрипт запускать не требуется, введите no.

Дождитесь окончания процесса конвертации - в это время сервер будет перезагружен.

Исходные варианты конфигурационных файлов будут сохранены по пути /var/config_backups/.

Обратите внимание!

Скрипт может завершиться с ошибкой по множеству причин.

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

Логирование

Журнал скрипта расположен по пути /root/centos7-to-alma8/convertation.log.

Журнал утилиты Elevate расположен по пути /var/log/leapp/upgrade.log.

При успешной конвертации будет создан файл с отчетом по пути /root/centos7-to-alma8/convertation-report.txt.

Известные проблемы при конвертации

При использовании комбинации OpenLiteSpeed и PostgreSQL, работа PostgreSQL будет нарушена после конвертации;
При использовании Afterlogic, он будет заменен на RoundCube после конвертации, однако сам Afterlogic продолжит работать;
В случае использования старой версии панели, для которой пользователи создавались с UID до значения 1010, могут возникнуть проблемы с Dovecot после конвертации. Для исправления работы с такими пользователями в файле /etc/dovecot/conf.d/10-mail.conf нужно заменить значение параметра first_valid_uid на 500.

Linux