BizTalk アプリケーションをインポートする方法
ここでは、BizTalk Server 管理コンソールまたはコマンド ラインを使用して、BizTalk アプリケーションを BizTalk グループにインポートする方法について説明します。 BizTalk アプリケーションをインポートすると、BizTalk 管理データベースに BizTalk アプリケーションのアイテムが登録され、適切な BizTalk データベースにアイテムのデータが書き込まれます。 詳細については、「 成果物がインポートされたときの動作」を参照してください。 アプリケーションをインポートしても、アプリケーションはインストールされません。 アプリケーションを実行できるようにするには、ファイルベースのアイテムが含まれているアプリケーションをインストールする必要があります。
BizTalk Server 管理コンソールを使用してアプリケーションをインポートする場合、どの場所から MSI のインポート ウィザードを起動するかによって、アイテムのインポート時に新しいアプリケーションを作成できるかどうかが決まります。 BizTalk グループを右クリックしてウィザードを起動する場合、アプリケーション名を指定する必要があります。 指定したアプリケーション名が BizTalk グループ内の既存のアプリケーションによって使用されていると、ファイルのアイテムはこの既存のアプリケーションにインポートされます。それ以外の場合、指定した名前のアプリケーションが新しく作成され、作成されたアプリケーションにアイテムがインポートされます。 アプリケーションを右クリックしてウィザードを起動する場合、アプリケーション名を指定することはできません。また、アイテムは現在のアプリケーションにインポートされます。
BTSTask コマンド ライン ツールを使用して .msi ファイルをインポートする場合、アプリケーション名の指定は省略可能です。 名前を指定しない場合、アイテムは既定のアプリケーションにインポートされます。
インポートしたアイテムは、BizTalk Server 管理コンソールのアプリケーションのフォルダーの下にある適切なフォルダーに表示できます。 ListApp Command で説明されているように、BTSTask を使用してアプリケーション内の成果物の一覧を表示することもできます。
前提条件
BizTalk アプリケーションをインポートするには、BizTalk Server 管理者グループに属するアカウントでログオンする必要があります。 BizTalk アプリケーションをインストールするには、ローカル ファイル システムへの書き込みアクセス許可も必要です。 アクセス許可の詳細については、「 BizTalk アプリケーションの展開と管理に必要なアクセス許可」を参照してください。
アプリケーションのインポートに関する考慮事項
アプリケーションのインポート時には、次のことを考慮してください。
以前のバージョンのBizTalk Serverからアプリケーションをインポートする。 BizTalk Server 2006 R2 または BizTalk Server 2009 からアプリケーションをインポートしていて、アプリケーションに EDI/AS2 パーティ データが含まれている場合、BizTalk Serverで取引先管理モデルが大幅に変更されたため、アプリケーションのインポートが失敗する可能性があります。 パーティ データを以前のバージョンの BizTalk Server から移行するには、パーティ移行ツールを使用する必要があります。 ツールの詳細については、「 EDI 移行ユーティリティ」を参照してください。
既存のバインドはインポートされるバインドによって必ず上書きされる。 既存のアプリケーションにバインドが含まれている .msi ファイルをインポートすると、既存のバインドはインポートされた同じ名前のバインドによって上書きされます。 これは、.msi ファイルのインポート時に既存のアイテムを上書きするオプションを選択しなかった場合も同様です。 エクスポートするアプリケーションのバインドで、.msi ファイルのインポート先アプリケーションのバインドを上書きしないようにするには、エクスポート操作中にエクスポートするリソースとしてバインド ファイルを選択しないでください。 詳細については、「 BizTalk アプリケーションをエクスポートする方法」を参照してください。
インポート プロセスでバインドが適用されるとき、同じ名前を持つ適用済みのバインドは、新しいバインドで上書きされます。 つまり、同じ名前のバインドを適用すると、常に、最新のバインドが有効になります。 アプリケーションをインポートすると、バインドは次の順序で適用されます。
BizTalk Server によって生成されたアプリケーション バインドのうち、バインド ファイルでアプリケーションに明示的に追加されたバインドではなく、ユーザーがアプリケーション .msi ファイルへのエクスポート対象として明示的に選択したバインド。
明示的に追加されたバインド ファイルのうち、対象の展開環境が指定されていないもの。 この一連のバインド内での適用順序は特に決まっていません。
明示的に追加されたバインドのうち、対象の (アプリケーションのインポート用に選択された展開環境と一致する) 展開環境が関連付けられているもの。 この一連のバインド内での適用順序は特に決まっていません。
ホストはグループ内に存在する必要がある。 .msi ファイルに含まれているアプリケーション バインドで指定されているホストに対応するホストは、BizTalk グループ内に既に存在する必要があります。存在しない場合、インポート操作に失敗します。 さらに、ホストの信頼レベルが一致する必要があります。
別のアプリケーションへの参照の追加が必要になる場合がある。 インポートするアプリケーションが別のアプリケーションの成果物に依存している場合は、このアプリケーションへの参照を追加する必要があります。 アプリケーションと必須アイテムは既にグループに存在する必要があります。 インポート ウィザードにはこのオプションが用意されています。 ただし、BTSTask の ImportApp コマンドを使用している場合は、「別のアプリケーションに参照を追加する方法」の説明に従って、インポート後 にアプリケーションへの参照を追加する必要があります。 背景情報については、「 依存関係とアプリケーションのデプロイ」を参照してください。 インポート ウィザードはグループ内の既存のアプリケーションへの参照を一致させて、新しい参照を追加するか既存の参照を変更するオプションを提供します。 参照先のアプリケーションが必須アイテムを含んでいることを確認する追加手順を実行する必要があります。
インポート操作がタイムアウトした場合、アプリケーションを別の .msi ファイルに分割する。 インポート操作の所要時間が 3600 秒を超えた場合は、タイムアウトになります。 .msi ファイルをインポートするとき、操作がタイムアウトした場合は、アプリケーションを再度エクスポートし、エクスポートするアイテムのサブセットを選択して、アプリケーションのコンテンツを複数の .msi ファイルに分割する必要があります。 詳細については、「 BizTalk アプリケーションをエクスポートする方法」を参照してください。
重要
セキュリティ上の理由により、パスワードは、アプリケーションのエクスポート中にアプリケーションのバインドから削除されます。 ただし、既にアプリケーションに追加されたバインド ファイルからは削除されません。 アプリケーションをインポートした後、アプリケーションを機能させるためにパスワードを再構成する必要があります。 この操作を行うには、バインド ファイルを編集するか、管理コンソールを使用します。 バインド ファイルの編集の詳細については、「バインド ファイル のカスタマイズ」を参照してください。 アダプターのセキュリティの構成の詳細については、「アダプターの 使用」を参照してください。
Note
インポートに失敗した場合、BizTalk Server によってすべてのインポート操作がロールバックされます。ただし、カスタム スクリプトによって実行される操作は除きます。
Note
別のアプリケーションのプロパティ スキーマを使用するアプリケーションの送信ポートにフィルターを作成し、そのアプリケーションを新しい BizTalk グループにインポートした場合、そのアプリケーションをインストールおよび起動しても、フィルターは正しく機能せず、スキーマが欠落していることを伝える警告も発生しません。 この問題は、スキーマが欠落しているアプリケーションをインストールする前に、必要なスキーマを含んでいるアプリケーションをインポートすれば解決できます。
BizTalk Server 管理を使用して BizTalk アプリをインポートする
[スタート]、[すべてのプログラム]、[Microsoft BizTalk Server 20xx] の順にクリックし、[BizTalk Server管理] をクリックします。
コンソール ツリーで、[BizTalk Server管理] を展開し、[BizTalk] グループを展開して、次のいずれかの操作を行います。
.msi ファイルに含まれるアプリケーションと成果物を BizTalk グループにインポートするには、[ アプリケーション] を右クリックし、[ インポート] をポイントして、[ MSI ファイル] をクリックします。
.msi ファイルに含まれる成果物を既存のアプリケーションにインポートするには、[ アプリケーション] を展開し、アプリケーションを右クリックし、[ インポート] をポイントして、[ MSI ファイル] をクリックします。
[MSI のインポート ウィザードへようこそ] ページで、 インポートする MSI ファイルに .msi ファイルのパスを入力し、[ 次へ] をクリックします。 必要に応じて、[ ... ] ボタンをクリックして .msi ファイルを参照できます。
[アプリケーションの設定] ページの [ アプリケーション名 ] ドロップダウン リストで、使用可能な場合はアプリケーション名を選択します。 この一覧は、アプリケーションを BizTalk グループにインポートしている場合に使用できます。
Note
この一覧には、BizTalk グループに現在含まれているすべてのアプリケーションの名前と、.msi ファイルのエクスポート元のアプリケーションが含まれます。 .msi ファイルのエクスポート元アプリケーションの名前を選択すると、アプリケーションは BizTalk グループには存在しないので、インポート ウィザードによって新しいアプリケーションが作成されます。 グループに既に存在するアプリケーションを選択すると、インポート ウィザードは .msi ファイルから既存のアプリケーションにアイテムをインポートします。
[ 参照を追加できるアプリケーション] で、参照を追加するアプリケーション (存在する場合) を選択し、[ 次へ] をクリックします。
.msi ファイルを既存のアプリケーションにインポートし、既存のアプリケーションの成果物を上書きする場合は、[ リソースの上書き] を選択します。
Note
このオプションを選択しない場合、アプリケーションに既に存在するアイテムが .msi ファイルに含まれていると、インポート操作に失敗し操作がロールバックされます。 BizTalk アプリケーションまたはグループ内のアイテムのうち、特定の種類のアイテムは一意でなければなりません。 BizTalk グループに既に存在するアイテムを追加すると、現在のアプリケーションにはそのアイテムが存在しなくても、インポート操作に失敗します。これは上書きオプションを指定した場合も同様です。 一意である必要がある成果物と、一意である必要がある方法の詳細については、「 アプリケーションまたはグループで一意である必要がある成果物」を参照してください。
[アプリケーション ターゲット環境設定] ページの [ ターゲット ステージング環境 ] ドロップダウン リストで、このアプリケーションのターゲット環境を選択し、[ 次へ] をクリックします。 この一覧には、このアプリケーションに追加されたすべてのバインド ファイルに指定されているすべての環境が含まれます。 ターゲット環境が指定されているものを除き、アプリケーション内のすべてのバインドを適用する場合は、[既定値]> を選択<します。 .msi ファイルに明示的に適用するバインド ファイルが含まれていない場合は、[既定値]> を選択したまま<にすることができます。
Note
バインド ファイルをアプリケーションに追加するときに、バインドのターゲット環境を指定します。 背景情報については、「 バインド ファイルとアプリケーションの展開」を参照してください。 バインド ファイルを追加する手順については、「 アプリケーションにバインド ファイルを追加する方法」を参照してください。
[インポートの概要] ページで、概要情報が正しいことを確認し、[ インポート] をクリックします。
[インポートに成功しました] ページで、ローカル コンピューターにアプリケーションをインストールする場合は、[アプリケーション インストール ウィザードの実行] を選択して、ローカル コンピューターにアプリケーションをインストールチェックボックスをオンにします。
Note
現在アプリケーションがローカル コンピューターで構成されている場合、アプリケーションを実行する必要がなければ、アプリケーションをインストールする必要はありません。 ただし、アプリケーションにファイルベースのアイテムが含まれている場合、アプリケーションが機能するためには、実行するすべてのコンピューターにアプリケーションをインストールする必要があります。アプリケーションのインポートでは BizTalk 管理データベースにしかアプリケーションは追加されません。
[完了] をクリックします。
注意
ローカル ファイル システムへの書き込みアクセス許可が与えられてないなどの理由によりインストールに失敗する場合、インストールはロールバックされますが、インポート操作はロールバックされません。
コマンド ラインを使用して BizTalk アプリをインポートする
コマンド プロンプトを次のように開きます。[ スタート] をクリックし、[ 実行] をクリックし、「」と入力
cmdして、[OK] をクリック します。次の表で説明するように、適切な値に置き換え、次のコマンドを入力します。
BTSTask ImportApp /Package:value [/Environment:value] [/ApplicationName:value] [/Overwrite] [/Server:value] [/Database:value]
例:
BTSTask ImportApp /Package:"C:\MSI Files\MyApplication.msi" /Environment:Test /ApplicationName:MyApplication /Overwrite
パラメーター 値 /パッケージ .msi ファイルの完全パス。 パスにスペースが含まれている場合は、引用符 (") で囲む必要があります。 /環境 バインド ファイルの適用対象の展開環境 (Test など)。 これは、バインド ファイルをアプリケーションに追加するときに、対象の展開環境として指定した値です。 /Applicationname .msi ファイル内のアイテムをインポートする BizTalk アプリケーションの名前。 指定しない場合は、.msi ファイルのエクスポート時に指定されたアプリケーション名が使用されます。 指定したアプリケーションが存在しない場合は、作成されます。 スペースを含むアプリケーション名は、二重引用符 (") で囲む必要があります。 /上書き .msi ファイル内のアイテムと、アプリケーション内のアイテムとが、同じローカル一意識別子 (LUID) を持つ場合に、アプリケーション内のアイテムを上書きするためのオプション。 このオプションを省略した場合、.msi ファイル内のアイテムと同じ LUID を持つアイテムがアプリケーションに存在すると、インポートは失敗します。 ListApp コマンドを使用して、アプリケーション内の成果物の LUID を表示できます。 /サーバー BizTalk 管理データベースをホストする SQL Server インスタンスの名前。ServerName\InstanceName,Port の形式で指定します。
インスタンス名の指定は、そのインスタンス名がサーバー名と異なる場合にのみ必要です。 ポートの指定は、SQL Server で使用するポート番号が既定値 (1433) と異なる場合にのみ必要です。
例 :
Server=MyServer
Server=MyServer\MySQLServer,1533
指定しなかった場合、ローカル コンピューターで実行されている SQL Server インスタンスの名前が使用されます。/データベース BizTalk 管理データベースの名前。 指定しなかった場合、SQL Server のローカル インスタンスで実行されている BizTalk 管理データベースが使用されます。