安装 Azure BizTalk 服务 SDK

更新时间: 2015年7月

安装 Microsoft Azure BizTalk Services 的步骤。Microsoft Azure BizTalk Services 具有三个主要组件:开发人员 SDK、BizTalk Adapter Service运行时和 Windows PowerShell cmdlet 工具。本主题内容:

所述 BizTalk 服务 SDK 组件

软件要求

安装 BizTalk 服务 SDK

将 BizTalk 服务 SDK 升级到最新版本

迁移 BizTalk 适配器服务运行时环境

删除 BizTalk 服务 SDK

下表列出 BizTalk 服务 SDK 中的组件,并列出了获取的内容:

 

组件 详细信息

开发人员 SDK

下载 BizTalk 服务 SDK

下载架构

在安装有 Visual Studio 的开发计算机上,Microsoft Azure BizTalk Services SDK 安装用于开发和设计 BizTalk 服务 应用程序。开发人员 SDK 自动安装:

  • Visual Studio 中的 BizTalk 服务项目模板,用于创建 XML 桥接。

  • Visual Studio 中的 BizTalk 服务项目项目模板,用于创建转换和架构。

  • BizTalk 适配器包 2013:如果 BizTalk 服务应用程序要向本地业务线 (LOB) 系统(包括 SAP、SQL Server、Siebel、Oracle 数据库或 Oracle E-Business Suite)发送消息,则使用该组件。

    note备注
    安装 BizTalk 适配器包 32 位和 64 位版本。

  • Microsoft WCF LOB 适配器 SDK:Microsoft BizTalk 适配器包 需要该组件。

  • Visual Studio 中的 BizTalk Adapter Service服务器资源管理器插件,用于创建 BizTalk Adapter Service使用的 LOB 中继和 LOB 目标。

Runtime

使用 Internet Information Services (IIS),运行时计算机管理 Microsoft Azure BizTalk Services 应用程序与本地业务线 (LOB) 应用程序之间的连接。

Important重要提示
如果应用程序使用本地 LOB 系统,则你必须在可以访问 IIS 和 Internet 的计算机上安装 BizTalk Adapter Service 运行时。如果应用程序不连接到本地 LOB 系统,则不需要安装 BizTalk Adapter Service 运行时。

