安装和配置故障排除

安装程序无法部署 RuntimeSchemas 程序集

症状

A4SWIFT安装程序无法部署 RuntimeSchemas.dll。 如果在安装后未手动部署程序集,则A4SWIFT配置向导将失败。

可能的原因

存在以下条件之一:

  • 尝试进行A4SWIFT的初始安装时,运行时模式程序集已经部署。

  • Microsoft SQL Server 未在尝试安装A4SWIFT的计算机上启动。

  • 当您尝试升级A4SWIFT时,运行时架构程序集已被部署,并由另一个程序集引用。 这阻止了A4SWIFT升级程序取消部署运行时架构程序集。

解决方案

按问题的性质进行以下操作:

  • 如果在尝试运行A4SWIFT的初始安装时已部署运行时架构程序集,请在 Microsoft Visual Studio.NET 中打开 BizTalk 资源管理器,右键单击程序集Microsoft。Solutions.FinancialServices.SWIFT.RuntimeSchemas,然后单击“取消部署”。 使用 BizTalk 部署向导从 %programfiles%\Microsoft BizTalk Accelerator for SWIFT\Assemblies 部署 RuntimeSchemas.dll 的最新版本。

  • 如果未启动 SQL Server,请启动 SQL Server Service Manager 中的 SQL Server。 使用 BizTalk 部署向导在 %programfiles%\Microsoft BizTalk Accelerator for SWIFT\Assemblies 中部署 RuntimeSchemas.dll 的最新版本。

  • 如果在尝试升级 A4SWIFT 时,“Runtime Schemas” 程序集已经部署,并且已被其他程序集引用,请在 BizTalk Explorer 中取消部署所引用的程序集,然后取消部署 BizTalk Explorer 中的 RuntimeSchemas.dll。 使用 BizTalk 部署向导从 %programfiles%\Microsoft BizTalk Accelerator for SWIFT\Assemblies 中部署 RuntimeSchemas.dll 的最新版本。

删除网页组件功能后,消息修复与对账被错误地显示为未安装。

症状

删除A4SWIFT的消息修复和新提交功能的 Web 组件后,无法卸载、安装或配置消息修复和对帐功能(或A4SWIFT组件)。 如果安装了消息修复和对帐,A4SWIFT无法识别该功能已安装。 如果尝试在“添加/删除程序”中安装、修改或删除消息修复和对帐(显示在“控制面板”中),“添加/删除程序”将指示未安装该功能。

可能的原因

在安装了用于消息修复和新提交功能的 Web 组件以及消息修复和对账功能后,你被从 BizTalk Server 管理员组中移除。 如果随后删除 Web 组件功能(无需成为 BizTalk Server 管理员组的成员),A4SWIFT安装程序将删除消息修复和对帐功能依赖的文件。 这些文件包括 ConfigFramework.exe。

解决方案

如果遇到此问题,请按如下所示继续作:

  1. 在“计算机管理”窗口中,将自己添加回 BizTalk Server 管理员组,注销计算机,然后重新登录。

  2. 重新安装用于消息修复和新提交功能的 Web 组件。

    注释

    步骤 2 将 ConfigFramework.exe 添加回 A4SWIFT 安装。

  3. 重新安装 MRSR 功能。

  4. 如果仍不希望使用 Web 组件进行消息修复和新提交功能,请将其删除。

修复A4SWIFT以添加服务文件夹可能会导致该文件夹的访问权限不正确

症状

如果从正确配置的 A4SWIFT 安装中删除了 \Microsoft BizTalk Accelerator for SWIFT\Service %programfiles%的文件夹,然后运行 A4SWIFT 安装程序的修复功能,将服务器文件夹添加回A4SWIFT安装中,则服务文件夹的访问权限将不正确。 正确的权限是A4SWIFT管理员的完全控制权限,以及A4SWIFT用户的读取和执行权限。

