作者:ShunWah
在运维管理领域,我拥有多年深厚的专业积累,兼具坚实的理论基础与广泛的实践经验。精通运维自动化流程,对于OceanBase、MySQL等多种数据库的部署与运维,具备从初始部署到后期维护的全链条管理能力。拥有OceanBase的OBCA和OBCP认证、OpenGauss社区认证结业证书,以及崖山DBCA、亚信AntDBCA、翰高HDCA、GBase 8a | 8c | 8s、Galaxybase的GBCA、Neo4j的Graph Data Science Certification、NebulaGraph的NGCI & NGCP、东方通TongTech TCPE等多项权威认证。
在OceanBase & 墨天轮的技术征文大赛中,多次荣获一、二、三等奖。同时,在OpenGauss第五届、第六届、第七届技术征文大赛,TiDB社区专栏征文大赛,金仓数据库有奖征文活动,以及YashanDB「产品体验官」征文等活动中,我也屡获殊荣。此外,我还活跃于墨天轮、CSDN等技术平台,经常发布原创技术文章,并多次被首页推荐。
前言
随着信息技术的快速发展,中间件作为连接应用与底层系统的桥梁,其重要性日益凸显。东方通TongWeb中间件,作为业界领先的产品之一,凭借其高性能、高可靠性和易用性,赢得了广泛的认可。本指南旨在为初学者从TongWeb中间件的基本概念、产品特性、应用场景以及实践探索等方面提供一套完整的TongWeb中间件入门部署流程,帮助您快速上手并高效利用这一强大工具。同时,我们鼓励您参加东方通初级认证培训,以获得更深入的理解和实践能力。
一、中间件的定义和作用
《 GB/T 33847-2017 信息技术 中间件术语 》—位于系统软件之上,用于支持分布式应用软件,连接不同软件实体的支撑软件。
中间件是位于操作系统之上,为应用软件提供支撑作用的基础软件。中间件用于屏蔽底层系统差异,提供数据传输、应用调度等共性服务,并保障系统的安全性、高效性、高可用性等。
l 中间件属于一类技术组件,通常按照部署在服务器端,不直接面向最终用户
l 中间件 与 操作系统、数据库 并称为基础软件三驾马车
l 提升系统的性能和效率:通过缓存、负载均衡、消息队列等技术手段,中间件能够优化数据的传输和处理流程,减少不必要的计算和通信开销。
l 提升系统的可扩展性、可维护性:中间件提供标准的接口和协议,使得这些模块或服务能够解耦。提供完善的管理监控和故障处理机制。
l 降低系统建设成本:中间件能够被多个系统共享和复用:基于应用系统共用的功能和逻辑进行封装,遵循通用的标准和规范。
l 提高系统的安全保障能力:对于信息安全的保障能力是中间件产品的重要评测指标,中间件提供身份验证、权限控制、数据加密、可信计算、行为审计等安全措施,防止未经授权的访问和恶意攻击。
1、中间件管理平台TongMMP 产品典型应用场景示意- - 空间维度
2、应用服务器中间件 TongWeb — 产品版本
3、TongWeb中间件简介
TongWeb V7.0 是东方通推出的一款全面符合Java EE、Jakarta EE最新标准规范的应用服务器产品。它支持多种部署场景,包括云环境、虚拟化环境以及传统物理环境,为开发者提供了灵活多样的应用部署选择。TongWeb不仅具备丰富的管理功能,还支持多种企业级服务,如负载均衡、故障转移、安全认证等,确保应用的高可用性和安全性。本指南将带领您从入门到实战,全面了解TongWeb V7.0的安装、配置及基本使用。
4、TongWeb中间件的产品特性
负载均衡:TongWeb支持万级并发接入,能够有效分散系统压力,提高系统的稳定性和响应速度。
服务总线:基于SOA架构,TongWeb提供了易用、易管的服务集成框架,能够轻松实现政务、电信、企业等领域的应用系统集成。
数据集成:TongWeb支持多种数据集成工具,能够实现全行业的数据替换和整合,打破数据孤岛,提升数据价值。
文件传输:TongGTP/WTP作为可管理的文件传输平台,在金融领域市占率遥遥领先,为企业提供了高效、安全的文件传输解决方案。
5、TongWeb中间件的应用场景
TongWeb中间件凭借其强大的功能和广泛的应用领域,已经成功应用于众多行业。例如,在政府领域,TongWeb可以支持政务系统的集成和整合,提高政府服务效率;在电信领域,TongWeb可以支持电信业务系统的快速部署和管理;在企业领域,TongWeb可以为企业提供高效、稳定的应用运行环境,助力企业数字化转型。
二、TongWeb中间件环境准备
安装TongWeb前需要先安装JDK环境以及配置环境变量。
1. 在Java官网上下载JDK安装文件。
https://jdk.java.net/jextract/
2. 安装成功后,配置 JDK环境变量,使之生效。
普通用户环境变量:
[mashunhua@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]$ echo $JAVA_HOME
/opt/jdk
[mashunhua@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]$ echo $PATH
/root/.tiup/bin:/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/opt/jdk/bin:/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.412.b08-1.el7_9.x86_64/bin:/root/bin:/opt/jdk/bin
[mashunhua@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]$ java -version
openjdk version "1.8.0_412"
OpenJDK Runtime Environment (build 1.8.0_412-b08)
OpenJDK 64-Bit Server VM (build 25.412-b08, mixed mode)
[mashunhua@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]$
3. 查看Java 版本
在root用户命令行界面,输入“java -version”。提示Java 版本,说明安装成功,如下图所示。
TongWeb的安装环境配置,安装前提条件,支持JDK的主流操作系统都可以安装。
[root@instance2 data]# java -version
openjdk version "1.8.0_412"
OpenJDK Runtime Environment (build 1.8.0_412-b08)
OpenJDK 64-Bit Server VM (build 25.412-b08, mixed mode)
[root@instance2 data]#
4. 修改该用户的openfiles值为65535。
完成后在该用户下执行ulimit -a查看结果
4.1 切换用户
open files参数主要涉及对进程可打开文件数量的限制和管理
[root@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]# su mashunhua
[mashunhua@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]$ vi /etc/security/limits.conf
[mashunhua@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]$
4.2 编辑 /etc/security/limits.conf 文件
mashunhua soft nofile 65535
mashunhua hard nofile 65535
4.3 查看 openfiles 结果
[mashunhua@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]$ ulimit -a
core file size (blocks, -c) unlimited
data seg size (kbytes, -d) unlimited
scheduling priority (-e) 0
file size (blocks, -f) unlimited
pending signals (-i) 128553
max locked memory (kbytes, -l) unlimited
max memory size (kbytes, -m) unlimited
open files (-n) 65535
pipe size (512 bytes, -p) 8
POSIX message queues (bytes, -q) 819200
real-time priority (-r) 0
stack size (kbytes, -s) 8192
cpu time (seconds, -t) unlimited
max user processes (-u) 4096
virtual memory (kbytes, -v) unlimited
file locks (-x) unlimited
[mashunhua@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]$
三、 安装TongWeb
绿色版为免安装版,解压后即可使用。
本章节以“在 Linux 平台上解压标准版 TongWeb7”为例进行说明。
1、获取标准版 TongWeb7 安装包
例如:TongWeb7.0.4.9_M5_Enterprise_Linux.tar.gz
2、上传 TongWeb 目录
2.1 以root用户登录Linux平台。
2.2 将TongWeb安装包上传到Linux平台,例如“/data/tongweb”目录。
[root@instance2 ~]# cd /data/
[root@instance2 data]# mkdir tongweb
[root@instance2 data]# cd tongweb/
[root@instance2 tongweb]#
3. 解压安装包
执行如下命令,解压安装包。解压完成即完成TongWeb的安装。
东方通应用服务器软件 TongWeb V7.0 快速使用手册
[root@instance2 tongweb]# ls
TongWeb7.0.4.9_M5_Enterprise_Linux TongWeb7.0.4.9_M5_Enterprise_Linux.tar.gz
[root@instance2 tongweb]# tar -zxvf TongWeb7.0.4.9_M5_Enterprise_Linux.tar.gz
4. 解压后,进入到安装目录
查看安装相关目录结构,如下图所示。
[root@instance2 tongweb]# ls
TongWeb7.0.4.9_M5_Enterprise_Linux TongWeb7.0.4.9_M5_Enterprise_Linux.tar.gz
[root@instance2 tongweb]# cd TongWeb7.0.4.9_M5_Enterprise_Linux/
[root@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]# ls
Agent autodeploy conf doc lib logs service TongDataGrid tools
applications bin deployment domain_template license_update samples temp tongweb-mq
[root@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]#
4.1 目录结构说明
表 2.6-1:TongWeb 目录结构
目录名称 说明
序号
目录结构
说明
1
Agent
代理服务器注册节点(仅企业版提供)
2
autodeploy
自动部署目录。
3
applications
系统应用所在目录。
4
bin
服务器启动,停止脚本目录。
5
conf
服务器的配置文件所在目录。
6
deployment
已部署应用的应用程序目录。
7
domain_template
域模板目录。
8
doc
手册压缩包存放目录。(快速上手的话推荐看下这里的快速使用手册)
9
TongDataGrid
TongDataGrid缓存所在目录。
10
lib
服务器类文件所在目录。(自带性能分析工具apm所在目录)
11
logs
服务器存放日志文件的目录。
12
samples
TongWeb的示例目录。
13
persistence
存放各类监视量的持久化文件。
14
snapshot
存放服务器生成的快照文件。
15
service
以系统服务方式运行TongWeb服务的工具存储目录。
16
temp
服务器产生的临时文件(应用清缓存从这清理)。
17
Tools
Eclipse、idea等IDE插件目录
5、安装 License
您需要安装 License 后,才能启动 TongWeb,可选择“本地授权”或者“服务授权”。
本地授权:通过提供的 license.dat 文件进行本地授权。
服务授权:通过 License Server 服务,进行服务授权。
5.1 此处展示方式一: 本地授权
下载解压 TongWeb 产品后,在 TongWeb7 目录中提供有临时学习license文件。将license.dat文件复制到安装完成
的TongWeb根目录下“/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux”。
[root@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]# ls
Agent bin doc lib logs persistence snapshot tongweb-mq
applications conf domains license.dat patch samples temp tongweb.pid
autodeploy deployment domain_template license_update patchManage service TongDataGrid tools
[root@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]# pwd
/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux
[root@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]#
5.2 查看License信息
登录管理控制台,在“首页”页面,即可查看License信息中“授权方式”为“本地授权”。
6、启动和停止
以在 Linux 下字符界面为例说明 TongWeb 的启动和停止过程:
[root@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]# cd bin/
[root@instance2 bin]# ls
boot.sh external.vmoptions startdomain.sh startserver.sh version.sh
commandstool.sh forcestopserver.sh startserverbg.sh stopdomain.sh
dft.sh installservice.sh startservernohup.sh stopserver.sh
domain.sh password.sh startserver-nohup-with-check.sh thread-profiler.sh
[root@instance2 bin]#
6.1 启动 TongWeb 需要进入 TongWeb 的 bin 目录,执行如下命令:
./startservernohup.sh
[root@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]# cd bin/
[root@instance2 bin]# ls
boot.sh external.vmoptions startdomain.sh startserver.sh version.sh
commandstool.sh forcestopserver.sh startserverbg.sh stopdomain.sh
dft.sh installservice.sh startservernohup.sh stopserver.sh
domain.sh password.sh startserver-nohup-with-check.sh thread-profiler.sh
[root@instance2 bin]# ./startservernohup.sh
[root@instance2 bin]#
注意:
这是后台启动方式,如果直接运行 startserver.sh,当 Telnet 断开后,会导致 TongWeb 进程退出。
6.2 查看启动日志
当日志中出现如下一行,没有异常信息,说明 TongWeb 启动成功。
[root@instance2 bin]# cd ../logs/
[root@instance2 logs]# ls
audit-log command-audit-log heimdall-audit-log jvm.log server.log startStopCommand-audit-log
[root@instance2 logs]# cat server.log
[2025-02-20 13:44:57 703] [SEVERE] [main] [core] [Instance not running.]
[2025-02-20 13:44:57 705] [INFO] [main] [core] [TongWeb server stopped successfully]
[2025-02-20 13:45:17 996] [WARNING] [main] [other] [this method encryptProductVersion has been deprecated, u can change to use LicenseSDKProvider encryptProductVersion]
[2025-02-20 13:45:18 358] [INFO] [main] [other] [
----------------License dat information------------------
Consumer_Name : 东方通
Project_Name : 生态初级认证培训
Product_Name : TongWeb
Edition : Enterprise
Version : 7.0
Create_Date : 2025-02-17
Expiry_Date : 2025-05-17
Max_Number : -1
License_Type : trial
[2025-02-20 13:45:38 062] [INFO] [main] [core] [TongWeb server startup complete in 19691 ms.]
6.3 ps查看正常启动
[root@instance2 bin]# ps -ef|grep tongweb
root 73053 1 0 13:45 pts/0 00:00:00 /bin/sh /data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/bin/startserver.sh
root 73205 73053 16 13:45 pts/0 00:00:59 /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.412.b08-1.el7_9.x86_64/bin/java -classpath /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.412.b08-1.el7_9.x86_64/lib/tools.jar:/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/lib/bootstrap.jar:/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/lib/jdk-api.jar:/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/lib/license-client.jar -Xms2048m -Xmx2048m -XX:CICompilerCount=6 -server -XX:+UnlockDiagnosticVMOptions -XX:+LogVMOutput -Djava.io.tmpdir=/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/temp -Duser.dir=/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/bin -Djava.security.egd=file:/dev/./urandom -XX:LogFile=/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/logs/jvm.log -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/logs/heap202502201345.hprof -Djava.security.policy=/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/conf/tongweb.policy -Djava.endorsed.dirs=/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/lib/endorsed -Djava.util.logging.manager=com.tongweb.log.TongwebLogManager -javaagent:/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/lib/ejb-agent.jar -Djava.awt.headless=true -Dibm.stream.nio=true -Djava.net.preferIPv4Stack=false -Dcom.tongweb.commons.logging.Log=com.tongweb.commons.logging.impl.Jdk14Logger -Dtongweb.restart.interval=1 -Dtongweb.java=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.412.b08-1.el7_9.x86_64 -Dtongweb.upload=/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/temp/upload -Dtongweb.app=/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/deployment -Dtongweb.sysapp=/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/applications -Dtongweb.base=/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux -Dtongweb.home=/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux -DcheckNonXADB=true -Dtongweb.jndi.lookup.relaxVersion=false -DWebserviceCXF.OFF=true -DgenSessionCookieNameForContext=console -DresLowversionLoad=false -DcompatibleWithWas=false -DTONGTECH_BC_JAR_PATH=/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/lib/bc/bcprov.jar -DWebModuleOnly=false -DShutdownSocketDisabled=false -Dstartup.secure=false -Dxss_defense=true -Dxss_apps=console,heimdall -DdisableVerCode=true -DdisableResourceCache=true -DLoadClassCache.Disabled=true -DuseBeanManagerInCompJNDI=false -DjvProfile=true -Dtongweb.X_Frame_Options=SAMEORIGIN -Denable_query_cache=false -Dcdi.passivate=false -Dpid_file_path=/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/tongweb.pid com.tongweb.web.thor.startup.ThorBootstrap start
root 82032 112084 0 13:51 pts/0 00:00:00 grep --color=auto tongweb
[root@instance2 bin]#
三、TonbWeb 域管理
TongWeb 域 逻辑服务器管理
1、TonbWeb 域管理
如果想在同一台主机上安装两套TongWeb,直接安装在两个不同的目录,端口会冲突,需要将
Tongweb 引入了域的概念,每创建一个域后,就会在
TonbWeb 安装完成后,就存在一个默认域(此时 domains 目录下无内容):
2、创建域:
[mashunhua@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]$ ls
Agent bin doc lib logs persistence snapshot tongweb-mq
applications conf domains license.dat patch samples temp tongweb.pid
autodeploy deployment domain_template license_update patchManage service TongDataGrid tools
[mashunhua@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]$ cd bin/
[mashunhua@instance2 bin]$ ./domain.sh create domain1
[DomainUtil] 2025-03-19 10:28:16: TongWeb home: /data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux
[DomainUtil] 2025-03-19 10:28:16: Agent home: /data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/Agent
[DomainUtil] 2025-03-19 10:28:16: creating domain: /data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/domains/domain1
[DomainUtil] 2025-03-19 10:28:17: Operation has been completed.
[mashunhua@instance2 bin]$
3、查看域 domains 1
[mashunhua@instance2 bin]$ cd ..
[mashunhua@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]$ ls
Agent bin doc lib logs persistence snapshot tongweb-mq
applications conf domains license.dat patch samples temp tongweb.pid
autodeploy deployment domain_template license_update patchManage service TongDataGrid tools
[mashunhua@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]$ cd domains/
[mashunhua@instance2 domains]$ ls
domain1 domain2 tw_domain_1
[mashunhua@instance2 domains]$ cd domain1/
[mashunhua@instance2 domain1]$ ls
autodeploy bin conf deployment lib logs persistence snapshot temp
[mashunhua@instance2 domain1]$ cd bin/
[mashunhua@instance2 bin]$ ls
external.vmoptions forcestopserver.sh startserverbg.sh startserver.sh stopserver.sh version.sh
[mashunhua@instance2 bin]$ ./version.sh
服务器:TongWeb 7.0.4.9_M5,构建于:2024-12-12 13:33:28
-----------------------------------------
-----------License 信息-------------------
consumer_name=东方通
project_name=生态初级认证培训
license_id=111659
license_type=trial
create_date=2025-02-17
end_date=2025-05-17
TW_Product_Name=TongWeb
TW_Version_Number=7.0
TW_CPU_COUNT=
bindip=
BindMac=
TW_Hardware_Id=
TW_Max_Number=-1
TW_Edition=Enterprise
-----------License 信息-------------------
-----------------------------------------
[mashunhua@instance2 bin]$
创建域的命令会在 domains 目录下生成与域同名的目录,同时在 domain.list 文件中生成记录。
4、删除域:
[mashunhua@instance2 bin]$ pwd
/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/domains/domain1/bin
[mashunhua@instance2 bin]$ cd ..
[mashunhua@instance2 domain1]$ cd ..
[mashunhua@instance2 domains]$ cd ..
[mashunhua@instance2 TongWeb7.0.4.9_M5_Enterprise_Linux]$ cd bin/
[mashunhua@instance2 bin]$ ls
boot.sh external.vmoptions password.sh startserver-nohup-with-check.sh thread-profiler.sh
commandstool.sh external.vmoptions.template startdomain.sh startserver.sh version.sh
dft.sh forcestopserver.sh startserverbg.sh stopdomain.sh
domain.sh installservice.sh startservernohup.sh stopserver.sh
[mashunhua@instance2 bin]$ ./domain.sh delete domain1
[DomainUtil] 2025-03-19 13:50:58: TongWeb home: /data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux
[DomainUtil] 2025-03-19 13:50:58: Agent home: /data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/Agent
[DomainUtil] 2025-03-19 13:50:58: You are going to delete the domain [/data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/domains/domain1], are you sure? [ yes / no ]
yes
[DomainUtil] 2025-03-19 13:51:05: deleting domain: /data/tongweb/TongWeb7.0.4.9_M5_Enterprise_Linux/domains/domain1
[DomainUtil] 2025-03-19 13:51:05: Operation has been completed.
[mashunhua@instance2 bin]$
删除域的命令会删除目录,同时删除 domains.list 中的记录。
注意:如果直接使用 rm 只删除域目录,没有删除文件中的记录的话,TongWeb会出错。
四、管理 TongWeb 控制台
在客户端打开浏览器,输入 TongWeb 管理控制台地址 http://:9060/console,端口 9060,
前缀 console,显示出 TongWeb 管理控制台首页面。
输入用户名/密码登录,默认系统管理员及初始密码为:thanos/thanos123.com
1、登录控制台
TongWeb管理控制台是应用服务器提供的图形管理工具,它允许系统管理员以Web方式管理系统服务、
应用程序、监控系统信息等。
2、修改密码 gCbIUtoQ$^dNf03g
2.1 用户首次登录集中管理控制台时会被提示要求修改初始密码
注意:
首次登录管理控制台时必须更新初始密码,密码必须由大写字母、小写字母、数字、特殊字
符4种组成,长度不得少于10位。
新密码不能和原始密码一致。
2.2 密码周期配置
访问成功后出现以下登录页面。默认系统管理员用户名及初始密码为:thanos/thanos123.com。系统默
认的用户名不可以修改或删除,但是可以在defaultRealm安全域的用户管理中添加用户及修改密码。
2.3 再次登录
修改初始密码如下图所示,密码必须由大写字母、小写字母、数字、特殊字符4种组成,长度不得少于10位。
注意:
新密码不能和初始密码一致,要求5次以内密码不能重复。
2.4 登录成功
如果管理控制台已被某用户登录,使用该用户登陆时会出现如下提示信息:
在首页里,可以看到TongWeb的安装目录、版本号、补丁信息、JDK信息、License信息等。
3、基础服务配置- - 启动参数配置
TongWeb提供启动参数配置,避免手动操作出现误配。bin/external.vmoptions
3.1 设置 JVM 堆内存
修改${TongWeb_HOME}/bin 目录下 external.vmoptions 配置文件,在配置文件开始,根据需要设
置 JVM 堆内存大小,主要是增大堆内存,用户还可根据自己需要增加或减少 JVM 参数,建议设置如下:
-Xms2048m
-Xmx2048m
有这几个标签页:jvm参数、其他jvm参数、服务器参数、环境变量。
通常只需要配置 “jvm 参数” 标签中的 “最大堆内存” 和 “最小堆内存”。
对应的配置文件是
/bin/external.vmoptions
默认2048m,调小内存,设置为1024m
3.2 修改后重启生效。
3.3 再次查看,已经是设置为1024m
4、创建数据源
启动 TongWeb,登录管理控制台,进行 JDBC 连接池配置。
4.1 进入“JDBC 配置”界面,单击“ 创建连接池”按钮:
4.2 创建连接池
配置参数:
名称:testdb
资源类型:DataSource
数据库类型:Oracle Type 4 Driver for Oracle
数据库驱动名称:oracle.jdbc.driver.OracleDriver
连接 URL:jdbc:oracle:thin:@[host]:[1521]:[dbName]
数据库驱动类名:oracle.jdbc.driver.OracleDriver #页面指定和放入TongWeb的lib目录下两种方式,推荐lib下
用户名/密码:数据库的用户密码
驱动路径:数据库驱动所在路径
4.3 池设置:
设置最大连接数、最小空闲连接数、获取连接的最大等待超时时间等。
4.4 进入验证属性,参数采用默认值:
验证连接属性:
生产上建立把“创建连接时验证”、“获取连接时验证”、“归还连接时验证” 这三个验证都开启。
4.5 进入高级属性,参数采用默认值。
高级属性:
根据自己的实际情况设置,例如慢sql检测。
4.6 创建连接
单击“ 完成”,testdb 创建成功。单击“testdb”连接池后的测试连接,连接成功,如下图:
数据库连接成功
五、应用管理(应用部署)
1、Java EE应用文件的类型
类型 扩展名 用途和构成
Web应用 .war 包含Servlet和JSP等Web组件以及静态HTML页面、Jar文件、标记库等,在JavaEE6及以上规范中还可以存在EJB。
EJB应用 .jar 包含EJB实现以及EJB实现所需的类
连接器应用 .rar 包含连接器(资源适配器)的实现类
企业应用 .ear 包含上述三种应用类型
应用程序如何引用数据源的,请参考开发手册。也可以通过 JNDI > 服务器资源域下的 JNDI 树进行引用。
2、应用包支持两种形式
l 目录形式
目录形式即应用以展开的目录方式进行部署,目录部署的优点是方便应用的修改。(推
荐)
l 文件形式
文件形式部署即应用以应用包(如*.war,*.ear等)的方式进行部署,部署后应用解
压在deployment目录下。
3、控制台部署
进入 “管理控制台” “应用管理”“部署应用”,支持文件和目录两种形式。
说明:选择“服务器”时,需要先在控制台首页配置权限“服务器选择文件可选目录”。
4、设置应用基本属性
在“基本属性”标签中,设置应用名称、应用前缀等。
在“虚拟主机”标签中,选择应用的虚拟主机。
在“完成部署”标签,确认信息无误后,点击完成。
5、点击“http访问”测试并访问应用
5.1 确认应用部署成功,日志中没有异常信息出现。
5.2 TongWeb 默认为应用分配的访问端口为 8088,通过 http://:8088/nonXaDsWeb/可以访问到应
用。
5.3 或者单击应用后的“http 访问”以访问应用。( 注:TonWeb 不自带 https 通道,如果想通过 https
访问,需要在“ 管理控制台”->“WEB 容器配置”->“HTTP 通道管理”-> 创建 https 通道)
5.4 成功访问部署应用首页
六、常见问题处理
1、问题描述:密码错误或权限不对
TongWeb7.0企业版重置console四密码:
1、删除TW HOME/conf/security目录下twusers和twgroups开头的文件,包含2个.bak(如果有)
2、复制TW HOME/domain templatelconf/security/twxxx,properies文件模版到TW HOME/conf/security目录下,或是域下的conf/security目录对应文件即可
2、问题描述:TongWeb安装失败
解决思路:
Ø 确认是否配置JAVA_HOME环境变量,执行java -version看是否能查看到jdk版本。
Ø 检查JDK版本是否符合TongWeb产品最低版本要求
Ø 是否执行了图形化显示,echo $DISPLAY ,设置为export DISPLAY=:0.0
Ø 确定产品是否支持对应的系统环境
3、问题描述:如何确定使用的TongWeb版本
确认方法:
Ø 登录TongWeb的后台管理服务http://IP:PORT/console,PORT默认9060,首页中即可看到。
Ø 进入TongWeb_HOME/bin/目录下,执行version.sh或version.bat
Ø 如原始TongWeb安装程序还存在也可以通过名称确认
4、问题描述: TongWeb 启动失败
原因:JAVA_HOME变量问题、JVM设置问题、license授权问题、端口冲突、目录属主、jvm参数配置文件修改错
误、启动方式等。
解决办法:
Ø 检查JAVA_HOME环境变量是否正确。
Ø JVM内存设置要合理。
Ø 从商务上重新获取合法的license;License is not for this version of product(版本不对)
License expires 2025-03-18(过期)
Ø 停止占用TongWeb端口的进程。
Ø 通过chown命令更改TongWeb整个目录文件属主。
Ø 为防止jvm参数配置文件改错,可控制台修改。
Ø 在Unix/Linux下用./startservernohup.sh方式启动TongWeb。
Ø 应用编译jdk版本与部署jdk版本高低(如:Unsupported major.minor version 49.0)。
5、问题描述:同时在一台机器上安装多个TongWeb 应用服务器,端口冲突。
解决办法:安装后需要调整TongWeb 目录下/conf/ tongweb.xml 中的部分端口信息解决端口冲突的问
题。
Ø %TW_HOME%/conf/tongweb.xml 中jmx-service 元素中的端口属性需调整;
Ø %TW_HOME%/conf/tongweb.xml 中http-listener , ajp-listener 元素中的端口属性均需调整(8088、
9060、7200、5100、8443)。
Ø %TW_HOME%/conf/tongweb.xml 中隐藏的接收停止服务器命令的端口8005/7090 需调整,
具体做法如下:
在server 标签中增加一个属性如:或其它空闲端口,这样可以避免
端口冲突异常。
6、问题描述:无法访问TongWeb的控制台
分析思路:
Ø 确认TongWeb进程是否存在,执行命令:ps -ef|grep tongweb
Ø 确认TongWeb服务启动正常并成功,查看TongWeb_HOME/logs/server.log中的信息,本机使用
curl访问控制台的URL
Ø 确认控制台端口正常,查看TongWeb_HOME/conf/tongweb.xml中的端口,netstat查看端口是否存
在
Ø 客户端ping服务端的IP或telnet IP PORT,确认防火墙策略
7、问题描述: TongWeb /bin 目录下 nohup.out 文件越来越大。
解决办法:
Ø 关闭命令行输出
Ø 后台启动并丢弃日志输出
8、问题描述: JSP 更新不生效。
解决办法:
Ø 确定“JSP开发模式”是否开启。
Ø 清理缓存:将TongWeb安装目录temp\work{虚拟主机名}{应用名}下所有文件清空
七、参加东方通初级认证培训
为了帮助您更深入地了解TongWeb中间件,可以参加东方通官方不定期提供的初级认证培训。该培训涵盖TongWeb的基本概念、安装配置、应用部署、性能调优等多个方面,通过理论讲解与实操演练相结合的方式,让您在短时间内掌握TongWeb的核心技能。完成培训并通过考核后,您将获得东方通初级认证证书,为您的职业发展增添一份有力的资质证明。
完成东方通初级认证培训并获得认证资格后,您将收到一张精美的认证证书。
总结
通过本指南,您已经了解了TongWeb V7.0的安装、基本配置、高级功能以及实战案例,帮助您快速上手并高效利用这一强大工具。TongWeb作为一款高效、稳定、安全的应用服务器产品,能够为您的企业应用提供强有力的支持。同时鼓励大家通过参加东方通高级认证培训以及参与实际项目实践等方式,不断提升自己的专业技能和竞争力。希望本指南能够帮助您更好地使用TongWeb V7.0,愿您在TongWeb中间件的学习和使用过程中取得丰硕的成果!
—— 仅供参考。如果有更多具体的问题或需要进一步的帮助,请随时告知。