41 Oracle BPMNのサービス・コンポーネントとエンジンの管理

この章では、BPMNプロセス・サービス・コンポーネントとサービス・エンジンの管理方法について説明します。

この章の内容は次のとおりです:

第41.1項「BPMNプロセス・サービス・コンポーネントのフォルトのリカバリ」
第41.2項「BPMNプロセス・サービス・コンポーネントのポリシーの管理」
第41.3項「BPMNプロセス・サービス・エンジンのフォルトのリカバリ」
第41.4項「BPMNプロセス・サービス・エンジンのメッセージ・リカバリの実行」

41.1 BPMNプロセス・サービス・コンポーネントのフォルトのリカバリ

リカバリ可能として識別されたBPMNプロセス・サービス・コンポーネントを監視し、個別のフォルト・リカバリと一括のフォルト・リカバリを実行できます。リカバリ可能として識別されたBPMNプロセス・フォルトについては、(fault-bindings.xmlファイルを介して)フォルトにバインドされ、アクションora-human-interventionをトリガーするフォルト・ポリシーが定義されている必要があります。ただし、フォルト・ポリシーが定義されていない場合、フォルトは、リカバリ可能またはリカバリ不可のフォルトとして通常どおり処理されます。

BPMNプロセス・サービス・コンポーネントのフォルトをリカバリする手順は、次のとおりです。

次のいずれかのオプションを使用して、このページにアクセスします。

SOAインフラストラクチャのメニューから...	ナビゲータのSOAフォルダから...
「ホーム」を選択します。「デプロイ済コンポジット」タブを選択します。「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。	「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションを選択します。

「コンポーネント・メトリック」セクションで、BPMNプロセス・サービス・コンポーネントを選択します。
「フォルト」をクリックします。

図版bpmn_comp_faults.gifの説明

「フォルト」ページに、次の詳細が表示されます。
- 特定のフォルトを検索するためのユーティリティ。基準を指定して「検索」をクリックします。詳細は、「ヘルプ」アイコンをクリックしてください。デフォルトでは、このページに初めてアクセスしたときにはフォルトは表示されません。フォルトを表示するには、「検索」をクリックする必要があります。
- サービス・コンポーネントで発生したフォルト。フォルトID、エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、サービス・コンポーネントのインスタンスID、フォルトが発生したアクティビティ、およびフォルトが記述されているログ・ファイルへのリンクが表示されます。
リカバリが可能として識別されたBPMNプロセス・サービス・コンポーネントのフォルトはリカバリできます。

次のいずれかの方法を使用して、リカバリ対象のフォルトを選択します。BPMNプロセス・サービス・コンポーネント・レベルでフォルト・リカバリ対象を選択することは、SOAインフラストラクチャ・レベル、SOAコンポジット・アプリケーション・レベルおよびOracle Mediatorサービス・コンポーネント・レベルで選択するのと同じです。

対象	操作
単一フォルト・リカバリ	単一フォルト・リカバリの対象を選択するには、次の3つの方法があります。リカバリ可能として識別されたフォルトの行をクリックします。行が強調表示された状態で、ステップ5の説明に従って、「リカバリ・アクション」リストから特定のアクションを選択します。「リカバリ」列で「リカバリ」リンクをクリックし、インスタンス監査証跡の「フォルト」ページにアクセスしてフォルト・リカバリを実行します。「エラー・メッセージ」列で、リカバリ可能として識別されたフォルトのメッセージをクリックします。完全なフォルト詳細(フォルトID、フォルトの発生時間、フォルトの場所、フォルト・タイプ、エラー・メッセージ・テキストなど)が表示されます。リカバリ可能なフォルトには、「ここでリカバリ」オプションが表示されます。「ここでリカバリ」をクリックし、インスタンス監査証跡の「フォルト」ページにアクセスしてフォルト・リカバリを実行します。
一括フォルト・リカバリ	一括フォルト・リカバリの対象を選択するには、次の2つの方法があります。 [Shift]キーまたは[Ctrl]キーを押しながら、行から特定のフォルトを選択します。または「選択」メニューから、「すべてのリカバリ可能な値を選択」を選択します。次に、[Shift]キーまたは[Ctrl]キーを押しながらクリックすることによって、リカバリ操作に含めないフォルトの選択を解除します。次に: ステップ5の説明に従って、「リカバリ・アクション」リストからアクションを選択します。注意: 選択できるのは、選択したすべてのフォルトに適用可能なアクションのみです。
すべてのフォルトのリカバリ	「選択」メニューから、「すべてのリカバリ可能な値を選択」を選択します。ステップ5の説明に従って、「リカバリ・アクション」リストからアクションを選択します。注意: 選択できるのは、選択したすべてのフォルトに適用可能なアクションのみです。