本选项自动安装:

  • BizTalk Adapter Service 运行时:本地运行并使用 WCF 网站服务管理本地 LOB 系统和 BizTalk 服务 应用程序之间的通信。

  • Microsoft WCF LOB 适配器 SDK:Microsoft BizTalk 适配器包 2013 需要该组件

  • BizTalk 适配器包 2013:如果 BizTalk 服务应用程序要向本地业务线 (LOB) 系统(包括 SAP、SQL Server、Siebel、Oracle 数据库或 Oracle E-Business Suite)发送消息,则使用该组件。

    note备注
    在 64 位计算机上,将安装 BizTalk 适配器包 32 位和 64 位版本。在 32 位计算机上,将安装 BizTalk 适配器包 32 位版本。

  • Windows Communication Foundation HTTP 激活功能 (.NET Framework 3.5)

  • ASP.NET 4.5 功能 (.NET Framework 4.5)

  • Internet 信息服务 (IIS) 功能,包括:

    • ASP.NET 3.5

    • ASP.NET 4.5

    • CGI

    • ISAPI 扩展

    • ISAPI 筛选器

    • (或 SQL Server 身份验证,

  • Windows 进程激活服务功能

运行时组件:BizTalk Adapter Service中描述了体系结构。

工具

工具组件包含用于管理 BizTalk Adapter Service运行时组件和你部署的 BizTalk 服务应用程序的 Windows PowerShell cmdlet。工具自动安装:

  • Windows PowerShell 扩展用于管理 BizTalk Adapter Service 运行时和 Microsoft Azure BizTalk Services。

  • Microsoft WCF LOB 适配器 SDK:Microsoft BizTalk 适配器包 2013 需要该组件。

  • BizTalk 适配器包 2013:如果 BizTalk 服务应用程序要向本地业务线 (LOB) 系统(包括 SAP、SQL Server、Siebel、Oracle 数据库或 Oracle E-Business Suite)发送消息,则使用该组件。

    note备注
    在 64 位计算机上,将安装 BizTalk 适配器包 32 位和 64 位版本。在 32 位计算机上,将安装 BizTalk 适配器包 32 位版本。

Important重要提示
  • 将随 Microsoft Azure BizTalk Services SDK 和 BizTalk Adapter Service一起自动安装 BizTalk 适配器包。不需要单独进行安装或购买许可证。

  • BizTalk Adapter Service Windows PowerShell 模块名称为 Microsoft.BizTalk.Adapter.Services.Powershell.dll。因此,在升级后,使用预览版 cmdlet 编写的 PowerShell 脚本可能会失败。

  • Setup 文件夹中提供了 EULA 的副本。你可以打印该副本。

安装分别在以下三个环境中进行:“开发”、“运行时”和“工具”。可以在一台计算机或者不同的计算机上配置环境。要进行完整安装,请在同一台计算机上设置 Visual Studio 开发环境和 BizTalk Adapter Service运行时/工具环境。下表列出了在不同计算机上安装 Microsoft Azure BizTalk Services环境所要满足的软件要求:

 

软件 详细信息 计算机

操作系统

可以是下列任一操作系统:

  • Windows 7

  • Windows Server 2008 R2

  • Windows 8

  • Windows Server 2012

Important重要提示
Visual Studio 2012 要求安装 Windows 7 和 Windows 2008 R2 Service Pack 1

  • 开发

  • Runtime

  • 工具

.NET Framework

所需的版本包括:

  • .NET Framework 3.5.1

    Windows Server:打开服务器管理器,选择功能并选择 .NET Framework 3.5

    Windows 7/Windows 8:打开控制面板,选择程序和功能,选择打开或关闭 Windows 功能并选择 Microsoft .NET Framework 3.5

  • .NET Framework 4.5

    Windows Server 2008 R2/Windows 7:下载 Microsoft .NET Framework 4.5

    Windows Server 2012/Windows 8:在“功能”中,选择“.NET Framework 4.5 高级服务”

  • 开发

  • Runtime

  • 工具

Microsoft Visual Studio 2012

安装 Microsoft Visual C# .NET 是最低要求。安装 Visual Studio 中提供了详细信息。

Important重要提示
BizTalk 服务 SDK 不支持 Visual Studio 2012 Express 版本 (Web/Desktop)。

  • 开发

LOB 服务器客户端库

BizTalk Adapter Service 要求使用 LOB 服务器客户端库与 LOB 系统进行通信。因此,无论在哪个位置安装 BizTalk Adapter Service,都请同时安装 LOB 客户端库。

如果你不使用或者不需要 BizTalk Adapter Service,则不必安装 LOB 服务器客户端库。

BizTalk Server 2013 安装指南中提供了有关需要哪些客户端库,以及可从何处安装这些库的更多具体详细信息。

  • 开发

  • Runtime

  • 工具

Service Bus 命名空间

BizTalk Adapter Service使用 Service Bus 命名空间和 Service Bus 颁发者名称/颁发者密钥值。在 Visual Studio 项目中创建 LOB 连接时,请输入这些值。

请参阅如何:创建或修改 Service Bus Service 命名空间中的步骤)。

  • 开发

Internet Explorer

Internet Explorer 用于访问 Microsoft Azure BizTalk 服务门户,在能够访问 Internet 的任何计算机上都可以进行这种访问。支持的 Internet Explorer 版本包括:

  • Internet Explorer 9 桌面版

  • Internet Explorer 10 桌面版

  • Internet Explorer 11 桌面版

note备注
Microsoft Azure BizTalk 服务门户使用 Silverlight。不支持 Internet Explorer 的现代浏览器版本。

  • Runtime

  • 工具

Internet 访问

BizTalk Adapter Service运行时将在 Microsoft Azure Service Bus 上启动一个中继终结点。运行 IIS 网站的计算机和帐户必须能够穿过防火墙访问 Internet。

根据你的网络要求,可能需要在 Forefront 威胁管理网关 (TMG) 客户端上安装 Forefront TMG 客户端。TMG 客户端还支持 ISA Server 2004 和 ISA Server 2006。

  • Runtime

通过代理连接使用 HTTP 1.1

若要连接到你的命名空间,需要安装“通过代理连接使用 HTTP 1.1”组件。默认情况下,已启用“通过代理连接使用 HTTP 1.1”。可以通过“Internet Explorer 选项”(“高级”选项卡)、域组策略或者通过在代理服务器上启用 HTTP 1.1 来启用该组件。

  • Runtime

Windows PowerShell 3.0

使用 Windows PowerShell cmdlets 所必需的。安装选项:

Windows Server 2008 R2/Windows 7:下载 Windows Management Framework 3.0

Windows Server 2012/Windows 8:随操作系统一起自动安装。不需要单独进行安装。

  • 工具

