BizTalk アプリケーションをインストールする方法
ここでは、ローカル コンピューターにアプリケーションをインストールする方法について説明します。ローカル コンピューターにアプリケーションをインストールするには、Windows インターフェイスでアプリケーションの Windows インストーラー (.msi) ファイルをダブルクリックする方法と、コマンド ラインから msiexec を実行する方法があります。 「 BizTalk アプリケーションをインポートする方法」の説明に従って、インポート ウィザードの最後の手順としてインストール ウィザードを起動することもできます。
注意事項
アプリケーションが既にコンピューターにインストールされている場合は、アプリケーションの修復オプションが表示されます。 修復がサポートされるのは、アプリケーション用に単一の .msi ファイルがインストールされている場合のみです。 アプリケーション用に複数の .msi をコンピューターにインストールしている場合は、このオプションを選択しないでください。 [修復] を選択すると、後からインストールした .msi ファイルによって加えられた変更がすべて元に戻され、アプリケーションが正常に機能しなくなる可能性があります。
アプリケーションの運用を開始するには、アプリケーションを実行する BizTalk Server コンピューターにアプリケーションをインストールする必要があります。 アプリケーションをインストールすると、アプリケーションのリソースがローカル ファイル システムに格納されます。 アプリケーションとそのコンテンツおよび構成によっては、インストールで次の操作も実行されます。
グローバル アセンブリ キャッシュ (GAC) へのアセンブリの追加
証明書と仮想ディレクトリのインストール
Windows レジストリへのコンポーネントの追加
処理前または処理後のスクリプトの実行 (.msi ファイルに存在する場合)
背景情報については、「 インストールとアンインストール中の成果物の動作」を参照してください。
前提条件
このトピックの手順を実行するには、ローカル ファイル システムへの書き込みアクセス許可を持つアカウントでログオンする必要があります。 アプケーションに含まれるアイテムによっては、Windows レジストリ、GAC、証明書ストア、およびインターネット インフォメーション サービスに対する書き込みアクセス許可も必要になります。 ローカル コンピューターの管理者アカウントには、これらのアクセス許可が与えられています。 アクセス許可の詳細については、「 BizTalk アプリケーションの展開と管理に必要なアクセス許可」を参照してください。
アプリケーションのインストールに関する考慮事項
アプリケーションのインストール時には、次のことを考慮してください。
インストールするアプリケーションと依存関係を持つアプリケーションがある場合は、そのアプリケーションもインストールする。 他のアプリケーションに含まれるアイテム (BizTalk アセンブリなど) と依存関係があるアプリケーションをインストールする場合は、そのアイテムを含むアプリケーションもインストールする必要があります。 これは、アプリケーションを実行する前に行う必要があります。 たとえば、アプリケーション A がアプリケーション B のアセンブリに依存している場合は、アプリケーション B もインストールする必要があります。その後、アプリケーション A をインストールできます。背景情報については、「 依存関係とアプリケーションのデプロイ」を参照してください。
更新するアプリケーションを停止してください。 インストールによってアプリケーションのアイテムを更新する場合、本来はアプリケーションを停止する必要はありませんが、更新対象に既存のアセンブリと同じバージョンのアセンブリが含まれる場合は、 更新のインストール前にアプリケーションを停止する必要があります。 更新がアプリケーション実行の妨げにならないことが確実にわかっていない限り、すべての場合でアプリケーションを停止することをお勧めします。 詳細については、「 BizTalk アプリケーションの更新」を参照してください。
同じアプリケーション用の複数の .msi ファイルをインストールする場合に、[プログラムの追加と削除] にエントリが 1 つだけ作成される。 既存のアプリケーションを更新する場合などは、このような処理になります。 その後、プログラムの追加と削除 (コントロール パネル) を使用して、更新された項目を含め、アプリケーションを完全にアンインストールできます。 .msi ファイルをダブルクリックしてアプリケーションをアンインストールしたり、msiexec を使用してアプリケーションをアンインストールすることはできません。 詳細については、「 BizTalk アプリケーションをアンインストールする方法」を参照してください。
アプリケーションを実行するには、送信ポートをホストするすべてのコンピューターに証明書が存在する必要がある。 "その他のユーザー" 証明書ストアには、送信ポートで使用される証明書が含まれます。
アプリケーションのアイテムを、複数の .msi ファイルに分けてインストールできる。 アプリケーションを実行するコンピューターごとに、アプリケーションのすべてのアイテムをインストールする必要はありません。 代わりに、アプリケーションのアイテムを複数の .msi ファイルに分けてエクスポートし、別々のコンピューターにインストールすることができます。 手順については、「 BizTalk アプリケーションをエクスポートする方法」を参照してください。
アプリケーションの .msi ファイルに仮想ディレクトリが含まれている場合、ローカル コンピューターでインターネット インフォメーション サービス (IIS) が実行されている必要がある。 ローカル コンピューターでインターネット インフォメーション サービス (IIS) が実行されていない場合、インストールは失敗します。
ローカル コンピューターに既に存在する仮想ディレクトリと同じ名前の仮想ディレクトリがアプリケーションに含まれている場合に、既存の仮想ディレクトリにアプリケーションのリソースが追加される。 同じ名前の仮想ディレクトリがない場合は、仮想ディレクトリが作成されます。 追加するファイルと同じ名前の既存のファイルはすべて上書きされます。 既存の仮想ディレクトリのセキュリティ関連の設定は変更されないので、既存の仮想ディレクトリが十分に安全かどうかを確認する必要があります。
アプリケーションのインストール前に、仮想ディレクトリ用のアプリケーション プールを作成する。 アプリケーションに仮想ディレクトリが含まれており、IIS にアプリケーション プールが存在しない場合は、インストール前に手動でアプリケーション プールを作成する必要があります。 こうすると、インストール時に仮想ディレクトリがアプリケーション プールにバインドされます。 アプリケーションを作成しない場合、仮想ディレクトリはインストール時に既定のアプリケーション プールにバインドされます。
BTSHttpReceive.dll がインターネット インフォメーション サービス (IIS) 7.0 のハンドラー マッピングとして登録されていることを確認する。 アプリケーションに仮想ディレクトリが含まれる場合、HTTP 受信場所が動作するためには、これを行う必要があります。
64 ビットのアイテムを含むアプリケーションを 32 ビット コンピューターにインストールすると、問題が発生する可能性がある。 詳細については、「 64 ビット成果物をアプリケーションに追加する方法」を参照してください。
インストール先ディレクトリの長さが 260 文字を超える場合に問題が発生する。 MSI パッケージのインストール時に指定したインストール先ディレクトリの文字数が 260 文字を超える場合、インストールは失敗します。 この問題を解決するには、インストール先ディレクトリに指定されている文字数が 260 文字を超えていないことを確認してください。
インストール フォルダーの場所を変更しない。 アプリケーションをインストールした後は、インストール フォルダーまたはインストール フォルダーに含まれるファイルの場所を変更しないでください。 これらのフォルダーやファイルの場所を変更すると、後でアプリケーションを削除 (アンインストール) するときに、削除操作が失敗する可能性があります。 特にアプリケーションのインストール フォルダーには、BizTalk Server によって生成された、アプリケーションの削除の実行に必要なファイルが含まれています。 これらのファイルの名前を変更したり、移動や削除を行わないでください。 該当するファイルは次のとおりです。
ApplicationDefinition.adf
Microsoft.BizTalk.CustomInstaller.dll
Microsoft.BizTalk.CustomInstaller.InstallState
Note
インストール操作が完了する前に取り消した場合、BizTalk Serverは、操作が取り消される前に前処理スクリプトまたは後処理スクリプトによって実行されたアクションを除き、インストールをロールバックします。
重要
アプリケーションをインストールする前に、信頼できるソースから .msi ファイルを受け取っていることを確認してください。 悪意のあるユーザーは、システムまたはネットワークに望ましくない影響を与える可能性があるコードを .msi ファイルに含めることができます。 詳細については、「 セキュリティと Windows インストーラー」を参照してください。
アプリケーションに Web サイトが含まれている場合、または Web サービスを使用するオーケストレーションが含まれている場合、仮想ディレクトリのセキュリティ設定は、アプリケーションのエクスポートで .msi ファイルが生成されたときに使用されていた設定になります。ただし、仮想ディレクトリが存在する場合は既存の設定が使用されます。 アプリケーションをインストールした後は、設定がセキュリティの要件を満たしているかどうかを確認してください。
すべての分離アクセス制御リスト (DACL) は、アプリケーションのエクスポート時にファイルとフォルダーから削除されます。 ホスト インスタンスにアプリケーションをインストールした後は、ファイルとフォルダーのすべてのセキュリティ設定 (仮想ディレクトリを含む) を再構築する必要があります。
ローカル パス (仮想ディレクトリがターゲット コンピューターに作成された後に HTTP 受信場所が参照する場所) を変更する必要がある。
ターゲット コンピューターに作成された仮想ディレクトリは、次のいずれかの物理ディレクトリを指します。
<インストール ドライブ>\Program Files\Microsoft BizTalk Server\HttpReceive
- または –
<インストール ドライブ>\Program Files (x86)\Microsoft BizTalk Server\HttpReceive
BizTalk HTTP 受信 ISAPI 拡張 BTSHTTPReceive.dll が指定されたディレクトリに存在しない場合、またはターゲット コンピューターが 64 ビットのオペレーティング システムを実行している場合は、ローカル パスを変更し、BizTalk HTTP 受信 ISAPI 拡張ファイルを格納する物理ディレクトリを指すように、仮想ディレクトリの場所を変更する必要があります。 たとえば、ターゲット コンピューターで 64 ビット バージョンの Windows Vista が実行されている場合、仮想ディレクトリのローカル パス: 指定をインストール ドライブ>\Program Files (x86)\Microsoft BizTalk Server\HttpReceive64 に<変更する必要があります。
BizTalk アプリケーションをインストールするには
Windows インターフェイスを使用する
アプリケーションの .msi ファイルをローカル コンピューターにコピーします。
既存の BizTalk アプリケーションを再インストールまたはアップグレードするときに、新しいインストールに、既にアプリケーションに存在するアセンブリと同じバージョンのアセンブリが含まれている場合、または更新中の成果物と対話する場合は、アプリケーション フォルダーを右クリックして [ 停止] をクリックして、アプリケーションが停止していることを確認します。
Windows エクスプローラーで、.msi ファイルをダブルクリックしてインストール ウィザードを起動します。
[ インストール フォルダーの選択] ページの [ フォルダー] に、BizTalk アプリケーションの完全なインストール パスを入力します。 たとえば、「C:\Program Files\Generated by BizTalk\MyApplication」のように入力します。
[ 次へ ] を 4 回クリックし、[ インストールの完了 ] ページで [ 閉じる] をクリックします。
複数のコンピューターでアプリケーションを実行する場合は、それぞれのコンピューターで上記の手順を繰り返します。
アプリケーションを実行するすべてのコンピューターにアプリケーションがインストールされ、アプリケーションが BizTalk グループにインポートされたら、アプリケーションのフォルダーを右クリックして [開始] をクリックして、BizTalk Server管理コンソールからアプリケーションを起動できます。 詳細な手順については、「 BizTalk アプリケーションを開始および停止する方法」を参照してください。
コマンド ラインの使用
アプリケーションの .msi ファイルをローカル コンピューターにコピーします。
[ スタート] をクリックし、[ 実行] をクリックし、「」と入力
cmd
し、Enter キーを押します。.msi ファイルが格納されている場所へ移動します。
次のコマンドを入力し、アプリケーションをインストールします。指定するパラメーターと値は次のとおりです。
重要
msiexec のパラメーターは、次の表に示すものだけがサポートされます。
msiexec [/i] パッケージ [/qn] TARGETDIR="value"]
例: msiexec /i MyApplication.msi
パラメーター 値 /私 アプリケーションをインストールします。 パッケージ Windows インストーラー (.msi) ファイルの名前を指定します。 /Qn ユーザー インターフェイスを表示しないでインストールを実行します。 TARGETDIR="value" アプリケーションのインストール フォルダーを指定します。 この値は %BTAD_InstallDir% 環境変数にも設定されます。
たとえば、「TARGETDIR="C:\Programs\BizTalk Applications\My Application"」のように指定します。複数のコンピューターでアプリケーションを実行する場合は、それぞれのコンピューターで上記の手順を繰り返します。
アプリケーションを実行するすべてのコンピューターにアプリケーションがインストールされたら、アプリケーションのフォルダーを右クリックして [開始] をクリックして、BizTalk Server管理コンソールからアプリケーションを起動できます。 詳細な手順については、「 BizTalk アプリケーションを開始および停止する方法」を参照してください。