対象

操作

単一フォルト・リカバリ

単一フォルト・リカバリの対象を選択するには、次の3つの方法があります。

リカバリ可能として識別されたフォルトの行をクリックします。行が強調表示された状態で、ステップ5の説明に従って、「リカバリ・アクション」リストから特定のアクションを選択します。
「リカバリ」列で「リカバリ」リンクをクリックし、インスタンス監査証跡の「フォルト」ページにアクセスしてフォルト・リカバリを実行します。
「エラー・メッセージ」列で、リカバリ可能として識別されたフォルトのメッセージをクリックします。完全なフォルト詳細(フォルトID、フォルトの発生時間、フォルトの場所、フォルト・タイプ、エラー・メッセージ・テキストなど)が表示されます。リカバリ可能なフォルトには、「ここでリカバリ」オプションが表示されます。「ここでリカバリ」をクリックし、インスタンス監査証跡の「フォルト」ページにアクセスしてフォルト・リカバリを実行します。

一括フォルト・リカバリ

一括フォルト・リカバリの対象を選択するには、次の2つの方法があります。

[Shift]キーまたは[Ctrl]キーを押しながら、行から特定のフォルトを選択します。

または
「選択」メニューから、「すべてのリカバリ可能な値を選択」を選択します。次に、[Shift]キーまたは[Ctrl]キーを押しながらクリックすることによって、リカバリ操作に含めないフォルトの選択を解除します。

次に:
ステップ5の説明に従って、「リカバリ・アクション」リストからアクションを選択します。

注意: 選択できるのは、選択したすべてのフォルトに適用可能なアクションのみです。

すべてのフォルトのリカバリ

「選択」メニューから、「すべてのリカバリ可能な値を選択」を選択します。
ステップ5の説明に従って、「リカバリ・アクション」リストからアクションを選択します。

注意: 選択できるのは、選択したすべてのフォルトに適用可能なアクションのみです。

注意:

ほとんどの場合、フォルト・ポリシーのアクションは自動的に実行されます。ただし、アクションora-human-interventionを使用するフォルト・ポリシーを定義した場合は例外です。このアクションによって、Oracle Enterprise Manager Fusion Middleware Controlからリカバリできるリカバリ可能なフォルトが作成されます。

「リカバリ・アクション」リストからアクションを選択します。

アクション	説明
再試行	インスタンスを直接再試行します。このリカバリ・アクションを使用するシナリオ例は、ネットワーク・エラーのためにサービス・プロバイダにアクセスできないことが原因でフォルトが発生した場合の例です。ネットワーク・エラーは現在解決しています。
中断	インスタンス全体を終了します。
リプレイ	フォルトが発生したスコープ全体を再度リプレイします。
再スロー	現在のフォルトを再スローします。フォルトの処理に、BPMNフォルト・ハンドラ(catchブランチ)が使用されます。デフォルトでは、再スロー・フォルト・ポリシーが明示的に指定されていない場合、すべての例外がフォルト管理フレームワークによって捕捉されます。
続行	フォルトを無視して処理を続行します(フォルト・アクティビティには成功のマークが付けられます)。

