跳转到主内容
Waters员工入口

Knowledge Base Home

Waters China

如何升级用于 NuGenesis SDMS 的 Apache Tomcat 版本 - WKB111885

  1. 最后更新
  2. 另存为PDF
文章编号: 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

步骤

  1. 从 https://tomcat.apache.org 下载 Apache Tomcat 的最新版“32 位 Windows zip”发行版
  2. 将文件解压到各自的文件夹中；例如，对于 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 文件夹结构
  3. 在“记事本”中编辑以下 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
  4. 将以下行添加到 server.xml 的末尾，添加到 "</Host>" 行的上方：
    • <Context path="/ngaudit/servlet" docBase="NGAudit" reloadable="true" cookies="true" useHttpOnly="false"/>
    • <Context path="/servlet" docBase="WebVision" reloadable="true" />
  5. 保存并关闭 server.xml
  6. 将 NuGenesis Web 应用程序复制到新的 Tomcat 文件夹：
    • NuGenesis 8：
      1. 将文件夹驱动器:\Program Files (x86)\apache-tomcat-6.0.29\webapps\NGAudit to Drive:\Program Files (x86)\apache-tomcat-X.Y.ZZ\webapps
      2. 将文件夹驱动器:\Program Files (x86)\apache-tomcat-6.0.29\webapps\WebVision to Drive:\Program Files (x86)\apache-tomcat-X.Y.ZZ\webapps
    • NuGenesis 9：
      1. 将文件夹驱动器:\Program Files (x86)\Waters\apache-tomcat-9.0.8\webapps\NGAudit 复制到驱动器:\Program Files (x86)\Waters\apache-tomcat-X.Y.ZZ\webapps
      2. 将文件夹驱动器:\Program Files (x86)\Waters\apache-tomcat-9.0.8\webapps\WebVision 复制到驱动器:\Program Files (x86)\Waters\apache-tomcat-X.Y.ZZ\webapps
  7. 创建新服务。使用管理员权限在 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 和此步骤
  8. 打开 services.msc 并配置 Tomcat 服务：
    1. 停止缺省的 Apache Tomcat 服务“Apache Tomcat 9”以及可能存在的任何其他旧版本
    2. 将旧版 Tomcat 服务的启动类型设置为“已禁用”
    3. 启动最新的 Tomcat 服务，并将其启动类型设置为“自动”
  9. 卸载旧版 Tomcat 服务（可选）；有关说明，请参阅“附加信息”部分

附加信息

兼容性

NuGenesis 8 与 Apache Tomcat 9.x 或 10.x 不兼容，因为这些版本的 Tomcat 至少需要 Java 8。

NuGenesis 9 与 Apache Tomcat 10.x 不兼容，因为基类现在是“jakarta.*”而不是“java.*”，这意味着 Tomcat 无法启动 NuGenesis servlet。

另请参阅：如何升级 NuGenesis 9 SDMS 的 Java Runtime Environment

卸载旧版 Tomcat 服务

  1. 打开 services.msc，双击弃用的 Tomcat 服务，并记录服务名称；根据上述安装步骤，密码可能是“Tomcat9”或“tomcatXYZZ”
  2. 使用管理员权限打开“命令提示符”窗口。
  3. 将目录更改为弃用 Tomcat 安装的 \bin 文件夹。示例：驱动器:\Program Files (x86)\Waters\apcahe-tomcat-9.0.8\bin
  4. 运行以下命令，替换为步骤 1 中记录的服务名称：
    • service.bat uninstall serviceName
  5. 成功完成此命令后，命令提示符窗口中将出现消息：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 服务使用配置工具：

  1. 使用管理员权限打开命令提示符窗口
  2. 更改为 tomcat 安装目录（缺省：驱动器:\Program Files (x86)\Waters\apache-tomcat-9.0.X\bin）
  3. 输入命令，其中“tomcatXYZZ”与升级过程步骤 7 中使用的服务名称相同：
    • tomcat9w.exe //ES//tomcatXYZZ
  4. Tomcat9w 将运行并显示新版 Tomcat 服务的配置

升级后

更新 Tomcat 版本时，运行 Application Server IQ 时可能会遇到 4 个失败文件。

1 - 请勿从文件夹中删除旧版本 Tomcat 的文件及其结构。
2 - 如果删除这些文件，您会发现这 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