Apache Tomcat® - 升级 Apache Tomcat

升级 Apache Tomcat^® 可能很简单，也可能很复杂，具体取决于您的环境复杂程度。本文档解释了升级 Apache Tomcat 的一些基本知识，可以作为您制定自己的环境特定升级计划和程序的起点。

本基本升级指南未涵盖一些主题。

Apache Tomcat 项目不提供补丁。如果在特定版本的 Tomcat 中宣布了功能、错误修复或安全补丁，则您必须升级到该版本。您可能可以从您的操作系统供应商或其他技术支持组织获得补丁，但 Apache Tomcat 项目不会提供此类补丁。

本文档不涵盖升级嵌入式环境中使用的 Apache Tomcat。假设您在嵌入式环境中使用 Apache Tomcat，那么您拥有执行升级所需的知识，无需像这里提供的入门文档。

升级可以分为两种不同的升级：主要版本之间的升级（例如，从 9.0 升级到 10.0）——称为“主要升级”，以及单个版本内的升级（例如，从 9.0.45 升级到 9.0.85）——称为“次要升级”。每种升级类型的步骤不同。

Apache Tomcat 版本号的格式为 X.Y.Z，其中 X.Y 是“主”版本号，Z 是主版本内的修订号。从 Tomcat 8.0 升级到 8.5 被认为是“主要升级”，而从 8.5.25 升级到 8.5.85 被认为是“次要升级”。

在升级主要版本的 Tomcat（例如从 9.0 升级到 10.0）时，最好从一个标准安装的 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 版本中。

您可能还想从以前的安装中复制或调整一些其他配置文件。以下是您可能在旧安装中自定义的这些其他文件的列表。

如果您不确定，可以使用上面显示的相同技术来检查您的安装与标准 Apache Tomcat 配置文件之间是否存在任何差异。

通常，次要升级非常简单，您可以使用与先前版本相同的配置文件，无需任何更改。

阅读您正在使用的主要版本的迁移指南仍然很重要，特别是“升级”部分。

迁移指南还包含一个“显著变化”部分，其中包括主要版本内的变化 - 也就是说，主要版本修订号内的次要版本 - 包含一个非常重要的变化。这些变化包括引入新的默认值、新的要求（通常是为了安全），或者与以前版本的不兼容变化（通常也是为了安全）。

最后，迁移指南有一个部分允许您比较不同次要版本之间的默认配置文件，以查看这些版本之间是否进行了任何重要更改。使用起来很简单：只需从迁移指南页面上的下拉框中选择您的旧版本和新版本，然后点击“查看差异”。

在RUNNING.txt中，有一个名为“高级配置 - 多个 Tomcat 实例”的部分。它旨在描述如何使用单个 Apache Tomcat 安装来运行多个独立的服务器实例。此技术可以用来简化升级过程。

有一个演示文稿可以引导您完成拆分安装的过程，然后描述如何执行升级。

Apache Tomcat^®