フォルト表内から次の追加監視タスクを実行します。
1. 「リカバリ可能なフォルトのみ表示」チェック・ボックスを選択すると、リカバリ可能なフォルトのみ表示されます。
2. 「フォルト・タイプ」リストから、すべてのフォルト、システム・フォルト、ビジネス・フォルトまたはOracle Web Service Manager (OWSM)フォルトを選択して、フォルト表に表示します。これらのフォルト・タイプの詳細は、「ヘルプ」アイコンをクリックしてください。
3. 「ビュー」リストから、「列」→「フォルトID」の順に選択し、各エラー・メッセージのフォルトIDを表示します。フォルトIDは自動的に生成され、フォルトを一意に識別します。フォルトIDは、エラー・メッセージをクリックしたときも表示されます。
4. 「コンポーネント・インスタンスID」列で、特定のサービス・コンポーネントIDをクリックし、インスタンスに関するタスク詳細(たとえば、タスクの現在の状態)にアクセスします。拒否メッセージにはコンポーネント・インスタンスIDがありません。
5. 「ログ」列で、リンクをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

詳細は、次のドキュメントを参照してください。

第1.4.3.1項「フォルト・リカバリの概要」
第8.4.2項「BPMNプロセスに対するフォルト・リカバリの例」
『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』

41.2 BPMNプロセス・サービス・コンポーネントのポリシーの管理

現在デプロイされているSOAコンポジット・アプリケーションのBPMNプロセス・サービス・コンポーネントとの間で、ポリシーをアタッチおよびデタッチできます。ポリシーでは、メッセージ配信に対してセキュリティが適用されます。Oracle Fusion Middlewareでは、ポリシー・ベースのモデルを使用してWebサービスを管理します。

注意:

ポリシーをアタッチするには、その前に、使用可能なポリシーの定義と使用環境で使用するポリシーの詳細について、『Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイド』を参照してください。

BPMNプロセス・サービス・コンポーネント・ポリシーを管理する手順は、次のとおりです。

次のいずれかのオプションを使用して、このページにアクセスします。

SOAインフラストラクチャのメニューから...	ナビゲータのSOAフォルダから...
「ホーム」を選択します。「デプロイ済コンポジット」タブを選択します。「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。	「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションを選択します。

「コンポーネント・メトリック」セクションで、BPMNプロセス・サービス・コンポーネントを選択します。
「ポリシー」をクリックします。

「ポリシー」ページを使用すると、BPMNプロセス・サービス・コンポーネントとの間でポリシーをアタッチおよびデタッチできます。ポリシー表には、アタッチされたポリシーの名前、切替え可能なポリシー参照ステータス(有効または無効)、カテゴリ(「管理」、「信頼できるメッセージング」、「MTOMアタッチメント」、「セキュリティ」または「WSアドレス」)、違反、およびSOAインフラストラクチャの最後の再起動以降の認証、認可、機密性および整合性の失敗が表示されます。
「アタッチ/デタッチ」をクリックします。

複数のコンポーネントが使用可能な場合は、アタッチまたはデタッチを実行するサービスまたはコンポーネントを選択するプロンプトが表示されます。
ポリシーのアタッチ先またはデタッチ先のサービスまたはコンポーネントを選択します。

ポリシーをアタッチまたはデタッチするためのダイアログが起動します。

「アタッチされたポリシー」セクションに、現在アタッチされているポリシーが表示されます。「使用可能なポリシー」セクションには、アタッチ可能な追加のポリシーが表示されます。
使用環境に適したポリシーを選択してアタッチします。
「アタッチ」をクリックします。
ポリシーのアタッチを終了した後は、「検証」をクリックします。
エラー・メッセージが表示された場合は、検証エラーがなくなるまで必要な修正を行います。
「OK」をクリックします。

アタッチしたポリシーがポリシー表に表示されます。

詳細は、次のドキュメントを参照してください。

第1.4.3.2項「ポリシーの概要」
ポリシーのアタッチで表示されるダイアログについては、第7.7項「SOAコンポジット・アプリケーションのポリシーの管理」を参照してください。
使用可能なポリシーの定義と使用環境で使用するポリシーの詳細は、『Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイド』を参照してください。

41.3 BPMNプロセス・サービス・エンジンのフォルトのリカバリ

BPMNプロセス・サービス・エンジンで発生し、リカバリ可能として識別されたフォルトを監視し、個別リカバリと一括リカバリを実行できます。BPMNプロセス・サービス・エンジンでは、すべてのBPMNプロセス・サービス・コンポーネントのフォルトを、属しているSOAコンポジット・アプリケーション・インスタンスに関係なく表示できます。リカバリ可能として識別されたBPMNプロセス・フォルトについては、(fault-bindings.xmlファイルを介して)フォルトにバインドされ、アクションora-human-interventionをトリガーするフォルト・ポリシーが定義されている必要があります。ただし、フォルト・ポリシーが定義されていない場合、フォルトは、リカバリ可能またはリカバリ不可のフォルトとして通常どおり処理されます。

