设置参与者的网关

WebSphere Business Integration Connect 使用网关来将文档路由到其正确的目的地。出站传输协议决定了在网关配置期间使用哪些信息。

参与者网关支持的传输方法(缺省情况下)包括下列各项:

您还可以指定在创建网关过程中上载的用户定义传输方法。

作为中心管理员,您可以设置参与者的网关,参与者也可以自己执行该任务。在本章中,您将看到如何为参与者执行该任务。

创建网关

要创建网关,请使用下列过程。

  1. 单击帐户管理 > 概要文件 > 社区参与者
  2. 输入搜索条件,然后单击搜索,或者不输入任何搜索条件而单击搜索,以显示所有参与者的列表。
  3. 单击放大镜图标以显示参与者的概要文件。
  4. 单击网关
  5. 单击创建。控制台显示“网关详细信息”屏幕。
  6. 如果您希望上载用户定义的传输方法,请执行下列步骤。否则,转至步骤 7。
    1. 单击导入传输类型
    2. 输入定义传输方法的 XML 文件名(或使用浏览,浏览至该文件)。
    3. 单击上载

    注意: 从网关列表,您还可以删除用户定义的传输类型。不能删除由 WebSphere Business Integration Connect 提供的传输方法。在使用用户定义的传输方法创建某个网关后,也不能删除该传输方法。

  7. 单击创建
  8. 输入标识网关的名称。这是必需字段。
  9. 指出网关的状态,这是可选的。已启用是缺省值。已启用网关已经为准备好送文档。已禁用的网关不能发送文档。
  10. 指出网关是联机还是脱机,这是可选的。缺省值是联机
  11. 输入网关的描述,这是可选的。

以上所示的步骤对于所有网关都是通用的。但是,所选的网关不同,屏幕上所显示的选项也不同。下面是配置网关时所要采取的其它步骤,取决于其传输类型。

请注意,在提供了特定于传输方法的信息以定义网关之后,您还可以修改该网关的配置点。

创建 HTTP 网关

要创建 HTTP 网关:

  1. 目标 URI 字段中,输入将传递文档的 URI。这个字段是必需的。

    格式是:http://<servername>:<optional port>/<path>

    该格式的示例是:

    http://anotherwbicserver.ibm.com:57080/bcgreceiver/Receiver
     
  2. 如果访问安全 HTTP 服务器需要用户名和密码,则输入用户名和密码(这是可选的)。
  3. 重试计数字段中,输入您希望网关在发送文档失败之前所尝试的次数。缺省值是 3。
  4. 重试时间间隔字段中,输入网关在再次尝试发送文档前将等待的时间。缺省值是 300 秒。
  5. 线程数字段中,输入将同时处理的文档数。 缺省值是 3。
  6. 如果您希望在处理文档之前先验证发送方的 IP 地址,则在验证客户机 IP 字段中,选择。否则就选择。 缺省值是
  7. 如果您希望在由于到达了重试次数而要发生传递失败时(自动)将网关设为脱机,则在自动排队字段中,选择。否则就选择。 缺省值是

    当您选择“自动排队”时,所有文档都排在队列中,直到手工将网关设为联机为止。

  8. 连接超时字段中,输入在没有流量的情况下套接字将保持打开状态的秒数。 缺省值是 120 秒。
  9. 如果您想要配置网关的预处理或后处理步骤,请转至修改网关的配置点。否则,请单击保存

创建 HTTPS 网关

