次の手順では、サービス指向ソリューションのスタブ バージョンをインストールする前にコンピューターを準備する方法と、ソリューションをコンピューターにインストールする方法について説明します。
サービス指向ソリューションのスタブ バージョンをインストールするためのコンピューターを準備する
サービス指向ソリューションのスタブ バージョンをインストールするためのコンピューターを準備するには
既定の Web サイトが ASP.NET 2.X を使用するように構成されていることを確認します。
[ スタート] をクリックし、[ すべてのプログラム] をポイントし、[ 管理ツール] をポイントして、[ インターネット インフォメーション サービス (IIS) マネージャー] をクリックします。
インターネット インフォメーション サービス (IIS) マネージャーで、コンピューター名、サイトの展開、既定の Web サイトの展開、aspnet_client展開、system_web展開します。
サブフォルダーが 2.X であることを確認します。
[スタート] をクリックし、[すべてのプログラム] をポイントし、[管理ツール] をポイントして、[Services] をクリックします。 サービス コンソールを使用して、次のサービスが実行されていることを確認します。
- World Wide Web Publishing
[ スタート] をクリックし、[ すべてのプログラム] をポイントし、[ 管理ツール] をポイントし、[ コンピューター管理 コンソール] をクリックして、BizTalk サービス アカウントをローカルの Administrators グループに追加します。
Windows SharePoint Services をインストールした場合は、Windows SharePoint Services 管理パスから 既定の Web サイト の (ルート) を除外します。[ スタート] をクリックし、[ すべてのプログラム] をポイントし、[ 管理ツール] をポイントして、[ SharePoint サーバーの全体管理] をクリックします。
[ 仮想サーバーの構成] で、[ 仮想サーバー設定の構成] を選択します。
[ 仮想サーバーの一覧 ] ページ で、[既定の Web サイト] をクリックします。
[ 仮想サーバーの設定] ページで、[ 管理パスの定義] をクリックします。
[定義済みの管理パス] ページの [インクルード パス] セクションで、[ルート] を選択し、[選択したパスの削除] をクリックします。
コマンド プロンプトで IISReset を実行します。
コンピューターからログオフし、BizTalk サービス アカウントとしてコンピューターにログオンします。
コマンド プロンプトを開き、次のコマンドを入力し、Enter キーを押して %BTSSolutionsPath% 環境を設定します。 次に、コマンド プロンプトを終了します。
setx BTSSolutionsPath "\Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Scenarios"
注
64 ビット コンピューターを使用している場合は、%ProgramFiles%の代わりに %ProgramFiles(x86)% を使用します。
注
SETX コマンドの詳細については、 https://go.microsoft.com/fwlink/?LinkId=67831の Microsoft TechNet Web サイトを参照してください。
Windows 用 WebSphere MQ クライアントをインストールする
Windows 用 WebSphere MQ クライアントをインストールするには
最新バージョンの WebSphere MQ Client for Windows をダウンロードします。
注
ソリューションのスタブ・バージョンに IBM WebSphere Server が必要ない場合でも、クライアント・アプリケーションは、WebSphere MQ Client for Windows によって提供される amqmdnet.dll・ファイルを参照するため、インストールする必要があります。 スタブ バージョンのクライアントは、実際には DLL 内の API を呼び出しません。 これは、クライアント アプリケーションのコンパイルと実行にのみ必要です。 Ibm WebSphere MQ Client for Windows は、IBM Web サイトからダウンロードできます。
Windows 用 WebSphere MQ クライアントをインストールします。
注
Windows 用の WebSphere MQ クライアントを構成する必要はありません。 すべての既定の設定をそのまま使用します。
.NET アセンブリの WebSphere MQ クラスをグローバル アセンブリ キャッシュ (GAC) に追加します。
Visual Studio コマンド プロンプトで、IBM MQSeries Installation Directory\bin ディレクトリに移動します。
次のコマンドを実行します (gacutil.exe がパス環境にあることを確認します)。
gacutil.exe /i amqmdnet.dll
サービス指向ソリューション用の IIS に仮想ディレクトリを作成する
サービス指向ソリューションの IIS で仮想ディレクトリを作成するには
インターネット インフォメーション サービス (IIS) マネージャーで、[アプリケーション プール] を右クリックし、[アプリケーション プールの追加] を選択します。
[アプリケーション プールの追加] ダイアログ ボックスで、[名前] テキスト ボックスに「
SSOStubAppPool
」と入力し、[OK] をクリックします。サービス指向ソリューションで使用される仮想ディレクトリには、オーケストレーションのスタブ バージョンの発行済み Web サービス、スタブ SAP Web サービス、スタブ支払いトラッカー Web サービス、スタブ保留中トランザクション Web サービスが含まれます。
インターネット インフォメーション サービス (IIS) マネージャーで、先ほど作成したアプリケーション プールを右クリックし、[詳細設定] をクリックします。
Identity プロパティの右側にある列をクリックし、省略記号 (...) ボタンをクリックします。
[ アプリケーション プール ID ] ダイアログ ボックスで、[ カスタム アカウント ] オプションを選択し、[ 設定] をクリックします。
[ 資格情報の設定 ] ダイアログ ボックスで、ユーザー名とパスワードを指定し、パスワードを確認して、[OK] をクリック します。
注
このユーザーには、オーケストレーション プロキシ Web サービスを実行するためのアクセス許可が必要です。また、BizTalk Server Administrators、SSO Administrators、または SSO 関連 Administrators グループのいずれかに追加する必要があります。
[ OK] を クリックして[ アプリケーション プール ID ] ダイアログ ボックスを閉じます。
[OK] をクリックして [詳細設定] ダイアログ ボックスを閉じます。
インターネット インフォメーション サービス (IIS) マネージャーで、[Web サイト] を展開し、[既定の Web サイト] を右クリックし、[新規] をポイントし、[仮想ディレクトリ] をクリックして仮想ディレクトリ作成ウィザードを実行します。
仮想ディレクトリ作成ウィザードを使用して、アダプター バージョンのプロキシ Web サービス用に次の仮想ディレクトリを作成します。
Alias = Microsoft.Samples.BizTalk.WoodgroveBank.OrchProxy.Stub
PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\OrchProxy\Stub
アクセス許可 = 読み取り、スクリプトの実行
仮想ディレクトリ作成ウィザードを使用して、アダプター バージョンのプロキシ Web サービス用に次の仮想ディレクトリを作成します。
エイリアス = Microsoft.Samples.BizTalk.WoodgroveBank.StubSAP
PATH = <BizTalk インストール ディレクトリ>\SDK\Scenarios\SO\BTSSoln\StubWebServices\SAP
アクセス許可 = 読み取り、スクリプトの実行
仮想ディレクトリ作成ウィザードを使用して、アダプター バージョンのプロキシ Web サービス用に次の仮想ディレクトリを作成します。
Alias = Microsoft.Samples.BizTalk.WoodgroveBank.StubPendingTransactions
PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\StubWebServices\PendingTrans
アクセス許可 = 読み取り、スクリプトの実行
仮想ディレクトリ作成ウィザードを使用して、アダプター バージョンのプロキシ Web サービス用に次の仮想ディレクトリを作成します。
Alias = Microsoft.Samples.BizTalk.WoodgroveBank.StubPaymentTracker
PATH = <BizTalk インストール ディレクトリ>\SDK\Scenarios\SO\BTSSoln\StubWebServices\PaymentTrack
アクセス許可 = 読み取り、スクリプトの実行
インターネット インフォメーション サービス (IIS) マネージャーで、[Web サイト] を展開し、[既定の Web サイト] を展開し、[Microsoft.Samples.BizTalk.WoodgroveBank.OrchProxy.Stub] を右クリックし、[プロパティ] をクリックし、次のように設定を変更します。
[仮想ディレクトリ] タブで、作成した SSOStubAppPool にアプリケーション プールを設定します。
[ディレクトリ セキュリティ] タブをクリックし、[認証とアクセス制御グループ] ボックスで [編集] をクリックし、[統合 Windows 認証のみ有効] を選択して、他の [認証アクセス] チェック ボックスをオフにします。 [ OK] を クリックして終了します。
インターネット インフォメーション サービス (IIS) マネージャーで、[Web サイト] を展開し、[既定の Web サイト] を展開し、[Microsoft.Samples.BizTalk.WoodgroveBank.StubSAP] を右クリックし、[プロパティ] をクリックし、次のように設定を変更します。
[仮想ディレクトリ] タブで、作成した SSOStubAppPool にアプリケーション プールを設定します。
[ディレクトリ セキュリティ] タブをクリックし、[認証とアクセス制御グループ] ボックスで [編集] をクリックし、[匿名アクセスを有効にする] を選択します。 [ OK] を クリックして終了します。
インターネット インフォメーション サービス (IIS) マネージャーで、[Web サイト] を展開し、[既定の Web サイト] を展開し、[Microsoft.Samples.BizTalk.WoodgroveBank.StubPendingTransactions] を右クリックし、[プロパティ] をクリックし、次のように設定を変更します。
[仮想ディレクトリ] タブで、作成した SSOStubAppPool にアプリケーション プールを設定します。
[ディレクトリ セキュリティ] タブをクリックし、[認証とアクセス制御グループ] ボックスで [編集] をクリックし、[匿名アクセスを有効にする] を選択します。 [ OK] を クリックして終了します。
インターネット インフォメーション サービス (IIS) マネージャーで、[Web サイト] を展開し、[既定の Web サイト] を展開し、[Microsoft.Samples.BizTalk.WoodgroveBank.StubPaymentTracker] を右クリックし、[プロパティ] をクリックし、次のように設定を変更します。
[仮想ディレクトリ] タブで、作成した SSOStubAppPool にアプリケーション プールを設定します。
[ディレクトリ セキュリティ] タブをクリックし、[認証とアクセス制御グループ] ボックスで [編集] をクリックし、[匿名アクセスを有効にする] を選択します。 [ OK] を クリックして終了します。
サービス指向ソリューションを構築する
サービス指向ソリューションを構築するには
Visual Studio コマンド プロンプトを起動します。
注
\Scenarios\SO\BTSSoln\OrchProxy\Inline\app_code\customerserviceport.asmx.cs および %BTSInstallPath%\Scenarios\SO\BTSSoln\OrchProxy\Stub\app_code\customerserviceport.asmx.cs の%BTSInstallPath%ファイルで、17f20caea2afcc8c のすべてのインスタンスを a1054514fc67bded に置き換えます。
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 データベースに Enterprise Single Sign-On (SSO) エントリと値を作成する
SSO データベースに Enterprise Single Sign-On (SSO) エントリと値を作成するには
コマンド プロンプトを開き、現在のディレクトリを %BTSSolutionsPath%\SO\BTSSoln\Scripts に変更し、次のコマンドを実行して Enterprise Single Sign-On フォルダーの PATH 環境を設定します。
Set PATH=%PATH%;%ProgramFiles%\"Common Files\Enterprise Single Sign-On"
コマンド プロンプトで、メモ帳を使用してディレクトリを %BTSSolutionsPath%\SO\BTSSoln\Scripts folder, open ConfigStoreApp.xml に変更し、ファイルの内容を確認します。
注
このファイルは、シナリオが構成パラメーターを格納するために使用する SSO で構成ストア アプリケーションを定義します。 一部の構成パラメーターには、SAP との通信に使用される タイムアウト 値 (3 つのバージョンすべて) が含まれます。 このファイルを変更する必要はありません。
コマンド プロンプトで次のコマンドを実行して、SSO 構成ストア アプリケーションを作成します。
ssomanage -createapps ConfigStoreApp.xml
コマンド プロンプトで、メモ帳を使用してSetConfigValuesInSSO.cmdを開き、ファイルの内容を確認します
注
このコマンド ファイルは、SSO データベースの構成パラメーターの値を設定します。 これには、コマンド ファイルの先頭にあるローカル変数の値を設定する set ステートメントがいくつか含まれています。 SAPAdapterTimeout、PendingTransactionsAdapterTimeout、PaymentTrackingAdapterTimeout の値は、スタブとアダプターのバージョンで使用されます。 残りの値はインライン バージョンで使用されます。 スタブ バージョンでは、このファイルを変更する必要はありません。
コマンド プロンプトで「
SetConfigValuesInSSO.cmd
」と入力し、Enter キーを押して値を SSO 構成ストア アプリケーションに格納します。コマンド プロンプトで、次のコマンドを実行して SSO でチケットを有効にします。
ssomanage -tickets yes yes
サービス指向ソリューションの BAM 定義を展開する
サービス指向ソリューションの BAM 定義を展開するには
コマンド プロンプトで、次のコマンドを入力し、Enter キーを押します。 これにより、BAM ユーティリティを検索するためのパスが設定されます。
- SET PATH=%PATH%;%programfiles%\Microsoft BizTalk Server\Tracking
コマンド プロンプトで、ディレクトリを %BTSSolutionsPath%\SO\BTSSoln\BAM フォルダーに変更し、次のコマンドを入力して Enter キーを押します。
bm deploy-all -DefinitionFile:ServiceLevelTracking.xml
注
ユーザー アカウント制御 (UAC) をサポートするシステムでは、管理者特権でツールを実行することが必要になる場合があります。
サービス指向ソリューションをデプロイする
サービス指向ソリューションをデプロイするには
コマンド プロンプトを開き、ディレクトリを \SO\BTSSoln\Scripts フォルダー %BTSSolutionsPath%に変更します。
"debug" と "development" のすべてのインスタンスを "release" に置き換えて、 DeployStubBinding.cmd ファイルを変更します。
コマンド プロンプトを開き、ディレクトリを \SO\BTSSoln\Scripts フォルダー %BTSSolutionsPath%に変更します。 次のコマンドを入力し、Enter キーを押します。
DeployStubBinding.cmd
コマンド プロンプトで次のコマンドを実行して、スタブ バージョンのオーケストレーションを開始します。
Startstub.vbs
次のステップ
サービス指向ソリューションのスタブ バージョンの動作をテストするには、「 サービス指向ソリューションを実行する方法」を確認します。
こちらもご覧ください
サービス指向ソリューションをインストールする前に、サービス指向ソリューション用のサービス指向ソリューション開発者マシン セットアップのインラインバージョンとアダプター バージョンをインストールする方法