管理网关配置

网关管理传输信息,该信息用于将文档路由到中心社区中正确的目的地。出站传输协议决定了在网关配置过程中使用什么信息。有关创建网关的信息,请参阅中心配置指南

必需的网关配置信息

传输类型决定网关设置所需的参数信息。在表 3 中,标有 X 的框需要配置信息,而标有字母 O 的框是可选的。请参阅表 4 以获取网关参数描述。

注:
编辑某些网关配置值的能力会随着用户许可权级别的不同而不同。
表 3. 必需的传输信息
必需的传输信息 HTTP 传输 HTTPS 传输 FTP 传输 FTPS 传输 FTP 脚本传输 文件目录传输 JMS 传输 SMTP 传输

认证..
必需

O

O

自动排队

O

O

O

O

O

O

连接
超时

X

X

X

X

X

FTPS 方式

O

JMS 工厂
名称

X

JMS JNDI
工厂
名称

X

JMS 消息

X

JMS 消息
类型

O

JMS 队列
名称

X

锁定用户

O

数量
线程

X

X

X

X

X

X

密码

O

O

O

O

O

O

O

O

提供程序
URL 包

O

重试计数

X

X

X

X

X

X

X

X

重试时间间隔

X

X

X

X

X

X

X

X

服务器 IP

X

目标 URI

X

X

X

X

X

X

X

用户标识

O

用户名

O

O

O

O

O

O

O

验证
客户机 IP

O

O

O

O

验证
客户机 SSL
证书

O

注:
  1. 如果网关的“需要认证”选项处于“打开”状态,并且提供了用户名和密码,那么网关将把用户名和密码传递到与之相连的外部系统,以进行文档传递。网关不会强制进行认证,它只将这些认证凭证传递到它尝试连接的系统。对于 JMS 网关,用户名和密码用作 JMS 队列连接工厂的 JNDI 查找的凭证。请注意,当基于文件的 JNDI 用于连接到 JMS 队列时,Websphere MQ 上的 JMS 不会强制进行 JNDI 认证。
  2. 对 FTPS 认证来说用户名和密码是必需的,除非您正在协商的 FTPS 服务器根据已提供的客户机证书对用户进行映射。与 FTPS 服务器管理员核实以了解实现的详细信息。

查看和编辑网关

要查看和编辑网关,请遵循以下步骤:

  1. 单击帐户管理 > 概要文件 > 网关
  2. 单击访问列下的联机脱机以更改对网关的访问。
  3. 单击状态列中的启用禁用以更改网关的状态。
  4. 单击“查看详细信息”图标以查看网关的详细信息。
  5. 单击“编辑”图标。
  6. 在“网关详细信息”窗口上,编辑在“表 4”中描述的网关参数。
  7. 单击保存

    您也可以通过单击删除来删除网关。

    表 4. 网关参数描述
    参数 描述

    需要认证

    如果启用,则用户名和密码是通过 JMS 或 SMTP 消息提供的。

    自动排队

    如果启用了该参数,当网关处于脱机状态时,会将文档放置在临时资源库中。如果禁用了该参数,并且网关处于脱机状态,则无法路由文档,且会发生错误。

    基于日历的调度

    如果选择该选项,则会根据所选的调度处理与该网关关联的文档。

    配置点处理程序

    用于指定哪些处理程序用于前处理,哪些用于后处理。

    连接超时

    套接字将保持打开状态而无流量的秒数。缺省值是 120(2 分钟)。

    描述

    网关的可选描述。

    FTPS 方式

    选择“是”或“否”以控制是否使用安全连接。

    网关名

    用于标识网关的名称。

    注:网关名是用户定义的自由格式字段。尽管网关名不需要唯一性,但用户应当对各个网关使用不同的名称,以避免可能的冲突。

    基于时间间隔的调度

    如果选择该选项,则网关会以指定的时间间隔处理文档。

    JMS 工厂名

    Java(TM) 类的名称,JMS 提供程序将使用它来生成与 JMS 队列的连接。

    JMS JNDI 工厂名

    用于连接到名称服务的工厂名。

    JMS 消息类

    消息类。

    JMS 消息类型

    JMS 消息的类型。

    JMS 队列名

    存储 JMS 消息的队列名。

    锁定重试时间间隔(以秒为单位)

    FTP 脚本组件在两次重试锁定尝试之间等待的时间长度。

    锁定重试计数

    FTP 脚本组件尝试获取锁定的次数。

    锁定用户

    选择“是”或“否”以控制是否允许并发连接。

    最大锁定时间(以秒为单位)

    FTP 脚本组件保持锁定的最长时间。在最长时间后,锁定会被返回给数据库。

    最大队列时间(以秒为单位)

    FTP 脚本组件在锁定请求队列中的最长时间。当它被锁定请求拒绝时,被放入锁定请求队列中。

    线程数

    分配用于路由文档的线程数。缺省值是 3。只有中心管理员用户才能使用该参数。

    联机/脱机

    表明网关处于联机状态还是脱机状态。如果处于脱机状态,则将文档排队,直到网关处于联机状态。

    密码

    通过参与者防火墙进行安全访问的密码。

    提供程序 URL 包

    Java 用来理解 JMS 上下文 URL 的类或 JAR 文件的名称。

    重试计数

    系统在文档发送失败前尝试发送的最大次数。缺省值是 3。

    重试时间间隔

    网关在两次重试尝试之间等待的时间。缺省值是 300(5 分钟)。

    脚本文件

    包含 FTP 命令的 FTP 脚本。

    服务器 IP

    服务器 IP 地址

    状态

    表明网关处于启用状态还是禁用状态。如果处于禁用状态,则无法处理通过网关传递的文档。

    目标 URI

    参与者的统一资源标识(URI)。

    线程数

    将同时被处理的文档数。

    传输方法

    路由文档的协议(请参阅必需的网关配置信息)。

    使用唯一的文件名

    当目标位置收到文档时会创建唯一的文件名。初始文件名存储在数据库中。

    用户定义的属性

    对于 FTP 脚本文件,用户可以添加自己的属性,这些属性可以在控制台中定义。这些属性在网关中读取并替换到脚本文件中。

    用户标识

    访问 FTP 服务器所必需的。

    用户名

    通过参与者防火墙进行安全访问的用户名。

    验证客户机 IP

    在处理文档前验证发送方的 IP 地址。与选作连接源网关的网关一起使用。

    验证客户机 SSL 证书

    在处理文档前,依据与文档关联的业务标识来验证发送参与者的数字证书。与选作连接源网关的网关一起使用。