安装之前

  • 关闭 Visual Studio 的所有实例。终止所有 MsBuild.exe 进程;可以使用任务管理器进行此操作。

  • 更新 machine.config:在以前的 Microsoft Azure BizTalk Services SDK 版本中,你可能已手动或使用 RelayConfigurationInstaller.exe /i 更新了 machine.config 文件。如果你更新了 machine.config 文件,请运行 RelayConfigurationInstaller.exe /u 删除 machine.config 中的条目。以前的 SDK 版本和 2012 年 12 月版本中提供了 RelayConfigurationInstaller 工具。必须使用以前的 SDK 版本随附的 RelayConfigurationInstaller 工具。

  • 升级:可以运行“安装程序”以从预览版升级到最新的 SDK 版本。如果你想要执行全新安装,请卸载所有以前版本的 Microsoft Azure BizTalk Services SDK 和 BizTalk Adapter Service。删除 BizTalk 服务 SDK中列出了卸载步骤。

  • 建议安装:建议至少在两台计算机上完成安装:“开发”和“运行时”/“工具”。将这些组件安装到不同的计算机后,所有计算机必须在受信任的网络中。

  • 运行时是可选的:如果 BizTalk 服务应用程序无法连接到本地业务线 (LOB) 系统,则你不需要 BizTalk Adapter Service运行时。

  • 安装测试证书:使用 Azure 管理门户创建 BizTalk 服务时,将自动创建一个可从 Azure 管理门户下载的测试证书。在安装运行时的过程中可以使用此证书。附录:BizTalk 服务证书概述列出了在本地计算机上安装该证书的步骤。

  • 打开 TCP 端口:在安装运行时的过程中,安装程序将在绑定到端口 8080(默认)的 IIS 中创建一个网站。在 IIS 服务器上,必须在任何防火墙中打开端口 8080。如果你使用 Windows 防火墙,请在 TCP 端口 8080 上创建一个新的入站规则。如何创建 Windows 防火墙入站规则中列出了步骤。

  • 可以在使用 Windows PowerShell cmdlet 的任何计算机(包括运行时计算机和开发计算机)上安装工具

安装步骤

  1. 用属于本地管理员组的帐户登录。如果安装运行时,帐户必须对安装运行时的 IIS 实例也具有管理特权。

  2. 安装 软件要求

  3. 以管理员身份运行 32 位或 64 位 WindowsAzureBizTalkServicesSetup.exe

    note备注
    如果已启用“用户帐户控制”,此时可能会显示安装警报。选择“是”继续安装。

  4. 接受许可协议,然后选择下一步

  5. 根据需要选择开发者 SDK运行时和/或工具所述 BizTalk 服务 SDK 组件 列出了差异。选择“下一步”

  6. 摘要列出了设置操作。选择安装

    note备注
    对于全新安装,设置操作为安装。如果已安装了一些组件,摘要列出了版本和操作;如升级将 BizTalk 服务 SDK 升级到最新版本 提供详细信息。

  7. 如果选择运行时,BizTalk Adapter Service 设置启动:

    1. 在“欢迎”页上选择下一步

    2. 接受许可协议,然后选择下一步

    3. 对于应用程序池,输入有 Internet 访问权限的标识,选择下一步

      此时已创建 IIS 中的 BizTalk Adapter Service应用程序池,它以此标识执行。之所以需要能够访问 Internet,是因为此标识将用于访问 Service Bus 上的中继终结点。

    4. “Azure BizTalk 服务部署详细信息”页中,输入 BizTalk 服务部署 URL,然后选择“下一步”

      此 URL 用于确定与你的 BizTalk 服务订阅关联的项目存储。创建的 BizTalk Adapter Service组件(例如 LOB 中继和 LOB 目标)的配置设置存储在项目存储中。

    5. 选择 BizTalk Adapter Service 网站的证书绑定并选择下一步

      • 使用 SSL 保护管理服务:选择此选项可以使用 SSL 来加密 HTTP 请求。

      • 选择现有的 SSL 证书:选择此选项可从证书存储中选择现有的证书。该证书应该来自受信任的证书颁发机构。

      • 端口:输入 BizTalk Adapter Service网站的端口号。默认情况下已输入端口 8080。请确认已在防火墙中打开该端口。

    6. 选择安装。完成向导中的操作后,选择完成返回到 Microsoft Azure BizTalk Services SDK 向导。

  8. 选择完成以完成安装并退出向导。

安装完成后,将在路径为 C:\Users\用户名\AppData\Local\Temp 的用户临时目录下创建一个安装日志文件。如果安装失败,请参考此日志文件以了解所有错误。如果安装成功,环境将可以提供创建和/或管理 BizTalk 服务 应用程序所需的全部组件。

