このトピックでは、Windows インターフェイスでアプリケーションの Windows インストーラー (.msi) ファイルをダブルクリックするか、コマンド ラインから msiexec を実行して、ローカル コンピューターにアプリケーションをインストールする方法について説明します。 「BizTalk アプリケーションをインポートする方法」の説明に従って、インポート ウィザードの最後の手順としてインストール ウィザードを起動することもできます。
注意事項
このアプリケーションが既にこのコンピューターにインストールされている場合は、アプリケーションを修復するオプションが表示されます。 修復は、このアプリケーションに対して 1 つの .msi がインストールされている場合にのみサポートされます。 このアプリケーション用にこのコンピューターに複数の .msi をインストールしている場合は、このオプションを選択しないでください。 これは、修復を選択すると、この .msi ファイルの後にインストールされた .msi ファイルによって行われた変更が元に戻されるためです。これにより、アプリケーションが正常に動作しなくなる可能性があります。
アプリケーションを操作する前に、アプリケーションを実行する BizTalk Server コンピューターにインストールする必要があります。 アプリケーションをインストールすると、そのリソースがローカル ファイル システムに配置されます。 アプリケーション、その内容、および構成によっては、インストールによって次の処理が行われる場合もあります。
グローバル アセンブリ キャッシュにアセンブリを追加する (GAC)
証明書と仮想ディレクトリをインストールする
Windows レジストリにコンポーネントを追加します。
.msi ファイルにスクリプトが存在する場合は、前処理スクリプトまたは後処理スクリプトを実行します。
背景情報については、「 インストールおよびアンインストール中のアーティファクトの動作」を参照してください。
[前提条件]
このトピックの手順を実行するには、ローカル ファイル システムに対する書き込みアクセス許可を持つアカウントでログオンする必要があります。 アプリケーションに含まれる項目によっては、Windows レジストリ、GAC、証明書ストア、インターネット インフォメーション サービスに対する書き込みアクセス許可も必要になる場合があります。 ローカル コンピューターの Administrators アカウントには、これらのアクセス許可があります。 アクセス許可の詳細については、「 BizTalk アプリケーションの展開と管理に必要なアクセス許可」を参照してください。
アプリケーションのインストールに関する考慮事項
アプリケーションをインストールするときに、次の考慮事項が適用される場合があります。
また、このアプリケーションに依存関係があるアプリケーションもインストールする必要があります。 別のアプリケーションに含まれる BizTalk アセンブリなど、成果物に依存するアプリケーションをインストールする場合は、成果物を含むアプリケーションもインストールする必要があります。 これは、アプリケーションを実行する前に行う必要があります。 たとえば、アプリケーション A がアプリケーション B のアセンブリに依存している場合は、アプリケーション B もインストールする必要があります。その後、アプリケーション A をインストールできます。背景情報については、「 依存関係とアプリケーションのデプロイ」を参照してください。
更新するアプリケーションを停止する必要があります。 アプリケーション内の成果物を更新するためにインストールを実行する場合は、既存のアセンブリと同じバージョンの 1 つ以上のアセンブリが更新プログラムに含まれていない限り、アプリケーションを停止する必要はありません。 この場合は、更新プログラムをインストールする前にアプリケーションを停止する必要があります。 ただし、更新プログラムがアプリケーションの実行時に干渉しないことがわかっている場合を除き、すべてのケースでアプリケーションを停止することをお勧めします。 詳細については、「 BizTalk アプリケーションの更新」を参照してください。
同じアプリケーションに対して複数の .msi ファイルをインストールする場合、[プログラムの追加と削除] に作成されるエントリは 1 つだけです。 たとえば、既存のアプリケーションを更新するためにこれを行う場合があります。 その後、(コントロール パネルの) [プログラムの追加と削除] を使用して、更新された項目を含め、アプリケーションを完全にアンインストールできます。 .msi ファイルをダブルクリックしてアプリケーションをアンインストールしたり、msiexec を使用したりすることはできません。 詳細については、「 BizTalk アプリケーションをアンインストールする方法」を参照してください。
アプリケーションを実行するには、送信ポートをホストするすべてのコンピューターに証明書が存在する必要があります。 その他のユーザー証明書ストアには、送信ポートで使用される証明書が含まれています。
インストールのために、アプリケーション成果物をさまざまな .msi ファイルに組み込むことができます。 アプリケーションを実行する各コンピューターにすべてのアプリケーション成果物をインストールする必要はありません。 代わりに、アプリケーション成果物のサブセットを異なる .msi ファイルにエクスポートして、異なるコンピューターにインストールできます。 手順については、「 BizTalk アプリケーションをエクスポートする方法」を参照してください。
アプリケーション .msi ファイルに仮想ディレクトリが含まれている場合は、インターネット インフォメーション サービス (IIS) がローカル コンピューターで実行されている必要があります。 そうでない場合、インストールは失敗します。
アプリケーションにローカル コンピューターに既に存在する仮想ディレクトリと同じ名前の仮想ディレクトリが含まれている場合は、アプリケーションのリソースが追加されます。 それ以外の場合は、仮想ディレクトリが作成されます。 追加されたファイルと同じ名前の既存のファイルは上書きされます。 さらに、既存の仮想ディレクトリのセキュリティ設定は変更されず、十分にセキュリティで保護されていることを確認する必要があります。
アプリケーションをインストールする前に、仮想ディレクトリ用のアプリケーション プールを作成します。 アプリケーションに仮想ディレクトリが含まれており、アプリケーション プールがまだ IIS に存在しない場合は、インストール前にアプリケーション プールを手動で作成する必要があります。 これにより、インストール時に仮想ディレクトリがアプリケーション プールにバインドされます。 アプリケーションを作成しない場合、仮想ディレクトリはインストール時に既定のアプリケーション プールにバインドされます。
BTSHttpReceive.dll がインターネット インフォメーション サービス (IIS) 7.0 とのハンドラー マッピングとして登録されていることを確認します。 HTTP 受信場所を機能させるには、アプリケーションに仮想ディレクトリが含まれている場合にこれを行う必要があります。
32 ビット コンピューターに 64 ビット成果物を含むアプリケーションをインストールするときに問題が発生する可能性があります。 詳細については、「 64 ビット成果物をアプリケーションに追加する方法」を参照してください。
ターゲット ディレクトリの長さが 260 文字を超えると、問題が発生する可能性があります。 MSI パッケージのインストール中に指定されたターゲット ディレクトリ内の文字数が 260 文字を超える場合、インストールは失敗します。 この問題を解決するには、ターゲット ディレクトリに指定された文字数が 260 文字を超えないようにします。
インストール フォルダーを再配置しないでください。 アプリケーションをインストールしたら、インストール フォルダーまたはアプリケーションに含まれるファイルを再配置しないでください。 その後、アプリケーションを削除 (アンインストール) しようとすると、削除操作が失敗する可能性があります。 特に、アプリケーションのインストール フォルダーには、削除を実行するために必要な BizTalk Server によって生成されたファイルが含まれています。 これらのファイルの名前変更、移動、または削除はしないでください。 ファイルは次のとおりです。
ApplicationDefinition.adf
Microsoft.BizTalk.CustomInstaller.dll
Microsoft.BizTalk.CustomInstaller.InstallState
注
インストール操作が完了する前に取り消した場合、BizTalk Server は、操作が取り消される前に前処理スクリプトまたは後処理スクリプトによって実行されたアクションを除き、インストールをロールバックします。
Von Bedeutung
アプリケーションをインストールする前に、信頼できるソースから .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 アプリケーションの完全なインストール パスを入力します。 例: BizTalk\MyApplication によって生成された C:\Program Files\。
[ 次へ ] を 4 回クリックし、[ インストールの完了 ] ページで [ 閉じる] をクリックします。
複数のコンピューターでアプリケーションが実行される場合は、各コンピューターで前の手順を繰り返します。
アプリケーションを実行するすべてのコンピューターにアプリケーションがインストールされ、アプリケーションが BizTalk グループにインポートされたら、アプリケーションのフォルダーを右クリックして [スタート] をクリックすることで、BizTalk Server 管理コンソールからアプリケーションを起動できます。 完全な手順については、「 BizTalk アプリケーションを起動および停止する方法」を参照してください。
コマンド ラインの使用
アプリケーションの .msi ファイルをローカル コンピューターにコピーします。
Startをクリックし、Runをクリックし、
cmd
と入力して Enter キーを押します。.msi ファイルが格納されている場所に移動します。
次の表に示すように、次のコマンドを入力してアプリケーションをインストールし、適切なパラメーターと値を指定します。
Von Bedeutung
次の表に示す 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 アプリケーションを起動および停止する方法」を参照してください。