IBM Sterling Connect:Direct 概述和概念

及其术语的概述 IBM® Sterling™ Connect:Direct® 及其与 IBM App Connect Enterprise 时，

IBM Sterling Connect:Direct 是受管文件传输产品，用于在企业之间和企业内部传输文件。

IBM Sterling Connect:Direct与 IBM App Connect Enterprise 结合使用以下术语:
Connect:Direct 服务器
在需要 IBM Sterling Connect:Direct 功能的机器上运行的应用程序。 文件在两个 Connect:Direct 服务器之间传输。
  • 主 Connect:Direct 服务器，也称为 PNODE。
  • 辅助 Connect:Direct 服务器(也称为 SNODE) ，用于接收传输的文件并将该文件放在本地文件系统上。
Connect:Direct-S

Connect:Direct 服务器 ，用于将文件传输到其他 Connect:Direct 服务器。

Connect:Direct-R

Connect:Direct 应用程序，用于连接到 Connect:Direct 服务器 并请求该服务器执行某种形式的处理。 IBM App Connect Enterprise 充当 Connect:Direct-R 以请求传输或接收有关传输的信息。

IBM App Connect Enterprise CDInput 节点

使用 IBM App Connect Enterprise CDInput 节点接收已传输到给定 Connect:Direct 服务器的消息。

如果部署了两个或多个输入节点以在同一 Connect:Direct 服务器上进行侦听，那么只有一个输入节点接收该文件，而哪个输入节点无法确定。 节点之间存在一些分布，这相当于有两个或更多 MQInput 节点在同一队列上进行侦听。

针对同一 Connect:Direct 服务器，可以在不同的流和不同的集成服务器中使用 CDInput 节点。

您可以配置 CDInput 节点，以根据目录名称和文件名仅处理传输到服务器的文件子集。 这允许同一集成服务器中的多个 CDInput 节点接收特定文件，具体取决于所使用的过滤器。

请参阅 IBM Sterling Connect:Direct 概念 ，以获取有关 CDInput 节点， CDOutput 节点和 Connect:Direct 服务器的更多信息。

IBM App Connect Enterprise CDOutput 节点

使用 IBM App Connect Enterprise CDOutput 节点将消息树序列化为文件，然后使用主 Connect:Direct 服务器将其传输到辅助 Connect:Direct 服务器 。 将使用集成服务器中工作路径下的一个目录作为登台区域，直到该文件准备好传输为止。 传输文件后，会将其从登台区域中删除。

Initparm

主 Connect:Direct 服务器 (PNODE) 和辅助 Connect:Direct 服务器 (SNODE) 的启动参数的定义。

Netmap

主 Connect:Direct 服务器与辅助服务器之间的连接的定义。

Processname

为在 IBM Sterling Connect:Direct中运行的进程提供的名称。 可以对多个进程指定同一个名称，每个进程都由进程编号唯一地标识。

请注意， IBM App Connect Enterprise 节点纯粹作为客户机使用 IBM Sterling Connect:Direct Java™ 应用程序接口连接到外部 Connect:Direct 服务器。

缺省情况下， IBM App Connect Enterprise 尝试在缺省端口上连接到本地 Connect:Direct 服务器:
  • 使用 CDOutput 节点发送文件时，或者
  • 要接收要使用 CDInput 节点处理的文件的通知。

要使 CDOutput 和 CDInput 节点能够连接到本地 Connect:Direct 服务器，必须使用 mqsicreential 命令设置用户名和密码。 或者，可以使用 mqsisetdbparms 命令。

IBM Sterling Connect:Direct 概念

CDInput 节点接收已传输到给定 Connect:Direct 服务器的消息。

节点在传输时接收 IBM Sterling Connect:Direct 提供的文件内容和元数据。 一个或多个 CDInput 节点可用于接收同一流，不同流或不同集成服务器中的传输; 对于任何给定传输，只有一个 CDInput 节点接收消息。

您还可以使用基于传输的目录和文件名的过滤器来指定 CDInput 节点可以接收的传输。 处理传输后，有一组选项指示如何处理传输的文件; 有关更多详细信息，请参阅 CDInput 节点。

从 Connect:Direct 服务器 获取所有传输文件并将其写入 IBM MQ 队列的简单流可能包含 CDInput 节点和 MQOutput 节点。

一旦通知 CDInput 节点要处理的文件，它就会以与正常 FileInput 节点相同的方式处理该文件。 发生传输时， Connect:Direct 服务器 管理器会通知 CDInput 节点。 通知消息持久存储在 IBM MQ 上，并且在队列管理器重新启动后仍存在。

Connect:Direct 服务器 管理器是使用 Connect:Direct Server 策略定义和运行的。 此策略用于使用 IBM Sterling Connect:Direct 来管理访问和处理文件 (请参阅 Connect:Direct Server 策略 (CDServer))。

