迁移 V5.1 Web Service 网关配置
在 WebSphere® Application Server V5.1 中,Web Service 网关是一个可分离的组件,它具有自己的用户界面。在产品的更高版本中,网关将集成至服务集成总线支持的 Web Service,并作为扩展和链接入站和出站服务的机制重新实现。使用 wsadmin 命令脚本将现有网关配置从 V5.1 应用程序服务器迁移至更高版本上的应用程序服务器或集群。
开始之前
考虑您是否必须迁移现有网关:
- WebSphere Application Server V5.0 不再受支持,所以应迁移 V5.0 应用程序服务器中运行的全部现有网关,使其在产品最新级别的应用程序服务器中运行。
- 只要遵守某些限制,在 WebSphere Application Server V5.1 上运行的 Web Service 网关可以与 V7.0 或更高版本 应用程序服务器上运行的网关实例共存。.
- V7.0 或更高版本 单元可以包含 V5.1、V6 和 V7.0 或更高版本 应用程序服务器.
无须停止网关就可以迁移用于生产的 V5.1 网关;于是,请求者应用程序可以切换为使用新的网关配置,而现有的 V5.1 网关将继续运行。
关于此任务
迁移过程使用已将其配置导出到 XML 文件的 V5.1 网关应用程序,并使用导出的 XML 文件来在更高版本上的单个应用程序服务器或集群上配置相同的网关功能。要完成此任务,首先导出 V5.1 网关配置,然后运行一个脚本来将导出的配置迁移到更高版本上现有应用程序服务器或集群中的新网关实例内。
V5.1 配置将按如下方式迁移:
- 在迁移过程中,将自动创建网关实例。
- 将直接迁移网关服务、目标服务和 UDDI 引用。
- 还将迁移 JAX-RPC 处理程序和处理程序列表的网关中的定义。您必须确保底层处理程序类在运行时是可用的。
- 由于在更高版本中,通道功能已在端点侦听器和入站端口之间共享,所以应该将网关服务等效地指定给一对特定的入站端口和端点侦听器,而不是指定给特定通道。对 Apache SOAP 通道的所有使用都会被迁移到 SOAP over HTTP 端点侦听器和入站端口。
- 现有过滤器未迁移。建议不要在 V5.1.1 中使用过滤器,并且已在 V7.0 中移除对过滤器的支持。 以前由过滤器扮演的角色,现在由 JAX-RPC 处理程序与服务集成总线调解的组合承担。
- 缺省情况下,在更高版本中,会将根据目标服务的 WSDL(而不是网关服务的 WSDL)生成的 Web Service 客户机标记为错误。
- 如果已使用 V5.1 网关服务 WSDL 来生成 Web Service 客户机,并且 WSDL 绑定和编码样式不是文档字面值,那么迁移到更高版本后,必须使用新的网关服务 WSDL 来重新生成客户机存根。
- 会将 WS-Security 绑定作为符合 WS-Security Draft 13 规范的绑定来迁移。但是:
- WS-Security 规范的最终版本(在 WebSphere Application Server V6 中实现)与 Draft 13 版本不兼容,因此建议不要在 WebSphere Application Server V6 中使用 WS-Security Draft 13。不推荐使用 WS-Security Draft 13,并且仅应使用它来允许连续使用已写至 WS-Security Draft 13 规范的现有 Web Service 客户机应用程序。
- 仅当在符合下列条件的机器上运行迁移进程时才会迁移 WS-Security 绑定对象: 在该机器上,目标服务器作为独立的服务器运行;或者在该机器上,Deployment Manager 在 Network Deployment 配置中运行。
- 仅迁移网关服务或目标服务 WS-Security 配置所使用的 WS-Security 绑定对象。不会迁移您已创建但是并未使用的任何绑定对象。例如:如果 WS-Security 配置引用了“签名信息”对象,而“签名信息”对象又引用了“信任锚”对象,那么“签名信息”对象和“信任锚”对象都会随引用它们的 WS-Security 配置一起迁移。
注:
- 迁移过程假定已迁移的服务的外部 Web 地址保持不变。此假定是根据期望这些地址与 Web 服务器而不是与网关所在的机器相关联这种情况来作出的,因此,这些地址的主机名和端口号不会受影响。在您的配置中,如果外部 Web 地址指向网关,那么在完成迁移过程之后修改端点侦听器配置。
- 可使用 WebSphere Application Server Network Deployment 迁移到在任一配置概要文件(独立服务器或 Deployment Manager)下运行的单服务器。但是,建议您迁移到在 Deployment Manager 概要文件下运行的单服务器。如果迁移到独立服务器概要文件,那么接下来不能使用管理控制台来修改网关配置。
- 与 WebSphere Application Server V5.1 相比,服务集成总线支持的 Web Service 会更彻底地验证 Web Service 消息。因此,某些使用格式不良的请求或响应(消息部分的名称错误)的客户机应用程序在 V5.1 中能够正常运行,但现在却被标识为格式不良。有关解决此问题要采取的步骤,请参阅支持总线的 Web Service:已知限制。
要将现有网关配置从 V5.1 应用程序服务器迁移至更高版本上应用程序服务器或集群上的网关功能,请完成下列步骤:
过程
下一步做什么
注:
- 如果 V5.1 网关使用了过滤器,那么应使用 JAX-RPC 处理程序与服务集成总线调解的组合来重新创建过滤器功能。
- 如果网关配置中包含任何具有多个目标服务的网关服务,那么 V5.1 配置可能已使用路由过滤器来选择特定的目标服务。如果出现这种情况,那么必须进一步配置已迁移的网关以便通过路由调解选择目标服务和端口。
- 更高版本上的 Web Service 网关使用更多内存处理消息,所以如果通过已迁移的网关来传递大型附件,那么在 Java 虚拟机中可能会产生内存不足错误。要解决此问题,应增大 JVM 堆大小。