Debian 11からDebian 12へのISPConfigパーフェクトサーバーのアップデート

このチュートリアルでは、ISPConfigで管理されているサーバーをDebian 11（bullseye）からDebian 12（bookworm）にアップデートする手順を説明します。このガイドは、単一サーバーおよびマルチサーバーのセットアップの両方に対応しています。すべてのサーバーで同じ手順を繰り返してください。

アップデートプロセスにより、一時的なダウンタイムが発生する可能性があることに注意してください。

前提条件

rootユーザーとしてログインしていることを確認してください。

1. Debian 11からDebian 12へのシステムのアップデート

まず、Debian自体のアップデートに関するガイドを確認してください: https://www.howtoforge.com/how-to-upgrade-from-debian-11-to-debian-12/

2. 不足しているPHPパッケージのインストール

Debian 12にはデフォルトのPHPバージョンとして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を引き続き使用したい場合は、https://www.howtoforge.com/ispconfig-php-debian/ に従って追加のバージョンとしてインストールしてください。

4. ISPConfigの強制アップデートを実行

サービスがDebian 12に正しく構成されるように再構成するために、ISPConfigのアップデートスクリプトを実行し、サービスを再構成させる必要があります。コマンドラインから次のスクリプトを実行します:

ispconfig_update.sh --force

アップデート手順に従ってください。サービスを再構成するかどうか尋ねられたら、Enterキーを押してください。このステップを「いいえ」と答えてスキップすると、ISPConfigはDebian 12用にサービスを構成せず、一部のサービスが壊れる可能性があります。

5. PHP 8.2をデフォルトのPHPバージョンとして使用するためのパスの更新

PHP 8.2がDebian 12に搭載されているデフォルトのPHPバージョンであるため、ISPConfig内のPHPパスを更新する必要があります。

管理者ユーザーとしてパネルにログインし、次にSystem -> Server Config -> server1.example.com（サーバーのホスト名） -> Web -> PHP Settingsに移動します。

7.4への参照を8.2に置き換え、次のようにします:

Apache php.ini path: /etc/php/8.2/apache2/php.ini  
CGI php.ini path: /etc/php/8.2/cgi/php.ini  
PHP-FPM init script: php8.2-fpm  
PHP-FPM php.ini path: /etc/php/8.2/fpm/php.ini  
PHP-FPM pool directory: /etc/php/8.2/fpm/pool.d  
PHP-FPM socket directory: /var/lib/php8.2-fpm

このサーバー上のすべてのウェブサイトが「デフォルト」のPHPバージョンを使用する場合、古いバージョンの代わりにPHP 8.2を使用することに注意してください。

また、システムがISPConfig以外のアクションに対してPHP 8.2をデフォルトのPHPハンドラーとして使用するように設定する必要があります。これを行うには、次を実行します:

update-alternatives --config php

PHPバージョンを選択する必要がある場合は、PHP 8.2を選択してください。次に、実行します:

update-alternatives --config php-cgi

PHPバージョンを選択する必要がある場合は、PHP 8.2を選択してください。最後に、実行します:

update-alternatives --config php-fpm.sock

PHPバージョンを選択する必要がある場合は、再度PHP 8.2を選択してください。

Apache2がインストールされているサーバーでは、デフォルトのPHPハンドラーとしてPHP-FPM 7.4を無効にし、PHP-FPM 8.2を有効にするために次のコマンドを実行する必要があります:

a2disconf php7.4-fpm  
a2enconf php8.2-fpm  
systemctl restart apache2

6. phpMyAdminのアップデート（オプション）

phpMyAdminがインストールされている場合は、多くのユーザーが古いバージョンをインストールしているため、インストールをアップデートすることをお勧めします。

次のコマンドを実行して、phpMyAdminのアップデートスクリプトを実行します:

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

今後は、このスクリプトを使用してphpMyAdminを自動的に更新できます。詳細については、このフォーラムの投稿を参照してください: https://www.howtoforge.com/community/threads/keep-your-phpmyadmin-installation-up-to-date-automatically.88495/

完了です！問題がある場合は、フォーラムでスレッドを開いてください。