如果在服务文件夹存在时运行A4SWIFT安装程序的修复功能,也会发生这种情况。 A4SWIFT配置向导设置的访问权限将被用不正确的值覆盖。

可能的原因

安装用于消息修复和新提交功能的 Web 组件会添加一个名为“Service”的文件夹。 如果删除文件夹,然后运行“修复”选项A4SWIFT安装程序以添加用于邮件修复和新提交的 Web 组件,A4SWIFT安装程序不会运行配置向导(ConfigFramework.exe)来设置文件夹的权限。 由于配置向导已运行,因此很难再次运行向导来重置配置。 因此,“修复”选项将重新创建所有已删除的文件和文件夹,但不会正确设置访问权限。

如果运行修复时存在该文件夹,修复过程还会覆盖 Service 文件夹的权限。 与在运行修复之前删除 Service 文件夹的情况一样,运行配置程序设置权限将非常困难。 在此实例中,权限也将不正确,必须手动设置这些权限。

解决方案

如果遇到此问题,请手动设置服务文件夹的以下访问权限:

组或用户名 许可
A4SWIFT管理员 完全控制
A4SWIFT用户 读取及执行

若要设置这些权限,请按如下所示继续作:

在 Windows 资源管理器中,打开 %programfiles%\Microsoft BizTalk Accelerator for SWIFT\Service。

  1. 右键单击“服务”文件夹,单击“ 属性”,然后单击“ 安全 ”选项卡。

  2. 在“服务属性”对话框的“组”或“用户名”窗格中,单击“ 添加”,输入 <服务器名称>\A4SWIFT管理员,然后单击“ 确定”。

    注释

    如果A4SWIFT管理员组是域组,请输入 <域名>\A4SWIFT管理员

  3. 如果 <A4SWIFT用户组是域组,请对服务器名称>\A4SWIFT用户<域名>\A4SWIFT用户 重复步骤 2。

  4. 在“组”或“用户名”窗格中,选择 A4SWIFT管理员。 在“权限”窗格中,选择“允许完全控制”。

  5. 在“组”或“用户名”窗格中,选择 “A4SWIFT用户”。 在“权限”窗格中,单击“允许读取和执行”、“列出文件夹内容”和“读取”。

  6. 单击 “确定”

升级会导致并行安装两个版本的A4SWIFT

症状

尝试升级到 A4SWIFT 时,可能无法完全删除以前版本的 A4SWIFT。 如果在控制面板中运行“添加/删除程序”,则“当前已安装的程序”列表可能会显示当前版本和以前的版本。

可能的原因

以下任一情况都可能导致上述情况发生:

  • 尝试升级的用户不是 BizTalk Server 管理员组的成员。

  • SQL Server 服务 (MSSQLSERVER) 已停止。

  • 使用 setup.exe /addlocal 命令执行静默升级。

解决方案

若要防止在升级期间并行安装 A4SWIFT 2.1 和 A4SWIFT 3.0,请确保(已登录用户)是 BizTalk Server 管理员组的成员,并启动 SQL Server 服务(MSSQLSERVER)。

如果最终并排安装了 A4SWIFT 2.1 或 A4SWIFT 2.3 和 A4SWIFT 3.0,请按以下步骤进行:

  1. 备份 SWIFT Messages 文件夹中的数据。

  2. 以 BTS 管理员组的成员身份登录到 BizTalk Server,并确保 MSSQLSERVER 服务正在运行。

  3. 删除以前版本的 A4SWIFT。

  4. 再次升级到最新版本的 A4SWIFT。 这一次升级将正常工作,不会创建并行安装。

  5. 使用 BizTalk 部署实用工具,手动撤销部署 Microsoft .Solutions.FinancialServices.SWIFT.RuntimeSchemas.dll,然后从 A4SWIFT 安装位置的“程序集”文件夹中重新部署它。 有关此工具的详细信息,请参阅 BRE 部署实用工具

如果未在出现提示时重新启动,则卸载或升级过程可能无法正确完成

症状