要创建 HTTPS 网关:

  1. 目标 URI 字段中,输入将传递文档的 URI。这个字段是必需的。

    格式是:https://<servername>:<optional port>/<path>

    例如:

    https://anotherwbicserver.ibm.com:57443/bcgreceiver/Receiver
     
  2. 如果访问安全 HTTP 服务器需要用户名和密码,则输入用户名和密码(这是可选的)。
  3. 重试计数字段中,输入您希望网关在发送文档失败之前所尝试的次数。缺省值是 3。
  4. 重试时间间隔字段中,输入网关在再次尝试发送文档前将等待的时间。缺省值是 300 秒。
  5. 线程数字段中,输入将同时处理的文档数。 缺省值是 3。
  6. 如果您希望在处理文档之前先验证发送方的 IP 地址,则在验证客户机 IP 字段中,选择。否则就选择。缺省值是
  7. 如果您希望依据与文档关联的 DUNS 号来验证发送方合作伙伴的数字证书,则在验证客户机 SSL 证书字段中选择。缺省值是
  8. 如果您希望在由于到达了重试次数而要发生传递失败时(自动)将网关设为脱机,则在自动排队字段中,选择。否则就选择。 缺省值是

    当您选择“自动排队”时,所有文档都排在队列中,直到手工将网关设为联机为止。

  9. 连接超时字段中,输入在没有流量的情况下套接字将保持打开状态的秒数。 缺省值是 120 秒。
  10. 如果您想要配置网关的预处理或后处理步骤,请转至修改网关的配置点。否则,请单击保存

创建 FTP 网关

要创建 FTP 网关:

  1. 目标 URI 字段中,输入将传递的 URI。这个字段是必需的。

    格式是:ftp://<ftp servername>: <portno>

    例如:

    ftp://ftpserver1.ibm.com:2115
     

    如果不输入端口号,则使用标准的 FTP 端口。

  2. 如果访问 FTP 服务器需要用户名和密码,则输入用户名和密码(可选)。
  3. 重试计数字段中,输入您希望网关在发送文档失败之前所尝试的次数。缺省值是 3。
  4. 重试时间间隔字段中,输入网关在再次尝试发送文档前将等待的时间。缺省值是 300 秒。
  5. 线程数字段中,输入将同时处理的文档数。 缺省值是 3。
  6. 如果您希望在处理文档之前先验证发送方的 IP 地址,则在验证客户机 IP 字段中,选择。否则就选择。缺省值是
  7. 如果您希望在由于到达了重试次数而要发生传递失败时(自动)将网关设为脱机,则在自动排队字段中,选择。否则就选择。缺省值是

    当您选择“自动排队”时,所有文档都排在队列中,直到手工将网关设为联机为止。

  8. 连接超时字段中,输入在没有流量的情况下套接字将保持打开状态的秒数。 缺省值是 120 秒。
  9. 如果您想要配置网关的预处理或后处理步骤,请转至修改网关的配置点。否则,请单击保存

创建 SMTP 网关

要创建 SMTP 网关:

  1. 目标 URI 字段中,输入将传递文档的 URI。这个字段是必需的。

    格式是:mailto:<user@servername>

    例如:

    mailto:admin@anotherwbicserver.ibm.com
     
  2. 如果访问 SMTP 服务器需要用户名和密码,则输入用户名和密码(这是可选的)。
  3. 重试计数字段中,输入您希望网关在发送文档失败之前所尝试的次数。缺省值是 3。
  4. 重试时间间隔字段中,输入网关在再次尝试发送文档前将等待的时间。缺省值是 300 秒。
  5. 线程数字段中,输入将同时处理的文档数。 缺省值是 3。
  6. 如果您希望在处理文档之前先验证发送方的 IP 地址,则在验证客户机 IP 字段中,选择。否则就选择。缺省值是
  7. 如果您希望在由于到达了重试次数而要发生传递失败时(自动)将网关设为脱机,则在自动排队字段中,选择。否则就选择。缺省值是

    当您选择“自动排队”时,所有文档都排在队列中,直到手工将网关设为联机为止。

  8. 需要认证字段中,指出是否随文档提供用户名和密码。缺省值是
  9. 连接超时字段中,输入在没有流量的情况下套接字将保持打开状态的秒数。 缺省值是 120 秒。
  10. 如果您想要配置网关的预处理或后处理步骤,请转至修改网关的配置点。否则,请单击保存

创建 JMS 网关