有关文件传输的信息保存在由 IBM MQ控制的存储队列上，因此如果要使用 CDInput 和 CDOutput 节点提供的功能，那么必须在与 IBM App Connect Enterprise 相同的计算机上安装 IBM MQ 。

您还必须创建 CDInput 和 CDOutput 节点所需的系统队列，包括用于存储来自 Connect:Direct 服务器的传输详细信息的两个队列:
  • SYSTEM.BROKER.CD.STATS
  • SYSTEM.BROKER.CD.TRANSFERS

有关创建系统队列的信息，请参阅 在 IBM MQ 队列管理器上创建缺省系统队列。

对于到 Connect:Direct 服务器的每个成功传输，将在 TRANSFER 队列上放置一条消息，该消息用于触发 CDInput 节点来处理文件。 STATS 队列包含 IBM App Connect Enterprise 用于记录 IBM App Connect Enterprise已处理的传输的内部数据。 同时清除这两个队列将导致忽略目前为止发生的所有传输；无需执行重新启动之类的操作。

输入节点不会执行轮询以查找传输，而是在传输到达时触发。 但是， Connect:Direct 服务器 管理器需要轮询事件以通知 CDInput 节点有关传输的信息。 Connect:Direct 服务器 管理器的轮询时间间隔为 1 秒。

CDInput 和 CDOutput 节点通过 Connect:Direct 服务器 管理器来发送和接收来自给定服务器的传输，其名称在节点上设置。 Connect:Direct 服务器 管理器属性是使用 Connect:Direct Server 策略定义的。

Connect:Direct 服务器 管理器组织:
  • 监视 Connect:Direct 服务器 以获取需要由 CDInput 节点处理的传输。
  • 将 CDOutput 节点创建的命令发送到 Connect:Direct 服务器 以执行传输。
在这两种情况下， Connect:Direct 服务器 管理器可用于配置共享文件系统的目录结构，用于发送和接收来自 Connect:Direct 服务器的文件。

目录的高级结构在两台不同的机器上可能不同，您可以在 Connect:Direct 服务器 管理器上定义属性以提供正确的映射。

缺省 策略使用缺省端口连接到本地主机上的 Connect:Direct 服务器 。 您可以将缺省的策略修改成更为复杂的配置（CD 服务器使用不同的端口运行，或者在另一台机器上），或者将节点更改为使用完全不同的策略（设置为使用另一个端口和主机名）。

除了定义连接详细信息以外，您还可以配置其他关键属性，例如暂存目录的位置以及不同机器上的目录之间的映射。

Connect:Direct 服务器 管理器由 CDInput 和 CDOutput 节点根据需要启动和停止，并且不是在部署视图中部署或看到的工件; 其所有功能都由策略中的属性定义。 如果在 IBM App Connect Enterprise 停止 (或 IBM Sterling Connect:Direct 流停止) 时发生传输，那么这些传输不会丢失，并且会在流重新启动后立即进行处理。 所有传输都是持久传输，并且在队列管理器重新启动后仍然存在。

策略安全身份必须对 集成服务器 中的 Connect:Direct 服务器 管理器具有足够的许可权，才能检测发送到 Connect:Direct 服务器的所有传输。 例如: 在 UNIX 系统上， Connect:Direct 中 userfile.cfg 内的用户节必须具有 :cmd.selstats=A:\。 此属性可以显式设置，也可以从更高级别的属性 :admin.auth=y:\ 继承。 如果不存在此许可权，那么 CDInput 节点不会检测或处理由其他用户传输的文件。 有关安全标识的更多信息，请参阅 Connect:Direct Server 策略 (CDServer)中的 安全身份 属性。

IBM App Connect Enterprise 与本地 Connect:Direct 服务器 建立了许多 API 连接，以处理入站传输和请求出站传输。

IBM App Connect Enterprise 针对每个集成服务器的每个策略创建一个 API 连接。 此连接使 CDInput 节点能够处理发送到本地 Connect:Direct 服务器的文件。 如果存在多个与同一 Connect:Direct 服务器相关的策略，那么将建立多个 API 连接。

除了这些连接外，使用 CDOutput 节点的每个消息流实例还会创建一个 API 连接，以向 Connect:Direct 服务器提交传输请求。 如果有多个流包含 CDOutput 节点，或者这些流具有额外定义的实例，那么 IBM App Connect Enterprise 将创建多个 API 连接。 如果所需的 API 连接数超过 Connect:Direct 服务器中配置的最大连接数，那么连接失败将导致 BIP7951E 异常，其中包含以下信息: "Error: Logon failed! Attempted to exceed maximum API connections"。 通过增加 Connect:Direct 服务器的最大客户机连接数来避免此错误。 在 UNIX 上， Connect:Direct 服务器 接受的最大连接数由 api.max.connects 参数控制。 有关此参数以及其他操作系统上的等效设置的更多信息，请参阅 IBM Sterling Connect:Direct 产品文档: http://www.ibm.com/support/knowledgecenter/SS4PJT_5.2.0/cd_52_welcome.html。