卸载或升级过程未正确完成。

可能的原因

如果尚未取消部署一个引用了现有已部署程序集的项目,可能会收到提示,指示必须重启系统,以便A4SWIFT配置更改生效。 如果不单击 “是 ”立即重启,则可能无法删除为全局程序集缓存中删除而分配的某些程序集,从而导致其他卸载或升级进程无法正确完成。

解决方案

取消部署引用现有已部署程序集的任何项目,然后再次运行卸载或升级过程。

如果在安装过程中 IIS 管理服务已停止,则必须重新配置 WebService 功能

症状

A4SWIFT配置向导未正确配置 WebService 功能。 你收到以下错误:

无法创建 MRSR 工件:无法连接到远程服务器。

可能的原因

运行A4SWIFT配置向导时,IIS 管理服务已停止。

解决方案

若要成功完成配置过程,请按如下所示继续作:

  1. 关闭A4SWIFT配置控制台。

  2. 重启 IIS 管理服务。

  3. 执行 %programfiles%\Microsoft BizTalk Accelerator for SWIFT\Configuration.exe。

  4. 在A4SWIFT配置控制台中,选择“ 取消配置功能 ”,然后选择“ WebService”。

  5. 确保配置控制台中 WebService 功能的状态显示为未配置。

  6. 选择 “应用配置”

    注释

    A4SWIFT配置向导现在将正确配置 WebService 功能。

如果未在 BizTalk Server 配置中创建 BizTalkServerApplication 主机,则A4SWIFT配置将失败

症状

A4SWIFT配置向导未正确配置 WebService 功能。 你收到以下错误:

“无法创建 MRSR 工件:对象引用未设置为对象的实例。”

可能的原因

在 BizTalk Server 运行时配置期间未创建 In-Process 主机和主机实例。

解决方案

若要修复A4SWIFT配置,请按照以下步骤进行:

  • 在 BizTalk Server 管理中创建主机。 现在无需有正在运行的实例。

  • 在安装A4SWIFT安装的 %programfiles%\Microsoft BizTalk Accelerator for SWIFT\SDK\Tools 文件夹中运行 RepairBAS 工具。

    为此,请继续执行如下操作:

  1. 启动 BizTalk Server 管理控制台

  2. 在 BizTalk Server 管理控制台中,依次展开 BizTalk Server 管理BizTalk 组平台设置。

  3. 右键单击“ 主机”,指向“ 新建”,然后选择“ 主机”。

  4. 在“主机属性”屏幕的“常规”窗格中,输入以下内容:

    • 主机名: BizTalkServerApplication

    • 类型:进行中

    • Windows 组: <>\BizTalk 应用程序用户 (或在 BizTalk Server 配置期间为运行 BizTalk In-Process 应用程序设置的帐户)

    • 在“选项”部分中,选择 “允许主机跟踪 ”并将 此设置为组中的默认主机

  5. 单击 “确定”

  6. 单击“ 开始 ”,然后单击“运行”。 键入 cmd ,然后单击“ 确定”。

  7. 在命令提示符下,导航到 %programfiles%\Microsoft BizTalk Accelerator for SWIFT\SDK\Tools

  8. 键入 RepairBAS.exe ,然后按 Enter

在 64 位计算机上运行 BRE 部署实用工具时,必须更改 BRE 部署配置文件

症状

在 32 位计算机上或在非默认目录中(C:\Program Files\Microsoft BizTalk Accelerator for SWIFT)上运行 BRE 部署实用工具时无法正常工作。

可能的原因

在您更改位于 C:\Program Files\Microsoft BizTalk Accelerator for SWIFT\SDK\Tools 文件夹中的 BREDeployment.exe.config 文件路径之前,BRE 部署实用工具将无法正常工作。

解决方案

通过在记事本中打开 BREDeployment.exe.config 并更改基本策略、架构和词汇目录的文件夹来更新实用工具的配置。

另请参阅

故障排除:问题和解决方法