通过

如何安装面向服务的存根版本解决方案

以下步骤介绍如何在安装面向服务的存根解决方案之前准备计算机，以及如何在计算机上安装解决方案。

准备计算机以安装面向服务的解决方案的存根版本

准备计算机以安装面向服务的解决方案的存根版本

  1. 确保 默认网站 配置为使用 ASP.NET 2.X。

    1. 单击“ 开始”，指向 “所有程序”，指向 “管理工具”，然后单击“ Internet Information Services”（IIS）管理器。

    2. 在 Internet Information Services (IIS) 管理器中，展开计算机名称，展开站点，展开默认网站，展开aspnet_client，展开system_web。

    3. 确保子文件夹为 2.X。

  2. 单击“开始”，指向“所有程序”，指向“管理工具”，然后单击“服务”。 使用 服务 控制台，确保以下服务正在运行：

    • 万维网发布服务

  3. 依次单击“ 开始”、“ 所有程序”、“ 管理工具”、“ 计算机管理控制台 ”，然后将 BizTalk 服务帐户添加到本地管理员组。

  4. 如果安装了 Windows SharePoint Services，请从 Windows SharePoint Services 托管路径中排除 默认网站的 （根），如下所示：单击 “开始”，指向 “所有程序”，指向 “管理工具”，然后单击“ SharePoint 管理中心”。

    1. 在 “虚拟服务器配置”下，选择“ 配置虚拟服务器设置”。

    2. 在 “虚拟服务器列表 ”页上，单击 “默认网站”。

    3. 在 “虚拟服务器设置” 页上，单击“ 定义托管路径”。

    4. 在“已定义托管路径”页的“包含的路径”部分中，选择“根”，然后单击“删除所选路径”。

    5. 在命令提示符下，执行 IISReset。

  5. 注销计算机，然后以 BizTalk 服务帐户身份登录到计算机。

  6. 打开命令提示符，键入以下命令，然后按 Enter 设置 %BTSSolutionsPath% 环境。 然后，退出命令提示符。

    • setx BTSSolutionsPath 「\Program Files （x86）\Microsoft BizTalk Server <VERSION>SDK\Scenarios」

      注释

      如果使用 64 位计算机，请使用 %ProgramFiles（x86）% 而不是 %ProgramFiles%。

      注释

      有关 SETX 命令的详细信息，请参阅 at https://go.microsoft.com/fwlink/?LinkId=67831的 Microsoft TechNet 网站。

安装适用于 Windows 的 IBM WebSphere MQ 客户端

安装适用于 Windows 的 IBM WebSphere MQ 客户端

  1. 下载适用于 Windows 的 IBM WebSphere MQ 客户端的最新版本。

    注释

    即使解决方案的存根版本不需要 IBM WebSphere Server，客户端应用程序也会引用 IBM WebSphere MQ Client for Windows 提供的 amqmdnet.dll 文件，因此必须安装它。 存根版本的客户端实际上不会在 DLL 中调用 API。 它仅用于编译和运行客户端应用程序。 可以从 IBM 网站下载适用于 Windows 的 IBM WebSphere MQ 客户端。

  2. 安装 IBM WebSphere MQ Client for Windows。

    注释

    无需配置适用于 Windows 的 IBM WebSphere MQ 客户端。 保留所有默认设置。

  3. 将 .NET 程序集的 WebSphere MQ 类添加到全局程序集缓存（GAC）。

    1. 在 Visual Studio 命令提示符处，导航到 <IBM MQSeries 安装目录>\bin 目录。

    2. 运行以下命令（确保 gacutil.exe 位于路径环境中）：

      gacutil.exe /i amqmdnet.dll

在 IIS 中为面向服务的解决方案创建虚拟目录

