TongWeb 在不少单位的软件清单里属于必备件尤其是近两年做系统迁移和中间件国产化替换的项目几乎绕不开它。这次我拿到的是 TongWeb 7.0.4.9 企业版操作系统是 Linux 服务器。很多刚接触这套环境的同事第一反应是“这不就是个 tomcat 吗”其实这么想没问题但它和 Tomcat 的差别也不小有独立的管理控制台、有 License 授权机制、部署规范也更贴近商业中间件的套路。这篇文章就把我从解压安装到成功登录管理界面、部署出第一个应用的全过程记录下来涉及的坑和判断依据都会写清楚适合刚接手 TongWeb 运维和部署任务的 Java 工程师、运维人员参考。1. 安装前的准备先搞清楚装在哪、用什么版本跑1.1 操作系统和 JDK 版本怎么选TongWeb 7 是基于 Java EE 7 规范实现的应用服务器这一点决定了它对 JDK 版本有硬性要求。我在实际项目里用的 Linux 内核是 3.10 以上发行版是常见的 CentOS 7.9 和 Ubuntu 20.04 都跑过TongWeb 7.0.4.9 兼容性没什么问题。最关键的其实是 JDK 版本官方要求是 JDK 1.8这一点务必遵守。为什么强调 JDK 8因为 TongWeb 7 在开发时主要针对 JDK 8 做了适配和验证用 JDK 11 或者更高版本去启动经常会出现类加载异常、UnsupportedClassVersionError 这类怪问题到时候排查起来很浪费时间。所以我的一贯做法是确认系统里安装的是 64 位的 JDK 8能用官方推荐的 8u191 之后的小版本更稳妥小版本太老会遇到一些安全相关的兼容问题。确认命令很简单java -version echo $JAVA_HOME如果 JAVA_HOME 是空的或者 java 命令不在 PATH 里后面启动 TongWeb 大概率要报错。建议把 JDK 路径配到 /etc/profile 里内容大致是这样export JAVA_HOME/usr/java/jdk1.8.0_201 export PATH$JAVA_HOME/bin:$PATH export CLASSPATH.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar改完先 source /etc/profile 让它生效再用 java -version 验证。很多安装失败的案例问题根源都在这一步别偷懒跳过。1.2 安装包和 License 授权文件要提前拿到手TongWeb 7.0.4.9 企业版不像开源软件那样在公开仓库里随便拉一个包就能用商业版产品一般由厂商或者项目渠道方提供安装介质。正常流程是找中间件管理员或厂商对接人获取 Linux 版本的安装压缩包以及配套的企业版 License 授权文件。我这里拿到的压缩包名称大致是 TongWeb-7.0.4.9-linux-x86_64.tar.gz 这类格式授权文件是 license.dat 或者类似命名的文件。这里说一个我自己踩过的坑刚开始接触时以为安装完就能直接进入管理界面结果启动成功后控制台页面打开提示产品未授权很多功能用不了。所以 License 文件一定要提前拿到别等到装完再临时找厂商要那会白白耽误半天。另外License 通常和服务器硬件信息或 IP 绑定最好在目标服务器上申请授权临时拿测试机的授权顶上去大概率会校验失败。1.3 安装目录规划和端口占用检查安装目录我一般放在 /opt 下面专门建一个 tongweb 目录统一管理比如 /opt/tongweb/TongWeb-7.0.4.9。不建议直接放 /root 或 /home一是路径太深不便于维护脚本引用二是权限控制容易出问题生产规范里也更倾向于统一的软件安装目录。这里顺便统计一下我在项目中用到的关键目录目录用途bin启动、停止脚本核心的 start/stop 文件都在这里conf服务器配置文件比如 server.xml、vms.propertiesdeploy应用部署目录手工投放 war 包或静态资源也可以放这里logs运行日志、访问日志、控制台操作日志license授权文件放置目录lib依赖库和容器运行所需的 jar 包TongWeb 默认的 HTTP 端口是 8080管理控制台端口是 9060。安装之前先用命令检查一下这两个端口是否被占用netstat -anp | grep -E 8080|9060 ss -anp | grep 8080如果有进程占用了这些端口要么先把旧进程处理掉要么等安装完去 conf/server.xml 里改端口。提前检查比启动失败后再排查要省事得多。很多 Tomcat 迁移场景里服务器上同时跑着其他 Web 服务8080 被占的概率非常高我在正式环境里遇到过一次就是从 netstat 这一步发现是虚拟机监控服务占用了端口。2. 正式安装与首次启动2.1 上传、解压和目录权限处理拿到安装包之后先上传到服务器。上传方式看个人习惯我用过 scp也用过图形化工具效果一样。物理机上如果带宽可以直接用scp TongWeb-7.0.4.9-linux-x86_64.tar.gz root服务器IP:/opt/tongweb/如果现场不方便用 scp用 rz 这类终端上传工具也可以。上传完成后进入目录解压cd /opt/tongweb tar -zxvf TongWeb-7.0.4.9-linux-x86_64.tar.gz ls -l解压后会多出一个 TongWeb-7.0.4.9 的目录这就是产品主目录。我习惯紧接着建一个软链接方便脚本引用和后续升级替换ln -s /opt/tongweb/TongWeb-7.0.4.9 /opt/tongweb/current然后处理目录权限。如果后续用 root 启动问题不大但如果是分配给专用账号运行建议把目录属主改成账号并保证 bin 目录下脚本有执行权限。之前遇到过解压后某些脚本只有 644 权限启动时报 Permission denied加权限即可chmod x /opt/tongweb/current/bin/*.sh chmod -R 755 /opt/tongweb/TongWeb-7.0.4.92.2 修改启动脚本里的 JDK 路径TongWeb 启动时会从系统的 PATH 和 JAVA_HOME 环境变量里找 Java所以前面配置了全局 JDK 环境理论上已经够了。但生产环境里服务器可能有多个 JDK 版本为了防止启动脚本找错我习惯在 TongWeb 的 bin 目录里直接写死 JAVA_HOME。不同小版本的 TongWeb 脚本组织方式略有差异7.0.4.9 这个版本里我实际是在 bin 目录下的 setEnv.sh有的版本是 vms-setEnv.sh 或者直接在 startserver.sh 顶部里找到 JAVA_HOME 设置项改成JAVA_HOME/usr/java/jdk1.8.0_201 export JAVA_HOME这样写的好处是不管 /etc/profile 里配了什么TongWeb 启停脚本都强制使用我们指定的 JDK排除环境混淆造成的启动失败。上面这里路径要按照实际 JDK 安装路径填写不要照抄。拿不准 JDK 在哪可以用which java readlink -f $(which java)一层层找到真实的 JDK home 目录。2.3 首次启动与启动日志检查启动命令在 bin 目录下cd /opt/tongweb/current/bin ./startserver.sh正常的启动过程会看到脚本打印一些输出后台进程起来后先别急着看管理界面第一步是确认进程是否存在ps -ef | grep TongWeb jps -ljps 是 JDK 自带的进程查看工具如果能列出包含 TongWeb 的进程说明 Java 进程起来了。再查端口netstat -anp | grep -E 8080|9060如果 8080 和 9060 都在 LISTEN 状态说明启动是基本成功的。不过最可靠的判断依据还是启动日志。进入 logs 目录查看 server.logcd logs tail -n 50 server.logTongWeb 启动完成的标志一般是类似 Server startup in 数字 ms 的信息或者 Deploy all applications finished 这样的提示。如果日志里出现异常堆栈或者加载失败的描述需要继续往下排查。这里想提醒一句TongWeb 启动比 Tomcat 要慢一些尤其是首次启动类加载和资源扫描比较多有时候要等 30 到 60 秒。我见过有同事敲完启动命令后马上看 8080 端口没看到监听就以为失败了其实再等一会儿就好了。建议用下面这条命令动态观察日志tail -f server.log看到 “server startup” 字样的日志后再进入下一步。2.4 没有 License 的时候会怎样如果你是带着授权文件来安装的这一步可以先跳过。但没有 License 的情况下启动控制台登录后会发现提示授权过期或未激活并且很多管理功能受限比如部署按钮置灰、不能新增数据源等。我遇到过有朋友跳过激活直接部署 war能访问但控制台里一直有红色告警提示系统资源监控等模块也用不了。所以建议把 License 激活放在管理控制台登录之后立即处理后面第三部分细说。这里提前说明是避免大家以为启动成功就万事大吉。3. 管理控制台登录与 License 激活3.1 控制台访问地址和初始账号TongWeb 7 的管理控制台是一个独立的 Web 应用默认通过 9060 端口访问。访问地址通常是http://服务器IP:9060/console/注意是 https 还是 http 要看你实际启动日志里的提示默认一般是 http除非安全策略要求改成 https那就要在配置里单独开启 TLS/SSL。浏览器打开这个地址后会跳转到登录页面。登录账号密码这里有个比较容易误解的地方。网上能搜到一些旧版本 TongWeb 控制台账号是 thanos/thanos123.com 之类的说明但 7.0.4.9 企业版不同企业定制包的默认初始化密码可能不一样而且出于安全考虑很多出厂包会在首次登录时要求强制修改密码。稳妥的判断方式有两个一是查看随安装包一起提供的产品说明文档安装介质文件夹里一般有个“环境默认账号密码.txt”或者 product.doc 之类的文件二是直接看 conf 目录里是否有关于认证用户的描述。我个人在项目里遇到的 7.0.4.9 版本常见默认组合是 thanos/thanos123.com但不排除有的项目方已经在交付前改过密码最好跟项目负责人确认不要随便猜猜错几次可能触发锁定策略。3.2 登录后的 License 激活流程进入控制台后找左侧菜单或顶部的“系统管理”相关区域一般会有“License 管理”或“许可管理”入口。点击进入后可以看到当前授权状态如果显示“未授权”或“过期”就进入激活操作界面。TongWeb 7 企业版激活通常有两种方式在线激活通过控制台上传 License 文件。选择本地已准备好的 license.dat 或 .lic 文件点击上传并激活系统会校验文件的正确性和与服务器的绑定关系校验通过后显示授权有效期、版本信息等。离线激活如果服务器没有外网或者浏览器访问受限可以根据控制台生成的机器码把机器码发给厂商让厂商生成对应 License 文件再上传激活。我用得比较多的是第一种直接在“License 管理”页面上传文件效率高。激活成功后控制台会刷新授权状态显示企业版和有效期。有些版本的 License 不是通过控制台上传而是要求把 license 文件放到安装目录的 license 目录下然后重启 TongWeb 生效。我建议两种都试一下优先看文档我试用过的 7.0.4.9 版本控制台是支持页面上传省去重启的。激活之后别忘记改密码。这也是一个生产环境的老生常谈默认密码持续挂一个月等出了安全扫描通报再来补救就很被动了。控制台的用户管理菜单里可以直接修改管理员密码顺手把超时时间、密码复杂度策略也调一下。3.3 控制台访问常见的三个登录问题第一页面打不开。先检查 9060 端口是否监听再检查服务器防火墙是否放行。如果用云主机安全组里是否放开了入方向 TCP 9060 也要确认。我在本地测试机上习惯直接关掉 firewalld 省事正式环境就只放行必要端口firewall-cmd --add-port9060/tcp --permanent firewall-cmd --reload第二登录页能打开但登录后一片空白或报错。这类问题多半是浏览器兼容性TongWeb 的管理控制台对老版内核的支持不算特别好Chrome、Edge 一般正常个别极老浏览器有兼容问题。可以换浏览器或开启兼容模式再试。第三连续输错密码被锁定。商业中间件普遍有账户锁定保护锁了之后一般等几分钟会自动解或者需要重启服务来恢复。与其硬试不如去确认账号资料。4. 部署第一个 Web 应用到 TongWeb4.1 应用包准备war 包还是目录形式TongWeb 部署应用最常用的是 war 包它和管理控制台的部署功能衔接最顺。如果你的项目是个纯 HTML 静态页面在热搜词里也有人搜到“tongweb部署html项目”TongWeb 是支持这种场景的但要注意静态资源也得做好目录结构。最简单的办法是把 html、css、js、图片等文件整理成标准 Web 应用目录一级目录下放一个 WEB-INF/web.xml即使内容很精简也要有再打包成 war。不要一上来就把纯 HTML 丢进去那样 TongWeb 不一定能正确识别虚拟主机和上下文。打包时注意编码问题。Windows 上打包然后上传到 Linux 服务器时war 包里的文件名编码容易出乱码尤其是中文文件名的资源。建议在打包工具里统一 UTF-8 编码文件命名尽量用英文能避免很多诡异问题。热搜词里也出现了“linux 解压文件乱码”这种查询这就是打包和服务器字符集不一致导致的典型场景。4.2 通过控制台部署 war 包进入控制台后找到“应用管理”或“部署管理”菜单点击“部署”或“安装应用”。操作流程大致是选择本地的 war 包文件填写应用名称比如 pm-web这个名称会作为访问路径的一部分设置上下文路径也就是访问 URL 里的项目名比如填 /pm访问地址就是 http://IP:8080/pm/选择部署目标和虚拟主机一般默认即可提交部署请求。部署过程中控制台会显示进度完成后可以看到应用状态变为“已启动”或“running”。如果状态变成“启动失败”就需要去 logs 目录下查应用相关的日志一般会有具体异常信息。部署完成后直接在浏览器里访问http://IP:8080/pm/ 能正常打开说明应用已经跑通了。这里特别提一下上下文路径不写默认是按 war 包名访问比如 pm-web.war 打上去后路径就是 /pm-web习惯上最好显式设置成带语义的路径避免维护时理不清。4.3 手工部署方式和热部署提示有的环境因为安全策略限制不允许通过控制台上传文件那就用手工方式。把 war 包直接放到 deploy 目录比如cp pm-web.war /opt/tongweb/current/deploy/TongWeb 默认会扫描 deploy 目录下新增的 war 包并自动部署。如果没有自动触发可以重启 TongWebcd /opt/tongweb/current/bin ./startserver.sh手工部署的时候用一个细节可以判断产品是否真的加载了应用查看 logs 目录下会生成与部署应用同名的日志文件比如 pm-web.log里面有应用初始化、Spring 容器启动等信息。热部署在 TongWeb 里是可以用的但我个人建议测试环境玩玩可以生产环境最好别用。商业中间件在某些版本下热部署会引发 PermGen/Metaspace 内存泄漏或者线程残留部署新版本时旧版本没有彻底卸载后续就会出各种偶发问题。所以我的经验法则很简单生产环境换包挑业务低峰期停应用、替换 war、清空旧的应用缓存目录、再启动这套流程最稳妥。4.4 如何确认应用是否部署成功判断应用部署成功的标准不能只看控制台要以实际访问和日志为准。我个人习惯按三件事核对控制台应用列表里状态是“已启动”logs 里应用启动完成日志没有异常堆栈本地浏览器或 curl 命令访问后返回正常 HTTP 状态码curl -I http://127.0.0.1:8080/pm/返回 200 基本就说明通了。如果返回 404多半是上下文路径不对返回 500 就要继续看应用日志里的异常基本是代码运行时才暴露的问题。5. 常见问题排查与配置优化5.1 启动失败端口被占用怎么处理TongWeb 8080 端口被占用而导致启动失败是最常见的问题。启动日志里会出现类似 Address already in use: JVM_Bind 的异常。排查思路很简单netstat -anp | grep 8080查看占用端口的 PID再反查对应的进程。如果这个进程不能停那么只能改 TongWeb 的端口。修改位置在 conf/server.xml找到 HTTP Connector 配置把 port 从 8080 改成 8081同时 9060 管理端口如果冲突也可以一起调。改完重启 TongWeb。不过要留意端口改了之后已经部署的应用访问地址也会变化如果前面有 Nginx 在反代要及时更新 upstream 的端口配置。5.2 JDK 版本不兼容导致的启动异常启动脚本里没指定 JDK导致系统里默认的 Java 是 JDK 11 甚至更高版本启动时会看到诸如 Unsupported major.minor version 52.0、ClassNotFoundException 等报错。这个问题的根因是 TongWeb 7 的类库和模块是基于 JDK 8 编译验证的高版本 JDK 的模块化体系对部分老库兼容性不足。解决办法就是回到 2.2 那一步在 setEnv.sh 或启动脚本里明确指定 JDK 8 的路径。修改完后最好先确认当前 shell 环境里 Java 已经指向 JDK 8避免脚本看不到正确的路径source /etc/profile java -version5.3 JVM 内存参数调整企业版的业务系统一般部署着好几个应用默认 JVM 参数可能只给了很保守的堆内存运行一段时间后就频繁 Full GC 或直接 OOM。TongWeb 7 的 JVM 参数一般在 conf/vms.properties 里配置或者启动脚本 setEnv.sh 里通过 JAVA_OPTS 指定。以常见配置为例我一般会在 setEnv.sh 或 vms.properties 中设置JAVA_OPTS-Xms2048m -Xmx2048m -XX:MaxMetaspaceSize512m -XX:UseG1GC如果服务器内存充足比如 16G我会把 -Xms 和 -Xmx 调到 4G。这里有个细节-Xms 和 -Xmx 建议设成一样大小避免运行时堆动态扩容引发性能抖动。同样的-XX:MaxMetaspaceSize 也建议显式设置JDK 8 默认的元空间上限不够时应用会越来越频繁触发 Full GC。修改完成后重启 TongWeb继续用jstat -gcutil pid 1000可以实时观察堆内存使用和 GC 情况以此验证参数设置是否合理。5.4 防火墙、SELinux 和外部访问限制外部浏览器访问不了管理控制台和应用页面除了端口监听问题最常见的是防火墙没放行。CentOS 7 上的 firewalld 在前面已经提过放行命令再补充完整一点firewall-cmd --permanent --add-port8080/tcp firewall-cmd --permanent --add-port9060/tcp firewall-cmd --reload对于 Ubuntu 系列使用的是 ufwufw allow 8080/tcp ufw allow 9060/tcp ufw reloadSELinux 如果是 enforcing 模式也可能会拦截 TongWeb 的非标准端口监听。在一些老旧项目服务器上为了快速排除问题我见过直接把 SELinux 改成 permissive 的做法但从合规角度看更推荐用正确的安全上下文配置而不是一关了之。测试环境里为了效率可以临时 setenforce 0正式环境不要这么干。5.5 用 systemd 管理 TongWeb 进程TongWeb 自带的 startserver.sh 启动后进程是 shell 的子进程如果终端关了或者服务器重启了服务就没了。为了让服务更规范地运行、支持开机自启我在生产环境里一般配置 systemd 管理。以 root 身份创建服务文件 /etc/systemd/system/tongweb.service内容如下[Unit] DescriptionTongWeb Application Server Afternetwork.target [Service] Typeforking EnvironmentJAVA_HOME/usr/java/jdk1.8.0_201 ExecStart/opt/tongweb/current/bin/startserver.sh ExecStop/opt/tongweb/current/bin/stopserver.sh Userroot Restarton-failure [Install] WantedBymulti-user.target然后执行systemctl daemon-reload systemctl enable tongweb systemctl start tongweb systemctl status tongweb这样每次服务器重启TongWeb 都会自动拉起来对生产环境是刚需。需要注意如果启停脚本要求交互输入Type 需要改成 oneshot 或者 extra不过实际项目里我用的版本都是后台启动型用 forking 没问题。5.6 其他值得注意的问题日志文件膨胀。如果业务流量大logs 目录下的 server.log 和访问日志会快速增长建议在 conf 里配置日志分割策略或者写定时任务按天归档。操作系统中磁盘空间不足会导致服务挂掉这个坑我很早之前踩过一次自此以后在服务器上隔一段时间就会跑一下 df -h 查磁盘。部署目录里存在残留的旧版本文件。每次替换 war 包时TongWeb 会在工作目录里解压并缓存应用旧文件如果没有清干净容易出现改了代码但页面没变化的“灵异事件”。解决办法是把应用停掉后找到 working 目录或者和 war 同名的临时解压目录整个删掉再启动。6. 个人体会把安装验证做成一套固定动作流程走完一遍之后我自己的习惯是总结成检查清单换一台机器重新装的时候照着走效率提升最明显。比如安装前确认 JDK 8 和端口安装中确认脚本里 JAVA_HOME 写死启动后依次检查进程、端口、日志登录控制台后第一时间激活 License 和改密码部署应用后再用 curl 做健康检查。这一串动作固定下来基本不会出现装完发现访问不通又重新折腾的情况。再分享一个细节在正式交付运维之前我会把安装目录、JAVA_HOME 路径、端口配置、License 文件位置、启动方式这五项信息集中记录在一个维护文档里。等后面交接或排障时一个文档就能解决大部分疑问。这个习惯在长时间运维 TongWeb 的过程中帮我省了很多事而且团队里的其他同事接手时也不用从零摸索。这次基于 Linux 环境安装 TongWeb 7.0.4.9 企业版的过程从准备环境到激活授权再到部署应用每一环都有一些不起眼但很坑人的细节。希望上面这些记录能给正在做同样事情的朋友实实在在的帮助。