如何安装 BizTalk 应用程序

2025-06-05

本主题介绍如何通过双击 Windows 界面中应用程序的 Windows Installer（.msi）文件或从命令行运行 msiexec，在本地计算机上安装应用程序。还可以启动安装向导作为导入向导的最后一步，如如何导入 BizTalk 应用程序中所述。

谨慎

如果此计算机上已安装此应用程序，系统会提供修复应用程序的选项。仅当为此应用程序安装了单个 .msi 时，才支持修复。如果为此应用程序在此计算机上安装了多个 .msi，则不应选择此选项。这是因为选择“修复”将撤消 .msi 安装在此 .msi 文件之后所做的任何更改，这可能会导致应用程序出现故障。

在将应用程序投入运行之前，必须在运行应用程序的 BizTalk Server 计算机上安装它。安装应用程序会将其资源放置在本地文件系统上。根据应用程序、其内容及其配置，安装也可能执行以下作：

将程序集添加到全局程序集缓存（GAC）
安装证书和虚拟目录
将组件添加到 Windows 注册表。
如果脚本存在于 .msi 文件中，请运行预处理脚本或后处理脚本。

有关背景资料，请参阅安装和卸载过程中人工制品发生的情况。

先决条件

若要执行本主题中的过程，必须使用对本地文件系统具有写入权限的帐户登录。根据应用程序中包含的项，你可能还需要对 Windows 注册表、GAC、证书存储和 Internet Information Services 具有写入权限。本地计算机上的管理员帐户具有这些权限。有关权限的详细信息，请参阅部署和管理 BizTalk 应用程序所需的权限。

安装应用程序的注意事项

安装应用程序时，可能需要注意以下事项：

还必须安装此应用程序具有依赖项的任何应用程序。 安装依赖于项目的应用程序（例如包含在另一个应用程序中的 BizTalk 程序集）时，还必须安装包含该项目的应用程序。必须先执行此作，然后才能运行应用程序。例如，如果应用程序 A 依赖于应用程序 B 中的程序集，则还必须安装应用程序 B。然后，可以安装应用程序 A。有关背景信息，请参阅依赖项和应用程序部署。
应停止正在更新的应用程序。 如果要执行安装以更新应用程序中的项目，则无需停止应用程序，除非更新包含与现有程序集具有相同版本的一个或多个程序集。在这种情况下，在安装更新之前，必须停止应用程序。但是，我们建议在所有情况下停止应用程序，除非知道更新不会干扰运行应用程序。有关详细信息，请参阅更新 BizTalk 应用程序。
为同一应用程序安装多个 .msi 文件时，在“添加或删除程序”中只会创建一个条目。 例如，可以执行此作来更新现有应用程序。然后，可以使用添加或删除程序（在控制面板中）完全卸载应用程序，包括任何更新的项目。请注意，不支持双击 .msi 文件或使用 msiexec 卸载应用程序。有关详细信息，请参阅如何卸载 BizTalk 应用程序。
证书必须存在于托管发送端口的所有计算机上，然后应用程序才能运行。 Other People 证书存储区包含发送端口使用的证书。
可以将应用程序工件分解为不同的 .msi 文件进行安装。 无需在将运行应用程序的每台计算机上安装所有应用程序项目。相反，可以将应用程序项目的子集导出到不同的 .msi 文件中，以在不同的计算机上安装。有关说明，请参阅如何导出 BizTalk 应用程序。
如果应用程序 .msi 文件包含虚拟目录，则必须在本地计算机上运行 Internet Information Services （IIS）。 否则，安装将失败。
如果应用程序包含与本地计算机上已存在同名的虚拟目录，则会将该应用程序中的资源添加到其中。 否则，将创建虚拟目录。任何与新添加的文件同名的现有文件将被覆盖。此外，现有虚拟目录的安全设置不会更改，应验证它们是否足够安全。
在安装应用程序之前，请为虚拟目录创建应用程序池。 如果应用程序包含虚拟目录，并且 IIS 中尚不存在应用程序池，则应在安装之前手动创建应用程序池。这样，虚拟目录将在安装过程中绑定到应用程序池。如果未创建应用程序，则虚拟目录将绑定到安装时的默认应用程序池。
确保将 BTSHttpReceive.dll 注册为 Internet Information Services (IIS) 7.0 的处理程序映射。 如果应用程序包含虚拟目录才能使 HTTP 接收位置正常工作，则必须执行此作。
在 32 位计算机上安装包含 64 位项目的应用程序时，可能会遇到问题。 有关详细信息，请参阅如何将 64 位项目添加到应用程序。
如果目标目录长度超过 260 个字符，可能会遇到问题。 如果在安装 MSI 包期间指定的目标目录中的字符数超过 260 个字符，则安装将失败。若要解决此问题，请确保为目标目录指定的字符数不超过 260 个字符。
不应重新定位安装文件夹。 安装应用程序后，不应重新定位安装文件夹或其包含的文件。如果这样做，然后稍后尝试删除（卸载）应用程序，则删除作可能会失败。具体而言，应用程序安装文件夹包含 BizTalk Server 生成的文件，这些文件是执行删除所必需的。不应重命名、移动或删除这些文件。文件包括：
- ApplicationDefinition.adf
- Microsoft.BizTalk.CustomInstaller.dll
- Microsoft.BizTalk.CustomInstaller.InstallState