在 IIS 中为面向服务的解决方案创建虚拟目录

  1. 在 Internet Information Services （IIS） 管理器中，右键单击 “应用程序池”，选择“ 添加应用程序池”。

    在“ 添加应用程序池 ”对话框中，键入 SSOStubAppPool “ 名称 ”文本框，然后单击“ 确定”。

    面向服务的解决方案使用的虚拟目录包括用于业务流程存根版本的已发布 Web 服务、存根 SAP Web 服务、存根付款跟踪器 Web 服务和存根挂起事务 Web 服务。

  2. 在 Internet Information Services （IIS） 管理器中，右键单击刚刚创建的应用程序池，然后单击“高级设置”。

  3. 在 Identity 属性右侧的列中单击，然后单击省略号 （...） 按钮。

  4. 在 “应用程序池标识 ”对话框中，选择“ 自定义帐户 ”选项，然后单击“ 设置”。

  5. 在 “设置凭据 ”对话框中，指定用户名和密码，确认密码，然后单击“ 确定”。

    注释

    此用户必须具有执行业务流程代理 Web 服务的权限，并且必须添加到 BizTalk Server 管理员、SSO 管理员或 SSO 关联管理员组之一

  6. 单击“ 确定 ”关闭 “应用程序池标识 ”对话框。

  7. 单击“确定” 关闭“高级设置” 对话框。

  8. 在 Internet Information Services （IIS） 管理器中，展开 “网站”，右键单击 “默认网站”，指向“ 新建”，然后单击“ 虚拟目录 ”以运行 虚拟目录创建向导。

    1. 使用 虚拟目录创建向导，为适配器版本的代理 Web 服务创建以下虚拟目录：

      Alias = Microsoft.Samples.BizTalk.WoodgroveBank.OrchProxy.Stub

      PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\OrchProxy\Stub

      访问权限 = 读取、运行脚本

    2. 使用 虚拟目录创建向导，为适配器版本的代理 Web 服务创建以下虚拟目录：

      Alias = Microsoft.Samples.BizTalk.WoodgroveBank.StubSAP

      PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\StubWebServices\SAP

      访问权限 = 读取、运行脚本

    3. 使用 虚拟目录创建向导，为适配器版本的代理 Web 服务创建以下虚拟目录：

      Alias = Microsoft.Samples.BizTalk.WoodgroveBank.StubPendingTransactions

      PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\StubWebServices\PendingTrans

      访问权限 = 读取、运行脚本

    4. 使用 虚拟目录创建向导，为适配器版本的代理 Web 服务创建以下虚拟目录：

      Alias = Microsoft.Samples.BizTalk.WoodgroveBank.StubPaymentTracker

      PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\StubWebServices\PaymentTrack

      访问权限 = 读取、运行脚本

  9. 在 Internet Information Services （IIS） 管理器中，展开 “网站”， 展开 “默认网站”，右键单击Microsoft.Samples.BizTalk.WoodgroveBank.OrchProxy.Stub，单击“ 属性”，然后修改设置，如下所示：

    1. 在 “虚拟目录 ”选项卡上，将 应用程序池 设置为刚刚创建的 SSOStubAppPool 。

    2. 单击“目录安全性”选项卡，在“身份验证和访问控制组”框中单击“编辑”，选择“仅启用集成 Windows 身份验证”，然后清除其他身份验证访问复选框。 单击“ 确定 ”退出。

  10. 在 Internet Information Services （IIS） 管理器中，展开 “网站”， 展开 “默认网站”，右键单击Microsoft.Samples.BizTalk.WoodgroveBank.StubSAP，单击“ 属性”，然后修改设置，如下所示：

    1. 在 “虚拟目录 ”选项卡上，将 应用程序池 设置为刚刚创建的 SSOStubAppPool 。

    2. 单击“目录安全性”选项卡，在“身份验证和访问控制组”框中单击“编辑”，然后选择“启用匿名访问”。 单击“ 确定 ”退出。

  11. 在 Internet Information Services （IIS） 管理器中，展开 “网站”， 展开 “默认网站”，右键单击Microsoft.Samples.BizTalk.WoodgroveBank.StubPendingTransactions，单击“ 属性”，然后修改设置，如下所示：

    1. 在 “虚拟目录 ”选项卡上，将 应用程序池 设置为刚刚创建的 SSOStubAppPool 。

    2. 单击“目录安全性”选项卡，在“身份验证和访问控制组”框中单击“编辑”，然后选择“启用匿名访问”。 单击“ 确定 ”退出。

  12. 在 Internet Information Services （IIS） 管理器中，展开 “网站”， 展开 “默认网站”，右键单击“Microsoft.Samples.BizTalk.WoodgroveBank.StubPaymentTracker”，单击“ 属性”，然后修改设置，如下所示：

    1. 在 “虚拟目录 ”选项卡上，将 应用程序池 设置为刚刚创建的 SSOStubAppPool 。

    2. 单击“目录安全性”选项卡，在“身份验证和访问控制组”框中单击“编辑”，然后选择“启用匿名访问”。 单击“ 确定 ”退出。

生成面向服务的解决方案

