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