TongWeb 嵌入式容器替换

本文介绍如何将河图安装包中的默认 Tomcat 运行容器替换为 TongWeb 嵌入式容器。

准备工作

请提前准备以下文件：

• 河图安装包。
• TongWeb 嵌入式容器安装介质：tongweb-embed-7.0.E.8_P2.zip。
• TongWeb 授权文件：license.dat。

注意

操作前建议备份河图安装目录，尤其是 bin、config 和 lib 目录。替换过程中请保持文件版本一致，避免混用其他版本的 TongWeb 组件。

操作步骤

步骤一：解压河图安装包

将河图安装包解压到目标安装目录，后续示例以 hetu 作为河图安装目录。

unzip -d hetu hetu-版本号.zip

步骤二：删除 Tomcat 相关依赖

进入河图安装目录下的 lib 目录，删除以下文件：

spring-boot-starter-tomcat-3.5.9.jar
tomcat-embed-core-10.1.50.jar
tomcat-embed-websocket-10.1.50.jar
tomcat-embed-el-10.1.50.jar

提示

如果实际安装包中的文件版本号与上方示例不一致，请以安装包 lib 目录中的 Tomcat 相关依赖为准。

步骤三：解压 TongWeb 嵌入式容器安装介质

找到安装介质中的 tongweb-embed-7.0.E.8_P2.zip，解压到临时目录。

unzip -d tongweb-embed tongweb-embed-7.0.E.8_P2.zip

步骤四：复制 TongWeb 相关依赖

进入 TongWeb 解压目录下的 lib 目录，将以下文件复制到河图安装目录的 lib 目录中：

tongweb-embed-core-3.x-7.0.E.8_P2.jar
tongweb-embed-el-3.x-7.0.E.8_P2.jar
tongweb-spring-boot-starter-3.x-7.0.E.8_P2.jar
tongweb-lic-sdk-4.5.1.10.jar
tongweb-embed-websocket-3.x-7.0.E.8_P2.jar
tongweb-spring-boot-websocket-3.x-7.0.E.8_P2.jar

步骤五：复制授权文件

将 license.dat 复制到河图安装目录下的 config 目录。

hetu/
├── config/
│   └── license.dat
└── lib/

步骤六：修改启动脚本

根据操作系统修改河图启动脚本，在 Java 启动参数中增加 TongWeb 授权配置：

-Dserver.tongweb.license.type=file
-Dserver.tongweb.license.path=config/license.dat

Windows

修改 bin/start.bat。

修改前：

java %JAVA_OPTS% -Dfile.encoding=UTF-8 -jar -Dloader.path=.,ext,config bin/%SERVER_NAME%.jar --spring.profiles.active=prod

修改后：

java %JAVA_OPTS% -Dserver.tongweb.license.type=file -Dserver.tongweb.license.path=config/license.dat -Dfile.encoding=UTF-8 -jar -Dloader.path=.,ext,config bin/%SERVER_NAME%.jar --spring.profiles.active=prod

Linux/macOS

修改 bin/start.sh。

修改前：

nohup java ${JAVA_OPTS} -jar -Dloader.path=.,ext,config ${DEPLOY_DIR}/bin/${SERVER_NAME}.jar --spring.profiles.active=prod >>${STDOUT_FILE}  2>&1 &

修改后：

nohup java ${JAVA_OPTS} -jar -Dserver.tongweb.license.type=file -Dserver.tongweb.license.path=config/license.dat -Dloader.path=.,ext,config ${DEPLOY_DIR}/bin/${SERVER_NAME}.jar --spring.profiles.active=prod >>${STDOUT_FILE}  2>&1 &

启动验证

完成替换后，启动河图服务并查看启动日志。

• Linux/macOS：查看 logs/hetu_console.log。
• Windows：查看启动命令行窗口输出。

出现以下提示表示服务启动成功：

HeTu start success

如启动失败，请优先检查 license.dat 是否已复制到 config 目录、启动脚本中的授权路径是否正确，以及 lib 目录中 Tomcat 依赖是否已删除、TongWeb 依赖是否已完整复制。