手动升级 Apache Tomcat (Windows)

Apache Tomcat 是运行 ESET PROTECT Web Console 所需的必需组件。如果手动执行现有 Apache Tomcat 安装或者没有最新的 ESET PROTECT 一体式安装程序，则手动升级 Apache Tomcat。

如果安装了自定义版本的 Apache Tomcat（Tomcat 服务的手动安装），则通过一体式安装程序或通过组件升级任务的后续 ESET PROTECT Web 控制台升级不受支持。

升级之前

•Apache Tomcat 需要 64 位 Java/OpenJDK。如果在系统上安装了多个 Java 版本，建议您卸载较早的 Java 版本并仅保留最新的受支持的 Java 版本。

从 2019 年 1 月开始，面向企业、商业或生产用途的 Oracle JAVA SE 8 公开更新将需要商业许可证。如果不购买 JAVA SE 订阅，可以使用本指南来转换为免费替代方案。请参阅 JDK 的受支持版本。

•查看当前使用的是哪一个版本的 Apache Tomcat。

a.导航到 Apache Tomcat 安装文件夹：
C:\Program Files\Apache Software Foundation\[ Tomcat 文件夹 ]\

b.使用文本编辑器打开 RELEASE-NOTES 文件，然后检查版本号（例如 9.0.34）。

c.如果较新支持版本可用，请执行升级。

升级过程

1.停用 Apache Tomcat 服务。导航到启动 > 服务 > 右键单击 Apache Tomcat 服务并选择停止。

如果 Tomcat7w.exe 正在 Windows 通知区域中运行，请关闭它。

2.备份以下文件：

C:\Program Files\Apache Software Foundation\[ Tomcat 文件夹 ]\.keystore
C:\Program Files\Apache Software Foundation\[ Tomcat 文件夹 ]\conf\server.xml
C:\Program Files\Apache Software Foundation\[ Tomcat 文件夹 ]\webapps\era\WEB-INF\classes\sk\eset\era\g2webconsole\server\modules\config\EraWebServerConfig.properties

如果使用的是 Tomcat 文件夹中的自定义 SSL 证书存储，也请备份该证书。

3.卸载当前版本的 Apache Tomcat。

4.删除系统上仍存在的以下文件夹：

C:\Program Files\Apache Software Foundation\[ Tomcat 文件夹 ]\

5.从 https://tomcat.apache.org 下载最新支持版本的 Apache Tomcat 安装程序文件（32 位/64 位 Windows Service Installer）apache-tomcat-[版本].exe。

6.安装已下载的较新版本的 Apache Tomcat。

•如果已安装更多 Java 版本，请在安装期间选择最新 Java 的路径。

•安装完成后，请取消选中运行 Apache Tomcat 旁边的复选框。

7.将 .keystore、server.xml 和自定义证书恢复到其原始位置。

8.打开 server.xml 文件，并确保 keystoreFile 路径正确无误（如果已升级到主版本更高的 Apache Tomcat，则更新该路径）：

keystoreFile="C:\Program Files\Apache Software Foundation\[ Tomcat 文件夹 ]\.keystore"

9.确保为 ESET PROTECT Web 控制台正确配置了 Apache Tomcat 的 HTTPS 连接。

10. 部署 ESET PROTECT Web控制台（Web 控制台安装 - Windows）。

11. 将 EraWebServerConfig.properties 恢复到其原始位置。

12. 运行 Apache Tomcat 并设置正确的 Java VM：

a.导航到文件夹 C:\Program Files\Apache Software Foundation\[ Tomcat 文件夹 ]\bin，然后运行 Tomcat9w.exe。

b.在常规选项卡中，将启动类型设置为自动，然后按下启动。

c.单击 Java 选项卡、取消选中使用默认值、确保 Java 虚拟机包含 jvm.dll 文件的路径（参阅所示知识库说明），然后单击确定。

13. 连接到 ESET PROTECT Web 控制台并验证是否正确加载了 Web 控制台。

另请参见企业解决方案的 Web 控制台配置或低性能系统。

故障排除

•如果未成功设置 Apache Tomcat 的 HTTPS 连接，您可以跳过此步骤，暂时使用 HTTP 连接。

•如果 Apache Tomcat 的升级失败，请安装您的原始版本并应用步骤 2 中的配置。

•Web 控制台和 Apache Tomcat 升级会清除脱机帮助文件。如果使用了早期版本的 ESET PROTECT On-Prem 的脱机帮助，请在升级后为 ESET PROTECT On-Prem 11.1 重新创建它，以确保您有匹配 ESET PROTECT On-Prem 版本的最新脱机帮助。

˄˅