BPMNプロセス・サービス・エンジンのフォルトをリカバリする手順は、次のとおりです。

次のいずれかのオプションを使用して、このページにアクセスします。

SOAインフラストラクチャのメニューから...	ナビゲータのSOAフォルダから...
「サービス・エンジン」→「BPMN」の順に選択します。	「soa-infra」を右クリックします。「サービス・エンジン」→「BPMN」の順に選択します。

「フォルト」タブを選択します。

図版bpmn_se_faults.gifの説明

「フォルト」ページに、次の詳細が表示されます。
- 特定のフォルトを検索するためのユーティリティ。基準を指定して「検索」をクリックします。詳細を表示するには、「ヘルプ」アイコンをクリックします。デフォルトでは、このページに初めてアクセスしたときにはフォルトは表示されません。フォルトを表示するには、「検索」をクリックする必要があります。
- サービス・エンジンで発生したフォルト。フォルトID、エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、フォルトが発生したSOAコンポジット・アプリケーションとサービス・コンポーネント、およびサービス・コンポーネント・インスタンスIDが表示されます。
リカバリが可能として識別されたBPMNプロセス・サービス・エンジンのフォルトはリカバリできます。

SOAインフラストラクチャ・レベル、SOAコンポジット・アプリケーション・レベルおよびOracle Mediatorサービス・コンポーネント・レベルでのフォルト・リカバリと同様に、単一フォルト・リカバリ、一括フォルト・リカバリ、およびすべてのフォルトのリカバリを実行できます。フォルトを選択してこれらのタイプのリカバリを実行する手順については、第41.1項「BPMNプロセス・サービス・コンポーネントのフォルトのリカバリ」の手順4を参照してください。

注意:

「リカバリ・アクション」リストからアクションを選択します。

アクション	説明
再試行	再試行成功時アクションを指定するオプション付きでインスタンスを再試行します。このリカバリ・アクションを使用するシナリオ例は、ネットワーク・エラーのためにサービス・プロバイダにアクセスできないことが原因でフォルトが発生した場合の例です。ネットワーク・エラーは現在解決しています。
中断	インスタンス全体を終了します。
リプレイ	フォルトが発生したスコープ全体を再度リプレイします。
再スロー	現在のフォルトを再スローします。フォルトの処理に、BPMNフォルト・ハンドラ(catchブランチ)が使用されます。デフォルトでは、再スロー・フォルト・ポリシーが明示的に指定されていない場合、すべての例外がフォルト管理フレームワークによって捕捉されます。
続行	フォルトを無視して処理を続行します(フォルト・アクティビティには成功のマークが付けられます)。

フォルト表内から次の追加監視タスクを実行します。
1. 「リカバリ可能なフォルトのみ表示」チェック・ボックスを選択すると、リカバリ可能なフォルトのみ表示されます。
2. 「フォルト・タイプ」リストから、すべてのフォルト、システム・フォルト、ビジネス・フォルトまたはOWSMフォルトを選択して、フォルト表に表示します。これらのフォルト・タイプの詳細は、「ヘルプ」アイコンをクリックしてください。
3. 「ビュー」リストから、「列」→「フォルトID」の順に選択し、各エラー・メッセージのフォルトIDを表示します。フォルトIDは自動的に生成され、フォルトを一意に識別します。フォルトIDは、エラー・メッセージをクリックしたときも表示されます。
4. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。
5. 「コンポーネント」列で、特定のサービス・コンポーネントをクリックし、そのホーム・ページにアクセスします。
6. 「コンポーネント・インスタンスID」列で、特定のサービス・コンポーネントIDをクリックし、インスタンスに関するタスク詳細(たとえば、タスクの現在の状態)にアクセスします。拒否メッセージにはコンポーネント・インスタンスIDがありません。

詳細は、次の項を参照してください。

