安装连接器

在安装了 WebSphere Business Integration 系统之后,您可以在任何时候从产品 CD 安装其它适配器。为此,插入产品 CD,运行安装程序,并选择您要安装的适配器。

注:
除非另有指示,否则本章中其余各节适用于连接器的 Windows 和 UNIX 安装。

IBM WebSphere Business Integration mySAP.com 适配器连接器可以安装在 UNIX 或 Windows 机器上。连接器由三个需要安装的部件组成:特定于应用程序的连接器组件、SAP 的 RFC 库和任何随产品交付且支持连接器而所需的 SAP 传送文件。

在安装必需的连接器文件之后,您必须下载和安装 Java 连接器(SAPJCo)文件。有关下载 SAPJCo 文件的更多信息,请参阅安装 SAP JCo。有关安装 SAPJCo 文件的更多信息,请参阅安装 SAP JCo

在安装 UNIX 系统上安装

要在 UNIX 系统上安装连接器,运行 IBM WebSphere Business Integration 适配器的安装程序,并选择 IBM WebSphere Business Integration mySAP.com 适配器。表 1 列示在 UNIX 环境中运行的连接器所使用的文件。

表 1. WBIA:UNIX 文件结构
目录/文件名 描述
connectors/SAP/bapi/client 包含 BAPI 模块业务对象处理程序文件的目录
connectors/SAP/bapi/server 包含 RFC 服务器模块业务对象处理程序文件的目录
connectors/SAP/dependencies 包含所有特定于版本的传送文件的目录
connectors/SAPmessages 包含 SAPConnector.txt 文件的目录
connectors/SAP/samples 包含样本 ABAP 对象的目录
connectors/SAP/utilities 包含 generatedfiles 子目录的目录,您可以将 SAPODA 生成的文件放入该子目录
connectors/SAP/CWSAP.jar 连接器类文件
connectors/SAP/start_SAP.sh 连接器的系统启动脚本。

将从通用连接器管理器脚本调用此脚本。产品安装程序为此 连接器管理器脚本创建定制的包装程序。

当连接器与 WebSphere InterChange Server 一起运行时,请使用此定制的包装程序来启动和停止连接器。当连接器与 WebSphere MQ 消息代理一起运行时,请使用此定制的包装程序来仅启动连接器;使用 mqsiremotestopadapter 来停止连接器

repository/SAP 包含 sap_idoccontrol.xsd 文件的目录
/lib 包含 WBIA.jar 文件
/bin 包含 CWConnEnv.sh 文件
/bin/Data/app 包含 SAPConnectorTemplate 文件

您必须从安装程序的“连接器配置”屏幕配置连接器,然后才能使用连接器。从此屏幕:

注:
有关安装连接器组件的更多信息,参阅 WebSphere Business Integration Adapters Installation Guide

在 Windows 系统上安装

要在 Windows 系统上安装连接器,运行 IBM WebSphere Business Integration 适配器的安装程序,并选择 IBM WebSphere Business Integration mySAP.com 适配器。安装程序安装与连接器相关的标准文件。表 2 列示 Windows 环境中安装的标准文件。

表 2. WebSphere Business Integration Adaptor:Windows 文件结构
目录/文件名 描述
connectors\SAP\bapi\client 包含 BAPI 模块业务对象处理程序文件的目录
connectors\SAP\bapi\server 包含 RFC 服务器模块业务对象处理程序文件的目录
connectors\SAP\dependencies 包含所有特定于版本的传送文件的目录
connectors\SAPmessages 包含 SAPConnector.txt 文件的目录
connectors\SAP\samples 包含样本 ABAP 对象的目录
connectors\SAP\CWSAP.jar 连接器类文件
connectors\SAP\start_SAP.bat 用来启动连接器的批处理文件
repository\SAP 包含 CN_SAPSAP.txt 文件的目录
\lib 包含 WBIA.jar 文件
\bin 包含 CWConnEvn.bat 文件

安装程序将特定于应用程序的连接器组件的菜单选项添加至 IBM WebSphere Business Integration 适配器菜单。要以最快的方式启动连接器,请在桌面上创建此组件的快捷方式。

注:
有关安装连接器组件的更多信息,参阅 WebSphere Business Integration Adapters Installation Guide

安装 SAP JCo

在安装了连接器并且已将所有文件安装到适当目录中之后,必须下载并安装 SAP JavaAPI。这是 SAPODA 的必备软件,在使用 SAPODA 生成业务对象定义中对此进行了描述。

