Apache Tomcat^®

Apache Tomcat 專案不提供修補程式。如果在特定版本的 Tomcat 中宣告功能、錯誤修正或安全性修補程式，則您必須升級到該版本。您可能可以從作業系統供應商或其他技術支援組織取得修補程式，但 Apache Tomcat 專案不會提供此類修補程式。

本文件未涵蓋在嵌入式環境中使用的 Apache Tomcat 升級。假設如果您在嵌入式環境中使用 Apache Tomcat，那麼您具備在沒有入門文件（如本文所提供）的情況下執行升級所需的知識。

您應該閱讀與您的特定升級頁面相關的遷移指南。如果您從 Apache Tomcat 9.0 升級到 Apache Tomcat 10.0，您應該閱讀「Tomcat 10.0 遷移指南」，其中涵蓋從前一個版本升級時適用的一切事項。

如果您一次升級多個版本，您應該閱讀所有介於其中的遷移指南。例如，如果您從 Tomcat 8.5 升級到 Tomcat 10.1，您應該閱讀「Tomcat 9.0 遷移指南」、「Tomcat 10.0 遷移指南」和「Tomcat 10.1 遷移指南」。

您必須遷移的最重要的設定檔可能是您的 conf/server.xml 檔案。

快速判斷您的 server.xml 檔案可能需要哪些變更的一種方法是，使用 diff 程式將您現有的舊 Tomcat 版本檔案與 Apache Tomcat 舊版本附帶的原始設定檔進行比較。

例如

$ diff /path/to/stock/tomcat/conf/server.xml /path/to/your/tomcat/conf/server.xml

這將顯示針對原始檔案進行的變更，而這些變更是您的環境所獨有的。您可以將這些變更調整到您的新 Apache Tomcat 版本的新安裝。

您可能想要從您的前一個安裝複製或調整一些其他設定檔。以下是您可能在舊安裝中自訂過的其他檔案清單。

• conf/web.xml
• conf/context.xml
• conf/tomcat-users.xml
• conf/logging.properties
• bin/setenv.sh（如果存在）
• conf/catalina.properties
• conf/catalina.policy
• conf/jaspic-providers.xml

如果您不確定，可以使用上面顯示的相同技術來檢查您的安裝與 Apache Tomcat 庫存組態檔之間的任何差異。

仍然重要的是閱讀您正在使用的主要版本的移轉指南，特別是「升級」部分。

移轉指南還包含「顯著變更」部分，其中包含主要版本內的變更，也就是主要版本修訂號碼內的次要版本，其中包含非常重要的變更。這些類型的變更包括引入新的預設值、新的需求（通常是安全性）或與先前版本的重大變更（通常也是安全性）。

最後，移轉指南有一個部分，讓您可以在次要版本之間比較庫存組態檔，以查看這些版本之間是否進行了任何重要的變更。使用很簡單：只要從移轉指南頁面上的下拉式方塊中選擇您的舊版本和新版本，然後「檢視差異」即可。