构建面向服务的解决方案

  1. 启动 Visual Studio 命令提示符。

    注释

    %BTSInstallPath%在 \Scenarios\SO\BTSSoln\OrchProxy\Inline\app_code\customerserviceport.asmx.cs 和 %BTSInstallPath%\Scenarios\SO\BTSSoln\OrchProxy\Stub\app_code\customerserviceport.asmx.cs 文件中，将 17f20caea2afcc8c 的所有实例替换为 a1054514fc67bded。

  2. 在 Visual Studio 命令提示符处，将目录更改为 %BTSSolutionsPath%\SO\BTSSoln 文件夹，然后运行以下命令以生成面向服务的解决方案的存根版本。

    • SetupBTSSoln.bat

    注释

    在下面列出的文件中，将 17f20caea2afcc8c 的所有实例替换为当前的公钥令牌。

    • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\Aggregate_To_CustomerServiceResponse.btm.cs
      • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\Aggregate_To_ErrorResponse.btm.cs
      • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\CustomerServiceRequest_To_CreditLimitResponse.btm.cs
      • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\CustomerServiceRequest_To_CustomerServiceResponseDenied.btm.cs
      • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\CustomerServiceRequest_To_LastPaymentResponseTimeout.btm.cs
      • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\CustomerServiceRequest_To_PendingTransactionResponse.btm.cs

在 SSO 数据库中创建企业单一 Sign-On（SSO）条目和值

在 SSO 数据库中创建企业单一 Sign-On（SSO）条目和值

  1. 打开命令提示符，将当前目录更改为 %BTSSolutionsPath%\SO\BTSSoln\Scripts，然后运行以下命令以设置企业单 Sign-On 文件夹的 PATH 环境。

    • Set PATH=%PATH%;%ProgramFiles%\"Common Files\Enterprise Single Sign-On"

  2. 在命令提示符下，使用记事本将目录更改为 %BTSSolutionsPath%\SO\BTSSoln\Scripts folder, open ConfigStoreApp.xml，然后查看文件的内容。

    注释

    此文件在 SSO 中定义配置存储应用程序，该方案用于存储配置参数。 某些配置参数包括用于与 SAP 通信的 超时 值（对于所有三个版本）。 无需对此文件进行更改。

  3. 在命令提示符下运行以下命令以创建 SSO 配置存储应用程序。

    • ssomanage -createapps ConfigStoreApp.xml

  4. 在命令提示符下，使用记事本打开SetConfigValuesInSSO.cmd，然后查看文件的内容

    注释

    此命令文件设置 SSO 数据库中配置参数的值。 它包含多个 set 语句，这些语句在命令文件的开头设置局部变量中的值。 SAPAdapterTimeout、PendingTransactionsAdapterTimeout 和 PaymentTrackingAdapterTimeout 值用于存根和适配器版本。 其余值用于内嵌版本。 存根版本不需要对此文件进行更改。

  5. 在命令提示符下，键入 SetConfigValuesInSSO.cmd并按 Enter 将值存储在 SSO 配置存储应用程序中。

  6. 在命令提示符下运行以下命令，在 SSO 中启用票证：

    • ssomanage -tickets yes yes

为面向服务的解决方案部署 BAM 定义

为服务导向解决方案部署 BAM 定义

  1. 在命令提示符下，键入以下命令，然后按 Enter。 这会设置查找 BAM 实用工具的路径：

    • SET PATH=%PATH%;%programfiles%\Microsoft BizTalk Server\Tracking

  2. 在命令提示符下，将目录更改为 %BTSSolutionsPath%\SO\BTSSoln\BAM 文件夹，然后键入以下命令，然后按 Enter：

    • bm deploy-all -DefinitionFile:ServiceLevelTracking.xml

      注释

      在支持用户帐户控制（UAC）的系统上，可能需要使用管理权限运行该工具。

部署面向服务的解决方案

部署面向服务的解决方案

  1. 打开命令提示符，将目录更改为 %BTSSolutionsPath%\SO\BTSSoln\Scripts 文件夹。

  2. 通过将“debug”和“development”的所有实例替换为“release”来修改 DeployStubBinding.cmd 文件。

  3. 打开命令提示符，将目录更改为 %BTSSolutionsPath%\SO\BTSSoln\Scripts 文件夹。 键入以下命令，然后按 Enter：

    • DeployStubBinding.cmd

  4. 在命令提示符下运行以下命令以启动存根版本的编排流程

    • Startstub.vbs

后续步骤

在 如何运行面向服务的解决方案中测试面向服务的存根版本的工作原理。

另请参阅

在安装面向服务的解决方案之前如何安装面向服务的解决方案的内联和适配器版本面向服务的解决方案的开发者机器设置