如何升级用于 NuGenesis SDMS 的 Apache Tomcat 版本 - WKB111885
文章编号: 111885点击此处访问英文版本文章
目的
在 NuGenesis SDMS Web 服务器中升级 Apache Tomcat 的版本。
环境
- NuGenesis 9 SDMS
- 缺省 Apache Tomcat v9.0.8
- NuGenesis 8 SDMS
- 缺省 Apache Tomcat v6.0.29
- 适用于 NuGenesis 9 的可接受的 Apache Tomcat 新版本(最低带有 Java 8 Update 172 x86):
- v9.0.x x8632 位 Windows 发行版
- 适用于 NuGenesis 8 的可接受的 Apache Tomcat 新版本(全部带有 Java 7 Update 2 x86):
- v6.0.x x86
- v7.0.x x86
- v8.0.x x86
- v8.5.x x86
步骤
- 从 https://tomcat.apache.org 下载 Apache Tomcat 的最新版“32 位 Windows zip”发行版
- 将文件解压到各自的文件夹中;例如,对于 Tomcat 6.0.53,将其解压到驱动器:\Program Files (x86)\apache-tomcat-6.0.53;对于 Tomcat 9.0.44,将其解压到驱动器:\Program Filex (x86)\Waters\apache-tomcat-9.0.44。新版本 Tomcat 下的目录结构应反映使用 NuGenesis SDMS 部署的 Tomcat 文件夹结构
- 在“记事本”中编辑以下 server.xml 文件:
- NuGenesis 8:驱动器:\Program Files (x86)\apache-tomcat-X.Y.ZZ\conf\server.xml
- NuGenesis 9:驱动器:\Program Files (x86)\Waters\apache-tomcat-X.Y.ZZ\conf\server.xml
- 将以下行添加到 server.xml 的末尾,添加到 "</Host>" 行的上方:
- <Context path="/ngaudit/servlet" docBase="NGAudit" reloadable="true" cookies="true" useHttpOnly="false"/>
- <Context path="/servlet" docBase="WebVision" reloadable="true" />
- 保存并关闭 server.xml
- 将 NuGenesis Web 应用程序复制到新的 Tomcat 文件夹:
- NuGenesis 8:
- 将文件夹驱动器:\Program Files (x86)\apache-tomcat-6.0.29\webapps\NGAudit to Drive:\Program Files (x86)\apache-tomcat-X.Y.ZZ\webapps
- 将文件夹驱动器:\Program Files (x86)\apache-tomcat-6.0.29\webapps\WebVision to Drive:\Program Files (x86)\apache-tomcat-X.Y.ZZ\webapps
- NuGenesis 9:
- 将文件夹驱动器:\Program Files (x86)\Waters\apache-tomcat-9.0.8\webapps\NGAudit 复制到驱动器:\Program Files (x86)\Waters\apache-tomcat-X.Y.ZZ\webapps
- 将文件夹驱动器:\Program Files (x86)\Waters\apache-tomcat-9.0.8\webapps\WebVision 复制到驱动器:\Program Files (x86)\Waters\apache-tomcat-X.Y.ZZ\webapps
- NuGenesis 8:
- 创建新服务。使用管理员权限在 cmd.exe 中运行以下命令。将“XYZZ”替换为 Tomcat 的版本号:
- 驱动器:\Program Files (x86)\apache-tomcat-X.Y.ZZ\bin\service.bat install tomcatXYZZ
- 注意:service.bat 仅可在 Apache Tomcat 的 Windows 发行版中获取。如果 Bin 文件夹中没有 service.bat,说明安装了错误的发行版,或不完整/异常。仅“32 位 Windows”发行版支持用于 NuGenesis 和此步骤
- 打开 services.msc 并配置 Tomcat 服务:
- 停止缺省的 Apache Tomcat 服务“Apache Tomcat 9”以及可能存在的任何其他旧版本
- 将旧版 Tomcat 服务的启动类型设置为“已禁用”
- 启动最新的 Tomcat 服务,并将其启动类型设置为“自动”
- 卸载旧版 Tomcat 服务(可选);有关说明,请参阅“附加信息”部分
附加信息
兼容性
NuGenesis 8 与 Apache Tomcat 9.x 或 10.x 不兼容,因为这些版本的 Tomcat 至少需要 Java 8。
NuGenesis 9 与 Apache Tomcat 10.x 不兼容,因为基类现在是“jakarta.*”而不是“java.*”,这意味着 Tomcat 无法启动 NuGenesis servlet。
卸载旧版 Tomcat 服务
- 打开 services.msc,双击弃用的 Tomcat 服务,并记录服务名称;根据上述安装步骤,密码可能是“Tomcat9”或“tomcatXYZZ”
- 使用管理员权限打开“命令提示符”窗口。
- 将目录更改为弃用 Tomcat 安装的 \bin 文件夹。示例:驱动器:\Program Files (x86)\Waters\apcahe-tomcat-9.0.8\bin
- 运行以下命令,替换为步骤 1 中记录的服务名称:
- service.bat uninstall serviceName
- 成功完成此命令后,命令提示符窗口中将出现消息:The service 'serviceName' has been removed(服务“serviceName”已被删除),该服务将从 services.msc 中消失
配置
缺省情况下,Tomcat 配置工具 tomcat9w.exe 不会配置通过上述步骤安装的新版 Tomcat 服务。双击该工具将显示一条消息:The specified service does not exist as an installed service. Unable to open the service 'tomcat9'(指定的服务不作为已安装的服务存在。无法打开服务“tomcat9”)。要针对新的 Tomcat 服务使用配置工具:
- 使用管理员权限打开命令提示符窗口
- 更改为 tomcat 安装目录(缺省:驱动器:\Program Files (x86)\Waters\apache-tomcat-9.0.X\bin)
- 输入命令,其中“tomcatXYZZ”与升级过程步骤 7 中使用的服务名称相同:
- tomcat9w.exe //ES//tomcatXYZZ
- Tomcat9w 将运行并显示新版 Tomcat 服务的配置
升级后
更新 Tomcat 版本时,运行 Application Server IQ 时可能会遇到 4 个失败文件。 请勿从文件夹中删除旧版本 Tomcat 的文件及其结构。如果删除这些文件,您会发现这 4 个文件丢失了,尽管它们不会影响应用程序的使用。
- 驱动器\Program Files (x86)\Waters\apache-tomcat-oldversion\webapps\WebVision\ngv_common.js
- 驱动器\Program Files (x86)\Waters\apache-tomcat-oldversion\webapps\WebVision\WEB-INF\lib\NGWebVision.jar
- 驱动器\Program Files (x86)\Waters\apache-tomcat-oldversion\webapps\NGAudit\web-inf\lib\NGAudit.jar
- 驱动器\Program Files (x86)\Waters\apache-tomcat-oldversion\webapps\WebVision\web-inf\lib\ojdbc14.jar
id111885, SDMS, SDMS8, SDMS8NU, SUPISDMS, SUPNG, upgrade