TongWeb替换tomcat的实现步骤

TongWeb替换Tomcat的实现步骤可以分为以下几个主要阶段：

一、前期准备与评估

1. 环境评估

• 确认当前Tomcat版本、JDK版本
• 梳理现有应用的技术栈（Spring Boot、Servlet版本、JSP等）
• 识别使用的Tomcat特有功能（如JMX、Valve、Cluster配置等）

2. 版本选择

• 选择合适的TongWeb版本（建议选择与当前JDK兼容的最新稳定版）
• 下载TongWeb安装包（从东方通官网获取）

二、安装与部署

1. 安装TongWeb

# 解压安装包
tar -zxvf TongWeb-7.x.x.tar.gz -C /opt/

# 设置环境变量
export TONGWEB_HOME=/opt/TongWeb7.0
export PATH=$PATH:$TONGWEB_HOME/bin

2. 目录结构对比

Tomcat结构              TongWeb对应结构
├── bin/               → ├── bin/
├── conf/              → ├── conf/
├── lib/               → ├── lib/
├── webapps/           → ├── webapps/
├── logs/              → ├── logs/
└── work/              → └── work/

三、配置迁移

1. 核心配置文件迁移

• server.xml → tongweb.xml

  <!-- 端口配置迁移 -->
  <Connector port="8080" protocol="HTTP/1.1" />
  
  <!-- Context配置 -->
  <Context path="/myapp" docBase="myapp" />

• web.xml：通常可直接复用

• context.xml：配置方式基本兼容

2. 数据源配置

<!-- TongWeb数据源配置示例 -->
<Resource name="jdbc/myDS" 
          auth="Container"
          type="javax.sql.DataSource"
          factory="com.tongweb.jdbc.TongWebDataSourceFactory"
          driverClassName="com.mysql.jdbc.Driver"
          url="jdbc:mysql://localhost:3306/mydb"
          username="user" 
          password="pass"
          maxTotal="20" 
          maxIdle="10"/>

3. SSL配置迁移

<!-- TongWeb SSL配置 -->
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           SSLEnabled="true"
           keystoreFile="/path/to/keystore"
           keystorePass="password"
           sslProtocol="TLS"/>

四、应用部署与测试

1. 应用部署方式

# 方式1：直接复制WAR包
cp myapp.war $TONGWEB_HOME/webapps/

# 方式2：通过管理控制台部署
# 访问 http://localhost:9060/console

2. 启动与停止

# 启动TongWeb
$TONGWEB_HOME/bin/startserver.sh

# 停止TongWeb
$TONGWEB_HOME/bin/stopserver.sh

# 查看状态
$TONGWEB_HOME/bin/server_status.sh

五、功能验证与调优

1. 兼容性测试

• Servlet/JSP规范兼容性
• JNDI资源访问
• Session集群（如果使用）
• 静态资源访问

2. 性能调优

<!-- 连接器性能优化 -->
<Connector port="8080" 
           maxThreads="200"
           minSpareThreads="25"
           acceptCount="100"
           connectionTimeout="20000"/>

<!-- JVM参数调整 -->
# 在startserver.sh中调整
JAVA_OPTS="-Xms2G -Xmx4G -XX:+UseG1GC"

3. 监控配置

• 启用JMX监控
• 配置日志输出格式
• 集成第三方监控工具

六、特殊注意事项

1. 类加载器差异

• TongWeb使用统一的类加载机制
• 检查lib目录下的jar包冲突

2. 特有功能替代

• 替换Tomcat Valve为TongWeb Filter
• 使用TongWeb的管理控制台替代Tomcat Manager

3. 常见问题处理

// 1. 编码问题
// 在server.xml中添加URIEncoding
<Connector URIEncoding="UTF-8" ... />

// 2. Session序列化问题
// 确保所有Session属性实现Serializable

// 3. 日志框架适配
// 可能需要调整log4j/logback配置

七、完整迁移检查清单

八、回滚方案

最佳实践建议

TongWeb对Tomcat的兼容性较好，大部分应用可以平滑迁移。但在迁移过程中仍需关注一些细微差异，特别是使用了Tomcat特定API或配置的应用。