迁移 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.1V6V7.0 或更高版本 应用程序服务器.
有关更多信息,请参阅共存:保留或迁移 V5.1 网关

无须停止网关就可以迁移用于生产的 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 应用程序服务器迁移至更高版本上应用程序服务器或集群上的网关功能,请完成下列步骤:

过程

  1. 可选: V5.1 网关中移除所有过滤器。
    可迁移包含过滤器的网关。但是,过滤器不能在 更高版本中工作,所以您可能更愿意通过完成下列步骤从配置中移除它们,然后进行迁移:
    1. 检查 V5.1 网关是否使用过滤器。有关更多信息,请参阅 WebSphere Application Server V5.1 主题:列示和管理网关部署的过滤器
    2. 移除所有过滤器。有关更多信息,请参阅 WebSphere Application Server V5.1 主题:从 Web Service 网关中移除过滤器
    迁移后,可使用 JAX-RPC 处理程序与服务集成总线调解的组合来重新创建过滤器功能。如果您迁移包含路由过滤器的 Web Service 网关,那么可以重新创建过滤器功能。
  2. 选择作为更高版本上单服务器或集群并且包含在 Network Deployment 单元中的目标服务器或集群。
  3. 将目标服务器或集群配置为服务集成总线的成员。
  4. 在单元范围为目标服务器或集群配置服务数据对象 (SDO) 存储库。
  5. 如果您正在迁移任何 EJB 绑定,并且想要让它们继续使用由 RPC 编码的绑定或者使用不是文档文字的任何绑定,那么将正确类型的绑定添加至 EJB 绑定 WSDL。 必须执行此步骤,这是因为 V5.1 网关缺省绑定是由 RPC 编码的,而更高版本中的缺省绑定是文档文字
  6. 确保源 (V5.1) 应用程序服务器正在运行,然后使用 V5.1 网关用户界面将 V5.1 应用程序服务器的网关配置作为专用配置来备份。 有关更多信息,请参阅 WebSphere Application Server V5.1 主题:备份网关配置
  7. 可选: 停止 V5.1 应用程序服务器。
    注: 如果您正在迁移一个用于生产的网关,那么让 V5.1 网关一直运行,直到 更高版本上的网关配置完成为止,然后将请求者应用程序切换为使用新的网关配置,而现有的 V5.1 网关将继续运行。但是,这两个版本的网关不必同时运行,并且可能需要先停止 V5.1 服务器再启动更高版本上的服务器或集群(例如,如果在同一机器上并使用同一端口号安装更高版本上的服务器或集群以直接替换 V5.1 服务器,情况即如此)。
  8. 启动更高版本上的目标应用程序服务器或集群以及(对于受管单元中的单服务器或集群)目标单元的 Deployment Manager。
  9. 检查在 V5.1 应用程序服务器上用来定义目标服务的所有 WSDL 文档是否位于它们的给定位置中。如果 WSDL 位置是 UDDI 引用,那么检查引用的 UDDI 注册中心是否可用。
  10. 可选: 如果迁移的网关使用 JAX-RPC 处理程序和处理程序列表,那么应确保底层的处理程序类在运行时是可用的。
  11. 要将导出的配置迁移到更高版本上应用程序服务器或集群中的新网关实例内,请完成以下步骤:
    1. 打开命令提示符,然后切换至 app_server_root/util 目录。
    2. 运行以下命令:
      [IBM i]注: [IBM i]wsadmin 脚本编制客户机通过 Qshell 运行. [IBM i]有关更多信息,请参阅 使用 wsadmin 脚本编制配置 Qshell 以运行 WebSphere 脚本.
      migratewsgw[AIX Solaris HP-UX Linux Windows][z/OS].ext -C=cell_name [-S=server_name -N=node_name] 
                          [-X=cluster_name] -B=bus_name 
                           -G=v5_gateway_configuration_file_name 
                          [-H=administration_hostname] [-A=administration_port] 
                          [-U=gateway_instance_name] [-P=object_prefix] 
                          [-username=WAS_user_ID -password=WAS_password]
      其中:
      • [AIX Solaris HP-UX Linux Windows][z/OS].ext 是文件扩展名 .bat(对于 Windows 系统)或 .sh(对于 Unix 或 Linux 系统)。
      • 方括号(“[ ]”)表示参数或参数组在某些情况下是可选的。
      • server_namenode_name 一起(对于单服务器)或 cluster_name(对于集群)定义要将网关配置迁移到的服务器或集群。
      • cell_nameserver_namenode_name(或 cluster_name)、administration_hostnameadministration_port 共同定义与更高版本上应用程序服务器(或集群)的连接。server_namecluster_name 指定创建端点侦听器和出站端口目标所在的目标应用程序服务器或集群的名称。如果正在迁移到作为受管单元一部分的服务器或集群,那么 administration_hostnameadministration_port 分别定义 Deployment Manager 的主机名和 SOAP 管理端口号。如果您正在迁移到不是作为受管单元一部分的某个服务器,那么 administration_hostnameadministration_port 分别定义独立服务器的主机名和端口号,并且此步骤是可选的。如果省略了它们,那么该命令将假定期望值为 localhost:8880(即,独立服务器的 WebSphere Application Server 缺省值)。
        [IBM i]注: administration_hostname 是 IBM i 平台所必需的。
      • v5_gateway_configuration_file_name 是导出的 V5.1 专用网关 XML 配置文件的完整路径和文件名。
      • bus_namegateway_instance_name 共同定义正在此总线中创建的网关实例。仅当您想要在此总线中创建多个网关实例时,gateway_instance_name 才是必需的。如果省略这个可选参数,那么将指定缺省名称。
      • object_prefix 是一个字符串,它用作由迁移过程定义的对象的名称前缀。如果省略此参数,那么将使用已迁移的服务的名称空间 URI(缺省值为 urn:ibmwsgw)。
      • 如果目标应用程序服务器或集群受密码保护,那么 WAS_user_IDWAS_password 是必需的。
  12. 可选: 如果迁移过程更改了已迁移服务的外部 Web 地址,请修改端点侦听器配置以更新这些地址。 如果外部 Web 地址指向网关而不是指向 Web 服务器,并且您已将网关迁移到另一台机器或者迁移到同一机器上的另一个端口,那么必须执行上述操作。

下一步做什么

注:
  • 如果 V5.1 网关使用了过滤器,那么应使用 JAX-RPC 处理程序与服务集成总线调解的组合来重新创建过滤器功能。
  • 如果网关配置中包含任何具有多个目标服务的网关服务,那么 V5.1 配置可能已使用路由过滤器来选择特定的目标服务。如果出现这种情况,那么必须进一步配置已迁移的网关以便通过路由调解选择目标服务和端口
  • 更高版本上的 Web Service 网关使用更多内存处理消息,所以如果通过已迁移的网关来传递大型附件,那么在 Java 虚拟机中可能会产生内存不足错误。要解决此问题,应增大 JVM 堆大小。

指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twsg_coex_migrate
文件名:twsg_coex_migrate.html