简介

提供修补程序,使 BizTalk Adapter for TIBCO EMS 支持 Microsoft BizTalk Server 2006 R2 Service Pack 1 (SP1) 和 BizTalk Server 2009 中的有序消息传送和安全套接字层 (SSL) 连接。

更多信息

重要说明

  1. 请确保正确安装和配置 Tibco 服务器。

  2. 请确保将 TIBCO EMS C# API (Tibco.ems.dll) 添加到全局程序集缓存 (GAC) 。 为此,请使用 Gacutil.bat 应用程序。 有关详细信息,请参阅"参考"部分。

  3. 从版本 4.4 开始,Tibco 支持 SSL。

启用对有序邮件传递的支持

应用修补程序后,BizTalk Adapter for TIBCO EMS 传输属性对话框中提供了两个新选项,可用于启用对有序消息传送的支持。 两个选项是"有序交付"和"StopPollingOnFailure"。 默认情况下,"订购交付"选项设置为 False,"StopPollingOnFailure"选项设置为 True。

已订购的送达选项

将"有序传递"选项设置为 True 时,邮件预期会从 Tibco 服务器轮询并提交到BizTalk Server。 BizTalk 服务器接收消息的顺序与将消息发送到 Tibco 服务器的顺序相同。

请注意,Tibco 队列中优先级较高的消息是预期会先于优先级较低的消息轮询并提交到 BizTalk 的消息。 可以使用消息优先级选项的发送器配置属性更改消息的优先级。

StopPollingOnFailure 选项

此选项仅适用于"订购交付"选项设置为 True 的情况。 此选项用于决定是否在将消息提交到 BizTalk 失败时继续或停止轮询。 如果 StopPollingOnFailure 选项设置为 True 且未将消息提交到 BizTalk,则使用 BizTalk Adapter for TIBCO EMS 的接收端口会停止从 Tibco 服务器对消息进行其他轮询,然后禁用该端口。 如果 StopPollingOnFailure 选项设置为 False,则即使向 BizTalk 提交消息失败,轮询也不停止。 在这种情况下,失败的消息将移到挂起的队列。

注意,当 StopPollingOnFailure 选项设置为 False 时,无法提交到 BizTalk 的消息将移到挂起的队列。 此行为会导致订单丢失。 因此,建议将此选项设置为 True。

启用 SSL 连接支持

应用修补程序后,BizTalk Adapter for TIBCO EMS 传输属性对话框中提供了三个新选项,可用于启用 SSL 连接支持。 三个选项如下所示:

  • UseSSL

  • SSLTargetHostName

  • SSLClientSubjectDN

注意:默认情况下,UseSSL 选项设置为 False,SSLTargetHostName 选项和 SSLClientSubjectDN 选项为空。

重要内容:若要支持 SSL 连接,必须在 Tibco 服务器和 BizTalk 服务器上配置一些必要的设置。 有关详细信息,请参阅"支持 SSL 连接所需的设置"部分。

UseSSL 选项

如果 UseSSL 选项设置为 False,适配器将连接到 TCP 端口上的 Tibco 服务器。 如果 UseSSL 选项设置为 True,适配器将连接到 SSL 端口上的 Tibco 服务器。

请注意,Tibco 服务器在服务器连接定义部分下的"服务器名称"字段中配置。 TCP 端口和 SSL 端口在服务器连接定义部分下的"端口号"字段中配置。

SSLTargetHostName 选项确保 Tibco 服务器的受信任根证书安装在为
BizTalk 主机实例配置其帐户的用户的"受信任的根证书颁发机构"存储
中。

SSL ClientSubjectDN 选项

:如果需要双向 SSL,此选项是必需的。 例如,Tibco 服务器要求客户端提供证书。 可以在 Tibemsd.conf 文件的 ssl_require_client_cert 属性中启用或禁用证书。 此值对应于客户端证书的可分辨名称。 确保 Tibco 服务器的受信任根证书安装在其帐户已配置为 BizTalk 主机实例的用户的"受信任的根证书颁发机构"存储中。

下面是此选项的示例值:

E=client@testcompany.com、CN=client、OU=client Unit、O=Test Company、L=us-english、S=California、C=US

支持 SSL 连接所需的设置

SSL 是一种提供安全身份验证的协议,通过 Internet 或 Intranet 传输加密数据。 客户端和适配器 (与 Tibco) 之间的 SSL 握手可通过以下两种方式发生:

  • 单向 SSL:客户端无需向服务器提供证书。

  • 双向 SSL:客户端必须向服务器提供 CA 的证书。

配置单向 SSL


在 Tibco 服务器上,更改 Tibemsd.conf 文件。 为此,请按照下列步骤操作:

  1. 禁用 ssl_require_client_cert 属性。 为此,请更改此设置,以便它如下所示
    :ssl_require_client_cert = 禁用

  2. 将 ssl_server_identity 属性设置为指向服务器证书,将 ssl_server_key 属性设置为使用正确的 SSL 密钥,将 ssl_password 属性设置为使用正确的 SSL 密码。 为此,请更改这些设置,使其如下所示
    :ssl_server_identity = server.cert.pem
    ssl_server_key = server.key.pem ssl_password =<密码>请注意请确保


    .pem 文件在设置的路径中可用。

  3. 保存 Tibemsd.conf 文件并启动 Tibco EMS 服务器。