可以将 Microsoft Azure BizTalk Services预览版或 Microsoft Azure BizTalk Services(2013 年 11 月)正式版 (GA) 中的开发人员、运行时和工具组件升级到最新版本。若要升级,请以管理员身份运行 WindowsAzureBizTalkServicesSetup.exe,选择要升级的组件,然后继续安装。安装程序将检测以前安装的组件版本,并相应地建议对其进行升级。通常,必须以相同的版本安装这三个组件。例如,如果安装了某一个版本的开发人员 SDK 和运行时,同时安装了另一个版本的工具组件,则安装程序将会建议对这些组件使用相同的版本。

在升级过程中,现有的项目(包括 BizTalk 服务项目项目、转换和BizTalk Adapter Service组件)将升级到 GA。另外,如果选择升级 BizTalk Adapter Service 运行时组件,安装程序还会将本地 SQL Server 数据库中的 BizTalk Adapter Service 设置迁移到 Azure 存储空间。有关详细信息,请参阅迁移 BizTalk 适配器服务运行时环境

升级后

升级到最新版本后,请执行以下操作:

  • 重新部署已启用批处理的 EDI 协议。如果协议中未使用批处理,则无需重新部署 EDI 协议。

  • BizTalk 适配器服务 Windows PowerShell 模块名称为 Microsoft.BizTalk.Adapter.Services.Powershell.dll。因此,在升级后,使用预览版 cmdlet 编写的 PowerShell 脚本可能会失败。必须重新编写这些脚本。

  • 请参考 Azure BizTalk 服务发行说明,以了解升级后可能会发生的其他问题。

  • 最佳做法之一是创建 BizTalk 服务的备份。BizTalk 服务:备份和还原中提供了有关创建备份的详细信息。

随 Microsoft Azure BizTalk Services SDK 一起提供的预览版和 2013 年 11 月 GA 版 BizTalk Adapter Service组件要求使用一个本地 SQL Server 数据库来存储有关 LOB 中继和 LOB 目标的信息。2014 年 2 月版 BizTalk Adapter Service组件在与 BizTalk 服务关联的存储库中存储这些信息。使用 Microsoft Azure BizTalk Services SDK 安装程序可将本地 SQL Server 数据库中存储的信息迁移到与 BizTalk 服务关联的 Azure 存储空间。以下步骤提供了有关如何执行迁移的信息:

note备注
你可以在升级的同时执行迁移。

  1. 在装有以前版本的 BizTalk Adapter Service的计算机上,以管理员身份运行 WindowsAzureBizTalkServicesSetup.exe

    note备注
    如果已启用“用户帐户控制”,此时可能会显示安装警报。选择“是”继续安装。

  2. 接受许可协议,然后选择下一步

  3. 选择“运行时”,然后选择“下一步”

  4. “摘要”页列出了将要升级的运行时(BizTalk Adapter Service)组件。选择“下一步”

  5. “迁移”页上,提供 BizTalk 服务 订阅的 URL、与 BizTalk 服务 关联的访问控制命名空间,以及该访问控制命名空间的颁发者名称/颁发者密钥。

    note备注
    安装程序将使用该 URL 来确定与你的 BizTalk 服务订阅关联的存储库。创建的 BizTalk Adapter Service组件(例如 LOB 中继和 LOB 目标)的配置设置存储在与 BizTalk 服务关联的存储库中。如果你以前将 BizTalk Adapter Service用作使用预览版或 2013 年 11 月 GA 版 SDK 创建的现有BizTalk 服务应用程序的一部分,则向导会将本地 SQL Server 数据库中的 BizTalk Adapter Service配置设置迁移到与 BizTalk 服务订阅关联的存储库中。

    选择安装

  6. 完成向导中的操作后,选择“完成”

可以使用控制面板卸载 Microsoft Azure BizTalk Services SDK 和 BizTalk Adapter Service。选择“卸载程序”。在“卸载或更改程序”页中,右键单击该组件,然后选择“卸载”。已安装组件的完整列表包括:

  • Microsoft Azure BizTalk Services SDK

  • Microsoft BizTalk Adapter Service

  • Microsoft Azure BizTalk Services工具

  • Microsoft BizTalk 适配器包(如果已安装)

  • Microsoft BizTalk 适配器包 (x64)(如果已安装)

  • Windows Communication Foundation LOB 适配器 SDK(WCF LOB 适配器 SDK)(如果已安装)

    Important重要提示
    在卸载 WCF LOB 适配器 SDK 之前,始终应该先卸载 BizTalk 适配器包。

另请参阅

显示: