老薛主机帮助中心

自 Plesk 12.5 起，可以在 Plesk 服务器上升级操作系统。在 Plesk 中支持以下 dist-upgrade 升级路径：

Debian 6 到 Debian 7
Debian 7 到 Debian 8
Ubuntu 12.04 到 Ubuntu 14.04
警告： 如果您的 Plesk 不是在 Debian 6 或 7或 Ubuntu 12.04 的 Linux 版本上运行，请不要尝试升级操作系统。不支持此类升级路径，尝试此类升级将会破坏您的 Plesk 安装实例。

警告： 请仔细阅读说明并进行相应操作。如果不按照说明操作可能会导致 Plesk 与其服务运行不正常。

若要执行 dist-upgrade，请按以下步骤进行：

1.在执行 dist-upgrade 之前，请确保您已了解了可能遇到的问题。

如果您从 Debian 6 升级，请参阅：https://www.debian.org/releases/wheezy/amd64/release-notes/ch-upgrading.en.html#trouble.

如果您从 Debian 7 升级，请参阅：https://www.debian.org/releases/stable/i386/release-notes/ch-upgrading.en.html#trouble.
2.运行升级前脚本。升级前脚本名为 distupgrade.helper.<OS.old-OS.new>_pre.sh，位于 /usr/local/psa/bin 目录。

3.请根据操作系统文档执行 dist-upgrade：

Debian 6：请根据下面链接中的说明操作：https://www.debian.org/releases/wheezy/i386/release-notes/ch-upgrading.html.
Debian 7：请根据下面链接中的说明操作：https://www.debian.org/releases/jessie/i386/release-notes/ch-upgrading.en.html
Ubuntu 12.04：请使用 do-release-upgrade 工具，具体描述如下：https://help.ubuntu.com/14.04/serverguide/installing-upgrading.html
4.运行升级后脚本。升级后脚本名为 distupgrade.helper.<OS.old-OS.new>_post.sh，位于 /usr/local/psa/bin 目录。

升级后脚本完成后，Plesk 应该可以运行了。您可以查看升级日志 /var/log/plesk/install/plesk-distupgrade.log 了解有关升级的详情。

从失败的 Dist-Upgrade 恢复

若要从失败的 dist-upgrade 恢复，请根据以下步骤操作：

检查更新查找系统包

1.请确保 /etc/apt/sources.list 和 /etc/apt/sources.list.d/ 中的库切换为新的操作系统版本（例如，如果您升级到 Debian 8，则是 "jessie"，升级到 Debian 7，则是 "wheezy"，以及升级到 Ubuntu 14，会是 "trusty"）。

2.运行 apt-get update、apt-get upgrade 和 apt-get dist-upgrade 命令。如果没有程序包需要更新，则表示已经安装了升级。否则，程序包需要升级。

检查更新查找 Plesk 包

1.检查已安装的程序包列表。请运行 dpkg -l | less 命令。Plesk 程序包通常有 "plesk-"、"psa" 或 "sw-" 前缀或后缀。请确保所有的 Plesk 程序包版本都包含您要升级到的操作系统名称（例如，如果从 Debian 7 升级，则是 "debian8"）。

2.如果一个或多个 Plesk 程序包版本包含您要升级自的操作系统名称（例如，如果您从 Debian 6 升级，则是 "debian6"），这些程序包则需要升级。

升级程序包

1.启用 Plesk 库。

1)请运行 plesk-installer --skip-cleanup 命令（添加其它的必要选项）。

2)选择当前安装的 Plesk 版本，例如，12.5.30。

3)等候组件列表加载，然后取消安装。

4)将会创建文件 /etc/apt/sources.list.d/50sw_autoinstaller.list。

2.使用新的操作系统代号代替旧的代号来编辑 apt 库 (/etc/apt/sources.list 和 /etc/apt/sources.list.d/*.list) （例如，使用"trusty" 替代 "precise"，使用 "wheezy" 替代 "squeeze"，使用 "jessie" 替代 "wheezy"）。

3.升级程序包。

1)请运行 apt-get update 命令。

2)请运行 apt-get upgrade 命令。

3)请运行 apt-get dist-upgrade 命令。

4.如果安装程序包失败，请运行 apt-get install -f 命令以重新配置未安装成功的程序包，修复错误，然后再试。

升级 Plesk 组件

1.升级程序包后，请再次运行 Plesk 安装程序并为已安装的组件安装更新。

修复 Plesk

1.请运行 plesk repair installation 命令。

2.请运行 plesk repair all -n 命令检查 Plesk 配置的问题。

3.如果检测出任何问题，则可以使用 plesk 修复命令（例如，plesk repair mail 或 plesk repair web）自动修复。如果自动修复失败，请尝试手动修复或联系支持。

潜在问题

如果配置 Apache 时出现 "API module structure...is garbled" 错误信息，表示 Apache 已被更新，但是其中一个或多个模块并未更新。因此请禁用受影响的模块。
如果配置 Apache 时出现 "No matches for the wildcard '*.conf'" 错误信息，表示 Apache 已被更新，但是 /etc/apache2/conf.d 和 /etc/apache2/plesk.conf.d 中的一个或多个配置文件仍包含使用旧的句法的 Include 指令。请使用 IncludeOptional 替代 Include 就可以解决该问题。
如果启动 Apache 时出现 "Could not open configuration file ..." 错误信息则表示指定的文件是指向不存在的文件的符号链接。移除符号链接即可解决该问题。
如果启动 Apache 时出现 "Invalid command 'LockFile'" 错误信息则表示 Apache 已被更新，但是配置文件 /etc/apache2/apache2.conf 包含已弃用的 LockFile 指令。请替换以下行LockFile ${APACHE_LOCK_DIR}/accept.lock
换成该行

Mutex file:${APACHE_LOCK_DIR} default

即可解决问题。

如果启动 Apache 时出现 "SSLSessionCache ... session cache not supported" 错误信息则表示 socache_shmcb.load 文件已丢失。请运行以下命令

cp /etc/apache2/mods-available/socache_shmcb.load /etc/apache2/mods-enabled/

即可解决问题。您还应编辑 /etc/apache2/mods-enabled/ssl.conf 文件并替换该行

SSLMutex file:${APACHE_RUN_DIR}/ssl_mutex

换成该行

Mutex file:${APACHE_LOCK_DIR} ssl-cache

以避免其它问题的出现。

如果启动 Apache 时出现 "Invalid command 'Order'" 错误信息则表示 Apache 已被更新，但是 /etc/apache2/conf.d 和 /etc/apache2/plesk.conf.d 中的一个或多个配置文件包含已弃用的 Order 指令。请替换该行

Order allow,deny

Allow from all

换成该行

Require all granted

即可解决问题。

"Config file dir.conf not properly enabled" 错误信息可能表示文件 /etc/apache2/mods-enabled/dir.conf 是真实的文件而不是符号链接。请移除文件并创建指向 /etc/apache2/mods-available/dir.conf 的符号链接即可解决问题。

"Failed to get D-Bus connection" 错误信息可能表示从 init 到 systemd 转换不完全。请重启服务器即可解决问题。