在 BizTalk 服务器上,在为 BizTalk 主机实例配置帐户的用户的"受信任的根证书颁发机构"存储中安装 Tibco 服务器的受信任根证书。 然后,尝试使用 Tibco 适配器连接到 Tibco 服务器。

配置双向 SSL

在 Tibco 服务器上,更改 Tibemsd.conf 文件。 为此,请按照下列步骤操作:

  1. 启用 ssl_require_client_cert 属性。 为此,请更改此设置,以便它如下所示:ssl_require_client_cert =
    enable

  2. 将 ssl_server_identity 属性设置为指向服务器证书,将 ssl_server_key 属性设置为使用正确的 SSL 密钥,将 ssl_password 属性设置为使用正确的 SSL 密码。 为此,请更改这些设置,使其如下所示
    :ssl_server_identity = server.cert.pem
    ssl_server_key = server.key.pem ssl_password =<密码>注意:请确保


    .pem 文件在设置的路径中可用。

  3. 将 ssl_server_trusted 属性设置为指向客户端证书 CA 的根证书。 为此,请更改此设置,使其如下所示:ssl_server_trusted
    = client.root.cert.pem

    注意:请确保 .pem 文件在设置的路径中可用。

  4. 保存 Tibemsd.conf 文件并启动 Tibco EMS 服务器

在 BizTalk 服务器上,在为 BizTalk 主机实例配置帐户的用户的"受信任的根证书颁发机构"存储中安装 Tibco 服务器的受信任根证书。 在当前用户的"受信任的根证书颁发机构"存储中安装客户端证书的 CA 证书。 在当前用户的"个人"存储中安装客户端证书。 然后,尝试使用 Tibco 适配器连接到服务器。

修补程序信息

对于 BizTalk Server 2006 R2 SP1

此修补程序包含在 2006 R2 SP1 的累积更新包 3 BizTalk Server包 3 中。

若要详细了解如何获取累积更新包,请单击以下文章编号以查看 Microsoft 知识库中的文章

:2286501累积更新包 3 for BizTalk Server 2006 R2 Service Pack 1。有关

BizTalk Server 2006 R2 SP1 修补程序详细信息, 单击以下文章编号以查看 Microsoft 知识库中的文章

:BizTalk Server 2006 R2 Service Pack 1 中包含的 Microsoft BizTalk Server 974563修补程序列表

2009 BizTalk Server 2009 年

2009 年 9 月 2 日累积更新包 2 BizTalk Server修补程序。

若要详细了解如何获取累积更新包,请单击以下文章编号以查看 Microsoft 知识库中的文章

:2497794 Cumulative update package 2 for BizTalk Server 2009

现在 Microsoft 提供了受支持的修补程序。 但是,它旨在仅更正本文中所述的问题。 仅应用于遇到此特定问题的系统。 此修补程序可能会收到其他测试。 因此,如果你未受到此问题的严重影响,我们建议你等待下一次包含此修补程序的软件更新。

若要立即解决此问题,请联系 Microsoft 客户支持服务获取修补程序。 有关 Microsoft 客户支持服务电话号码的完整列表和有关支持成本的信息,请访问以下 Microsoft 网站:

http://support.microsoft.com/contactus/?ws=support注意:在特殊情况下,如果 Microsoft 支持专业人员确定特定更新将解决你的问题,则通常针对支持呼叫产生的费用可能会被取消。 通常的支持费用将应用于其他支持问题和不符合特定更新条件的问题。

先决条件

必须安装 Microsoft BizTalk Server 2009 和 Microsoft BizTalk 企业应用程序适配器 (也称为 BizTalk LOB Adapter) 应用此修补程序。

重启要求

应用修补程序后,无需重启计算机。

修补程序替换信息

此修补程序不会替换任何其他修补程序。

文件信息

此修补程序的英文版具有下表中列出的文件属性(或较新的文件属性)。 这些文件的日期和时间按协调世界时 (UTC) 列出。 在查看文件信息时,文件时间将转换为本地时间。 要了解 UTC 与本地时间之间的时差,请使用“控制面板”中“日期和时间”项中的“时区”选项卡。

文件名

文件版本

文件大小

日期

时间

平台

Btcore.dll

1.0.5020.12

2,129,744

2010 年 4 月 26 日

12:16

x86

Microsoft.biztalk.adapters.bizutil.dll

1.0.5020.12

163,720

2010 年 4 月 26 日

12:16

x86

Microsoft.biztalk.adapters.corereceiver.dll

1.0.5020.12

33,680

2010 年 4 月 26 日

12:16

x86

Microsoft.biztalk.adapters.coretransmitter.dll

1.0.5020.12

39,320

2010 年 4 月 26 日

12:16

x86

Microsoft.biztalk.adapters.tibcoems.dll

1.0.5020.12

88,968

2010 年 4 月 26 日

12:16

x86

状态

Microsoft 已确认这是在“适用范围”部分中列出的 Microsoft 产品存在的问题。

参考

有关 TIBCO 企业消息服务的信息,请访问 MSDN Microsoft 开发人员网络 () :

TIBCO 企业消息服务要求和限制有关有序传递邮件的信息,请访问以下 MSDN 网站:

邮件的有序传递有关这些修补程序BizTalk Server,请单击以下文章编号,在 Microsoft 知识库中查看该文章:

2003907 有关 BizTalk Server 修补程序的信息

Need more help?

Expand your skills
Explore Training
Get new features first
Join Microsoft Insiders

Was this information helpful?

How satisfied are you with the translation quality?
What affected your experience?

Thank you for your feedback!

×