WAS版本迁移技术白皮书(简体中文)

第 1 章. 迁移战略及规划

1.1 迁移过程概述. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.1.1 迁移类型 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.1.2 重要方面及注意事项 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.2 迁移评估 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.2.1 迁移调查问卷 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.2.2 迁移调查问卷评审会 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.2.3 迁移评估报告 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.3 迁移规划 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.3.1 角色和职责 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.3.2 迁移项目计划 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.4 迁移实施 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.4.1 实施注意事项 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.4.2 实施阶段 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.4.3 应用程序迁移 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
1.4.4 IDE 迁移 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.4.5 运行时迁移 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.5 后部署. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.5.1 性能调整及优化. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.5.2 获取帮助 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.6 总结. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

第 2 章. 常见迁移问题

2.1 J2EE 至 Java EE 迁移注意事项 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
2.1.1 Java 消息服务（JMS）. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.1.2 JavaServer Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.1.3 Servlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.1.4 JavaServer Faces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
2.1.5 Web 服务 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
2.1.6 Java 持久性 API （JPA） . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
2.2 运行时迁移问题. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
2.2.1 同时迁移其他产品. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
2.2.2 资源定义 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
2.2.3 开发环境问题 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
2.3 互操作性和集成. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

第 3 章. Application Migration Tool 的安装和配置

3.1 IBM WebSphere Application Server Migration Toolkit 概述 . . . . . . . . . . . . . . . . . . . . . 30
3.1.1 Migration Toolkit 基础知识 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
3.2 在 Eclipse 上安装 Application Migration Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
3.3 在 Rational Application Developer V8.5 上安装 Application Migration Tool . . . . . . . . . 40
3.4 命令行安装 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
3.5 配置 Application Migration Tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
3.5.1 运行分析 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
3.5.2 配置和运行分析. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
3.5.3 生成报告 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
3.6 故障诊断 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

第 4 章. Application Migration Tool - WebSphere Version to Version 的安装和配置

4.1 Application Migration Tool - WebSphere Version to Version 概述 . . . . . . . . . . . . . . . . 52
4.1.1 Application Migration Tool V3.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
4.1.2 WebSphere Application Server V8.5 Liberty 概要文件. . . . . . . . . . . . . . . . . . . . . 53
4.2 在 Eclipse 上安装 Application Migration Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
4.2.1 使用 Eclipse Marketplace 安装 Application Migration Tool . . . . . . . . . . . . . . . . . . 53
4.2.2 使用 CLI 安装 Application Migration Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
4.2.3 使用 Rational Application Developer V8.5 安装 Application Migration Tool . . . . . 56

第 5 章. 从较早版本的 WebSphere Application Server 迁移

5.1 概念. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
5.1.1 整体迁移过程 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
5.1.2 轻松迁移 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
5.1.3 已知问题 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
5.2 Plants by WebSphere 样例应用程序迁移 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
5.2.1 应用程序概述 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
5.2.2 修改和重建 Plants by WebSphere 样例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
5.2.3 删除及重新安装 PlantsByWebSphere.ear 文件 . . . . . . . . . . . . . . . . . . . . . . . . . . 78
5.2.4 从管理控制台安装 Plants By WebSphere . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
5.2.5 运行样例应用程序. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
5.3 Plants By WebSphere 的迁移. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
5.3.1 导出 PlantsByWebSphere.ear 以及将其导入 Eclipse 以进行分析 . . . . . . . . . . . . 82
5.3.2 配置和运行 Application Migration Tool - WebSphere Version to Version . . . . . . . 85
5.3.3 修正由 Application Migration Tool 报告的错误 . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
5.3.4 Application Migration Tool 未检测到的其他迁移问题 . . . . . . . . . . . . . . . . . . . . . . 93
5.3.5 导出经修正的 Plants By WebSphere 应用程序并在
WebSphere Application Server V8.5 上运行该应用程序 . . . . . . . . . . . . . . . . . . . 94
5.4 概率分布样例. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
5.4.1 将应用程序导入 Rational Application Developer V8.5 中 . . . . . . . . . . . . . . . . . . . 95
5.4.2 在 WebSphere Application Server V6.1 上安装应用程序 . . . . . . . . . . . . . . . . . . . 95
5.4.3 在 WebSphere Application Server V6.1 上测试应用程序 . . . . . . . . . . . . . . . . . . . 96
5.4.4 运行 Application Migration Tool - WebSphere Version to Version . . . . . . . . . . . . 96
5.4.5 解决发现的迁移问题 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
5.4.6 在 Rational Application Developer 中准备应用程序在
WebSphere Application Server V8.5 上安装 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
5.4.7 在 WebSphere Application Server V8.5 上安装应用程序 . . . . . . . . . . . . . . . . . . . 99
5.4.8 在 WebSphere Application Server V8.5 上测试应用程序 . . . . . . . . . . . . . . . . . . . 99
5.4.9 迁移后升级应用程序的其他选项 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
5.5 Web 服务 Axis 2 股票报价样例. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
5.5.1 概述. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
5.5.2 在 WebSphere Application Server V6.1 上安装 . . . . . . . . . . . . . . . . . . . . . . . . . 101
5.5.3 在 WebSphere Application Server V6.1 上测试 . . . . . . . . . . . . . . . . . . . . . . . . . 102
5.5.4 将应用程序源代码导入到 Eclipse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
5.5.5 运行 Application Migration Tool - WebSphere Version to Version . . . . . . . . . . . 103
5.5.6 准备在 WebSphere Application Server V8.5 上进行安装 . . . . . . . . . . . . . . . . . . 105
5.5.7 在 WebSphere Application Server V8.5 上安装 . . . . . . . . . . . . . . . . . . . . . . . . . 106
5.5.8 配置 WebSphere Application Server V8.5 以支持应用程序 . . . . . . . . . . . . . . . . 106
5.5.9 在 WebSphere Application Server V8.5 上测试应用程序 . . . . . . . . . . . . . . . . . . 108
5.5.10 Web 服务 Axis 2 股票报价应用程序迁移的摘要 . . . . . . . . . . . . . . . . . . . . . . . . 108

全部内容请见