SAP 将其 Java API 称为 Java 连接器(SAP JCo)。SAP 的连接器当前支持 SAP JCo V.2.1.3。

  1. 为您的连接器运行所在的操作系统下载 SAP JCo。可从 SAP 的 Web 站点下载 SAP JCo,网址为:http://service.sap.com/connectors。您必须具有 SAPNet 帐户才能访问 SAP JCo(如果您尚未具有该帐户,则联系本地 SAP Basis 管理员)。

    如果无法从 SAP Service Marketplace 下载连接器支持的 SAP JCo 版本,请检查受支持的最新版本 JCo 的当前适配器补丁说明,或者与 IBM 代表联系。

  2. 将已解压缩的下列 SAP JCo 文件复制到您的环境中:

    UNIX:

    从压缩文件中解压缩可执行的 jar 文件(sapjco.jar)和运行时库(librfccmlibsapjcorfc)。

    如果您已遵循在安装 SAPODA 的同一机器上安装适配器的指示信息,则将这些文件从 \connectors\SAP 目录复制到 \ODA\SAP 目录中。如果您在与连接器不同的机器上安装 SAPODA,则在解压缩 SAP JCo 文件之后,将这三个文件复制到 \ODA\SAP 目录中。

    Windows:

    从 zip 文件中,解压缩可执行的 jar 文件(.jar 扩展名)和运行时库(.dll 扩展名)。如果您已遵循在安装 SAPODA 的同一机器上安装适配器的指示信息,则将这些文件从 \connectors\SAP 目录复制到 \ODA\SAP 目录中。

    如果您在与连接器不同的机器上安装 SAPODA,则在解压缩 SAP JCo 文件之后,将这 3 个文件(librfc32.dllsapjco.jarsapjcorfc.dll)复制到 \ODA\SAP 目录中。对于 Windows,librfc32.dll 需要一个或多个 C 运行时 dll。C 运行时 dll 取决于正在使用的 SAP 发行版的版本。

在远程机器上安装连接器

您可以在远程机器上安装和运行连接器。在一台机器上安装集成代理程序,在另一台机器上安装连接器。建议(但不要求)两个机器在同一子网中。

安装多个连接器

要使集成代理程序能够同时处理多个 SAP 业务对象,您可能要为 SAP 系统安装和配置多个连接器组件,并定制每个连接器以处理特定业务对象。

每个连接器组件都可以预订某些业务对象,这取决于它们的类型(如客户或采购订单)。因为您可以让多个连接器来访问同一 SAP 应用程序,所以每个连接器可以处理多个事件并将它们传递至集成代理程序。另外,多个连接器可以同时支持多个业务对象请求。这会增加吞吐量并提高将数据输入和输出 SAP 应用程序的传送速度。

建议您为每个连接器组件选择一个唯一命名约定。例如,如果您正在使用两个连接器,则可以将它们命名为 SAP1ConnectorSAP2Connector

要安装并设置多个连接器组件,执行以下操作:

  1. 按本章所述安装每个连接器。这包括连接器共享库文件。给您安装的每个连接器提供一个唯一名称,并验证您是否具有支持连接器文件。

    如果在同一机器上安装多个连接器,则您仅需要生成共享库文件的副本并重命名它们。您不需要再次安装传送包。

  2. 创建启动脚本的副本:
  3. 生成连接器模板的副本,重命名它以与新的连接器名称匹配,然后将它复制到 repository 目录(如果 IBM WebSphere MQ Integrator 是集成代理程序),或将它装入 IBM WebSphere 资源库(如果 IBM WebSphere InterChange Server 是集成代理程序)。
  4. 生成连接器类文件 CWSAP.jar 的副本并将它重命名为唯一的连接器名称,如 CWSAP1.jar
  5. 初始化连接器配置属性,以便所有连接器轮询同一 SAP 应用程序来获取事件。
  6. 仅当 IBM WebSphere InterChange Server 是集成代理程序时,则添加每个连接器的映射引用。
  7. 指定每个连接器所支持的业务对象。
  8. 仅当 WebSphere InterChange Server 是集成代理程序时,才将协作指定给适当的连接器。目前,一个协作只能由一个连接器进行处理。如果已设置协作,则您可能需要停止它们并接着重新绑定端口。
  9. 如果您要使用 ABAP 扩展模块来进行业务对象处理,则设置您安装的每个连接器的事件分布。使用 IBM CrossWorlds Station(传送包 /nYXR1)。有关为业务对象、集成代理程序和连接器的每个组合设置事件分布的指示信息,请参阅设置事件分布

重要提示:
如果未将业务对象配置为转至特定连接器,则将把该业务对象发送至用于轮询事件的下一个连接器。如果将业务对象配置为转至特定连接器(例如,在测试阶段),但在生产阶段不使用连接器,那么连接器的事件队列将填满。要改正此情况,在“事件分布”窗口中删除连接器/业务对象配置(事务 YXRH)。

Copyright IBM Corp. 1997, 2004