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 轉換不完全。請重啟伺服器即可解決問題。