要创建 JMS 网关:

  1. 目标 URI 字段中,输入将传递文档的 URI。这个字段是必需的。

    对于 WebSphere MQ JMS,目标 URI 的格式如下:

    file:///<user_defined_MQ_JNDI_bindings_path>
     

    例如:

    file:///opt/JNDI-Directory
     

    该目录包含了用于基于文件的 JNDI“.bindings”文件。该文件表明 WebSphere Business Integration Connect 如何将文档路由到既定的目的地。

    对于参与者网关,参与者可能会提供 『.bindings』 文件。内部 JMS 网关(即社区管理者网关)可以使用 JMSAdmin 生成,如准备配置中心所讨论的。

    这个字段是必需的。

  2. 如果访问 JMS 队列需要用户名和密码,则输入用户名和密码(这是可选的)。
  3. 重试计数字段中,输入您希望网关在发送文档失败之前所尝试的次数。缺省值是 3。
  4. 重试时间间隔字段中,输入网关在再次尝试发送文档前将等待的时间。缺省值是 300 秒。
  5. 线程数字段中,输入将同时处理的文档数。 缺省值是 3。
  6. 如果您希望在处理文档之前先验证发送方的 IP 地址,则在验证客户机 IP 字段中,选择。否则就选择。缺省值是
  7. 如果您希望在由于到达了重试次数而要发生传递失败时(自动)将网关设为脱机,则在自动排队字段中,选择。否则就选择。缺省值是

    当您选择“自动排队”时,所有文档都排在队列中,直到手工将网关设为联机为止。

  8. 需要认证字段中,指出是否随文档提供用户名和密码。缺省值是
  9. JMS 工厂名字段中,输入 JMS 提供程序用于连接至 JMS 队列的 Java 类的名称。这个字段是必需的。
  10. JMS 消息类字段中,输入消息类。可选择任何有效的 JMS 消息类,例如 TextMessage 或 BytesMessage。这个字段是必需的。
  11. JMS 消息类型字段中,输入消息的类型。这是可选字段。
  12. 提供程序 URL 包字段中,输入 Java 用来解析 JMS 上下文 URL 的类(或 JAR 文件)的名称。这个字段是可选的。如果您未指定值,则使用到绑定文件的文件系统路径。
  13. JMS 队列名字段中,输入用于接收文档的 JMS 队列的名称。这个字段是必需的。
  14. JMS JNDI 工厂名字段中,输入用于连接至名称服务的工厂名。这个字段是必需的。如果您象准备配置中心中描述的那样设置了您的 JMS 配置,则 com.sun.jndi.fscontext.RefFSContextFactory 可能是您将要使用的一个值。
  15. 连接超时字段中,输入在没有流量的情况下套接字将保持打开状态的秒数。缺省值是 120 秒。
  16. 如果您希望配置网关的预处理或后处理步骤,请转至修改网关的配置点。否则,请单击保存

创建文件目录网关

要创建文件目录网关:

  1. 目标 URI 字段中,输入将传递文档的 URI。这个字段是必需的。

    在 UNIX 系统和 Windows 系统中,与 WebSphere Business Integration Connect 安装在同一驱动器上的文件目录的格式是:file:///<path to target directory>

    例如:

    file:///localfiledir 
     

    其中 localfiledir 是根目录之外的目录。

    在 Windows 系统中,与对 WebSphere Business Integration Connect 安装在不同驱动器上的文件目录的格式是:file:///<drive letter>:/<path>

  2. 重试计数字段中,输入您希望网关在发送文档失败之前所尝试的次数。缺省值是 3。
  3. 重试时间间隔字段中,输入网关在再次尝试发送文档前将等待的时间。缺省值是 300 秒。
  4. 线程数字段中,输入将同时处理的文档数。缺省值是 3。
  5. 如果您希望在处理文档之前先验证发送方的 IP 地址,则在验证客户机 IP 字段中,选择。否则就选择。缺省值是
  6. 如果您希望在由于到达了重试次数而要发生传递失败时(自动)将网关设为脱机,则在自动排队字段中,选择。否则就选择。缺省值是

    当您选择“自动排队”时,所有文档都排在队列中,直到手工将网关设为联机为止。

  7. 如果您希望配置网关的预处理或后处理步骤,请转至修改网关的配置点。否则,请单击保存

创建 FTPS 网关

要创建 FTPS 网关:

  1. 目标 URI 字段中,输入将传递文档的 URI。这个字段是必需的。

    格式是:ftp://<ftp servername>: <portno>

    例如:

    ftp://ftpserver1.ibm.com:2115
     

    如果不输入端口号,则使用标准的 FTP 端口。

  2. 如果访问安全 FTP 服务器需要用户名和密码,则输入用户名和密码(这是可选的)。
  3. 重试计数字段中,输入您希望网关在发送文档失败之前所尝试的次数。缺省值是 3。
  4. 重试时间间隔字段中,输入网关在再次尝试发送文档前将等待的时间。缺省值是 300 秒。
  5. 线程数字段中,输入将同时处理的文档数。缺省值是 3。
  6. 如果您希望在处理文档之前先验证发送方的 IP 地址,则在验证客户机 IP 字段中,选择。否则就选择。缺省值是
  7. 如果您希望在由于到达了重试次数而要发生传递失败时(自动)将网关设为脱机,则在自动排队字段中,选择。否则就选择。缺省值是

    当您选择“自动排队”时,所有文档都排在队列中,直到手工将网关设为联机为止。

  8. 如果您希望配置网关的预处理或后处理步骤,请转至修改网关的配置点。否则,请单击保存

注意: 要使出站 FTPS 网关正常工作,您至少需要在中心操作者的概要文件下装入 FTPS 服务器的 CA 证书,用其作为根证书。(使用帐户管理 > 概要文件 > 证书来装入证书。)当您装入该证书后,WebSphere Business Integration Connection 将信任 FTPS 服务器的证书。

如果 FTPS 服务器还要求客户机认证,则您必须在中心操作者的概要文件下装入客户机证书,用其作为 SSL 证书。WebSphere Business Integration Connect 为 FTPS 服务器提供了该证书。必须设置参与者的 FTPS 服务器以使之信任您的证书。

有关安全性的更多信息,请参阅设置入站和出站交换的安全性

修改网关的配置点

正如简介所描述的,您可以修改网关的两个处理点 - 预处理和后处理。

要将用户编写的处理程序应用于这些配置点,首先必须如上载用户定义的处理程序所描述的那样上载该处理程序。您还可以使用系统提供的处理程序,这类处理程序已处于可用状态,无须进行上载。

要修改配置点:

  1. 如果您正在创建网关,请继续执行步骤 6。如果您正在更新网关配置,请单击帐户管理 > 概要文件 > 社区参与者
  2. 输入搜索条件,然后单击搜索,或者不输入任何搜索条件而单击搜索,以显示所有参与者的列表。
  3. 单击放大镜图标以显示参与者的概要文件。
  4. 单击网关
  5. 单击放大镜图标以显示网关,然后单击编辑图标以编辑该网关。
  6. 配置点处理程序列表中选择要修改的配置点。可修改的网关配置点是预处理后处理
  7. 对于您希望修改的每个处理程序,请执行下面的一个或多个步骤。
    1. 通过从可用处理程序列表中选择处理程序,然后单击添加,可以添加处理程序。该处理程序被移动到已配置处理程序列表。

      注意: WebSphere Business Integration Connect 不支持缺省的网关处理程序。可用列表中的处理程序只是您上载的那些处理程序。

    2. 通过从已配置处理程序列表中选择处理程序,然后单击除取,可以除取某个处理程序。该处理程序被移动到可用处理程序列表。
    3. 通过选择处理程序,然后单击上移下移按钮,可以重新排列处理程序的使用顺序。
    4. 通过从已配置列表中选择某个处理程序,然后单击配置,可对该处理程序进行配置。这样将显示可配置属性的列表。
  8. 单击保存

Copyright IBM Corp. 1997, 2004