本页内容
- 前置条件
- 1. 将系统从 Ubuntu 20.04 升级到 Ubuntu 22.04
- 2. 清理 mailman
- 3. 安装缺失的 PHP 软件包
- 4. 对 ISPConfig 执行强制更新
- 5. 更新路径以使用 PHP 8.1 作为默认 PHP 版本
- 6. 更新 phpMyAdmin(可选)
本教程将带你逐步将一台由 ISPConfig 管理的服务器从 Ubuntu 20.04(Focal Fossa)升级到 Ubuntu 22.04(Jammy Jellyfish)。本指南同时适用于单服务器和多服务器部署,只需在每台服务器上重复相同的步骤即可。
警告:mailman2 在 Ubuntu 22.04 中不受支持,而 mailman3 目前尚不被 ISPConfig 支持。请注意,升级过程可能会导致部分停机时间。
前置条件
- 请确保你以 root 用户身份登录
1. 将系统从 Ubuntu 20.04 升级到 Ubuntu 22.04
请先按照关于升级 Ubuntu 系统本身的官方指南进行操作。
2. 清理 mailman
如果曾安装 mailman2,我们必须重命名其数据目录,以防止邮件传输冲突。
mv /var/lib/mailman /var/lib/mailman-bk
然后运行以下命令:
mkdir -p /var/lib/mailman/data/
touch /var/lib/mailman/data/{aliases,transport-mailman,virtual-mailman}
postmap /var/lib/mailman/data/{aliases,transport-mailman,virtual-mailman}
以创建一些空文件来替代。
3. 安装缺失的 PHP 软件包
Ubuntu 22.04 默认搭载 PHP 8.1 作为默认 PHP 版本,因此我们需要安装它(同时安装后续所需的 curl):
apt -y install php8.1 php8.1-cli php8.1-cgi php8.1-fpm php8.1-gd php8.1-mysql php8.1-imap php8.1-curl php8.1-intl php8.1-pspell php8.1-sqlite3 php8.1-tidy php8.1-xsl php8.1-zip php8.1-mbstring php8.1-soap php8.1-opcache php8.1-common php8.1-readline php8.1-xml curl
如有必要,别忘了调整 PHP 配置文件。
如果你仍想为部分网站使用 PHP 7.4,可将其作为附加版本另行安装。
4. 对 ISPConfig 执行强制更新
为了重新配置各项服务,使其正确适配 Debian 11,我们需要运行 ISPConfig 的更新脚本并让其重新配置服务。通过命令行使用以下方式运行该脚本:
ispconfig_update.sh --force
逐步完成更新流程。当被问到是否要重新配置服务时,按回车键确认。如果回答“否”跳过此步骤,ISPConfig 将不会针对 Ubuntu 22.04 配置你的服务,部分服务可能会出现故障。
5. 更新路径以使用 PHP 8.1 作为默认 PHP 版本
由于 PHP 8.1 是 Ubuntu 22.04 自带的默认 PHP 版本,我们需要更新 ISPConfig 中的 PHP 路径。
以 admin 用户登录面板,然后进入 System -> Server Config -> server1.example.com(你的服务器主机名)-> Web -> PHP Settings
将对 7.4 的引用替换为 8.1,使其显示如下:
Apache php.ini path: /etc/php/8.1/apache2/php.ini CGI php.ini path: /etc/php/8.1/cgi/php.ini PHP-FPM init script: php8.1-fpm PHP-FPM php.ini path: /etc/php/8.1/fpm/php.ini PHP-FPM pool directory: /etc/php/8.1/fpm/pool.d PHP-FPM socket directory: /var/lib/php8.1-fpm
请注意,本服务器上所有使用“Default”作为 PHP 版本的网站,现在都将使用 PHP 8.1 而不是旧版本。
我们还需要让系统将 PHP 8.1 作为非 ISPConfig 操作的默认 PHP 处理器。为此,运行:
update-alternatives --config php
如果需要选择 PHP 版本,请选择 PHP 8.1。然后运行
update-alternatives --config php-cgi
如果需要选择 PHP 版本,同样请选择 PHP 8.1。最后运行
update-alternatives --config php-fpm.sock
如果需要选择 PHP 版本,请再次选择 PHP 8.1。
对于安装了 Apache2 的服务器,我们必须禁用 PHP-FPM 7.4 作为默认 PHP 处理器,并通过运行以下命令启用 PHP-FPM 8.1:
a2disconf php7.4-fpm
a2enconf php8.1-fpm
systemctl restart apache2
6. 更新 phpMyAdmin(可选)
如果你安装了 phpMyAdmin,我们建议进行更新,因为许多用户安装的版本都已过时。
运行以下命令来执行我们的 phpMyAdmin 更新脚本:
curl https://git.ispconfig.org/ispconfig/tools/-/raw/master/auto_update_phpmyadmin.sh -sL | sh
从现在起,你可以使用该脚本来自动保持 phpMyAdmin 为最新版本。
大功告成!如果你遇到任何问题,请在论坛上开一个主题。