Переход на новую мажорную версию операционной системы — всегда ответственный шаг для любого системного администратора. С выходом стабильного релиза Debian 12 (Bookworm) многие владельцы серверов планируют миграцию своих систем. В этой статье мы подробно разберем процесс обновления конфигурации Perfect Server под управлением панели ISPConfig с версии Debian 11 (Bullseye) до Debian 12.

Данное руководство применимо как для одиночных, так и для мультисерверных инфраструктур. Если ваша панель обслуживает несколько узлов, вам придется последовательно выполнить все шаги на каждом сервере. Обратите внимание, что процесс обновления повлечет за собой временную приостановку работы служб, поэтому работы лучше планировать на периоды минимальной активности пользователей.

Предварительные требования и обновление базовой системы

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

Первым делом необходимо обновить саму ОС. Процесс перехода подробно описан в специализированных инструкциях по системному апгрейду. Вам потребуется обновить текущие пакеты, заменить репозитории на актуальные для Bookworm и выполнить полное обновление дистрибутива. Убедитесь в стабильной работе базовой ОС перед адаптацией сервисов панели.

Установка пакетов PHP 8.2

Поскольку Debian 12 поставляется с PHP 8.2 по умолчанию, нам необходимо установить этот интерпретатор и сопутствующие модули, необходимые для работы сайтов и панели управления. Выполните команду:

apt-get install php8.2 php8.2-cli php8.2-cgi php8.2-fpm php8.2-gd php8.2-mysql php8.2-imap php8.2-curl php8.2-intl php8.2-pspell php8.2-sqlite3 php8.2-tidy php8.2-xsl php8.2-zip php8.2-mbstring php8.2-soap php8.2-opcache libonig5 php8.2-common php8.2-readline php8.2-xml curl

После установки скорректируйте конфигурационные файлы PHP при необходимости. Если для сайтов вам все еще нужен PHP 7.4, его можно установить параллельно как дополнительную версию, используя стандартные руководства по интеграции альтернативных версий PHP в ISPConfig.

Принудительное обновление конфигурации ISPConfig

Чтобы системные службы были корректно перенастроены под новую ОС, запустите процедуру принудительного обновления ISPConfig. Скрипт автоматически перепишет конфигурационные файлы сервисов. В терминале выполните команду:

ispconfig_update.sh –force

Интерактивный помощник проведет вас через все шаги. Когда появится вопрос о необходимости перенастройки служб (reconfigure services), обязательно нажмите Enter. Если пропустить этот этап, выбрав отрицательный ответ, ISPConfig не настроит сервисы под Debian 12, что приведет к сбоям в их работе.

Обновление путей PHP в панели ISPConfig

Так как PHP 8.2 становится стандартом в новой системе, мы должны обновить пути к интерпретатору в настройках ISPConfig. Зайдите в панель управления под администратором и перейдите в меню: System -> Server Config -> server1.example.com (имя вашего сервера) -> Web -> PHP Settings.

Замените упоминания версии 7.4 на 8.2, чтобы параметры приняли следующий вид:

• Путь к Apache php.ini: /etc/php/8.2/apache2/php.ini
• Путь к CGI php.ini: /etc/php/8.2/cgi/php.ini
• Инициализационный скрипт PHP-FPM: php8.2-fpm
• Путь к PHP-FPM php.ini: /etc/php/8.2/fpm/php.ini
• Директория пулов PHP-FPM: /etc/php/8.2/fpm/pool.d
• Директория сокетов PHP-FPM: /var/lib/php8.2-fpm

Все сайты на сервере, использующие версию PHP «Default», автоматически перейдут на работу с PHP 8.2.

Также нужно назначить PHP 8.2 системным обработчиком по умолчанию для консоли и внешних утилит. Выполните три команды, выбирая в меню версию PHP 8.2:

update-alternatives –config php

update-alternatives –config php-cgi

update-alternatives –config php-fpm.sock

Для серверов с веб-сервером Apache2 необходимо отключить старую конфигурацию PHP-FPM и активировать новую, выполнив команды:

a2disconf php7.4-fpm

a2enconf php8.2-fpm

systemctl restart apache2

Обновление phpMyAdmin (опционально)

Если в системе установлен phpMyAdmin, рекомендуется обновить его, так как у многих пользователей установлена устаревшая версия. Запустите скрипт обновления командой:

curl https://git.ispconfig.org/ispconfig/tools/-/raw/master/auto_update_phpmyadmin.sh -sL | bash

Вы можете использовать этот же скрипт для регулярного автоматического обновления утилиты в будущем.

На этом процесс перехода завершен. При возникновении сложностей вы можете обратиться за помощью к сообществу на официальном форуме поддержки.

Источник: howtoforge.com