Dist-Upgrade 支持

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

• Debian 6 到 Debian 7
• Debian 7 到 Debian 8
• Ubuntu 12.04 到 Ubuntu 14.04

警告： 如果您在非 Debian 6 或 7或 Ubuntu 12.04 的 Linux 版本上运行 Plesk，请不要尝试升级操作系统。Odin 不支持此类升级路径，尝试此类升级将会破坏您的 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：请根据下面链接中的说明操作：http://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 转换不完全。请重启服务器即可解决问题。