注释

如果在安装操作完成之前取消，BizTalk Server 将回滚安装，但由预处理或后处理脚本在操作取消之前所执行的任何操作除外。

重要

安装任何应用程序之前，请确保已从受信任的源收到 .msi 文件。恶意用户可以在 .msi 文件中包括代码，而该文件可能会对系统或网络产生不良影响。有关详细信息，请参阅安全和 Windows Installer。

如果应用程序包含使用 Web 服务的网站或业务流程，请注意，虚拟目录中的安全设置是在应用程序导出期间生成 .msi 文件时生效的，除非在现有虚拟目录的情况下使用现有设置。安装应用程序后，应验证设置是否符合安全要求。

导出应用程序时，会从文件和文件夹中删除所有不重要的访问控制列表（DACL）。在主机实例上安装应用程序后，必须在文件和文件夹（包括虚拟目录）上重新配置所有安全设置。

在目标计算机上创建虚拟目录后，您可能需要更改 HTTP 接收位置引用的虚拟目录的本地路径指定。

在目标计算机上创建虚拟目录时，它将指向以下物理目录之一：

< 安装驱动器>\Program Files\Microsoft BizTalk Server\HttpReceive

- 或 –

< 安装驱动器>\Program Files （x86）\Microsoft BizTalk Server\HttpReceive

如果 BizTalk HTTP 接收 ISAPI 扩展 BTSHTTPReceive.dll 不在指定目录中，或者目标计算机运行的是 64 位作系统，则必须更改本地路径：指定虚拟目录以指向包含 BizTalk HTTP 接收 ISAPI 扩展文件的物理目录。例如，如果目标计算机运行的是 64 位版本的 Windows Vista，则本地路径：应将虚拟目录的指定更改为 <安装驱动器>\Program Files （x86）\Microsoft BizTalk Server\HttpReceive64。

安装 BizTalk 应用程序

使用 Windows 接口

将应用程序的 .msi 文件复制到本地计算机。
如果要重新安装或升级现有 BizTalk 应用程序，并且新安装包含的程序集的版本与应用程序中已存在的程序集相同，或者与正在更新的项目进行交互，请确保应用程序通过右键单击应用程序文件夹并单击“ 停止”来停止该应用程序。
在 Windows 资源管理器中，双击 .msi 文件以启动安装向导。
在 “选择安装文件夹 ”页上的 “文件夹”中，键入 BizTalk 应用程序的完整安装路径。示例：C：\Program Files\Generated by BizTalk\MyApplication.
单击“ 下一步 四次”，然后在 “安装完成 ”页上，单击“ 关闭”。
如果多台计算机将运行应用程序，请对每台计算机重复前面的步骤。

在将运行该应用程序的所有计算机上安装应用程序并且应用程序已导入 BizTalk 组后，可以通过右键单击应用程序的文件夹并单击 “启动”，从 BizTalk Server 管理控制台启动应用程序。有关完整说明，请参阅如何启动和停止 BizTalk 应用程序。

使用命令行

将应用程序的 .msi 文件复制到本地计算机。
单击“ 开始”，单击“ 运行”，键入 cmd，然后按 Enter。
导航到存储 .msi 文件的位置。

键入以下命令以安装应用程序，提供适当的参数和值，如下表所示：

重要

仅支持下表中显示的 msiexec 参数。

msiexec [/i] Package [/qn] TARGETDIR=“value”]

示例： msiexec /i MyApplication.msi

参数	价值
/我	安装应用程序。
包	Windows Installer （.msi）文件的名称。
/qn	执行安装而不显示用户界面。
TARGETDIR=“value”	指定应用程序安装文件夹。此值也在 %BTAD_InstallDir% 环境变量中设置。示例：TARGETDIR=“C：\Programs\BizTalk 应用程序\我的应用程序”

如果多台计算机将运行应用程序，请对每台计算机重复前面的步骤。

在运行该应用程序的所有计算机上安装应用程序后，可以通过右键单击应用程序的文件夹并单击 “启动”，从 BizTalk Server 管理控制台启动该应用程序。有关完整说明，请参阅如何启动和停止 BizTalk 应用程序。

另请参阅

部署 BizTalk 应用程序
 如何卸载 BizTalk 应用程序

通过