查看和编辑缺省网关

要查看为系统配置的缺省网关并编辑它们,请遵循以下步骤:

  1. 单击帐户管理 > 概要文件> 网关
  2. 单击窗口右上角的查看缺省网关。控制台会显示所有网关类型及其关联网关的列表。
  3. 要查看有关缺省网关的信息,请单击网关旁边的“查看详细信息”图标。
  4. 根据需要编辑信息,然后单击保存

删除网关配置

如果您不再需要某个网关配置,则请遵循下面的步骤删除它。在您删除网关配置前不会出现警告消息。因此,在删除网关配置前请务必确保您已不再需要该配置。

  1. 单击帐户管理 > 概要文件> 网关
  2. 单击要删除的网关旁边的“查看详细信息”图标。
  3. 单击“编辑”图标。
  4. 单击删除

上载传输

使用以下过程上载传输。

  1. 单击帐户管理 > 概要文件> 网关
  2. 选择管理传输类型
  3. 单击浏览,然后选择传输。
  4. 选择是否将新传输落实到数据库。
  5. 选择是否覆盖现有数据。
  6. 单击上载

删除传输方法

如果您不再需要某个传输方法,则使用下面的步骤删除它。

  1. 单击帐户管理 > 概要文件> 网关
  2. 选择管理传输类型
  3. 单击已列出传输旁边的“删除”图标。

传输重试和网关重试

如果将文档传递到参与者网关时失败,那么 WebSphere Partner Gateway 会尝试再次传递文档。每次尝试被称为重试。在 WebSphere Partner Gateway 中重试功能有两个级别:传输和网关。

传输重试

传输重试是内置的、低级别的重试,无论网关规范如何,始终都会采用。采取低级重试的原因是:瞬态故障是进行传递的网络(特别是因特网)所固有的。因此,传递系统被设计成自动重试,而无须用户显式地定义重试参数。传输重试次数(bcg.delivery.gwTransportMaxRetries)和重试间的时间间隔(bcg.delivery.gwTransportRetryInterval)是在文档管理器的 bcg.properties 文件中定义的,且适用于所有网关。缺省值是重试三次,时间间隔为三秒。

网关重试次数(又称为文档重试次数)

网关重试参数(所允许的重试次数和重试间的时间间隔)是由用户在网关属性中配置的。通常,网关重试时间间隔比内置的传输重试时间间隔长。目的是让用户有足够的时间来纠正妨碍传递的问题。例如,目的地 Web 服务器可能已当机,或者目的地 URL 可能不正确。设置参数值需要用户为每个网关都分配值。

对于每个(用户定义的)网关重试,WebSphere Partner Gateway 将自动执行传输重试。例如,如果指定了三次网关重试,则系统重试模式是:

每次失败的传递尝试都会生成一个警告事件,在社区控制台中可看到该事件。

转发代理支持

对于 HTTP 和 HTTPS 传输,可以设置转发代理支持,以便通过一个已配置的代理服务器发送文档。 通过 WebSphere Partner Gateway,可以设置下列支持类型:

设置转发代理之后,通过使之成为缺省转发代理网关,可以使它在传输中全局可用(例如,所有 HTTP 网关都使用该转发代理)。 然后,对于每个单独网关,可以选择不使用缺省转发代理服务器或者可以选择使用其他转发代理服务器。 请参阅中心配置指南, 以获取有关转发代理支持的更多信息。

Copyright IBM Corp. 2003, 2005