以下步骤介绍如何准备计算机以安装面向服务的内联解决方案和适配器版本,以及如何在此计算机上安装解决方案。
注释
- 面向服务的解决方案位于 BizTalk Server 安装文件夹>\SDK\Scenarios\SO 文件夹中<。
- 如果您的解决方案没有大型机,可以修改端口绑定以使用挂起事务的存根 Web 服务。 Web 服务在本地生成事务以模拟大型机事务。
准备计算机以安装面向服务的解决方案的适配器和内联版本
如果安装了 Windows SharePoint Services,请从 Windows SharePoint Services 托管路径中排除默认网站的(根),如下所示:单击 “开始”,指向 “所有程序”,指向 “管理工具”,然后单击“ SharePoint 管理中心”。
在 “虚拟服务器配置”下,选择“ 配置虚拟服务器设置”。
在 “虚拟服务器列表 ”页上,单击 “默认网站”。
在 “虚拟服务器设置” 页上,单击“ 定义托管路径”。
在“已定义托管路径”页的“包含的路径”部分中,选择“根”,然后单击“删除所选路径”。
在命令提示符下,执行 IISReset。
依次单击“ 开始”、“ 所有程序”、“ 管理工具”、“ 计算机管理控制台 ”,然后将 BizTalk 服务帐户添加到本地管理员组。
注销计算机,然后以 BizTalk 服务帐户身份登录到计算机。
在命令提示符处,键入以下命令,然后按 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 网站。
删除面向服务的解决方案的存根版本
按如下所示打开 BizTalk Server 管理控制台 :单击“ 开始”,指向 “所有程序”,指向 BizTalk Server,然后单击 “BizTalk Server 管理”。
在 BizTalk Server 管理控制台中,展开 BizTalk Server 管理、 BizTalk 组、 应用程序、右键单击 BTSScn.SO.CustomerService,然后单击“ 停止”。 在“ 停止应用程序 ”对话框中,选择 “完全停止 - 终止实例”,然后单击“ 停止”。
注释
无需删除用于安装内联和适配器版本的存根版本。 如果要将所有版本放在一起,应跳过此步骤。
打开命令提示符,键入以下命令,然后按 Enter。 此命令将默认脚本主机更改为 CScript.exe:
cscript /H:CScript
在命令提示符下,将当前目录更改为 %BTSSolutonsPath%\SO\BTSSoln\Scripts 文件夹,键入以下命令,然后按 Enter:
UnEnlistStub.vbs
在命令提示符下,键入以下命令,然后按 Enter:
UndeployStub.vbs
在命令提示符下运行以下命令
SET PATH=%PATH%;\Program Files (x86)\Microsoft BizTalk Server <VERSION>Tracking”
这会设置查找 BAM 实用工具的路径。
注释
如果使用 64 位计算机,请键入
%ProgramFiles(x86)%
而不是%ProgramFiles%
。在命令提示符下,将目录更改为 %BTSSolutionsPath%\SO\BTSSoln\BAM,然后运行以下命令:
bm remove-all -DefinitionFile:ServiceLevelTracking.xml
在命令提示符下,将目录更改为 <Enterprise Single Sign-On Install Directory>,然后运行以下命令:
ssomanage -tickets no no
在命令提示符下运行以下命令以删除 WoodgroveBank.CustomerService SSO 关联应用程序:
ssomanage -deleteapp WoodgroveBank.CustomerService
在命令提示符下运行以下命令,删除存根版本使用的网站。 有关 iisvdir.vbs 的详细信息,请参阅Microsoft TechNet 网站。https://go.microsoft.com/fwlink/?LinkId=67830
iisvdir /delete W3SVC/1/ROOT/Microsoft.Samples.BizTalk.WoodgroveBank.OrchProxy.Stub
iisvdir /delete W3SVC/1/ROOT/Microsoft.Samples.BizTalk.WoodgroveBank.StubSAP
iisvdir /delete W3SVC/1/ROOT/Microsoft.Samples.BizTalk.WoodgroveBank.StubPendingTransactions
iisvdir /delete W3SVC/1/ROOT/Microsoft.Samples.BizTalk.WoodgroveBank.StubPaymentTracker
启动 Internet Information Services (IIS) 管理器,如下所示:单击“ 开始”,指向 “所有程序”,指向 “管理工具”,然后单击“ Internet Information Services”(IIS)管理器。
- 展开 应用程序池,右键单击为以前的 Web 应用程序列出的应用程序池,单击“ 删除”,然后在确认对话框中单击“ 确定 ”。
单击“ 开始”,指向 控制面板,单击“ 添加或删除程序”,然后卸载适用于 Windows 的 IBM WebSphere MQ 客户端。
启动 Visual Studio 命令提示符 ,然后运行以下命令以删除为存根版本安装的 amqmdnet.dll。
gacutil /u amqmdnet
为服务导向的解决方案配置后端系统以便访问
在本地计算机上安装 IBM WebSphere MQ for Windows Server。
保留所有默认设置。 在准备 WebSphere MQ 向导结束时设置默认配置。 队列管理器命名为QM_<计算机名称>。
安装修补程序包 10 (CSD10)。 保留所有默认设置。
安装 MQSeries 代理。
重新运行 BizTalk Server 安装程序。
在 “程序维护 ”页上,选择“ 修改”,然后单击“ 下一步”。
在 “组件安装 ”页上,展开 “其他软件 ”节点,然后选择 MQSeries 代理。
在 “完成 ”页上,确保未选择 “启动 BizTalk MQSeries 代理配置向导 ”。
注释
只有在安装 IBM WebSphere MQ for Windows 后, 才会激活 MQSeries 代理 复选框。
打开 Visual Studio 命令提示符,将目录更改为 <IBM MQSeries 安装目录>\bin 文件夹,然后运行以下命令:
gacutil /i amqmdnet.dll
如果要安装 Microsoft Host Integration Server 2004 以访问大型机,请安装 Microsoft Visual Studio。 在安装程序的 “选项” 页上,选择 Visual C# .NET,然后清除其他组件复选框。 无需安装 Visual C# .NET 以外的其他组件。
注释
Host Integration Server 2004 中的 TI 设计器需要 Visual Studio .NET 2003。
如果要访问大型机,请安装和配置 Microsoft Host Integration Server 2004。 保留所有默认设置。
创建 MQSeries 队列
打开 WebSphere MQ 资源管理器,展开 队列管理器,然后展开要在其中创建队列的队列管理器。 通常,队列管理器命名为QM_<计算机名称>。
在 WebSphere MQ 资源管理器中,右键单击“ 队列”,指向“ 新建”,单击“ 本地队列”,然后为解决方案的适配器版本创建以下本地队列:
AdapterSOAInputQueue
适配器SOA输出队列
注释
队列可以共享 MQSeries 群集,但不需要这样做。
注释
MQSeries 队列管理器名称和队列名称区分大小写。
重复上一步,为内联版本创建以下本地队列:
InlineSOAOutputQueue
InlineSOAInputQueue
重复上一步,为付款跟踪器模拟器创建以下本地队列。 (适配器和内联版本均使用付款跟踪器模拟器):
LastPaymentsInputQueue
最后支付输出队列
MQSeries 适配器的完整配置
依次单击“ 开始”、“ 所有程序”、“ Microsoft BizTalk Server 20xx”,然后单击 “BizTalk MQSeries 代理配置向导”。
在“欢迎”页面上,单击“下一步”。
在 “应用程序标识 ”页上,选择“ 此用户”,然后输入用户名和密码。 MQSeries 代理的 COM+ 应用程序将在此用户帐户下运行。 对于本演练,请使用 BizTalk 服务正在使用的同一用户帐户。 否则,托管 MQSeries 适配器的 BizTalk 服务的用户帐户必须添加到 COM+ 应用程序的 CreatorOwner 角色。
如果系统提示你在上一步中输入的用户帐户具有管理权限,请在 MQSConfigWiz 对话框中单击“是”。
在“ 角色名称 ”页上,单击“ 下一步”。
在“创建 MQSAgent COM+ 应用程序”页上,单击“下一步”,然后单击“完成”页上的“完成”。
配置大型机 CICS 应用程序
使用记事本,在 %BTSSolutionsPath%\SO\MFAccess\HISTIComponent 文件夹中打开 bizcbl.txt 及其“复制书”(MainFrameProgramVTCS2Description.txt),然后查看内容。
Bizcbl.txt 包括一个 COBOL 过程,用于从输入的账户号中返回随机生成的账户对账单。
MainFrameProgramVTCS2Descriptoin.txt 包含 COMMAREA,用于描述输入和输出数据信息。 COMMAREA 是一个连续内存块,用于在被调用方和调用方程序之间传递数据。
注释
您还可以使用拷贝簿,通过 Visual Studio 和 TI 设计器插件生成事务集成器(TI)元数据文件。
注释
尽管以下步骤对于成功部署至关重要,但通常不会由 BizTalk Server 开发人员执行。 您需要依赖大型机人员来正确配置大型机环境。 本演练所需的软件通常安装在大多数大型机环境中。 有关最小大型机作系统环境的详细信息,请参阅 Host Integration Server 文档。
通过 FTP 等方法将 COBOL 代码复制到主机。
编译 COBOL 代码并复制书籍。 以下代码演示 COBOL 编译器的作业控制语言(JCL)示例。
//COB EXEC PGM=IGYCRCTL, // PARM=&COBPARM, // REGION=® //STEPLIB DD DSN=&COMPINDX..SIGYCOMP,DISP=SHR //SYSLIB DD DSN=&INDEX..SDFHCOB,DISP=SHR // DD DSN=&INDEX..SDFHMAC,DISP=SHR // DD DSN=&HLQ..&COMP..COBCOPY,DISP=SHR //SYSPRINT DD SYSOUT=&OUTC //*SYSPRINT DD DSN=&&INPUT,DISP=(,PASS),UNIT=SYSDA, //* SPACE=(TRK,(100,50)), //* DCB=(DSORG=PS,LRECL=121,BLKSIZE=2420,RECFM=FBA) //SYSIN DD DSN=&&SYSCIN,DISP=(OLD,DELETE) //SYSLIN DD DSN=&&LOADSET, // DISP=(MOD,PASS), // UNIT=&WORK, // SPACE=(80,(250,100)) //SYSUT1 DD UNIT=&WORK,SPACE=(460,(350,150)) //SYSUT2 DD UNIT=&WORK,SPACE=(460,(350,150)) //SYSUT3 DD UNIT=&WORK,SPACE=(460,(350,150)) //SYSUT4 DD UNIT=&WORK,SPACE=(460,(350,150)) //SYSUT5 DD UNIT=&WORK,SPACE=(460,(350,150)) //SYSUT6 DD UNIT=&WORK,SPACE=(460,(350,150)) //SYSUT7 DD UNIT=&WORK,SPACE=(460,(350,150))
编辑已编译的源代码以创建可执行文件。 以下代码显示了 COBOL 链接编辑的 JCL 示例。
//LKED EXEC PGM=IEWL,REGION=®, // PARM=&LNKPARM,COND=(5,LT,COB) //SYSLIB DD DSN=&INDEX..SDFHLOAD,DISP=SHR // DD DSN=CEE.SCEELKED,DISP=SHR // DD DSN=&TCPINDX..SEZATCP,DISP=SHR //SYSLMOD DD DSN=&LMINDX..&COMP..LOADLIB,DISP=SHR //SYSUT1 DD UNIT=&WORK, // DCB=BLKSIZE=1024, // SPACE=(1024,(200,20)) //SYSPRINT DD SYSOUT=&OUTC //SYSLIN DD DSN=&&LOADSET,DISP=(OLD,DELETE) // DD DSN=&©LINK,DISP=(OLD,DELETE)
配置 CICS 大型机应用程序。
在此步骤中,大型机系统程序员或 CICS 开发人员必须安装 TCPIPSERVICE、会话、连接、事务和程序资源定义。
应咨询大型机管理员以获取可以访问的 IP 地址、端口号和程序名称。
注释
本演练假定大型机使用 CICS 应用程序服务器,并且事务的编程模型为 TCP/IP(增强侦听器模式 (ELM) 链接)。
为安全套接字层配置 Web 服务器 (SSL)
安装证书服务
单击“开始”,指向控制面板,然后单击“添加或删除程序”。
在“ 添加或删除程序 ”对话框中,单击“ 添加/删除 Windows 组件”。
在 Windows 组件向导中,选择 证书服务,单击“ 下一步”,然后按照屏幕上的说明完成安装。
创建证书请求
在 Internet Information Services (IIS) 管理器中,展开 “网站”,右键单击 “默认网站”,单击“ 属性”,单击“ 目录安全性 ”选项卡,然后单击“ 服务器证书”。
在 Web 服务器证书向导的“欢迎”页上,单击“下一步”。
在 “服务证书 ”页上,选择“ 创建新证书”,然后单击“ 下一步”。
在 “延迟或即时请求 ”页上,单击“ 立即准备请求”,但稍后发送请求,然后单击“ 下一步”。
在 “名称和安全设置” 页上,保留所有默认设置,然后单击“ 下一步”。
在 “组织信息 ”页上,键入公司的组织和组织单位名称,然后单击“ 下一步”。
在 “站点的公用名 ”页上,在 “公用名 ”框中键入计算机名称,然后单击“ 下一步”。
在 “地理信息 ”页上,填写地理信息,然后单击“ 下一步”。
在“ 证书请求文件名 ”页上,键入
c:\certreq.txt
“ 文件名 ”框,然后单击“ 下一步”。在 “请求文件摘要 ”页上,单击“ 下一步”,然后单击“ 完成 ”页上的“ 完成 ”。
将证书请求提交到证书颁发机构
在 Internet Explorer 的“地址”框中,键入
http://localhost/certsrvt
,然后按 Enter。在“欢迎”页上,单击“请求证书”,然后在“请求证书”页上单击“高级证书请求”。
在 “高级证书请求 ”页上,单击“ 使用 base64 编码的 PKCS #10 文件提交证书请求”,或使用 base64 编码的 PKCS #7 文件提交续订请求。
复制 c:\certreq.txt 在“创建证书请求”过程中创建的所有文本,将其粘贴到“提交证书请求或续订请求”页上的“保存的请求”框,然后单击“提交”。
使用证书颁发机构管理工具颁发证书
单击“ 开始”,指向 “管理工具”,然后单击“ 证书颁发机构”。
在 证书颁发机构 控制台中,展开证书颁发机构的名称,展开 “挂起的请求”,右键单击在上一步中提交的证书请求,指向 “所有任务”,然后单击“ 颁发”。
关闭证书颁发机构控制台。
将证书下载到 Web 服务器
在 Internet Explorer 的“地址”框中,键入
http://localhost/certsrvt
,然后按 Enter。在 “欢迎 ”页上,单击“ 查看挂起的证书请求的状态”。
在“查看挂起证书请求状态”页上,单击在“创建证书请求”过程中创建的证书请求。
在 “证书颁发 ”页上,选择任一编码方案,然后单击“ 下载证书”。
在“ 安全警告 ”对话框中,单击“ 保存”,然后将证书另存为 c:\certnew.cer。
将证书安装到 Web 服务器
在 Internet Information Services (IIS) 管理器中,展开 “网站”,右键单击为其创建了证书请求 的默认网站 ,然后单击“ 属性”。
在“ 属性 ”对话框中,单击“ 目录安全性 ”选项卡,然后单击“ 服务器证书”。
在 Web 服务器证书向导的“欢迎”页上,单击“下一步”。
在“ 挂起的证书请求 ”页上,选择“ 处理挂起的请求并安装证书”,然后单击“ 下一步”。
在“处理挂起的请求”页上,键入
c:\certnew.cer
“路径”和“文件名”文本框,然后单击“下一步”。在 SSL 端口页上单击“下一步”,单击“证书摘要”页上的“下一步”,然后单击“确认”页上的“完成”。
注释
在本演练中,无需将服务器证书安装到本地计算机上的受信任根证书颁发机构存储,因为证书服务和 Web 服务器都安装在同一台计算机上。
为后端系统创建 Web 服务
在 Internet Information Services (IIS) 管理器中,右键单击 “应用程序池”,选择“ 新建”,然后选择 “应用程序池”。
注释
面向服务的解决方案通过此 Web 服务访问大型机。
在“ 添加新应用程序池 ”对话框中,输入 应用程序池 ID (任何值),然后单击“ 确定”。
在 Internet Information Services (IIS) 管理器中,右键单击刚刚创建的应用程序池,然后选择“ 属性”。
在“属性”页上,单击“标识”选项卡,选择“可配置”,输入用户名和密码,然后单击“确定”。 对于本演练,请使用 BizTalk 服务正在使用的同一用户帐户。
为运行时创建 PendingTransactions Web 服务
在 Internet Information Services (IIS) 管理器中,展开 “网站”,右键单击 “默认网站”,指向“ 新建”,然后单击“ 虚拟目录 ”以运行 虚拟目录创建向导。
使用 虚拟目录创建向导,为存根 SAP Web 服务创建以下虚拟目录:
别名 = Microsoft.Samples.BizTalk.WoodgroveBank.PendingTransactions
PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\MFAccess\PendingTransactions
访问权限 = 读取、运行脚本
在 Internet Information Services (IIS) 管理器中,展开 “网站”,展开 “默认网站”,右键单击Microsoft.Samples.BizTalk.WoodgroveBank.PendingTransactions,然后单击“ 属性”。
在 “目录安全性 ”选项卡中,单击“ 编辑 ”以修改 身份验证和访问控制。 选择 “基本身份验证”(密码以明文形式发送),并清除其他 身份验证访问 复选框。 单击“ 确定 ”关闭 “身份验证方法 ”对话框。
在“目录安全性”选项卡中,单击“安全通信组”框下的“编辑”,然后在“安全通信”对话框中选中“需要安全通道”(SSL)。
在 “虚拟目录 ”选项卡中,将 应用程序池 设置为在“为挂起的事务 Web 服务创建新的 IIS 应用程序池”过程中创建的应用程序池。
为开发环境创建 PendingTransactions Web 服务
在 Internet Information Services (IIS) 管理器中,展开 “网站”,右键单击 “默认网站”,指向“ 新建”,然后单击“ 虚拟目录 ”以运行 虚拟目录创建向导。
使用 虚拟目录创建向导,为存根 SAP Web 服务创建以下虚拟目录:
Alias = 待处理交易
PATH = <BizTalk 安装目录>\SDK\Scenarios\SO\MFAccess\PendingTransactions
访问权限 = 读取、运行脚本
在 Internet Information Services (IIS) 管理器中,展开 “网站”,展开“ 默认网站”,右键单击“PendingTransactions”,然后单击“ 属性”。
在 “目录安全性 ”选项卡中,单击“ 编辑 ”以修改 身份验证和访问控制。 选择“ 启用匿名访问”。 单击“ 确定 ”退出。
注释
用于开发环境的 PendingTransactions Web 应用程序将由 Visual Studio 使用。 无需此 Web 应用程序用于生产环境。
在 “虚拟目录 ”选项卡中,将 应用程序池 设置为在“为挂起的事务 Web 服务创建新的 IIS 应用程序池”过程中创建的应用程序池。
创建存根 SAP Web 服务
在 Internet Information Services (IIS) 管理器中,展开 “网站”,右键单击 “默认网站”,指向“ 新建”,然后单击“ 虚拟目录 ”以运行 虚拟目录创建向导。
使用 虚拟目录创建向导,为存根 SAP Web 服务创建以下虚拟目录:
Alias = Microsoft.Samples.BizTalk.WoodgroveBank.StubSAP
PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\StubWebServices\SAP
访问权限 = 读取、运行脚本
在 Internet Information Services (IIS) 管理器中,展开 “网站”,展开 “默认网站”,右键单击“Microsoft.Samples.BizTalk.WoodgroveBank.StubSAP”,单击“ 属性”,然后修改设置,如下所示:
在“虚拟目录”选项卡中,将应用程序池设置为<在“为挂起的事务 Web 服务创建新的 IIS 应用程序池”过程中创建的 YourAppPool>。
在“目录安全性”选项卡中,单击“身份验证和访问控制组”框中的“编辑”,然后选择“启用匿名访问”。 单击“ 确定 ”退出。
为面向服务的解决方案创建 TI 组件
为 TI 组件创建 COM+ 应用程序
在命令提示符处,运行 %systemroot%\system32\com\comexp.msc。
在组件服务控制台中,依次展开组件服务、计算机、我的计算机,右键点击COM+ 应用程序,指向新建,然后单击应用程序。
在“欢迎”页上,单击“下一步”,然后在“安装”或“创建新应用程序”页上单击“创建空应用程序”。
在“
BTSScn SO TI Component
输入新应用程序”框的名称中,选择“服务器应用程序”作为激活类型,然后单击“下一步”。在“设置应用程序标识”页的“帐户”组中,选择“此用户”,然后在“用户和密码”框中键入用户名和密码。 新的 COM+ 应用程序将在此用户帐户下运行。 此用户帐户必须是本地 HIS 运行时用户组的成员。 对于本演练,请使用 BizTalk 服务正在使用的同一用户帐户。
在“ 添加应用程序角色 ”页上,单击“ 下一步”。
在“ 将用户添加到角色 ”页上,展开 CreatorOwner,单击“ 用户”,然后单击“ 添加”。
在“ 选择用户或组 ”对话框中,选择将用于访问大型机的用户帐户。 对于本次操作指南,请添加 UserID 本地帐户。
注释
若要通过 TI 组件访问 CICS 事务,可以使用托管 .NET 远程处理组件的 COM+ 应用程序或 Web 应用程序。 本演练使用适用于 TI 组件的 COM+ 应用程序和 COM 互作来访问大型机以提高性能。
在“完成”页上,单击“完成”。
创建远程环境以访问大型机
单击“ 开始”,指向 “所有程序”,指向 “Microsoft Host Integration Server 2004”,然后单击 “TI 管理器”。
在 TI 管理器 控制台中,单击 “事务集成器”(配置),展开 Windows 发起的处理,右键单击“ 远程环境”,指向“ 新建”,然后单击“ 远程环境”。
在“欢迎”页面上,单击“下一步”。
在 “配置新远程环境 ”页上,键入 远程应用程序名称,然后单击“ 下一步”。 对于本演练,请使用名称Mainframe_TCP。
在“配置主机环境和编程模型”页上,选择目标主机的 CICS 和编程模型的ELM 链接,然后单击“下一步”。
在“配置终结点 TCP/IP”页上,在“IP/DNS 地址”框中键入大型机的 IP 地址,然后单击“编辑”添加端口号。 HIS COM 将通过终结点地址访问交易。
在“完成”页上,单击“完成”。
为面向服务的解决方案创建 TI 组件
单击“ 开始”,指向 “所有程序”,指向 “Microsoft Host Integration Server 2004”,然后单击 “TI 管理器”。
在 TI 管理器 控制台中,单击 “事务集成器”(配置),单击 “Windows 发起的处理”,然后单击“ 对象”。 右键单击 “对象”,单击“ 新建”,然后单击“ 对象”。
在“欢迎”页面上,单击“下一步”。
在“ 指定或查找对象 ”页上,单击“ 浏览”,在 %BTSSolutionsPath%\SO\MFAccess\HISTIComponent 文件夹中选择 SOHISTIUSingCOM.TLB,然后单击“ 下一步”。
在“为 COM 对象定义环境特征”页上,选择 COM+ 应用程序的BTSScn SO TI 组件,然后单击“下一步”。
在“ 定义远程环境 ”页上,选择在上一过程中为 远程环境创建的远程环境,然后单击“下一步”。
在“创建 WIP 对象”页上,单击“下一步”,然后单击“完成”页上的“完成”。
测试与大型机的连接
在 Windows 资源管理器中,浏览到 %BTSSolutionsPath%\SO\MFAccess\HISTISimpleTester folder, and then double-click the Interop.SOHISTIUsingCOM.dll.reg 文件。 这将为 HISTISimpleTester 应用程序添加注册表值,以通过运行时可调用包装器(RCW)调用 TI 组件。
在 Windows 资源管理器中,导航到 %BTSSolutionsPath%\SO\MFAccess\ folder, and then run SetupMFAccess.bat。
在 Windows 资源管理器中,导航到 %BTSSolutionsPath%\SO\MFAccess\HISTISimpleTester\bin\Debug folder, and then run BTSScnSOHISTIComponentSimpleTester.exe。
- 在 HISTISimpleTester 应用程序中,单击“ 调用大型机程序 - 使用 COM”。 它从大型机上运行的 COBOL 应用程序返回五条记录。
为编排 Web 服务创建虚拟目录
在 Internet Information Services (IIS) 管理器中,右键单击 “应用程序池”,选择“ 新建”,然后选择 “应用程序池”。
在“ 添加新应用程序池 ”对话框中,输入 应用程序池 ID (任何值),然后单击“ 确定”。
右键单击刚刚创建的应用程序池,然后选择“ 属性”。
在“属性”页上,单击“标识”选项卡,选择“可配置”,输入用户名和密码,然后单击“确定”。 对于本演练,请使用 BizTalk 服务正在使用的同一用户帐户。
注释
此用户必须具有执行业务流程代理 Web 服务的权限,并且必须添加到 BizTalk Server 管理员、SSO 管理员或 SSO 关联管理员组之一
在 Internet Information Services (IIS) 管理器中,展开 “网站”,右键单击 “默认网站”,指向“ 新建”,然后单击“ 虚拟目录 ”以运行 虚拟目录创建向导。
使用 虚拟目录创建向导,为适配器版本的代理 Web 服务创建以下虚拟目录:
别名 = Microsoft.Samples.BizTalk.WoodgroveBank.OrchProxy.Adapter
PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\OrchProxy\Adapter
访问权限 = 读取、运行脚本
在 Internet Information Services (IIS) 管理器中,展开 “网站”, 展开 “默认网站”,右键单击Microsoft.Samples.BizTalk.WoodgroveBank.OrchProxy.Adapter,单击“ 属性”,然后修改设置,如下所示:
在“虚拟目录”选项卡中,将应用程序池设置为<在上一步中创建的 YourAppPool>。
在“目录安全性”选项卡中,单击“身份验证和访问控制组”框中的“编辑”,选择“仅启用集成 Windows 身份验证”,然后清除其他身份验证访问复选框。 单击“ 确定 ”退出。
在 Internet Information Services (IIS) 管理器中,展开 “网站”,右键单击 “默认网站”,指向“ 新建”,然后单击“ 虚拟目录 ”以运行 虚拟目录创建向导。
使用 虚拟目录创建向导,为内联版本的代理 Web 服务创建以下虚拟目录:
Alias = Microsoft.Samples.BizTalk.WoodgroveBank.OrchProxy.Inline
PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\OrchProxy\Inline
访问权限 = 读取、运行脚本
在 Internet Information Services (IIS) 管理器中,展开 “网站”,展开 “默认网站”,右键单击Microsoft.Samples.BizTalk.WoodgroveBank.OrchProxy.Inline,单击“ 属性”,然后修改设置,如下所示:
在“虚拟目录”选项卡上,将应用程序池设置为<刚刚创建的 YourAppPool>。
单击“目录安全性”选项卡,在“身份验证和访问控制组”框中单击“编辑”,选择“仅启用集成 Windows 身份验证”,然后清除其他身份验证访问复选框。 单击“ 确定 ”退出。
生成面向服务的解决方案
在命令提示符下,将目录更改为 %BTSSolutionsPath%\SO\BTSSoln,键入
SetupBTSSoln.bat
,然后按 Enter。 SetupBTSSoln.bat 执行以下任务:创建一个唯一的强名称密钥(SNK),用于为 SO 解决方案的程序集签名。
从 SNK 中提取公钥令牌,并使用公共令牌更新绑定文件。
生成 SO 解决方案。
在 %BTSSolutionsPath%\Common 文件夹中生成 SSOApplicationConfig。
创建 SSO 关联应用程序
打开命令提示符,然后将目录更改为 %BTSSolutionsPath%\SO\BTSSoln\Scripts 文件夹。
在命令提示符下,使用记事本打开 PendTransAffApp.xml,并查看它。 无需对此文件进行更改。
注释
PendTransAffApp.xml 文件为事务挂起的后端系统定义了 SSO 关联应用程序 WoodgroveBank.PendingTransactions。 它还定义 SSO 关联应用程序的用户和管理组。 对于本演练,请使用 BizTalk 应用程序用户 和 BizTalk 服务器管理员。
如果要对 SSO 关联应用程序使用不同的组,则需要在 Active Directory 中创建 Windows 组(具有任意名称),然后在 PendTransAffApp.xml中更改 appAdminAccount 和 appUserAccount 节点。 如果执行此作,则应将标志节点的 groupApp 属性的值设置为“yes”。
有关 SSO 关联应用程序的详细信息,请参阅 SSO 关联应用程序。
在命令提示符下,使用记事本打开 PendTransUserMap.xml 文件,然后进行以下编辑:
<mapping> <windowsDomain><DomainName></windowsDomain> <windowsUserId><UserID></windowsUserId> <externalUserId><ExternalUserID></externalUserId> </mapping>
注释
PendTransUserMap.xml 文件包含挂起事务后端系统的用户映射。
注释
对于 externalUserId 节点,请使用挂起事务后端系统的外部用户 ID。 在本次演练中,请将 UserID 用作外部 ID。
注释
对于 windowsUserId 节点,输入 externalUserId 将映射到的用户名。 可以使用域组和域用户帐户。 此用户必须是允许使用挂起事务后端系统的组的成员。 对于本演练,请使用 BizTalk 服务的用户名。
注释
对于 windowsDomain 节点,输入 windowsUserId 的域名。
在命令提示符下,使用记事本打开 PmntTrckAffApp.xml 文件,并查看文件的内容。 无需对此文件进行更改。
注释
PmntTrckAffApp.xml 文件为付款跟踪器后端系统定义 SSO 关联应用程序 WoodgroveBank.PaymentTracker。
在命令提示符下,使用记事本打开 PmntTrckUserMap.xml 文件,然后进行以下编辑:
<mapping> <windowsDomain><DomainName></windowsDomain> <windowsUserId><UserID></windowsUserId> <externalUserId><ExternalUserID></externalUserId> </mapping>
注释
付款跟踪器 SSO 关联应用程序将用于 MQSeries 适配器,映射的外部用户 ID/密码通过 MQSeries 标头属性发送。 MQSeries 服务器仅验证运行 MQSeries 适配器的 BizTalk 服务帐户。 它不会验证任何外部用户凭据。
有关 MQSeries 适配器的 SSO 关联应用程序的详细信息,请参阅 如何配置 MQSeries 适配器接收位置和发送端口。
注释
PmntTrckUserMap.xml 文件包含付款跟踪器后端系统的 SSO 用户映射。 付款跟踪器模拟器程序模拟用户身份验证的成功和失败情况。
程序成功对所有以PT开头的用户 ID(例如PTUserID)进行身份验证,并且无法对不以PT开头的任何用户 ID 进行身份验证。 这使你可以根据要测试的条件来选择适当的用户 ID。 还可以对每个用户 ID 重复整个 映射 节点,并在同一文件中定义多个映射。
注释
对于 externalUserId 节点,输入付款跟踪器后端系统的外部用户 ID。 对于本操作指南,请使用 PTUserID 作为外部标识符。
注释
对于 windowsUserId 节点,输入 externalUserId 将映射到的用户名。 此用户必须是允许使用付款跟踪器后端系统的组的成员。 对于本演练,请使用 BizTalk 服务的用户名。
注释
对于 windowsDomain 节点,输入 windowsUserId 的域名。
在命令提示符下,使用记事本打开 ConfigStoreApp.xml 文件,然后查看文件的内容。
此文件在 SSO 中定义配置存储应用程序,该方案使用该应用程序来保留配置参数。 某些配置参数包括与 SAP 通信时的超时值(适用于适配器和内联版本),以及使用内联版本时要使用的队列管理器和队列的名称。 无需对此文件进行更改。
在命令提示符处,使用记事本打开SetConfigValuesInSSO.cmd文件,查看并更改文件的内容,如下表所示。
注释
此命令文件设置 SSO 数据库中配置参数的值。 它包含多个集命令,这些命令将值分配给命令文件的开头的局部变量。
SAPAdapterTimeout、PendingTransactionsAdapterTimeout 和 PaymentTrackingAdapterTimeout 值用于适配器版本。 其余值用于内嵌版本。
注释
可以在下表中为标记为<用户指定>的默认值输入“ ”(两个双引号)。
参数 默认值 DESCRIPTION SAPAdapterTimeout 20000 请求 SAP 后端的最大超时时间(毫秒) SAPInlineTimeout 20000 请求 SAP 后端的最大超时时间(以毫秒为单位) SAPInlineHostName <用户指定> SAP 后端标识符 SAP内嵌客户端编号 <用户指定> SAP 客户端编号 SAP内联系统号 <用户指定> SAP 系统编号 SAPInlineUserName <用户指定> 用于连接到 SAP 后端的用户名 SAPInlinePassword <用户指定> 用于连接到 SAP 后端的密码 待处理交易适配器超时 20000 对待处理事务服务器请求的最大超时(毫秒) PendingTransactionsInlineTimeout 20000 请求挂起事务服务器的最大超时时间(毫秒) PendingTransactionsInlineURL < https://您的计算机名称>/Microsoft.Samples.BizTalk.WoodgroveBank.PendingTransactions/PendTransWS.asmx 挂起的事务服务的 URL。 < 计算机名称> 必须与“创建证书请求”过程中的 公用名 匹配。 不得将“localhost”用于 <计算机名称>。 待处理事务内联SSO关联应用程序 WoodgroveBank.待处理交易 挂起的事务 SSO 应用程序名称 支付跟踪适配器超时 20000 请求付款跟踪系统的超时时间上限(以毫秒计) PaymentTrackingInlineTimeout 20000 请求付款跟踪系统的最大超时时间(毫秒) PaymentTrackingInlineQManager <用户指定> (通常QM_<计算机名称>)。 MQSeries 队列管理器名称 PaymentTrackingInlineMQChannelDefinition “(需要输入两个双引号)。 如果是本地,则为空字符串;如果是远程 MQ 服务器,则为格式化的通道名称。 如果在配置 IBM WebSphere MQ 时保留所有默认设置,通道定义将S__<计算机名称>/TCP/<计算机名称>(1414)。 PaymentTrackingInlineRequestQueue LastPaymentsInputQueue 付款跟踪请求的 MQ 队列名称 PaymentTrackingInlineResponseQueue 最后支付输出队列 用于支付跟踪响应的 MQ 队列名称 支付跟踪内联SSO会员应用 WoodgroveBank.付款追踪器 付款跟踪 SSO 应用程序名称 StubSAPWebServiceURL http://localhost/Microsoft.Samples.BizTalk.WoodgroveBank.StubSAP/StubSAPWS.asmx 信用额度限制 SAP 系统的存根 Web 服务 URL 在命令提示符下运行以下命令以设置 PATH 环境:
SET PATH=%PATH%;"%CommonProgramFiles%\Enterprise Single Sign-On"
在命令提示符处,运行CreateInitialConfigInSSO.cmd。 它创建 SSO 关联应用程序、SSO 配置存储应用程序和关联应用程序的用户映射。 然后,它会执行SetConfigValuesInSSO.cmd,将配置值存储在 SSO 配置存储应用程序中。
在命令提示符下运行以下命令,为Pending Transactions关联应用程序设置用户凭据。 使用在 PendTransUserMap.xml 中定义的 DomainName> 和 <UserID>,用于 <WindowsDomain>\<WindowsUserId>。 此命令要求输入本演练中使用的外部用户 UserID 的密码。
ssomanage -setcredentials <WindowsDomain>\<WindowsUserId> WoodgroveBank.PendingTransactions
在命令提示符下运行以下命令,为付款跟踪器关联应用程序设置用户凭据。 <使用在 windowsDomain>\<WindowsUserId 的 PmntTrckUserMap.xml <中定义的 DomainName> 和 <UserID>>。 此命令要求输入本演练中使用的外部用户 PTUserID 的密码。
注释
付款跟踪器模拟器不会验证外部用户凭据。 可以为 PTUserID 输入任何密码。
ssomanage -setcredentials < WindowsDomain >\< WindowsUserId > WoodgroveBank.PaymentTracker
为面向服务的解决方案部署 BAM 定义文件
打开命令提示符,键入以下命令,然后按 Enter 设置路径以查找 BAM 实用工具:
- SET PATH=%PATH%;\Program Files (x86)\Microsoft BizTalk Server <VERSION>Tracking”
在命令提示符下,将目录更改为 %BTSSolutionsPath%\SO\BTSSoln\BAM,键入以下命令,然后按 Enter:
bm deploy-all -DefinitionFile:ServiceLevelTracking.xml
部署面向服务的解决方案
更新面向服务的解决方案的绑定文件
在命令提示符下,使用记事本将目录更改为 %BTSSolutionsPath%\SO\BTSSoln\Scripts folder, open the Deployallbinding.xml,然后进行以下编辑:
将服务器名称在 SET MGMT_DB_SERVER 和 MBMT_DB 中更改为 BizTalk Server 正在使用的服务器和数据库名称。
将 SOLNDIR 变量的值更改为“%BTSSolutionsPath%\SO\BTSSoln”。
在命令提示符下,将目录更改为 %BTSSolutionsPath%\SO\BTSSoln\Bindings 文件夹。
对于适配器版本,请使用记事本打开 AdapterSOAOrchBindings.xml,然后按如下所示进行编辑:
将所有出现的 _MQ_SERVER_NAME\_ 替换为 MQSeries 服务器名称。
将 _MQ_QMANAGER_NAME\_ 的所有匹配项替换为 MQSeries 队列管理器名称。
将字符串“<Address>https://_PT_WS_SERVER_NAME\_”中所有_PT_WS_SERVER_NAME\_的出现替换为挂起事务 Web 服务所部署的服务器名称。 服务器名称必须与步骤“为 SSL 配置 Web 服务器”中的公用名匹配。 不应使用 localhost。
注释
绑定文件 AdapterSOAOrchBindings.xml使用存根 Web 服务:
信用额度管理后端 SAP 系统。 2. MQSeries 适配器用于集成付款跟踪后端系统。 3.待处理事务 Web 服务调用 HIS TI .NET 组件以与大型机后端系统集成。
如果您不使用主机,则必须使用模拟Web服务为待处理事务系统生成数据。
对于内嵌版本,请使用记事本打开InlineSOAOrchBindings.xml,然后按照以下步骤进行编辑:
将所有出现的 _MQ_SERVER_NAME\_ 替换为 MQSeries 服务器名称。
将 _MQ_QMANAGER_NAME\_ 的所有匹配项替换为 MQSeries 队列管理器名称。
部署面向服务的解决方案
在命令提示符下,将目录更改为 %BTSSolutionsPath%\SO\BTSSoln\Scripts 文件夹,键入以下命令,然后按 Enter。
Deployallbinding.cmd
注释
Deployallbinding.cmd创建名为 BTSScn.SO.CustomerService 的 BizTalk 应用程序,并导入适配器和内联版本的绑定文件。
在大型机不可用时,配置挂起事务存根的 Web 服务
配置存根挂起的事务 Web 服务(用于不使用大型机的适配器版本)
在 Internet Information Services (IIS) 管理器中,展开 “网站”,右键单击 “默认网站”,指向“ 新建”,然后单击“ 虚拟目录 ”以运行 虚拟目录创建向导。
使用 虚拟目录创建向导,为适配器版本的待处理事务存根网页服务创建以下虚拟目录:
Alias = Microsoft.Samples.BizTalk.WoodgroveBank.StubPendingTransactions
PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\StubWebServices\PendingTrans
访问权限 = 读取、运行脚本
在 Internet Information Services (IIS) 管理器中,展开 “网站”,展开“ 默认网站”,右键单击Microsoft.Samples.BizTalk.WoodgroveBank.StubPendingTransactions,单击“ 属性”,然后使用“ 属性 ”对话框修改设置,如下所示。
在“虚拟目录”选项卡中,将应用程序池设置为<在步骤中创建的 YourAppPool>,“若要在 IIS 中为解决方案创建虚拟目录”。
在“目录安全性”选项卡中,单击“身份验证和访问控制组”框中的“编辑”,然后选择“启用匿名访问”。 单击“ 确定 ”退出。
在 BizTalk Server 管理控制台中,展开 BizTalk 组、应用程序、BTSScn.SO.CustomerService、发送端口,然后右键单击 PendingTransactionSolicitResponsePort 并选择 属性。
在“常规”页面中,单击“配置”以显示“传输属性”对话框,然后将Web 服务 URL修改为挂起事务的存根 Web 服务,例如:
http://localhost/Microsoft.Samples.BizTalk.WoodgroveBank.StubPendingTransactions/StubPendTransWS.asmx
关闭所有对话框。
配置模拟挂起事务的 Web 服务(用于不依赖大型主机的内联版本)
在 Internet Information Services (IIS) 管理器中,展开 “网站”,右键单击 “默认网站”,指向“ 新建”,然后单击“ 虚拟目录 ”以运行 虚拟目录创建向导。
使用 虚拟目录创建向导,为适配器版本的存根挂起事务 Web 服务创建以下虚拟目录:
Alias = Microsoft.Samples.BizTalk.WoodgroveBank.StubPendingTransactions
PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\StubWebServices\PendingTrans
访问权限 = 读取、运行脚本
在 Internet Information Services (IIS) 管理器中,展开 “网站”,展开 “默认网站”,右键单击Microsoft.Samples.BizTalk.WoodgroveBank.StubPendingTransactions,单击“ 属性”,然后修改设置,如下所示:
在“虚拟目录”选项卡中,将应用程序池设置为<在步骤中创建的 YourAppPool>,“若要在 IIS 中为解决方案创建虚拟目录”。
在“目录安全性”选项卡中,单击“身份验证和访问控制组”框中的“编辑”,然后选择“启用匿名访问”。 单击“ 确定 ”退出。
打开命令提示符,然后将目录更改为 %BTSSolutionsPath%\SO\BTSSoln\Scripts 文件夹。
在命令提示符下,使用记事本打开SetConfigValuesInSSO.cmd文件,然后将 PendingTransactionsInlineURL 的值设置为存根挂起事务 Web 服务的 URL。
http://localhost/Microsoft.Samples.BizTalk.WoodgroveBank.StubPendingTransactions/StubPendTransWS.asmx
在命令提示符下,键入
SetConfigValuesInSSO.cmd
,然后按 Enter。
启动面向服务的解决方案
打开命令提示符,将目录更改为 %BTSSolutionsPath%\SO\BTSSoln\Scripts 文件夹,键入以下命令,然后按 Enter 以启动内联和适配器版本的所有业务流程。
startAll.vbs
运行面向服务的解决方案。 有关运行解决方案的详细信息,请参阅 如何运行面向服务的解决方案。
后续步骤
在 “如何运行面向服务的解决方案”中测试面向服务的内联和适配器版本。