国产中间件 东方通 TongWeb7.0用户使用手册

【实例简介】国产中间件 东方通 TongWeb7.0用户使用手册
【实例截图】

【核心代码】

TongWeb7应用服务器概述................................................................................ 15
1.1 概述................................................................................................................ 15
1.2 JavaEE7 Web Profile的新特性.......................................................................... 15
1.3 TongWeb7的体系结构...................................................................................... 16
1.4 应用开发工具.................................................................................................. 16
1.5 TongWeb7的特性............................................................................................. 17
1.6 集成的第三方产品........................................................................................... 18
1.7 规范支持......................................................................................................... 18
2 TongWeb7安装指南.......................................................................................... 18
2.1 系统配置要求.................................................................................................. 18
2.2 安装TongWeb7应用服务器.............................................................................. 19
2.2.1 Windows平台上界面安装........................................................................ 19
2.2.2 Linux平台命令行安装............................................................................ 24
2.2.3 Linux平台上静默安装............................................................................ 29
2.2.4 安装License.......................................................................................... 29
2.3 TongWeb7开始向导......................................................................................... 30
2.3.1 TongWeb7应用服务器目录说明................................................................ 30
2.3.2 启动服务器............................................................................................ 30
2.3.2.1 在Windows上启动服务器...................................................... 30
2.3.2.2 在Linux平台上启动服务器.................................................. 30
2.3.2.3 安全启动.............................................................................. 30
2.3.3 宕机重启模式......................................................................................... 31
2.3.3.1 宕机重启模式用法................................................................ 31
2.3.3.2 宕机重启使用场景................................................................ 31
2.3.4 管理控制台............................................................................................ 32
2.3.4.1 登录..................................................................................... 32
2.3.4.2 注销..................................................................................... 33
2.3.4.3 导航栏................................................................................. 33
2.3.4.4 首页..................................................................................... 33
2.3.5 JConsole................................................................................................ 34
2.3.6 停止服务器............................................................................................ 35
2.3.6.1 Windows................................................................................ 35
2.3.6.2 Unix/Linux.......................................................................... 36
2.4 卸载TongWeb7应用服务器.............................................................................. 36
2.4.1 Windows平台上卸载............................................................................... 36
2.4.2 Linux平台上卸载................................................................................... 37
3 应用管理......................................................................................................... 37
3.1 应用管理概述.................................................................................................. 37
3.1.1 应用类型支持......................................................................................... 37
3.1.2 应用部署方式......................................................................................... 37
3.1.3 应用管理方式......................................................................................... 37
3.1.4 应用形态结构......................................................................................... 38
3.1.4.1 Web应用结构........................................................................ 38
3.1.4.2 EJB应用结构.............................................................................. 39
3.1.4.3 EAR应用结构............................................................................. 40
3.1.4.4 RAR应用结构............................................................................. 41
3.1.5 应用部署附加属性.................................................................................. 41
3.1.5.1 应用名称.............................................................................. 42
3.1.5.2 应用前缀.............................................................................. 42
3.1.5.3 JSP预编译........................................................................... 42
3.1.5.4 共享库................................................................................. 42
3.1.5.5 类加载顺序.......................................................................... 43
3.1.5.6 静态资源缓存最大值............................................................ 44
3.1.5.7 应用描述.............................................................................. 44
3.1.5.8 虚拟主机.............................................................................. 44
3.1.6 应用自定义部署描述文件....................................................................... 44
3.2 管理控制台应用管理....................................................................................... 44
3.2.1 查看已部署的应用.................................................................................. 44
3.2.2 应用部署................................................................................................ 45
3.2.3 应用查看与编辑..................................................................................... 50
3.2.4 查看应用子模块..................................................................................... 52
3.2.5 应用解部署............................................................................................ 53
3.2.6 应用重部署............................................................................................ 53
3.2.7 应用访问................................................................................................ 54
3.2.8 应用停止................................................................................................ 55
3.2.9 应用启动................................................................................................ 55
3.2.10 应用更新..................................................................................... 55
3.2.11 应用版本管理.............................................................................. 57
3.2.12 Connector应用........................................................................... 57
3.2.12.1 Connector应用部署............................................................. 57
3.2.12.2 应用查看与编辑................................................................... 58
3.2.12.3 应用重部署.......................................................................... 59
3.2.12.4 应用解部署.......................................................................... 59
3.3 自动部署......................................................................................................... 59
3.3.1 设置自动部署目录.................................................................................. 59
3.3.2 自动部署支持的应用类型....................................................................... 60
3.3.3 自动部署支持的部署方式....................................................................... 60
3.3.4 默认的自动部署目录.............................................................................. 60
3.3.5 自动部署应用......................................................................................... 60
3.3.6 自动解部署应用..................................................................................... 61
3.3.7 自动重部署应用..................................................................................... 61
3.4 热部署............................................................................................................ 61
2020/12/2 192.168.1.3:9060/console/doc/help.htm
192.168.1.3:9060/console/doc/help.htm 4/170
3.4.1 热部署配置............................................................................................ 61
3.4.2 热部署应用............................................................................................ 61
4 Web容器.......................................................................................................... 62
4.1 Web容器说明.................................................................................................. 62
4.1.1 Web容器配置.......................................................................................... 62
4.2 访问日志......................................................................................................... 63
4.2.1 访问日志提供的功能.............................................................................. 63
4.2.1.1 访问日志基本功能................................................................ 63
4.2.2 访问日志的使用..................................................................................... 63
4.2.3 访问日志格式......................................................................................... 64
4.2.4 访问日志使用示例.................................................................................. 66
4.3 虚拟主机......................................................................................................... 66
4.3.1 虚拟主机提供的功能.............................................................................. 66
4.3.1.1 虚拟主机的基本功能............................................................ 66
4.3.1.2 缺省虚拟主机....................................................................... 66
4.3.1.3 单点登陆.............................................................................. 66
4.3.1.4 远程访问过滤....................................................................... 67
4.3.2 虚拟主机的使用..................................................................................... 67
4.3.2.1 创建虚拟主机....................................................................... 67
4.3.2.2 查看/编辑虚拟主机.............................................................. 69
4.3.2.3 启动/停止虚拟主机.............................................................. 69
4.3.2.4 删除虚拟主机....................................................................... 70
4.3.3 虚拟主机使用示例.................................................................................. 70
4.3.3.1 远程访问过滤....................................................................... 70
4.4 通道................................................................................................................ 70
4.4.1 通道提供的功能..................................................................................... 70
4.4.1.1 通道的基本功能................................................................... 70
4.4.1.2 长连接................................................................................. 71
4.4.1.3 通道的工作模式................................................................... 71
4.4.1.4 传输压缩(HTTP&HTTPS)......................................................... 71
4.4.1.5 SSL(HTTPS).......................................................................... 71
4.4.2 通道的使用............................................................................................ 71
4.4.2.1 创建通道.............................................................................. 71
4.4.2.2 查看/编辑通道..................................................................... 76
4.4.2.3 启动/停止通道..................................................................... 78
4.4.2.4 删除通道.............................................................................. 78
4.4.3 配置使用说明......................................................................................... 79
4.4.3.1 通道重定向.......................................................................... 79
4.4.3.2 HTTP通道的重定向............................................................... 79
4.4.3.3 Proxy转发........................................................................... 79
4.5 虚拟主机与通道的关系.................................................................................... 80
4.6 资源................................................................................................................ 81
4.6.1 文件集................................................................................................... 81
4.6.2 共享库................................................................................................... 82
4.6.2.1 共享库类型.......................................................................... 82
4.7 类加载............................................................................................................ 83
4.7.1 类加载机制............................................................................................ 83
4.7.2 类加载模式............................................................................................ 84
4.7.3 类加载推荐策略..................................................................................... 85
4.7.4 类加载参数............................................................................................ 85
4.8 其他................................................................................................................ 85
4.8.1 设置Session Cookie的名字.................................................................. 85
4.8.2 应用上下文共用Session........................................................................ 86
4.8.3 多应用Session共享............................................................................... 86
4.8.4 虚拟目录................................................................................................ 86
5 JDBC配置........................................................................................................ 86
5.1 JDBC数据源概述............................................................................................ 86
5.2 TongWeb7中的JDBC数据源概述..................................................................... 87
5.2.1 连接池管理功能描述.............................................................................. 87
5.2.2 空闲超时的处理..................................................................................... 87
5.2.3 泄露连接的处理..................................................................................... 87
5.2.4 获取连接的处理..................................................................................... 87
5.2.5 连接有效性检查..................................................................................... 88
5.2.6 动态驱动路径加载.................................................................................. 88
5.2.7 语句缓存................................................................................................ 88
5.2.8 故障转移................................................................................................ 88
5.2.9 负载均衡................................................................................................ 88
5.2.10 多数据源状态检查....................................................................... 88
5.3 JDBC数据源的使用......................................................................................... 89
5.3.1 创建数据源连接池.................................................................................. 89
5.3.2 查看/编辑连接池.................................................................................... 94
5.3.3 测试连接................................................................................................ 96
5.3.4 删除JDBC连接池.................................................................................... 97
5.4 多数据源JDBC的使用.................................................................................... 97
5.4.1 创建多数据源连接池.............................................................................. 97
5.4.2 查看/编辑多数据源连接池...................................................................... 98
5.4.3 测试连接................................................................................................ 98
5.4.4 删除JDBC连接池.................................................................................... 98
6 EJB.................................................................................................................. 99
6.1 EJB2.X特性.................................................................................................... 99
6.2 EJB3.0特性................................................................................................... 100
6.3 EJB3.1特性................................................................................................... 100
2020/12/2 192.168.1.3:9060/console/doc/help.htm
192.168.1.3:9060/console/doc/help.htm 5/170
6.4 EJB3.2新特性............................................................................................... 101
6.5 EJB2.x 应用结构........................................................................................... 101
EJB2.x结构下图如所示：............................................................................................. 101
6.6 EJB2.x使用说明............................................................................................ 102
6.6.1 配置说明.............................................................................................. 102
6.6.2 CMP使用步骤........................................................................................ 102
6.6.3 BMP使用步骤........................................................................................ 102
6.7 JPA............................................................................................................... 102
6.7.1 EclipseLink......................................................................................... 103
6.7.2 使用说明.............................................................................................. 104
6.7.3 JPA事物支持说明................................................................................. 106
6.8 EJB容器....................................................................................................... 106
6.8.1 EJB3.2特性支持................................................................................... 106
6.8.2 EJB实例管理........................................................................................ 106
6.8.2.1 无状态会话Bean的实例池.................................................. 106
6.8.2.2 有状态会话Bean的实例缓存............................................... 107
6.8.2.3 消息驱动Bean的实例池...................................................... 107
6.8.3 查看/编辑EJB配置属性........................................................................ 107
6.8.3.1 查看/编辑无状态会话Bean实例池属性............................... 107
6.8.3.2 查看/编辑有状态会话Bean属性......................................... 108
6.8.3.3 查看/编辑单例会话bean属性............................................. 109
6.8.3.4 查看/编辑消息驱动Bean实例池属性.................................. 109
6.8.4 EJB远程调用........................................................................................ 109
6.8.4.1 远程调用协议及方式........................................................... 109
6.8.4.2 远程调用配置..................................................................... 109
6.8.5 EJB集群............................................................................................... 110
6.8.5.1 支持故障转移..................................................................... 110
6.8.5.2 支持故障隔离和恢复........................................................... 110
6.8.5.3 支持负载均衡..................................................................... 110
6.8.5.4 使用说明............................................................................ 110
6.9 全局事务........................................................................................................ 111
6.9.1 全局事务概述........................................................................................ 111
6.9.2 全局事务场景描述................................................................................. 111
6.9.3 全局事务传播策略................................................................................. 111
6.9.4 全局事务配置....................................................................................... 112
7 基础服务配置................................................................................................ 112
7.1 JNDI.............................................................................................................. 112
7.1.1 TongWeb7中的JNDI概述....................................................................... 112
7.1.2 InitialContext的环境属性.................................................................. 112
7.1.2.1 访问本地资源的初始化上下文环境属性............................... 112
7.1.2.2 访问远程资源的初始化上下文环境属性............................... 112
7.1.3 JNDI命名空间....................................................................................... 112
7.1.3.1 全局命名空间..................................................................... 112
7.1.3.2 应用命名空间..................................................................... 114
7.1.3.3 模块命名空间..................................................................... 114
7.1.3.4 组件命名空间..................................................................... 114
7.1.4 JNDI树展示.......................................................................................... 115
7.1.4.1 JDNI展示............................................................................ 115
7.1.5 代码中使用JNDI的示例........................................................................ 117
7.1.6 应用移植.............................................................................................. 117
7.1.6.1 全局JNDI名应用移植......................................................... 117
7.1.6.2 组件JNDI名应用移植......................................................... 118
7.2 安全服务....................................................................................................... 118
7.2.1 安全服务概述....................................................................................... 118
7.2.2 TongWeb7中的安全服务......................................................................... 118
7.2.2.1 安全域................................................................................ 118
7.2.3 安全服务的使用.................................................................................... 119
7.2.3.1 安全域概述......................................................................... 119
7.2.3.2 安全域基本属性.................................................................. 120
7.2.3.3 创建文件安全域.................................................................. 121
7.2.3.4 创建LDAP安全域................................................................ 122
7.2.3.5 创建JDBC安全域................................................................ 123
7.2.3.6 创建Jaas安全域................................................................ 124
7.2.3.7 创建脚本安全域.................................................................. 125
7.2.3.8 创建服务扩展安全域........................................................... 126
7.2.3.9 SSL证书方式认证和授权..................................................... 126
7.2.3.10 安全管理器......................................................................... 128
7.2.4 管理控制台三员分立............................................................................. 128
7.2.4.1 系统管理员......................................................................... 128
7.2.4.2 安全保密管理员.................................................................. 130
7.2.4.3 安全审计员......................................................................... 131
7.3 诊断.............................................................................................................. 131
7.3.1 系统日志.............................................................................................. 131
7.3.1.1 查看系统日志..................................................................... 131
7.3.1.2 下载日志............................................................................ 132
7.3.1.3 搜索日志............................................................................ 132
7.3.2 SQL日志............................................................................................... 133
7.3.3 访问日志.............................................................................................. 133
7.3.4 快照..................................................................................................... 134
7.3.4.1 生成快照和下载.................................................................. 134
7.3.4.2 删除快照............................................................................ 136
7.3.4.3 设置快照路径..................................................................... 136
2020/12/2 192.168.1.3:9060/console/doc/help.htm
192.168.1.3:9060/console/doc/help.htm 6/170
7.3.4.4 快照回放............................................................................ 136
7.3.4.5 快照下载............................................................................ 136
7.3.5 SNMP(简单网络协议)............................................................................. 136
7.3.5.1 SNMP代理服务配置............................................................. 136
7.3.5.2 SNMP代理服务示例............................................................. 138
7.4 监视.............................................................................................................. 138
7.4.1 监视概述.............................................................................................. 138
7.4.2 监视配置.............................................................................................. 138
7.4.3 监视明细.............................................................................................. 140
7.4.4 模块监视属性....................................................................................... 141
7.4.4.1 JVM 内存............................................................................ 141
7.4.4.2 JVM 内存池......................................................................... 141
7.4.4.3 JVM 垃圾收集器.................................................................. 142
7.4.4.4 JVM 线程............................................................................ 142
7.4.4.5 JVM 类加载信息.................................................................. 142
7.4.4.6 JVM 运行时......................................................................... 142
7.4.4.7 操作系统............................................................................ 142
7.4.4.8 TongWeb 信息..................................................................... 142
7.4.4.9 通道信息............................................................................ 142
7.4.4.10 数据源信息......................................................................... 142
7.4.4.11 JVM 编译器信息.................................................................. 142
7.4.4.12 事务信息............................................................................ 143
7.4.4.13 JCA..................................................................................... 143
7.4.4.14 应用细节信息..................................................................... 143
7.4.4.15 应用会话信息..................................................................... 143
7.4.4.16 应用类加载器..................................................................... 143
7.4.4.17 应用资源缓存..................................................................... 143
7.4.5 监视概览.............................................................................................. 143
7.4.6 监视回放.............................................................................................. 144
7.4.7 hung线程............................................................................................. 145
7.4.8 阈值配置.............................................................................................. 146
7.5 日志服务....................................................................................................... 148
7.5.1 日志服务概述....................................................................................... 148
7.5.2 模块日志级别配置................................................................................ 148
7.5.3 系统日志配置....................................................................................... 150
7.5.4 压缩日志配置....................................................................................... 150
7.5.5 日志路径配置....................................................................................... 151
7.5.6 审计日志.............................................................................................. 152
7.5.6.1 操作页面............................................................................ 152
7.5.6.2 配置................................................................................... 153
7.6 JavaMail资源................................................................................................. 153
7.6.1 JavaMail 介绍..................................................................................... 153
7.6.2 TongWeb7中的JavaMail........................................................................ 153
7.6.3 JavaMail资源的使用............................................................................ 154
7.6.3.1 创建JavaMail资源.............................................................. 154
7.6.3.2 查看/编辑JavaMail资源.................................................... 155
7.6.3.3 删除JavaMail资源............................................................. 155
7.6.4 使用JavaMail的示例............................................................................ 155
8 启动参数配置................................................................................................ 156
8.1 概述.............................................................................................................. 156
8.2 参数配置....................................................................................................... 156
图8.2.1 启动参数配置.................................................................................................. 156
8.3 参数格式....................................................................................................... 157
8.4 使用限制....................................................................................................... 157
8.5 外部JVM参数配置........................................................................................ 158
9 JCA................................................................................................................ 158
9.1 概述.............................................................................................................. 158
9.2 TongWeb7中的Connector............................................................................... 158
9.3 线程池........................................................................................................... 159
9.3.1 连接池概述........................................................................................... 159
9.3.2 TongWeb7中的线程池........................................................................... 159
9.3.3 创建线程池........................................................................................... 159
9.3.4 查看/编辑线程池................................................................................... 160
9.3.5 删除线程池........................................................................................... 161
9.3.6 Connector应用中指定线程池................................................................. 161
9.4 JCA连接池.................................................................................................... 161
9.4.1 创建连接池........................................................................................... 161
9.4.2 查看/编辑连接池................................................................................... 162
9.4.3 删除连接池资源.................................................................................... 163
9.4.4 创建安全映射....................................................................................... 163
9.4.5 查看/编辑安全映射............................................................................... 164
9.4.6 删除安全映射....................................................................................... 165
9.5 托管对象资源................................................................................................ 165
9.5.1 创建托管资源对象................................................................................ 165
9.5.2 查看/编辑托管资源对象........................................................................ 166
9.5.3 删除托管资源对象................................................................................ 167
10 工作管理器.................................................................................................... 167
10.1 概述.............................................................................................................. 167
10.2 创建工作管理器............................................................................................. 167
10.3 查看/编辑工作管理器..................................................................................... 168
10.4 删除工作管理器资源...................................................................................... 169
10.5 使用工作管理器............................................................................................. 169
2020/12/2 192.168.1.3:9060/console/doc/help.htm
192.168.1.3:9060/console/doc/help.htm 7/170
11 类加载分析工具............................................................................................. 169
11.1 概述.............................................................................................................. 169
11.2 名词定义....................................................................................................... 170
11.2.1 冗余.......................................................................................... 170
11.2.2 潜在冲突................................................................................... 170
11.3 类加载器树.................................................................................................... 170
11.3.1 类加载器树概述......................................................................... 170
11.3.2 类加载器树使用示例.................................................................. 170
11.4 类资源分析.................................................................................................... 170
11.4.1 类资源分析概述......................................................................... 170
11.4.2 类资源分析使用示例.................................................................. 170
11.4.3 类资源分析结果......................................................................... 171
11.5 类冲突检测.................................................................................................... 171
11.5.1 类冲突检测概述......................................................................... 171
11.5.2 类冲突检测使用示例.................................................................. 171
11.5.3 类冲突检测结果......................................................................... 172
11.5.4 类冲突检测报告......................................................................... 172
12 JMS服务....................................................................................................... 172
12.1 概述.............................................................................................................. 172
12.2 JMS主要功能................................................................................................ 172
12.3 JMS提供的主要接口..................................................................................... 173
12.4 TongWeb7中的JMS....................................................................................... 174
12.4.1 与ActiveMQ集成....................................................................... 176
12.4.2 与TongLINKQ8.1集成................................................................ 178
12.4.3 查看/编辑集成属性................................................................... 179
12.5 JMS资源的使用............................................................................................ 179
12.5.1 创建连接工厂资源..................................................................... 180
12.5.2 查看/编辑连接工厂资源............................................................ 182
12.5.3 删除连接工厂资源..................................................................... 183
12.5.4 创建目的地资源......................................................................... 183
12.5.5 查看/编辑目的地资源................................................................ 185
12.5.6 删除目的地资源......................................................................... 185
12.6 JMS使用示例................................................................................................ 186
示例一：使用ActiveMQ——JNDI集成方式（使用默认提供的名字服务）....... 186
示例二：使用ActiveMQ——JavaBean集成方式............................................... 188
示例三：使用TongLINK/Q8.1.......................................................................... 191
13 TongWeb 域................................................................................................... 193
13.1 概述.............................................................................................................. 193
13.2 创建TongWeb 域........................................................................................... 193
13.3 删除TongWeb 域........................................................................................... 193
13.4 启动TongWeb 域........................................................................................... 193
13.5 停止TongWeb 域........................................................................................... 194
13.6 注意事项....................................................................................................... 194
14 安全防护....................................................................................................... 194
14.1 HttpOnly支持................................................................................................ 194
14.2 HTTP trace支持............................................................................................. 194
14.2.1 启用trace功能......................................................................... 194
14.2.2 禁用trace功能......................................................................... 195
14.3 X-Frame-Options............................................................................................ 195
14.4 防SDOS攻击（慢攻击）............................................................................... 196
14.5 支持国密算法的负载均衡软件THS................................................................ 197
15 工具使用指南................................................................................................ 197
15.1 Eclipse中TongWeb7插件............................................................................... 197
15.1.1 功能概述.............................................................................................. 197
15.1.2 安装Eclipse.......................................................................................... 197
15.1.3 安装Eclipse插件.................................................................................. 197
15.1.4 Eclipse插件的使用................................................................................ 197
15.1.4.1 添加TongWeb7 服务器........................................................ 197
15.1.4.2 修改服务器实例配置........................................................... 201
15.1.4.3 添加和移除工程.................................................................. 201
15.1.4.4 启动和停止服务器.............................................................. 203
15.1.4.5 使用Debug功能.................................................................. 204
15.1.5 Eclipse插件的卸载................................................................................ 204
15.2 Eclipse中混淆器使用..................................................................................... 204
15.3 IDEA插件..................................................................................................... 205
15.3.1 IDEA插件功能概述.............................................................................. 205
15.3.2 IDEA插件的安装与卸载....................................................................... 206
15.3.2.1 安装IDEA.......................................................................... 206
15.3.2.2 安装IDEA插件.................................................................. 206
15.3.2.3 卸载IDEA插件.................................................................. 206
15.3.3 IDEA中TongWeb7插件的使用............................................................. 206
15.3.3.1 在IDEA中添加TongWeb7.................................................. 206
15.3.3.2 部署工程............................................................................ 209
15.3.3.3 使用Debug功能................................................................. 212
15.3.3.4 解部署工程......................................................................... 212
15.4 Patch补丁工具使用说明................................................................................. 212
15.4.1 工具简介.............................................................................................. 212
15.4.2 环境需求.............................................................................................. 212
15.4.3 配置说明.............................................................................................. 212
15.4.4 制作补丁.............................................................................................. 214
15.4.5 升级补丁.............................................................................................. 214
15.5 TongAPM工具使用说明................................................................................. 215
2020/12/2 192.168.1.3:9060/console/doc/help.htm
192.168.1.3:9060/console/doc/help.htm 8/170
15.5.1 安装TongAPM工具..................................................................... 215
15.5.2 APM配置.................................................................................... 216
15.5.3 慢请求分析首页......................................................................... 217
15.5.4 慢请求追踪................................................................................ 217
15.5.5 类方法分析................................................................................ 218
15.5.6 线程刨析................................................................................... 218
15.5.7 JDBC-TOP SQL............................................................................ 219
15.5.8 JDBC-JDBC资源泄漏................................................................... 219
15.5.9 内存分析-潜在内存泄漏............................................................ 220
15.5.10 大对象分析................................................................................ 220
15.6 appclient工具................................................................................................. 221
15.6.1 安装Eclipse............................................................................. 221
15.6.2 在Eclipse中创建客户端应用.................................................... 221
15.6.3 Applient工具调用EJB.............................................................. 226
1. 附录1 应用配置说明..................................................................................... 226
1.1 .tongweb-web.xml........................................................................................... 226
1.2 .tongweb-ejb-jar.xml....................................................................................... 230
1.3 .default-web.xml............................................................................................. 231
1.4 .ejb-jar.xml..................................................................................................... 232
<ejb-jar>......................................................................................................... 232
<description>............................................................................................ 232
<display-name>........................................................................................ 232
<small-icon>............................................................................................ 232
<large-icon>............................................................................................. 232
<enterprise-beans>.................................................................................... 233
<session>.......................................................................................... 233
<description>.............................................................................. 233
<display-name>.......................................................................... 233
<small-icon>.............................................................................. 233
<large-icon>............................................................................... 233
<ejb-name>................................................................................ 233
<home>..................................................................................... 233
<remote>................................................................................... 233
<ejb-class>................................................................................. 234
<session-type>............................................................................ 234
<transaction-type>....................................................................... 234
<transaction-scope>..................................................................... 234
<env-entry>................................................................................ 234
<description>....................................................................... 234
<env-entry-name>................................................................ 234
<env-entry-type>................................................................. 234
<env-entry-value>................................................................ 234
<ejb-ref>.................................................................................... 234
<description>....................................................................... 234
<ejb-ref-name>.................................................................... 234
<ejb-ref-type>..................................................................... 235
<home>.............................................................................. 235
<remote>............................................................................ 235
<ejb-link>........................................................................... 235
<security-role-ref>...................................................................... 235
<description>....................................................................... 235
<role-name>........................................................................ 235
<role-link>.......................................................................... 235
<security-identity>...................................................................... 235
<discription>....................................................................... 235
<use-caller-identity>............................................................. 235
<run-as-specified-identity>.................................................... 235
<description>................................................................ 235
<role-name>................................................................. 236
<resource-ref>............................................................................ 236
<description>....................................................................... 236
<res-ref-name>.................................................................... 236
<res-type>........................................................................... 236
<res-auth>........................................................................... 236
<resource-env-ref>...................................................................... 236
<description>....................................................................... 236
<resource-env-ref-name>...................................................... 236
<resource-env-ref-type>........................................................ 236
<entity>............................................................................................ 236
<description>.............................................................................. 237
<display-name>.......................................................................... 237
<small-icon>.............................................................................. 237
<large-icon>............................................................................... 237
<ejb-name>................................................................................ 237
<home>..................................................................................... 237
<remote>................................................................................... 237
<ejb-class>................................................................................. 237
<persistence-type>....................................................................... 237
<prim-key-class>........................................................................ 237
<reentrant>................................................................................. 237
<cmp-version>............................................................................ 238
<abstract-schema-name>.............................................................. 238
<cmp-field>............................................................................... 238
<description>....................................................................... 238
<field-name>....................................................................... 238
2020/12/2 192.168.1.3:9060/console/doc/help.htm
192.168.1.3:9060/console/doc/help.htm 9/170
<primkey-field>.......................................................................... 238
<transaction-scope>..................................................................... 238
<env-entry>................................................................................ 238
<description>....................................................................... 238
<env-entry-name>................................................................ 238
<env-entry-type>................................................................. 238
<env-entry-value>................................................................ 238
<ejb-ref>.................................................................................... 239
<description>....................................................................... 239
<ejb-ref-name>.................................................................... 239
<ejb-ref-type>..................................................................... 239
<home>.............................................................................. 239
<ejb-link>........................................................................... 239
<security-role-ref>...................................................................... 239
<description>....................................................................... 239
<role-name>........................................................................ 239
<role-link>.......................................................................... 239
<security-identity>...................................................................... 239
<description>....................................................................... 239
<use-caller-identity>............................................................. 240
<run-as-specified-identity>.................................................... 240
<description>................................................................ 240
<role-name>................................................................. 240
<resource-ref>............................................................................ 240
<resource-env-ref>...................................................................... 240
<query>..................................................................................... 240
<description>....................................................................... 240
<query-method>.................................................................. 240
<method-name>............................................................ 240
<method-params>......................................................... 240
<method-param>.................................................... 240
<ejb-ql>.............................................................................. 240
<query-spec>....................................................................... 240
<message-driven>.............................................................................. 241
<description>.............................................................................. 241
<display-name>.......................................................................... 241
<small-icon>.............................................................................. 241
<large-icon>............................................................................... 241
<ejb-name>................................................................................ 241
<ejb-class>................................................................................. 241
<transaction-type>....................................................................... 241
<transaction-scope>..................................................................... 241
<jms-message-selector>............................................................... 242
<jms-acknowledge-mode>............................................................ 242
<message-driven-destination>....................................................... 242
<jms-destination-type>......................................................... 242
<res-ref-name>.................................................................... 242
1.5 . persistence.xml............................................................................................. 242
<persistence>................................................................................................... 242
<persistence-unit>..................................................................................... 242
<description>..................................................................................... 242
<provider>........................................................................................ 242
<jta-data-source>............................................................................... 242
<non-jta-data-source>......................................................................... 242
<mapping-file>.................................................................................. 242
<jar-file>.......................................................................................... 242
<class>.............................................................................................. 242
<exclude-unlisted-classes/>.................................................................. 243
<properties>...................................................................................... 243
< propertie>............................................................................... 243
2. 附录2 TongWeb7配置说明............................................................................. 243
2.1. EJB配置说明................................................................................................ 243
2.1.1. 无状态会话bean配置................................................................ 243
2.1.2. 有状态会话bean配置................................................................ 244
2.1.3. 单例会话bean配置.................................................................... 244
2.1.4. 消息驱动bean配置.................................................................... 244
2.2. JDBC配置说明.............................................................................................. 245
2.2.1. 连接池基本配置......................................................................... 245
2.2.2. 连接池池设置............................................................................ 246
2.2.3. 连接池验证连接属性配置........................................................... 247
2.2.4. 连接池的高级属性配置.............................................................. 248
2.3. Web容器配置说明......................................................................................... 250
2.3.1. 容器配置................................................................................... 250
2.3.2. access-log................................................................................ 250
2.3.3. virtual-host............................................................................ 253
2.3.3.1. Remote-filter................................................................... 254
2.3.4. http-listener.......................................................................... 254
2.3.4.1. ssl..................................................................................... 255
2.3.4.2. protocol............................................................................ 255
2.3.4.3. http-options..................................................................... 256
2.3.4.4. advance.............................................................................. 257
2.3.5. ajp-listner.............................................................................. 258
2.3.5.1. ajp-options....................................................................... 259
2.4. 日志服务配置................................................................................................ 259
2.4.1. 日志服务配置属性..................................................................... 259
2020/12/2 192.168.1.3:9060/console/doc/help.htm
192.168.1.3:9060/console/doc/help.htm 10/170
2.5. 事务配置....................................................................................................... 260
2.5.1. 事务配置属性............................................................................ 260
2.6. JSF配置........................................................................................................ 261
2.6.1. JSF配置属性............................................................................. 261
3. 附录3常见问题说明...................................................................................... 261
3.1. 跨域访问技术CORS配置说明........................................................................ 261
3.2. TongWeb及其集中管理工具对IPv6支持........................................................ 263
3.3. TongWeb7支持Invoker Servlet........................................................................ 263
3.4. TongWeb7对JDK9以上版本支持说明............................................................ 264
4. 附录4开机自启动服务安装工具说明............................................................. 264
5. 附录5TongWeb7使用jmxmp协议..................................................................... 265
6. 附录6使用命令行安装TongWeb..................................................................... 265
installTongWebs.sh num........................................................................................... 265
installTongWebs.sh num pathPrefix........................................................................... 266
installTongWebs.sh configFilePath............................................................................ 266
7. 附录7 jmstool命令使用说明........................................................................ 267
8. 附录8 参数说明.......................................................................................... 268
9. 附录9 命令行使用说明................................................................................. 275
9.1基本使用说明................................................................................................... 275
9.1.1执行方式............................................................................................... 275
9.1.2安全认证............................................................................................... 275
9.1.3参数格式............................................................................................... 275
9.1.4错误提示............................................................................................... 276
9.1.5参数默认值........................................................................................... 276
9.2基本参数.......................................................................................................... 276
9.3Commandstool使用命令..................................................................................... 276
9.3.1 change-admin-password....................................................................... 276
9.3.2 create-auth-realm.............................................................................. 277
9.3.3 delete-auth-realm.............................................................................. 277
9.3.4 create-file-user................................................................................ 278
9.3.5 delete-file-user................................................................................ 278
9.3.6 create-http-listener......................................................................... 278
9.3.7 update-http-listener......................................................................... 279
9.3.8 delete-http-listener......................................................................... 279
9.3.9 start-http-listener.......................................................................... 279
9.3.10 stop-http-listener.......................................................................... 280
9.3.11 create-ajp-listener......................................................................... 280
9.3.12 delete-ajp-listener......................................................................... 280
9.3.13 start-ajp-listener.......................................................................... 280
9.3.14 stop-ajp-listener............................................................................ 280
9.3.15 create-virtual-server..................................................................... 281
9.3.16 delete-virtual-server..................................................................... 281
9.3.17 start-virtual-server....................................................................... 281
9.3.18 stop-virtual-server......................................................................... 281
9.3.19 create-jdbc-connection-pool........................................................... 281
9.3.20 update-jdbc-connection-pool........................................................... 282
9.3.21 delete-jdbc-connection-pool........................................................... 283
9.3.22 deploy............................................................................................... 283
9.3.23 undeploy............................................................................................ 284
9.3.24 redeploy............................................................................................ 284
9.3.25 ping-jdbc-connection-pool.............................................................. 285
9.3.26 help................................................................................................... 285
9.3.27 list-apps.......................................................................................... 285
9.3.28 list-file-users................................................................................ 285
9.3.29 list-http-listeners......................................................................... 285
9.3.30 list-ajp-listeners.......................................................................... 285
9.3.31 list-jdbc-connection-pools............................................................ 286
9.3.32 list-virtual-servers....................................................................... 286
9.3.33 list-auth-realms.............................................................................. 286
9.3.34 list-sys-properties......................................................................... 286
9.3.35 list-jms-connection-factory........................................................... 286
9.3.36 list-jms-destination....................................................................... 286
9.3.37 create-jms-connection-factory....................................................... 286
9.3.38 create-jms-destination................................................................... 287
9.3.39 delete-jms-connection-factory....................................................... 288
9.3.40 delete-jms-destination................................................................... 288
9.3.41 list-adapter-adminobject................................................................ 288
9.3.42 list-connector-connection-pools.................................................... 288
9.3.43 create-connector-connection-pool.................................................. 288
9.3.44 delete-connector-connection-pool.................................................. 289
9.3.45 list-threadpools.............................................................................. 289
9.3.46 create-threadpool............................................................................ 289
9.3.47 delete-threadpool............................................................................ 290
9.3.48 create-adapter-adminobject............................................................ 290
9.3.49 delete-adapter-adminobject............................................................ 290
9.3.50 list-connector-security-maps......................................................... 290
9.3.51 create-connector-security-map....................................................... 290
9.3.52 delete-connector-security-map....................................................... 291
9.3.53 version.............................................................................................. 291
9.3.54 web-container-config....................................................................... 291
9.3.55 update-web-container-config........................................................... 292
9.3.56 server-log-config............................................................................ 292
2020/12/2 192.168.1.3:9060/console/doc/help.htm
192.168.1.3:9060/console/doc/help.htm 11/170
9.3.57 update-server-log-config................................................................ 293
9.3.58 set-jvm-arg....................................................................................... 293
9.3.59 delete-jvm-arg................................................................................. 293
9.3.60 set-server-arg................................................................................. 294
9.3.61 delete-server-arg............................................................................ 294
9.3.62 update-auto-deploy-config.............................................................. 294
10. 附录10 提供NativeJdbcExtractor工具类.................................................... 295
11. 附录11 数据库密码加密脚本......................................................................... 295
12. 附录12 通过JCA集成Tuxedo配置说明......................................................... 295
12.1 Tuxedo远端服务配置简介............................................................................ 295
12.2 com.oracle.tuxedo.TuxedoAdapter.rar配置......................................................... 296
12.3 TongWeb相关部署及配置............................................................................... 296
13. 附录13 Apache作为Proxy Server配置说明................................................. 296
14. 附录14 TongWeb提供等同Apache的rewrite重写机制功能配置说明............. 298
14.1 RewriteCond................................................................................................... 299
14.2 RewriteRule.................................................................................................... 300