第1.4.3.1項「フォルト・リカバリの概要」(フォルトの概念的な詳細情報)。
第8.4.2項「BPMNプロセスに対するフォルト・リカバリの例」

41.4 BPMNプロセス・サービス・エンジンのメッセージ・リカバリの実行

プロセス・インスタンスのトランザクション・ロールバックによって配信されなかった起動メッセージまたはコールバック・メッセージのリカバリは、手動で実行できます。起動メッセージのリカバリは、非同期のBPMNプロセスにのみ適用されます。同期BPMNプロセスは、エラーをコール側クライアントに返すため、このページからはリカバリできません。リカバリ可能アクティビティは失敗したアクティビティですが、リカバリが可能です。たとえば、非同期BPMNプロセスを起動するファイル・アダプタを使用しているときに、システムがインスタンスの処理中にクラッシュした場合は、すべてのメッセージ・レコードが確実にリカバリされるように、サーバーが再起動したときに手動でリカバリを実行できます。

注意:

エラー・メッセージORA-01000: maximum open cursors exceededが表示された場合、次を実行します。

Oracleデータベースを停止します。
OPEN_CURSORSの値を1500に増やします。
Oracleデータベースを再起動します。

BPMNプロセス・サービス・エンジンのメッセージをリカバリする手順は、次のとおりです。

次のいずれかのオプションを使用して、このページにアクセスします。

SOAインフラストラクチャのメニューから...	ナビゲータのSOAフォルダから...
「サービス・エンジン」→「BPMN」の順に選択します。	「soa-infra」を右クリックします。「サービス・エンジン」→「BPMN」の順に選択します。

「リカバリ」をクリックします。

「リカバリ」ページに、次の詳細が表示されます。
- 特定のメッセージの失敗を検索するためのユーティリティ。基準を指定して「検索」をクリックします。詳細は、「ヘルプ」アイコンをクリックしてください。
- サービス・エンジンでのメッセージの失敗。対話ID、メッセージの失敗のリカバリが可能かどうか、サービス・コンポーネント、失敗が発生したコンポジット・アプリケーション、およびフォルトの発生時間が表示されます。
この表でフォルトを選択します。

次のいずれかのオプションを選択します。

アクション	説明
リカバリ	フォルトが発生したメッセージを再試行します。関連する例外エラーが原因で、非同期BPMNプロセスでトランザクション・ロールバック・シナリオが発生した場合は、最後のデハイドレーション・アクティビティにロールバックします。これが新しいインスタンスであり、かつ最初のデハイドレーション・アクティビティが受信アクティビティであった場合、BPMNプロセス・サービス・エンジンはリカバリ可能な呼出しを作成します。呼出しをリカバリするために「リカバリ」をクリックすると、サービス・エンジンによって新しいインスタンスが作成されます。このインスタンスは、例外エラーなしで実行が完了する可能性があります。ただし、フォルトとして識別された古いインスタンスは引き続き表示されます。
取消としてマーク	メッセージが配信されないようにマークを付けます。

アクション

説明

リカバリ

フォルトが発生したメッセージを再試行します。

関連する例外エラーが原因で、非同期BPMNプロセスでトランザクション・ロールバック・シナリオが発生した場合は、最後のデハイドレーション・アクティビティにロールバックします。これが新しいインスタンスであり、かつ最初のデハイドレーション・アクティビティが受信アクティビティであった場合、BPMNプロセス・サービス・エンジンはリカバリ可能な呼出しを作成します。呼出しをリカバリするために「リカバリ」をクリックすると、サービス・エンジンによって新しいインスタンスが作成されます。このインスタンスは、例外エラーなしで実行が完了する可能性があります。ただし、フォルトとして識別された古いインスタンスは引き続き表示されます。

取消としてマーク

メッセージが配信されないようにマークを付けます。

リカバリのためにメッセージが送信されると、そのアクションがBPMNプロセス・サービス・エンジンによって完了するのに時間がかかる場合があります。通常、この時間は数秒以内となります。この間、メッセージは「リカバリ」ページに表示されたままになります。この期間内に、同じメッセージのリカバリをもう1回実行しても、無視されます。最新のリカバリ・ステータスを受信するには、ページを数秒ごとに更新します。