Миграция с 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".