Oracle® Fusion Middleware

Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド

11gリリース1 (11.1.1.7.0)

B55916-10(原本部品番号:E10226-20)

2013年10月

バインディング・コンポーネント、Oracle BPELプロセス、ヒューマン・タスク、Oracle MediatorおよびOracle Business Process Management Notation (BPMN)サービス・コンポーネントで構成されるOracle Service-Oriented Architecture (SOA)コンポジット・アプリケーションをOracle Enterprise Manager Fusion Middleware Controlで管理する方法を記載したシステム管理者向けのドキュメントです。Oracle B2B、Oracle Business Activity Monitoring (BAM)、Oracle JCAアダプタ、Oracle User Messaging Serviceおよびビジネス・イベントの管理に関する追加情報も含まれています。

Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド, 11gリリース1 (11.1.1.7.0)

B55916-10

Copyright © 2006, 2013, Oracle and/or its affiliates. All rights reserved.

原本著者:  Oracle Corporation

原本協力者:  Oracle SOA Suite and Oracle Fusion Middleware development, product management, and quality assurance teams

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

このガイドで説明する新機能

第I部 Oracle SOA SuiteおよびOracle Business Process Management Suiteの概要

1 概要と概念

- 1.1 Oracle Fusion Middlewareの概要

- 1.2 Oracle SOA Suiteの概要

- 1.2.1 SOAインフラストラクチャ・アプリケーションの概要

- 1.2.2 SOAコンポジット・アプリケーションの概要

- 1.2.3 SOAコンポジット・アプリケーション・インスタンスの概要

- 1.2.4 サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要

- 1.2.4.1 Springサービス・コンポーネントのサポート

- 1.2.5 バインディング・コンポーネントの概要

- 1.2.6 サービス・エンジンの概要

- 1.2.7 サービス・インフラストラクチャの概要

- 1.2.8 SOAコンポジット・アプリケーションのコンテンツの概要

- 1.3 Oracle Business Process Management Suiteの概要

- 1.4 Oracle SOA SuiteおよびOracle BPM Suiteの管理

- 1.4.1 Oracle SOA SuiteおよびOracle BPM Suiteの構成

- 1.4.1.1 監査レベル設定の優先順位の概要

- 1.4.2 Oracle SOA SuiteおよびOracle BPM Suiteの監視

- 1.4.3 Oracle SOA SuiteおよびBPM Suiteの管理

- 1.4.3.1 フォルト・リカバリの概要

- 1.4.3.2 ポリシーの概要

- 1.4.3.3 SOAコンポジット・アプリケーションのライフサイクルの状態の概要

- 1.4.3.4 SOAコンポジット・アプリケーションの自動テストの概要

- 1.4.3.5 SOAインフラストラクチャのパーティションの概要

- 1.4.4 Oracle SOA SuiteおよびOracle BPM Suiteのパフォーマンスとチューニング

- 1.5 アプリケーション開発者による管理

- 1.6 Oracle Enterprise Manager 11g Grid ControlおよびOracle SOA Management Packによる管理

第II部 管理のスタート・ガイド

2 Oracle SOA SuiteおよびOracle BPM Suiteの管理のスタート・ガイド

- 2.1 Oracle Enterprise Manager Fusion Middleware Controlへのログイン

- 2.2 Oracle SOA SuiteおよびOracle BPM Suite管理タスクへの移動

- 2.2.1 SOAインフラストラクチャのホーム・ページおよびメニューからの移動

- 2.2.2 SOAコンポジット・アプリケーションのホーム・ページおよびメニューからの移動

- 2.2.3 パーティションのホーム・ページおよびメニューからの移動

- 2.2.4 デプロイ済Java EEアプリケーションへの移動

- 2.2.5 Oracle WebLogic Server管理コンソールおよび他のページへの移動

- 2.2.6 ファーム・ホーム・ページからSOAインフラストラクチャまたはSOAコンポジット・アプリケーションのホーム・ページへの移動

- 2.3 システムMBeanブラウザへの移動

- 2.3.1 メイン・ページからのシステムMBeanブラウザへのアクセス

- 2.3.2 「コンポーネント・プロパティ」ページからのシステムMBeanブラウザへのアクセス

- 2.4 Oracle Enterprise Manager Fusion Middleware Controlからのログアウト

第III部 SOAインフラストラクチャの管理

3 SOAインフラストラクチャの構成

- 3.1 SOAインフラストラクチャ・プロパティの構成

- 3.1.1 システムMBeanブラウザを使用した、インスタンス数とフォルト数のメトリックの取得の無効化

- 3.2 管理対象サーバーとSOAインフラストラクチャの停止と起動

- 3.2.1 SOAインフラストラクチャ起動初期化の完了の待機

- 3.2.2 SOAコンポジット・アプリケーションの状態およびSOAインフラストラクチャの停止

- 3.2.3 リタイアされたコンポジットがアクティブ化されているときは、SOAインフラストラクチャを再起動しても、エンドポイントがアクティブ化されない

- 3.2.4 cwallet.ssoにSOAマップが含まれている場合に、SOAインフラストラクチャの起動が失敗する

- 3.3 システムMBeanブラウザでのSOAインフラストラクチャ・サーバーURLプロパティ・ポートの変更

- 3.4 ログ・ファイルの構成

- 3.4.1 ログ・ファイルのエンコーディング・プロパティの構成

- 3.4.2 Oracle Enterprise Manager Fusion Middleware Controlページのパフォーマンス問題を診断するロギングの構成

- 3.5 カスタムXAドライバのサポートのためのドライバ名の変更

- 3.6 XAデータ・ソースへのデフォルト以外のXAトランザクション・タイムアウト値の指定

- 3.7 ローカルの最適化の構成

- 3.7.1 ローカルの最適化を使用するための条件チェック

- 3.7.2 ローカルの最適化のオーバーライドまたは強制

- 3.7.3 ローカルの最適化のロギング

- 3.7.4 ローカル最適化コールのユースケース

- 3.8 複数のSOAコンポジット・アプリケーションのグローバル・トークン変数の管理

- 3.8.1 「トークン構成」ページでのグローバル・トークン変数の管理

- 3.8.2 実行時にグローバル・トークン変数を置換する方法

- 3.8.3 事前定義されたグローバル・トークン変数の使用

4 SOAインフラストラクチャの監視

- 4.1 Oracle SOA Suiteルーティング・トポロジの検出

- 4.2 SOAインフラストラクチャのパフォーマンス・サマリー・メトリックの監視

- 4.3 SOAインフラストラクチャの最新のインスタンスとフォルト、およびデプロイ済コンポジットの監視

- 4.4 メッセージ配信リクエスト処理の監視

- 4.5 SOAインフラストラクチャのサービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントの監視

第IV部 SOAコンポジット・アプリケーションの管理

5 SOAコンポジット・アプリケーションの保護

- 5.1 SOAコンポジット・アプリケーションの保護の概要

- 5.2 Oracle WebLogic ServerグループまたはユーザーへのSOAOperatorおよびSOAMonitorロールのマッピング

- 5.3 Oracle BPM Worklist用のOracle HTTP Serverの構成

- 5.4 SOAインフラストラクチャのSAMLメッセージ保護付きポリシー構成の設定

- 5.5 Oracle BPM WorklistおよびOracle Business Process Managementユーザーの自動認証

- 5.5.1 SAML SSO環境でのOracle BPM Worklistユーザーの自動認証

- 5.5.2 SAML SSO環境でのOracle BPM Workspaceユーザーの自動認証

- 5.5.3 SAML SSO環境でのOracle Business Process Composerユーザーの自動認証

- 5.5.4 Windowsのネイティブ認証環境でのOracle BPM Worklistユーザーの自動認証

- 5.5.5 Windowsのネイティブ認証環境でのOracle Business Process Composerユーザーの自動認証

- 5.6 認証プロバイダの設定

- 5.6.1 Oracle Internet Directoryを最初の認証プロバイダとして表示

- 5.6.2 デフォルトの認証プロバイダを使用したWebベースのアプリケーションへのアクセス

- 5.7 NTLM認証をリクエストするWebサービスの起動

- 5.8 SSLの構成

- 5.8.1 HTTPSポートで構成されたSOA/BPMサーバーでのSSL証明書の使用

- 5.8.2 SSLで管理対象サーバーを全部構成する、または構成しないための推奨事項

- 5.8.3 Oracle BPM Worklistでの非SSLからSSL構成への切替え

- 5.8.4 SOAコンポジット・アプリケーションの双方向SSL通信の構成

- 5.8.5 Oracle JDeveloperの一方向SSL環境での参照の呼出し

- 5.8.6 Oracle SOA SuiteおよびOracle HTTP ServerのSSL通信の構成

- 5.8.6.1 Oracle HTTP ServerのSSL通信の構成

- 5.8.6.2 Oracle Client、Oracle HTTP ServerおよびOracle WebLogic Serverの証明書の構成

- 5.8.7 SOAコンポジット・アプリケーション・インスタンスとOracle WebCache間のSSLの構成

- 5.8.8 設計時の一方向SSLでのカスタム・トラスト・ストアの使用

- 5.8.9 SSL対応の管理対象サーバーにデプロイ済の非同期プロセスの有効化による、HTTPを介した別の非同期プロセスの呼出し

- 5.9 ヒューマン・ワークフローWSDLファイルに対するセキュリティの構成

6 SOAコンポジット・アプリケーションの監視

- 6.1 SOAコンポジット・アプリケーションのパフォーマンス・サマリー・メトリックの監視

- 6.2 SOAコンポジット・アプリケーションの最新のインスタンスとフォルトおよび拒否メッセージの監視

7 SOAコンポジット・アプリケーションのデプロイおよび管理

- 7.1 SOAコンポジット・アプリケーションのデプロイ

- 7.1.1 複数のADFタスク・フォーム・デプロイメントのPermGenメモリー要件

- 7.1.2 タスク・フローを持つSOAコンポジット・アプリケーションのデプロイ

- 7.1.3 antスクリプトおよびWLSTコマンドライン・ツールによるSOAコンポジット・アプリケーションのデプロイ

- 7.2 アンデプロイメントまたは再デプロイメント時のインスタンス、フォルトおよび拒否メッセージの失効状態への更新

- 7.3 SOAコンポジット・アプリケーションの再デプロイ

- 7.4 SOAコンポジット・アプリケーションのアンデプロイ

- 7.5 デプロイ済SOAコンポジット・アプリケーションの状態管理

- 7.5.1 SOAインフラストラクチャ・レベルでのすべてのアプリケーションの状態管理

- 7.5.2 SOAコンポジット・アプリケーションのホーム・ページでのアプリケーションの状態管理

- 7.5.3 BPEL処理途中でSOAインフラストラクチャがデプロイされる管理対象のOracle WebLogic Serverの起動および停止

- 7.5.4 コンポジット・インスタンス名の設定

- 7.6 SOAコンポジット・アプリケーションのテストの自動化

- 7.7 SOAコンポジット・アプリケーションのポリシーの管理

- 7.7.1 WS-RMセッション

- 7.7.2 コンポジット間呼出しでのポリシー・アタッチメントおよびローカルの最適化

- 7.8 デプロイ済のSOAコンポジット・アプリケーションのエクスポート

- 7.9 SOAコンポジット・アプリケーションのパーティションへのグループ化

- 7.9.1 パーティションの作成および削除

- 7.9.2 パーティションのコンポジットに対する一括ライフサイクル管理タスクの実行

- 7.10 BPELおよびBPMNのビジネス監視の有効化と無効化

8  SOAコンポジット・アプリケーション・インスタンスの管理

- 8.1 SOAコンポジット・アプリケーションのテスト・インスタンスの起動

- 8.1.1 「Webサービスのテスト」ページでのRPC/リテラル・スタイルのWSDLファイルの指定

- 8.2 アプリケーションのホーム・ページからの、SOAコンポジット・アプリケーション・インスタンスの監視と削除

- 8.2.1 SOAコンポジット・アプリケーション・インスタンス数とサービス・コンポーネント・インスタンス数の不一致

- 8.2.2 サービス・コンポーネントとSOAコンポジット・アプリケーションのインスタンスの状態

- 8.3 SOAインフラストラクチャ・レベルでの、SOAコンポジット・アプリケーション・インスタンスの監視と削除

- 8.4 SOAインフラストラクチャ・レベルでの、SOAコンポジット・アプリケーションのフォルトのリカバリ

- 8.4.1 BPELプロセスに対するフォルト・リカバリの例

- 8.4.1.1 例: BPELプロセスに対する単一フォルト・リカバリ

- 8.4.1.2 例: BPELプロセスに対する一括フォルト・リカバリ

- 8.4.2 BPMNプロセスに対するフォルト・リカバリの例

- 8.4.2.1 例: BPMNプロセスに対する単一フォルト・リカバリ

- 8.4.2.2 例: BPMNプロセスに対する一括フォルト・リカバリ

- 8.4.3 Oracle Mediatorに対するフォルト・リカバリの例

- 8.4.3.1 例: Oracle Mediatorに対する単一フォルト・リカバリ

- 8.4.3.2 例: Oracle Mediatorに対する一括フォルト・リカバリ

- 8.5 アプリケーションのホーム・ページでの、SOAコンポジット・アプリケーションのフォルトのリカバリ

- 8.6 SOAインフラストラクチャ・レベルでの拒否メッセージの削除

- 8.7 アプリケーションのホーム・ページからの拒否メッセージの削除

- 8.8 複数のSOAコンポジット・アプリケーション・リビジョン間でのインスタンスの移行

- 8.8.1 移行の互換性

- 8.8.2 Facade APIによるインスタンスの移行

- 8.8.2.1 一括移行の評価

- 8.8.2.2 移行レポート

- 8.8.2.3 移行の一括実行

- 8.8.2.4 移行の結果

- 8.8.2.5 移行計画

- 8.8.2.6 移行API

- 8.8.3 antスクリプトによるインスタンスの移行

- 8.8.4 Oracle BPMのリビジョン・インスタンス移行の例

- 8.8.5 すべてのサービス・コンポーネントとともにリビジョン・インスタンスを移行する例

- 8.8.6 互換性のないサービス・コンポーネントを含むリビジョンを移行する例

9 データベース増分管理戦略の策定

- 9.1 データベース増分計画の概要

- 9.2 データベースのプロファイルまたはサイズの確認

- 9.2.1 データのインフローの確認

- 9.2.1.1 毎日生成されるコンポジット数の確認

- 9.2.1.2 各コンポジットが使用するディスク領域の確認

- 9.2.1.3 毎日永続的に使用されるコンポジット領域の確認

- 9.2.1.4 Oracle SOA Suiteセグメントの領域配分の分析

- 9.2.2 保存ポリシーの策定

- 9.2.2.1 最小保存ディスク領域の決定

- 9.2.2.2 最小保存コンポジット数の判定

- 9.2.3 データのアウトフローの確認

- 9.2.4 長期間実行されるコンポジットおよび表のパーティション化の確認

- 9.2.4.1 パーティション化する各表に対する推奨事項

- 9.3 領域使用量、ハードウェア・リソース、およびデータベース・パフォーマンスの監視

- 9.3.1 領域の使用量の監視

- 9.3.1.1 コンポーネントの増加傾向の判定

- 9.3.1.2 Oracle SOA Suiteスキーマの増加傾向の判定

- 9.3.1.3 最大セグメントの判別

- 9.3.1.4 表と索引の増加傾向の判定

- 9.3.1.5 表サイズの推定

- 9.3.1.6 索引サイズの推定

- 9.3.1.7 未使用索引の監視

- 9.3.2 ハードウェア・リソースおよびデータベースの監視

- 9.3.2.1 ハードウェア- OSWatcher Black Box

- 9.3.2.2 データベース– AWR/ADDM

- 9.3.2.3 ディスクI/O-Oracle Orion

- 9.4 増分管理の課題およびテスト戦略について

- 9.4.1 データベース増分管理の課題

- 9.4.1.1 非効率的な管理戦略によるOracle SOA Suiteの表の過度の増大化

- 9.4.1.2 インフローを処理できない調整済のパラレル・パージ・スクリプト

- 9.4.1.3 長時間実行されるコンポジットが原因で削除できない表パーティション

- 9.4.2 品質保証テスト

- 9.4.2.1 Metalinkサポート・ノート1384379.1の確認

- 9.4.2.2 本番監査レベル設定の構成

- 9.4.2.3 Oracle SOA Suiteスキーマの作成-テスト環境

- 9.4.2.4 パラレルまたはシングル・スレッド・スクリプトの実行および領域の再利用

- 9.4.2.5 テスト結果の確認

- 9.4.2.6 ボトルネックを発生する表のパーティション化

- 9.4.2.7 パージ・テストと確認の反復およびパーティション化された表の除外

- 9.4.3 推奨される増分管理戦略

- 9.4.3.1 大規模データベース・プロファイルの推奨事項

- 9.4.3.2 中規模データベース・プロファイルの推奨事項

- 9.4.3.3 小規模データベース・プロファイルの推奨事項

- 9.5 領域管理について

- 9.5.1 データファイルのコンポーネントの概要

- 9.5.1.1 セグメント最高水位標

- 9.5.2 セグメントおよびデータファイル領域の再利用

- 9.5.2.1 オンラインのセグメント縮小の実行

- 9.5.2.2 未使用領域の割当て解除

- 9.5.2.3 索引の結合および再構築

- 9.5.2.4 表パーティションの削除

- 9.5.2.5 セキュアなファイルのLOBの構成

- 9.5.2.6 その他のデータベース管理方法

- 9.5.3 データファイルのサイズ変更

10 データベース増分の管理

- 10.1 データベース増分の管理の概要

- 10.2 パージおよびパーティション化の方法の開発

- 10.3 パージ・スクリプトを使用した大量のインスタンスの削除

- 10.3.1 ループしたパージ・スクリプト

- 10.3.1.1 delete_instancesプロシージャ

- 10.3.2 dbms_schedulerを使用したパラレル・スクリプトでのループしたパージ

- 10.3.2.1 パラレルでのdelete_instancesプロシージャ

- 10.3.2.2 パラレル・スクリプトでのループしたパージの実行後のデッドロックの解決

- 10.3.3 パージの状態

- 10.3.4 Oracle Mediatorのリシーケンスされたメッセージのパージの状態

- 10.3.5 特定のSOAコンポジット・アプリケーションのインスタンスのパージ

- 10.3.6 パージ・スクリプトの実行

- 10.4 コンポーネント表のパーティション化

- 10.4.1 コンポーネント・データベース表のパーティション化

- 10.4.1.1 参照整合性および同一レベル・パーティション化

- 10.4.1.2 パーティション・キーの選択の概要

- 10.4.2 パーティションの構成

- 10.4.3 検証スクリプトの概要

- 10.4.4 コンポーネント表

- 10.4.4.1 パーティション化の制約

- 10.4.4.2 コンポーネント表、レンジ・パーティション・キーおよびグループ

- 10.4.5 検証スクリプトの実行

- 10.4.6 パーティションの検証と削除

- 10.4.7 別のパーティションへの長時間実行されているアクティブなインスタンスの移動

- 10.4.8 コンポーネントの部分的なパーティション化

- 10.5 表削除なしでの実行時表からのレコードの削除

- 10.6 オープン・コンポジット・インスタンスでの表の再作成およびデータベース領域の再利用

- 10.6.1 TRSスクリプトの使用に関する考慮事項

- 10.6.2 TRSスクリプトの機能

- 10.6.3 XML_DOCUMENT表の再構築の前提条件

- 10.6.4 フェーズ1-TRSスクリプトの作成

- 10.6.5 フェーズ2-TRSスクリプトの実行

- 10.6.6 ロギングとデバッグ

- 10.7 Microsoft SQL Serverでのインスタンスのパージ

- 10.7.1 Microsoft SQL Serverの機能について

- 10.7.2 Microsoft SQL Server上のパージ・スクリプトの相違点

- 10.7.3 Microsoft SQL Server上でのパージ・スクリプトの実行

11 Facade APIを使用したSOAコンポジット・アプリケーションのプログラムによる管理

- 11.1 SOAコンポジット・アプリケーションのプログラムによる管理の概要

- 11.1.1 locatorオブジェクト作成時に必要なセキュリティ資格証明

- 11.2 Facade APIインタフェース

- 11.3 Facade APIの例

- 11.3.1 コンポジットの状態の取得

- 11.3.2 コンポジット・インスタンスおよびコンポーネント・インスタンスの検索

12 SOAコンポジット・アプリケーションに関する問題の診断

- 12.1 診断フレームワークの概要

- 12.1.1 WLDFの概要

- 12.1.1.1 監視および通知の概要

- 12.1.1.2 診断シナリオおよびMBeanの概要

- 12.1.2 診断フレームワークの概要

- 12.1.2.1 インシデント・パッケージ数の制御

- 12.1.3 事前定義のインシデント処理ルール

- 12.1.3.1 診断フレームワークを使用したインシデント処理ルール・ファイルの構成

- 12.1.3.2 SOAサーバーのホーム・ディレクトリでのインシデント処理ルール・ファイルの構成

- 12.1.3.3 カスタム・ルール・ファイルの動的なロード

- 12.2 Oracle SOA Suite診断ダンプの実行

- 12.2.1 ランタイム環境の診断ダンプ(soa.env)

- 12.2.1.1 WLSTコマンド(ダンプの説明および実行)

- 12.2.2 ランタイム・プラットフォーム構成の診断ダンプ(soa.config)

- 12.2.2.1 WLSTコマンド(ダンプの説明および実行)

- 12.2.3 データベース診断ダンプ(soa.db)

- 12.2.3.1 WLSTコマンド(ダンプの説明および実行)

- 12.2.4 デプロイ済コンポジット・メタデータの診断ダンプ(soa.composite)

- 12.2.4.1 WLSTコマンド(ダンプの説明および実行)

- 12.2.5 インスタンス監査証跡の診断ダンプ(soa.composite.trail)

- 12.2.5.1 WLSTコマンド(ダンプの説明および実行)

- 12.2.6 イベント診断ダンプ(soa.edn)

- 12.2.6.1 WLSTコマンド(ダンプの説明および実行)

- 12.2.7 デプロイ済コンポジットWSDL/スキーマ・キャッシュの診断ダンプ(soa.wsdl)

- 12.2.7.1 WLSTコマンド(ダンプの説明および実行)

- 12.2.8 ディスパッチャの静的構成の診断ダンプ(bpel.dispatcher)

- 12.2.8.1 WLSTコマンド(ダンプの説明および実行)

- 12.2.8.2 システムMBeanブラウザを使用したディスパッチャの静的構成の診断ダンプの取得

- 12.2.9 平均インスタンス処理時間の診断ダンプ(bpel.apt)

- 12.2.9.1 WLSTコマンド(ダンプの説明および実行)

- 12.2.10 平均インスタンス処理遅延の診断ダンプ(bpel.apd)

- 12.2.10.1 WLSTコマンド(ダンプの説明および実行)

- 12.2.11 同期プロセス統計の診断ダンプ(bpel.sps)

- 12.2.11.1 WLSTコマンド(ダンプの説明および実行)

- 12.2.12 非同期プロセス統計の診断ダンプ(bpel.aps)

- 12.2.12.1 WLSTコマンド(ダンプの説明および実行)

- 12.2.13 リクエスト統計の診断ダンプ(bpel.rs)

- 12.2.13.1 WLSTコマンド(ダンプの説明および実行)

- 12.2.14 リシーケンサ・グループ処理遅延の診断ダンプ(mediator.resequencer)

- 12.2.14.1 WLSTコマンド(ダンプの説明および実行)

- 12.2.15 アダプタ診断ダンプ(soa.adapter.ra)

- 12.2.15.1 WLSTコマンド(ダンプの説明および実行)

- 12.2.16 アダプタ診断ダンプ(soa.adapter.connpool)

- 12.2.16.1 WLSTコマンド(ダンプの説明および実行)

- 12.2.17 アダプタ診断ダンプ(soa.adapter.stats)

- 12.2.17.1 WLSTコマンド(ダンプの説明および実行)

- 12.3 SOAコンポジット・アプリケーションの診断フレームワーク・スレッド・ダンプの実行

- 12.3.1 WLSTコマンド(ダンプの説明および実行)

- 12.4 サポートされるDMSメトリック

- 12.5 監視および通知の作成

- 12.5.1 事前構成済ルールおよび監視の有効化

- 12.5.2 Oracle SOA Suite監視および通知の手動作成

- 12.5.3 Webサービス・バインディング・コールの経過時間を識別する監視の作成

- 12.5.4 処理遅延が指定の制限時間を超えているかどうかを識別する監視の作成

- 12.5.5 リシーケンサの監視および通知の作成

- 12.6 手動によるダンプのトリガーと実行

- 12.7 ADRツールでのインシデント・パッケージの表示

- 12.8 問題およびインシデントの問合せ

第V部 BPELプロセスのサービス・コンポーネントとエンジンの管理

13 BPELプロセスのサービス・コンポーネントとエンジンの構成

- 13.1 BPELプロセス・サービス・エンジン・プロパティの構成

- 13.2 Oracle BPEL Process Managerの自動リカバリの構成

- 13.3 マスター・ノード・リカバリ・スケジューリングの構成

- 13.4 起動メッセージおよびコールバック・メッセージの自動リカバリ試行の構成

- 13.5 コールバック・メッセージの順序の保持

- 13.6 BPELプロセス・サービス・コンポーネント・レベルでの監査レベルの設定

14 BPELプロセスのサービス・コンポーネントとエンジンの監視

- 14.1 BPELプロセス・サービス・コンポーネントの監査証跡とプロセス・フローの監視

- 14.1.1 フォルトが発生していないのにreplayアクティビティが失敗したと表示される

- 14.1.2 複数のサーバー上におけるコンポジット間呼び出しのフロー・トレース

- 14.1.3 監査証跡とプロセス・フローでのBPEL 2.0アクティビティの監視

- 14.2 BPELプロセス・サービス・コンポーネントの最新のインスタンスとフォルトの監視

- 14.3 BPELプロセス・サービス・コンポーネントのインスタンスの監視

- 14.4 BPELプロセス・サービス・コンポーネントにおけるフォルト、アクティビティおよび可変センサー・データの監視

- 14.4.1 BPEL 2.0のCompensateおよびCompensateScopeアクティビティ内でのアクティビティ・センサーの動作

- 14.5 BPELプロセス・サービス・エンジンのインスタンスとフォルトの監視

- 14.6 BPELプロセス・サービス・エンジンのリクエスト統計とスレッドパフォーマンス統計の監視

- 14.6.1 「リクエストのブレークダウン」表の下位レベルの詳細の表示

- 14.7 BPELプロセス・サービス・エンジンのインスタンスの監視

- 14.8 サービス・エンジンのデプロイ済BPELプロセス・サービス・コンポーネントの監視

- 14.9 BPELプロセス・サービス・エンジンでのリクエストの所要時間に関する統計の表示

15 BPELプロセスのサービス・コンポーネントとエンジンの管理

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

- 15.2 BPELプロセス・サービス・コンポーネントのポリシーの管理

- 15.3 BPELプロセス・サービス・エンジンのフォルトのリカバリ

- 15.4 BPELプロセス・サービス・エンジンのメッセージ・リカバリの実行

- 15.5 Oracle Exalogicプラットフォームにおけるインスタンスとメッセージ・データのOracle Coherence分散キャッシュへの格納

- 15.5.1 Oracle Coherenceのキャッシュ機能アーキテクチャの概要

- 15.5.2 デフォルトのSOAクラスタ・ノードおよびCoherenceキャッシュ・グリッド・ノードでの実行

- 15.5.3 Oracle Coherenceのキャッシュ機能の構成

- 15.5.4 複数の監査証跡メッセージの単一トランザクションへの格納の構成

- 15.5.5 Oracle Coherenceキャッシュへの監査証跡の格納の構成

- 15.5.6 Oracle Coherenceキャッシュへの呼出しメッセージの格納の構成

- 15.5.7 BPELプロセス・キャッシュ・サーバーの起動

第VI部 Oracle Mediatorのサービス・コンポーネントとエンジンの管理

16 Oracle Mediatorのサービス・コンポーネントとエンジンの構成

- 16.1 Oracle Mediatorサービス・エンジン・プロパティの構成

- 16.2 リシーケンスされたメッセージの構成

17 Oracle Mediatorのサービス・コンポーネントとエンジンの監視

- 17.1 Oracle Mediatorの「ダッシュボード」ページの概要

- 17.1.1 「最新のインスタンス」セクション

- 17.1.2 「コンポーネント」セクション

- 17.1.3 「最新のフォルト」セクション

- 17.1.4 「ルーティングの統計」セクション

- 17.1.5 「インスタンス率/分(リアルタイム・データ)」セクション

- 17.2 Oracle Mediatorサービス・コンポーネントのインスタンスとフォルトの監視

- 17.2.1 Oracle Mediatorサービス・コンポーネントの最新インスタンスおよびフォルトの監視

- 17.2.2 Oracle Mediatorサービス・コンポーネント・インスタンスの監視

- 17.2.3 Oracle Mediatorサービス・コンポーネント・フォルトの監視

- 17.2.4 Oracle Mediatorのルーティング統計の監視

- 17.2.5 Oracle Mediatorコンポーネント・インスタンスの監査証跡とフォルト詳細の監視

- 17.3 Oracle Mediatorサービス・エンジンのインスタンスとフォルトの監視

- 17.3.1 Oracle Mediatorサービス・エンジンの最新インスタンスおよびフォルトの監視

- 17.3.2 Oracle Mediatorサービス・エンジン・インスタンスの監視

- 17.3.3 リクエストのブレークダウン統計の監視

- 17.3.4 サービス・エンジンのデプロイ済Oracle Mediatorサービス・コンポーネントの監視

- 17.4 リシーケンスされたメッセージの監視

- 17.4.1 メディエータ・サービス・コンポーネントのホーム・ページからのリシーケンスされたメッセージの監視

- 17.4.1.1 「ダッシュボード」ページ

- 17.4.1.2 「インスタンス」ページ

- 17.4.1.3 「フォルト」ページ

- 17.4.1.4 「メディエータ・リシーケンス・グループ」ダイアログ

- 17.4.2 「メディエータ・インスタンス」ダイアログからのリシーケンスされたメッセージの監視

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

- 18.1 Oracle Mediatorサービス・コンポーネントのフォルトのリカバリ

- 18.2 Oracle Mediatorのポリシーの管理

- 18.3 Oracle Mediatorサービス・エンジンのフォルトのリカバリ

- 18.4 リシーケンスされたメッセージのスキップ

- 18.4.1 実行中のグループの次のシーケンスIDへのスキップ

- 18.4.2 タイムアウトしたグループの次のシーケンスIDへのスキップ

19 相互参照の管理

- 19.1 相互参照値の削除

第VII部 デシジョン・サービス・コンポーネントとビジネス・ルール・サービス・エンジンの管理

20 デシジョン・サービス・コンポーネントとエンジンの監視

- 20.1 ビジネス・ルール・サービス・エンジンの最新のインスタンスとフォルトの監視

- 20.2 ビジネス・ルール・サービス・エンジンのパフォーマンス統計の監視

- 20.3 ビジネス・ルール・サービス・エンジンのインスタンスの監視

- 20.4 ビジネス・ルール・サービス・エンジンのフォルトの監視

- 20.5 ビジネス・ルール・サービス・エンジンのデプロイ済コンポーネントの監視

- 20.6 コンポジット・アプリケーションのデシジョン・サービス・コンポーネントのインスタンスの監視

- 20.7 ビジネス・ルールのトレースの監視

- 20.7.1 開発監査レベルでのルール実行のトレース

- 20.7.2 本番監査レベルでのルール実行のトレース

- 20.8 デシジョン・サービス・コンポーネントのログの監視

- 20.8.1 デシジョン・サービス・コンポーネントのログの表示

- 20.8.2 ログ構成での診断ロギング・レベルの設定

第VIII部 ヒューマン・タスク・サービス・コンポーネントとヒューマン・ワークフロー・サービス・エンジンの管理

21 ヒューマン・ワークフローのサービス・コンポーネントとエンジンの構成

- 21.1 ヒューマン・ワークフロー通知プロパティの構成

- 21.2 テスト・アドレスに通知を送信する通知サービスの構成

- 21.3 ヒューマン・ワークフロー・タスク・サービス・プロパティの構成

- 21.4 Oracle HTTP Serverでのタスク・フォームの添付の構成

- 21.5 Oracle Human Workflow通知用のOracle Advanced Queuingの構成

- 21.6 プラガブル通知サービスの構成

- 21.6.1 プラガブル通知サービスの実装

- 21.6.2 プラガブル通知サービスの登録

- 21.7 Oracle BPM Worklistタスクに対するオート・リリース・タイマーのグローバルな無効化

- 21.8 電子メール通知メッセージの数の構成

- 21.9 複数の送信アドレスの構成

- 21.10 通知の再試行の構成

- 21.11 アイデンティティ・サービスの構成

- 21.11.1 認証プロバイダの追加

- 21.11.1.1 ユーザー属性の更新

- 21.11.2 認証プロバイダのユーザーとグループの作成

- 21.11.2.1 WebLogicコンソールを使用したユーザーとグループの作成

- 21.11.2.2 Oracle Internet Directoryを使用したユーザーとグループの作成

- 21.11.3 ディレクトリ・サービスの構成

- 21.11.4 アイデンティティ・プロバイダのカスタマイズ

- 21.12 LDAPツールを使用したユーザー、グループおよびアプリケーション・ロールのシード

- 21.12.1 組込みLDAPサーバーのデフォルト・パスワードの変更

- 21.12.2 LDAPブラウザを介したユーザーまたはグループのシード

- 21.12.3 WLSTスクリプトを使用したアプリケーション・ロールのシード

- 21.12.4 Oracle Enterprise Manager Fusion Middleware Controlでのアプリケーション・ロールの管理

- 21.13 ヒューマン・タスクでの大文字/小文字を区別しないグループ名の有効化

- 21.14 ヒューマン・ワークフローWebサービスのセキュリティ・ポリシーの構成

22 ヒューマン・ワークフローのサービス・コンポーネントとエンジンの監視

- 22.1 ヒューマン・タスク・サービス・コンポーネントの最新のインスタンスとフォルトの監視

- 22.2 ヒューマン・ワークフロー・タスクのステータスの表示

- 22.3 ヒューマン・タスク・サービス・コンポーネントのインスタンスの監視

- 22.4 ヒューマン・ワークフロー・サービス・エンジンの最新のインスタンスとフォルトの監視

- 22.5 ヒューマン・ワークフロー・サービス・エンジンのアクティブ・リクエストと操作パフォーマンス統計の監視

- 22.6 ヒューマン・ワークフロー・サービス・エンジンのインスタンスの監視

- 22.7 サービス・エンジンにデプロイされたヒューマン・ワークフローの監視

23 ヒューマン・ワークフローのサービス・コンポーネントとエンジンの管理

- 23.1 ヒューマン・タスク・サービス・コンポーネントのポリシーの管理

- 23.2 ヒューマン・ワークフロー・サービス・エンジンのフォルトのリカバリ

- 23.3 ヒューマン・タスク・サービス・コンポーネントのタスク詳細アプリケーションのURI管理

- 23.4 ヒューマン・タスク・サービス・コンポーネントのフォルトのリカバリ

- 23.5 送信通知および受信電子メール通知の管理

- 23.6 ヒューマン・ワークフロー・データのテスト環境から本番環境への移動

- 23.6.1 ヒューマン・ワークフロー・データのテスト環境から本番環境への移動

- 23.6.2 migration.propertiesファイルの構文

- 23.6.2.1 移行プロパティ・ファイルの例

- 23.6.3 antスクリプトのデータ移行の構文

第IX部 Oracle Business Activity Monitoringの管理

24 Oracle Business Activity Monitoringの構成

- 24.1 Oracle BAMの構成の概要

- 24.2 Oracle BAM Web基本プロパティの構成

- 24.2.1 Oracle BAM Webアプリケーションのプロパティの構成

- 24.2.2 アプリケーションURLの構成

- 24.2.3 レポート・ロード・インジケータの構成

- 24.2.4 サーバー名の構成

- 24.3 Oracle BAMサーバー基本プロパティの構成

- 24.3.1 Oracle BAMサーバー・プロパティの構成

- 24.3.2 データソースJNDIの構成

- 24.3.3 アプリケーションURLの構成

- 24.3.4 ビューセットの共有の構成

- 24.3.5 レポート・キャッシュ永続性マネージャの構成

- 24.3.6 Oracle Data Integratorの統合プロパティの構成

- 24.3.7 電子メール・アカウントのアウトバウンドの構成

- 24.4 ロガーの構成

- 24.5 Oracle User Messaging Serviceの構成

- 24.6 Oracle BAMのディストリビューション・リストの構成

- 24.7 Oracle BAMアダプタの構成

- 24.7.1 Oracle BAMアダプタ・プロパティの構成

- 24.7.1.1 メッセージの送信を再試行するためのアダプタの構成

- 24.7.2 Oracle BAMコネクション・ファクトリの構成

- 24.7.2.1 Oracle BAMアダプタに対するHTTPSの構成

- 24.7.3 信頼できるドメインの構成

- 24.7.4 資格証明マッピングの構成

- 24.8 Oracle BAMのバッチ処理プロパティの構成

- 24.9 セキュリティの構成

- 24.9.1 資格証明マッピングの構成

- 24.9.2 Oracle BAMユーザー権限の構成

- 24.9.3 Secure Socket Layerの構成

- 24.9.4 Oracle BAMでのOracle Internet Directoryの使用

- 24.9.5 Oracle BAM JMSリソースの保護

- 24.9.6 セキュアなWebサービスのコール

- 24.9.6.1 例: Oracle BAM Webサービスの保護

- 24.10 拡張プロパティの構成

- 24.11 Oracle BAMの構成プロパティの参照

25 Oracle Business Activity Monitoringの監視

- 25.1 Oracle BAMの監視の概要

- 25.2 Oracle BAMサーバーのコンポーネントの監視

- 25.2.1 Oracle BAMアクティブ・データ・キャッシュの監視

- 25.2.2 イベント・エンジン・コンポーネントの監視

- 25.2.3 レポート・キャッシュ・コンポーネントの監視

- 25.2.4 エンタープライズ・メッセージ・ソースの監視

- 25.2.5 進行中のクライアント・リクエストの監視

- 25.3 Oracle BAM Webアプリケーションの監視

- 25.3.1 Oracle BAMレポート・サーバーの監視

- 25.3.2 オープン接続の監視

- 25.4 Oracle BAM Webサービスの監視

- 25.5 Oracle BAMのパフォーマンスの監視

- 25.6 Oracle BAMのログの監視

26 Oracle Business Activity Monitoringの管理

- 26.1 Oracle BAMの管理の概要

- 26.2 Oracle BAMの可用性の管理

- 26.3 Oracle BAMユーザーの管理

- 26.3.1 ユーザーとグループの定義

- 26.3.2 以前にシードされたグループ・メンバーの使用

- 26.3.3 アプリケーション・ロールへのメンバーの追加

- 26.3.3.1 DBベースのポリシー・ストアを使用するSOAドメインへのOracle BAMの拡張

- 26.3.4 Oracle BAMアプリケーション・ロールの概要

- 26.3.5 Oracle WebLogic Server組込みLDAPサーバーの構成

- 26.3.5.1 Oracle WebLogic Server管理コンソールの使用

- 26.3.5.2 グループの追加

- 26.3.5.3 ユーザーの追加

- 26.3.5.4 グループへのユーザーの追加

- 26.3.6 Oracle BAMアドミニストレータへのユーザーの移入

- 26.3.6.1 Registerusersユーティリティの使用

- 26.3.6.2 ユーザー・ログインによる移入

- 26.3.7 Oracle BAMのオブジェクト所有権の管理

- 26.3.8 Oracle BAMアドミニストレータからの無効なユーザーの削除

第X部 Oracle User Messaging Serviceの管理

27 Oracle User Messaging Serviceの構成

- 27.1 ユーザー・メッセージング・サービスの概要

- 27.1.1 コンポーネント

- 27.1.2 アーキテクチャ

- 27.2 Oracle User Messaging Serviceの構成の概要

- 27.3 ユーザー・メッセージング・サービスの構成ページへのアクセス

- 27.3.1 保管方法の設定

- 27.3.2 ユーザー・メッセージング・プリファレンスのビジネス条件の追加または削除

- 27.3.2.1 ビジネス条件の追加

- 27.3.2.2 ビジネス条件の削除

- 27.4 ユーザー・メッセージング・サービス・ドライバの構成

- 27.4.1 ドライバの構成

- 27.4.1.1 ドライバ・プロパティの概要

- 27.4.1.2 パスワードの保護

- 27.4.1.3 メッセージング拡張ドライバの構成

- 27.4.1.4 電子メール・ドライバの構成

- 27.4.1.5 SMPPドライバの構成

- 27.4.1.6 XMPPドライバの構成

- 27.4.1.7 VoiceXMLドライバの構成

- 27.4.1.8 ワークリスト・ドライバの構成

- 27.4.1.9 プロキシ・ドライバの構成

- 27.5 LDAPユーザー・プロファイルへのユーザー・メッセージング・サービスのアクセスの構成

- 27.6 Oracle User Messaging Serviceの保護

- 27.6.1 通知に関するWebサービス・セキュリティ

- 27.6.2 UMSサービス・セキュリティの有効化

- 27.6.3 クライアント・セキュリティの有効化

- 27.6.4 キーストア構成

- 27.6.5 クライアント別名

- 27.6.6 JMSリソースの保護

- 27.7 Oracle User Messaging Serviceのトラブルシューティング

28 Oracle User Messaging Serviceの監視

- 28.1 Oracle User Messaging Serviceの監視

- 28.1.1 メッセージ・ステータスの使用

- 28.1.2 メッセージング・クライアント・アプリケーションの登録解除

- 28.1.3 「すべて」タブを使用したドライバの監視

- 28.2 ログ・ファイルの表示

- 28.2.1 ロギングの構成

- 28.3 メトリックおよび統計の表示

29 Oracle User Messaging Serviceの管理

- 29.1 ドライバのデプロイ

- 29.1.1 WLSTコマンドを使用したドライバのデプロイ

- 29.1.1.1 deployUserMessagingDriver

- 29.1.2 Oracle Enterprise Manager Fusion Middleware Controlを使用したドライバのデプロイ

- 29.1.3 Oracle Fusion Middleware構成ウィザードを使用したドライバのデプロイ

- 29.1.4 wsadminツールを使用したドライバのデプロイ

- 29.1.4.1 wsadminのOracleUMS.deployUserMessagingDriverコマンドについて

- 29.1.4.2 追加ドライバのデプロイ

- 29.2 ドライバのアンデプロイおよび登録解除

第XI部 Oracle JCAアダプタの管理

30 Oracle JCAアダプタの構成

- 30.1 インバウンド・アダプタのエンドポイント・プロパティの構成

- 30.1.1 インバウンド・アダプタの事前定義されたプロパティの編集

- 30.1.2 インバウンド・アダプタの事前定義されたプロパティの追加

- 30.1.3 インバウンド・アダプタの新規プロパティの作成

- 30.1.4 インバウンド・アダプタのプロパティの削除

- 30.1.5 インバウンド・アダプタのプロパティ値を元に戻す

- 30.2 アウトバウンド・アダプタのエンドポイント・プロパティの構成

- 30.2.1 アウトバウンド・アダプタの事前定義されたプロパティの編集

- 30.2.2 アウトバウンド・アダプタの事前定義されたプロパティの追加

- 30.2.3 アウトバウンド・アダプタの新規プロパティの作成

- 30.2.4 アウトバウンド・アダプタのプロパティの削除

- 30.2.5 アウトバウンド・アダプタのプロパティ値を元に戻す

31 Oracle JCAアダプタの監視

- 31.1 インバウンド・アダプタのインスタンスとフォルトの監視

- 31.2 インバウンド・アダプタの最新のフォルトと拒否メッセージの監視

- 31.3 インバウンド・アダプタのフォルトと拒否メッセージの監視

- 31.3.1 インバウンド・アダプタの拒否メッセージの検索

- 31.3.2 インバウンド・アダプタの拒否メッセージの削除

- 31.4 インバウンド・アダプタのプロパティの監視

- 31.5 アウトバウンド・アダプタのインスタンスとフォルトの監視

- 31.6 アウトバウンド・アダプタの最新のフォルトの監視

- 31.7 アウトバウンド・アダプタのフォルトの監視

- 31.7.1 アウトバウンド・アダプタのフォルトの検索

- 31.8 アウトバウンド・アダプタのプロパティの監視

- 31.9 アダプタ・ログの監視

第XII部 Oracle B2BとOracle Healthcareの管理

32 Oracle B2Bの構成

- 32.1 Oracle B2Bサーバーのプロパティの構成

- 32.2 Oracle B2B操作の構成

- 32.3 Oracle B2B属性の構成

- 32.4 Oracle B2Bロギング・モードの構成

33 Oracle B2Bの監視

- 33.1 Oracle B2Bインフラストラクチャの監視

- 33.2 「B2Bインフラストラクチャ」ページからOracle B2Bへのアクセス

- 33.3 Oracle B2Bバインディング・コンポーネントのメッセージ・フローの表示

- 33.4 サービスと参照の表示

- 33.5 Oracle B2Bコンポジットの「フローのトレース」ページからのOracle B2Bレポートへのアクセス

34 Oracle Healthcareの監視

- 34.1 監査証跡の概要

- 34.1.1 Oracle SOA Suite for Healthcare Integrationの監査オプション

- 34.1.2 監査でのフィルタ条件の使用

- 34.2 Healthcare Integration監査証跡の構成

- 34.3 ユーザー監査ログの表示

第XIII部 ビジネス・イベントの管理

35 ビジネス・イベントの管理

- 35.1 イベント配信ネットワークの概要

- 35.2 ビジネス・イベントのサブスクライブ

- 35.3 ビジネス・イベント・サブスクライバの管理

- 35.4 ビジネス・イベントのフォルトのリカバリ

第XIV部 バインディング・コンポーネントの管理

36 サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントの構成

- 36.1 サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントのプロパティの構成

- 36.1.1 Webサービスに対するプロパティの構成

- 36.1.2 Oracle JCAアダプタに対するプロパティの構成

- 36.1.2.1 Oracle AQアダプタ

- 36.1.2.2 Oracleデータベース・アダプタ

- 36.1.2.3 Oracleファイル・アダプタ

- 36.1.2.4 Oracle FTPアダプタ

- 36.1.2.5 Oracle JMSアダプタ

- 36.1.2.6 Oracle MQ Seriesアダプタ

- 36.1.2.7 Oracleソケット・アダプタ

- 36.1.2.8 Oracle JCAアダプタのエンドポイント・プロパティ

- 36.1.3 Oracle Service Registryと統合している場合のエンドポイント参照およびサービス・キーの変更

- 36.1.3.1 WSDL URLのキャッシュの構成

37 サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントの監視

- 37.1 バインディング・コンポーネントのインスタンスとフォルトの監視

- 37.2 バインディング・コンポーネントの拒否メッセージの監視

38 サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントの管理

- 38.1 バインディング・コンポーネントのポリシーの管理

- 38.1.1 ポリシー構成プロパティ値のオーバーライド

- 38.2 UDDIレジストリへのWebサービスの公開

- 38.2.1 UDDIにWebサービスを公開するための環境の構成

- 38.2.2 UDDIレジストリへのWebサービスの公開

第XV部 Oracle BPMNプロセス・サービス・コンポーネントとエンジンの管理

39 Oracle BPMNプロセス・サービス・コンポーネントとエンジンの構成

- 39.1 BPMNプロセス・サービス・エンジン・プロパティの構成

- 39.2 Oracle BPMとOracle Business Activity Monitoringの統合

- 39.2.1 タスク1: Oracle BPMサーバー上でのOracle BAMアダプタの構成

- 39.2.2 タスク2: Oracle BPMサーバー上でのOracle BAMの有効化

40 BPMNプロセスのサービス・コンポーネントとエンジンの監視

- 40.1 BPMNプロセス・サービス・コンポーネントの監査証跡とプロセス・フローの表示

- 40.2 BPMNプロセス・サービス・コンポーネントのインスタンスとフォルトの監視

- 40.3 BPMNプロセス・サービス・コンポーネントのインスタンスの監視

- 40.4 BPMNプロセス・サービス・エンジンのインスタンスとフォルトの監視

- 40.5 BPMNプロセス・サービス・エンジンのリクエスト統計とスレッド・パフォーマンス統計の監視

- 40.6 BPMNプロセス・サービス・エンジンのインスタンスの監視

- 40.7 サービス・エンジンにデプロイされたBPMNプロセスの監視

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

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

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

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

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

第XVI部 付録

A データベースへのデモ・ユーザー・コミュニティのインストール

- A.1 デモ・ユーザー・コミュニティのインストール

- A.2 デモ・コミュニティのユーザー

- A.3 デモ・コミュニティのグループ

- A.4 soa-infraアプリケーション・ロール

- A.5 SOATestDemoAppアプリケーション・ロール

- A.6 ユーザーに付与されているロールおよびユーザーが所有しているロール

- A.7 WorkflowPermissionクラス

B Oracle SOA SuiteとOracle BPM Suiteのトラブルシューティング

- B.1 トラブルシューティングのためのロギング・レベルの設定

- B.1.1 すべての管理対象サーバーからのログ・ファイルおよびスレッド・ダンプ

- B.2 パラレル・パージと表のパーティション化の問題

- B.2.1 パラレル・パージ・スクリプトの実行

- B.2.1.1 並列度値の指定

- B.2.1.2 削除するSOAコンポジット・アプリケーションの解析

- B.2.1.3 パラレル問合せスレーブの使用

- B.2.1.4 パージ操作のデバッグとトレース

- B.2.2 Oracle SOA Suiteの表のパーティション化

- B.2.2.1 参照整合性および同一レベル・パーティション化

- B.2.2.2 SOAコンポジット・アプリケーションのレンジ - ハッシュ・パーティション

- B.2.2.3 時間隔パーティション化

- B.2.2.4 グローバル・ハッシュ索引

- B.2.2.5 パーティション・プルーニング

- B.2.2.6 パーティションのパージ

- B.2.3 監査レベルの低減

- B.2.3.1 本番環境の監査レベルの設定

- B.2.3.2 インスタンス状態のトラッキングの無効化

- B.3 接続およびトランザクション・タイムアウトのトラブルシューティング

- B.3.1 接続タイムアウトの解決

- B.3.2 データベース接続値を増やす

- B.3.3 SOAインフラストラクチャの障害後にデプロイメント・アーカイブのEJBトランザクション・タイムアウト値を更新する

- B.3.4 リモートWebサービスへの長時間実行される同期コールによるエラーの発生または非同期トランザクションの長時間後のエラー・リターン

- B.4 ランタイム診断のトラブルシューティング

- B.4.1 「WSDLを読み取れません」というOracle SOA Suite実行時エラー

- B.4.2 BPELインスタンスの自動リカバリで特定インスタンスがリカバリされない

- B.4.3 障害発生時に一部コンポジットは複数回再試行される

- B.4.4 アプリケーション・トランザクションが完了せず、基になるコンポジットが実行状態でスタックしている

- B.5 ヒューマン・ワークフローのトラブルシューティング

- B.5.1 タスク割当て、ルーティングおよびエスカレーションの問題

- B.5.2 タスク・アクションの問題

- B.5.3 通知の問題

- B.5.4 タスク・ビューの問題

- B.5.5 タスクの属性マッピングの問題

- B.5.6 タスク・レポートの問題

- B.5.7 タスク履歴の問題

- B.5.8 タスク・フォームおよびタスク・アクションの問題

- B.5.9 タスク・コメントと添付ファイルの問題

- B.5.10 実行時のデザインタイムの問題

- B.5.11 ヒューマン・ワークフローAPI (SOAPおよびEJBを含む)の使用の問題

- B.5.12 Oracle JDeveloperのデータ・コントロールとフォームの生成の問題

- B.5.13 ヒューマン・ワークフロー・サービスとシステムMBeanブラウザの問題

- B.5.14 AMX拡張の問題

- B.5.15 Oracle BPM Worklistとタスク領域の問題

- B.5.16 テストから本番への移行の問題

- B.5.17 アイデンティティ・サービスの問題

- B.6 EDNのトラブルシューティング

- B.6.1 EDNイベント・バスと配信のチューニング

- B.6.2 ロールバックされたOne-and-Only-Oneイベント配信メッセージがログ・ファイルに表示される

- B.6.3 イベントが同じコンポジットの複数リビジョンによって使用される

- B.6.4 ビジネス・イベントがSOAサーバーによって2回(以上)取得される

- B.6.5 EDNとコンポジットまたはクラスタ全体のコンポジット間でメッセージが一部失われる

- B.6.6 EDNの全体的なイベント配信を低速化する不良なコンポジットがSOAドメインに存在するかどうかのチェック

- B.7 パフォーマンスのトラブルシューティング

- B.7.1 インスタンスおよびフォルトのメトリックのあるページのロードの最適化

- B.7.2 開いているファイルが多すぎることが原因で発生したメッセージの失敗の解決

- 1B.7.3 ペイロードが大きいことによって発生するMaxMessageSizeExceededExceptionエラーの解決

- B.7.4 表領域の拡張による実行時の問題の回避

- B.7.5 大量のトランザクションによるデータベース増大の問題の解決

- B.7.6 ページ表示やトランザクション終了に長時間かかるといったアプリケーションの低速パフォーマンスの観察

- B.7.7 送信メッセージ速度を超える受信メッセージ速度の観察

- B.8 サーバーのトラブルシューティング

- B.8.1 管理対象サーバーの起動および停止のベスト・プラクティス

- B.8.2 SOAサーバー起動の問題の診断

- B.8.3 プロキシ・サーバーの指定

- B.8.4 一部のローエンドのホストで、フロー・ダイアグラムが初回に表示されない

- B.8.5 IPv4とIPv6をサポートするデュアル・スタック・ホスト上のOracle Enterprise Manager Fusion Middleware Controlへのアクセス

- B.9 ブラウザのトラブルシューティング

- B.9.1 Safariブラウザを使用してWSDLファイルの内容を表示する場合の制限

- B.10 その他のトラブルシューティングのドキュメント

C Oracle Enterprise ManagerのOracle SOA Suiteユーザーのロールおよび権限

- C.1 ロールおよび権限

- C.1.1 全体的なロール機能のマトリックス

- C.1.2 「SOAインフラストラクチャ」ページへのアクセス

- C.1.3 「SOAインフラストラクチャ」メニューへのアクセス

- C.1.4 「SOAコンポジット」メニューへのアクセス

- C.1.5 コンポジットのホーム・ページへのアクセス

- C.1.6 BPELプロセス・サービス・エンジンへのアクセス

- C.1.7 Oracle Mediatorサービス・エンジンへのアクセス

- C.1.8 ヒューマン・ワークフロー・サービス・エンジンへのアクセス

- C.1.9 ビジネス・ルール・サービス・エンジンへのアクセス

- C.1.10 BPELプロセス・サービス・コンポーネントのホーム・ページへのアクセス

- C.1.11 Oracle Mediatorサービス・コンポーネントのホーム・ページへのアクセス

- C.1.12 ヒューマン・タスク・サービス・コンポーネントのホーム・ページへのアクセス

- C.1.13 デシジョン・サービス・コンポーネントのホーム・ページへのアクセス

- C.1.14 「フローのトレース」ページへのアクセス

- C.1.15 監査証跡へのアクセス

- C.1.16 「サービス・ホーム」ページへのアクセス

- C.1.17 「参照ホーム」ページへのアクセス

- C.1.18 Oracle B2Bのページへのアクセス

- C.1.19 「ビジネス・イベント」ページへのアクセス

- C.1.20 システムMBeanブラウザへのアクセス

索引

はじめに

『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』では、Oracle SOA SuiteおよびOracle Business Process Management Suiteの次のコンポーネントを管理する方法を説明します。

- SOAインフラストラクチャおよびSOAコンポジット・アプリケーション

- コンポジット・コンポーネントおよびサービス・エンジン(BPELサービス・エンジン、BPMNプロセス・サービス・エンジン、Oracle Mediatorサービス・エンジン、ヒューマン・ワークフロー・サービス・エンジン、ビジネス・ルール・サービス・エンジンなど)

- Oracle B2B、Oracle Adapters、Oracle Business Activity MonitoringおよびOracle User Messaging Service

対象読者

このドキュメントは、SOAプラットフォームでアプリケーションを管理する管理者を対象としています。

ドキュメントのアクセシビリティについて

オラクル社のアクセシビリティへの取組みの詳細は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

Oracleのお客様は、My Oracle Supportにアクセスして電子サポートを受けることができます。詳細は、http://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoまたはhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs (聴覚障害者向け)を参照してください。

関連ドキュメント

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

- 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』

- 『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』

- Oracle Fusion Middleware Oracle SOA Suite Healthcare Integrationユーザーズ・ガイド

- 『Oracle Fusion Middleware Oracle Business Activity Monitoringユーザーズ・ガイド』

- 『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』

- 『Oracle Fusion Middleware Oracle Business Rulesユーザーズ・ガイド』

- 『Oracle Fusion Middleware Oracle Business Rulesランゲージ・リファレンス・ガイド』

- 『Oracle Fusion Middleware Oracle Business Process Managementモデリングおよび実装ガイド』

- 『Oracle Fusion Middleware Oracle Business Process Managementユーザーズ・ガイド』

- 『Oracle Fusion Middleware Oracle Business Process Management Business Process Composerユーザーズ・ガイド』

- 『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』

- Oracle Fusion Middleware Oracle SOA Suiteエンタープライズ・デプロイメント・ガイド

- 『Oracle Fusion Middleware高可用性ガイド』

- Oracle Fusion Middleware WebLogic Scripting Toolのコマンド・リファレンス

表記規則

このドキュメントでは、次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するグラフィカル・ユーザー・インタフェース要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

このガイドで説明する新機能

このガイドは、いくつかの点が更新されています。次の表に、追加または変更された部分をリストします。

既知の問題のリスト(リリース・ノート)は、"Known Issues for Oracle SOA Products and Oracle AIA Foundation Pack"(http://www.oracle.com/technetwork/middleware/docs/soa-aiafp-knownissuesindex-364630.html)を参照してください。

項

変更内容

2013年2月

2013年5月

2013年8月

2013年9月

2013年10月

第2章「Oracle SOA SuiteおよびOracle BPM Suiteの管理のスタート・ガイド」

第2.2.1項「SOAインフラストラクチャのホーム・ページおよびメニューからの移動」および 第2.2.2項「SOAコンポジット・アプリケーションのホーム・ページおよびメニューからの移動」

これらの項は、「SOAインフラストラクチャ」メニューおよび「SOAコンポジット」メニューの「ホーム」オプションの説明が改訂され、それぞれSOAインフラストラクチャおよびSOAコンポジット・アプリケーションのホーム・ページの選択したタブに直接移動できるようになりました。

X

第3章 SOAインフラストラクチャの構成

第3.1項「SOAインフラストラクチャ・プロパティの構成」

この項は、システムMBeanブラウザのAuditConfigプロパティのbpelRecoveryAlertDurationInDaysキーの説明が改訂されています。このキーは、「必須のBPELメッセージ・リカバリ」インライン警告メッセージがリカバリ可能BPELメッセージが最近7日間以内に作成されている場合にのみ表示されるように制限します。7日間のデフォルト設定は変更可能です。

X

第3.4.2項「Oracle Enterprise Manager Fusion Middleware Controlページのパフォーマンス問題を診断するロギングの構成」

作成されたOracle Enterprise Manager Fusion Middleware Controlページに対する高コストのAPIコールのパフォーマンスをトレースする方法を説明する項が追加されています。

X

第3.8項「複数のSOAコンポジット・アプリケーションのグローバル・トークン変数の管理」

Oracle Enterprise Manager Fusion Middleware ControlのSOAコンポジット・アプリケーションの特定のURIに対するグローバル・トークン変数の定義方法を説明する項が追加されています。これにより、各構成プランにおける値の置換の代替方法が提供されます。

X

第4章 SOAインフラストラクチャの監視

第4.1項「Oracle SOA Suiteルーティング・トポロジの検出」

トポロジ・ビューアを使用してコンポーネントと要素間のルーティング関係を表示する方法を説明する項が追加されています。

X

第4.2項「SOAインフラストラクチャのパフォーマンス・サマリー・メトリックの監視」

「パフォーマンス・サマリー」ページのSOAインフラストラクチャのパフォーマンス・メトリックのサマリーを表示する方法を説明する項が追加されています。

X

第5章 SOAコンポジット・アプリケーションの保護

第5.2項「Oracle WebLogic ServerグループまたはユーザーへのSOAOperatorおよびSOAMonitorロールのマッピング」

Oracle Enterprise Manager Fusion Middleware ControlでOracle WebLogic ServerグループまたはユーザーにSOAMonitorおよびSOAOperatorロールをマップする方法を説明する項が追加されています。

X

第6章 SOAコンポジット・アプリケーションの監視

第6.1項「SOAコンポジット・アプリケーションのパフォーマンス・サマリー・メトリックの監視」

「パフォーマンス・サマリー」ページのSOAコンポジット・アプリケーションのパフォーマンス・メトリックのサマリーを表示する方法を説明する項が追加されています。

X

第7章 SOAコンポジット・アプリケーションのデプロイおよび管理

第7.2項「アンデプロイメントまたは再デプロイメント時のインスタンス、フォルトおよび拒否メッセージの失効状態への更新」

アンデプロイメントおよび再デプロイメント時に、インスタンス、フォルトおよび拒否メッセージを失効としてマークする方法を説明する項が追加されています。

X

第8章 SOAコンポジット・アプリケーション・インスタンスの管理

第8.3項「SOAインフラストラクチャ・レベルでの、SOAコンポジット・アプリケーション・インスタンスの監視と削除」

この項では、SOAインフラストラクチャのすべてのSOAコンポジット・アプリケーションのインスタンスのコンポジット・センサーを検索する機能の説明が改訂されています。

X

第8.2項「アプリケーションのホーム・ページからの、SOAコンポジット・アプリケーション・インスタンスの監視と削除」から第8.5項「アプリケーションのホーム・ページでの、SOAコンポジット・アプリケーションのフォルトのリカバリ」まで

これらの項は改訂され、SOAインフラストラクチャおよびSOAコンポジット・アプリケーションのインスタンス・ページとフォルトおよび拒否メッセージのページへの初回アクセス時に、デフォルトではインスタンスとフォルトが表示されないことが示されています。インスタンスおよびフォルトを表示するには、「検索」をクリックする必要があります。

X

第8.8項「複数のSOAコンポジット・アプリケーション・リビジョン間でのインスタンスの移行」

リビジョン間で稼働中のSOAコンポジット・アプリケーション・インスタンスを移行する方法(たとえばCreditRatingService 1.0からCreditRatingService 2.0へのインスタンスの移行)を説明する項が追加されています。

X

第9章 データベース増分管理戦略の策定

X

第9章「データベース増分管理戦略の策定」

データベースのプロファイルまたはサイズの決定、領域使用量、ハードウェア・リソースおよびデータベース・パフォーマンスの監視、増分管理の課題およびテスト戦略について、および領域管理についてなど、データベース増分管理の戦略を説明する章が追加されています。

X

第10章 データベース増分の管理

第10.1項「データベース増分の管理の概要」

データベースの増分管理方法を説明する表が追加されています。

X

第10.3.1項「ループしたパージ・スクリプト」

この項は、ignore_stateパラメータの説明で更新されています。trueに設定すると、指定された日付範囲内でオープンまたはクローズされたすべてのインスタンスがパージされます。

X

第10.5項「表削除なしでの実行時表からのレコードの削除」

すべてのOracle SOA Suite表から表を削除しないですべてのレコードを削除する切捨てスクリプトの使用方法を説明する項が追加されています。

X

第10.6項「オープン・コンポジット・インスタンスでの表の再作成およびデータベース領域の再利用」

オープン・コンポジット・フローを保持しながら、表再作成スクリプト(TRS)を使用してOracle SOA Suiteの表を再作成し、データベース・セグメント(表と索引)を縮小または再構築することなく、ただちに領域を再使用する方法を説明する項が追加されています。

X

第10.7項「Microsoft SQL Serverでのインスタンスのパージ」

Microsoft SQL Serverでデータベース・インスタンスをパージする方法を説明する項が追加されています。

X

第10.7.3項「Microsoft SQL Server上でのパージ・スクリプトの実行」

この項は更新され、Microsoft SQL Serverでパージ・スクリプトを実行する際にサポートされる言語が英語のみであることが示されています。

X

第11章 Facade APIを使用したSOAコンポジット・アプリケーションのプログラムによる管理

第11.1.1項「locatorオブジェクト作成時に必要なセキュリティ資格証明」

locatorオブジェクトの作成で追加のセキュリティ資格情報がどのように要求されるかを説明する項が追加されています。

X

第12章 SOAコンポジット・アプリケーションに関する問題の診断

第12.1.3項「事前定義のインシデント処理ルール」

この項は改定され、サーバーを再起動せずにルール・ファイルをSOAインフラストラクチャに動的にロードする方法、および診断フレームワークかSOAサーバーのホーム・ディレクトリのいずれかを使用してインシデント処理ルール・ファイルを構成する方法が説明されています。

X

第12.5.1項「事前構成済ルールおよび監視の有効化」

OWS-04086エラーが原因で、多数のインシデントが生成される問題が発生する場合に、パッチ番号2248452についてOracleサポート・サービスに連絡することを示す、注意が追加されています。

X

第12.2.4項「デプロイ済コンポジット・メタデータの診断ダンプ(soa.composite)」

この項は改訂され、実行コンテキストID (ECID)と関連付けられたSOAコンポジット・アプリケーションを照合するecidダンプ・パラメータが説明されています。

X

第12.2.5項「インスタンス監査証跡の診断ダンプ(soa.composite.trail)」

この項は改訂され、ダンプがECIDと関連付けられた最上位レベルの監査証跡、およびコンポジット・インスタンスとサービス・コンポーネント・インスタンスのレベルでの監査証跡をどのように取得するかが説明されています。すべて、コンポジット・インスタンスまたはサービス・コンポーネント・インスタンスごとに1つのファイルに書き込まれます。

X

第12.2.8項「ディスパッチャの静的構成の診断ダンプ(bpel.dispatcher)」、第12.2.9項「平均インスタンス処理時間の診断ダンプ(bpel.apt)」、第12.2.10項「平均インスタンス処理遅延の診断ダンプ(bpel.apd)」、第12.2.11項「同期プロセス統計の診断ダンプ(bpel.sps)」、第12.2.12項「非同期プロセス統計の診断ダンプ(bpel.aps)」および第12.2.13項「リクエスト統計の診断ダンプ(bpel.rs)」

次に関するBPELプロセス診断ダンプを実行する方法を説明する項が追加されています。

- 静的(システム、起動、エンジンおよび監査スレッド件数)および実行時にスケジュールされたワーキング・メッセージ件数に関するディスパッチャ構成情報

- インスタンスの平均処理時間情報

- インスタンスの平均処理遅延情報(非同期プロセス)

- 最小、最大、平均処理時間情報(ミリ秒)および処理されたインスタンスの件数(同期プロセス)

- 最小、最大、平均処理時間情報(ミリ秒)および処理されたインスタンスの件数(非同期プロセス)

- 最小、最大、平均処理時間情報(ミリ秒)およびBPELプロセス・サービス・エンジンの各レイヤーを通過するリクエスト・フローとして処理されたリクエストの件数

X

第12.2.14項「リシーケンサ・グループ処理遅延の診断ダンプ(mediator.resequencer)」

この項は、一定期間保留中のリシーケンサ・グループに関するメディエータ診断情報検索についての情報が追加されています。

X

第12.2.15項「アダプタ診断ダンプ(soa.adapter.ra)」、第12.2.16項「アダプタ診断ダンプ(soa.adapter.connpool)」および第12.2.17項「アダプタ診断ダンプ(soa.adapter.stats)」

次に関するアダプタ診断ダンプを実行する方法を説明する項が追加されています。

- 接続ファクトリ構成情報

- アダプタ接続プール情報

- メッセージ・サイズ、フォルト件数などのダイナミック・モニタリング・サービス(DMS)統計

X

第12.3項「SOAコンポジット・アプリケーションの診断フレームワーク・スレッド・ダンプの実行」

SOAコンポジット・アプリケーションの診断フレームワーク・スレッド・ダンプを実行する方法を説明する項が追加されています。

X

第12.5.1項「事前構成済ルールおよび監視の有効化」

sca_createWatches WLSTコマンドを使用して、事前構成されたルールと監視を有効にする方法を説明する項が追加されています。

X

第12.5.3項「Webサービス・バインディング・コールの経過時間を識別する監視の作成」

コンポジットから外部参照へのWebサービス・バインディング・コールの完了に要した時間を追跡する監視を手動で作成する方法を説明する項が追加されています。

X

第12.5.4項「処理遅延が指定の制限時間を超えているかどうかを識別する監視の作成」

件数またはメッセージ待機時間、あるいは処理遅延が一定の限度を超過した場合にアラートを実行する監視を作成する方法を説明する項が追加されています。

X

第12.5.5項「リシーケンサの監視および通知の作成」

リシーケンサ・グループがメッセージの処理に要した時間を追跡する監視を作成する方法を説明する項が追加されています。

X

第14章 BPELプロセスのサービス・コンポーネントとエンジンの監視

第14.3項「BPELプロセス・サービス・コンポーネントのインスタンスの監視」および第14.7項「BPELプロセス・サービス・エンジンのインスタンスの監視」

これらの項は改訂され、BPELプロセス・サービス・コンポーネント、およびBPELプロセス・サービス・エンジンのインスタンス・ページへの初回アクセス時に、デフォルトではインスタンスが表示されないことが示されています。インスタンスを表示するには、「検索」をクリックする必要があります。

X

第14.6.1項「「リクエストのブレークダウン」表の下位レベルの詳細の表示」および第14.9項「BPELプロセス・サービス・エンジンでのリクエストの所要時間に関する統計の表示」

処理時に様々なサービス・エンジン・レイヤーでリクエストが消費した時間に関する下位レベルの詳細を表示するように、統計ページの「リクエストのブレークダウン」部分を構成する方法を説明する項が追加されています。

X

第15章 BPELプロセスのサービス・コンポーネントとエンジンの管理

第15.1項「BPELプロセス・サービス・コンポーネントのフォルトのリカバリ」および第15.3項「BPELプロセス・サービス・エンジンのフォルトのリカバリ」

これらの項は改訂され、BPELプロセス・サービス・コンポーネント、およびBPELプロセス・サービス・エンジンのフォルト・ページへの初回アクセス時に、デフォルトではフォルトが表示されないことが示されています。フォルトを表示するには、「検索」をクリックする必要があります。

X

第15.4項「BPELプロセス・サービス・エンジンのメッセージ・リカバリの実行」

この項は改訂され、BPELプロセス・サービス・エンジンの「リカバリ」ページの次のオプションが説明されています。

- 「中断」オプションを使用すると、ECIDのコンテキストのコンポジット・インスタンス・フロー全体を強制終了できます。フローに関連付けられているコンポジット・インスタンスおよびコンポーネント・インスタンスのすべてが強制終了されます。

- 「中断せずに取消」オプションを使用すると、メッセージが含まれるコンポジット・インスタンス・フロー全体ではなく、選択したBPELプロセス・メッセージの配信を取り消すことができます。

X

第15.5項「Oracle Exalogicプラットフォームにおけるインスタンスとメッセージ・データのOracle Coherence分散キャッシュへの格納」

これらの項は改訂され、監査証跡および起動メッセージの記憶域をOracle Coherenceキャッシュに構成するプロパティが説明されています。

X

第17章 Oracle Mediatorのサービス・コンポーネントとエンジンの監視

第17.2.2項「Oracle Mediatorサービス・コンポーネント・インスタンスの監視」および第17.3.2項「Oracle Mediatorサービス・エンジン・インスタンスの監視」

これらの項は改訂され、Oracle Mediatorサービス・コンポーネントおよびOracle Mediatorサービス・エンジンへの初回アクセス時に、デフォルトではインスタンスが表示されないことが示されています。フォルトを表示するには、「検索」をクリックする必要があります。

X

第17.4.1.4項「「メディエータ・リシーケンス・グループ」ダイアログ」

この項は改訂され、標準リシーケンサ・グルの新しいスキップ機能に関する情報が組み込まれています。このオプションを使用すると、シーケンス内の次のIDをスキップして、処理を促進できます。

X

第18章 Oracle Mediatorのサービス・コンポーネントとエンジンの管理

第18.1項「Oracle Mediatorサービス・コンポーネントのフォルトのリカバリ」および第18.3項「Oracle Mediatorサービス・エンジンのフォルトのリカバリ」

これらの項は改訂され、Oracle Mediatorサービス・コンポーネントおよびOracle Mediatorサービス・エンジンの「フォルト」ページへの初回アクセス時に、デフォルトではフォルトが表示されないことが示されています。フォルトを表示するには、「検索」をクリックする必要があります。

X

第20章 Oracle Mediatorのサービス・コンポーネントとエンジンの管理

第20.3項「ビジネス・ルール・サービス・エンジンのインスタンスの監視」および第20.4項「ビジネス・ルール・サービス・エンジンのフォルトの監視」

これらの項は改訂され、ビジネス・ルール・サービス・エンジンの「インスタンス」ページと「フォルト」ページそれぞれへの初回アクセス時に、デフォルトではインスタンスとフォルトが表示されないことが示されています。フォルトを表示するには、「検索」をクリックする必要があります。

X

第22章 ヒューマン・ワークフローのサービス・コンポーネントとエンジンの監視

第22.3項「ヒューマン・タスク・サービス・コンポーネントのインスタンスの監視」および第22.6項「ヒューマン・ワークフロー・サービス・エンジンのインスタンスの監視」

これらの項は改訂され、ヒューマン・タスク・プロセス・サービス・コンポーネント、およびヒューマン・ワークフロー・サービス・エンジンの「インスタンス」ページへの初回アクセス時に、デフォルトではインスタンスが表示されないことが示されています。インスタンスを表示するには、「検索」をクリックする必要があります。

X

第23章 ヒューマン・ワークフローのサービス・コンポーネントとエンジンの管理

第23.2項「ヒューマン・ワークフロー・サービス・エンジンのフォルトのリカバリ」および第23.4項「ヒューマン・タスク・サービス・コンポーネントのフォルトのリカバリ」

これらの項は改訂され、ヒューマン・ワークフロー・サービス・エンジン、およびヒューマン・タスク・プロセス・サービス・コンポーネントの「フォルト」ページへの初回アクセス時に、デフォルトではフォルトが表示されないことが示されています。フォルトを表示するには、「検索」をクリックする必要があります。

X

第36章 サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントの構成

第36.1.2.6項「Oracle MQ Seriesアダプタ」

MQ Seriesアダプタでサービス・バインディング・コンポーネント用のキュー内のメッセージの参照がサポートされないことを示す注意が追加されています。

X

第39章 ヒューマン・ワークフローのサービス・コンポーネントとエンジンの監視

第40.3項「BPMNプロセス・サービス・コンポーネントのインスタンスの監視」および第40.6項「BPMNプロセス・サービス・エンジンのインスタンスの監視」

これらの項は改訂され、BPMNプロセス・サービス・コンポーネント、およびBPMNプロセス・サービス・エンジンの「インスタンス」ページへの初回アクセス時に、デフォルトではインスタンスが表示されないことが示されています。インスタンスを表示するには、「検索」をクリックする必要があります。

X

第40章 ヒューマン・ワークフローのサービス・コンポーネントとエンジンの管理

第41.1項「BPMNプロセス・サービス・コンポーネントのフォルトのリカバリ」および第41.3項「BPMNプロセス・サービス・エンジンのフォルトのリカバリ」

これらの項は改訂され、BPMNプロセス・サービス・コンポーネント、およびBPMNプロセス・サービス・エンジンの「フォルト」ページへの初回アクセス時に、デフォルトではフォルトが表示されないことが示されています。フォルトを表示するには、「検索」をクリックする必要があります。

X

付録A データベースへのデモ・ユーザー・コミュニティのインストール

付録A「データベースへのデモ・ユーザー・コミュニティのインストール」

この項は改訂され、データベースでのデモ・ユーザー・コミュニティのインストール手順が組み込まれています。以前は、Oracle SOA Suiteサンプルサイトで提供されるworkflow-001-DemoCommunitySeedAppサンプルの一部として含まれるREADME.txtファイルのみにこれらの手順が記載されていました。

X

付録C Oracle Enterprise ManagerのOracle SOA Suiteユーザーのロールおよび権限

C.1項「ロールおよび権限」

この項は改定され、Oracle Enterprise Manager Fusion Middleware Controlで実行可能なアクションはOracle WebLogic Serverエンタープライズ・ロール(モニター、オペレータおよび管理者)を使用して保護されることが示されています。Oracle Enterprise Manager Fusion Middleware Controlが適切に動作するためには、SOAアプリケーション・ロールにユーザー・ロールかエンタープライズ・ロールのいずれかを正しくマップする必要があります。

X

付録C「Oracle Enterprise ManagerのOracle SOA Suiteユーザーのロールおよび権限」

付録の表ヘッダーは改訂され、Oracle WebLogic Serverエンタープライズ・ロールとOracle SOA Suiteアプリケーション・ロールの間に必要なマッピングが示されています。

X

第I部

Oracle SOA SuiteおよびOracle Business Process Management Suiteの概要

この部では、Oracle SOA SuiteとOracle Business Process Management Suiteについて説明します。

次の章で構成されています。

- 第1章「概要と概念」

1 概要と概念

この章では、Oracle Fusion Middleware、Oracle Service-Oriented Architecture (SOA) SuiteおよびOracle Business Process Management (BPM) Suiteについて説明し、Oracle Enterprise Manager Fusion Middleware Controlから実行するOracle SOA SuiteとBPM Suiteの管理タスクのタイプについて説明します。Oracle Enterprise Manager 11g Grid ControlおよびOracle SOA Management Packも概略が説明されています。

この章では、次の項目について説明します。

- 第1.1項「Oracle Fusion Middlewareの概要」

- 第1.2項「Oracle SOA Suiteの概要」

- 第1.3項「Oracle Business Process Management Suiteの概要」

- 第1.4項「Oracle SOA SuiteおよびOracle BPM Suiteの管理」

- 第1.5項「アプリケーション開発者による管理」

- 第1.6項「Oracle Enterprise Manager 11g Grid ControlおよびOracle SOA Management Packによる管理」

Oracle Enterprise Manager Fusion Middleware Controlの管理タスクおよびOracle Fusion Middlewareの概要は、次のドキュメントを参照してください。

- 『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』

- 『Oracle Fusion Middleware管理者ガイド』

- 『Oracle Fusion Middleware 2日で管理者ガイド』

- 『Oracle Fusion Middleware概要』

1.1 Oracle Fusion Middlewareの概要

Oracle Fusion Middlewareは、標準ベースのソフトウェア製品群であり、Java EE、開発ツール、統合サービス、ビジネス・インテリジェンス、コラボレーションなど、様々なツールとサービスを提供します。また、アプリケーションの開発、デプロイメントおよび管理を完全にサポートします。

1.2 Oracle SOA Suiteの概要

Oracle SOA Suiteは、Oracle Fusion Middlewareのミドルウェア・コンポーネントの1つです。SOAコンポジット・アプリケーションの設計、デプロイおよび管理に対応するサービス・インフラストラクチャ・コンポーネントの完全なセットを提供します。Oracle SOA Suiteを使用すると、サービスを作成して管理し、SOAコンポジット・アプリケーションに組み込むことができます。コンポジットによって、複数のテクノロジ・コンポーネントを組み合せて1つのSOAコンポジット・アプリケーションを作成できます。Oracle SOA Suiteは、異種ITインフラストラクチャへの接続を行い、企業がSOAを段階的に採用できるようにします。

Oracle SOA Suiteは、Oracle Enterprise Manager Fusion Middleware Controlから管理できます。次の各項で、Oracle SOA Suiteのコンポーネントの概要を示します。

- 第1.2.1項「SOAインフラストラクチャ・アプリケーションの概要」

- 第1.2.2項「SOAコンポジット・アプリケーションの概要」

- 第1.2.3項「SOAコンポジット・アプリケーション・インスタンスの概要」

- 第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」

- 第1.2.5項「バインディング・コンポーネントの概要」

- 第1.2.6項「サービス・エンジンの概要」

- 第1.2.7項「サービス・インフラストラクチャの概要」

- 第1.2.8項「SOAコンポジット・アプリケーションのコンテンツの概要」

Oracle SOA Suiteの概要は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

1.2.1 SOAインフラストラクチャ・アプリケーションの概要

SOAインフラストラクチャは、Oracle WebLogic Serverで実行されるJava EE準拠のアプリケーションです。アプリケーションでは、コンポジットとそのライフサイクル、サービス・エンジンおよびバインディング・コンポーネントが管理されます。

Oracle JDeveloperで設計したSOAコンポジット・アプリケーションをSOAインフラストラクチャ上の選択したパーティションにデプロイします。パーティションはSOAインフラストラクチャの個別のセクションであり、管理を簡単にするためにコンポジット・アプリケーションを論理的にグループ化できます。

図1-1に示した例では、多数のSOAコンポジット・アプリケーションがSOAインフラストラクチャにデプロイされ、Oracle Enterprise Manager Fusion Middleware Controlに表示されています。

SOAインフラストラクチャのホーム・ページからは、SOAコンポジット・アプリケーションの監視、個々のコンポジット・インスタンスの監視、SOAコンポジット・アプリケーションおよび個々のコンポジット・インスタンスの状態の更新などの管理タスクを実行できます。フォルト・リカバリなどの修正処理も実行できます。

図1-1 SOAインフラストラクチャにデプロイされたSOAコンポジット・アプリケーション

「コンポジット」表の特定のSOAコンポジット・アプリケーションをクリックすると、そのホーム・ページにアクセスできます。図1-2に、SOAコンポジット・アプリケーションのホーム・ページの上部を示します。SOAコンポジット・アプリケーションのホーム・ページからは、インスタンスの監視、フォルトのリカバリ、アプリケーション・インスタンスの状態の管理、ポリシーのアタッチなどの管理タスクを実行できます。また、SOAコンポジット・アプリケーション・レベルで、コンポジット監査レベルやペイロード検証の指定など、一定数の構成タスクを実行することもできます。これらのタスクは、ページの上部にボタンとして表示されます。

図1-2 SOAコンポジット・アプリケーションのホーム・ページ(上部)

メッセージがリカバリを待っている場合は、ダッシュボード・ページの最上部およびその他のSOAコンポジット・アプリケーションのホーム・ページに、「必須のBPELメッセージ・リカバリ」メッセージが表示されます。

図1-3に、このSOAコンポジット・アプリケーションのホーム・ページの下部を示します。コンポジットに組み込まれているサービス・コンポーネント、およびサービス・バインディング・コンポーネントと参照バインディング・コンポーネントが表示されます。

図1-3 SOAコンポジット・アプリケーションのホーム・ページ(下部)

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

- 第1.2.2項「SOAコンポジット・アプリケーションの概要」

- 第III部「SOAインフラストラクチャの管理」

- 第6.2項「SOAコンポジット・アプリケーションの最新のインスタンスとフォルトおよび拒否メッセージの監視」

1.2.2 SOAコンポジット・アプリケーションの概要

図1-1の「デプロイ済コンポジット」ページに示されているようなSOAコンポジット・アプリケーションは、次のコンポーネントで構成されます。

- サービス・コンポーネント。ルーティングのためのOracle Mediator、オーケストレーションのためのBPELプロセス、オーケストレーションのためのBPMNプロセス(Oracle BPM Suiteがインストールされている場合)、ワークフロー承認のためのヒューマン・タスク、SOAコンポジット・アプリケーションにJavaインタフェースを統合するためのSpring、ビジネス・ルールを使用するためのデシジョン・サービスなどがあります。

- 外部のサービス、アプリケーションおよびテクノロジに対してSOAコンポジット・アプリケーションを接続するバインディング・コンポーネント(サービスと参照)

これらのコンポーネントが、1つのSOAコンポジット・アプリケーションに組み込まれています。コンポーネントを単一のデプロイメント単位(アプリケーション)に組み込むことで、SOAアプリケーションの管理とライフサイクルが大幅に簡素化されます。

図1-4に、Oracle JDeveloperのSOAコンポジット・エディタに表示されたSOAコンポジット・アプリケーションの例を示します。サービス・バインディング・コンポーネント(orderprocessor_client_epなど)によって、その機能が外部コンシューマに通知されます。サービスは、BPELプロセス、Oracle Mediator、ヒューマン・タスクおよびデシジョン・サービスの各コンポーネントで構成されるSOAコンポジット・アプリケーション(OrderBookingComposite)のパブリック・インタフェースを公開します。サービスは、ワイヤでコンポジット内の特定のコンポーネントまたは参照に接続されます。参照バインディング・コンポーネント(CreditCardAuthorizationServiceやPartnerSupplierServiceなど)を使用すると、SOAコンポジット・アプリケーションから外部サービスにメッセージを送信できます。サービス・バインディング・コンポーネント、サービス・コンポーネントおよび参照バインディング・コンポーネントは、通信するために連結(接続)されます。

図1-4 SOAコンポジット・アプリケーション

SOAコンポジット・アプリケーションに組み込まれているサービス・コンポーネントとバインディング・コンポーネントは、図1-3および図1-5に示すように、アプリケーションのホーム・ページの下部に表示されます。図1-5の例は、「コンポーネント・メトリック」セクションの3つのBPELプロセス・サービス・コンポーネントと、「サービスと参照」セクションの1つのバインディング・コンポーネントを示しています。特定のサービス・コンポーネントまたはバインディング・コンポーネントをクリックすると、そのホーム・ページにアクセスできます。

図1-5 SOAコンポジット・アプリケーションのサービス・コンポーネントおよびバインディング・コンポーネント

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

- 第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」

- 第1.2.5項「バインディング・コンポーネントの概要」

- 第IV部「SOAコンポジット・アプリケーションの管理」

- 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』

1.2.3 SOAコンポジット・アプリケーション・インスタンスの概要

SOAコンポジット・アプリケーションを起動すると、新規コンポジット・インスタンスが作成されます。このインスタンスは、一意のインスタンスIDで識別されます。このIDは、Oracle Enterprise Manager Fusion Middleware Controlの各ページに表示されます。たとえば、図1-6では、SOAインフラストラクチャの「インスタンス」ページに、SOAコンポジット・アプリケーション用のインスタンスIDが表示されています。このページに初めてアクセスしたときに、インスタンスは表示されません。インスタンスを表示するには、まず「検索」をクリックする必要があります。これらのIDをクリックすると、SOAコンポジット・アプリケーション・インスタンスの状態に関するより具体的な詳細にアクセスできます。「インスタンス」ページから、SOAコンポジット・アプリケーション・インスタンスの状態を監視することもできます。

SOAコンポジットの「テスト実行」ページからユニット・テストとして作成したインスタンスは、「Webサービスのテスト」ページから自動的にまたは手動で作成されたインスタンスとは小さい黄色のボックスで区別されます。このボックスは、インスタンスIDの左側に表示されます。このボックスは、SOAインフラストラクチャおよびSOAコンポジット・アプリケーションの「インスタンス」ページおよび「ダッシュボード」ページの「最新のインスタンス」表の両方に表示されます。

一部のSOAコンポジット・アプリケーションに対しては、対話IDも生成されます。対話IDは、生成された一連のインスタンスを明確に識別する別の方法を提供します。図1-6に示すように、対話IDはすべてのインスタンスに対して自動的に表示されるわけではありません。生成された対話IDを参照するには、次のいずれかのタスクを実行します。

- プログラムでサービスを起動し、WS-Addressingヘッダー(messageId)を介して一意のIDを渡します。

- 「Webサービスのテスト」ページを使用してインスタンスを作成します。ただし、「Webサービスのテスト」ページの「追加テスト・オプション」セクションにある「ストレス・テストの有効化」チェック・ボックスが選択されている場合を除きます。この場合、インスタンスの対話IDは作成されません。

図1-6 SOAコンポジット・アプリケーション・インスタンスID

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

- 第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」

- 第IV部「SOAコンポジット・アプリケーションの管理」

- 第8.1項「SOAコンポジット・アプリケーションのテスト・インスタンスの起動」

1.2.4 サービス・コンポーネントとサービス・コンポーネント・インスタンスの概要

SOAコンポジット・アプリケーションには、複数のサービス・コンポーネントが含まれています。サービス・コンポーネントは、SOAコンポジット・アプリケーションの基礎単位です。サービス・コンポーネントによって、SOAコンポジット・アプリケーションの全体的なビジネス・ロジックの一部が実装されます。

SOAコンポジット・アプリケーションで使用できるサービス・コンポーネントは、次のとおりです。

- BPELプロセス: 同期プロセスと非同期プロセスのオーケストレーションに使用します。

- BPMNプロセス(Oracle BPM Suiteがインストールされている場合): Business Process Management Notation and Modeling (BPMN)を使用したビジネス・プロセスの作成およびモデリングに使用します。

- Oracle Mediator: サービスの生産者とコンシューマ間のコンテンツ変換およびイベント(メッセージ)のルーティングに使用します。

- ヒューマン・タスク: ユーザーまたはグループが、エンドツーエンドのビジネス・プロセス・フローの一環として実行するタスクを記述するヒューマン・タスク(例: 手動による注文の承認)のモデリングのために使用します。

- Spring: SOAコンポジット・アプリケーションへのJavaインタフェースの統合に使用します。

- デシジョン・サービス: 意思決定またはビジネス・ルールに基づく処理に使用します。

Oracle Enterprise Manager Fusion Middleware Controlのサービス・コンポーネントのホーム・ページからは、インスタンスの監視、フォルトのリカバリ、ポリシーのアタッチなどの管理タスクを実行できます。

第1.2.3項「SOAコンポジット・アプリケーション・インスタンスの概要」で説明したように、各アプリケーション・インスタンスには独自のインスタンスIDがあります。SOAコンポジット・アプリケーション・インスタンスに組み込まれている各サービス・コンポーネント・インスタンスにも独自のインスタンスIDがあり、Oracle Enterprise Manager Fusion Middleware Controlに表示されます。図1-7は、SOAコンポジット・アプリケーションのLoanBroker BPELプロセス・サービス・コンポーネントの「インスタンスID」列に表示されるインスタンスIDを示しています。「インスタンス」ページから、そのサービス・コンポーネント・インスタンスの状態を監視できます。このインスタンスをクリックすると、サービス・コンポーネントに関するより具体的な詳細にアクセスすることもできます。

図1-7 サービス・コンポーネント・インスタンスID

サービス・コンポーネントの管理の詳細は、次の各項を参照してください。

- 第V部「BPELプロセスのサービス・コンポーネントとエンジンの管理」

- 第VI部「Oracle Mediatorのサービス・コンポーネントとエンジンの管理」

- 第VII部「デシジョン・サービス・コンポーネントとビジネス・ルール・サービス・エンジンの管理」

- 第VIII部「ヒューマン・タスク・サービス・コンポーネントとヒューマン・ワークフロー・サービス・エンジンの管理」

- 第XV部「Oracle BPMNプロセス・サービス・コンポーネントとエンジンの管理」

1.2.4.1 Springサービス・コンポーネントのサポート

Oracle SOA SuiteはSpringサービス・コンポーネントをサポートするようになりました。Oracle Enterprise Manager Fusion Middleware ControlでのSpringのサポートについては、次の詳細を確認してください。

- Springサービス・エンジン管理ページはありません。

- Springコンポーネントはフローのトレースに表示されますが、監査証跡はありません。

- Springコンポジット・メトリックはコンポジット・アプリケーションのホーム・ページ(たとえば、「ダッシュボード」ページの「コンポーネント・メトリック」セクション)に表示されます。

- Springサービス・コンポーネントは、実行中および終了したインスタンスの状態はサポートしません。Springサービス・コンポーネントは同期する設計であるため、同期している実行中のインスタンスを終了することはサポートされません。このため、実行中のインスタンスは中断できず、また、Springサービス・コンポーネントで終了した状態を保持できません。

1.2.5 バインディング・コンポーネントの概要

SOAコンポジット・アプリケーションは、バインディング・コンポーネントによって、外部のサービス、アプリケーションおよびテクノロジ(メッセージング・システムやデータベースなど)に接続されます。バインディング・コンポーネントは、次の2つのグループに編成されます。

- サービス: SOAコンポジット・アプリケーションへのエントリ・ポイントを外部に提供します。サービスのWSDLファイルによって、そのサービスの機能が外部のアプリケーションに通知されます。サービスのバインディングでは、SOAコンポジット・サービスをどのように呼び出すことができるか(例: SOAP経由で)が定義されます。

- 参照: SOAコンポジット・アプリケーションから外部のサービスにメッセージを送信できます(たとえば、パートナ・リンクがBPELプロセスに対して提供するものと同じ機能であっても、より高度なSOAコンポジット・アプリケーション・レベルで提供されます)。

Oracle Enterprise Manager Fusion Middleware Controlでは、ポリシーのアタッチ、拒否メッセージの監視、バインディング・コンポーネント・プロパティの設定などのバインディング・コンポーネント管理タスクを実行できます。図1-8に、サービス・バインディング・コンポーネント(この例ではJCAアダプタ)のホーム・ページを示します。

図1-8 バインディング・コンポーネント

詳細は、第35.4項「バインディング・コンポーネントの管理」を参照してください。

1.2.6 サービス・エンジンの概要

SOAインフラストラクチャには、一連のサービス・エンジン(BPELプロセス、ヒューマン・ワークフロー、デシジョン・サービス、Oracle MediatorおよびSpring)が組み込まれており、これらは、SOAコンポジット・アプリケーション(例: BPELプロセス)内でそれぞれのコンポーネントのビジネス・ロジックを実行します。Oracle BPM Suiteがインストールされている場合、SOAインフラストラクチャにはBPMNプロセス・サービス・エンジンも含まれます。

図1-9に、BPELプロセス・サービス・エンジンのOracle Enterprise Manager Fusion Middleware Controlの例を示します。このサービス・エンジンでは、LoanService、およびCreditRatingService BPELプロセス・サービス・コンポーネントが実行されています。LoanServiceおよびCreditRatingServiceに対して複数のインスタンスIDがあることに注意してください。BPELプロセス・サービス・コンポーネントは、CompositeTest SOAコンポジット・アプリケーションに組み込まれています。このページに初めてアクセスしたときに、インスタンスは表示されません。インスタンスを表示するには、まず「検索」をクリックする必要があります。

各BPELプロセス・サービス・コンポーネントは、同じBPELプロセス・サービス・エンジンで実行されます。ページ上のリンクをクリックすると、各BPELプロセス・サービス・コンポーネント・インスタンス、サービス・コンポーネント自体、または組み込まれているSOAコンポジット・アプリケーションに関する詳細を参照できます。

図1-9 サービス・エンジンで実行中のサービス・コンポーネント

Oracle Enterprise Manager Fusion Middleware Controlでは、インスタンスの監視、フォルトのリカバリ、失敗したメッセージの手動リカバリ(BPEL)、サービス・エンジン固有のプロパティの構成などのサービス・エンジン管理タスクを実行できます。これらの構成プロパティは、サービス・コンポーネントが組み込まれているSOAコンポジット・アプリケーションに関係なく、サービス・エンジンで実行されるすべてのサービス・コンポーネントに影響を与えます。サービス・エンジンのページには、サービス・エンジン固有の統計およびパフォーマンス・メトリックも表示されます。

サービス・エンジンの管理の詳細は、次の各項を参照してください。

- 第V部「BPELプロセスのサービス・コンポーネントとエンジンの管理」

- 第VI部「Oracle Mediatorのサービス・コンポーネントとエンジンの管理」

- 第VII部「デシジョン・サービス・コンポーネントとビジネス・ルール・サービス・エンジンの管理」

- 第VIII部「ヒューマン・タスク・サービス・コンポーネントとヒューマン・ワークフロー・サービス・エンジンの管理」

- 第XV部「Oracle BPMNプロセス・サービス・コンポーネントとエンジンの管理」

注意:

Oracle Enterprise Manager Fusion Middleware Controlには、Springサービス・エンジンを管理するためのページは含まれていません。

1.2.7 サービス・インフラストラクチャの概要

サービス・インフラストラクチャは、内部メッセージ転送インフラストラクチャ機能を提供して複数のコンポーネントを接続し、データ・フローを有効にします。サービス・インフラストラクチャには、サービス、サービス・コンポーネントおよび参照間のワイヤ接続に従ってメッセージをルーティングする役割があります。

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

- 第4.4項「メッセージ配信リクエスト処理の監視」

- ワイヤリングの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

1.2.8 SOAコンポジット・アプリケーションのコンテンツの概要

SOAコンポジット・アプリケーションは、様々なサービス・コンポーネント、バインディング・コンポーネントおよびサービスで構成でき、これらはOracle Enterprise Manager Fusion Middleware Controlから管理します。

- BPELプロセス

- BPMNプロセス(Oracle BPM Suiteがインストールされている場合)

- ヒューマン・ワークフロー

- Oracle Mediator

- デシジョン・サービス(Oracle Business Rules)

- Spring

- JCAアダプタ

- HTTPバインディング

- EJBサービス

- 直接バインディング・サービス

- Oracle Application Development Framework (ADF)ビジネス・コンポーネント・サービス

- Oracle BAM

- Oracle B2B

- Oracle Healthcare

- ビジネス・イベント

- Oracle User Messaging Service

これらのサービス・コンポーネント、バインディング・コンポーネントおよびサービスの概要は、『Oracle Fusion Middleware Oracle SOA Suiteスタート・ガイド』および『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

1.3 Oracle Business Process Management Suiteの概要

Oracle BPM Suiteでは、ビジネス・プロセスを中心とするビジネス・アプリケーションの開発、管理および使用のための統合環境が提供されます。

Oracle BPM Suiteには、次の機能が用意されています。

- ユーザーフレンドリなアプリケーションで標準に基づくプロセス・モデルを作成できます。プロセス開発者とプロセス・アナリスト間のコラボレーションが可能です。Oracle BPMでは、モデリングや実装からランタイムや監視まで、BPMN 2.0およびBPELがサポートされます。

- プロセス・アナリストとプロセス所有者がビジネス・プロセスとOracle Business Rulesをカスタマイズできます。

- ビジネス・プロセスの作成、Oracle Business Rulesの編集および事前定義されたコンポーネントを使用したタスクのカスタマイズ用のWebベース・アプリケーションを提供します。

- 柔軟性の高い非構造型プロセスを含めるようにビジネス・プロセス管理を拡張します。動的タスクを追加し、宣言的なパターンとルールドリブンのフローの決定を使用した承認ルーティングをサポートします。

- プロセス・スペースによってコラボレーションを可能にし、生産性と革新性を高めます。

- プロセスベースのアプリケーションの開発のエンドツーエンド要件に対処することで、アプリケーション開発ライフサイクルの様々なステージを統一します。Oracle BPM Suiteは、サービス・コンポーネント・アーキテクチャ(SCA)インフラストラクチャに基づいて、設計、実装、ランタイムおよび監視のステージを統一します。これにより、異なるペルソナがアプリケーション・ライフサイクルのすべてのステージに参加できます。

Oracle BPM Suiteは、設計時や実装からランタイムやアプリケーション管理まで、アプリケーション開発ライフサイクルのすべてのステージをシームレスに統合します。

Oracle BPM Suiteは、Oracle SOA Suite上で階層化され、次のような多くの同じ製品コンポーネントを共有します。

- Oracle Business Rules

- ヒューマン・ワークフロー

- 統合用のOracleアダプタ・フレームワーク

1.4 Oracle SOA SuiteおよびOracle BPM Suiteの管理

Oracle SOA SuiteおよびOracle BPM Suiteの様々な管理(構成、監視および管理)タスクは、Oracle Enterprise Manager Fusion Middleware Controlから実行できます。この項では、これらのタスクの概要を示します。

- 第1.4.1項「Oracle SOA SuiteおよびOracle BPM Suiteの構成」

- 第1.4.2項「Oracle SOA SuiteおよびOracle BPM Suiteの監視」

- 第1.4.3項「Oracle SOA SuiteおよびOracle BPM Suiteの管理」

- 第1.4.4項「Oracle SOA SuiteおよびOracle BPM Suiteのパフォーマンスとチューニング」

実行可能な管理タスクは、マップされているロールに基づきます。各ロールは、異なる一連の権限に対応しています。特定のユーザーを単一の監視権限(表示専用アクセスなど)にマップし、他のユーザーには、完全アクセス(構成の更新、サーバーの再起動などを実行できる権限)を付与できます。Oracle Enterprise Manager Fusion Middleware Controlのロールの詳細は、付録C「Oracle Enterprise ManagerのOracle SOA Suiteユーザーのロールおよび権限」を参照してください。

注意:

このガイドは、主にOracle SOA SuiteをOracle WebLogic Serverと使用する方法を説明していますが、ほとんどの情報はOracle SOA Suiteをサード・パーティのその他のアプリケーション・サーバーと使用する場合にも当てはまります。ただし、サード・パーティのアプリケーション・サーバーを使用する場合は、異なる部分がある可能性があります。

これらの相違点の詳細は、Oracle Fusion Middlewareサードパーティ・アプリケーション・サーバー・ガイドを参照してください。

1.4.1 Oracle SOA SuiteおよびOracle BPM Suiteの構成

Oracle SOA SuiteおよびOracle BPM Suiteの構成タスクは、Oracle Enterprise Manager Fusion Middleware Controlで実行できます。構成タスクでは、使用環境の監査レベルやペイロード検証などのプロパティを設定します。プロパティは次のレベルで設定できます。

- SOAインフラストラクチャ(すべてのSOAコンポジット・アプリケーションに影響)

- サービス・エンジン(サービス・コンポーネントが組み込まれているSOAコンポジット・アプリケーションに関係なく、サービス・エンジンで実行されるすべてのサービス・コンポーネントに影響)

- SOAコンポジット・アプリケーション(そのコンポジット・アプリケーションに組み込まれているすべてのサービス・コンポーネントに影響)

- Oracle B2Bバインディング

- サービスおよび参照バインディング・コンポーネントのメッセージ・ヘッダー・プロパティ

優先順位としては、継承SOAコンポジット・アプリケーションのプロパティ設定(監査レベルの設定やペイロード検証)が最も優先され、次にサービス・エンジンの設定、SOAインフラストラクチャの設定の順に優先されます。ただし、ほとんどのプロパティでは、この種の優先度を考慮する必要はありません。

Oracle SOA SuiteおよびOracle BPM Suiteのチューニング構成プロパティの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』を参照してください。

1.4.1.1 監査レベル設定の優先順位の概要

監査トラッキングでは、メッセージ・トラッキング・インフラストラクチャによって収集する情報のレベルを選択できます。監査レベル・トラッキングは、次のレベルで設定できます。

- BPELプロセスまたはBPMNプロセス・サービス・コンポーネント

- SOAコンポジット・アプリケーション

- サービス・エンジン

- SOAインフラストラクチャ

監査トラッキングを複数レベルで設定した場合は、どの設定が優先されるかを理解することが重要です。表1-1に、監査レベル設定の優先順位の例を示します。

表1-1 優先順位の例

コンポーネント

コンポジット

サービス・エンジン

SOAインフラストラクチャ

優先される設定

プロパティなし

オフ

本番

開発

コンポジット。

監査レベルは「オフ」に設定されます。サービス・エンジンおよびSOAインフラストラクチャの監査レベルは無効になります。

プロパティなし

継承

開発

本番

サービス・エンジン。

監査レベルは「開発」に設定されます。assignアクティビティでペイロードが表示されます。SOAインフラストラクチャの監査レベルは無効になります。

プロパティなし

継承

継承

本番

SOAインフラストラクチャ。

監査レベルは「本番」に設定されます。

プロパティなし

継承

本番/開発/オフ/継承

オフ

全体的な監査は表示されません。

コンポジットはSOAインフラストラクチャの監査レベルを継承します。サービス・エンジンの監査レベル設定に基づいてペイロードがassignアクティビティで表示されます。

開発

オフ

本番

開発

コンポジット。

コンポジット監査レベルが「オフ」に設定されているため、全体的な監査は表示されません。サービス・エンジンの監査レベルが表示されますが、コンポーネントの「開発」設定が優先されます。

「開発」のコンポーネント監査レベル設定に基づいてペイロードがassignアクティビティで表示されます。

継承

オフ

本番

開発

コンポジット。

コンポジット監査レベルが「オフ」に設定されているため、全体的な監査は表示されません。コンポジットから「オフ」が継承されるため、サービス・エンジンの監査レベルは表示されません。

注意:

- コンポジット監査レベルが「オフ」に設定されている場合、このコンポジットおよびコンポジット内で使用されているすべてのサービス・エンジンに対して監査証跡は生成されません。

- コンポジット監査レベルが「継承」に設定されている場合は、常にSOAインフラストラクチャの設定を継承します。

- コンポジット監査レベルが「オフ」に設定されている場合、コンポーネントはサービス・エンジンの設定を継承します。

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

- 第3章「SOAインフラストラクチャの構成」

- 第13.1項「BPELプロセス・サービス・エンジン・プロパティの構成」

- 第13.6項「BPELプロセス・サービス・コンポーネント・レベルでの監査レベルの設定」

- 第21章「ヒューマン・ワークフローのサービス・コンポーネントとエンジンの構成」

- 第36章「サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントの構成」

- 第39.1項「BPMNプロセス・サービス・エンジン・プロパティの構成」

1.4.2 Oracle SOA SuiteおよびOracle BPM Suiteの監視

Oracle SOA SuiteおよびOracle BPM Suiteの監視タスクは、Oracle Enterprise Manager Fusion Middleware Controlで実行できます。次のような項目を監視できます。

- SOAインフラストラクチャ、SOAコンポジット・アプリケーション、サービス・コンポーネント、サービス・エンジン、サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントのインスタンス、フォルトおよび拒否メッセージ。

- サービス・エンジン、サービス・インフラストラクチャ、およびバインディング・コンポーネントのリクエスト処理パフォーマンス。

- サービスおよび参照バインディング・コンポーネントのメッセージ処理に要する合計処理時間と平均処理時間。

- サービス・コンポーネントにおける監査証跡およびプロセス・フローの動作。BPMNプロセスの場合は、BPMNプロセス・フロー全体が表示され、プロセス・インスタンスがとるパスが強調表示されます。

- BPELプロセス、BPMNプロセスおよびヒューマン・ワークフローにおけるサービス・エンジンのリクエストおよびスレッドの状態。

注意:

WebLogic診断フレームワーク(WLDF)および診断フレームワークを使用すると、Oracle SOA Suiteでも問題を監視して診断できます。詳細は、第12章「SOAコンポジット・アプリケーションに関する問題の診断」を参照してください。

1.4.3 Oracle SOA SuiteおよびOracle BPM Suiteの管理

Oracle SOA SuiteおよびOracle BPM Suiteの管理タスクは、Oracle Enterprise Manager Fusion Middleware Controlで実行できます。次のような項目を管理できます。

- パーティションの作成と削除。パーティションの作成後、コンポジットを適切なパーティションにデプロイできます。このアクションにより、SOAコンポジット・アプリケーションをパーティションに論理的にグループ化できます。このことは、Oracle BPEL Process Managerの10.1.xリリースのドメインの概念に似ています。

- コンポジットの状態(アクティブ化、リタイア、起動、停止およびデフォルト・コンポジット・バージョンの設定)。

- コンポジット・インスタンスの削除と終了。

- SOAコンポジット・アプリケーションのデプロイメント、アンデプロイメントおよび再デプロイメント・アクション。

- デプロイされたSOAコンポジット・アプリケーションのJARファイルへのエクスポート。

- SOAコンポジット・アプリケーション・テスト・インスタンスの「Webサービスのテスト」ページからの手動の起動。

- SOAコンポジット・アプリケーション、サービス・コンポーネント、サービス・エンジンおよびビジネス・イベントのフォルトのリカバリ。

- BPELプロセスで失敗したメッセージの手動リカバリ。

- SOAコンポジット・アプリケーションの自動ユニット・テスト。

- SOAコンポジット・アプリケーション、サービス・コンポーネントおよびバインディング・コンポーネントへのポリシーの添付。

- ヒューマン・ワークフローの受信および送信通知メッセージ。

- ビジネス・イベントのサブスクリプションおよびイベント公開のテスト。

- Universal Description, Discovery, and Integration (UDDI)レジストリへのWebサービスの公開。

- ビジネス監視の無効化(BPELセンサー、BPELモニターおよびBPMN測定)。

- Oracle Exalogicプラットフォームにおけるインスタンスとコールバック・メッセージ・データのOracle Coherence分散キャッシュへの格納。

- Oracle Virtual Assembly BuilderによってインストロペクトされるOracle SOA Suiteプラグインの管理。Oracle Virtual Assembly Builderは、インストールされたOracleコンポーネントを仮想化して変更し、それを特定の環境にデプロイするためのツールです。Oracle Virtual Assembly Builderを使用して、ソフトウェア・アプライアンスと呼ばれるアーティファクトで既存のソフトウェア・コンポーネントの構成を取得することで、ソフトウェア・アセンブリと呼ばれるアーティファクトでのこれらのグループ化、および関係の定義が可能になります。Oracle SOA Suiteプラグインの詳細は、『Oracle Virtual Assembly Builderユーザーズ・ガイド』を参照してください。

以降の各項では、いくつかの管理タスクについてより具体的な概要を示します。

- 第1.4.3.1項「フォルト・リカバリの概要」

- 第1.4.3.2項「ポリシーの概要」

- 第1.4.3.3項「SOAコンポジット・アプリケーションのライフサイクルの状態の概要」

- 第1.4.3.4項「SOAコンポジット・アプリケーションの自動テストの概要」

- 第1.4.3.5項「SOAインフラストラクチャのパーティションの概要」

注意:

- Oracle SOA Suiteのバックアップおよびリカバリについては、Oracle Fusion Middlewareの管理者ガイドを参照してください。

- SOAインフラストラクチャは、GridLinkデータ・ソースおよびマルチ・データ・ソースによってデータベース障害から保護されます。通常、GridLinkおよびマルチ・データ・ソースはシステム設定時に構成します(インストール時にマルチプールを直接定義)。Oracle Real Application Clusters (Oracle RAC)データベース・インスタンスが失敗すると、使用可能なデータベース・インスタンスを使用して接続が再確立されます。GridlinkおよびOracle SOA Suiteの詳細は、『Oracle Fusion Middleware高可用性ガイド』のOracle SOA Suiteの高可用性の構成に関する項を参照してください。

1.4.3.1 フォルト・リカバリの概要

Oracle Enterprise Manager Fusion Middleware Controlでリカバリ可能として識別されたBPELプロセス、BPMNプロセス、Oracle Mediator、ヒューマン・ワークフローおよびビジネス・イベント・サブスクリプションのフォルト(データベースおよびコンポーネント・サブスクリプションのフォルトを含む)に対しては、フォルト・リカバリ・アクションを実行できます。次のタイプのフォルト・リカバリがサポートされています。

- 個々のフォルトのリカバリ。この場合は、各フォルト・タイプに固有の最も詳細なリカバリ・オプションにアクセスできます。

- 複数(一括)フォルトのリカバリ。この場合は、リカバリに対して複数のフォルトを選択します。

リカバリ可能なフォルトに対しては、個別および一括リカバリ・アクションを次のレベルで実行できます。

- SOAインフラストラクチャのすべてのSOAコンポジット・アプリケーションで発生したフォルト

- 個々のSOAコンポジット・アプリケーションで発生したフォルト

- サービス・コンポーネントで発生したフォルト

- サービス・エンジンで発生したフォルト

- ビジネス・イベントで発生したフォルト

Oracle Enterprise Manager Fusion Middleware Controlでリカバリ可能として識別されたフォルトに対して、フォルト・リカバリを実行します。リカバリ可能として識別されたBPELプロセス・フォルトについては、(fault-bindings.xmlファイルを介して)フォルトにバインドされ、アクションora-human-interventionをトリガーするフォルト・ポリシーが定義されている必要があります。BPELコンポーネントのフォルトは、この場合のみリカバリ可能です。フォルト・ポリシーがコンポジットの一部として定義されていない場合、BPELプロセスのフォルトはリカバリできません。

フォルト・リカバリ・ポリシーは、Oracle Enterprise Manager Fusion Middleware Controlの外部のfault-policies.xmlおよびfault-bindings.xmlファイルに定義します。これらのファイルは、SOAインフラストラクチャにデプロイするSOAコンポジット・アプリケーションとパッケージ化され、Oracle Enterprise Manager Fusion Middleware Controlで管理されます。

Oracle Mediatorおよびヒューマン・ワークフローのフォルトの動作はこれとは異なります。これらは、フォルト・ポリシーなしでリカバリ可能なフォルトを作成できます。ヒューマン・タスク・サービス・コンポーネントまたはヒューマン・ワークフロー・サービス・エンジンのエラーの場合は、Oracle BPM Worklistからリカバリ可能と識別されたフォルトに対してフォルト・リカバリを実行します。

次のタイプのフォルトがOracle Enterprise Manager Fusion Middleware Controlに表示されます。

- ビジネス: 処理対象の情報に問題がある場合に生成されるアプリケーション固有のフォルト(たとえば、社会保障番号がデータベースにない場合など)。

- システム: ネットワーク・エラーまたは他のタイプのエラー(データベース・サーバーやWebサービスがアクセス不可の場合など)。

- Oracle Web Service Manager (OWSM): SOAコンポジット・アプリケーション、サービス・コンポーネントまたはバインディング・コンポーネントにアタッチされたポリシーのエラー。ポリシーでは、メッセージ配信に対してセキュリティが適用されます。

フォルトは次のいずれかに分類することもできます。

- リカバリ可能またはリカバリ不可:
特定のタイプのフォルトのみがリカバリ可能として識別されます。表1-2に、リカバリ可能なフォルトとリカバリ不可のフォルトの例をいくつか示します。

- 拒否メッセージ:
フォルトは、その発生時期に基づいて拒否メッセージとして分類されます。フォルトの発生がSOAコンポジットの入力前で、コンポジット・インスタンスが生成されていない場合は、拒否メッセージとして分類されます。システム・フォルトまたはポリシー・フォルトは拒否メッセージとして分類されます。

表1-2 フォルト

リカバリ可能なフォルト

リカバリ不可のフォルト

- ビジネス・フォルトおよび一部の特定のシステム・フォルト

- Oracle Mediator入力ファイルのパスと出力ディレクトリの不一致

- Oracle BPM Worklistユーザーに関連(予想)アクションの実行権限がない場合

- 拒否メッセージ

- ほとんどのシステム・フォルト

- 存在しない参照

- サービス起動の失敗

- ポリシーのフォルト

フォルト・リカバリの実行の詳細は、次の各項を参照してください。

- 第8.4項「SOAインフラストラクチャ・レベルでの、SOAコンポジット・アプリケーションのフォルトのリカバリ」

- 第8.5項「アプリケーションのホーム・ページでの、SOAコンポジット・アプリケーションのフォルトのリカバリ」

- 第15.1項「BPELプロセス・サービス・コンポーネントのフォルトのリカバリ」

- 第15.3項「BPELプロセス・サービス・エンジンのフォルトのリカバリ」

- 第18.3項「Oracle Mediatorサービス・エンジンのフォルトのリカバリ」

- 第23.2項「ヒューマン・ワークフロー・サービス・エンジンのフォルトのリカバリ」

- 第23.4項「ヒューマン・タスク・サービス・コンポーネントのフォルトのリカバリ」

- 第35.4項「ビジネス・イベントのフォルトのリカバリ」

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

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

1.4.3.2 ポリシーの概要

Oracle Enterprise Manager Fusion Middleware Controlでは、ポリシーを次のレベルでアタッチおよびデタッチできます。

- SOAコンポジット・アプリケーション

- サービス・コンポーネント

- サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネント

ポリシーでは、メッセージ配信に対してセキュリティが適用されます。Oracle Fusion Middlewareでは、ポリシー・ベースのモデルを使用してWebサービスを管理します。次のタイプのポリシーがサポートされています。

- セキュリティ: WS-Security 1.0および1.1の標準を実装します。これらの標準によって、ユーザーの認証と認可、アイデンティティ伝播およびメッセージ保護(メッセージ整合性およびメッセージ機密性)が実施されます。

- 信頼できるメッセージング: WS-ReliableMessagingプロトコルをサポートして、エンドツーエンドのメッセージ配信を保証します。

- メッセージ転送最適化メカニズム(MTOM): 添付がMTOMフォーマットであることを保証します。このフォーマットは、Webサービスとの間でバイナリ・データを効率的に送受信するためのフォーマットです。

- WS-Addressing: WS-Addressing仕様に準拠したWS-AddressingヘッダーがSOAPメッセージに含まれていることを検証します。トランスポート・レベルのデータはXMLメッセージに含まれており、ネットワーク・レベルのトランスポートに依存せずに情報を伝達します。

- 管理: リクエスト、レスポンスおよびフォルト・メッセージをメッセージ・ログに記録します。管理ポリシーにはカスタム・ポリシーを含めることもできます。

ポリシーは、企業のポリシー・フレームワークの一部であり、このフレームワークによってポリシーを集中的に作成して管理できます。

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

- 第7.7項「SOAコンポジット・アプリケーションのポリシーの管理」

- 第15.2項「BPELプロセス・サービス・コンポーネントのポリシーの管理」

- 第18.2項「Oracle Mediatorのポリシーの管理」

- 第23.1項「ヒューマン・タスク・サービス・コンポーネントのポリシーの管理」

- 第38.1項「バインディング・コンポーネントのポリシーの管理」

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

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

1.4.3.2.1 ポリシーの実行方法の概要

ポリシーは、ポリシーがアタッチされているコンポーネントにメッセージが到達する前に実行されます。この結果、エラーは、ポリシーがアタッチされているコンポーネントの直前のコンポーネントに表示されます。次に例を示します。

- Oracle Mediatorサービス・コンポーネントにアタッチされたポリシーは、メッセージがOracle Mediatorに渡される前にワイヤで実行されます。この結果、フォルトは、Oracle Mediatorではなくサービス・バインディング・コンポーネントに表示されます。

- ヒューマン・タスク・サービス・コンポーネントにアタッチされたポリシーは、メッセージがヒューマン・タスク・サービス・コンポーネントに渡される前に、直前のBPELプロセス・サービス・コンポーネントで実行されます。この結果、フォルトは、ヒューマン・タスク・サービス・コンポーネントではなく、BPELプロセス・サービス・コンポーネントに表示されます。

- ヒューマン・タスク・サービス・コンポーネントにアタッチされたポリシーは、メッセージがヒューマン・タスク・サービス・コンポーネントに渡される前に、ヒューマン・サービス・コンポーネントに関連付けられているヒューマン・ステップのBPMNプロセスの内部で実行されます。これにより、フォルトは、ヒューマン・タスク・サービス・コンポーネントではなく、BPMNプロセス・サービス・コンポーネントに表示されます。

ポリシー・エラーの正確な位置を確認するには、監査証跡を参照してください。

1.4.3.3 SOAコンポジット・アプリケーションのライフサイクルの状態の概要

デプロイ済SOAコンポジット・アプリケーションのライフサイクルの状態は、Oracle Enterprise Manager Fusion Middleware Controlから管理できます。アプリケーションは、SOAインフラストラクチャにデプロイすると自動的にアクティブ化されます。デプロイメント時には、アプリケーションに対して特定のリビジョン番号を指定できます。リビジョンは、アプリケーションの特定のデプロイ済バージョンです。アプリケーションの複数のリビジョンをデプロイし、すべてのリビジョンを同時に実行できます。

これは、リビジョンの重要な利点です。たとえば、古いリビジョンのアプリケーションがあり、引続き有効なある顧客で実行中であるとします。その後、別の顧客とのパートナーシップが開始され、この顧客については小規模なアプリケーションの設計変更が必要です。ある時点で古い顧客を新しいリビジョンのアプリケーションに移行する計画ですが、現時点では、移行の必要はありません。これは、リビジョンを使用すると、両方のアプリケーションを実行できるためです。

Oracle Enterprise Manager Fusion Middleware Controlでは、リビジョン値がアプリケーション名に付加されます。たとえば、図1-1で、リビジョン1.0は、多数のデプロイ済SOAコンポジット・アプリケーションに対するバージョンです。特定のコンポジット・アプリケーション・リビジョンに対する新規リクエストを受信すると、そのコンポジット・アプリケーション・リビジョンが起動します。リビジョンが指定されていない新規リクエストを受信すると、デフォルトのリビジョンが起動します。デフォルトのリビジョンは、小さい緑色の丸印で他のリビジョンと区別されます。

SOAコンポジット・アプリケーションに関する次のライフサイクル管理タスクは、Oracle Enterprise Manager Fusion Middleware Controlから実行できます。

- インスタンスの作成。

- アプリケーション・リビジョンの停止と再起動。アプリケーション・リビジョンは通常、デプロイメント後即時に起動されます。

- アプリケーション・リビジョンのリタイアとアクティブ化。アプリケーション・リビジョンは、デプロイメント時に即時にアクティブ化されます。

- デフォルト・バージョンとしてのアプリケーションの設定。

- アプリケーション・リビジョンのデプロイ、アンデプロイおよび再デプロイ。

- アプリケーション・リビジョンの特定インスタンスの削除。

ライフサイクル管理にOracle SOAガバナンス・ツールが追加されたため、SOAコンポジット・アプリケーション、またはコンポジット内の任意のコンポーネントまたはサービスに対して追加のライフサイクル管理タスクを実行できます。

- Oracle Enterprise Repositoryで各コンポーネントの重要情報を収集して、プロデューサ、プロバイダ、コンシューマまたはその他のライフサイクル参加者の理解向上に役立てることができます。たとえば、前のバージョンと次のバージョンの関係を示すことができます。

- ライフサイクルのステージ分類をコンポーネントまたはサービス・エンドポイント(ビルド、テスト、ステージまたは本番など)に関連付けます。

- 様々なライフサイクル・ステージを経由して自動的に進み、コンポーネントとサービス・エンドポイントを追跡し、それらのライフサイクル・ステージの適切なUDDIサービス・レジストリに対して、ライフサイクル・ステージを自動的に公開します。

- 反復可能なプロセスを使用して、ライフサイクルおよび関連する承認を管理します。

- 本番でパフォーマンスを管理し、設計時により適切な意思決定を行うためにサービスのコンシューマに通知します。

SOA Governance Suiteは、アプリケーションとそのコンポーネントの完全なライフサイクル(たとえば、計画、設計、実装、テスト、ステージング、本番、変更およびリタイア)を指定および自動化するオプションを、Oracle SOA SuiteおよびOracle BPM Suiteのユーザーに提供します。

SOAコンポジット・アプリケーションのライフサイクルの状態の管理およびSOAガバナンスについては、次の各項を参照してください。

- 第8.1項「SOAコンポジット・アプリケーションのテスト・インスタンスの起動」

- 第7.5項「デプロイ済SOAコンポジット・アプリケーションの状態管理」

- 第8.2項「アプリケーションのホーム・ページからの、SOAコンポジット・アプリケーション・インスタンスの監視と削除」

- 第8.3項「SOAインフラストラクチャ・レベルでの、SOAコンポジット・アプリケーション・インスタンスの監視と削除」

- Oracle Fusion Middleware Oracle Enterprise Repositoryユーザー・ガイド

- Oracle Fusion Middleware Oracle Enterprise Repository統合ガイド

- Oracle Fusion Middleware Oracle Enterprise Repository構成ガイド

1.4.3.4 SOAコンポジット・アプリケーションの自動テストの概要

SOAコンポジット・アプリケーションのテストを自動化するテスト・ケースを作成、デプロイおよび実行できます。テスト・ケースを使用すると、SOAコンポジット・アプリケーションとその参照の間の相互作用を、本番環境へのデプロイメント前にシミュレートできます。テスト・スイートは、1つ以上のテスト・ケースの論理的な集合で構成されます。各テスト・ケースには、テスト・インスタンスの実行時に実行される一連のコマンドが含まれています。テスト・スイートの実行は、テスト実行と呼ばれます。各テストは、単一のSOAコンポジット・アプリケーション・インスタンスに対応しています。また、SOAコンポジット・アプリケーションのテスト・ケース内に、BPELプロセス・サービス・コンポーネントのテスト・ケースを作成することもできます。SOAインフラストラクチャの「インスタンスID」ページでは、これらのテストの実行で生成されたインスタンスのインスタンスIDの横に小さい黄色のボックスが表示され、テスト・インスタンスとして区別されます。

テスト・スイート・フレームワークの機能は、次のとおりです。

- SOAコンポジット・アプリケーションが実行時に相互作用するコンポーネントの動作を、エミュレーションを使用してシミュレートします。特定のコンポーネントを起動せずに、コンポーネントからのレスポンスを指定できます。

- アサーションを使用し、プロセス実行時にデータを検証します。

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

- テストの作成と実行の詳細は、第7.6項「SOAコンポジット・アプリケーションのテストの自動化」を参照してください。

- SOAコンポジット・アプリケーションのテスト・ケースの設計の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

1.4.3.5 SOAインフラストラクチャのパーティションの概要

パーティションと呼ばれるSOAインフラストラクチャの個別のセクションに、SOAコンポジット・アプリケーションをデプロイできます。パーティションにデプロイすると、SOAコンポジットを論理的にグループ化し、大量のコンポジット・アプリケーションに対して一括ライフサイクル管理タスクを実行できます。パーティションは、Oracle BPEL Process Managerの10.1.xリリースのドメインの概念に似ています。ただし、特定のパーティションへのログイン・アクセスの制限やパーティションの構成(たとえばスレッドの構成)などの、パーティションに対する特定の構成タスクを実行できないことに注意してください。

SOAコンポジット・アプリケーションをデプロイするには、パーティションが少なくとも1つ必要です。「デフォルト」という名前のデフォルトのパーティションが、Oracle SOA Suiteに自動的に作成されます。

パーティションの作成後に、次のタスクを実行できます。

- Oracle Enterprise Manager Fusion Middleware Control、Oracle JDeveloper、WebLogic Scripting Tool (WLST)コマンドまたはantコマンドを使用してSOAコンポジット・アプリケーションをパーティションにデプロイします。

- ナビゲーション・ツリーを使用して、パーティションおよびデプロイされたコンポジットにアクセスします。

- 特定のパーティション内のコンポジットに対して次の一括ライフサイクル管理タスクを実行します。

- すべてのコンポジットの起動

- すべてのコンポジットのシャットダウン

- すべてのコンポジットのアンデプロイ

- すべてのコンポジットのリタイア

- すべてのコンポジットのアクティブ化

- すべてのコンポジットのリスト

注意:

パーティションは、特定の状態(起動、停止、アクティブ化、リタイアなど)に関連付けられません。パーティション内のコンポジットのみが、特定の状態に関連付けられます。このため、パーティションを起動、停止、アクティブ化またはリタイアさせることはできません。

詳細は、第7.9項「SOAコンポジット・アプリケーションのパーティションへのグループ化」を参照してください。

1.4.4 Oracle SOA SuiteおよびOracle BPM Suiteのパフォーマンスとチューニング

設定する構成パラメータの多くは、パフォーマンスに影響を及ぼす可能性があります。たとえば、BPELプロセス・サービス・エンジンではディスパッチャ・システム、起動、およびエンジン・スレッドの構成パラメータを設定できます。

詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』を参照してください。

1.5 アプリケーション開発者による管理

アプリケーション開発者ロールの保持者は、Oracle JDeveloperおよびOracle Enterprise Manager Fusion Middleware Controlを組み合せて使用してSOAコンポジットを管理およびテストします。Oracle JDeveloperでSOAコンポジット・アプリケーションを開発するには『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照し、Oracle Enterprise Manager Fusion Middleware Controlでコンポジット・アプリケーションのテスト・インスタンスをデプロイ、監視および開始するには次の項を参照してください。

- 第6章「SOAコンポジット・アプリケーションの監視」

- 第7章「SOAコンポジット・アプリケーションのデプロイおよび管理」

- 第8.1項「SOAコンポジット・アプリケーションのテスト・インスタンスの起動」

Oracle BPM Suiteを使用してビジネス・プロセスを作成し、モデル化する場合は、『Oracle Fusion Middleware Oracle Business Process Managementモデリングおよび実装ガイド』を参照してください。

1.6 Oracle Enterprise Manager 11g Grid ControlおよびOracle SOA Management Packによる管理

Oracle Enterprise Manager 11g Grid Controlを使用すると、複数のOracle Fusion MiddlewareファームおよびOracle WebLogic Serverドメインの実行時データおよび履歴データを監視できます。Oracle Enterprise Manager 11g Grid Controlは、Oracle SOA SuiteからOracle SOA Management Packにいたる、Oracle Fusion Middlewareコンポーネント・ファミリ全体の検出、監視および中央管理をサポートします。

Oracle Enterprise Manager 11g Grid Controlは、Oracle Fusion Middleware 11gインストールの構成部分ではないため、ライセンスを別途取得してインストールする必要があります。

Oracle SOA Management Packの詳細は、次のURLを参照してください。

http://www.oracle.com/us/products/middleware/soa/management-pack/overview/index.html

第II部

管理のスタート・ガイド

この部では、Oracle Enterprise Manager Fusion Middleware ControlでOracle SOA SuiteおよびOracle BPM Suiteの管理タスクに移動する方法について説明します。

次の章で構成されています。

- 第2章「Oracle SOA SuiteおよびOracle BPM Suiteの管理のスタート・ガイド」

2 Oracle SOA SuiteおよびOracle BPM Suiteの管理のスタート・ガイド

この章では、ログインしてOracle Enterprise Manager Fusion Middleware Controlのメニューを移動し、Oracle SOA SuiteとOracle BPM Suiteの構成、監視および管理タスクを実行する方法について説明します。また、Oracle Enterprise Manager Fusion Middleware ControlからシステムMBeanブラウザおよびOracle WebLogic Server管理コンソールにアクセスする方法についても説明します。

この章では、次の項目について説明します。

- 第2.1項「Oracle Enterprise Manager Fusion Middleware Controlへのログイン」

- 第2.2項「Oracle SOA SuiteおよびOracle BPM Suiteの管理タスクへの移動」

- 第2.3項「システムMBeanブラウザへの移動」

- 第2.4「Oracle Enterprise Manager Fusion Middleware Controlからのログアウト」

サービス・エンジン、サービス・コンポーネント、バインディング・コンポーネントおよびSOAインフラストラクチャの詳細は、第1章「概要と概念」を参照してください。

2.1 Oracle Enterprise Manager Fusion Middleware Controlへのログイン

この項では、Oracle Enterprise Manager Fusion Middleware Controlへのログイン方法について説明します。

Oracle Enterprise Manager Fusion Middleware Controlにログインするには、次の手順を実行します。

1. Microsoft Internet Explorer 7、Mozilla Firefox 2.0.0.2、Apple Safari 4.0またはMozilla Firefox 3.0.xを使用して、次のURLにアクセスします。

http://host_name:port/em

host_nameは、Oracle Enterprise Manager Fusion Middleware Controlがインストールされているホストの名前で、portは、インストール時に動的に設定される番号です。通常、このポートは7001ですが、Oracle HTTP Serverに関連付けられているHTTPポートです。構成時にSSLポートが有効化されていた環境の場合、デフォルト・ポートは7002です。

2. 「weblogic/password」と入力し、「ログイン」をクリックします。

説明:

- weblogicは、Oracle Enterprise Manager Fusion Middleware Controlのデフォルトの管理者ユーザー名です(インストール時に変更可能)。

- passwordは、Oracle SOA Suiteのインストール時に入力したパスワードです。

初めてログインすると、「アクセシビリティ・プリファレンス」ダイアログが表示されます。必要に応じて、このダイアログが再度表示されないようにする選択もできます。

3. 適切なアクションを選択し、「続行」をクリックします。
ファーム・ホーム・ページが表示されます。このページから、次の各項で説明するように、異なるいくつかの方法でOracle SOA SuiteおよびOracle BPM Suiteに移動できます。

インストールの詳細は、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suiteインストレーション・ガイド』を参照してください。

2.2 Oracle SOA SuiteおよびOracle BPM Suiteの管理タスクへの移動

この項では、Oracle Enterprise Manager Fusion Middleware ControlでOracle SOA SuiteおよびOracle BPM Suiteの管理タスクに移動する方法について説明します。

- 第2.2.1項「SOAインフラストラクチャのホーム・ページおよびメニューからの移動」

- 第2.2.2項「SOAコンポジット・アプリケーションのホーム・ページおよびメニューからの移動」

- 第2.2.3項「パーティションのホーム・ページおよびメニューからの移動」

- 第2.2.4項「デプロイ済Java EEアプリケーションへの移動」

- 第2.2.5項「Oracle WebLogic Server管理コンソールおよび他のページへの移動」

- 第2.2.6項「ファーム・ホーム・ページからSOAインフラストラクチャまたはSOAコンポジット・アプリケーションのホーム・ページへの移動」

注意:

ナビゲータの上部に、「ファーム」メニューが常に表示されます。ナビゲータで「SOA」フォルダを開いてその下に表示されるリンクをクリックすると、ページ上部の「SOAインフラストラクチャ」メニューが使用可能になります。

2.2.1 SOAインフラストラクチャのホーム・ページおよびメニューからの移動

Oracle SOA SuiteおよびOracle BPM Suiteの管理タスクには、SOAインフラストラクチャのホーム・ページおよびメニューから移動できます。すべてのデプロイ済SOAコンポジット・アプリケーション、サービス・エンジン、サービス・コンポーネント、ビジネス・イベントおよびその他の要素には、SOAインフラストラクチャからアクセスできます。

SOAインフラストラクチャのホーム・ページおよびメニューから移動する手順は、次のとおりです。

1. ナビゲータで、「SOA」→「soa-infra」の順に開きます。

2. 特定のパーティション(例: default)を展開します。

これで、その管理対象サーバーのSOAインフラストラクチャの選択したパーティションで実行中のすべてのSOAコンポジット・アプリケーションが表示されます。SOAコンポジット・アプリケーションは、デプロイされたパーティション別にグループ化されています。

3. 「soa-infra」をクリックします。

SOAインフラストラクチャの「ダッシュボード」ページが表示されます。Oracle SOA Suite全体のリソース・センターにアクセスするには、このページの上部にあるヘルプ・アイコンをクリックします。

ページの上部には、最近デプロイされたSOAコンポジット・アプリケーション・インスタンス、デプロイされたコンポジット、最新のフォルトおよび拒否メッセージに関する詳細が表示されます。特定のSOAコンポジット・アプリケーション名またはインスタンスIDをクリックすると、その他の詳細にアクセスできます。各セクション下部の「詳細の表示」をクリックすると、すべての項目に関する詳細情報も表示できます。

ページの下部には、SOAインフラストラクチャで提供されるサービス・エンジンに関する詳細、およびSOAインフラストラクチャでホスト管理されるすべてのSOAコンポジット・アプリケーションのインスタンスとフォルトの数がグラフィカルに表示されます。この情報を表示するには、これらのセクションを開く必要があります。より具体的な詳細にアクセスするには、サービス・エンジン名をクリックします。

4. 「SOAインフラストラクチャ」メニューは、ページ上部のsoa-infra名の下に表示されることに注意してください。

注意:

現在の場所に応じて、このメニューのコンテキストは、現在の場所に最も関連のある管理オプションを示すように変更されます。たとえば、SOAコンポジット・アプリケーションのページを表示しているときは、「SOAコンポジット」メニューが表示され、特定のパーティションのホーム・ページを表示しているときは、「SOAパーティション」メニューが表示されます。

5. 「SOAインフラストラクチャ」メニューを選択します。

これらの管理オプションを使用すると、次のタスクを実行できます。

オプション

説明

ホーム

このオプションを使用すると、SOAインフラストラクチャの選択したタブに直接移動できます。

- ダッシュボード: このオプションを使用すると、SOAインフラストラクチャにデプロイされたすべてのSOAコンポジット・アプリケーションを監視できます。
詳細は、第4.3項「SOAインフラストラクチャの最新のインスタンスとフォルト、およびデプロイ済コンポジットの監視」を参照してください。

- デプロイ済コンポジット: このオプションを使用すると、SOAインフラストラクチャ内のすべてのSOAコンポジット・アプリケーションの状態を管理できます。
詳細は、第7.5.1項「SOAインフラストラクチャ・レベルでのすべてのアプリケーションの状態管理」を参照してください。

- インスタンス: このオプションを使用すると、SOAインフラストラクチャにデプロイされたすべてのSOAコンポジット・アプリケーションで任意の数のインスタンスを監視および削除できます。
詳細は、第8.3項「SOAインフラストラクチャ・レベルでの、SOAコンポジット・アプリケーション・インスタンスの監視と削除」を参照してください。

- フォルトと拒否メッセージ: このオプションを使用すると、SOAインフラストラクチャ内の任意の数のSOAコンポジット・アプリケーションでフォルトの個別および一括リカバリの監視および実行ができます。
詳細は、第8.4項「SOAインフラストラクチャ・レベルでの、SOAコンポジット・アプリケーションのフォルトのリカバリ」を参照してください。

監視

このオプションを選択すると、次の詳細が表示されます。

- SOAインフラストラクチャのパフォーマンス統計のサマリー

- バインディング・コンポーネント、サービス・インフラストラクチャおよびサービス・エンジン間でのリクエストのハンドシェイクに要した時間の詳細を示す、リクエスト処理の詳細

詳細は、第4.4項「メッセージ配信リクエスト処理の監視」を参照してください。

ログ

このオプションを選択すると、ランタイム・ロガーのロギング・レベルを表示して構成できます。

詳細は、第3.4項「ログ・ファイルの構成」および第B.1項「トラブルシューティングのためのロギング・レベルの設定」を参照してください。

SOAデプロイ

このオプションを選択すると、SOAコンポジット・アプリケーションをデプロイ、アンデプロイまたは再デプロイできます。

詳細は、第7章「SOAコンポジット・アプリケーションのデプロイおよび管理」を参照してください。

パーティションの管理

このオプションを選択すると、SOAインフラストラクチャをパーティションと呼ばれる個別のセクションに論理的にグループ化して、SOAコンポジット・アプリケーションをデプロイできます。これにより、コンポジットを論理的にグループ化して、多数のSOAコンポジット・アプリケーションに対する一括ライフ・サイクル管理タスクを実行できるようにします。

詳細は、第1.4.3.5項「SOAインフラストラクチャのパーティションの概要」と第7.9項「SOAコンポジット・アプリケーションのパーティションへのグループ化」を参照してください。

サービス・エンジン

このオプションを選択すると、BPELプロセス、Oracle BPMN、Oracle Mediator、ヒューマン・ワークフロー、およびビジネス・ルールの各サービス・エンジンを監視および管理するタスクにアクセスできます。

バインド

このオプションを選択すると、最新のアクティブなドキュメント・タイプと取引パートナ、およびOracle B2Bのインバウンド・エンドポイントとアウトバウンド・エンドポイントに関する詳細が表示されます。

詳細は、第33.1項「Oracle B2Bインフラストラクチャの監視」を参照してください。

サービスと参照

このオプションを選択すると、すべてのSOAコンポジット・アプリケーション内のサービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントに対するメッセージ処理メトリックが表示されます。

詳細は、第4.5項「SOAインフラストラクチャのサービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントの監視」を参照してください。

ビジネス・イベント

このオプションを選択すると、使用可能なビジネス・イベント、現在のイベント・サブスクライバおよびフォルトの詳細が表示されます。

詳細は、第35章「ビジネス・イベントの管理」を参照してください。

SOA管理

このオプションを選択すると、SOAインフラストラクチャおよび各サービス・エンジンを構成する次のタスクにアクセスできます。

- 共通プロパティ: SOAインフラストラクチャの監査レベルの表示と設定、SOAコンポジット・アプリケーション・インスタンスの状態のキャプチャ、受信メッセージのペイロード検証の有効化、コールバック・サーバーとサーバーURLの指定、Universal Description, Discovery and Integration (UDDI)レジストリ・プロパティの設定、データソースJNDIロケーションの表示、致命的でない接続の再試行回数の設定、Webサービス・バインディング・プロパティの設定、ページのロード効率の最適化など、SOAインフラストラクチャ全体に影響を与えるプロパティの設定が可能です。
詳細は、第3.1項「SOAインフラストラクチャ・プロパティの構成」を参照してください。

- BPELプロパティ: 監査証跡サイズ、変数の最大ドキュメント・サイズ、受信および送信メッセージのペイロード検証、監査証跡レベル、BPELモニターおよびセンサーの無効化ステータス、および(起動メッセージ・スレッド、システム・スレッド、サービス・エンジン・スレッドの)ディスパッチャ・スレッド・レベルの各設定が可能です。
詳細は、第13.1項「BPELプロセス・サービス・エンジン・プロパティの構成」を参照してください。

- BPMNプロパティ: 監査証跡サイズ、変数の最大ドキュメント・サイズ、受信および送信メッセージのペイロード検証、監査証跡レベル、および(起動メッセージ・スレッド、システム・スレッド、サービス・エンジン・スレッドの)ディスパッチャ・スレッド・レベルの各設定が可能です。
詳細は、第39.1項「BPMNプロセス・サービス・エンジン・プロパティの構成」を参照してください。

- メディエータ・プロパティ: 監査レベル、メトリック・レベル、パラレル・ワーカー・スレッド数、パラレル処理で取得する最大行数、パラレル・スレッド・スリープ値、エラー・スレッド・スリープ値、コンテナIDのリフレッシュ時間、およびコンテナIDのリース・タイムアウト値の設定が可能です。
詳細は、第16.1項「Oracle Mediatorサービス・エンジン・プロパティの構成」を参照してください。

- ワークフロー構成: 次のタブが表示されます。
「メーラー」タブ: ワークフロー・サービス通知モード、およびアクション可能な電子メール・アドレス値の設定が可能です。詳細は、第21.1項「ヒューマン・ワークフロー通知プロパティの構成」を参照してください。

「タスク」タブ: アクション可能な電子メール・アカウントの設定、ワークリスト・アプリケーションURLの追加、割当て先のプッシュバックの選択、ポータル・レルム・マッピングの追加、およびタスク・オート・リリース構成優先度の追加が可能です。詳細は、第21.3項「ヒューマン・ワークフロー・タスク・サービス・プロパティの構成」を参照してください。

- B2Bサーバー・プロパティ: DMS(ダイナミック・モニタリング・サービス)メトリックを有効にできます。詳細は、第32.1項「Oracle B2Bサーバーのプロパティの構成」を参照してください。

- 相互参照: 相互参照値を選択できます。詳細は、第19章「相互参照の管理」を参照してください。

セキュリティ

このオプションを選択すると、次の選択項目が表示されます。

- アプリケーション・ポリシー: リソースへのアクセスを制御するために、アプリケーションが依存するアプリケーション・ポリシーを作成できます。

- アプリケーション・ロール: アプリケーションに対するアプリケーション・ロールを作成できます。
アプリケーション・ロールの詳細は、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』を参照してください。

このオプションは、SOAインフラストラクチャ(soa-infra)アプリケーションを含めたデプロイ済のすべてのJava EEアプリケーションについて使用可能です。これらのオプションは、SOAコンポジットのセキュリティ・ポリシーを構成しません。

ポリシーをコンポジット・アプリケーションにアタッチする方法の詳細は、第7.7項「SOAコンポジット・アプリケーションのポリシーの管理」を参照してください。

管理

このオプションを選択すると、次の選択項目が表示されます。

- MDS接続: メタデータ・サービス(MDS)接続を管理できます。

- TopLinkセッション: Oracle TopLink永続フレームワークのキャッシュを管理できます。

- システムMBeanブラウザ: 複数のアプリケーションとコンポーネント間でプロパティの拡張構成を実施できます。
詳細は、第2.3項「システムMBeanブラウザへの移動」および『Oracle Fusion Middleware管理者ガイド』のシステムMBeanブラウザの使用に関する説明を参照してください。

Oracle Enterprise Manager Fusion Middleware ControlからのシステムMBeanブラウザを構成することに加え、WebLogic Scripting Tool (WLST)を使用したSOA構成のMBean操作も起動できます。詳細は、『Oracle Fusion Middleware Oracle WebLogic Scripting Tool』を参照してください。

注意: Oracle BPM Suiteがインストールされていなくても、システムMBeanブラウザにはOracle BPMNのMBeanが含まれています。Oracle BPM Suiteがインストールされていない場合は、このMBeanを使用できないため、無視します。このMBeanが存在しても、他のOracle SOA Suiteコンポーネントの実行時の動作に影響はありません。

一般情報

このオプションを選択すると、Oracle Enterprise Manager Fusion Middleware Controlのバージョン、Oracleホーム、OracleインスタンスなどのSOAインフラストラクチャに関する一般的な詳細が表示されます。

注意:

11g リリース1 (11.1.1.4.0)以降では、「SOAインフラストラクチャ」メニューからSOAインフラストラクチャを停止および開始できません。

6. 手順2で表示されたsoa-infraリストから特定のSOAコンポジット・アプリケーションを選択します。
「SOAインフラストラクチャ」メニューがナビゲータの上に表示され、SOAコンポジット・アプリケーションの各ページを参照している場合でも、同じ高レベルの管理オプションにアクセスできます。このメニューは、コンポジット・アプリケーションを選択すると位置が変わります。

7. ナビゲータで「soa-infra」を右クリックします。表示されたメニューでは、「SOAインフラストラクチャ」メニューに表示されている同じ管理オプションにアクセスできます。

2.2.2 SOAコンポジット・アプリケーションのホーム・ページおよびメニューからの移動

特定のSOAコンポジット・アプリケーションのOracle SOA SuiteおよびOracle BPM Suiteの管理タスクに直接移動できます。

SOAコンポジット・アプリケーションのホーム・ページおよびメニューから移動する手順は、次のとおりです。

1. ナビゲータで、「SOA」→「soa-infra」の順に開きます。

2. パーティションを展開します。
SOAインフラストラクチャのパーティションで実行中のすべてのSOAコンポジット・アプリケーションが表示されます。

3. 特定のSOAコンポジット・アプリケーションを選択します。
選択したSOAコンポジット・アプリケーションのホーム・ページが表示されます。ページの上部には、最新のインスタンス、フォルトおよび拒否メッセージに関する詳細が表示されます。ページのこの部分では、コンポジット・レベルの重要な管理タスクおよび構成タスクにもアクセスできます。

4. 各セクションの下部にある「詳細の表示」をクリックして、これらの項目の詳細を表示します。リンクをクリックすると、特定のコンポジット・インスタンスまたはフォルトに関する詳細にアクセスすることもできます。
ページの下部には、SOAコンポジット・アプリケーションに含まれるサービス・コンポーネント(この例では、BPELプロセス)とバインディング・コンポーネント(サービスと参照)に関する詳細が表示されます。「名前」列の特定のサービス・コンポーネントまたはバインディング・コンポーネント(サービスまたは参照)をクリックすると、より具体的な詳細にアクセスできます。

SOAコンポジット・アプリケーションの各ページを参照している場合は、ページ上部のアプリケーション名の下に「SOAコンポジット」メニューが表示されます。このメニューには、現在のコンポジット・アプリケーションに固有の管理タスクが表示されます。

5. 「SOAコンポジット」メニューを選択します。

これらの管理オプションを使用すると、次のタスクを実行できます。

オプション

説明

ホーム

このオプションを使用すると、SOAコンポジット・アプリケーションの選択したタブに直接移動できます。

- ダッシュボード: このオプションを使用すると、アプリケーションのホーム・ページから個別のSOAコンポジット・アプリケーションの状態を管理できます。
詳細は、第7.5.2項「SOAコンポジット・アプリケーションのホーム・ページでのアプリケーションの状態管理」を参照してください。

- インスタンス: このオプションを使用すると、SOAコンポジット・アプリケーションのライフサイクル状態を管理できます。また、特定のSOAコンポジット・アプリケーションの監視と削除もこのオプションで実行できます。
詳細は、第8.2項「アプリケーションのホーム・ページからの、SOAコンポジット・アプリケーション・インスタンスの監視と削除」を参照してください。

- フォルトと拒否メッセージ: このオプションを使用すると、SOAコンポジット・アプリケーションでフォルトの個別および一括リカバリの監視および実行ができます。
詳細は、第8.5項「アプリケーションのホーム・ページでの、SOAコンポジット・アプリケーションのフォルトのリカバリ」を参照してください。

- ユニット・テスト: このオプションを使用すると、テスト・ケースを実行して、現在のSOAコンポジット・アプリケーションとそのWebサービス・パートナの間の相互作用を、本番環境へのデプロイメント前にシミュレートできます。このオプションは、コンポジットのテスト・インスタンスを生成します。
詳細は、第1.4.3.4項「SOAコンポジット・アプリケーションの自動テストの概要」および第7.6項「SOAコンポジット・アプリケーションのテストの自動化」を参照してください。

- ポリシー: このオプションを使用すると、ポリシーを表示し、SOAコンポジット・アプリケーションとの間でアタッチまたはデタッチできます。
詳細は、第1.4.3.2項「ポリシーの概要」および第7.7項「SOAコンポジット・アプリケーションのポリシーの管理」を参照してください。

監視

このオプションを選択すると、選択したSOAコンポジット・アプリケーションに関するパフォーマンス統計のサマリーが表示されます。

SOAデプロイ

このオプションを選択すると、このSOAコンポジット・アプリケーションのアンデプロイまたは再デプロイ、あるいは別のSOAコンポジット・アプリケーションのデプロイを実行できます。

詳細は、第7.1項「SOAコンポジット・アプリケーションのデプロイ」を参照してください。

エクスポート

このオプションを使用すると、デプロイされたSOAコンポジット・アプリケーションをJARファイルにエクスポートできます。

詳細は、第7.8項「デプロイ済のSOAコンポジット・アプリケーションのエクスポート」を参照してください。

サービスのテスト

このオプションを選択すると、このデプロイ済SOAコンポジット・アプリケーションのインスタンスを「Webサービスのテスト」ページから手動で起動できます。

詳細は、第8.1項「SOAコンポジット・アプリケーションのテスト・インスタンスの起動」を参照してください。

SOAインフラストラクチャ

このオプションを選択すると、SOAインフラストラクチャのホーム・ページに移動します。

SOAインフラストラクチャの共通プロパティ

このオプションを選択すると、監査レベルの表示と設定、SOAコンポジット・アプリケーション・インスタンスの状態のキャプチャ、受信メッセージのペイロード検証の有効化、UDDIレジストリ・プロパティの設定、コールバック・サーバーとサーバーURLの指定、データソースJNDIロケーションの表示、致命的でない接続の再試行回数の設定、Webサービス・バインディング・プロパティの設定、およびページのロード効率の最適化が可能です。通常、SOAコンポジット・アプリケーションは、SOAインフラストラクチャ・レベルで定義された設定を継承します。

詳細は、第3.1項「SOAインフラストラクチャ・プロパティの構成」を参照してください。

サービス/参照プロパティ

このオプションを選択すると、SOAコンポジット・アプリケーションに含まれるサービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントに対してWSDLファイル・プロパティを構成できます。

詳細は、第36.1項「サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントのプロパティの構成」を参照してください。

一般情報

このオプションを選択すると、Oracle Enterprise Manager Fusion Middleware Controlのバージョン、Oracleホーム、Oracleインスタンス、コンポジットがデプロイされているパーティションなど、このSOAコンポジット・アプリケーションに関する一般的な詳細が表示されます。

6. ナビゲータでSOAコンポジット・アプリケーションの名前を右クリックします。表示されたメニューでは、「SOAコンポジット」メニューに表示されている同じ管理オプションにアクセスできます。

2.2.3 パーティションのホーム・ページおよびメニューからの移動

SOAインフラストラクチャの特定のパーティションの管理タスクに移動できます。

パーティションのホーム・ページおよびメニューから移動する手順は、次のとおりです。

1. ナビゲータで、「SOA」→「soa-infra」の順に開きます。

2. 特定のパーティションをクリックします。

3. ページ上部で「SOAパーティション」メニューを選択します。

これらの管理オプションを使用すると、次のタスクを実行できます。

オプション

説明

ホーム

このオプションを選択すると、パーティションのホーム・ページに関する次の詳細が表示されます。

- このパーティション内のSOAコンポジット・アプリケーション。

- このパーティション内のSOAコンポジット・アプリケーションのステータス(「稼働中」(オン)または「停止中」(オフ))。

- このパーティション内のSOAコンポジット・アプリケーションのモード(「アクティブ」または「リタイア」)。

- このパーティション内のSOAコンポジット・アプリケーションのインスタンスと失敗したインスタンスの合計数。

- このパーティション内のSOAコンポジット・アプリケーションが、最後にデプロイ、再デプロイまたは再構成された時刻。

コンポジット制御

このオプションを選択すると、次の一括ライフ・サイクル管理タスクが表示されます。

- 「すべて起動」: このパーティション内のすべてのコンポジットを起動するダイアログが起動されます。

- 「すべてシャットダウン」: このパーティション内のすべてのコンポジットをシャットダウンするダイアログが起動されます。

- 「すべてアクティブ化」: このパーティション内のすべてのコンポジットをアクティブ化するダイアログが起動されます。

- 「すべてリタイア」: このパーティション内のすべてのコンポジットをリタイアさせるダイアログが起動されます。

これらのコンポジットの状態の詳細は、第7.5.1項「SOAインフラストラクチャ・レベルでのすべてのアプリケーションの状態管理」を参照してください。

SOAデプロイ

このオプションを選択すると、次の管理タスクが表示されます。

- 「このパーティションにデプロイ」: コンポジットを選択してこのパーティションにデプロイするために、「SOAコンポジットのデプロイ」ウィザードを起動します。

- 「このパーティションからすべてアンデプロイ」: このパーティション内のすべてのコンポジットをアンデプロイするダイアログが起動されます。

- 「再デプロイ」: コンポジットを選択してこのパーティションに再デプロイするために、「SOAコンポジットの再デプロイ」ウィザードを起動します。

詳細は、第7章「SOAコンポジット・アプリケーションのデプロイおよび管理」を参照してください。

「このパーティションの削除」

このオプションを選択すると、このパーティションを削除するダイアログが起動されます。パーティションが削除される前に、パーティション内のすべてのコンポジットが自動的にアンデプロイされます。

一般情報

このオプションでは、パーティション(ターゲット)名、Oracle Fusion Middlewareのバージョン、Oracle Fusion Middlewareのホーム・ディレクトリ、ドメインのホーム・ディレクトリ、ホスト名、デプロイされたサーバーなど、パーティションについての一般的な詳細が表示されます。

4. ナビゲータでパーティションの名前を右クリックします。表示されたメニューでは、「SOAパーティション」メニューに表示されている同じ管理オプションにアクセスできます。

注意:

パーティションのホーム・ページには、SOAコンポジット・アプリケーションのホーム・ページにある関連トピック・メニューからもアクセスできます。

パーティションの詳細は、第1.4.3.5項「SOAインフラストラクチャのパーティションの概要」と第7.9項「SOAコンポジット・アプリケーションのパーティションへのグループ化」を参照してください。

2.2.4 デプロイ済Java EEアプリケーションへの移動

Oracle SOA Suiteコンポーネントおよび(インストールされている場合)Oracle BPM Suiteコンポーネントに関連したデプロイ済Java EEアプリケーションに移動できます。これは、SOAシステム・コンポーネント(テクノロジ・アダプタ、Oracle B2B、Oracle BPM Worklistなど)を表すJava EEアプリケーションです。Webサービスをデプロイし、そのサービスがここにリストされていることを確認できます。また、個々のアプリケーション(例: デプロイ済Webサービス)をクリックし、WARファイルとEARファイルを管理してここからデプロイできることをテストできます。独自のJava EEアプリケーションをデプロイしている場合は、それらもここに表示されます。

デプロイ済Java EEアプリケーションに移動する手順は、次のとおりです。

1. ナビゲータで、「アプリケーションのデプロイ」を開きます。

2. 「内部アプリケーション」を開きます。

3. 「リソース・アダプタ」を開きます。
Oracle SOA SuiteおよびOracle BPM Suiteコンポーネントに関連したデプロイ済Java EEアプリケーションのリストが表示されます。

4. 特定のアプリケーションをクリックします(この例では、worklistappが選択されています)。
ページに、アプリケーションのパフォーマンスに関する詳細が表示されます。

Oracle Enterprise Manager Fusion Middleware Controlにはデプロイ済モジュールすべてのURLが表示されますが、このページからは直接起動できません。

2.2.5 Oracle WebLogic Server管理コンソールおよび他のページへの移動

Oracle Enterprise Manager Fusion Middleware Controlのほとんどのページの右上隅には、「関連リンク」メニューがあります。現在の場所に応じて、このメニューのコンテキストは、関連ページへのリンクを示すように変更されます。たとえば、BPELプロセス・サービス・エンジンのページを参照している場合、「関連リンク」メニューには、SOAインフラストラクチャのホーム・ページ、BPELプロセス構成プロパティのページ、Oracle WebLogic Server管理コンソールへの各リンク、およびサービス・エンジン・ログ・ファイルに関するページへのリンクが表示されます。図2-1に詳細を示します。また、BPELサービス・エンジン・ページ上部の「soa-infra」をクリックすると、SOAインフラストラクチャのホーム・ページに直接移動することもできます。

図2-1 SOAコンポジット・アプリケーションの「関連リンク」メニュー

SOAコンポジット・アプリケーションのサービス・コンポーネントのページを参照している場合は、いくつかのナビゲーション・メニューおよびリンクを使用できます。

- 「関連リンク」メニューには、SOAインフラストラクチャのホーム・ページおよび適用可能なサービス・エンジンのホーム・ページへのリンクが表示されます。図2-2に詳細を示します。

- SOAコンポジット・アプリケーション内を移動すると、ブレッドクラムが左上隅に表示されます。

- SOAコンポジット・アプリケーション・ページ(サービス・コンポーネントのページを含む)内では、SOAインフラストラクチャのページへのリンクも、「SOAインフラストラクチャ」メニューを介して引き続き使用できます。このメニューは、ナビゲータの上にある「ファーム」メニューの横に表示されます。たとえば、このメニューを使用すると、特定のBPELサービス・コンポーネントのホーム・ページから、BPELサービス・エンジンの構成プロパティのページに直接移動できます。

- ページ上部の名前をクリックすると、親のページに移動できます。たとえば、サービス・コンポーネント・ページの最上部にあるコンポジットの名前をクリックすると、そのコンポーネントが含まれているコンポジットに移動できます。

図2-2 SOAコンポジット・アプリケーションのサービス・コンポーネントの「関連リンク」メニュー

サービス・エンジン、SOA管理(「SOAインフラストラクチャの共通プロパティ」ページなど)、およびビジネス・イベントの各ページでは、「関連項目」リストからOracle WebLogic Server管理コンソールにアクセスできます。「WebLogic Serverコンソール」を選択すると、新しいブラウザ・ページが開き、Oracle WebLogic Server管理コンソールのログイン・プロンプトが表示されます。Oracle Enterprise Manager Fusion Middleware Controlの現在のページは、そのまま表示されます。ログイン後は、ホーム・ページが表示されます。図2-3に詳細を示します。

図2-3 Oracle WebLogic Server管理コンソール

次のOracle SOA Suiteタスクは、Oracle WebLogic Server管理コンソールから実行できます。

- コンポジット参照に対するアダプタ接続の構成。

- アダプタで使用するデータソースの作成と管理。

- アダプタで使用するJMSリソースの作成と管理。

- SOAインフラストラクチャ・データソースの管理(例: 接続プールの設定変更)。

- ヒューマン・ワークフロー・ユーザーのセキュリティの管理。

- Oracle WebLogic Serverトランザクション(JTA)の設定(例: トランザクション・タイムアウト値)の管理。

- ヒューマン・タスク・ユーザー・インタフェースのデプロイ。

2.2.6 ファーム・ホーム・ページからSOAインフラストラクチャまたはSOAコンポジット・アプリケーションのホーム・ページへの移動

SOAインフラストラクチャ、特定のSOAパーティションまたは特定のSOAコンポジット・アプリケーションのホーム・ページには、ファーム・ホーム・ページからアクセスできます。

SOAインフラストラクチャまたはSOAコンポジット・アプリケーションのホーム・ページに移動するには、次の手順を実行します。

1. ファーム・ホーム・ページの「デプロイメント」セクションで、soa-infraまたは特定のSOAコンポジット・アプリケーションをクリックします。

選択した項目のホーム・ページが表示されます。

2.3 システムMBeanブラウザへの移動

Oracle SOA Suiteの構成パラメータの一部はOracle Enterprise Manager Fusion Middleware Controlのプロパティ・ページに公開されません。ただし、これらのパラメータはシステムMBeanブラウザを使用して変更できます。

マネージドBean (MBean)は、アプリケーション、サービス、コンポーネント、デバイスなど、分散環境におけるJava Management Extensions (JMX)管理可能リソースに相当するJavaオブジェクトです。Oracle Enterprise Manager Fusion Middleware Controlには、特定の監視および構成タスクを実行するMBeanを管理するためのシステムMBeanブラウザが用意されています。

この項では、システムMBeanにアクセスする各種の方法を説明し、個別のSOAインフラストラクチャおよびサービス・コンポーネントのプロパティを編集する方法を説明する参照ドキュメントを紹介します。

システムMBeanブラウザについての一般的な情報は、『Oracle Fusion Middleware管理者ガイド』のFusion Middleware ControlのMBeanブラウザの使用のスタート・ガイドを参照してください。

2.3.1 メイン・ページからのシステムMBeanブラウザへのアクセス

「システムMBeanブラウザ」メイン・ページに直接アクセスできます。このメイン・ページから、システムMBeanブラウザのすべてのプロパティにアクセスできます。ナビゲーション・ツリーを使用して管理するセクションに移動する必要があります。

メイン・ページからシステムMBeanブラウザにアクセスする手順は次のとおりです。

1. ナビゲータで「soa-infra」を右クリックします。

2. 「管理」→「システムMBeanブラウザ」を選択します。
「システムMBeanブラウザ」が表示されます。

3. 「アプリケーション定義のMBeans」まで下にスクロールします。

4. 「アプリケーション定義のMBeans」を展開して、特定のセクションにアクセスします。

このセクションには下記をはじめとして多くのOracle SOA Suiteコンポーネントのプロパティが格納されています。

- oracle.as.soainfra.bpel

- oracle.as.soainfra.bpm

- oracle.as.soainfra.bpmn

- oracle.as.soainfra.config

5. 構成が必要なプロパティが含まれるコンポーネントを展開します。たとえば、「oracle.as.soainfra.config」→「Server: server_name」→「BPELConfig」→「bpel」と展開します。また、この場所には、第2.3.2項「「コンポーネント・プロパティ」ページからのシステムMBeanブラウザへのアクセス」の手順3で説明されている「詳細BPEL構成プロパティ」ショートカットをクリックしてもアクセスできます。

『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』には、メイン・ページからシステムMBeanブラウザに移動してプロパティを構成する例が多数紹介されています。ここではいくつかの例を紹介します。

- BPELプロセスについては、第13.6項「BPELプロセス・サービス・コンポーネント・レベルでの監査レベルの設定」を参照してください。

- Oracle Mediatorについては、第16.1項「Oracle Mediatorサービス・エンジン・プロパティの構成」を参照してください。

- ヒューマン・ワークフローについては、第21.7項「Oracle BPM Worklistタスクに対するオート・リリース・タイマーのグローバルな無効化」を参照してください。

- BPMNプロセスについては、第39.2.2項「タスク2: Oracle BPMサーバー上でのOracle BAMの有効化」を参照してください。

2.3.2 「コンポーネント・プロパティ」ページからのシステムMBeanブラウザへのアクセス

システムMBeanブラウザには、Oracle SOA Suiteコンポーネントのプロパティ・ページの様々なメニューからもアクセスできます。これらのショートカットを使用すると、「アプリケーション定義のMBeans」グループのoracle.as.soainfra.configセクションなど、MBeanツリーの個別のセクションに直接アクセスできます。これにより、SOAインフラストラクチャおよびサービス・コンポーネントの共通プロパティの多くに迅速にアクセスできます。

コンポーネントのプロパティ・ページからシステムMBeanブラウザにアクセスする手順は次のとおりです。

1. ナビゲータで「soa-infra」を右クリックします。

2. 「SOA管理」を選択します。

3. システムMBeanブラウザのプロパティの管理対象の適切なコンポーネントを選択し、ページを下にスクロールしてショートカットにアクセスします。

選択...

スクロール先およびクリック対象

参照先

共通プロパティ(SOAインフラストラクチャ)

詳細SOAインフラ拡張構成プロパティ

第3.1項「SOAインフラストラクチャ・プロパティの構成」

BPELプロパティ

詳細BPEL構成プロパティ

第13.1項「BPELプロセス・サービス・エンジン・プロパティの構成」

メディエータ・プロパティ

詳細メディエータ構成プロパティ

第16.1項「Oracle Mediatorサービス・エンジン・プロパティの構成」

「ワークフロー・プロパティ」→「メーラー」タブ

詳細ワークフロー通知構成プロパティ

第21.1項「ヒューマン・ワークフロー通知プロパティの構成」

「ワークフロー・プロパティ」→「タスク」タブ

詳細ワークフロー・タスク・サービス構成プロパティ

第21.3項「ヒューマン・ワークフロー・タスク・サービス・プロパティの構成」

B2Bサーバー・プロパティ

詳細B2B構成プロパティ

第32.1項「Oracle B2Bサーバーのプロパティの構成」

BPMNプロパティ

注意: このオプションはOracle BPM Suiteがインストールされている場合のみ表示され選択可能になります。

詳細BPMN構成プロパティ

第39.1項「BPMNプロセス・サービス・エンジン・プロパティの構成」

たとえば、「詳細BPEL構成プロパティ」リンクを選択すると、システムMBeanブラウザの「oracle.as.soainfra.config」→「Server: server_name」→「BPELConfig」→「bpel」セクションに自動的に移動します。構成するプロパティは、ページの右側に表示されます。

2.4 Oracle Enterprise Manager Fusion Middleware Controlからのログアウト

この項では、Oracle Enterprise Manager Fusion Middleware Controlのログアウト方法について説明します。

Oracle Enterprise Manager Fusion Middleware Controlからログアウトするには、次の手順を実行します。

1. ログアウトについては、次の詳細に注意してください。

- 複数のページ(例: ヘルプ・ダイアログ、トポロジ・ビューア、フローのトレース)が開いている場合は、いずれかのページからログアウトすると、開いているすべてのページでアプリケーション全体からログアウトします。

- 未保存の構成変更がある状態でログアウトした場合、警告メッセージは表示されず、変更は失われます。

2. 任意のページの右上隅で、「ログアウト」リンクをクリックします。

第III部

SOAインフラストラクチャの管理

この部では、SOAインフラストラクチャの管理方法について説明します。

次の章で構成されています。

- 第3章「SOAインフラストラクチャの構成」

- 第4章「SOAインフラストラクチャの監視」

3 SOAインフラストラクチャの構成

この章では、SOAインフラストラクチャのプロパティ(監査レベル、コンポジット・インスタンスの状態、ペイロードの検証を含む)の構成方法について説明します。これらのプロパティ設定は、SOAインフラストラクチャで実行されているすべてのSOAコンポジット・アプリケーションに適用できます。また、ローカルの最適化の構成方法、管理対象サーバーとSOAインフラストラクチャの起動と停止方法、およびグローバル・トークン変数の作成方法についても説明します。

この章では、次の項目について説明します。

- 第3.1項「SOAインフラストラクチャ・プロパティの構成」

- 第3.2項「管理対象サーバーとSOAインフラストラクチャの停止と起動」

- 第3.3項「システムMBeanブラウザでのSOAインフラストラクチャ・サーバーURLプロパティ・ポートの変更」

- 第3.4項「ログ・ファイルの構成」

- 第3.5項「カスタムXAドライバのサポートのためのドライバ名の変更」

- 第3.6項「XAデータ・ソースへのデフォルト以外のXAトランザクション・タイムアウト値の指定」

- 第3.7項「ローカルの最適化の構成」

- 第3.8項「複数のSOAコンポジット・アプリケーションのグローバル・トークン変数の管理」

詳細は、第1.2.1項「SOAインフラストラクチャ・アプリケーションの概要」を参照してください。

3.1 SOAインフラストラクチャ・プロパティの構成

SOAインフラストラクチャの次のプロパティを構成できます。

- 監査レベル

- キャプチャするコンポジット・インスタンスの状態

- ペイロードの検証

- Universal Description, Discovery, and Integration (UDDI)レジストリ

- コールバック・サーバーとサーバーURL

- ページ上の最近のインスタンス数、フォルト数および件数のメトリックの表示

- 最新のインスタンスおよびフォルトの取得の検索基準

- Java Naming and Directory Interface (JNDI)データソース

- Webサービス・バインディング・プロパティ

このレベルで設定したプロパティは、コンポジット・アプリケーションまたはサービス・エンジン・レベルで異なる監査レベル値を明示的に設定したコンポジットを除いて、すべてのデプロイ済SOAコンポジット・アプリケーションに影響を与えます。

SOAインフラストラクチャの追加の拡張プロパティは、システムMBeanブラウザを使用して構成できます。これらのプロパティには、この項で説明するように、「共通プロパティ」ページの「詳細SOAインフラ拡張構成プロパティ」リンクからアクセスするか、または「SOAインフラストラクチャ」メニューから「管理」→「システムMBeanブラウザ」→「アプリケーション定義のMBean」→「oracle.as.soainfra.config」の順に選択してアクセスできます。

SOAインフラストラクチャ・プロパティは、SOAインフラストラクチャに関連付けられたOracle Metadata Services (MDS)リポジトリに格納されています。Oracle SOA Suiteの場合、MDSリポジトリはデフォルトでコンテンツがデータベースに格納されるように構成されています。

SOAインフラストラクチャ・プロパティを構成する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

SOAコンポジットのメニューから...

1. 「SOA管理」→「共通プロパティ」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「SOA管理」→「共通プロパティ」の順に選択します。

1. 「SOAインフラストラクチャの共通プロパティ」を選択します。

「SOAインフラストラクチャの共通プロパティ」ページには、次のプロパティが表示されます。

注意:

一部のプロパティ・フィールドには、緑と赤の矢印アイコンが表示されています。これらのプロパティ(例: Server URL)を変更する場合は、SOAインフラストラクチャを再起動する必要があります。

次の表に、ページの上部に表示されるプロパティの説明を示します。

要素

説明

監査レベル

メッセージ・トラッキング・インフラストラクチャによって収集する情報のレベルを選択します。この情報は、SOAインフラストラクチャに関連付けられたインスタンス・データ・ストア(データベース)に収集されます。この設定は、ログ・ファイルに書き込まれる内容には影響を与えません。

- オフ: コンポジット・インスタンスのトラッキング情報とペイロード・トラッキング情報は収集されません。コンポジット・インスタンスはこれ以上作成できません。また、ロギングは実行されません。Oracle Enterprise Manager Fusion Middleware Controlでロギングとインスタンスの表示を無効にすると、インスタンスの処理でパフォーマンスが少し向上することがあります。インスタンスは作成されますが表示されません。

- 開発: コンポジット・インスタンスのトラッキングとペイロード詳細のトラッキングの両方を有効にします。ただし、この設定はパフォーマンスに影響を与える可能性があります。このレベルは通常、テストおよびデバッグする際に便利です。

- 本番: コンポジット・インスタンスのトラッキングは収集されますが、Oracle Mediatorサービス・エンジンではペイロード詳細が収集されず、BPELプロセス・サービス・エンジンではassignアクティビティのペイロード詳細が収集されません(その他のBPELアクティビティのペイロード詳細は収集されます)。このレベルは、通常の本番操作に最適です。

SOAコンポジット・アプリケーションの監査レベルを下げること、およびOracle SOA Suiteスキーマへの書込みの詳細は、第B.2.3項「監査レベルの低減」を参照してください。

コンポジット・インスタンスの状態をキャプチャ

選択すると、SOAコンポジット・アプリケーション・インスタンス状態が取得されます。このオプションを有効化すると、インスタンス処理中に追加の実行時オーバーヘッドが発生する場合があります。このオプションでは、実行中のインスタンスのトラッキングが別々に実行されます。すべてのインスタンスは、実行中か未実行のいずれかとして取得されます。この情報は、後でSOAインフラストラクチャおよびSOAコンポジット・アプリケーションのコンポジット・インスタンス表の「状態」列に表示され、次のようになります。

- 合計インスタンス数に対する実行中のインスタンス数が表示されます。

- 実行中のインスタンスのみを表示するように制限することもできます。

有効な状態は「実行中」、「完了」、「失敗」、「リカバリが必要」、「失効」、「終了」および状態使用不可です。

「実行中」および「完了」状態は、このチェック・ボックスが選択されている場合のみキャプチャされます。選択されていない場合、状態は「不明」に設定されます。これらの状態を条件付きでキャプチャする主な理由は、SOAインフラストラクチャのランタイムにおけるパフォーマンス・オーバーヘッドを軽減するためです。

注意: このプロパティを無効にしてSOAコンポジット・アプリケーションの新規インスタンスを作成すると、新規インスタンスが作成されます。ただし、このインスタンスは、コンポジット・アプリケーションの「ダッシュボード」の表にページ実行中、フォルト、失効、終了、完了、またはリカバリが必要として表示されません。これは、インスタンスのコンポジット状態をキャプチャする処理がパフォーマンスに影響を与えるためです。

たとえば、このプロパティを有効にし、「Webサービスのテスト」ページでSOAコンポジット・アプリケーション・インスタンスを作成した場合、新規インスタンスはコンポジット・アプリケーションの「ダッシュボード」ページに表示されます。「ダッシュボード」ページで「実行中のインスタンスのみ表示」をクリックすると、インスタンスは「実行中」と表示されます。次に、このプロパティを無効にし、同じコンポジット・アプリケーションの別のインスタンスを作成した場合は、新規の実行中のインスタンスが作成されます。ただし、「実行中のインスタンスのみ表示」を選択すると、新規インスタンスは実行中のインスタンスの表にリストされません。

さらに、実行中のインスタンスを終了するには、インスタンスがある状態(実行中、失敗など)にあることが必要です。その結果、SOAコンポジット・アプリケーションの「インスタンス」ページで「中断」ボタンがアクティブになります。インスタンスを作成する前にこのチェック・ボックスを有効にしなかった場合、「中断」ボタンはアクティブにならないため、インスタンスを終了できません。

インスタンスの状態トラッキングを無効化して監査レベルを下げることの詳細は、第B.2.3項「監査レベルの低減」を参照してください。

ペイロードの検証

受信メッセージと送信メッセージの検証を有効にする場合に選択します。スキーマに準拠しないペイロード・データが捕捉され、フォルトとして表示されます。

2. 使用環境に適した変更を行います。
「UDDIレジストリ・プロパティ」セクションには、次のプロパティが表示されます。SOAインフラストラクチャで実行されているSOAコンポジット・アプリケーションは、UDDIレジストリに統合できます。このUDDIレジストリでは、公開サービスの検索、およびサービスに関するメタデータの管理(セキュリティ、トランスポートまたはサービスのクオリティ)を実行するための標準ベースの基盤が提供されます。ニーズを満たす公開サービスを参照して選択できます。

「ユーザー」および「パスワード」プロパティは、UDDIレジストリが保護されている場合に適用できます。これらのプロパティは、Oracle Service Registry (OSR)のセキュアHTTP構成にのみ使用されます。「照会URL」プロパティはパブリックです。

要素

説明

例

照会URL

問い合せるマスター・レジストリのURLを入力します。このURLでスレーブ・レジストリ自体を参照しないでください。参照すると、データの一部を失う可能性があります。照会URLによって、完全標準のUDDIバージョン3構造が取得されます。これは、UDDIレジストリ接続の作成ウィザードで指定したUDDI照会URLと同じです。

http://master.mycompany.com:8888/registry/uddi/inquiry

ユーザー

レジストリ照会ユーザーを入力します。

admin

パスワード

マスター・レジストリ照会ユーザーのパスワードを入力します。

問題のないセキュリティ・プラクティスを使用したパスワードを入力してください。

エンドポイント参照とサービス・キーの設定の詳細は、第36.1.3項「Oracle Service Registryと統合している場合のエンドポイント参照およびサービス・キーの変更」を参照してください。

3. 使用環境に適した変更を行います。
「サーバーURL」セクションには、次のプロパティが表示されます。ここでプロパティを明示的に設定しない場合、プロパティ値は実行時にOracle WebLogic Serverクラスタ、Webサーバーまたはローカル・サーバーのプロパティを問い合せて決定されます。

要素

説明

コールバック・サーバーURL

コールバック・サーバーURLを入力します。この設定は、SOAコンポジット・アプリケーション・サービスおよび参照コールバックのすべてに適用されます。通常、この設定の書式は、http://host:portで、サービス・コール先からコール元への非同期送信に使用されるSOAPサービスURL (例: http://host:port/endpoint-context-uri)の構築に使用されます。

サーバーURL

サーバーURLを入力します。このURLは、具体的なWSDLファイルでサービスのSOAPアドレスの一部として公開されます。

注意: 10.1.xリリースでは、optSoapShortcutプロパティを使用してSOAPの最適化を手動で構成していました。リリース11gでは、SOAPの最適化は自動的に構成されます。したがって、11gにアップグレードし、既存のアプリケーションで最適化されたショートカットを使用する場合、最適化されたコールがアクティブになるのは、ホスト名の値(composite.xmlファイルのWSDL URLを参照)と「サーバーURL」の値が一致する場合のみです。両方の値をホスト名(例: myhost)または完全ドメイン名(例: myhost.domain.com)に設定してください。両方の値が一致しない場合は、最適化されたローカル・コールではなく、通常のSOAPコールが実行されます。

ローカルの最適化の詳細は、第3.7項「ローカルの最適化の構成」を参照してください。

注意:

「コールバック・サーバーURL」および「サーバーURL」の値を変更する場合は(たとえば、テスト環境から本番環境に移行する場合)、WSDLを再生成するためにOracle WebLogic Serverを再起動する必要があります。

4. 使用環境に適した変更を行います。
「データ表示オプション」セクションには、ページのロードにかかる時間を短縮するための、次のプロパティが表示されます。

注意:

これらのプロパティに対する変更は、このOracle Enterprise Managerインスタンスに関連付けられているすべてのSOAファームに影響します。

要素

説明

インスタンス数およびフォルト数をフェッチするメトリックを無効にします。この場合でも各メトリックは必要に応じて取得できます。

SOAインフラストラクチャ、SOAコンポジット・アプリケーション、サービス・エンジンおよびサービス・コンポーネントの「ダッシュボード」ページでインスタンス数およびフォルト数のメトリックの表示を無効にする場合に選択します。

これらのメトリックは、インスタンス数とフォルト数のメトリックが必要な場合にクリックしてこの情報を取得するためのリンクで置換されます。この設定により、ページのロードにかかる時間を短縮できます。

インスタンス数とフォルト数のメトリックを取得するリンクをクリックするとOracle Enterprise Manager Fusion Middleware Controlがタイムアウトする場合は、トランザクション・タイムアウト・プロパティの値を増やします。詳細は、第B.3.1項「接続タイムアウトの解決」および第B.7.1項「インスタンスおよびフォルトのメトリックのあるページのロードの最適化」を参照してください。

インスタンスとフォルトの表示を次に制限: 過去time_period

このチェック・ボックスを選択し、次のページに表示する最近のインスタンス、フォルトおよび数のメトリックを取得する期間を指定します。

- SOAインフラストラクチャ、SOAコンポジット・アプリケーション、サービス・エンジンおよびサービス・コンポーネントのダッシュボード・ページ

- SOAインフラストラクチャおよびサービス・エンジンの「デプロイ済コンポジット」ページ

- 「パーティション」ホーム・ページ

デフォルトで、このチェック・ボックスは選択済で、期間は24時間(1日)に設定されています。このチェック・ボックスが選択されていない場合は、最後のパージ以降のSOAインフラストラクチャにおけるインスタンスとフォルト(数のメトリックを含む)がすべて表示されます。

注意: Oracle Enterprise Manager Fusion Middleware Controlの複数のページおよび問合せのパフォーマンスに大きく影響するため、期間を設定することを強くお薦めします。

指定した期間は、フォルトを検索できるフォルト・ページの「フォルト時間の開始」フィールドおよびインスタンスを検索できる「インスタンス」ページの「開始時間: 自」フィールドにデフォルトで表示されます。

詳細は、第B.7.1項「インスタンスおよびフォルトのメトリックのあるページのロードの最適化」を参照してください。

5. 使用環境に適した変更を行います。

6. 「拡張」セクションを開きます。

「データソース」セクションには、次のプロパティが表示されます。データソースを使用すると、データベース・サーバーへの接続を取得できます。

要素

説明

例

サーバー・データ・ソースJNDI

サーバー・データソースのJNDIロケーションが表示されます。「構成」をクリックして、Oracle WebLogic Server管理コンソールのデータソース構成ページに進みます。このデータソースに対しては、グローバル・トランザクション・サポートを無効にする必要があります。

jdbc/SOALocalTxDataSource

サーバー・トランザクション・データ・ソースJNDI

サーバー・トランザクション・データソースのJNDIロケーションが表示されます。「構成」をクリックして、Oracle WebLogic Server管理コンソールのデータソース構成ページに進みます。グローバル・トランザクションのデータソースを構成する必要があります。

jdbc/SOADataSource

致命的でない接続の再試行回数

失敗するまでに致命的でない接続エラーを再試行できる最大回数を入力します。このタイプのエラーは、デハイドレーション・ストアでの接続エラー(Oracle Real Application Clustersのフェイルオーバー、データベース停止など)に対して発生します。

10

7. 使用環境に適した変更を行います。
「Webサービス・バインディング・プロパティ」セクションには、次のオプションが表示されます。

要素

説明

例

Oracle SSL暗号

Oracleでサポートされている暗号のリストを入力します。

暗号スイートは、データ送信に対してセキュリティを提供する一連のアルゴリズムです。SSL接続内でのデータの移動を可能にするには、使用する共通アルゴリズムについて、接続の両側がネゴシエーションする必要があります。

SSL_RSA_WITH_RC4_128_MD5

Oracle Walletパスワード

キーストア用のウォレット・パスワードを入力します。

問題のないセキュリティ・プラクティスを使用したパスワードを入力してください。

チャンクの使用

SOAP over HTTP配信のデータのチャンク化を有効にする場合に選択します。

- -

チャンク・サイズ

チャンク・サイズを指定します。値は999以下である必要があります。このサイズはSOAP over HTTP配信で使用され、バイト単位で指定します。

500

8. 使用環境に適した変更を行います。

9. 「適用」をクリックします。

10. プロパティを変更した後に元の値にリセットする場合は、「元に戻す」をクリックします。

11. 拡張パラメータを変更するには、「詳細SOAインフラ拡張構成プロパティ」をクリックします。これにより、「システムMBeanブラウザ」が開きます。表示されるプロパティの一部を次に示します。各プロパティには説明が記載されています。

- AuditConfig: BPELメッセージ・リカバリのステータス。このプロパティには、次のキーが含まれています。

- bpelRecoveryStatusキー: BPELプロセス・サービス・エンジンの「リカバリ」ページにリカバリを必要とするBPELメッセージが存在する場合、この設定によって「必須のBPELメッセージ・リカバリ」インライン警告メッセージが有効化され、「フローのトレース」ページの「トレース」表、およびSOAインフラストラクチャ、およびSOAコンポジット・アプリケーションのホーム・ページの最上部にリカバリ・アイコンが表示されます。デフォルトでこのキーは「All」に設定されています。このキーをOffに設定すると、メッセージ・リカバリ情報は表示されません。詳細は、次の項を参照してください。
- 第4.3項「SOAインフラストラクチャの最新のインスタンスとフォルト、およびデプロイ済コンポジットの監視」

- 第6.2項「SOAコンポジット・アプリケーションの最新のインスタンスとフォルトおよび拒否メッセージの監視」

- 第14.1項「BPELプロセス・サービス・コンポーネントの監査証跡とプロセス・フローの監視」

- excludeBpelMaxCreationTimeキー: リカバリが必要なメッセージを除外する期間を設定できます。詳細は、第4.3項「SOAインフラストラクチャの最新のインスタンスとフォルト、およびデプロイ済コンポジットの監視」を参照してください。

- bpelRecoveryAlertDurationInDaysキー: リカバリ可能BPELメッセージが最近7日間以内に作成されている場合にのみ、「必須のBPELメッセージ・リカバリ」インライン警告メッセージが表示されるように制限します。7日間のデフォルト設定は変更可能です。このプロパティは-1などの負の値や0に設定できません。このような場合、キーではデフォルト値(7日間)が使用されます。アラート・メッセージの無効化には、bpelRecoveryStatusキーを使用します。この期間値はフロー・トレース・アラート・メッセージには適用されません。

- CreateWSCallTrackingMBean: Webサービス・コールの経過時間を追跡するMBeanの作成を制御します。経過時間のしきい値を超えると、インシデントが作成されます。trueに設定した場合は、監視を作成できます。この設定は、SOAインフラストラクチャ内のすべてのSOAコンポジット・アプリケーションに適用されます。詳細は、第12.5項「監視および通知の作成」を参照してください。

- GlobalTxMaxRetry: 呼出し例外を再試行できる最大回数。

- GlobalTxRetryInterval: 呼出し例外の再試行間隔(秒数)。

- HttpProxyAuthRealm: HTTPプロキシ認証レルム。

- HttpProxyAuthType: HTTPプロキシ認証タイプ。

- HttpProxyHost: HTTPプロキシ・ホスト。

- HttpProxyPassword: 認証を必要とするHTTPプロキシのパスワード。

- HttpProxyPort: HTTPプロキシ・ポート番号。

- HttpProxyUsername: 認証を必要とするHTTPプロキシのユーザー名。

- HttpServerURL: WSDLファイルでプロセスのSOAPアドレスの一部として公開されるHTTPプロトコルURL。

- HttpsServerURL: WSDLファイルでプロセスのSOAPアドレスの一部として公開されるHTTPSプロトコルURL。

- KeystoreLocation: Oracle SOA Suiteキーストアへのパス。

- UddiCacheLifetime: UDDIエンドポイント・キャッシュの存続期間。

3.1.1 システムMBeanブラウザを使用した、インスタンス数とフォルト数のメトリックの取得の無効化

第3.1項「SOAインフラストラクチャ・プロパティの構成」で説明したように、「SOAインフラストラクチャの共通プロパティ」ページの「データ表示オプション」セクションでインスタンス数とフォルト数のメトリックの取得を無効にできます。「システムMBeanブラウザ」でこのプロパティを変更することもできます。

システムMBeanブラウザを使用して、インスタンス数とフォルト数のメトリックの取得を無効化する手順は、次のとおりです。

1. 「アプリケーション定義のMBean」→「emom.props」→「サーバー: AdminServer」→「アプリケーション: em」→「プロパティ」→「emoms.properties」の順に選択します。
emoms.propertiesは、「SOAインフラストラクチャの共通プロパティ」ページの「データ表示オプション」セクションでインスタンス数とフォルト数のメトリックのフェッチの無効化オプションをすでに変更している場合にのみ選択可能になることに注意してください。

2. 「属性」タブの「名前」列で「プロパティ」をクリックします。

3. 「値」列で、「Element_20」を展開します。

4. 「要素」列で、「false」と入力してメトリック取得を無効にします。

5. 「適用」をクリックします。

6. SOAインフラストラクチャを再起動します。この方法ではなく、「SOAインフラストラクチャの共通プロパティ」ページの「データ表示オプション」セクションでインスタンス数とフォルト数のメトリックのフェッチの無効化オプションを変更した場合は、再起動が不要です。

3.2 管理対象サーバーとSOAインフラストラクチャの停止と起動

メンテナンスまたは構成変更後の再起動のために、Oracle Enterprise Manager Fusion Middleware ControlでSOAインフラストラクチャを停止して起動できます。このことを行うには、SOAインフラストラクチャがインストールされている管理対象サーバーを停止して起動します。これにより、管理対象サーバーとSOAインフラストラクチャの両方が再起動されます。

注意:

- 11g リリース1 (11.1.1.4.0)からは、ナビゲータの「soa-infra」メニューからSOAインフラストラクチャを停止および起動できなくなりました。

- 管理サーバーのみが含まれ、管理対象サーバーが含まれない、開発者用の構成を使用することもできます。

サーバー起動時の問題の詳細は、第B.8項「サーバーのトラブルシューティング」を参照してください。

管理対象サーバーとSOAインフラストラクチャを起動および停止する手順は、次のとおりです。

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

「WebLogic Server」メニューから

ナビゲータの「WebLogicドメイン」フォルダから

1. コントロールを選択します。

1. 管理対象サーバー(たとえば、「soa_server1」)を右クリックします。

2. コントロールを選択します。

2. 管理対象サーバーとSOAインフラストラクチャを停止するには、「停止」を選択します。

3. 管理対象サーバーとSOAインフラストラクチャの停止の確認が表示されたら、「OK」をクリックします。

4. 停止の完了を待ちます。

5. 管理対象サーバーとSOAインフラストラクチャを起動するには、「起動」を選択します。

ノード・マネージャを使用した管理対象サーバーの停止および起動の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverノード・マネージャ管理者ガイド』を参照してください。

WLSTコマンドを使用した管理対象サーバーの起動および停止の詳細は、『Oracle Fusion Middleware管理者ガイド』を参照してください。

3.2.1 SOAインフラストラクチャ起動初期化の完了の待機

SOAインフラストラクチャは、起動後、すべてのデプロイ済コンポジットがロードされるまで受信リクエストを管理するために完全には初期化されない場合があります。そのため、Oracle Enterprise Manager Fusion Middleware Controlの一部のページに表示されるレスポンス・メトリックは、実際のステータスを反映していない可能性があります。このことは、SOAインフラストラクチャが複数の管理対象サーバーおよび多数のデプロイ済コンポジットを持つクラスタ内にある場合に最も顕著になります。

初期化ステージ中、Oracle Enterprise Manager Fusion Middleware Controlでは、コンポジット・デプロイメント、コンポジット・アンデプロイメントなどの操作を、これらの操作が正常に完了しなくても、実行することができます。かわりに、表3-1に示すOracle Enterprise Manager Fusion Middleware Controlのページの上部に警告メッセージが表示されます。このメッセージが表示されている間は、コンポジット・デプロイメント、コンポジット・アンデプロイメントなどの操作を実行しないでください。初期化が完了すると、メッセージは表示されなくなります。このことは、ページをリフレッシュするとわかります。その後、操作を実行できます。

表3-1 SOAインフラストラクチャの初期化メッセージ

表示される警告メッセージ

上部にメッセージが表示されるページ

Initializing SOA
Even though the soa-infra target is up, some SOA
Fabric components and composite applications are
still loading. You may need to allow some time for
the initialization to complete, and later click the
Refresh Page icon. It is not adivsable to execute
any operations on this soa-infra until this warning
goes away.

- 「SOAインフラストラクチャ」ホーム・ページ

- SOAコンポジット・アプリケーションのホーム・ページ

- 「パーティションの管理」ページ

- 「パーティション」ホーム・ページ

3.2.2 SOAコンポジット・アプリケーションの状態およびSOAインフラストラクチャの停止

SOAインフラストラクチャの停止後、SOAコンポジット・アプリケーションの状態は、コンポジットが停止していることを示すように更新されません。コンポジットにアクセスしようとすると、コンポジット詳細を取得できない旨のエラー・メッセージが表示されます。

soa-infra runtime connection error  An error happened while connecting to
soa-infra runtime at  t3://152.61.150.106:8001/soa-infra.

このメッセージによって、システム内で別の問題が発生していると考える可能性があります。しかし、この場合はそうではありません。

このメトリックは、コンポジットが有効かどうか、SOAインフラストラクチャの起動に依存しているかどうかを示すため、これらのコンポジットの状態は「稼働中」また、場合によっては「保留」と表示されます。さらに、クラスタ内の他の管理対象サーバーではコンポジットは依然としてアクティブで、リクエストを受信できます。

3.2.3 リタイアされたコンポジットがアクティブ化されているときは、SOAインフラストラクチャを再起動しても、エンドポイントがアクティブ化されない

アダプタ・エンドポイントがあるSOAコンポジット・アプリケーションがリタイア状態にある場合は、次のアクションを実行した場合にエンドポイントはアクティブになりません。

- SOAインフラストラクチャの再起動

- SOAコンポジット・アプリケーションのアクティブ化

これは、ファイルやレコードなどがエンドポイント・アダプタによって取得されないためです。回避策として、SOAインフラストラクチャの再起動後にSOAコンポジット・アプリケーションを再デプロイします。

3.2.4 cwallet.ssoにSOAマップが含まれている場合に、SOAインフラストラクチャの起動が失敗する

cwallet.ssoにSOAマップがある場合は、SOAインフラストラクチャの起動を試行すると、次のようなエラー・メッセージが表示されます。

Caused By: java.security.UnrecoverableKeyException: Password verification
failed
at
sun.security.provider.JavaKeyStore.engineLoad(JavaKeyStore.java:769)
at
sun.security.provider.JavaKeyStore$JKS.engineLoad(JavaKeyStore.java:38)
at java.security.KeyStore.load(KeyStore.java:1185)
at oracle.j2ee.ws.saaj.util.SSLUtil.loadKeyStore(SSLUtil.java:73)
at
oracle.j2ee.ws.saaj.util.SSLUtil.getKeyManagerFactory(SSLUtil.java:88)
at oracle.j2ee.ws.saaj.util.SSLUtil.getKeyManagers(SSLUtil.java:97)
at
oracle.j2ee.ws.saaj.util.SSLUtil.createSSLSocketFactory(SSLUtil.java:50)
at
oracle.integration.platform.common.SSLSocketFactoryManagerImpl.getSSLSocketFac
tory(SSLSocketFactoryManagerImpl.java:58)
at oracle.fabric.common.wsdl.WSDLManager.init(WSDLManager.java:356)
at oracle.fabric.common.wsdl.WSDLManager.<init>(WSDLManager.java:101)
at
oracle.fabric.common.metadata.MetadataManagerImpl.getWSDLManager(MetadataManag
erImpl.java:283)
at
oracle.fabric.composite.model.CompositeModel.getWSDLManager(CompositeM

この問題を解決する手順は、次のとおりです。

1. 次のいずれかのアクションを実行します。

- cwallet.ssoでSOAマップを削除します。

- $DOMAIN_HOME/config/fmwconfig/default-keystore.jksを削除します。Oracle Web Services Manager (OWSM)でこのファイルが使用されます。

2. SOAインフラストラクチャを再起動します。

3.3 システムMBeanブラウザでのSOAインフラストラクチャ・サーバーURLプロパティ・ポートの変更

第3.1項「SOAインフラストラクチャ・プロパティの構成」で説明されているように、「SOAインフラストラクチャの共通プロパティ」ページ以外に、Oracle Enterprise Manager Fusion Middleware Controlの「システムMBeanブラウザ」でSOAインフラストラクチャの「ServerURL」プロパティ・ポートを変更することもできます。

ポートを変更するときは、次の点に注意してください。

- SOAインフラストラクチャと管理対象のOracle WebLogic Serverのポート番号が異なる場合は、Oracle BPM Worklistに接続しようとするとConnectExceptionエラーが発生します。これらのポート番号が一致していることを確認してください。

- Oracle WebLogic Server管理コンソールからSOAインフラストラクチャのポートを変更することはできません。Oracle WebLogic Server管理コンソールからは、管理対象のOracle WebLogic Serverのポートのみを変更できます。

SOAインフラストラクチャのポートを変更する手順は、次のとおりです。

1. 「SOAインフラストラクチャ」メニューから、「管理」→「システムMBeanブラウザ」の順に選択します。

2. 「アプリケーション定義のMBean」で、「oracle.as.soainfra.config」→「サーバー: server_soa」→「SoaInfraConfig」→「soa-infra」の順に開きます。
server_soaは、インストール後の構成で指定したサーバーの名前です。デフォルトでは、この名前は「soa_server1」です。

3. 「名前」列で「ServerURL」をクリックします。
「属性: ServerURL」ページが表示されます。

4. 「値」フィールドで、ポートを変更します。

5. 「適用」をクリックします。

6. Oracle WebLogic Server管理コンソールで、管理対象のOracle WebLogic Serverのポートを同じ値に変更します。
Oracle WebLogic Serverクラスタの前にロード・バランサを使用する環境では、「ServerURL」プロパティのホストとポートは、Oracle WebLogic Serverのホストとポートと異なっても構いません。これは、Oracle WebLogic Serverクラスタ内の管理対象サーバー間でロード・バランサがリクエストを分散するエンタープライズ・デプロイメント環境では一般的です。詳細は、『Oracle Fusion Middleware Oracle SOA Suiteエンタープライズ・デプロイメント・ガイド』を参照してください。

3.4 ログ・ファイルの構成

Oracle SOA Suiteのコンポーネントではログ・ファイルが生成され、起動と停止情報、エラー、警告メッセージ、HTTPリクエストに関するアクセス情報および追加情報を含むすべてのタイプのイベントを記録するメッセージが格納されます。

ログ・ファイルを構成する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ログ」→「ログ構成」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「ログ」→「ログ構成」の順に選択します。

「ログ構成」ページに、次の詳細が表示されます。

- 「ビュー」リスト。情報を表示するロガーのタイプを選択します。

- 永続: コンポーネントが起動するとアクティブになるロガー。このログ出力の構成詳細はファイルに保存され、ログ・レベルはコンポーネントの再起動後も維持されます。

- アクティブ・ランタイム: 実行時に自動的に作成され、特定の機能領域が実行されるとアクティブになるロガー(例: oracle.soa.b2b、oracle.soa.bpel)。このログ出力のログ・レベルはコンポーネントの再起動後は維持されません。

- ロガー名およびOracle Diagnostic Logging (ODL)レベルが表示された表で、ログ・ファイルに書き込む情報の量とタイプ、ログ・ファイル、およびログ・レベル状態を設定します。

2. このページで次のログ・ファイル・タスクを実行します。

1. 「ロガー名」列で、ロガー名を開きます。これによって、コンポーネント内の特定のロギング・レベルを指定できます。

2. 「Oracle Diagnostic Loggingレベル」列で、ログ・ファイルに書き込む情報のレベルとタイプを選択します。

3. 「ログ・ファイル」列で、ログ・ファイル構成を作成および編集する特定のログ・ファイルをクリックします。
ODLログ・ファイル、およびログ・ファイルに書き込むロギング情報のレベルとタイプの詳細は、『Oracle Fusion Middleware管理者ガイド』を参照してください。

3. 「ログ・ファイル」タブをクリックします。
このページを使用して、ログ・ファイル構成を作成および編集できます。ログ・ファイル構成には、ログ・メッセージが記録されるログ・ファイル、ログ・メッセージのフォーマット、使用されるローテーション・ポリシー、およびログ・ファイル構成クラスに基づく他のパラメータが含まれます。

ロギング・レベルおよび表示するOracle SOA Suiteログ・ファイルの設定の詳細は、B.1項「トラブルシューティングのためのロギング・レベルの設定」を参照してください。

3.4.1 ログ・ファイルのエンコーディング・プロパティの構成

soa-diagnostic.logファイルのoracle-soa-handlerログ・ハンドラ・プロパティには、SOA_Domain/config/fmwconfig/servers/server_soa/logging.xmlファイルに指定されるエンコーディング・プロパティがありません。かわりに、soa-diagnostic.logファイルにはオペレーティング・システムのデフォルトのエンコーディング・フォーマットで書き込まれます。このため、次の問題が発生する場合があります。

- ロギング情報はsoa-diagnostic.logにサーバーのデフォルトのエンコーディング・フォーマットで書き込まれるため、ASCII以外のエラー・メッセージは読み取れなくなる場合があります。

- Windowsオペレーティング・システムでは、デフォルトのエンコーディング・フォーマットで書き込むことによって、ASCII以外のデータが失われる場合があります。

この問題を回避するには、logging.xmlファイルで、oracle-soa-handlerログ・ハンドラ・プロパティに対して値UTF-8を指定します。

<?xml version='1.0'?>
<logging_configuration>
<log_handlers>
<log_handler name='wls-domain'
class='oracle.core.ojdl.weblogic.DomainLogHandler' level='WARNING'/>
<log_handler name='oracle-soa-handler'
class='oracle.core.ojdl.logging.ODLHandlerFactory'>
<property name='path' value='c:\soa1210.1411\user_
projects\domains\soa/servers/server_soa/logs/soa-diagnostic.log'/>
<property name='maxFileSize' value='10485760'/>
<property name='maxLogSize' value='104857600'/>
<property name='supplementalAttributes' value='J2EE_APP.name,J2EE_
MODULE.name,WEBSERVICE.name,WEBSERVICE_PORT.name,composite_instance_id,component_
instance_id,composite_name,component_name'/>
<property name='encoding' value='UTF-8'/>
</log_handler>
</log_handlers>
...

これで、ログ・ファイルはODLを使用して書き込まれます。ログ・ファイルの内容は、Oracle Enterprise Manager Fusion Middleware Controlから表示できます。

ロギングの詳細は、『Oracle Fusion Middleware管理者ガイド』を参照してください。

3.4.2 Oracle Enterprise Manager Fusion Middleware Controlページのパフォーマンス問題を診断するロギングの構成

Oracle SOA Suiteでは、APIコールのパフォーマンス・メトリックをログに記録できます。作成されたOracle Enterprise Manager Fusion Middleware Controlページに対する高コストのAPIコールのパフォーマンスをトレースできます。このトレースは、APIコールが効率的に実行されない場合に役立ちます。他の情報とともにview idが次のファイルにログとして記録されます。

FMW_HOME/user_projects/domains/domain_name/servers/weblogic_name/logs/weblogic_name-soa-tracking.trc

たとえば、weblogic_name-soa-tracking.trcファイルに関連付けられたルート・ロブ出力でFINEレベルのロギングを有効化して、診断対象の問題を再生してからロギング・レベルをSEVEREに戻すことができます。ログの内容を分析して、Oracle SOA Suiteで実行された元の操作を精密に指摘できます。

パフォーマンスの問題を診断するロギングを構成する手順は次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ログ」→「ログ構成」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「ログ」→「ログ構成」の順に選択します。

「ログ構成」ページが表示されます。

2. 「ロガー名」列で、oracle.soa > oracle.soa.sql.trc.fabricを開きます。

3. ロギング・レベルをFINEに設定します。

4. 「適用」をクリックします。
APIコールを生成したOracle Enterprise Manager Fusion Middleware Controlページは、weblogic_name-soa-tracking.trcファイルにログ記録されます。この例では、/ai/soa/composite (SOAコンポジット・アプリケーションのホーム・ページ)がページとして特定されます。

[2012-08-07T23:21:04.488-07:00] [soa_server1] [TRACE:32] []
[oracle.soa.sql.trc.fabric.toplink_session.tracking_session] [tid:
[ACTIVE].ExecuteThread: '1' for queue: 'weblogic.kernel.Default
(self-tuning)'] [userId: weblogic] [ecid:
6fec0e67fbf81939:-7d87fd84:138e67064fb:-8000-0000000000000dd6,1:24469]
[SRC_CLASS: oracle.integration.platform.instance.store.ToplinkSessionLogger]
[APP: soa-infra] [SOA.toplink.session_name: tracking_session]
[SOA.logging.category: query] [SOA.call_origin_category: /ai/soa/composite]
[SOA.call_origin: em] [SRC_METHOD: log] execute_query

3.5 カスタムXAドライバのサポートのためのドライバ名の変更

デフォルトのSOAインフラストラクチャのデータ・ソースは常にXAに対応しています。データ・ソースがカスタム・ドライバのサポートを必要とする場合は、Oracle WebLogic Serverでドライバ名を変更する必要があります。

次のいずれかの方法で、ドライバ名を変更する手順は、次のとおりです。

- Oracle WebLogic Server管理コンソールで編集します。

1. Oracle WebLogic Server管理コンソールにログインします。

2. 左側のペインで、「ドメイン構造」を選択します。

3. 「サービス」→「JDBC」→「データ・ソース」→「SOADataSource」→「接続プール」の順に選択します。

4. 「ドライバ・クラス名」で、値をカスタム・データ・ソース(例: oracle.jdbc.xa.client.myDataSource)に変更します。

5. サーバーを再起動します。

- soaDataSource-jdbc.xmlファイルを編集します。

1. Oracle WebLogic ServerでsoaDataSource-jdbc.xmlファイルを開きます。

2. SOADataSourceドライバ名をoracle.jdbc.OracleDriverからoracle.jdbc.xa.client.myDataSourceに変更します。

<?xml version="1.0" encoding="UTF-8"?>
<jdbc-data-source
/. . .
. . .
/  <name>SOADataSource</name>
<jdbc-driver-params>
<url>jdbc:oracle:thin:myhost.us.example.com:1537:co0yd570</url>
<driver-name>*oracle.jdbc.xa.client.myDataSource*</driver-name>
<properties>
<property>
<name>user</name>
<value>fusion_soainfra</value>
</property>
</properties>
/  . . .
. . ./
</jdbc-driver-params>
/. . .
. . ./
</jdbc-data-source>

3.6 XAデータ・ソースへのデフォルト以外のXAトランザクション・タイムアウト値の指定

XAデータ・ソースのデフォルトのXAトランザクション・タイムアウト値は、0秒です。このデフォルト値はOracle WebLogic Server管理コンソールで変更できます。変更する場合は次の手順に従います。

XAデータ・ソースにデフォルト以外のXAトランザクション・タイムアウト値を指定する手順は、次のとおりです。

1. Oracle WebLogic Server管理コンソールにログインします。

2. ページの左側の「ドメイン構造」で、「サービス」→「JDBC」→「データ・ソース」の順に選択します。

3. 「データ・ソース」表の「名前」列で、EDNDataSource (イベント配信ネットワーク・トランザクションの場合)、またはSOADataSource (その他のすべてのタイプのトランザクションの場合)を選択します。

4. 上部にある「構成」タブで、「トランザクション」サブタブをクリックします。

5. 「XAトランザクション・タイムアウト」フィールドに、値を秒単位で入力します。

6. 「XAトランザクション・タイムアウトの設定」チェック・ボックスを選択します。このチェック・ボックスは、新しいXAトランザクション・タイムアウト値を有効にするために選択する必要があります。

7. 「保存」をクリックします。

3.7 ローカルの最適化の構成

ローカルの最適化とは、2つのSOAコンポジット・アプリケーションが同じSOAサーバー(JVM)にある環境で、直接Java呼出しによってSOAコンポジット・アプリケーションが別のSOAコンポジット・アプリケーションを呼び出すプロセスです。

一般的に、直接Java呼出しはSOAP over HTTPコールより効率的です。したがって、直接Java呼出しの条件を満たしている場合は常に、Oracle SOA Suiteでは、同じ場所に存在するコンポジット間のサービス・コールを最適化します。

3.7.1 ローカルの最適化を使用するための条件チェック

Oracle SOA Suiteでは、ローカルの最適化が可能かどうかを判断するために、次の条件チェックを実行します。

- コンポジット間呼出しである必要があります。これは最も基本的な条件で、クライアント・サービスとターゲット・サービスの両方が同じSOAインフラストラクチャ(つまり、同じSOAサーバー)に基づいて実装されている場合に、直接Javaコールが可能になります。

- 参照(ターゲット)サービスを実装するコンポジットがアクティブである必要があります。この条件ではターゲット・コンポジットが起動して実行中であることが必要で、これにより、参照サービスが使用可能であることが保証されます。

注意:

ターゲット・コンポジットの状態は「オン」および「アクティブ」である必要があります。状態が「停止済」または「リタイア」の場合は、ローカルの最適化の対象になりません。

- クライアント・コンポジットとターゲット・コンポジットは同じサーバー上に存在する必要があります。これは、直接Java呼出しの明白な要件です。また、Oracle SOA Suiteで、(クライアント・コンポジットがデプロイされている)サーバーのホスト構成に対して、参照(ターゲット)サービス・エンドポイントURIで指定したホストとポート値を比較するのは重要なステップです。ホストとポート値が一致する場合は、クライアント・コンポジットとターゲット・コンポジットが同じサーバー上に存在すると判断できます。ただし、スタンドアロン・サーバー設定とクラスタ・サーバー設定の両方を使用し、ロード・バランサ構成が必要になる可能性がある場合、この比較は必ずしも単純ではありません。したがって、次に、すべてのプラットフォームでサーバー構成が正しいことを確認する条件チェックをステップごとに示します。

- 第3.1項「SOAインフラストラクチャ・プロパティの構成」で説明したように、「SOAインフラストラクチャの共通プロパティ」ページで「サーバーURL」構成プロパティ値をチェックします。

- 指定されていない場合は、クラスタMBeanのFrontendHostおよびFrontendHTTPPort (また、SSLが有効化されている場合はFrontendHTTPSPort)の構成プロパティ値をチェックします。

- 指定されていない場合は、Oracle WebLogic Server MBeanからFrontendHostおよびFrontendHTTPPort(または、SSLが有効な場合はFrontendHTTPSPort)構成プロパティ値をチェックします。

- 指定されていない場合は、DNS解決されたINETアドレスのlocalhostを使用します。

- 参照サービス・エンドポイントURLで指定したポート値が、構成されたサーバー・ポート値と一致するかどうかをチェックします。エンドポイントURLにポート値が指定されていない場合、Oracle SOA Suiteでは、HTTP URLの場合は80、HTTPS URLの場合は443を使用します。

- ポート値が一致する場合、サーバーURL、つまり、http(s)://host:port(hostとportは前のチェックから取得)が、参照エンドポイント・アドレスのサーバーURLと比較されます。URLは正規値に解決され、エンドポイントURLホストがlocalhostまたは127.0.0.1の場合もこの比較が行われます。

- Oracle SOA Suiteでは、サーバーURLの比較で値trueが返された場合、コンポジットは同じ場所に存在すると判断します。

- セキュリティ・ポリシー構成は、クライアント・コンポジットとサーバー・コンポジットの一方または両方に適用されている場合、ローカルの最適化に対応している必要があります。ポリシー構成およびローカルの最適化については、第7.7.2項「コンポジット間呼出しでのポリシー・アタッチメントおよびローカルの最適化」を参照してください。

「フローのトレース」ページの「トレース」セクションで、コールによってローカルの最適化が行われたかどうかを確認できます。図3-1に示すように、呼出し元コンポジットと呼出し先コンポジットの参照とサービスに対して(ローカル呼出し)というテキストが表示されます。

図3-1 「フローのトレース」ページの「トレース」セクションに表示されるローカルの最適化の詳細

「フローのトレース」ページの詳細は、第14.1項「BPELプロセス・サービス・コンポーネントの監査証跡とプロセス・フローの監視」を参照してください。

3.7.2 ローカルの最適化のオーバーライドまたは強制

ローカルの最適化をオーバーライドまたは強制するために、2つの構成プロパティが用意されています。

- oracle.webservices.local.optimization
デフォルトでは、Oracle SOA Suiteはローカルの最適化を実行します。ただし、composite.xmlファイルのoracle.webservices.local.optimizationバインディング・プロパティを使用してこの動作をオーバーライドできます。このプロパティをfalseに設定すると、ローカルの最適化は実行されず、コンポジット間コールはSOAP and HTTPを介して実行されます。必要に応じて、このプロパティを使用してください。このプロパティの設定については、第7.7.2項「コンポジット間呼出しでのポリシー・アタッチメントおよびローカルの最適化」を参照してください。

- oracle.soa.local.optimization.force
oracle.soa.local.optimization.forceプロパティをtrueに設定して、oracle.webservices.local.optimizationプロパティをオーバーライドすると、最適化を強制的に実行できます。このプロパティは、次のシナリオの場合に使用します。

- サーバー構成がかなり複雑で(たとえば、イントラネットにファイアウォールやプロキシ設定がある場合)、第3.7.1項「ローカルの最適化を使用するための条件チェック」で説明した同じ場所に存在するかどうかのチェックで正しい結果が得られない可能性がある場合。

- ユーザーがローカルの最適化のセマンティクスを十分に理解し、システム設定がローカルの最適化に適しており、ローカルの最適化が確実に効率的である場合。

この項で説明していないこれ以外のシナリオでも、最適化を強制する場合があります。

注意:

oracle.webservices.local.optimizationをfalseに設定し、oracle.soa.local.optimization.forceをfalseに設定すると、ローカルの最適化は実行されません。

oracle.soa.local.optimization.forceプロパティのデフォルト値はfalseです。このプロパティをtrueに設定すると、Oracle SOA Suiteでは第3.7.1項「ローカルの最適化を使用するための条件チェック」で説明した条件チェックをスキップしますが、ポリシー構成チェックは例外で、このチェックはサービス・コールの整合性を確認して強制するために必要とされます。

Oracle SOA Suiteで常にこのプロパティの設定が優先されることは、このプロパティに関する重要事項の1つです(ポリシー・チェックによって最適化が可能になる場合)。ただし、ローカル呼出しがアプリケーション以外のフォルトまたは例外によって失敗した場合(多くの場合、直接Java呼出しに関連するランタイム・エラー)、構成されたエンドポイントでの後続の呼出し、およびエンドポイントに構成されたすべての有効なエンドポイント・アドレスで、この設定の値が無視されます。

oracle.soa.local.optimization.forceプロパティを有効にする手順は、次のとおりです。

1. 呼び出されるコンポジットのreferenceセクションに、oracle.soa.local.optimization.forceをバインディング・コンポーネント・レベルのプロパティとして追加します。たとえば、コンポジットcomp_comp2がcomp_comp1を呼び出す場合は、comp_comp2のcomposite.xmlファイルのreferenceセクションでこのプロパティを定義します。

<reference name="Service1"
ui:wsdlLocation="http://localhost:8001/soa-infra/services/default/comp_
comp1!1.0/BPELProcess1.wsdl">
<interface.wsdl interface="http://xmlns.oracle.com/comp_comp/comp_
comp1/BPELProcess1#wsdl.interface(BPELProcess1)"
callbackInterface="http://xmlns.oracle.com/comp_
comp/comp_comp1/BPELProcess1#wsdl.interface(BPELProcess1Callback)"/>
<binding.ws port="http://xmlns.oracle.com/comp_comp/comp_
comp1/BPELProcess1#wsdl.endpoint(bpelprocess1_client_ep/BPELProcess1_pt)"
location="http://localhost:8001/soa-infra/services/default/comp_
comp1!1.0/bpelprocess1_client_ep?WSDL">
<property name="oracle.webservices.local.optimization">false</property>
<property name="oracle.soa.local.optimization.force">true</property>
</binding.ws>

参照サービス・コールバックに対してローカル最適化を強制する手順は次のとおりです。

1. 対応する参照サービスの<service>定義で、<callback>要素にoracle.soa.local.optimization.forceプロパティを追加します。
たとえば、composite1がcomposite2を起動する場合は、次のようにcomposite2の<service>定義にoracle.soa.local.optimization.forceプロパティを追加し、composite2からcomposite1への非同期コールバックを強制してローカルで最適化されるようにします。

<service ui:wsdlLocation="composite2.wsdl">
. . .
<callback>
<binding.ws
port="http://xmlns.oracle.com/example#wsdl.endpoint(FooService/FooPort)">
<property
name="oracle.soa.local.optimization.force">true</property>
</binding.ws>
</callback>
</service>

最適化、およびWS-AtomicTransaction (WS-AT)トランザクションの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の最適化有効時にサポートされないWS-ATトランザクションに関する項を参照してください。

3.7.3 ローカルの最適化のロギング

Oracle SOA Suiteでは、ローカルの最適化かSOAP処理かを決定するたびにNOTIFICATION:1(INFO)レベルのロギングが実行されます。詳細またはデバッグ情報が必要な場合は、Oracle Enterprise Manager Fusion Middleware Controlでoracle.integration.platform.blocks.localおよびoracle.integration.platform.blocks.soapロガーをTRACE:1(FINE)レベルで設定します。

3.7.4 ローカル最適化コールのユースケース

このローカル最適化コールのユースケースで説明する内容は次のとおりです。

- コンポジットAが同じサーバー上にあり関連付けられているコンポジットBをコールする環境でコンポジットBに到達不能な場合にローカル最適化コールがどのように機能するか(表3-2)。

- Oracle WebLogic Serversがリスニングするポートではないポート値でロード・バランサ・アドレスを作成した場合にどのようになるか(表3-3)。

表3-2 コンポジットに到達不能の場合のローカル最適化コール

シナリオ

説明

ローカル最適化コールの失敗時にどのようになるか。

ローカル最適化コールの試行前にコンポジットBのチェックが実行されます。

このチェックに失敗した場合(コンポジットBに到達不能)、SOAインフラストラクチャで例外がスローされBPELフォルトに変換されます。このBPELフォルトには、コンポジットBが到達不能であることに関する情報が組み込まれます。

関連付けられたコールの再試行が可能であるか。

基本チェックの実行後にローカル最適化コールが試行されます。このコールが失敗すると、SOAPを介して再起動されます。ただし、SOAPを介した再起動を行うには次の条件に合致している必要があります。

- ローカル最適化を強制するためのoracle.soa.local.optimization.force WSバインディング・プロパティがtrueに設定されている必要があります。この条件は、下位互換性を維持する目的で提供されています。

- 例外がビジネス例外であってはいけません。

関連付けられたコールの再試行が可能な場合(たとえば、コンポジットまたはエンドポイントでフォルトのポリシーが再試行に設定されている場合など)、コールが再度最適化されるか、ローカル・コンテナの終了してロード・バランサへのアクセスを試行するか。

ローカルでの送信の試行時にコールが初めて失敗した場合は、その情報がキャッシュされます(つまり、ローカルでの失敗)。

その後のコールについては、コールがSOAPを介して送信されます(このときはローカル最適化コールの再試行は行われません)。

表3-3 Oracle WebLogic Serversがリスニングするポートではないポート値でのロード・バランサ・アドレスの作成

シナリオ

説明

Oracle WebLogic Serversがリスニングするポートではないポート値でロード・バランサ・アドレスを作成する場合に、ロード・バランサのアドレスとしてサーバーURL (SOAインフラストラクチャの「共通プロパティ」ページ)、およびフロントエンド・ホスト/ポート(Oracle WebLogic Serverの「HTTP」タブ内)を指定できますか。

可サーバーURL、またはフロントエンド・ホスト/ポートは、ローカル最適化ルールのアドレスの識別子としてネットワーク・リクエストの送信先の実際のアドレスより詳細度が高くなります。

コールを実行する際にローカル最適化でポートを使用しませんか(たとえば、ポート2011を介してコンポジットAがコンポジットBをコールする場合など)。

使用します。このポートは、ローカル・コールを実行するために、ターゲットが関連付けられているかどうかを調べる比較の実行のみに使用されます。

3.8 複数のSOAコンポジット・アプリケーションのグローバル・トークン変数の管理

構成プランはコンポジット別です。このため、SOAコンポジット・アプリケーションを環境間で移動すると、構成プランのそれぞれで一部の値の置き換えが必要になります。各プランの値の置換を回避するため、Oracle Enterprise Manager Fusion Middleware ControlのSOAコンポジット・アプリケーションの特定のURIにグローバル・トークン変数を定義できます。

グローバル・トークン変数には、次の利点があります。

- 複数のSOAコンポジット・アプリケーションが特定のサーバー上でホストされる複数の異なるサービスを起動する場合は、単一のグローバル・トークン変数を使用して、コンポジット間でこのサーバーを参照できます。個別の構成プランが不要になり単一のトークン値セットを更新すれば済むため、開発作業が簡素化されます。たとえば、10個の異なる構成プランでサーバーのホスト名を更新するかわりに、グローバル・トークン変数を使用してこの名前をグローバルに設定します。この値は、デプロイされたSOAコンポジット・アプリケーションのcomposite.xmlファイルのbinding.ws要素内のホスト名のグローバル・トークン変数の値を取得および置換します。

- グローバル・トークン変数を使用することは、実行時サーバーにデプロイされるOracle SOA Suiteメタデータには環境固有値が含まれていないことを意味します。

- クラスタ環境では、グローバル・トークン変数の変更が管理サーバーで実行され、管理対象サーバーのすべてに伝播されます。

グローバル・トークン変数の管理には、次のオプションを使用できます。

- Oracle Enterprise Manager Fusion Middleware Controlの「トークン構成」ページを使用して、グローバル・トークン変数の管理(作成、編集および削除)を行います。

- トークンは、ws.bindingロケーションのホスト、ポート、プロトコル、およびreferenceタグ内のすべてのプロパティのみでサポートされます。

- serverURLという名前の事前定義のグローバル・トークン変数を使用します。

注意:

- ダッシュなどの特殊文字を含むトークン名(例: host-name)は作成しないでください。特殊文字があるとSOAコンポジット・アプリケーションの起動時にNull Pointer Exceptionエラーが発生して起動が失敗します。

- 作成できるのは、composite.xmlファイルで使用されるトークンのみです。

- composite.xmlファイルのimport要素でのグローバル・トークン変数の使用はサポートされません。

3.8.1 「トークン構成」ページでのグローバル・トークン変数の管理

トークン構成ページでは、グローバル・トークン変数を管理できます。このページでは、次の操作を実行できます。

- ローカルmdm-url-resolver.xmlファイルからの変数をシステムのmdm-url-resolver.xmlファイルに追加して、必要に応じて編集します。

- システムのmdm-url-resolver.xmlファイル内の変数を管理します。

「トークン構成」ページでトークン変数を管理する手順は次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「SOA管理」→「トークン構成」を選択します。

1. 「soa-infra」を右クリックします。

2. 「SOA管理」→「トークン構成」を選択します。

「トークン構成」ページが表示されます。

2. 実行するグローバル・トークン変数の構成アクションを選択します。

操作

移動先の手順

mdm-url-resolver.xmlファイルの変数をシステムのmdm-url-resolver.xmlファイルの変数に追加することを選択します。

4

システムのmdm-url-resolver.xml内の変数を管理します。

5

3. ローカル・ファイルの変数を追加するには、次の手順を実行します。

1. 「トークンの一括追加」をクリックします。

2. 「参照」をクリックして、ローカル・ファイル・システムからmdm-url-resolver.xmlファイルを選択します。アップロードを成功させるには、ローカル・ファイルが次の書式に従っている必要があります。この例では、ホスト名、ポートおよびプロトコルにグローバル・トークン変数が定義されています。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<comment>
URL Resolver file used by the Metadata manager to resolve $<variable>
in URLs
</comment>
<entry key="host">mymachine.us.example.com</entry>
<entry key="port">8001</entry>
<entry key="protocol">http</entry>
</properties>

3. 「追加」をクリックします。
ローカル・ファイルのコンテンツが、システムのmdm-url-resolver.xmlファイルのコンテンツに追加されます。システムのmdm-url-resolver.xmlファイルに既存のグローバル・トークン変数は上書きされません。

4. 変数の編集が必要な場合は、「構成ファイルの変更」をクリックして、手順5に進みます。

4. システムのmdm-url-resolver.xmlファイル内の変数を管理するには、次の手順を実行します。

1. 「構成ファイルの変更」をクリックします。
最初に「トークンの一括追加」を選択してファイルをアップロードした場合は、ローカルmdm-url-resolver.xmlファイルとシステムのmdm-url-resolver.xmlファイルのグローバル・トークン変数のトークン名と値が表書式で表示されます。変数に重複はなく、ローカル・ファイルの変数がシステム・ファイルに既存の場合は表示されません。

最初に「構成ファイルの変更」を選択した場合は、システムのmdm-url-resolver.xmlファイル内のグローバル・トークン変数がトークン名と変数が表書式で表示されます。

2. 管理対象のグローバル・トークン変数を選択して、特定のタスクを実行します。

注意:

変更の実行後は、「トークンの一括追加」モードに切り替えたり、このページから移動する前に「コミット」をクリックする必要があります。これらのアクションを実行するとコミットされていない変更が失われます。

要素

説明

1. クリックすると、新規トークン名と値を追加するための「トークンの追加」ダイアログが起動されます。既存のトークン名を追加しようとすると、別の名前を指定するように求めるメッセージが表示されます。別の名前を入力するか、このダイアログを閉じて「編集」アイコンをクリックし、既存の名前を変更します。

2. 「OK」をクリックして、「トークンの追加」 ダイアログでの変更内容を保存します。

3. 「コミット」をクリックして、システムのmdm-url-resolver.xmlファイルでの変更内容を保存します。

1. クリックすると、選択したトークン名、値、またはその両方を編集するための「トークンの編集」ダイアログが起動されます。

2. 「OK」をクリックして、「トークンの編集」 ダイアログでの変更内容を保存します。

3. 「コミット」をクリックして、システムのmdm-url-resolver.xmlファイルでの変更内容を保存します。

1. クリックすると、既存のトークン名と値が削除されます。

2. 「OK」をクリックして処理を確認します。

3. 「コミット」をクリックして、システムのmdm-url-resolver.xmlファイルに対する変更内容を保存します。

1. クリックすると、トークン構成に加えたすべての変更がコミットされます。これで、トークン名と値の新規作成、編集、または削除が永続化されます。このアクションによって、システムのmdm-url-resolver.xmlファイルに加えた変更内容がコミットされます。

1. クリックすると、最後に「コミット」をクリックした後に加えられた変更がすべて元に戻されます。

2. 確認を求められたら、「はい」をクリックします。

3. トークン値の追加、変更、または削除の実行後は、SOAインフラストラクチャを再起動してください。詳細は、第3.2項「管理対象サーバーとSOAインフラストラクチャの停止と起動」を参照してください。
更新内容がクラスタ全体に伝播されます。

4. 実行時にグローバル・トークン変数を置換する方法の詳細は、第3.8.2項「実行時にグローバル・トークン変数を置換する方法」を参照してください。

3.8.2 実行時にグローバル・トークン変数を置換する方法

注意:

Oracle Enterprise Manager Fusion Middleware Controlにグローバル・トークン変数を使用するSOAコンポジット・アプリケーションをデプロイすると、システムのmdm-url-resolver.xmlファイルですべてのトークンが構成されていることを確認するように求める警告メッセージが表示されます。詳細は、第7.1項「SOAコンポジット・アプリケーションのデプロイ」を参照してください。

トークン構成ページで指定したトークン名と置換値が、次のディレクトリにあるシステムのmdm-url-resolver.xmlファイルに追加されています。

$MIDDLEWARE_HOME/user_projects/domains/domain_name/config/fmwconfig/
mdm-url-resolver.xml

たとえば、トークン構成ページを使用して、4つのグローバル・トークン変数名と値が定義されているとします。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<comment>
URL Resolver file used by the Metadata manager to resolve $<variable> in
URLs
</comment>
<entry key="myprotocol">http</entry>
<entry key="myhost">mymachine.us.example.com</entry>
<entry key="myport">8001</entry>
</properties>

デプロイされたSOAコンポジット・アプリケーションのcomposite.xmlが実行時にロードされ、ファイル内のURIによって指定されたリソースが取得されると、URI内のグローバル・トークン変数の値がトークン構成ページで指定された値に置き換えられます。

たとえば、次のcomposite.xmlファイルは、これらのトークンを使用してbinding.ws要素のURIを指定します。

<?xml version="1.0" encoding="UTF-8"?>
<composite...>
. . .
. . .
<reference name="Service" ui:wsdlLocation="...">
. . .
<binding.ws port="..."
location="${myprotocol}://${myhost}:${myport}/soa-infra/services/default/
mycomposite/bpelprocess1_client_ep?WSDL" soapVersion="1.1">
</binding.ws>
</reference>
. . .
</composite>

実行時にWSDL定義ファイルが取得される場合、トークンはmdm-url-resolver.xml構成ファイル内の値によって置き換えられ、次のURIが作成されます。

http://mymachine.us.example.com:8001/soa-infra/services/default/myComposite/
bpelprocess1_client_ep?WSDL

3.8.3 事前定義されたグローバル・トークン変数の使用

リソースURLではserverURLという名前の事前定義のグローバル・トークン変数を使用できます。このトークンは、実行時にOracle Enterprise Manager Fusion Middleware ControlのSOAインフラストラクチャの「共通プロパティ」ページの「サーバーURL」プロパティの設定によって置き換えられます。

事前定義のグローバル・トークン変数を使用する手順は次のとおりです。

1. SOAインフラストラクチャの「共通プロパティ」ページの「サーバーURL」フィールドに値(例: my.host.com:8080)を入力します。このプロパティを変更した場合は、サーバーの再起動が必要です。図3-2に詳細を示します。

図3-2 SOAインフラストラクチャの「共通プロパティ」ページの「サーバーURL」フィールド

2. composite.xmlファイルにserverURLトークンを入力します。

${serverURL}/somePath/someResource.xml

serverURLトークンには、プロトコル(http、また、SSLが有効化されている場合はhttps)が含まれています。

これで、デプロイメント時にトークンが置換された後に次のURIが生成されます。

http://my.host.com:8080/somePath/someResource.xml

「サーバーURL」プロパティ、およびSOAインフラストラクチャの「共通プロパティ」ページの詳細は、第3.1項「SOAインフラストラクチャ・プロパティの構成」を参照してください。

4 SOAインフラストラクチャの監視

この章では、Oracle SOA Suiteのルーティング・トポロジ、SOAインフラストラクチャのパフォーマンスのサマリー・メトリック、最新のインスタンスおよびフォルト、デプロイ済のSOAコンポジット・アプリケーション、メッセージ配信処理リクエスト、およびSOAインフラストラクチャ内のサービスと参照バインディング・コンポーネントの監視方法について説明します。SOAインフラストラクチャには、すべてのSOAコンポジット・アプリケーションがデプロイされています。また、リカバリが必要なBPELプロセス・メッセージの詳細を表示する方法、およびBPELプロセス・サービス・エンジンの「リカバリ」ページにアクセスしてメッセージ・リカバリを実行する方法についても説明します。

この章では、次の項目について説明します。

- 第4.1項「Oracle SOA Suiteルーティング・トポロジの検出」

- 第4.2項「SOAインフラストラクチャのパフォーマンス・サマリー・メトリックの監視」

- 第4.3項「SOAインフラストラクチャの最新のインスタンスとフォルト、およびデプロイ済コンポジットの監視」

- 第4.4項「メッセージ配信リクエスト処理の監視」

- 第4.5項「SOAインフラストラクチャのサービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントの監視」

詳細は、第1.2.1項「SOAインフラストラクチャ・アプリケーションの概要」を参照してください。

4.1 Oracle SOA Suiteルーティング・トポロジの検出

既存のOracle SOA Suite環境の管理作業時は、トポロジ・ビューアが便利です。トポロジ・ビューアは、デプロイされているリソース(サーバー、データベースおよびデータ・ソース、SOAコンポジット・アプリケーションなど)とこれらの関係をグラフィックで迅速に表示します。

トポロジ・ビューアは、コンポーネントおよび要素間のルーティング関係を表示します。トポロジ・ビューアを使用すると、Oracle Enterprise Manager Fusion Middleware Control環境を検出して、コンポーネント間でリクエストがどのようにルーティングされるかを確認できます。

たとえば、トポロジ・ビューアを使用すると、次の事項の把握が可能になります。

- SOAサーバーが依存するデータベース

- これらのデータベースへの接続に使用されるデータ・ソース

- 稼働中および停止中のSOAサーバーなどのエンティティ

- 管理サーバーのリクエスト処理時間など、コンポーネントのパフォーマンス・メトリック。

1. ナビゲータ上で、「トポロジ」をクリックします。

別のウィンドウで「トポロジ・ビューア」が開きます。「トポロジ・ビューア」にOracle Fusion Middlewareコンポーネント(サーバー、クラスタ、およびデータベース)のルーティング関係が表示されます。

2. 「AdminServer」アイコン、および「クラスタ」アイコンの左側にあるハンドルを開き、追加の詳細を表示します。

さらに、soa-infraアイコン、「アプリケーションのデプロイ」アイコン、および「メタデータ・リポジトリ」アイコンも開いて、追加の詳細を表示できます。たとえば、soa-infraを開いた場合は、SOAインフラストラクチャ内のパーティション、およびこれらのパーティションにデプロイされたSOAコンポジット・アプリケーションを表示できます。

3. 「ノードの表示」リストから、「データ・ソース」を選択して、定義されているデータ・ソースを表示します。

4. 「ビュー」リストから、「ルーティング: アプリケーション別グループ」を選択します。これで、アプリケーション間のルーティング関係が表示されます。構成済のOracle Metadata Services (MDS)リポジトリも表示されます。

5. 上矢印をクリックすると、実行中ステータスのターゲットが、下矢印をクリックすると、停止中ステータスのターゲットが表示され、また、「クロック」アイコンをクリックするとステータスが不明のターゲットが表示されます。

6. 「検索」リストから、ターゲットのステータス(稼働中、停止中、不明)、または検索対象のターゲット・タイプを選択し、「検索」アイコンをクリックします。SOAコンポジット・アプリケーション名などの検索対象のエンティティの名前を手動で入力することもできます。

7. 「注釈」リストから、「ステータス」または「メトリック」をクリックすると、該当する詳細が表示されます。例:

- 「メトリック」を選択すると、「AdminServer」のリクエスト処理時間など、コンポーネントの主要パフォーマンス・メトリックが表示されます。

- 「ステータス」を選択すると、停止中のサーバーなど、様々なエンティティの状態の詳細が表示されます。

8. コンポーネント(アプリケーションなど)を右クリックすると、操作を実行するためのメニューが起動されます。たとえば、「パフォーマンス・サマリー」を選択して、選択したコンポーネントのパフォーマンス詳細を表示したり、「ホーム」を選択してアプリケーションの「ダッシュボード」ページにアクセスしたりできます。

9. コンポーネント間のラインをクリックすると、使用されているホスト、ポート、データベースなどのJDBCルーティング関係が表示されます。

10. いずれかのエンティティ(「AdminServer」など)の端にカーソルを合わせると、小さいアイコンが起動します。

11. このアイコンを開くと、サーバー・ステータス、ホスト名、CPU使用率、リクエスト処理時間、ヒープ使用量、アクティブなセッション、および1分当たりのメッセージ・リクエストについての詳細が表示されます。

12. 「リフレッシュ」リストから、ステータスとメトリックを手動と自動のいずれでリフレッシュするかを選択します。デフォルトでは、トポロジ・ビューアは5分ごとにリフレッシュされます。

トポロジ・ビューアの詳細は、Oracle Fusion Middleware管理者ガイドのルーティング・トポロジの表示に関する項を参照してください。

4.2 SOAインフラストラクチャのパフォーマンス・サマリー・メトリックの監視

「パフォーマンス・サマリー」ページでは、SOAインフラストラクチャのパフォーマンス・メトリックのサマリーを表示できます。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「監視」→「パフォーマンス・サマリー」を選択します。

1. 「soa-infra」を右クリックします。

2. 「監視」→「パフォーマンス・サマリー」を選択します。

「パフォーマンス・サマリー」ページには、デフォルトで次の情報がグラフィック表示されています。

- サーバーの最終再起動以降のSOAインフラストラクチャのメッセージの合計数。

- サーバーの最終再起動以降のサービス・コンポーネント・メッセージ(BPELプロセス、Oracle Mediator、ヒューマン・ワークフロー、ビジネス・ルール(デシジョン・サービス))の合計数。

2. 「メトリック・パレットの表示」をクリックすると、SOAインフラストラクチャのすべてのメトリックの階層ツリーが表示されます。このツリーは、メトリックをパフォーマンス・データの様々なカテゴリで整理しています。

3. フォルダを開き、「メトリック・パレット」のメトリックを選択すると、時間の経過に応じたメトリックの変化を示すパフォーマンス・グラフが表示されます。このグラフは自動的にリフレッシュされ、更新されたデータが表示されます。

4. 「スライダ」をクリックしてスライダ・ツールを表示すると、グラフに表示するデータの時間枠を指定できます。

「パフォーマンス・サマリー」ページの詳細は、「パフォーマンス・サマリー」ページのオンライン・ヘルプ、およびOracle Fusion Middleware管理者ガイドのOracle Fusion Middlewareのパフォーマンスの表示に関する項を参照してください。

メッセージ配信処理リクエストの監視の詳細は、第4.4項「メッセージ配信リクエスト処理の監視」を参照してください。

SOAコンポジット・アプリケーションのサマリー・メトリック監視の詳細は、第6.1項「SOAコンポジット・アプリケーションのパフォーマンス・サマリー・メトリックの監視」を参照してください。

サービス・エンジン統計の監視の詳細は、下記を参照してください。

- 第14.6項「BPELプロセス・サービス・エンジンのリクエスト統計とスレッド・パフォーマンス統計の監視」

- 第17.3.3項「リクエストのブレークダウン統計の監視」

- 第20.2項「ビジネス・ルール・サービス・エンジンのパフォーマンス統計の監視」

- 第22.5項「ヒューマン・ワークフロー・サービス・エンジンのアクティブ・リクエストと操作パフォーマンス統計の監視」

- 第40.5項「BPMNプロセス・サービス・エンジンのリクエスト統計とスレッド・パフォーマンス統計の監視」

4.3 SOAインフラストラクチャの最新のインスタンスとフォルト、およびデプロイ済コンポジットの監視

SOAインフラストラクチャにデプロイされたSOAコンポジット・アプリケーションを監視できます。

SOAインフラストラクチャの最新のインスタンスとフォルトを監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

SOAコンポジットのメニューから...

1. 「ホーム」を選択します。

1. 「soa-infra」を選択します。

1. 「SOAインフラストラクチャ」を選択します。

SOAインフラストラクチャの「ダッシュボード」ページの上部には、次の詳細が表示されます。

- このページに表示される最新のインスタンスとフォルトの取得は指定した期間内に制限されることを示すメッセージ。このメッセージは、「SOAインフラストラクチャの共通プロパティ」ページで「インスタンスとフォルトの表示を次に制限: 過去time_period」チェック・ボックスが選択されている場合に表示されます(デフォルトで選択されています)。期間のデフォルト値は24時間ですが、この値は変更できます。このチェック・ボックスが選択されていない場合は、最後のパージ以降のSOAインフラストラクチャにおけるインスタンスとフォルト(数のメトリックを含む)がすべて表示されます。

- 最新のSOAコンポジット・アプリケーション・インスタンス、インスタンスIDおよび開始時間。デフォルトでは、実行中のインスタンスのみ表示されます。

- デプロイ済SOAコンポジット・アプリケーションのステータスと、そのリビジョン番号、各アプリケーションに対して作成されたインスタンスの数、および各アプリケーション内の失敗したインスタンスの数。「詳細の表示」リンクの横にデプロイされたコンポジットの合計数も括弧に囲まれて表示されます。

- 最新のフォルトと拒否メッセージ。エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、フォルトが発生したSOAコンポジット・アプリケーション、フォルトの場所(サービス・バインディング・コンポーネント、サービス・コンポーネントまたは参照バインディング・コンポーネント)、SOAコンポジット・アプリケーションのインスタンスID、およびフォルトまたは拒否メッセージが記述されているログ・メッセージへのリンクが表示されます。リカバリ可能として識別されたフォルトは、SOAインフラストラクチャ、SOAコンポジット・アプリケーション、サービス・エンジンおよびサービス・コンポーネントの各レベルでリカバリできます。
BPELプロセス・サービス・エンジンの「リカバリ」ページからのリカバリを待機しているメッセージがある場合は、各SOAインフラストラクチャのホーム・ページの上部にメッセージが表示されます。

注意:

SOAインフラストラクチャは、起動後、すべてのデプロイ済コンポジットがロードされるまで受信リクエストを管理するために完全には初期化されない場合があります。SOAインフラストラクチャの初期化中、「SOAインフラストラクチャ」ホーム・ページの上部に警告メッセージが表示されます。このメッセージが表示されている間は、コンポジット・デプロイメント、コンポジット・アンデプロイメントなどの操作を実行しないでください。詳細は、第3.2.1項「SOAインフラストラクチャ起動初期化の完了の待機」を参照してください。

2. BPELプロセス・メッセージに対して、BPELプロセス・サービス・エンジンの「リカバリ」ページからリカバリが必要な場合、「必須のBPELメッセージ・リカバリ」メッセージが各SOAインフラストラクチャのホーム・ページの上部に表示されます。

このメッセージ・リカバリ情報の表示は、システムMBeanブラウザのAuditConfigプロパティのbpelRecoveryStatus、excludeBpelMaxCreationTime、およびbpelRecoveryAlertDurationInDaysキーによって制御されます。このプロパティは、SOAインフラストラクチャの「共通プロパティ」ページの「詳細SOAインフラ拡張構成プロパティ」セクションからアクセスできます。デフォルトでは、これらのキーには次の値が設定されています。

- bpelRecoveryStatusは、Allに設定されます。

- excludeBpelMaxCreationTimeは、直前5分間にリカバリを必要とするメッセージの表示を除外するように設定されています。

- bpelRecoveryAlertDurationInDaysは、リカバリ可能BPELメッセージが直前7日間に作成されている場合のみ、「必須のBPELメッセージ・リカバリ」警告メッセージを表示するように設定されています。

1. 次の作業を実行します。

クリックするリンク

操作

詳細の表示

BPELプロセス・サービス・エンジンの「リカバリ」ページからリカバリが必要な呼出しメッセージ、コールバック・メッセージおよびアクティビティ・メッセージの数を示すメッセージを表示します。BPELメッセージの自動リカバリが有効になっている場合、手動リカバリは不要です。その場合は、消耗済メッセージのみを手動でリカバリする必要があります。「リフレッシュ」をクリックして、リカバリが必要な呼出しメッセージ、コールバック・メッセージおよびアクティビティ・メッセージの数を再計算します。

BPELリカバリ・コンソールに移動

BPELプロセス・サービス・エンジンの「リカバリ」ページにアクセスして、メッセージ・リカバリを実行します。

また、後で「リカバリ」ページにアクセスするには、「SOAインフラストラクチャ」メニューから「サービス・エンジン」→「BPEL」を選択し、表示されたページで「リカバリ」タブをクリックします。

「時間しきい値の設定」

リカバリが必要なメッセージを除外する期間を示すメッセージを表示します。デフォルト設定では、過去5分間のメッセージが除外されます。この値は、SOAインフラストラクチャの「共通プロパティ」ページにあるAuditConfigプロパティのexcludeBpelMaxCreationTimeキーによって制御されます。この値を変更するには、「はい」をクリックして、システムMBeanブラウザでこのプロパティにアクセスします。

アラートの無効化

このメッセージ・リカバリ情報が「ダッシュボード」ページに表示されないようにできるメッセージを表示します。「はい」をクリックすると、このメッセージ・リカバリ情報は表示されなくなります。

この情報を「ダッシュボード」ページに再度表示するには、「SOAインフラストラクチャの共通プロパティ」ページの「詳細SOAインフラ拡張構成プロパティ」セクションで、AuditConfigプロパティのbpelRecoveryStatusキーをAllに設定します。詳細は、第3.1項「SOAインフラストラクチャ・プロパティの構成」を参照してください。

3. 「最新のコンポジット・インスタンス」セクションで、次のタスクを実行します。

1. 「インスタンス数」リンクをクリックして、SOAインフラストラクチャの実行中のインスタンス数と合計インスタンス数を示すメッセージを表示します。デフォルトでは、このリンクは表示されません。このリンクを表示するには、次を選択します: 「インスタンス数およびフォルト数をフェッチするメトリックを無効にします。この場合でも各メトリックは必要に応じて取得できます。」チェック・ボックス(「SOAインフラストラクチャの共通プロパティ」ページ)。
「SOAインフラストラクチャの共通プロパティ」ページで「インスタンスとフォルトの表示を次に制限: 過去time_period」チェック・ボックスを選択し、期間を指定するか、またはデフォルト値の24時間を受け入れた場合は、その期間内のSOAインフラストラクチャにおける実行中のインスタンス数と合計インスタンス数が表示されます。このチェック・ボックスを選択していない場合は、最後のパージ以降のSOAインフラストラクチャにおけるインスタンスとフォルトがすべて表示されます。「再計算」をクリックすると、これらの数が再計算されます。

2. 「インスタンスID」列で、特定のインスタンスIDをクリックし、様々なサービス・コンポーネントやバインディング・コンポーネント間のメッセージ・フローを表示します。

3. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

4. セクションの下部にある「詳細の表示」をクリックし、SOAインフラストラクチャの「インスタンス」ページにアクセスします。

4. 「デプロイ済コンポジット」セクションで、次のタスクを実行します。

1. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

2. セクションの下部にある「詳細の表示」をクリックし、SOAインフラストラクチャの「デプロイ済コンポジット」ページにアクセスします。

5. 「最新のフォルトと拒否メッセージ」セクションで、次のタスクを実行します。

1. 「エラー・メッセージ」列で、エラー・メッセージをクリックし、フォルトに関する完全な情報を表示します。フォルトがリカバリ可能と識別されている場合は、「ここでリカバリ」リンクをクリックし、フォルト・リカバリを実行します。

2. フォルトがリカバリ可能と識別されている場合は、「リカバリ」列で「リカバリ」をクリックし、フォルト・リカバリを実行します。

3. 「コンポジット」列で、SOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

4. 「フォルトの場所」列で、特定の場所をクリックし、フォルトが発生したサービス、コンポーネントまたは参照のホーム・ページにアクセスします。

5. 「コンポジット・インスタンスID」列で、コンポジット・インスタンスIDをクリックし、そのフォルトが含まれるメッセージのフローのトレースにアクセスします。

6. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。事前フィルタした検索基準を使用して、フォルトに関連するログ・メッセージを表示します。

7. セクションの下部にある「詳細の表示」をクリックし、SOAインフラストラクチャの「最新のフォルトと拒否メッセージ」ページにアクセスします。

SOAインフラストラクチャの「ダッシュボード」ページの下部には、次の詳細が表示されます。

- サービス・エンジン(BPELプロセス、BPMN process (Oracle BPM Suiteがインストールされている場合)、Oracle Mediator、ヒューマン・ワークフロー、ビジネス・ルール、Spring)で実行しているサービス・コンポーネントの数、および各サービス・エンジンで失敗したインスタンスの数。

- SOAインフラストラクチャの最終再起動以降に発生した、すべてのSOAコンポジット・アプリケーションのインスタンスとフォルトの合計数のグラフィカル表示。

6. 「サービス・エンジン」セクションの「名前」列で、特定のサービス・エンジンをクリックし、そのホーム・ページにアクセスします。「Springエンジン」をクリックすると、管理対象外であることを示すメッセージが表示されます。

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

- 第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」

- 第1.2.6項「サービス・エンジンの概要」

- 第1.4.3.1項「フォルト・リカバリの概要」

- 第8.1項「SOAコンポジット・アプリケーションのテスト・インスタンスの起動」

- 第15.4項「BPELプロセス・サービス・エンジンのメッセージ・リカバリの実行」

- ログ・ファイルの表示および検索については、『Oracle Fusion Middleware管理者ガイド』を参照してください

4.4 メッセージ配信リクエスト処理の監視

SOAインフラストラクチャのメッセージ配信リクエスト処理を監視できます。監視できるのは、サービス・エンジン、サービス・インフラストラクチャおよびバインディング・コンポーネント間のメッセージ配信のメトリックです。一旦メッセージがサービス・エンジンに渡されると、そのメッセージを処理する所要時間(インスタンス処理時間)は、これらのメトリックでは取得できません。

メッセージ配信処理リクエストを監視する手順は次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「監視」→「リクエスト処理」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「監視」→「リクエスト処理」の順に選択します。

「リクエスト処理」ページでは、次の詳細を監視できます。

- サービス・エンジンおよびサービス・インフラストラクチャでの同期メッセージと非同期メッセージの平均リクエスト処理時間、アクティブ・リクエスト、処理済リクエスト、および失敗したリクエスト。

- サービス(インバウンド)と参照(アウトバウンド)のバインディング・コンポーネントで発生した平均リクエスト処理時間、処理済リクエストおよびエラー。

2. 「サービス・エンジン」セクションで、特定のサービス・エンジン(たとえば、「BPELエンジン」)をクリックし、詳細(そのサービス・エンジンを使用する最新のインスタンスやコンポーネント、最新のフォルト発生など)にアクセスします。

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

- 第1.2.5項「バインディング・コンポーネントの概要」

- 第1.2.6項「サービス・エンジンの概要」

- 第1.2.7項「サービス・インフラストラクチャの概要」

4.5 SOAインフラストラクチャのサービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントの監視

SOAインフラストラクチャにデプロイされたすべてのSOAコンポジット・アプリケーションで使用する、すべてのサービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントを監視できます。サービスは、外部の世界に対して、SOAコンポジット・アプリケーションへのエントリ・ポイントを提供します。サービスのWSDLファイルによって、そのサービスの機能が外部のアプリケーションに通知されます。さらに、参照によって、SOAコンポジット・アプリケーションから外部の世界の外部サービスにメッセージを送信できます。

SOAインフラストラクチャのサービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントを監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービスと参照」を選択します。

1. 「soa-infra」を右クリックします。

2. 「サービスと参照」を選択します。

「サービス」ページには、サービスの名前とタイプ、サービスが使用されているSOAコンポジット・アプリケーション、SOAコンポジット・アプリケーションがデプロイされているパーティション、処理されたメッセージの合計数、平均処理時間、およびサービスで発生したフォルトの件数に関する詳細が表示されます。

2. 「サービス」列で、特定のサービスをクリックし、そのホーム・ページにアクセスします。

3. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

4. 「パーティション」列で、特定のパーティションをクリックしてホーム・ページにアクセスします。

5. 「参照」タブをクリックします。
「参照」ページには、参照の名前とタイプ、参照が使用されているSOAコンポジット・アプリケーション、SOAコンポジット・アプリケーションがデプロイされているパーティション、処理されたメッセージの合計数、平均処理時間、および参照で発生したフォルトの件数に関する詳細が表示されます。

6. 「参照」列で、特定の参照をクリックし、そのホーム・ページにアクセスします。

7. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

8. 「パーティション」列で、特定のパーティションをクリックしてホーム・ページにアクセスします。

サービスと参照の詳細は、第1.2.5項「バインディング・コンポーネントの概要」を参照してください。

第IV部

SOAコンポジットおよびインスタンスの管理

この部では、SOAコンポジット・アプリケーションおよびインスタンスの管理方法について説明します。

次の章で構成されています。

- 第5章「SOAコンポジット・アプリケーションの保護」

- 第6章「SOAコンポジット・アプリケーションの監視」

- 第7章「SOAコンポジット・アプリケーションのデプロイおよび管理」

- 第8章「SOAコンポジット・アプリケーション・インスタンスの管理」

- 第9章「データベース増分管理戦略の策定」

- 第10章「データベース増分の管理」

- 第11章「Facade APIを使用したSOAコンポジット・アプリケーションのプログラムによる管理」

- 第12章「SOAコンポジット・アプリケーションに関する問題の診断」

5 SOAコンポジット・アプリケーションの保護

この章では、SOAコンポジット・アプリケーションに固有のセキュリティ構成プロシージャ(Oracle WebLogic ServerグループまたはユーザーへのSOAOperatorおよびSOAMonitorロールのマッピングなど)について説明します。ほとんどのSOAコンポジット・アプリケーションのセキュリティ手順では、SOA固有の構成手順は必要ありません。これらのタスクを実行するための別のドキュメントへの参照を示します。

この章では、次の項目について説明します。

- 第5.1項「SOAコンポジット・アプリケーションの保護の概要」

- 第5.2項「Oracle WebLogic ServerグループまたはユーザーへのSOAOperatorおよびSOAMonitorロールのマッピング」

- 第5.3項「Oracle BPM Worklist用のOracle HTTP Serverの構成」

- 第5.4項「SOAインフラストラクチャのSAMLメッセージ保護付きポリシー構成の設定」

- 第5.5項「Oracle BPM WorklistおよびOracle Business Process Managementユーザーの自動認証」

- 第5.6項「認証プロバイダの設定」

- 第5.7項「NTLM認証をリクエストするWebサービスの起動」

- 第5.8項「SSLの構成」

- 第5.9項「ヒューマン・ワークフローWSDLファイルに対するセキュリティの構成」

注意:

ポリシーのアタッチおよびデタッチについては、次の各項を参照してください。

- 第7.7項「SOAコンポジット・アプリケーションのポリシーの管理」

- 第15.2項「BPELプロセス・サービス・コンポーネントのポリシーの管理」

- 第18.2項「Oracle Mediatorのポリシーの管理」

- 第23.1項「ヒューマン・タスク・サービス・コンポーネントのポリシーの管理」

- 第38.1項「バインディング・コンポーネントのポリシーの管理」

5.1 SOAコンポジット・アプリケーションの保護の概要

この章では、SOAコンポジット・アプリケーション固有のセキュリティ手順について説明します。ほとんどのSOAコンポジット・アプリケーションのセキュリティ手順は、SOA固有の手順を必要とせず、表5-1に示すドキュメントに従って実行できます。

表5-1 セキュリティに関するドキュメント

セキュリティ情報

参照ガイド

Oracleシングル・サインオン(OSSO)構成を含むOracle Fusion Middlewareの保護

『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』

Webサービスの保護および管理

『Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイド』

Oracle WebLogic Serverのセキュリティの理解

『Oracle Fusion Middleware Oracle WebLogic Serverセキュリティについて』

Oracle WebLogic Serverの本番環境の保護

『Oracle Fusion Middleware Oracle WebLogic Server本番環境の保護』

Oracle WebLogic Serverの保護

『Oracle Fusion Middleware Oracle WebLogic Serverの保護』

Oracle WebLogic Serverで使用する新規セキュリティ・プロバイダの開発

『Oracle Fusion Middleware Oracle WebLogic Serverセキュリティ・プロバイダの開発』

Oracle WebLogic ServerのWebサービスのセキュリティ

『Oracle Fusion Middleware Oracle WebLogic Server WebLogic Webサービスの保護』

Oracle WebLogic Serverのセキュリティ・プログラミング

『Oracle Fusion Middleware Oracle WebLogic Serverセキュリティのプログラミング』

Oracle Business Activity Monitoringの保護

第24.9項「セキュリティの構成」

Oracle User Messaging Serviceの保護

第27.6項「Oracle User Messaging Serviceの保護」

5.2 Oracle WebLogic ServerグループまたはユーザーへのSOAOperatorおよびSOAMonitorロールのマッピング

Oracle WebLogic Serverグループまたはユーザーに対するSOAMonitorおよびSOAOperatorロールのデフォルトのマッピングはありません。これらのロールは、手動でOracle Enterprise Manager Fusion Middleware Controlにマップする必要があります。

次の選択肢があります。

- Oracle WebLogic Server Monitorsグループまたは作成した個々のユーザーにSOAMonitorロールをマッピングする。

- Oracle WebLogic Server Operatorsグループまたは作成した個々のユーザーにSOAOperatorロールをマッピングする。

使用環境に最適なマッピング・オプションを作成します。この項では、両方のオプションの作成方法について説明します。

警告:

Oracle WebLogic Server管理者ロールには、SOAAdminロールのみが自動的にマップされます。対応するOracle WebLogic ServerグループまたはユーザーがOracle SOA Suiteアプリケーション・ロール(SOAMonitor/SOAOperator)にマップされないかぎり、Oracle WebLogic Serverグループ(Monitors/Operators)のみを実行しても、Oracle SOA Suiteコンテンツにアクセスできません。

グループまたはユーザーにSOAMonitorおよびSOAOperatorロールをマップする手順は、次のとおりです。

1. 管理者ロールを持つユーザーとして、Oracle Enterprise Manager Fusion Middleware Controlにログインします。

2. ナビゲータで、「SOA」フォルダを開きます。

3. 「soa-infra」を右クリックして、「セキュリティ」→「アプリケーション・ロール」の順に選択します。

4. 「ロール名」フィールドの右側にある「検索」アイコンをクリックします。
ロールのリストが表示されます。

5. SOAMonitorをクリックして、「編集」を選択します。
「アプリケーション・ロールの編集: SOAMonitor」ページが表示されます。

6. 「追加」アイコンをクリックします。
「プリンシパルの追加」ダイアログが表示されます。

7. 「タイプ」リストから、SOAMonitorのマップ先として、グループか個々のユーザーのいずれかを選択します。

- グループ: Monitorsグループにマッピングする場合。

- ユーザー: 作成した個々のユーザーにマッピングする場合。

8. 「検索」アイコンをクリックします。
「グループ」を選択すると、リストにMonitorsグループが表示されます。「ユーザー」を選択すると、リストに個々のユーザーが表示されます。

9. リストから選択して、「OK」をクリックします。
選択したユーザーまたはグループが「アプリケーション・ロールの編集: SOAMonitor」ページの「メンバー」セクションに追加されます。

10. 「OK」をクリックして変更を保存し、「アプリケーション・ロール」ページに戻ります。

11. 「ロール名」フィールドの右側にある「検索」アイコンをクリックします。
ロールのリストが表示されます。

12. SOAOperatorをクリックして、「編集」を選択します。
「アプリケーション・ロールの編集: SOAOperator」ページが表示されます。

13. 「追加」アイコンをクリックします。
「プリンシパルの追加」ダイアログが表示されます。

14. 「タイプ」リストから、SOAOperatorのマップ先として、グループか個々のユーザーのいずれかを選択します。

- グループ: Operatorsグループにマッピングする場合。

- ユーザー: 作成した個々のユーザーにマッピングする場合。

15. 「検索」アイコンをクリックします。
「グループ」を選択すると、リストにOperatorsグループが表示されます。「ユーザー」を選択すると、リストに個々のユーザーが表示されます。

16. リストから選択して、「OK」をクリックします。
選択したユーザーまたはグループが「アプリケーション・ロールの編集: SOAOperator」ページの「メンバー」セクションに追加されます。

17. 「OK」をクリックして変更を保存し、「アプリケーション・ロール」ページに戻ります。

5.3 Oracle BPM Worklist用のOracle HTTP Serverの構成

Oracle BPM WorklistがOracle HTTP Server経由で動作するように、Oracle HTTP Serverのmod_wl_ohs.confファイルに/integrationの場所を追加する必要があります。

<Location /integration>
SetHandler weblogic-handler
#   PathTrim /weblogic
ErrorPage  http:/WEBLOGIC_HOME:WEBLOGIC_PORT/
</Location>

5.4 SOAインフラストラクチャのSAMLメッセージ保護付きポリシー構成の設定

この項では、Oracle WebLogic Scripting Tool (WLST)を使用して、SOAインフラストラクチャのメッセージ保護付きSecurity Assertion Markup Language (SAML)ポリシー構成を設定および検証する方法を説明します。この項の例では、タスク問合せサービスの構成について説明します。ただし、これらの説明はSAMLトークン・ポートをサポートするすべてのヒューマン・ワークフロー・サービスに関連します。

- アクティビティ・ガイド問合せサービス

- アクティビティ・ガイド・メタデータ・サービス

- アクティビティ・ガイド管理サービス

- タスク問合せサービス

- タスク・サービス

- タスク・メタデータ・サービス

- ランタイム構成サービス

- タスク・エビデンス・サービス

- ユーザー・メタデータ・サービス

別のサービスのポリシーを変更する場合は、同じWLSTコマンドをそのサービスのSAMLトークン・ポートに適用する必要があります。

SAMLメッセージ保護付きポリシー構成を設定する手順は、次のとおりです。

1. WLSTを使用してSOAドメイン(たとえば、base_domain)にログインします。

2. 既存のwss10_saml_token_service_policyというサービス・ポリシーをデタッチします。

wls:/base_domain/domainRuntime> detachWebServicePolicy('/base_domain/soa
_server1/soa-infra','integration/services/TaskQueryService','web',
'WorkflowProvider','TaskQueryServicePortSAML','oracle/
wss10_saml_token_service_policy')

3. アプリケーションを再起動して、ポリシーまたは構成の変更をアクティブ化します。

4. 新しいポリシーをアタッチします。この場合、ポリシーにはoracle/wss10_saml_token_with_message_protection_service_policyという名前が付けられます。

wls:/base_domain/domainRuntime> attachWebServicePolicy('/base_domain/soa
_server1/soa-infra','integration/services/TaskQueryService',
'web','WorkflowProvider','TaskQueryServicePortSAML','ora
cle/wss10_saml_token_with_message_protection_service_policy')

5. アプリケーションを再起動して、ポリシーまたは構成の変更をアクティブ化します。

6. ポリシーを表示して検証します。

wls:/base_domain/domainRuntime> listWebServicePolicies('/base_domain/soa
_server1/soa-infra','integration/services/TaskQueryService',
'web','WorkflowProvider','TaskQueryServicePortSAML')
TaskQueryServicePortSAML :
security :
oracle/wss10_saml_token_with_message_protection_service_policy,
enabled=true
Attached policy or policies are valid; endpoint is secure.

7. キーストアを作成して、orakeyという別名を追加し、Oracle Web Service Manager (OWSM)構成を実行して、SAMLメッセージ保護付きポリシーをアクティブ化します。例:

keytool -genkeypair
-keystore  domain_home/config/fmwconfig/default-keystore.jks
-keyalg RSA
-dname "cn=consumer,dc=example,dc=com"
-alias clientalias
-keypass  password
-storepass password
-validity 3600

keytool -exportcert
-keystore domain_home/config/fmwconfig/default-keystore.jks
-v
-alias clientalias
-storepass password
-rfc
-file domain_home/config/fmwconfig/certificate.cer

keytool -importcert
-keystore domain_home/config/fmwconfig/default-keystore.jks
-alias orakey
-file domain_home/config/fmwconfig/certificate.cer
-storepass password
createCred(map="oracle.wsm.security", key="keystore-csf-key",
user="owsm", password="welcome1", desc="Keystore key")
createCred(map="oracle.wsm.security", key="enc-csf-key",
user="clientalias", password="welcome1", desc="Encryption key")
createCred(map="oracle.wsm.security", key="sign-csf-key",
user="clientalias", password="welcome1", desc="Signing key")

8. サーバーを再起動します。

5.5 Oracle BPM WorklistおよびOracle Business Process Managementユーザーの自動認証

この項では、様々な環境でOracle BPM WorklistおよびOracle Business Process Managementのユーザーを認証する方法について説明します。

5.5.1 SAML SSO環境でのOracle BPM Worklistユーザーの自動認証

SAML SSO環境で最初のOracle BPM Worklistから2番目のOracle BPM Worklistにアクセスするとき自動認証されるようにするには、次の手順を実行する必要があります。この手順を実行しないと、2番目のOracle BPM Worklistにアクセスするときに再度ログインするように求められます。この環境では、最初のOracle BPM WorklistはSAML IDプロバイダとして構成され、アクセスする2番目のOracle BPM WorklistはSAMLサービス・プロバイダとして構成されます。

SAML SSO環境でOracle BPM Worklistユーザーを自動認証する手順は、次のとおりです。

1. /integration/worklistapp/*をworklistappのリダイレクトURLとして、SAMLサービス・プロバイダ・サイトのSAML2IdentityAsserter構成に追加します。

1. Oracle WebLogic Server管理コンソールで、「セキュリティ・レルム」を選択します。

2. サービス・プロバイダのレルムをクリックします。

3. 「プロバイダ」タブを選択し、「認証」サブタブを選択します。

4. プロバイダ・リストから、SAML 2.0 IDアサーション・プロバイダと説明されているプロバイダを選択します。
SAML IDアサーション・プロバイダ構成が見つからない場合は、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』の説明に従ってください。

5. 「管理」タブを選択します。
「管理」タブには、IDプロバイダ・パートナのリストが表示されます。これらは、このSAML IDサービス・プロバイダ・サイトのSAML IDプロバイダ・パートナとして構成されているホストです。この構成手順は、Oracle BPM Worklistがホスト管理されるIDサービス・プロバイダ・サイトで実行されることに注意してください。

6. ユーザーが最初のログインを実行するIDプロバイダ・サイトを選択します。

7. 「リダイレクトURI」フィールドが表示されるまでページを下にスクロールします。

8. /integration/worklistapp/*をリストに追加します。

この手順を実行した後、通常の/integration/worklistappというURLを使用してSAML IDプロバイダ・サイトでOracle BPM Worklistにログインできます。必要に応じて、SAMLサービス・プロバイダ・サイトでURL /integration/worklistapp/ssologinに移動できます。ここで、Oracle BPM Worklistにアクセスして自動認証されます。

SAML2IdentityAsserter、およびWebブラウザとHTTPクライアントを使用したSSOの構成の詳細は、「Oracle Fusion Middleware Oracle WebLogic Serverの保護」を参照してください。

5.5.2 SAML SSO環境でのOracle BPM Workspaceユーザーの自動認証

SAML SSO環境で最初のOracle BPM Workspaceから2番目のOracle BPM Workspaceにアクセスするときに自動的に認証されるようにするには、次の手順を実行する必要があります。この手順を実行しないと、2番目のOracle BPM Workspaceにアクセスするときに再度ログインするように求められます。この環境では、最初のOracle BPM WorkspaceはSAML IDプロバイダとして構成され、アクセスする2番目のOracle BPM WorkspaceはSAMLサービス・プロバイダとして構成されます。

SAML SSO環境でOracle BPM Workspaceユーザーを自動認証する手順は、次のとおりです。

1. workspaceのリダイレクトURLとして、SAMLサービス・プロバイダ・サイトのSAML2IdentityAsserter構成に/bpm/workspace/*を次のように追加します。

1. Oracle WebLogic Server管理コンソールで、「セキュリティ・レルム」を選択します。

2. サービス・プロバイダのレルムをクリックします。

3. 「プロバイダ」タブを選択し、「認証」サブタブを選択します。

4. プロバイダ・リストから、SAML 2.0 IDアサーション・プロバイダと説明されているプロバイダを選択します。
SAML IDアサーション・プロバイダ構成が見つからない場合は、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』の説明に従ってください。

5. 「管理」タブを選択します。
「管理」タブには、IDプロバイダ・パートナのリストが表示されます。これらは、このSAML IDサービス・プロバイダ・サイトのSAML IDプロバイダ・パートナとして構成されているホストです。この構成手順は、Oracle BPM Workspaceがホスト管理されるIDサービス・プロバイダ・サイトで実行されることを忘れないでください。

6. ユーザーが最初のログインを実行するIDプロバイダ・サイトを選択します。

7. 「リダイレクトURI」フィールドが表示されるまでページを下にスクロールします。

8. リストに/bpm/workspace/*を追加します。

この手順の実行後は、/bpm/workspaceの通常のURLを使用してSAML IDプロバイダにあるOracle BPM Workspaceにログインできます。必要に応じて、SAMLサービス・プロバイダ・サイトでURL /bpm/workspace/ssologinに移動でき、ここからOracle BPM Workspaceにアクセスすると自動認証されます。

SAML2IdentityAsserter、およびWebブラウザとHTTPクライアントを使用したSSOの構成の詳細は、「Oracle Fusion Middleware Oracle WebLogic Serverの保護」を参照してください。

5.5.3 SAML SSO環境でのOracle Business Process Composerユーザーの自動認証

SAML SSO環境で最初のOracle Business Process Composerから2番目のOracle Business Process Composerにアクセスするときに自動的に認証されるようにするには、次の手順を実行する必要があります。この手順を実行しないと、2番目のOracle Business Process Composerにアクセスするときに再度ログインするように求められます。この環境では、最初のOracle Business Process ComposerはSAML IDプロバイダとして構成され、アクセスする2番目のOracle Business Process ComposerはSAMLサービス・プロバイダとして構成されます。

SAML SSO環境でOracle Business Process Composerユーザーを自動認証する手順は、次のとおりです。

1. composerのリダイレクトURLとして、SAMLサービス・プロバイダ・サイトのSAML2IdentityAsserter構成に/bpm/composer/*を次のように追加します。

1. Oracle WebLogic Server管理コンソールで、「セキュリティ・レルム」を選択します。

2. サービス・プロバイダのレルムをクリックします。

3. 「プロバイダ」タブを選択し、「認証」サブタブを選択します。

4. プロバイダ・リストから、SAML 2.0 IDアサーション・プロバイダと説明されているプロバイダを選択します。
SAML IDアサーション・プロバイダ構成が見つからない場合は、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』の説明に従ってください。

5. 「管理」タブを選択します。
「管理」タブには、IDプロバイダ・パートナのリストが表示されます。これらは、このSAML IDサービス・プロバイダ・サイトのSAML IDプロバイダ・パートナとして構成されているホストです。この構成手順は、Oracle Business Process Composerがホスト管理されるIDサービス・プロバイダ・サイトで実行されることを忘れないでください。

6. ユーザーが最初のログインを実行するIDプロバイダ・サイトを選択します。

7. 「リダイレクトURI」フィールドが表示されるまでページを下にスクロールします。

8. リストに/bpm/composer/*を追加します。

この手順の実行後は、/bpm/composerの通常のURLを使用してSAML IDプロバイダにあるOracle Business Process Composerにログインできます。必要に応じて、SAMLサービス・プロバイダ・サイトでURL /bpm/composer/ssologinに移動でき、ここからOracle Business Process Composerにアクセスすると自動認証されます。

SAML2IdentityAsserter、およびWebブラウザとHTTPクライアントを使用したSSOの構成の詳細は、「Oracle Fusion Middleware Oracle WebLogic Serverの保護」を参照してください。

5.5.4 Windowsのネイティブ認証環境でのOracle BPM Worklistユーザーの自動認証

Kerberosを使用したWindowsのネイティブ認証をOracle BPM Worklistで使用するには、保護されたURL /integration/worklistapp/ssologinを使用する必要があります。たとえば、Windowsのネイティブ認証を構成した後は、次のようにOracle BPM Worklistにアクセスします。

http://host_name.domain_name:8001/integration/worklistapp/ssologin

Microsoftクライアントを使用したSSOの構成については、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』を参照してください。

5.5.5 Windowsのネイティブ認証環境でのOracle Business Process Composerユーザーの自動認証

Kerberosを使用したWindowsのネイティブ認証をOracle Business Process Composerで使用するには、保護されたURL bpm/composer/ssologinを使用する必要があります。たとえば、Windowsのネイティブ認証を構成した後は、次のようにProcess Composerにアクセスします。

http://host_name.domain_name:8001/bpm/composer/ssologin

Microsoftクライアントを使用したSSOの構成については、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』を参照してください。

5.6 認証プロバイダの設定

この項では、最初の認証プロバイダを設定する方法を説明します。

5.6.1 Oracle Internet Directoryを最初の認証プロバイダとして表示

Oracle BPM Worklistおよびワークフロー・サービスでは、Java Platform Security (JPS)と、ユーザーおよびロールAPIが使用されます。このため、Oracle Internet Directoryでワークフローが使用されるときは、Oracle Internet Directoryオーセンティケータが最初のプロバイダとして表示される必要があります。Oracle Internet Directoryが最初に表示されない場合(たとえば、DefaultAuthenticatorの下に表示される場合)、ログイン認証は失敗します。

認証プロバイダの順序の変更方法については、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』を参照してください。

5.6.2 デフォルトの認証プロバイダを使用したWebベースのアプリケーションへのアクセス

Oracle Internet Directoryの認証を使用している場合、Webベースのアプリケーションへのログインが失敗することがあります。これは、Oracle WebLogic Serverの構成が、デフォルトの認証の前にOracle Internet Directoryの認証を使用するように設定されている場合に起こります。

この場合、次のエラーが発生することがあります。

"@ User "weblogic" is not found in configuration "jazn.com" Check if the user
exists in the repository specified by the configurations. Check the error stack
and fix the cause of the error. Contact oracle support if error is not fixable."

セキュリティ・プロバイダの順序は次のようにしてください。

1. デフォルトの認証

2. Oracle Internet Directory/LDAP認証

5.7 NTLM認証をリクエストするWebサービスの起動

NT LAN Manager (NTLM)認証をリクエストするWebサービスを起動しようとするときは、composite.xmlファイルで次のプロパティを設定する必要があります。

- oracle.webservices.auth.username

- oracle.webservices.auth.password

- oracle.webservices.preemptiveBasicAuth

oracle.webservices.preemptiveBasicAuthは、falseに設定する必要があります。

例5-1に詳細を示します。

例5-1 NTLM認証が構成されたcomposite.xmlファイル

<reference name="Service1" ui:wsdlLocation="test1.wsdl">
<interface.wsdl
interface="http://tempuri.org/#wsdl.interface(IService1)"/>
<binding.ws

port="http://tempuri.org/#wsdl.endpoint(Service1/BasicHttpBinding_IService1)"
location="test1.wsdl" soapVersion="1.1">
<property name="weblogic.wsee.wsat.transaction.flowOption"
type="xs:string" many="false">WSDLDriven</property>

<property name="oracle.webservices.auth.username"
type="xs:string" many="false">test</property>
<property name="oracle.webservices.auth.password"
type="xs:string" many="false">password</property>
<property name="oracle.webservices.preemptiveBasicAuth"
type="xs:string" many="false">false</property>
</binding.ws>
</reference>

これらのプロパティを設定していない場合は、BPELプロセスがWebサービスを起動しようとしたときに次のエラーが発生します。

setting preemptive basic auth" and "invoke failed...Bad response: 401 Unauthorized

5.8 SSLの構成

この項では、Oracle SOA SuiteおよびOracle Business Process Managementの環境でSecure Socket Layer (SSL)を構成する方法について説明します。

5.8.1 HTTPSポートで構成されたSOA/BPMサーバーでのSSL証明書の使用

SOA/BPMサーバーがHTTPSポートで構成されている場合は、SSL証明書が次の標準に従っていることを確認します。

- サーバーがSSLクライアント(ブラウザ、または通知送信者などの他の内部クライアント)に提示する証明書は、その独自のトラスト・ストア(CAストア)で信頼される証明書です。

- サーバーの証明書が自己署名されている場合は、その証明書がトラスト・ストアに追加されていることを確認します。つまり、サーバーが提示する証明書は、サーバーのトラスト・ストアに対する自己検証が必要です。

このようにされていない場合は、タスク通知の送信時に問題が発生する可能性があります。たとえば、サーバーの出力ログ(例: soa_server1.out)で例5-2に示されるようなエラー・メッセージを受信する場合があります。

例5-2 タスク通知エラー

<Sep 13, 2011 12:59:41 AM PDT> <Error> <oracle.soa.services.workflow.common>
<BEA-000000> <<.>
ORABPEL-0
at
oracle.bpel.services.workflow.task.notification.
TaskNotifications.getEmailPaylOad
(TaskNotifications.java:1354)
at
oracle.bpel.services.workflow.task.notification.
TaskNotifications.getEmailNotificationContent
(TaskNotifications.java:987)
at
weblogic.jms.client.JMSSession$UseForRunnable.run
(JMSSession.java:5170)
at
weblogic.work.SelfTuningWorkManagerImpl$WorkAdapterImpl.run(SelfTuningWorkManagerI
mpl.java:528)
at weblogic.work.ExecuteThread.execute(ExecuteThread.java:209)
at weblogic.work.ExecuteThread.run(ExecuteThread.java:178)
Caused By: javax.net.ssl.SSLKeyException: [Security:090477]Certificate chain
received from myhost.us.example.com - 10.232.152.78 was not trusted causing
SSL handshake failure.
at
com.certicom.tls.interfaceimpl.TLSConnectionImpl.
fireException(UnknownSource)
at
com.certicom.tls.interfaceimpl.TLSConnectionImpl.
fireAlertSent(UnknownSource)
at
com.certicom.tls.record.handshake.HandshakeHandler.
fireAlert(Unknown Source).
ficationContent(TaskNotifications.java:987)
at
weblogic.jms.client.JMSSession$UseForRunnable.run(JMSSession.java:5170)
at
weblogic.work.SelfTuningWorkManagerImpl$WorkAdapterImpl.run(SelfTuningWorkManagerI
mpl.java:528)
at weblogic.work.ExecuteThread.execute(ExecuteThread.java:209)
at weblogic.work.ExecuteThread.run(ExecuteThread.java:178)
Caused By: javax.net.ssl.SSLKeyException: [Security:090477]Certificate chain
received from myhost.us.example.com - 10.232.152.78 was not trusted causing
SSL handshake failure.
at
com.certicom.tls.interfaceimpl.TLSConnectionImpl.
fireException(UnknownSource)
at
com.certicom.tls.interfaceimpl.TLSConnectionImpl.
fireAlertSent(UnknownSource)
at
com.certicom.tls.record.handshake.HandshakeHandler.
fireAlert(Unknown Source

概要および構成の詳細は、「Oracle Fusion Middleware Oracle WebLogic Serverの保護」を参照してください。

5.8.2 SSLで管理対象サーバーを全部構成する、または構成しないための推奨事項

SSL (SOA、BAMなど)で管理対象サーバーを全部構成するか、構成しないかのいずれかをベスト・プラクティスとしてお薦めします。一部の管理対象サーバーをSSLで構成し、他の管理対象サーバーを構成しないと、Oracle BPM WorklistおよびOracle Web Services Manager (OWSM)では好ましくない結果になる可能性があります。たとえば、SSL構成された管理対象サーバー(bam_server)が存在する場合、SSLの構成がないサーバーはOWSMでは使用されません。SSL構成されたサーバーが停止した場合、OWSMは停止状態になり、Oracle BPM Worklistが停止状態になる原因となります。

5.8.3 Oracle BPM Worklistでの非SSLからSSL構成への切替

Oracle BPM Worklistで非SSLからSSL構成に切り替えるには、Oracle WebLogic Server管理コンソールで「フロントエンド・ホスト」および「フロントエンドHTTPSポート」フィールドを設定する必要があります。設定しないと、To-Doタスクを作成するときに例外エラーが発生します。

Oracle BPM Worklistで非SSLからSSL構成に切り替える手順は、次のとおりです。

1. Oracle WebLogic Server管理コンソールにログインします。

2. 「環境」セクションで、「サーバー」を選択します。

3. 管理対象サーバーの名前(たとえば、soa_server1)を選択します。

4. 「プロトコル」を選択し、次に「HTTP」を選択します。

5. 「フロントエンド・ホスト」フィールドに、Oracle BPM Worklistがあるホスト名を入力します。

6. 「フロントエンドHTTPSポート」フィールドに、SSLリスナー・ポートを入力します。

7. 「保存」をクリックします。

5.8.4 SOAコンポジット・アプリケーションの双方向SSL通信の構成

Oracle SOA Suiteでは、Oracle WebLogic ServerとOracle Secure Socket Layer (SSL)スタックの両方を使用し、て双方向SSL通信を構成します。

- インバウンドのWebサービス・バインディングの場合、Oracle SOA SuiteではOracle WebLogic Serverインフラストラクチャを使用し、SSL用にOracle WebLogic Serverライブラリを使用します。

- アウトバウンドのWebサービス・バインディングの場合、Oracle SOA SuiteはJRF HttpClientを使用するため、SSLにはOracle JDKライブラリを使用します。

このように違いがあるため、次のJVMオプションを使用してOracle WebLogic Serverを起動します。

SOAコンポジット・アプリケーションの双方向SSL通信を構成する手順は、次のとおりです。

1. 次のファイルを開きます。

- UNIXオペレーティング・システムでは、$MIDDLEWARE_HOME/user_projects/domains/domain_name/bin/setDomainEnv.shを開きます。

- Windowsオペレーティング・システムでは、MIDDLEWARE_HOME\user_projects\domains\domain_name\bin\setDomainEnv.batを開きます。

2. サーバーで一方向SSL(サーバー認可のみ)が有効化されている場合は、次の行をJAVA_OPTIONSセクションに追加します。

-Djavax.net.ssl.trustStore=your_truststore_location

双方向SSLの場合は、キーストア情報(場所とパスワード)は不要です。

また、次の手順を実行してSOAコンポジット・アプリケーションの双方向SSLが別のSOAコンポジット・アプリケーションまたは別の非SOAアプリケーションを起動できるようにします。

注意:

サーバーとクライアントの両方が相互認証でSSL用に構成されていることが前提となります。

SOAコンポジット・アプリケーションが別のアプリケーションを呼び出すために双方向SSLを有効化する手順は、次のとおりです。

1. クライアント側で、キーストアの場所を指定します。

1. 「SOAインフラストラクチャ」メニューから、「SOA管理」→「共通プロパティ」の順に選択します。

2. ページの下部で、「詳細SOAインフラ拡張構成プロパティ」をクリックします。

3. 「KeystoreLocation」をクリックします。

4. 「値」列に、キーストアの場所を入力します。

5. 「適用」をクリックします。

6. 「戻る」をクリックします。

2. Oracle JDeveloperでの設計時に、composite.xmlファイル内の参照セクションをoracle.soa.two.way.ssl.enabledプロパティで更新します。

<reference name="Service1"
ui:wsdlLocation=". . .">
<interface.wsdl interface=". . ."/>
<binding.ws port=". . .">
<property name="oracle.soa.two.way.ssl.enabled">true</property>
</binding.ws>
</reference>

3. Oracle Enterprise Manager Fusion Middleware Controlで、「WebLogicドメイン」→「domain_name」の順に選択します。

4. 「domain_name」を右クリックし、「セキュリティ」→「資格証明」の順に選択します。

5. 「マップの作成」をクリックします。

6. 「マップ名」フィールドに名前(SOAなど)を入力し、「OK」をクリックします。

7. 「キーの作成」をクリックします。

8. 次の詳細を入力します。

フィールド

説明

マップの選択

ステップ6で作成したマップ(この場合はSOA)を選択します。

キー

キー名を入力します(KeystorePasswordがデフォルトです)。

タイプ

「パスワード」を選択します。

ユーザー名

ユーザー名を入力します(KeystorePasswordがデフォルトです)。

パスワード

キーストアに対して作成したパスワードを入力します。

注意:

SSLをOracle WebLogic Serverで設定する場合は、キーの別名が必要です。別名の値として「mykey」を入力する必要があります。この値は必須です。

9. Oracle Enterprise Manager Fusion Middleware Controlでキーストアの場所を設定します。方法については、ステップ1を参照してください。

10. httpsおよびsslportを使用してSOAコンポジット・アプリケーションを起動するように、composite.xmlを変更します。たとえば、次の太字で示されている構文を変更します。

<?xml version="1.0" encoding="UTF-8" ?>
<!-- Generated by Oracle SOA Modeler version 1.0 at [4/1/09 11:01 PM]. -->
<composite name="InvokeEchoBPELSync"
revision="1.0"
label="2009-04-01_23-01-53_994"
mode="active"
state="on"
xmlns="http://xmlns.oracle.com/sca/1.0"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy"
xmlns:orawsp="http://schemas.oracle.com/ws/2006/01/policy"
xmlns:ui="http://xmlns.oracle.com/soa/designer/">
<import
namespace="http://xmlns.oracle.com/CustomApps/InvokeEchoBPELSync/BPELProcess1"
location="BPELProcess1.wsdl" importType="wsdl"/>
<import namespace="http://xmlns.oracle.com/CustomApps/EchoBPELSync/
BPELProcess1"location="http://hostname:port/soa-infra/services/default/EchoBPEL
Sync/BPELProcess1.wsdl"
importType="wsdl"/>

httpsおよびsslportを使用するように変更します。

location="https://hostname:sslport/soa-infra/services/default/EchoBPELSync
/BPELProcess1.wsdl"

5.8.5 Oracle JDeveloperの一方向SSL環境での参照の呼出し

Webサービスを一方向SSL環境でSOAコンポジット・アプリケーションからの外部参照として呼び出す場合は、サーバーの証明書名(CN)とホスト名が完全に一致することを確認します。これにより、正しいSSLハンドシェイクが保証されます。

たとえば、Webサービスの名前がadfbcで、証明書のサーバー名がmyhost05の場合、次の構文ではSSLハンドシェイク例外が発生します。

<import namespace="/adfbc1/common/"

location="https://myhost05.us.example.com:8002/CustomApps-adfbc1-context-root/Ap
pModuleService?WSDL"
importType="wsdl"/>
<import namespace="/adfbc1/common/" location="Service1.wsdl"
importType="wsdl"/>

importの順序を入れ替えると、SSLハンドシェイクに成功します。

<import namespace="/adfbc1/common/" location="Service1.wsdl"
importType="wsdl"/>
<import namespace="/adfbc1/common/"
location="https://myhost05.us.example.com:8002/CustomApps-adfbc1-context-root/Ap
pModuleService?WSDL"
importType="wsdl"/>

この問題に関連して次の制限があります。

- Oracle WebLogic Server管理コンソールにあるようなホスト名の検証を無視するオプションはOracle JDeveloperにありません。これは、Oracle JDeveloperで使用されているSSLキットが異なるためです。トラスト・ストアのみコマンドラインから構成できます。他のすべての証明書引数は渡されません。

- WSDLファイルで、https://hostnameは前述のように証明書内の名前と一致する必要があります。ブラウザで行う場合と同じ手順は実行できません。たとえば、証明書のCNのホスト名がmyhost05.us.example.comの場合、ブラウザではmyhost05、myhost05.us.example.comまたはIPアドレスを使用できます。Oracle JDeveloperでは、必ず証明書内の名前と同じ名前(myhost05.us.example.com)を使用する必要があります。

5.8.6 Oracle SOA SuiteおよびOracle HTTP ServerのSSL通信の構成

ここでは、Oracle SOA SuiteとOracle HTTP Server間でSSL通信を構成する手順について説明します。

5.8.6.1 Oracle HTTP ServerのSSL通信の構成

Oracle HTTP ServerのSSL通信を構成する手順は、次のとおりです。

1. <Location /integration/services>場所ディレクティブを使用してmod_ssl.confを更新します。

LoadModule weblogic_module   ${ORACLE_HOME}/ohs/modules/mod_wl_ohs.so

<IfModule mod_weblogic.c>
WebLogicHost host.domain.com
WLLogFile <logdir>/ohs_ssl.log
Debug ALL
DebugConfigInfo ON
SecureProxy ON
MatchExpression *.jsp
WlSSLWallet <OHS_
HOME>/instances/instance1/config/OHS/ohs1/keystores/default
</IfModule>

<Location /soa-infra>
WebLogicPort 8002
SetHandler weblogic-handler
ErrorPage http://host.domain.com:port/error.html
</Location>

<Location /b2bconsole>
WebLogicPort 8002
SetHandler weblogic-handler
ErrorPage http://host.domain.com:port/error.html
</Location>

<Location /b2b>
WebLogicPort 8002
SetHandler weblogic-handler
ErrorPage http://host.domain.com:port/error.html
</Location>

<Location /integration/worklistapp>
WebLogicPort 8002
SetHandler weblogic-handler
ErrorPage http://host.domain.com:port/error.html
</Location>

<Location /integration/services>
WebLogicPort 8002
SetHandler weblogic-handler
ErrorPage http://host.domain.com:port/error.html
</Location>

<Location /DefaultToDoTaskFlow>
WebLogicPort 8002
SetHandler weblogic-handler
ErrorPage http://host.domain.com:port/error.html
</Location>

<Location /OracleBAM>
WebLogicPort 9002
SetHandler weblogic-handler
ErrorPage http://host.domain.com:port/error.html
</Location>

<Location /OracleBAMWS>
WebLogicPort 9002
SetHandler weblogic-handler
ErrorPage  http://host.domain.com:port/error.html
</Location>

<Location /sdpmessaging/userprefs-ui/>
WebLogicPort 8002
SetHandler weblogic-handler
ErrorPage http://host.domain.com:port/error.html
</Location>

2. 第5.8.4項「SOAコンポジット・アプリケーションの双方向SSL通信の構成」の説明に従って、Oracle WebLogic Serverを起動します。

5.8.6.2 Oracle Client、Oracle HTTP ServerおよびOracle WebLogic Serverの証明書の構成

Oracle Client、Oracle HTTP ServerおよびOracle WebLogic Serverの証明書を構成する手順は、次のとおりです。

1. Oracle HTTP Serverウォレットからユーザー証明書をエクスポートします。

orapki wallet export -wallet . -cert cert.txt  -dn 'CN=\"Self-Signed
Certificate for ohs1 \",OU=OAS,O=ORACLE,L=REDWOODSHORES,ST=CA,C=US'

2. エクスポートした証明書をOracle WebLogic Serverトラスト・ストアに信頼できる証明書としてインポートします。

keytool -file cert.txt -importcert -trustcacerts -keystore DemoTrust.jks

3. Oracle WebLogic Serverトラスト・ストアから証明書をエクスポートします。

keytool -keystore DemoTrust.jks -exportcert -alias wlscertgencab -rfc -file
certgencab.crt

4. エクスポートした証明書をOracle HTTP Serverウォレットに信頼できる証明書としてインポートします。

orapki wallet add -wallet . -trusted_cert -cert certgencab.crt -auto_login_only

5. Oracle HTTP Serverを再起動します。

6. 第5.8.4項「SOAコンポジット・アプリケーションの双方向SSL通信の構成」の説明に従って、Oracle WebLogic Serverを再起動します。

5.8.7 SOAコンポジット・アプリケーション・インスタンスとOracle WebCache間のSSLの構成

Oracle WebCacheおよびOracle HTTP Server環境では、「Webサービスのテスト」ページでOracle WebCacheとの通信が必要になる場合があります。したがって、SOAコンポジット・アプリケーション・インスタンスとOracle WebCache間でSSLを構成する必要があります(つまり、ユーザー証明書をOracle WebCacheウォレットからエクスポートし、その証明書をOracle WebLogic Serverトラスト・ストアに信頼できる証明書としてインポートします)。

5.8.8 設計時の一方向SSLでのカスタム・トラスト・ストアの使用

keytoolやorapkiなどのツールで作成したカスタム・トラスト・ストアを使用している場合にHTTPSを介してSOAコンポジット・アプリケーションを別のコンポジットから起動するには、Oracle JDeveloperで次の操作を実行します。

設計時に一方向SSLでカスタム・トラスト・ストアを使用する手順は、次のとおりです。

1. 参照セクションでWSDLファイルをフェッチするには、「ツール」→「プリファレンス」→「HTTPアナライザ」→「HTTPS設定」→「クライアントの信頼する証明書キーストア」でトラスト・ストア情報を設定します。

2. SSL対応サーバーへのデプロイメント時に、コマンドラインでJSSEプロパティを使用します。

jdev -J-Djavax.net.ssl.trustStore=your_trusted_location

5.8.9 SSL対応の管理対象サーバーにデプロイ済の非同期プロセスの有効化による、HTTPを介した別の非同期プロセスの呼出し

次の環境を作成するとします。

- 非同期BPELプロセスAが非同期BPELプロセスBを起動する

- 非同期BPELプロセスAは一方向SSL対応の管理対象サーバーにデプロイされる

- すべてのWSDL参照およびバインディングでプレーンHTTPを使用する

実行時に、WSDLはHTTPSを介して検索され、非同期BPELプロセスBからのコールバック・メッセージが失敗します。

この問題を解決するには、callbackServerURLプロパティをcomposite.xmlファイルの参照バインディング・レベルで渡す必要があります。これは、特定の参照呼出しのコールバックURLの値を示します。クライアント・コンポジットがSSL管理対象サーバーで実行されている場合、コールバックはデフォルトでSSLになります。

<reference name="Service1"
ui:wsdlLocation="http://localhost:8000/soa-infra/services/default/AsyncSecondB
PELMTOM/BPELProcess1.wsdl">
<interface.wsdl
interface="http://xmlns.oracle.com/Async/AsyncSecondBPELMTOM/BPELProcess1#wsdl
.interface(BPELProcess1)"
callbackInterface="http://xmlns.oracle.com/Async/AsyncSecondBPELMTOM/BPELProce
ss1#wsdl.interface(BPELProcess1Callback)"/>
<binding.ws
port="http://xmlns.oracle.com/Async/AsyncSecondBPELMTOM/BPELProcess1#wsdl.endp
oint(bpelprocess1_client_ep/BPELProcess1_pt)"

location="http://localhost:8000/soa-infra/services/default/AsyncSecondBPELMTOM
/bpelprocess1_client_ep?WSDL">
<wsp:PolicyReference URI="oracle/wss_username_token_client_policy"
orawsp:category="security"
orawsp:status="enabled"/>
<wsp:PolicyReference URI="oracle/wsaddr_policy"
orawsp:category="addressing"
orawsp:status="enabled"/>
.
<property name="callbackServerURL">http://localhost:8000/</property>
.
</binding.ws>
.
<callback>
<binding.ws
port="http://xmlns.oracle.com/Async/AsyncSecondBPELMTOM/BPELProcess1#wsdl.endp
oint(bpelprocess1_client_ep/BPELProcess1Callback_pt)">
<wsp:PolicyReference
URI="oracle/wss_username_token_service_policy"
orawsp:category="security"
orawsp:status="enabled"/>
</binding.ws>
</callback>

.
</reference>

5.9 ヒューマン・ワークフローWSDLファイルに対するセキュリティの構成

ヒューマン・ワークフロー・サービスのWSDLファイルを外部コンシューマに公開しない場合は、各サービスのWSDL公開フラグをfalseに設定します。

<expose-wsdl>false</expose-wsdl>

6 SOAコンポジット・アプリケーションの監視

この章では、SOAコンポジット・アプリケーションのパフォーマンス・サマリー・メトリック、最新のインスタンス、最新のフォルトおよび拒否メッセージを、SOAコンポジット・アプリケーションで監視する方法について説明します。リカバリが必要なBPELプロセス・メッセージの詳細を表示する方法、およびBPELプロセス・サービス・エンジンの「リカバリ」ページにアクセスしてメッセージ・リカバリを実行する方法についても説明します。

この章では、次の項目について説明します。

- 第6.1項「SOAコンポジット・アプリケーションのパフォーマンス・サマリー・メトリックの監視」

- 第6.2項「SOAコンポジット・アプリケーションの最新のインスタンスとフォルトおよび拒否メッセージの監視」

詳細は、第1.2.2項「SOAコンポジット・アプリケーションの概要」を参照してください。

6.1 SOAコンポジット・アプリケーションのパフォーマンス・サマリー・メトリックの監視

「パフォーマンス・サマリー」ページでは、SOAコンポジット・アプリケーションのパフォーマンス・メトリックのサマリーを表示できます。

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

SOAコンポジットのメニューから...

ナビゲータのSOAフォルダから...

1. 「監視」→「パフォーマンス・サマリー」を選択します。

1. 「soa-infra」の下にあるパーティションを展開します。

2. 特定のSOAコンポジット・アプリケーションを選択します。

3. 「SOAコンポジット」メニューから、「監視」→「パフォーマンス・サマリー」を選択します。

「パフォーマンス・サマリー」ページには、デフォルトで次の情報がグラフィック表示されています。

- サーバーの最終再起動以降のSOAコンポジット・アプリケーション・インスタンスの合計数。

- サーバーの最終再起動以降のフォルトの合計数。

2. 「メトリック・パレットの表示」をクリックすると、SOAコンポジット・アプリケーションのすべてのメトリックの階層ツリーが表示されます。このツリーは、メトリックをパフォーマンス・データの様々なカテゴリで整理しています。

3. フォルダを開き、「メトリック・パレット」のメトリックを選択すると、時間の経過に応じたメトリックの変化を示すパフォーマンス・グラフが表示されます。このグラフは自動的にリフレッシュされ、更新されたデータが表示されます。

4. 「スライダ」をクリックしてスライダ・ツールを表示すると、グラフに表示する時間枠を指定できます。

「パフォーマンス・サマリー」ページの詳細は、「パフォーマンス・サマリー」ページのオンライン・ヘルプ、およびOracle Fusion Middleware管理者ガイドのOracle Fusion Middlewareのパフォーマンスの表示に関する項を参照してください。

SOAインフラストラクチャのパフォーマンス・サマリー・メトリックの監視の詳細は、第4.2項「SOAインフラストラクチャのパフォーマンス・サマリー・メトリックの監視」を参照してください。

メッセージ配信処理リクエストの監視の詳細は、第4.4項「メッセージ配信リクエスト処理の監視」を参照してください。

サービス・エンジン統計の監視の詳細は、下記を参照してください。

- 第14.6項「BPELプロセス・サービス・エンジンのリクエスト統計とスレッド・パフォーマンス統計の監視」

- 第17.3.3項「リクエストのブレークダウン統計の監視」

- 第20.2項「ビジネス・ルール・サービス・エンジンのパフォーマンス統計の監視」

- 第22.5項「ヒューマン・ワークフロー・サービス・エンジンのアクティブ・リクエストと操作パフォーマンス統計の監視」

- 第40.5項「BPMNプロセス・サービス・エンジンのリクエスト統計とスレッド・パフォーマンス統計の監視」

6.2 SOAコンポジット・アプリケーションの最新のインスタンスとフォルトおよび拒否メッセージの監視

SOAコンポジット・アプリケーションの「ダッシュボード」ページから、SOAコンポジット・アプリケーションの最新のインスタンスとフォルトおよび拒否メッセージを監視できます。このページには、アプリケーションの最新の状態に関する高レベルの概要が表示されます。

SOAコンポジット・アプリケーションの最新のインスタンス、フォルトおよび拒否メッセージを監視する手順は次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にあるパーティションを展開します。

2. 特定のSOAコンポジット・アプリケーションを選択します。

2. 「ダッシュボード」をクリックします(選択されていない場合)。
「ダッシュボード」ページの上部には、次の詳細が表示されます。

- コンポジットのライフサイクルの状態のサマリー。「ダッシュボード」ページの上部に、実行中のインスタンス数、合計インスタンス数、コンポジットのモード(「アクティブ」または「リタイア」)などが表示されます。

- このページに表示される最新のインスタンスとフォルトの取得は指定した期間内に制限されることを示すメッセージ。このメッセージは、「SOAインフラストラクチャの共通プロパティ」ページで「インスタンスとフォルトの表示を次に制限: 過去time_period」チェック・ボックスが選択されている場合に表示されます(デフォルトで選択されています)。期間のデフォルト値は24時間ですが、この値は変更できます。このチェック・ボックスが選択されていない場合は、最後のパージ以降のSOAインフラストラクチャにおけるインスタンスとフォルト(数のメトリックを含む)がすべて表示されます。

- SOAコンポジット・アプリケーションの最新のインスタンスの詳細。インスタンスID、名前、対話ID、状態(たとえば、「失敗」、「完了」)および開始時間が表示されます。

- 最新のフォルトと拒否メッセージの詳細。エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、フォルトの場所(サービス、サービス・コンポーネントまたは参照)、SOAコンポジット・アプリケーションのインスタンスID、およびフォルトが記述されているログ・ファイルへのリンクが表示されます。
BPELプロセス・サービス・エンジンの「リカバリ」ページからのリカバリを待機しているメッセージがある場合は、各SOAコンポジット・アプリケーションのホーム・ページの上部にメッセージが表示されます。

3. BPELプロセス・メッセージに対して、BPELプロセス・サービス・エンジンの「リカバリ」ページからリカバリが必要な場合、「必須のBPELメッセージ・リカバリ」メッセージが各SOAインフラストラクチャのホーム・ページの上部に表示されます。

このメッセージ・リカバリ情報の表示は、システムMBeanブラウザの AuditConfigプロパティのbpelRecoveryStatus、excludeBpelMaxCreationTime、およびbpelRecoveryAlertDurationInDaysのキーによって制御されます。このプロパティは、SOAインフラストラクチャの「共通プロパティ」ページの「詳細SOAインフラ拡張構成プロパティ」セクションからアクセスできます。デフォルトでは、これらのキーには次の値が設定されています。

- bpelRecoveryStatusは、Allに設定されます。

- excludeBpelMaxCreationTimeは、直前5分間にリカバリを必要とするメッセージの表示を除外するように設定されています。

- bpelRecoveryAlertDurationInDaysは、リカバリ可能BPELメッセージが直前7日間に作成されている場合のみ、「必須のBPELメッセージ・リカバリ」警告メッセージを表示するように設定されています。

1. 次の作業を実行します。

クリックするリンク

操作

詳細の表示

BPELプロセス・サービス・エンジンの「リカバリ」ページからリカバリが必要な呼出しメッセージ、コールバック・メッセージおよびアクティビティ・メッセージの数を示すメッセージを表示します。BPELメッセージの自動リカバリが有効になっている場合、手動リカバリは不要です。その場合は、消耗済メッセージのみを手動でリカバリする必要があります。「リフレッシュ」をクリックして、リカバリが必要な呼出しメッセージ、コールバック・メッセージおよびアクティビティ・メッセージの数を再計算します。

BPELリカバリ・コンソールに移動

BPELプロセス・サービス・エンジンの「リカバリ」ページにアクセスして、メッセージ・リカバリを実行します。

また、後で「リカバリ」ページにアクセスするには、「SOAインフラストラクチャ」メニューから「サービス・エンジン」→「BPEL」を選択し、表示されたページで「リカバリ」タブをクリックします。

詳細は、第15.4項「BPELプロセス・サービス・エンジンのメッセージ・リカバリの実行」を参照してください。

時間しきい値の設定

リカバリが必要なメッセージを除外する期間を示すメッセージを表示します。デフォルト設定では、過去5分間のメッセージが除外されます。この値は、SOAインフラストラクチャの「共通プロパティ」ページにあるAuditConfigプロパティのexcludeBpelMaxCreationTimeキーによって制御されます。この値を変更するには、「はい」をクリックします。

アラートの無効化

このメッセージ・リカバリ情報が「ダッシュボード」ページに表示されないようにできるメッセージを表示します。「はい」をクリックすると、このメッセージ・リカバリ情報は表示されなくなります。

この情報を「ダッシュボード」ページに再度表示するには、「SOAインフラストラクチャの共通プロパティ」ページの「詳細SOAインフラ拡張構成プロパティ」セクションで、AuditConfigプロパティのbpelRecoveryStatusキーをAllに設定します。詳細は、第3.1項「SOAインフラストラクチャ・プロパティの構成」を参照してください。

4. 「最新のインスタンス」セクションで、次のタスクを実行します。

1. 「インスタンス数」リンクをクリックして、このSOAコンポジット・アプリケーションの実行中のインスタンス数と合計インスタンス数を示すメッセージを表示します。デフォルトでは、このリンクは表示されません。このリンクを表示するには、次を選択します: 「インスタンス数およびフォルト数をフェッチするメトリックを無効にします。この場合でも各メトリックは必要に応じて取得できます。」チェック・ボックス(「SOAインフラストラクチャの共通プロパティ」ページ)。
「SOAインフラストラクチャの共通プロパティ」ページで「インスタンスとフォルトの表示を次に制限: 過去time_period」チェック・ボックスを選択し、期間を指定するか、またはデフォルト値の24時間を受け入れた場合は、その期間内のこのSOAコンポジット・アプリケーションにおける実行中のインスタンス数と合計インスタンス数が表示されます。このチェック・ボックスを選択していない場合は、最後のパージ以降のこのSOAコンポジット・アプリケーションにおけるインスタンスとフォルトがすべて表示されます。「再計算」をクリックすると、これらの数が再計算されます。

2. 「インスタンスID」列で、特定のインスタンスIDをクリックし、コンポジット・アプリケーションに関するすべてのインスタンス詳細(フローのトレース、および各コンポーネントの監査証跡)を取得します。これによって、インスタンス間の一連のメッセージ・フローにおけるフォルトが表示されます。

注意:

「コンポジット・インスタンスの状態をキャプチャ」チェック・ボックスを選択しない場合、「最新のインスタンス」セクションには、フォルト・リカバリが必要なインスタンスが「実行中」と表示されません。ただし、インスタンスの状態をキャプチャするかどうかに関係なく、リカバリが必要なインスタンスは引き続き実行中で、このページの「コンポーネント・メトリック」セクションの「リカバリ可能」列に表示されます。

3. セクションの下部にある「詳細の表示」をクリックして、SOAコンポジット・アプリケーションの「インスタンス」ページにアクセスします。

5. 「最新のフォルトと拒否メッセージ」セクションで、次のタスクを実行します。

1. 「エラー・メッセージ」列で、エラー・メッセージをクリックし、フォルトに関する完全な情報を表示します。フォルトがリカバリ可能と識別されている場合は、「ここでリカバリ」リンクをクリックし、フォルト・リカバリを実行します。

2. フォルトがリカバリ可能と識別されている場合は、「リカバリ」列で「リカバリ」をクリックし、コンポーネント・インスタンス・レベルでフォルト・リカバリを実行します。

3. 「フォルトの場所」列で、特定の場所をクリックし、サービス、サービス・コンポーネントまたは参照の「ダッシュボード」ページにアクセスします。

4. 「コンポジット・インスタンスID」列で、コンポジット・インスタンスIDをクリックし、そのフォルトが含まれるメッセージのフローのトレースにアクセスします。これによって、インスタンス間の一連のメッセージ・フローにおけるフォルトが表示されます。

5. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、特定の失敗したインスタンスがフィルタされて表示されます。

6. セクションの下部にある「詳細の表示」をクリックして、SOAコンポジット・アプリケーションの「フォルトと拒否メッセージ」ページにアクセスします。

「ダッシュボード」ページの下部には、次の詳細が表示されます。

- SOAコンポジット・アプリケーションで使用されているサービス・コンポーネントの名前とタイプ、実行中のインスタンス数と合計インスタンス数、各サービス・コンポーネントのリカバリ可能およびリカバリ不可の失敗したインスタンスの数。

- SOAコンポジット・アプリケーションで使用されているサービス・バインディング・コンポーネント(インバウンド)および参照バインディング・コンポーネント(アウトバウンド)の名前とタイプ、バインディング・コンポーネントのフォルト件数、処理メッセージの合計、および平均メッセージ処理時間。

「コンポーネント・メトリック」セクションの「失敗したインスタンス」列には、リカバリ可能およびリカバリ不可のフォルトの件数が表示されます。リカバリ可能なフォルトに関連するコンポーネント・インスタンスは、フォルトと見なされません。このようなインスタンスは、ライフ・サイクルの終わりに達していないため、実行中と見なされます。これらのインスタンスは、「再試行」、「再スロー」、「中断」などのリカバリ・オプションを使用してリカバリできます。このページの「最新のインスタンス」セクションおよび「フォルト・メッセージと拒否メッセージ」ページにはリカバリ可能とリカバリ不可を区別せずにフォルトの件数が表示されるため、このフォルト件数と異なる場合があります。

6. 「コンポーネント・メトリック」セクションの「名前」列で、サービス・コンポーネントをクリックします。選択したサービス・コンポーネントのホーム・ページが表示され、インスタンス、フォルトおよびポリシーに関する具体的な詳細が表示されます。

7. 「サービスと参照」セクションの「名前」列で、サービスまたは参照をクリックします。該当するホーム・ページが表示され、インスタンス、フォルト、ポリシー、拒否メッセージおよびメッセージ・ヘッダー構成プロパティに関する具体的な詳細が表示されます。

注意:

SOAインフラストラクチャの「インスタンス」ページおよび「フォルト・メッセージと拒否メッセージ」ページに移動して、それぞれですべてのデプロイ済コンポジットのインスタンスおよびフォルトを監視することもできます。ここで特定のコンポジットをクリックすると、さらに詳細を表示できます。

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

- 第1.2.3項「SOAコンポジット・アプリケーション・インスタンスの概要」

- 第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」

- 第1.2.5項「バインディング・コンポーネントの概要」

- 第8.4項「SOAインフラストラクチャ・レベルでの、SOAコンポジット・アプリケーションのフォルトのリカバリ」

- 第8.5項「アプリケーションのホーム・ページでの、SOAコンポジット・アプリケーションのフォルトのリカバリ」

- ログ・ファイルの表示および検索については、『Oracle Fusion Middleware管理者ガイド』を参照してください

7 SOAコンポジット・アプリケーションのデプロイおよび管理

この章では、SOAコンポジット・アプリケーションのデプロイおよび管理方法について説明します。これには、デプロイ済コンポジットの状態の管理、Oracle Enterprise Manager Fusion Middleware ControlからのSOAコンポジット・アプリケーションのデプロイ、再デプロイ、アンデプロイ、SOAコンポジット・アプリケーションのテストの自動化、ポリシー管理、デプロイ済コンポジットのエクスポート、コンポジットのパーティションへのグループ化、BPELおよびBPMNモニターの管理が含まれます。

この章では、次の項目について説明します。

- 第7.1項「SOAコンポジット・アプリケーションのデプロイ」

- 第7.2項「アンデプロイメントまたは再デプロイメント時のインスタンス、フォルトおよび拒否メッセージの失効状態への更新」

- 第7.3項「SOAコンポジット・アプリケーションの再デプロイ」

- 第7.4項「SOAコンポジット・アプリケーションのアンデプロイ」

- 第7.5項「デプロイ済SOAコンポジット・アプリケーションの状態管理」

- 第7.6項「SOAコンポジット・アプリケーションのテストの自動化」

- 第7.7項「SOAコンポジット・アプリケーションのポリシーの管理」

- 第7.8項「デプロイ済のSOAコンポジット・アプリケーションのエクスポート」

- 第7.9項「SOAコンポジット・アプリケーションのパーティションへのグループ化」

- 第7.10項「BPELおよびBPMNのビジネス監視の有効化と無効化」

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

- SOAコンポジット・アプリケーション・アーカイブ、およびテスト、開発および本番の各環境で使用するURLとプロパティ値を定義する構成プランの作成方法については、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

- antスクリプトを使用したデプロイについては、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

- Oracle WebLogic Scripting Tool (WLST)を使用したデプロイの詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

注意:

Oracle Enterprise Manager Fusion Middleware Controlがシングル・サインオン(SSO)対応の環境で実行されている場合は、SOAコンポジットのデプロイ、SOAコンポジットのアンデプロイおよびSOAコンポジットの再デプロイの各ウィザードの最後のステップの一部として、ユーザー名およびパスワード資格証明の入力を再度求められます。この情報は、Oracle Enterprise Manager Fusion Middleware Controlセッションごとに1回のみ要求されます。

7.1 SOAコンポジット・アプリケーションのデプロイ

SOAコンポジット・アプリケーションは、「SOAコンポジットのデプロイ」ウィザードを使用して、Oracle Enterprise Manager Fusion Middleware Controlからデプロイできます。最初に、デプロイ可能なアーカイブをOracle JDeveloperで作成するか、antやWLSTコマンドライン・ツールを使用して作成する必要があります。この「SOAコンポジットのデプロイ」ウィザードを使用して、次のいずれかをデプロイします。

- 最初の新規SOAコンポジット・アプリケーション。

- 旧リビジョン(1.0など)と新リビジョン(2.0など)。旧リビジョンへの影響はありません。最後にデプロイされたリビジョンが、そのコンポジットの新しいデフォルト・リビジョンになります(デプロイメントのこの後の手順で他のリビジョンを指定しない場合にかぎります)。

- 異なるリビジョン(たとえば、1.0)が現在デプロイされているSOAコンポジット・アプリケーションの複数のリビジョン(たとえば、2.0、3.0および4.0)を含むSOAバンドル(ZIPファイル)。このオプションでは、リビジョン1.0、2.0、3.0および4.0をまとめてデプロイできます。SOAバンドルをデプロイすると、すべてのコンポジットが順序に従ってデプロイされます。例:

deploy Composite1 + activate Composite1 -> deploy CompositeN + activate CompositeN

バンドルには、異なるコンポジットのリビジョンを含めることもできます。すべてのリビジョンが同じコンポジット・アプリケーションのリビジョンである必要はありません。ただし、同じバンドル内にコンポジット間の相互参照は存在できません。たとえば、コンポジットAのリビジョン1.0はコンポジットBのリビジョン1.0を参照できません。

デプロイメントによって、SOAインフラストラクチャのコンポジット・アプリケーションが抽出されてアクティブ化されます。アプリケーションをデプロイした後は、インスタンスの作成、プロパティの構成、パフォーマンスの監視、インスタンスの管理、ポリシーとフォルトの管理などの管理タスクを実行できます。

注意:

- アプリケーションの既存のリビジョンを再デプロイする場合は、このウィザードを使用しないでください。かわりに、「SOAコンポジットの再デプロイ」ウィザードを使用してください。

- ユーザーOracleSystemUserは削除しないでください。SOAコンポジット・アプリケーションのデプロイメントなど、Oracle SOA Suiteが正常に機能するには、このユーザーが必要です。

SOAコンポジット・アプリケーションをデプロイする手順は次のとおりです。

1. 次のいずれかのオプションを使用して、「SOAコンポジットのデプロイ」ウィザードにアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

「SOAインフラストラクチャ・ホーム」ページから...

SOAコンポジットのメニューから...

1. 「SOAデプロイ」→「デプロイ」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「SOAデプロイ」→「デプロイ」の順に選択します。

1. 「デプロイ済コンポジット」タブをクリックします。

2. 「コンポジット」表の上にある「デプロイ」をクリックします。

1. 「SOAデプロイ」→「別のコンポジットをデプロイ」の順に選択します。

注意:

また、次の方法を使用しても、「SOAコンポジットのデプロイ」ウィザードにアクセスできます。

- 「パーティションの管理」ページ、または個別のパーティションのホーム・ページの「デプロイメント」ドロップダウン・リストから、「このパーティションにデプロイ」を選択

- 個別のパーティションのホーム・ページの上部にある「SOAパーティション」から

- ナビゲータ内で個別のパーティションを右クリック

「アーカイブの選択」ページが表示されます。

2. 「アーカイブまたは展開済ディレクトリ」セクションで、デプロイするSOAコンポジット・アプリケーションのアーカイブを指定します。このアーカイブには、デプロイするコンポジットのプロジェクト・ファイルが含まれています(単一アーカイブの場合のHelloWorld_rev1.0.jar、複数アーカイブの場合のOrderBooking_rev1.0.zipなど)。この情報は必須です。

3. 「構成プラン」セクションで、アーカイブに含める構成プランを指定します(オプション)。構成プランを使用して、異なる環境で使用するURLおよびプロパティ値を定義できます。プロセス・デプロイメント時に、構成プランを使用して、次のターゲット環境にプロジェクトを適合させるために置き換える必要がある値をSOAプロジェクトで検索します。

4. 「次へ」をクリックします。
「ターゲットの選択」ページが表示されます。

このページには、SOAコンポジット・アプリケーション・アーカイブをデプロイする先のOracle SOA Suite管理対象サーバーまたはクラスタがリストされます。

5. このSOAコンポジット・アプリケーションをデプロイする先のパーティションを選択します。パーティションを使用すると、SOAコンポジット・アプリケーションを異なるセクションに論理的にグループ化できます。使用可能なパーティションが1つのみである場合も、そのパーティションを明示的に選択する必要があります。デプロイした後は、コンポジットを別のパーティションに転送できなくなります。
存在しないパーティションにSOAコンポジット・アプリケーションをデプロイする場合は、ウィザードを終了し、コンポジットをデプロイする前にパーティションを作成します。「SOAインフラストラクチャ」メニューからアクセスできる「パーティションの管理」ページでパーティションを作成します。

サーバーにパーティションが含まれていない場合は、そのサーバーにコンポジット・アプリケーションをデプロイできません。また、サーバーが実行中状態でない場合は、このアーカイブをデプロイできません。デフォルトでは、「デフォルト」という名前のパーティションが、Oracle SOA Suiteに自動的に作成されます。デフォルト・パーティションは削除できます。

注意:

タスク・マップ済属性(以前はフレックス・フィールド・マッピングと呼ばれていました)やルール(休暇ルールなど)などのヒューマン・ワークフロー・アーティファクトは、タスク定義のネームスペースに基づいて定義されます。このため、ヒューマン・ワークフロー・タスクを持つ同じSOAコンポジット・アプリケーションが複数のパーティションにデプロイされると、次の問題が発生します。

- 同じタスク定義タイプの場合は、あるパーティションに定義されているマップ済属性が、別のパーティションに表示されます。

- あるパーティションのタスク定義に定義されているルールを、別のパーティションの同じ定義に適用できます。

「パーティションの管理」ページまたは特定のパーティションのホーム・ページの「デプロイメント」ドロップダウン・リストから「このパーティションにデプロイ」を選択して「SOAコンポジットのデプロイ」ウィザードを起動する場合は、デプロイ先のパーティションが選択されています。したがって、「ターゲットの選択」ページはスキップされます。

6. 「次へ」をクリックします。
「確認」ページが表示されます。

7. 選択内容を確認します。
SOAコンポジット・アプリケーションでグローバル・トークン変数を使用している場合は、システムのmdm-url-resolver.xmlファイルですべてのトークンが構成済であることを確認するよう求める警告メッセージが表示されます。トークンがシステムで構成されていない場合、または場所が不適切な場合(たとえば、composite.xmlファイルのimportセクション)、SOAコンポジット・アプリケーションはデプロイされず、エラー・メッセージが表示されます。グローバル・トークン変数の管理の詳細は、第3.8項「複数のSOAコンポジット・アプリケーションのグローバル・トークン変数の管理」を参照してください。

8. SOAコンポジット・アプリケーションをデフォルトのリビジョンとしてデプロイするかどうかを選択します。デフォルトのリビジョンは、新しいリクエストを受信するとインスタンス化されます。

9. 「デプロイ」をクリックします。
処理メッセージが表示されます。

この時点では、デプロイメント操作を取り消すことができません。ブラウザ・ページを閉じてもデプロイメントは続行されます。

10. デプロイメントが完了すると、新規にデプロイしたコンポジット・リビジョンのホーム・ページが自動的に表示されます。ページの上部に、コンポジットが正常にデプロイされたことを示す確認メッセージが表示されます。バンドルのデプロイメントの場合は、SOAインフラストラクチャの「デプロイ済コンポジット」ページが表示されます。

構成プランを作成する方法、およびOracle JDeveloperからアプリケーションをデプロイする方法については、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

7.1.1 複数のADFタスク・フォーム・デプロイメントのPermGenメモリー要件

ADFタスク・フォームのデプロイメントごとに、SOAおよびBPMサーバーのメモリー消費量は増加します。一般的な推奨事項として、本番環境でPermGenメモリーの設定が要求されていない場合は、Oracle JRockitを使用してください。

本番環境でOracle JDKを使用する必要があるときに複数のタスク・フォームをデプロイしてjava.lang.OutOfMemoryError: PermGen spaceエラーが発生した場合は、$Domain/bin/setSOADomainEnv.shファイルのPermGenメモリー(Unix)、またはDOMAIN_HOME\bin\setSOADomainEnv.cmdファイル (Windows)を環境に適した値に更新します。

7.1.2 タスク・フローを持つSOAコンポジット・アプリケーションのデプロイ

タスク・フローのEnterprise Resource Archive (EAR)ファイルを持つSOAコンポジット・アプリケーションを、Oracle Enterprise Manager Fusion Middleware ControlまたはOracle WebLogic Server管理コンソールから複数パーティションの環境にデプロイする場合は、パーティションの詳細を指定できません。パーティションを指定するには、生成されるEARファイル(ファイルのプロジェクト・バージョンが変更されません)にパーティション名を含めるようにhwtaskflow.xmlファイルを変更します。このファイルは、TaskFormプロジェクトのadfmsrcディレクトリ(たとえば、HelpDeskRequestTaskFlow\adfmsrc\hwtaskflow.xml)にあります。例7-1に詳細を示します。

例7-1 hwtaskflow.xmlファイル

<hwTaskFlows
xmlns="http://xmlns.oracle.com/bpel/workflow/hwTaskFlowProperties">
<ApplicationName>worklist</ApplicationName>
<LookupType>LOCAL</LookupType>
<TaskFlowDeploy>false</TaskFlowDeploy>
<PartitionName>partition2</PartitionName>

7.1.3 antスクリプトおよびWLSTコマンドライン・ツールによるSOAコンポジット・アプリケーションのデプロイ

SOAコンポジット・アプリケーションは、antスクリプトおよびWLSTコマンドライン・ツールを使用してもデプロイできます。

- antスクリプトを使用したデプロイの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

- WLSTを使用したデプロイの詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

7.2 アンデプロイメントまたは再デプロイメント時のインスタンス、フォルトおよび拒否メッセージの失効状態への更新

SOAコンポジット・アプリケーションをアンデプロイまたは再デプロイする際は、インスタンス、フォルト、および拒否メッセージの一部の状態の動作が失効に更新されます。この項では、次のインスタンス、フォルト、および拒否メッセージで、どの状態が失効に更新されるかについて説明します。

- SOAコンポジット・アプリケーションのインスタンス

- Oracle Mediatorインスタンス

- BPELプロセス・インスタンス

- Oracle BPMNインスタンス

- ヒューマン・ワークフロー・タスク・インスタンス

- ビジネス・ルール・インスタンス

- Oracle B2Bインスタンス

- 参照バインディング・コンポーネント・インスタンス

- 拒否メッセージ

- コンポジット・インスタンスのフォルト

注意:

SOAコンポジット・アプリケーション・インスタンスに関する次の詳細に注意してください。

- 失効としてマークされなくなったインスタンスでもパージは可能です。

- フォルトありまたはなしで完了したインスタンスは、アンデプロイメントまたは再デプロイメント時に失効には変更されないことになります。これは、リリース11g R1 (11.1.1.6)以前からの変更点です。

表7-1は、SOAコンポジット・アプリケーションの再デプロイメントまたはアンデプロイメントの際に失効に更新される状態を示しています。

表7-1 アンデプロイメントまたは再デプロイメント時に、失効に更新されるインスタンス、フォルトおよび拒否メッセージの状態

要素

失効に更新されるインスタンス、フォルトおよび拒否メッセージの状態

SOAコンポジット・アプリケーションのインスタンス

次のインスタンスは、失効に更新されます。

- 実行中

- リカバリが必要

- 一時停止

失効に更新される具体的な状態番号および状態は次のとおりです。

- 0 実行中

- 2 フォルトありで実行中

- 4 リカバリが必要で実行中

- 5 リカバリが必要で完了

- 6 フォルトおよびリカバリが必要で実行中

- 7 フォルトおよびリカバリが必要で完了

- 8 一時停止ありで実行中

- 9 一時停止ありで完了

- 10 フォルトおよび一時停止ありで実行中

- 11 フォルトおよび一時停止ありで完了

- 12 リカバリが必要および一時停止ありで実行中

- 13 リカバリが必要および一時停止ありで完了

- 14 フォルト、リカバリが必要および一時停止ありで実行中

- 15 フォルト、リカバリが必要および一時停止ありで完了

- 16 停止ありで実行中

- 18 フォルトおよび停止ありで実行中

- 20 リカバリが必要および停止ありで実行中

- 21 リカバリが必要および停止ありで完了

- 22 フォルト、リカバリが必要および停止ありで実行中

- 23 フォルト、リカバリが必要および停止ありで完了

- 24 一時停止および停止ありで実行中

- 25 一時停止および停止ありで完了

- 26 フォルト、一時停止および停止ありで実行中

- 27 フォルト、一時停止および停止ありで完了

- 28 リカバリが必要、一時停止および停止ありで実行中

- 29 リカバリが必要、一時停止および停止ありで完了

- 30 フォルト、リカバリが必要、一時停止および停止ありで実行中

- 31 フォルト、リカバリが必要、一時停止および停止ありで完了

- 36 リカバリが必要

- 38 リカバリが必要でフォルト

Oracle Mediatorインスタンス

次のインスタンス状態は、関連コンポジットが再デプロイおよびアンデプロイされると、失効に更新されます。

- 実行中

- リカバリが必要

失効に更新される具体的な状態番号および状態は次のとおりです。

- 4 リカバリが必要

- 5 中断およびリカバリが必要

- 6 フォルトおよびリカバリが必要

- 7 中断、フォルトおよびリカバリが必要

- 8 実行中

- 9 中断ありで実行中

- 10 フォルトありで実行中

- 11 中断およびフォルトありで実行中

- 12 リカバリが必要で実行中

- 13 中断およびリカバリが必要で実行中

- 14 フォルトおよびリカバリが必要で実行中

- 15 中断、フォルトおよびリカバリが必要で実行中

BPELプロセス・インスタンス

次のインスタンス状態は、関連コンポジットが再デプロイおよびアンデプロイされると、失効に更新されます。

- 実行中

- リカバリが必要

Oracle BPMN

次のインスタンス状態は、関連コンポジットが再デプロイおよびアンデプロイされると、失効に更新されます。

- 実行中

- リカバリが必要

ヒューマン・ワークフロー・タスク・インスタンス

次のタスク・インスタンス状態は、関連コンポジットが再デプロイおよびアンデプロイされると失効に更新されます。

- 割当て済

- 情報のリクエスト中

- 結果を更新

- 一時停止

- アラート済

ビジネス・ルール・インスタンス

次のインスタンス状態は、関連コンポジットが再デプロイおよびアンデプロイされると、失効に更新されます。

- 実行中

- 正常に完了しました

- フォルト

参照バインディング・コンポーネント・インスタンス

参照バインディング・コンポーネント・インスタンスは、失効への更新が行われません。かわりに、参照バインディング・コンポーネントの元の状態が保持されます。

- 2 正常終了

- 3 ポリシーの障害

- 31 ビジネス・フォルト

- 32 フォルト (ポリシーまたはビジネス以外)

拒否メッセージ

拒否メッセージに関連付けられた次のエラー・カテゴリは、失効に更新されます。

- システム

- ビジネス

- ポリシー

- 失効

- 不明

コンポジット・インスタンスのフォルト

コンポジット・インスタンス・フォルトに関連付けられた次のエラー・カテゴリは、失効に更新されます。

- システム

- ビジネス

- ポリシー

- 失効

- 不明

再デプロイメントおよびアンデプロイメントの詳細は、第7.3項「SOAコンポジット・アプリケーションの再デプロイ」および第7.4項「SOAコンポジット・アプリケーションのアンデプロイ」を参照してください。

7.3 SOAコンポジット・アプリケーションの再デプロイ

SOAコンポジット・アプリケーションは、「SOAコンポジットの再デプロイ」ウィザードを使用して、Oracle Enterprise Manager Fusion Middleware Controlから再デプロイできます。「SOAコンポジットの再デプロイ」ウィザードを使用すると、次のような結果になります。

- 現在デプロイされているSOAコンポジット・アプリケーションのリビジョンの新規バージョンが同じデプロイメント・ターゲットに再デプロイされます(たとえば、古いバージョン1.0が新規バージョン1.0として再デプロイされます)。

- このリビジョンの古いデプロイ済バージョンがインスタンスを実行中の場合は、これらのインスタンスの状態を失効に変更するかどうかを選択できます。「SOAコンポジットの再デプロイ」ウィザードの「実行中インスタンス」セクションの説明は、手順6を参照してください。
インスタンスの状態はインスタンス・リストで使用可能であり、監査およびフローのトレースの詳細にアクセスできます。

再デプロイメント時に失効に更新されるインスタンス、フォルト、拒否メッセージの状態の詳細は、第7.2項「アンデプロイメントまたは再デプロイメント時のインスタンス、フォルトおよび拒否メッセージの失効状態への更新」を参照してください。

注意:

- デプロイされたアプリケーションの複数のリビジョンを管理する場合(例: リビジョン1.0および2.0)、このウィザードを使用しないでください。かわりに「SOAコンポジットのデプロイ」ウィザードを使用してください。

- 複数のSOAコンポジット・アプリケーションを一度に再デプロイする機能はサポートされていません。

アプリケーションを再デプロイする手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

「SOAインフラストラクチャ・ホーム」ページから...

SOAコンポジットのメニューから...

1. 「SOAデプロイ」→「再デプロイ」の順に選択します。
「コンポジットの選択」ページが表示されます。

2. 「SOAコンポジット・デプロイ」セクションで、再デプロイするSOAコンポジット・アプリケーションのリビジョンを選択し、「次へ」をクリックします。

1. 「soa-infra」を右クリックします。

2. 「SOAデプロイ」→「再デプロイ」の順に選択します。
「コンポジットの選択」ページが表示されます。

3. 「SOAコンポジット・デプロイ」セクションで、再デプロイするSOAコンポジット・アプリケーションのリビジョンを選択し、「次へ」をクリックします。

1. 「デプロイ済コンポジット」タブをクリックします。

2. 「コンポジット」表で、特定のSOAコンポジット・アプリケーションを選択します。一度に再デプロイできるのは1つのアプリケーションのみです。

3. 「コンポジット」表の上にある「再デプロイ」をクリックします。

1. 「SOAデプロイ」→「再デプロイ」の順に選択します。

注意:

「SOAコンポジットの再デプロイ」ウィザードには、パーティションを右クリックし、「SOAデプロイ」→「再デプロイ」の順に選択することによってもアクセスできます。

「アーカイブの選択」ページが表示されます。

2. 「アーカイブまたは展開済ディレクトリ」セクションで、再デプロイするSOAコンポジット・アプリケーションのリビジョンの場所を選択します。

3. 「構成プラン」セクションで、アーカイブに含める構成プランを指定します(オプション)。

4. 「次へ」をクリックします。
「確認」ページが表示されます。

5. 「デフォルトのリビジョン」セクションで、SOAコンポジット・アプリケーションを、デフォルトのリビジョンとして再デプロイするかどうかを選択します。

6. 「実行中インスタンス」セクションで、再デプロイされるSOAコンポジット・アプリケーションの現在のインスタンスの実行を継続するかどうかを選択します。

- 実行中インスタンスを失効状態に変更

- 選択すると、SOAコンポジット・アプリケーションが再デプロイされた後に、現在実行中のインスタンスの状態が失効に変更されます。

注意:

SOAコンポジット・アプリケーション・インスタンスの状態が失効になっても、このコンポジットに含まれているBPELプロセス・サービス・コンポーネントのインスタンス状態は、失効ではなく完了として存続します。これは、パフォーマンス上の理由で行われ、予想される動作です。

- 再デプロイ時にインスタンスを続行(現在のインスタンス状態は変更されません)

注意:

このオプションは、Oracle BPM SuiteがSOAインフラストラクチャにインストールされている場合に表示され、BPMコンポジットのデプロイメントに対してのみサポートされます。次のようなデプロイでは、このオプションを選択しないでください。

- Oracle BPM SuiteもインストールされているSOAインフラストラクチャ環境からのSOAコンポジット・アプリケーション

- 永続的なBPELプロセスが含まれているBPMコンポジット(そのプロセスが変更されているかどうかにかかわらず)。永続的なBPELプロセスとは、実行が完了するまで時間がかかるプロセスです。永続的なBPELプロセスの例には、非同期プロセス(非同期プロセスは常に永続プロセスです)や、waitアクティビティなどの永続的なアクティビティが含まれる同期プロセスがあります。
このオプションを選択して永続的なBPELプロセスを再デプロイしようとすると、デプロイメントは失敗します。

- 選択すると、BPMコンポジット・アプリケーションが再デプロイされた後も、インスタンスの実行は継続されます。この場合、これらのインスタンスの状態は失効に変更されません。
各サービス・コンポーネントのインスタンスは、それぞれ再デプロイ後に異なる動作を行います。次の詳細事項を理解しておいてください:

対象

説明

Oracle Business Process Management Notation (BPMN)のインスタンス

インスタンスを手動で移行する必要があります。

BPMNサービス・コンポーネントのインスタンスは、再デプロイ後にOracle Enterprise Manager Fusion Middleware Controlで実行中と表示されます。ただし、再デプロイしたアプリケーションが正常に実行されるようにするため、Oracle BPMワークスペースで、移行が保留中の状態のインスタンスを検索して、これらのインスタンスを新しいコンポーネント定義に手動で移行します。

Oracle BPELプロセス、デシジョン・サービス(ビジネス・ルール)、Oracle Mediatorおよびヒューマン・ワークフローのインスタンス

インスタンスは自動的に移行されます。

Oracle Enterprise Manager Fusion Middleware Controlは、これらのコンポーネントのインスタンスを自動的に移行する処理を試行します。移行に成功すると、SOAコンポジット・アプリケーションが再デプロイされます。ただし、次のコンポーネント・インスタンスの一部が移行できなかった場合、コンポジット全体の再デプロイメントは失敗します。

- BPELインスタンス: コンポジットに以前のリビジョンから変更されたBPELプロセス・サービス・コンポーネントが含まれている場合、この機能はサポートされません。

- Oracle Mediator: 新しいコンポーネント定義で互換性についてチェックします。既存のコンポーネント定義と互換性がない場合、コンポジット・リビジョンの再デプロイメントは失敗します。しかし、再デプロイメント時に、このコンポジットの実行中のインスタンスでOracle Mediatorプロセスのすべてが完了している場合は、定義変更による影響はなく再デプロイメントが成功します。Oracle Mediatorインスタンスは短時間で完了するため、移行では、再デプロイメントが失敗する高いリスクはありません。

- デシジョン・サービス: コンポジット定義が変更され、既存のコンポーネント定義と互換性がない場合、コンポジット・リビジョンの再デプロイメントは失敗となる可能性があります。しかし、再デプロイメント時に、このコンポジットの実行中のインスタンスでデシジョン・サービス・プロセスのすべてが完了している場合は、定義変更による影響はなく再デプロイメントが成功します。デシジョン・サービス・インスタンスは短時間で完了するため、移行では、再デプロイメントが失敗する高いリスクはありません。

- ヒューマン・ワークフロー: ヒューマン・ワークフローの変更は、作成されている既存のユーザー・タスクには影響しません。再デプロイメント後に新規に作成されたヒューマン・タスクでは、新しいルーティング・スリップを使用できます。

7. 「再デプロイ」をクリックします。
処理メッセージが表示されます。

この時点では、デプロイメント操作を取り消すことができません。ブラウザ・ページを閉じてもデプロイメントは続行されます。

8. 再デプロイが完了した後は、「閉じる」をクリックします。
再デプロイメントが完了すると、新規に再デプロイしたコンポジット・リビジョンのホーム・ページが自動的に表示されます。ページの上部に、コンポジットが正常に再デプロイされたことを示す確認メッセージが表示されます。

7.4 SOAコンポジット・アプリケーションのアンデプロイ

SOAコンポジット・アプリケーションは、「SOAコンポジットのアンデプロイ」ウィザードを使用して、Oracle Enterprise Manager Fusion Middleware Controlからアンデプロイできます。「SOAコンポジットのアンデプロイ」ウィザードを使用すると、次のような結果になります。

- アプリケーションのこのリビジョンの構成や監視ができなくなります。

- また、アプリケーションのこのリビジョンのインスタンスも処理できなくなります。

- 現在実行中のインスタンスの状態は「失効」に変更され、このコンポジットに送信した新規メッセージは処理されません。

- アンデプロイしたコンポジット・アプリケーションのインスタンスの状態は「失効」に設定されます。インスタンスの状態はインスタンス・リストで使用可能であり、監査証跡およびフローのトレースの詳細にアクセスできます。

- SOAコンポジット・アプリケーションのデフォルトのリビジョン(たとえば、2.0)をアンデプロイした場合、アプリケーションの次に使用可能なアクティブなリビジョン(たとえば、1.0)が新しいデフォルトとして自動的に指定されます。

- デフォルトのコンポジット・リビジョンをアンデプロイした場合、このウィザードの終了時に警告メッセージが表示されます。
使用可能なアクティブ・リビジョンが存在しない場合にデフォルトのリビジョンをアンデプロイすると、コンポジットが新しい受信リクエストを処理できなくなる可能性があります。デフォルトのリビジョンをアンデプロイする前に、デプロイ済のコンポジットのアクティブなリビジョンを最低1つは設定しておくことをお薦めします。

このリビジョンをアンデプロイしたときに、そのコンポジットのアクティブなリビジョンが見つからない場合、リタイア済のリビジョンが自動的に新しいデフォルトのリビジョンとして指定されます。このウィザードを閉じた後に、警告メッセージが表示されます。リタイア済のコンポジット内の現在実行中のインスタンスはすべて正常に終了しますが、これらのインスタンスは受信リクエストを処理することはできません。現在のデフォルトのリビジョンをアンデプロイした後に、このコンポジットに対する新規の受信リクエストを処理するには、新しいリビジョンをデプロイするか、以前にリタイアしたリビジョンを再アクティブ化する必要があります。

アンデプロイメント時に更新され失効となるインスタンス、フォルト、拒否メッセージの状態の詳細は、第7.2項「アンデプロイメントまたは再デプロイメント時のインスタンス、フォルトおよび拒否メッセージの失効状態への更新」を参照してください。

注意:

現在のアプリケーションの既存のリビジョンをアンデプロイしてから再デプロイする場合、このウィザードを使用しないでください。かわりに「SOAコンポジットの再デプロイ」ウィザードを使用してください。「SOAコンポジットの再デプロイ」ウィザードを使用すれば、SOAコンポジット・アプリケーションの既存のリビジョンを再デプロイし、リビジョンの現在デプロイされているバージョンの古い方を削除(上書き)できます。

アプリケーションをアンデプロイする手順は、次のとおりです。

注意:

複数のSOAコンポジット・アプリケーションが同じパーティションにある場合は、まとめてアンデプロイできます。詳細は、第7.9項「SOAコンポジット・アプリケーションのパーティションへのグループ化」を参照してください。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

「SOAインフラストラクチャ・ホーム」ページから...

SOAコンポジットのメニューから...

1. 「SOAデプロイ」→「アンデプロイ」の順に選択します。
「コンポジットの選択」ページが表示されます。

2. 「SOAコンポジット・デプロイ」セクションで、アンデプロイする特定のSOAコンポジット・アプリケーションを選択し、「次へ」をクリックします。

1. 「soa-infra」を右クリックします。

2. 「SOAデプロイ」→「アンデプロイ」の順に選択します。
「コンポジットの選択」ページが表示されます。

3. 「SOAコンポジット・デプロイ」セクションで、アンデプロイする特定のSOAコンポジット・アプリケーションを選択し、「次へ」をクリックします。

1. 「デプロイ済コンポジット」タブをクリックします。

2. 「コンポジット」表で、特定のSOAコンポジット・アプリケーションを選択します。一度にアンデプロイできるのは1つのアプリケーションのみです。

3. 「コンポジット」表の上にある「アンデプロイ」をクリックします。

1. 「SOAデプロイ」→「アンデプロイ」の順に選択します。

注意:

「SOAコンポジットのアンデプロイ」ウィザードには、次の追加のパーティション・オプションを使用してアクセスすることもできます。

- パーティションを右クリックし、「SOAデプロイ」→「このパーティションからすべてアンデプロイ」の順に選択します。

- パーティションのホーム・ページで「デプロイメント」→「このパーティションからすべてアンデプロイ」の順に選択します。

- 「パーティションの管理」ページで、選択したパーティションに対して「デプロイメント」→「このパーティションからすべてアンデプロイ」の順に選択します。

「確認」ページが表示されます。

2. 確認した後は、「アンデプロイ」をクリックします。デプロイ済コンポジット・アプリケーションの最後に残ったリビジョンをアンデプロイしようとすると、警告が表示されます。

処理メッセージが表示されます。

この時点では、アンデプロイ操作を取り消すことができません。ブラウザ・ページを閉じてもアンデプロイメントは続行されます。

3. アンデプロイメントが完了すると、SOAインフラストラクチャの「デプロイ済コンポジット」ページが自動的に表示されます。ページの上部に、コンポジットが正常にアンデプロイされたことを示す確認メッセージが表示されます。

注意:

パーティションが削除されると、そのパーティション内のすべてのSOAコンポジット・アプリケーションが自動的にアンデプロイされます。そのパーティション内のすべてのアプリケーションがアンデプロイされることを示すメッセージが表示されます。

7.5 デプロイ済SOAコンポジット・アプリケーションの状態管理

デプロイ済のSOAコンポジット・アプリケーションのライフサイクルの状態は、次の2つのページのいずれかから管理できます。

- SOAインフラストラクチャの「デプロイ済コンポジット」ページ。このページには、SOAインフラストラクチャにデプロイされたすべてのSOAコンポジット・アプリケーションがリストされます。

- 特定のSOAコンポジット・アプリケーションのアプリケーション・ホーム・ページ(すべてのタブ)。

実行できる管理タスクは、使用しているページによって異なります。表7-2に詳細を示します。

表7-2 アプリケーションの状態に関するアクション

アクション

SOAインフラストラクチャの「デプロイ済コンポジット」ページでの実行の可否

アプリケーションのホーム・ページ(すべてのタブ)での実行の可否

停止と起動

はい

はい

リタイアとアクティブ化

はい

はい

デフォルトとして設定

はい

- 不可: コンポジット・アプリケーションの1つのバージョンのみがデフォルトとして設定されている場合。

- 可: 同じコンポジット・アプリケーションのバージョンが複数ある場合は、デフォルトのバージョンを除き、同じコンポジットの他の全バージョンでこのオプションが表示されます。

デプロイ

はい

可(「コンポジット」メニューから「SOAデプロイ」→「別のコンポジットをデプロイ」の順に選択)

アンデプロイ

はい

可(「コンポジット」メニューから「SOAデプロイ」→「アンデプロイ」の順に選択)

再デプロイ

はい

可(「コンポジット」メニューから「SOAデプロイ」→「再デプロイ」の順に選択)

テスト

いいえ

はい

コンポジットの監査レベル

いいえ

はい

ペイロードの検証

いいえ

はい

ビジネス監視の有効化/無効化

いいえ

はい

WSDLおよびエンドポイントURIの表示(アイコン)

いいえ

はい

XML定義の表示(アイコン)

いいえ

はい

実行するアクションに応じて、次の各項を参照してください。

- 第7.5.1項「SOAインフラストラクチャ・レベルでのすべてのアプリケーションの状態管理」

- 第7.5.2項「SOAコンポジット・アプリケーションのホーム・ページでのアプリケーションの状態管理」

詳細は、第1.2.2項「SOAコンポジット・アプリケーションの概要」を参照してください。

7.5.1 SOAインフラストラクチャ・レベルでのすべてのアプリケーションの状態管理

すべてのSOAコンポジット・アプリケーションの状態は、SOAインフラストラクチャ・レベルで「デプロイ済コンポジット」ページから管理できます。

SOAインフラストラクチャ・レベルですべてのアプリケーションの状態を管理する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

SOAコンポジットのメニューから...

1. 「ホーム」を選択します。

1. 「soa-infra」をクリックします。

1. 「SOAインフラストラクチャ」を選択します。

2. 「デプロイ済コンポジット」タブをクリックします。
「デプロイ済コンポジット」ページに、次の詳細が表示されます。

- 特定のSOAコンポジット・アプリケーションを検索するためのユーティリティ。コンポジット名の全部または一部を指定して「検索」をクリックします。SOAコンポジット・アプリケーションは、パーティションを指定して検索することもできます。

- デプロイされたパーティションを含む、SOAインフラストラクチャにデプロイされたすべてのSOAコンポジット・アプリケーションのリスト。現在のモード(「アクティブ」または「リタイア」)、インスタンスの数、失敗したインスタンスの数、および最終更新日時(デプロイメント時間、再デプロイメント時間、またはコンポジットの構成変更)が表示されます。コンポジット名の左にある緑色の丸印は、それがアプリケーションのデフォルトのリビジョンであることを示しています。

注意:

デプロイ済SOAコンポジット・アプリケーションに関する最新の詳細を表示するには、右上隅にある「リフレッシュ」アイコンをクリックするか、他のページに移動してこのページに戻ります。

3. 「デプロイ」をクリックして新しいアプリケーションをデプロイします。「コンポジット」セクションの上にリストされている他のすべてのオプションについては、最初にコンポジット・アプリケーション名の左の列をクリックしてコンポジット・アプリケーションを選択し、次に実行する特定のオプションを選択します。

次の表に、使用可能なオプションを示します。

アクション

説明

停止

実行中のSOAコンポジット・アプリケーションのリビジョンを停止します。コンポジットが停止している場合、コンポジットへのリクエスト(開始リクエストまたはコールバック・リクエスト)はすべて拒否されます。新しい受信リクエストは処理できません。既存のすべてのインスタンスは通常どおり完了できます(コンポジットがリタイアするときと同様)。

注意: 使用するバインディング・コンポーネントによって動作が異なります。たとえば、Webサービス・リクエストの場合は、却下されてコール元に戻されます。また、JCAアダプタ・バインディング・コンポーネントの場合も動作が異なる場合があります(たとえば、リクエストは却下表に格納されます)。

このオプションは、コンポジット・アプリケーションが開始されると表示されます。

起動

停止したコンポジット・アプリケーションのリビジョンを再起動します。これにより、新規リクエストを処理できるようになります(却下されません)。メッセージのリカバリは発生しません。

このオプションは、コンポジット・アプリケーションが停止されると表示されます。

リタイア

選択したコンポジットのリビジョンをリタイア状態にします。プロセスのライフサイクルがリタイア状態の場合、新しいインスタンスは作成できません。既存のインスタンスは正常に完了できます。

コンポジット・アプリケーションへの開始リクエストは、却下されてクライアントに戻されます。バインディング・コンポーネントが異なる場合の拒否の動作については、「停止」オプションで説明しています。

開始済のコンポジット・アプリケーション・インスタンスへのコールバックは、適切に配信されます。

このオプションは、コンポジット・アプリケーションがアクティブの場合に表示されます。

デフォルトのコンポジット・リビジョンをリタイアしようとする場合、またはデフォルトのコンポジット・リビジョンをすでにリタイアした場合、次の点に注意してください。これらの点を記載した警告ページも表示されます。

- デフォルトのコンポジット・リビジョンをリタイアしようとするときに、そのコンポジットの他のアクティブなリビジョンが見つかった場合、見つかったコンポジットが新しいデフォルトのリビジョンとして指定されます。アクティブなリビジョンが複数ある場合は、(タイムスタンプを基準にして)直前にデフォルトのリビジョンだったアクティブなコンポジットが、デフォルトのリビジョンとして指定されます。その後、リタイアされたリビジョンを再アクティブ化しても、デフォルトのリビジョンに自動的に戻ることはありません。再度、明示的にデフォルトのリビジョンに指定する必要があります。

- デフォルトのコンポジット・リビジョンをリタイアして、そのコンポジットのアクティブなリビジョンが見つからない場合、新しいデフォルトのリビジョンは指定されず、警告メッセージが表示されます。リタイアしたリビジョンが、デフォルトのリビジョンのままになります。ただし、このコンポジットでは、受信リクエストを処理できません。このコンポジットに対する新規の受信リクエストを処理するには、新しいリビジョンをデプロイするか、以前にリタイアしたリビジョンの1つを再アクティブ化する必要があります。

アクティブ化

リタイア状態のコンポジット・アプリケーションのリビジョンをアクティブ化します。このオプションを使用する場合は、次の動作に注意してください。

- すべてのコンポジット・アプリケーションは、デプロイされると自動的にアクティブになります。

- 新たにデプロイしたコンポジット・アプリケーションの他のリビジョンは、アクティブのままです(つまり、自動的にリタイア状態になりません)。必要な場合は、明示的にリタイア状態にする必要があります。

このオプションは、アプリケーションがリタイア状態のときに表示されます。

デフォルトとして設定

選択したコンポジット・アプリケーション・リビジョンをデフォルトとして設定します。「コンポジット」表では、デフォルトのリビジョンに緑色の丸印が付いています。特定のコンポジット・アプリケーション・リビジョンに対する新規リクエストを受信すると、そのコンポジット・アプリケーション・リビジョンが起動します。リビジョンが指定されていない新規リクエストを受信すると、デフォルトのリビジョンが起動します。

デフォルトのリビジョンは、コンポジット・アプリケーションがリタイアされると、変更される場合があります。変更は、そのコンポジットのアクティブなリビジョンが他にあるかどうかに基づいて行われます。詳細は、この表の「リタイア」アクションの説明を参照してください。

デフォルトのリビジョンは、デフォルトのコンポジット・アプリケーションのリビジョンがアンデプロイされると、自動的に変更されます。

コンポジット・アプリケーションを再デプロイした場合も、デフォルトのコンポジット・リビジョンは自動的に変更されます。再デプロイメント時に以前のデフォルトのリビジョンをデフォルトのままにするように指定しないかぎり、新規に再デプロイしたリビジョンが自動的にデフォルトのリビジョンになります。詳細は、この表の「アンデプロイ」アクションの説明を参照してください。

インバウンド・アダプタがアクティブ化されるのは、デフォルトのリビジョンでのみです。

デプロイ

リビジョンをデプロイします。デプロイメントによって、SOAインフラストラクチャのコンポジット・アプリケーションがアクティブ化されます。デプロイする場合は次の内容を選択します。

- 最初の新規SOAコンポジット・アプリケーション。

- 現在デプロイされているSOAコンポジット・アプリケーションのリビジョン(たとえば、1.0)とは異なる、新しいリビジョン(たとえば、2.0)のSOAコンポジット・アプリケーション。このオプションでは、リビジョン1.0と2.0の両方を同時にデプロイできます。

すでに存在するリビジョンを指定すると、エラーが発生します。このリビジョンは、「SOAコンポジットのデプロイ」ウィザードを使用して変更できません。

詳細は、第7.1項「SOAコンポジット・アプリケーションのデプロイ」および第7.9項「SOAコンポジット・アプリケーションのパーティションへのグループ化」を参照してください。

アンデプロイ

選択したコンポジット・アプリケーションのリビジョンをアンデプロイします。このアクションを実行すると、次のような結果になります。

- コンポジット・アプリケーションのこのリビジョンを構成したり監視できなくなります。

- コンポジット・アプリケーションのこのリビジョンのインスタンスを処理できなくなります。

- 以前に完了したプロセスを表示できなくなります。

- 現在実行中のインスタンスの状態は「失効」に変更され、このコンポジット・アプリケーションに送信した新規メッセージは処理されません。

- コンポジット・アプリケーションのデフォルトのリビジョン(たとえば、2.0)をアンデプロイした場合、コンポジット・アプリケーションの次に使用可能なアクティブなリビジョン(たとえば、1.0)がデフォルトになります。
使用可能なアクティブ・リビジョンが存在しない場合に古いデフォルトのリビジョンをアンデプロイすると、コンポジットが新しい受信リクエストを処理できなくなる可能性があります。デフォルトのリビジョンをアンデプロイする前に、デプロイ済のコンポジットのアクティブなリビジョンを最低1つは設定しておくことをお薦めします。

デフォルトのリビジョンをアンデプロイしたときに、そのコンポジットのアクティブ・リビジョンが見つからない場合、リタイア済のリビジョンが自動的に新しいデフォルトのリビジョンとして指定されます。このウィザードを閉じた後に、警告メッセージが表示されます。リタイア済のコンポジット内の現在実行中のインスタンスはすべて正常に終了しますが、これらのインスタンスは受信リクエストを処理することはできません。現在のデフォルトのリビジョンをアンデプロイした後に、このコンポジットに対する新規の受信リクエストを処理するには、新しいリビジョンをデプロイするか、以前にリタイアしたリビジョンを再アクティブ化する必要があります。

注意: 複数のSOAコンポジット・アプリケーションが同じパーティションにある場合は、それらを同時にアンデプロイする機能がサポートされています。

詳細は、第7.4項「SOAコンポジット・アプリケーションのアンデプロイ」および第7.9項「SOAコンポジット・アプリケーションのパーティションへのグループ化」を参照してください。

再デプロイ

SOAコンポジット・アプリケーションの既存のリビジョンを再デプロイします。このアクションを実行すると、次のような結果になります。

- 現在デプロイされているSOAコンポジット・アプリケーションのリビジョンの新規バージョンが再デプロイされます(たとえば、古いバージョン1.0が新規バージョン1.0として再デプロイされます)。

- 現在デプロイされているこのリビジョンの古いバージョンは削除(上書き)されます。

- このリビジョンの古いデプロイ済バージョンがインスタンスを実行中の場合は、これらのインスタンスの状態を失効に変更するかどうかを選択できます。

詳細は、第7.3項「SOAコンポジット・アプリケーションの再デプロイ」を参照してください。

詳細は、第1.4.3.3項「SOAコンポジット・アプリケーションのライフサイクルの状態の概要」を参照してください。

7.5.2 SOAコンポジット・アプリケーションのホーム・ページでのアプリケーションの状態管理

個々のSOAコンポジット・アプリケーションの状態は、アプリケーションのホーム・ページで管理できます。

SOAコンポジット・アプリケーションのホーム・ページでアプリケーションの状態を管理する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にあるパーティションを展開します。

2. 特定のSOAコンポジット・アプリケーションを選択します。

選択したSOAコンポジット・アプリケーションの「ダッシュボード」ページが表示されます。

注意:

- 「最新のインスタンス」セクションの「合計」フィールドには、インスタンスが正常に完了している場合でも、正しい合計インスタンス数が表示されない場合があります。その場合は、右上隅の「リフレッシュ」アイコンをクリックすると、実際の合計インスタンス数が表示されます。

- 「SOAインフラストラクチャの共通プロパティ」ページで「コンポジット・インスタンスの状態をキャプチャ」チェック・ボックスが選択されていると、インスタンスがただちに表示されない制約を定義していても(たとえば、フラッシュ遅延を10分に定義した場合、またはデータベースに書き込むバッチ・サイズを100レコードに指定した場合)、作成されたインスタンスはただちに表示されます。これは、コンポジットの状態を取得することが必要となり、インスタンスのトラッキングが即時モードに移行するためです。

- SOAインフラストラクチャは、起動後、すべてのデプロイ済コンポジットがロードされるまで受信リクエストを管理するために完全には初期化されない場合があります。SOAインフラストラクチャの初期化中、SOAコンポジット・アプリケーションのホーム・ページの上部に警告メッセージが表示されます。このメッセージが表示されている間は、コンポジット・デプロイメント、コンポジット・アンデプロイメントなどの操作を実行しないでください。詳細は、第3.2.1項「SOAインフラストラクチャ起動初期化の完了の待機」を参照してください。

2. ページの上部にあるオプションのリストから、実行するアクションを選択します。これらのオプションは、SOAコンポジット・アプリケーションの「インスタンス」、「フォルト・メッセージと拒否メッセージ」、「ユニット・テスト」および「ポリシー」ページの上部にも表示されます。

アクション

説明

停止

このオプションの説明は、第7.5.1項「SOAインフラストラクチャ・レベルでのすべてのアプリケーションの状態管理」の手順3にある表を参照してください。

起動

このオプションの説明は、第7.5.1項「SOAインフラストラクチャ・レベルでのすべてのアプリケーションの状態管理」の手順3にある表を参照してください。

リタイア

このオプションの説明は、第7.5.1項「SOAインフラストラクチャ・レベルでのすべてのアプリケーションの状態管理」の手順3にある表を参照してください。

アクティブ化

このオプションの説明は、第7.5.1項「SOAインフラストラクチャ・レベルでのすべてのアプリケーションの状態管理」の手順3にある表を参照してください。

テスト

「Webサービスのテスト」ページからテスト・インスタンスを起動できます。

注意: SOAコンポジット・アプリケーションが停止またはリタイアしているときは、このボタンは無効です。停止またはリタイアしたアプリケーションのインスタンスは作成できないためです。また、このアプリケーションで使用可能なWebサービスがない場合も、ボタンは無効になります。このページからテストできるのは、Webサービス・バインディングのあるサービスを持つコンポジット・アプリケーションのみです。

詳細は、第8.1項「SOAコンポジット・アプリケーションのテスト・インスタンスの起動」を参照してください。

設定: コンポジットの監査レベル

SOAコンポジット・アプリケーション・レベルで実行される監査トラッキングのレベルを設定します。この設定は、SOAインフラストラクチャ・レベルで定義されている監査レベルをオーバーライドできます。デフォルト値は「継承」で、SOAインフラストラクチャ・レベルの設定はオーバーライドされません。

監査トラッキングのレベルを設定する場合は、次のオプションが選択可能です。

- 継承: ロギング・レベルは、SOAインフラストラクチャの「共通プロパティ」ページで設定したSOAインフラストラクチャ監査レベルと一致します。これがデフォルトの設定です。

- 本番: SOAコンポジット・アプリケーション・インスタンスに関する最小限の情報が収集されます。たとえば、BPELプロセスおよびOracle Mediatorサービス・エンジンはペイロードをキャプチャしません。したがって、フローの監査証跡でペイロード詳細は使用できません。BPELプロセス・サービス・エンジンは、assignアクティビティを除くすべてのアクティビティについてペイロード詳細を収集します。このレベルは、標準の操作とテストに最適です。

- 開発: SOAコンポジット・アプリケーション・インスタンスに関する完全な情報が収集されます。このオプションを選択すると、コンポジット・インスタンスのトラッキングとペイロード・トラッキングの両方が実行されます。ただし、メッセージ・フローの各ステップでペイロードが格納されるため、パフォーマンスに影響を与える可能性があります。この設定は、デバッグする際に便利です。

- オフ: ロギングは実行されません。コンポジット・インスタンスのトラッキング情報とペイロード・トラッキング情報は収集されません。

SOAコンポジット・アプリケーション・レベルで監査レベル・トラッキングを設定すると、SOAインフラストラクチャ・レベルで設定した同じトラッキングがオーバーライドされます。デフォルトでは、SOAコンポジット・アプリケーション・レベルとSOAインフラストラクチャ・レベルの設定は同じです。グローバルなSOAインフラストラクチャの設定が変更されると、SOAコンポジット・アプリケーションの設定も自動的に変更されます。ただし、SOAコンポジット・アプリケーション・レベルで別の設定を選択すると、継承された設定をオーバーライドできます。

現在のグローバル値と同じローカル・コンポジット値を明示的に選択した場合も、設定がオーバーライドされます。この場合、SOAインフラストラクチャの設定が変更されても、そのコンポジット・アプリケーションは新しい値を継承しません。たとえば、SOAインフラストラクチャの設定が「オフ」であるとします。これによって、すべてのコンポジット・アプリケーションは監査トラッキングが「オフ」に設定されます。ここで、コンポジット・アプリケーションXYZを明示的に「オフ」に設定したとします。次に、SOAインフラストラクチャに移動して、その設定を「本番」に変更します。その結果、コンポジット・アプリケーションXYZを除くすべてのコンポジット・アプリケーションのトラッキング・レベルは「本番」に変更されますが、コンポジット・アプリケーションXYZの設定は「オフ」のままです。

複数のSOAコンポジット・アプリケーションにわたるメッセージ・フローでは、インスタンス・トラッキングの設定によって次のように表示が変わることに注意してください(たとえば、参照バインディング・コンポーネントを介して別のコンポジットを起動するコンポジット・アプリケーション、または、あるコンポジット・アプリケーションで公開されて別のコンポジット・アプリケーションでサブスクライブされたイベントの場合です)。

- 複数のコンポジット・アプリケーション・インスタンスにまたがる1つのメッセージ・フローの場合は、中間のコンポジット・アプリケーションでインスタンス・トラッキングが無効になると、接続していない別々のフローとして表示されます。たとえば、コンポジット・アプリケーションC1、C2およびC3を経由するメッセージ・フローがあるとします。C1とC3ではインスタンス・トラッキングを有効にして、C2では無効にします。Oracle Enterprise Manager Fusion Middleware Controlでは、C1とC3に対して2つの別個のフローが表示されます。

- イベントまたはメッセージのソースまたはターゲットが表示されない場合があります。たとえば、コンポジット・アプリケーションが2つあるとします(C1とC2)。C1でインスタンスのトラッキングが無効にされると、フロー・トレースにメッセージ・フローの起点が表示されず、C2が直接起動されたように表示されます。

設定: ペイロードの検証

コンポジット・アプリケーション・リビジョンのインバウンド・ポイントとアウトバウンド・ポイントで、XMLスキーマ・ベースのペイロードを検証します。ペイロードの検証を有効にし、無効なペイロード(スキーマに準拠しない)がある場合は、そのメッセージに対してフォルトが生成されます。

ただし、同期サービスのレスポンス・メッセージは例外です。このメッセージは、ペイロードの検証が有効な場合でも検証されません。検証されないのはアウトバウンド・メッセージのみで、インバウンド・メッセージは引続き検証されます。

設定: ビジネス監視の有効化/無効化

センサーの現在のステータスを表示する確認ダイアログを起動するオプションを選択します。

- 無効化: このSOAコンポジット・アプリケーションのすべてのBPELコンポーネントのBPELセンサーを無効にする場合に選択します。

- 有効化: このSOAコンポジット・アプリケーションのすべてのBPELコンポーネントのBPELセンサーを有効にします。

「ビジネス監視の有効化/無効化」の選択肢は、コンポーネントにセンサーが含まれているかどうかに関係なく、BPELサービス・コンポーネントを持つコンポジットに対してのみ表示されます。

BPELセンサーがサービス・エンジン・レベルで無効になっている場合、SOAコンポジット・アプリケーション・レベルではBPELセンサーの有効または無効を設定できません。「BPELサービス・エンジン・プロパティ」ページで、BPELモニターおよびセンサーをサービス・エンジン・レベルで有効または無効にできます。

詳細は、第7.10項「BPELおよびBPMNのビジネス監視の有効化と無効化」と第13.1項「BPELプロセス・サービス・エンジン・プロパティの構成」を参照してください。

WSDLおよびエンドポイントURIの表示(アイコン)

クリックすると、このSOAコンポジット・アプリケーションに対するすべての外部サービスのエンドポイント・アドレスおよびWSDLが表示されます。

注意: Safariブラウザを使用してこの情報を表示する場合は、B.9.1項「Safariブラウザを使用してWSDLファイルの内容を表示する場合の制限」を参照してください。

コンポジットXML定義の表示(アイコン)

クリックすると、SOAコンポジット・アプリケーションのXML定義が表示されます。

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

- 第1.4.3.3項「SOAコンポジット・アプリケーションのライフサイクルの状態の概要」

- 第3.1項「SOAインフラストラクチャ・プロパティの構成」

7.5.3 BPEL処理途中でSOAインフラストラクチャがデプロイされる管理対象のOracle WebLogic Serverの起動および停止

SOAコンポジット・アプリケーションでのBPELプロセスの途中で、SOAインフラストラクチャがデプロイされている管理対象のOracle WebLogic Serverを起動および停止する場合は、次の問題に注意してください。

- 同期BPELプロセスの場合
シナリオ全体が同期され、実行中の状態(サーバーの再起動後)のインスタンスはBPELのwaitアクティビティで保留されます。このため、フロー・スレッドはサーバーで終了します(waitアクティビティでスリープ中)。サーバーが再起動しても、フローは同期であるため、同じインスタンスは再起動されません。したがって、サーバーの再起動後もインスタンスで処理が発生しないため、これらのインスタンスは常に実行中の状態です。

- 非同期BPELプロセスの場合
BPELのinvokeアクティビティの途中でサーバーが停止すると、BPELが受信したメッセージは処理されません。BPELは再起動時にこれらのメッセージを自動的にリカバリしないため、Facade APIコールを使用してメッセージを手動でリカバリする必要があります。Facade APIの詳細は、第11章「Facade APIを使用したSOAコンポジット・アプリケーションのプログラムによる管理」を参照してください。

7.5.4 コンポジット・インスタンス名の設定

Oracle MediatorおよびOracle BPEL Process Managerでは、設計時にSOAコンポジット・アプリケーションのインスタンス名を設定できます。詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の設計時のコンポジットインスタンス名の設定方法に関する項を参照してください。

7.6 SOAコンポジット・アプリケーションのテストの自動化

SOAコンポジット・アプリケーションのテストを自動化するテスト・ケースを作成、デプロイおよび実行できます。テスト・ケースを使用すると、本番環境へのデプロイメントの前に、SOAコンポジット・アプリケーションとWebサービス・パートナ間の相互作用をシミュレートできます。これにより、本番環境へのデプロイメント準備が完了するまでに、プロセスとWebサービス・パートナの相互作用が期待どおりであるかを確認できます。Oracle JDeveloperでテスト・ケースを作成し、SOAコンポジット・アプリケーションに組み込みます。このアプリケーションは、その後、Oracle Enterprise Manager Fusion Middleware Controlからデプロイされて管理されます。また、SOAコンポジット・アプリケーションのテスト・ケース内に、BPELプロセス・サービス・コンポーネントのテスト・ケースを作成することもできます。

SOAコンポジット・アプリケーションのテストを自動化する手順は、次のとおりです。

注意:

Oracle Enterprise Manager Fusion Middleware ControlからSOAコンポジット・アプリケーション、またはBPELプロセス・サービス・コンポーネントのテストを行う前に、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の章「SOAコンポジット・アプリケーションのテストの自動化」で、テスト・ケースの作成に関する説明を参照してください。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

SOAコンポジットのメニューから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」を選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

4. 「ユニット・テスト」タブをクリックします。

1. 「soa-infra」の下にあるパーティションを展開します。

2. 特定のSOAコンポジット・アプリケーションを選択します。

3. 「ユニット・テスト」タブをクリックします。

1. 「ユニット・テスト」を選択します。

表示されるテスト・ケースは、Oracle JDeveloperで設計され、デプロイ済のSOAコンポジット・アプリケーションに組み込まれたテスト・ケースです。

2. テスト・スイート全体を選択するか、実行するスイートの個々のテストを選択して、「実行」をクリックします。

テストの作成プロンプトが表示されます。

3. 次の値を入力し、「OK」をクリックします。

フィールド

説明

テスト実行名

テスト・インスタンスの名前を入力します。テストの終了時に、レポート詳細がこの名前で取得されます。

タイムアウト

テストを終了させる値(秒単位)を入力します。この時間内にテストが完了しない場合、テストは終了されます。

同時テスト・インスタンスの数

作成するテスト・インスタンスの数を入力します。

実行中のテストを追跡するための「テスト実行」ページが自動的に表示されます。

「テスト実行」ページを使用して、実行中のテスト・ケースを追跡し、テスト結果を表示できます。テスト・スイートは、1つ以上のテスト・ケースの論理的な集合で構成されます。各テスト・ケースには、テスト・インスタンスの実行時に実行される一連のコマンドが含まれています。テスト・スイートを実行することをテスト実行と呼びます。

4. 「テスト実行名」列で特定のテスト実行をクリックして、「テスト実行の結果」セクションに詳細を表示します。追加のテスト実行を作成する場合は、「テスト・ケース」ページにいつでも戻ることができます。
「テスト実行の結果」セクションには、実行されたテスト実行の詳細(テスト・サマリー、成功率など)が表示されます。追加の詳細は、「ヘルプ」アイコンをクリックしてください。

5. ページの下部にアサーション詳細が表示されます。アサーションにより、変数データやプロセス・フローを検証できます。

6. コンポジット・インスタンス番号をクリックして、特定のテスト詳細を表示します。
SOAコンポジット・アプリケーションの「インスタンス」ページ、およびSOAインフラストラクチャとSOAコンポジット・アプリケーションの「最新のインスタンス」表では、ユニット・テスト実行を実行して作成されたコンポジット・インスタンスのインスタンスIDの横に黄色のボックスが表示されます。これらのインスタンスは、この黄色のボックスによって、「Webサービスのテスト」ページで作成されたり、アプリケーションの外部コンシューマによって自動的に作成されたテスト・インスタンスと区別されます。

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

- 第1.4.3.4項「SOAコンポジット・アプリケーションの自動テストの概要」

- 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の章「SOAコンポジット・アプリケーションのテストの自動化」の、Oracle JDeveloperでのSOAコンポジット・アプリケーションおよびBPELプロセス・サービス・コンポーネントのテスト・ケースの作成に関する説明

7.7 SOAコンポジット・アプリケーションのポリシーの管理

現在デプロイされているSOAコンポジット・アプリケーションとの間で、セキュリティ・ポリシーをアタッチまたはデタッチできます。ポリシーでは、メッセージ配信に対してセキュリティが適用されます。

注意:

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

SOAコンポジット・アプリケーション・ポリシーを管理する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

SOAコンポジットのメニューから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」を選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

4. 「ポリシー」タブをクリックします。

1. 「soa-infra」の下にあるパーティションを展開します。

2. 特定のSOAコンポジット・アプリケーションを選択します。

3. 「ポリシー」タブをクリックします。

1. 「ポリシー」を選択します。

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

2. 「アタッチ/デタッチ先」をクリックします。

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

3. ポリシーのアタッチまたはデタッチの対象のコンポーネントを選択します。

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

「アタッチされたポリシー」セクションに、現在アタッチされているポリシーが表示されます。「使用可能なポリシー」セクションには、アタッチ可能な追加のポリシーが表示されます。

4. 使用環境に適した、アタッチ対象のポリシーを選択します。

5. 「アタッチ」をクリックします。
「直接アタッチされたポリシー」セクションに、アタッチされたポリシーが表示されます。

6. 必要に応じて、追加のポリシーをアタッチします。

7. ポリシーのアタッチを終了した後は、「検証」をクリックします。

8. エラー・メッセージが表示された場合は、検証エラーがなくなるまで必要な修正を行います。

9. 「OK」をクリックします。
アタッチしたポリシーがポリシー表に表示されます。

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

- 第1.4.3.2項「ポリシーの概要」

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

7.7.1 WS-RMセッション

単一のWS-RMセッションにおけるOracle SOA Suiteからの複数のリクエストは、現在サポートされていません。各リクエストは個別のWS-RMセッション内にあります。

7.7.2 コンポジット間呼出しでのポリシー・アタッチメントおよびローカルの最適化

OWSMでは、1つのコンポジットの参照で2つ目のコンポジットへのWebサービス・バインディングを指定するコンポジット間呼出しに対してOracle SOA Suiteのローカルの最適化機能がサポートされます。ローカルの最適化を使用すると、実行時にHTTPスタックとSOAP/正規化メッセージ変換をバイパスできます。コンポジットが異なるコンテナにある場合、ローカルの最適化は使用されません。ポリシーがWebサービス・バインディングにアタッチされている場合は、ローカルの最適化が使用されているとポリシーを呼び出すことができません。

デフォルトでは、OWSMセキュリティ・ポリシーには、ポリシーでローカルの最適化がサポートされるかどうかを示すlocal-optimizationプロパティが含まれます。ポリシーの設定は、Oracle Enterprise Manager Fusion Middleware Controlから表示できます。

ポリシーのローカル最適化設定を表示する手順は、次のとおりです。

1. ナビゲータで、「WebLogicドメイン」フォルダを開きます。

2. 「WLS_SOAWC」を右クリックし、「Webサービス」→「ポリシー」の順に選択します。

3. ポリシーを選択し、「ファイルにエクスポート」をクリックします。

4. テキスト・エディタでファイルを開き、local-optimizationを検索して値を識別します。このプロパティでは次の値がサポートされます。

- on: アタッチされたポリシーでローカルの最適化が使用され、ポリシーは実行時に適用されません。

- off: アタッチされたポリシーではローカルの最適化は使用されず、ポリシーは実行時に適用されます。

- check-identity: JAASサブジェクトが現在のスレッドに存在する場合は、ローカルの最適化が使用されます。それ以外の場合、ローカルの最適化は使用されません。

セキュリティ・ポリシーに対するデフォルトのローカルの最適化設定の詳細は、『Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイド』を参照してください。

composite.xmlファイルのバインディング・セクションにoracle.webservices.local.optimizationプロパティを追加することで、ポリシーのローカルの最適化設定をオーバーライドできます。サポートされている値は次のとおりです。

- true(デフォルト値): ローカルの最適化が使用され、最適化されたコールに適用可能な場合はポリシーが適用されます(詳細は個々のポリシー・ファイルで定義します)。

- false: OWSMポリシー・レベルでのlocal-optimizationプロパティのデフォルト設定にか関係なく、ローカルの最適化は使用されません。この設定ではポリシーが強制的に適用されます。

たとえば、falseの次の設定ではoracle/wss_username_token_client_policyが適用されます。

<binding.ws
port="http://xmlns.oracle.com/CalledBPELProcessApp_
jws/CalledBPELProcess/CalledBPELProcess#wsdl.endpoint(calledbpelprocess_client_
ep/CalledBPELProcess_pt)"

location="http://myhost.us.example.com:8001/soa-infra/services/default/CalledBPEL
Process!1.0/calledbpelprocess_client_ep?WSDL">
<wsp:PolicyReference URI="oracle/wss_username_token_client_policy"
orawsp:category="security"
orawsp:status="enabled"/>
<wsp:PolicyReference URI="oracle/log_policy"
orawsp:category="management"
orawsp:status="enabled"/>
<property
name="oracle.webservices.local.optimization">false</property>
</binding.ws>

ローカルの最適化の詳細は、第3.7項「ローカルの最適化の構成」を参照してください。

7.8 デプロイ済のSOAコンポジット・アプリケーションのエクスポート

SOAコンポジット・アプリケーションのコンテンツをアーカイブJARファイルにエクスポートできます。ファイルには次のデータの一部またはすべてが含まれます。

- 元の設計時コンポジット。

- ルール・ディクショナリとドメイン値マップ(DVM)のデプロイ後の変更。

- バインディング・コンポーネントのプロパティなどのデプロイ後のプロパティの変更、監査レベル設定やペイロード検証ステータスなどのコンポジット・プロパティ、およびポリシー・アタッチメント。

注意:

- SOAコンポジット・アプリケーションのエクスポートは、現在は個々のSOAコンポジット・レベルでのみ可能です。

- 共有データは、コンポジット・エクスポートSOAアーカイブ(SAR)の一部としてエクスポートされません。

実行中のSOAコンポジット・アプリケーションをエクスポートする手順は、次のとおりです。

1. エクスポートするSOAコンポジット・アプリケーションのホーム・ページに移動します。

2. 「SOAコンポジット」メニューから、「エクスポート」を選択します。
「コンポジットのエクスポート」ページが表示されます。

3. オプションを選択します。

- オプション1: 「オプション2」および「オプション3」で説明されている元の設計時コンポジットとデプロイ後の詳細を含むアーカイブ・ファイルを生成します。

- オプション2: 元の設計時コンポジットとデプロイ後の変更をルール・ディクショナリとDVMに含めます。

- オプション3: 元の設計時コンポジットとバインディング・コンポーネントのプロパティなどのデプロイ後のプロパティの変更、監査レベル設定やペイロード検証ステータスなどのコンポジット・プロパティ、およびポリシー・アタッチメントを含めます。

- オプション4: 元の設計時コンポジットのみ含むアーカイブ・ファイルを生成します。「オプション2」および「オプション3」は含まれません。

4. 既存のファイルに追加の名前を付加する場合は、「カスタム拡張テキストの指定」を選択します。たとえば、sca_OrderBookingComposite_rev1.0.jarという名前のファイルにMyTextを追加すると、エクスポート・ファイルの名前はsca_OrderBookingComposite_rev1.0-MyText.jarになります。

5. 「エクスポート」をクリックします。
「処理中: コンポジットのエクスポート」ダイアログに、アーカイブ・ファイル生成の進行状況が表示されます。生成が完了すると、ファイルの保存を求められます。

6. 「ファイルの保存」をクリックします。
ファイルを開くかローカル・ホストのディレクトリに保存するためのダイアログが表示されます。

注意:

「ファイルの保存」ボタンをクリックすることが重要です。このダイアログは閉じないでください。コンポジットはエクスポートされますが、実際のエクスポートされたファイルを取得できません。

7. JARファイルを保存するローカル・ディレクトリを指定します。

8. 「処理中: コンポジットのエクスポート」ダイアログの右上にある「X」アイコンをクリックしてダイアログを閉じます。

9. 「コンポジットのエクスポート」ページで、「取消」ボタンが「終了」に変わります。

10. 「終了」をクリックします。
「コンポジットのエクスポート」が閉じ、SOAコンポジット・アプリケーションのホーム・ページに戻ります。

7.9 SOAコンポジット・アプリケーションのパーティションへのグループ化

パーティションと呼ばれるSOAインフラストラクチャの個別のセクションに、SOAコンポジット・アプリケーションをデプロイできます。パーティションにデプロイすると、SOAコンポジットを論理的にグループ化し、特定のパーティション内のすべてのSOAコンポジット・アプリケーションに対して一括ライフサイクル管理タスクを実行できます。パーティションは、Oracle BPEL Process Managerの10.1.xリリースの一部であるドメイン機能に似ています。ただし、特定のパーティションへのログイン・アクセスを制限したり、パーティションを構成する(たとえば、スレッドの構成)など、パーティションに対して特定の構成タスクを実行することはできません。

SOAコンポジット・アプリケーションをデプロイするには、パーティションが少なくとも1つ必要です。「デフォルト」という名前のデフォルトのパーティションが、Oracle SOA Suiteに自動的に作成されます。

パーティション化は次の2つのページから管理できます。

- SOAインフラストラクチャの「パーティションの管理」ページ。このページで、パーティションの作成、パーティションの削除、および特定のパーティション内のすべてのSOAコンポジット・アプリケーションに対する一括ライフサイクル管理タスクを実行できます。

- パーティションのホーム・ページ。このページでも、特定のパーティション内のすべてのSOAコンポジット・アプリケーションに対する一括ライフサイクル管理タスクを実行できます。

注意:

同じインバウンド・リソースを使用している複数のSOAコンポジット・アプリケーションが異なるパーティションにデプロイされている場合は、処理するメッセージをどのパーティションが取得するかを保証できません。

たとえば、ファイル・アダプタを使用しており、/home/Directory1がコンポジットSOAComposite1のインバウンド・ディレクトリだとします。このコンポジットがPartition1とPartition2の両方にデプロイされている場合、ファイルが/home/Directory1に置かれると、Partition1またはPartition2内のコンポジットがファイルを取得できます。

ただし、ソケット・アダプタでは、同じインバウンド・ポートを使用するコンポジットをデプロイできないという制限があります。この場合は、インバウンド・ポートが使用されていることを示す例外がスローされます。

表7-3に、両方のページで実行できるタスクの詳細を示します。

表7-3 パーティション管理に関するアクション

アクション

「パーティションの管理」ページでの実行の可否

パーティションのホーム・ページでの実行の可否

パーティションの作成

はい

いいえ

パーティションの削除

はい

可

1. 「SOAパーティション」メニューを選択します。

2. 「このパーティションの削除」を選択します。

注意: ナビゲータで右クリックし、「このパーティションの削除」を選択することによってもパーティションを削除できます。

特定のパーティションにデプロイされているすべてのコンポジットに対する一括ライフサイクル管理の実行

- すべて起動

- すべてシャットダウン

- すべてリタイア

- すべてアクティブ化

- すべてアンデプロイ

はい

はい

注意:

- パーティションは、特定の状態(起動、停止、アクティブ化、リタイアなど)に関連付けられません。パーティション内のコンポジットのみが、特定の状態に関連付けられます。このため、パーティションを起動、停止、アクティブ化またはリタイアさせることはできません。

- SOAインフラストラクチャは、起動後、すべてのデプロイ済コンポジットがロードされるまで受信リクエストを管理するために完全には初期化されない場合があります。SOAインフラストラクチャの初期化中、「パーティションの管理」ページおよび「パーティション」ホーム・ページの上部に警告メッセージが表示されます。このメッセージが表示されている間は、コンポジット・デプロイメント、コンポジット・アンデプロイメントなどの操作を実行しないでください。詳細は、第3.2.1項「SOAインフラストラクチャ起動初期化の完了の待機」を参照してください。

実行するタスクに応じて、次の各項を参照してください。

- 第7.9.1項「パーティションの作成および削除」

- 第7.9.2項「パーティションのコンポジットに対する一括ライフサイクル管理タスクの実行」

パーティションの詳細は、第1.4.3.5項「SOAインフラストラクチャのパーティションの概要」を参照してください。

7.9.1 パーティションの作成および削除

パーティションは、「パーティションの管理」ページで作成および削除できます。「デフォルト」という名前のデフォルトのパーティションが、Oracle SOA Suiteに自動的に作成されます。デフォルト・パーティションは削除できます。既存のパーティションの名前を変更することはできません。パーティションの作成と削除のみがサポートされています。

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

SOAインフラストラクチャのメニューから...

特定のパーティションのホーム・ページからアクセスする手順

1. 「パーティションの管理」を選択します。

1. 特定のパーティションの「関連リンク」リストから、「パーティションの管理」を選択します。

「パーティションの管理」ページに、次の詳細が表示されます。

- 各パーティションの名前、各パーティション内のアクティブおよびリタイア状態のSOAコンポジット・アプリケーション・リビジョンの数、各パーティションに含まれているコンポジットの名前(「表示」リンクの下)、および各パーティション内の実行中インスタンスと失敗したインスタンスの総数。

- 特定のパーティションを検索するためのユーティリティ。完全または部分的なパーティション名を入力し、「検索」アイコンをクリックするか[Return]キーを押します。検索では大文字と小文字は区別されません。

2. パーティションを追加するには、「作成」をクリックします。
「新規SOAパーティションの作成」ダイアログが表示されます。

1. 「名前」フィールドにパーティションの名前を入力し、「作成」をクリックします。

注意:

名前は次の規則に従っている必要があります。

- ASCII文字と数字を使用できます。

- アンダースコア(_)を使用できます。

- ハイフン(-)を使用できます(最初の文字以外)。

- ASCII以外の文字を使用できます。

- スペースは使用できません。

有効な名前の例は、mypartition、partition2、dept-a、customer_servicesおよび22です。無効な名前の例は、-part2、/partition、およびnullまたは空の名前です。

既存のパーティションの名前の変更や、デプロイしたコンポジット・アプリケーションを後で別のパーティションに転送することはできません。

新しいパーティションは、「soa-infra」のナビゲータと「パーティションの管理」ページの「SOAパーティション」列の両方に表示されます。これで、「デプロイメント」ドロップダウン・リストから「このパーティションにデプロイ」を選択するか、ナビゲータで特定のパーティションを右クリックして「このパーティションにデプロイ」をクリックすることにより、コンポジットをこのパーティションにデプロイできます。

コンポジットがパーティションにデプロイされると、ナビゲータでそのコンポジットがパーティションの下に表示されます。デプロイした後は、コンポジットを別のパーティションに転送できなくなります。

3. パーティションを削除するには、特定のパーティションを選択し、「削除」をクリックします。ナビゲータで特定のパーティションを右クリックし、「このパーティションの削除」をクリックすることによっても削除できます。
「SOAパーティションの削除」ダイアログが表示されます。次のことに注意してください。

- 別のパーティションにコンポジット・デプロイメントの一部を再作成する場合は、このパーティションを削除する前にコンポジットをJARファイルにエクスポートできます。

- 選択したパーティションを削除する前に、パーティション内のすべてのSOAコンポジット・アプリケーション・リビジョンがアンデプロイされます。これらのリビジョンの、すべてのアンデプロイされたインスタンスの状態は「失効」になります。

注意:

少なくとも1つのパーティションが必要です。すべてのパーティションを削除すると、SOAコンポジット・アプリケーションをデプロイできません。

1. 「削除(すべてのコンポジットのアンデプロイ)」をクリックします。
パーティションにデプロイされたすべてのコンポジットがアンデプロイされ、ナビゲータに表示されなくなります。パーティションは、「soa-infra」のナビゲータと「パーティションの管理」ページの「SOAパーティション」列の両方から削除されます。

「コンポジット制御」および「デプロイメント」リストからの一括ライフサイクル管理タスクの実行については、第7.9.2項「パーティションのコンポジットに対する一括ライフサイクル管理タスクの実行」を参照してください。

Oracle WebLogic Scripting Tool (WLST)およびantコマンドでもパーティションを作成できます。詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』および『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

7.9.2 パーティションのコンポジットに対する一括ライフサイクル管理タスクの実行

「パーティションの管理」ページ、特定のパーティションのホーム・ページ、およびナビゲータでパーティションを右クリックすると表示されるメニューで、特定のパーティション内のすべてのSOAコンポジット・アプリケーションに対して一括ライフサイクル管理タスクを実行できます。

一括ライフサイクル管理タスクは、一度に1つではなく複数のコンポジットに影響を及ぼします。コンポジットに実行中のインスタンスがあり、ライフサイクルの変更操作がコンポジットに対して実行されている場合は、インスタンスが完了しないことがあります。様々なライフサイクル操作がコンポジット・インスタンスに及ぼす影響については、第7.5.1項「SOAインフラストラクチャ・レベルでのすべてのアプリケーションの状態管理」の手順3を参照してください。

特定のパーティション内のすべてのSOAコンポジット・アプリケーションに対して一括ライフサイクル管理を実行する手順は、次のとおりです。

1. ページには、次のいずれかの手順でアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「パーティションの管理」を選択します。

1. 「soa-infra」の下にある、特定のパーティションを選択します。

注意:

ショートカットとして、ナビゲータで特定のパーティションを右クリックして、この項で説明する一括ライフサイクル管理アクションを選択するメニューを表示することもできます。このメニューの詳細は、第2.2.3項「パーティションのホーム・ページおよびメニューからの移動」のステップ3を参照してください。

いずれかのページに表示される2つのドロップダウン・リストを使用すると、一括ライフサイクル管理アクションを実行できます。

- 「コンポジット制御」リスト

- 「デプロイメント」リスト

特定のパーティションのホーム・ページでは、これらのリストはページの上部に表示されます。

「パーティションの管理」ページでは、これらのリストは「SOAパーティション」表の上に表示されます。

注意:

パーティションのホーム・ページの上部にある「SOAパーティション」メニューを選択して、パーティションにコンポジットをデプロイし、一括ライフサイクル管理タスクを実行することも選択できます。

2. 選択したパーティションに含まれるすべてのSOAコンポジット・アプリケーションに次の一括ライフサイクル管理タスクの1つを実行するには、「コンポジット制御」リストを選択します。

- すべてのコンポジットを起動します。

- すべてのコンポジットをシャットダウンします。

- すべてのコンポジットをアクティブにします。

- すべてのコンポジットをリタイアします。

1. 実行する操作を選択します。
選択内容の確認を求めるダイアログが表示されます。操作が完了すると、ページ上部に確認メッセージが表示されます。

注意:

「コンポジット制御」リストから「すべてリタイア」を選択すると、そのパーティション内のすべてのコンポジットがリタイアされ、その際にデフォルトや最後のアクティブ・コンポジットがリタイアされることを示す警告メッセージは表示されないため、注意が必要です。

これは、特定パーティション内の全コンポジットの一括リタイアメントの実行時に予期される動作です。

3. 次のいずれかの管理タスクを実行するには、「デプロイメント」リストを選択します。

- このパーティションにデプロイするコンポジットを指定します。この選択により、デプロイするコンポジット・リビジョンを指定する「SOAコンポジットのデプロイ」ウィザードが起動します。

- このパーティション内のすべてのコンポジットをアンデプロイします。
選択内容の確認を求めるダイアログが表示されます。操作が完了すると、ページ上部に確認メッセージが表示されます。

7.10 BPELおよびBPMNのビジネス監視の有効化と無効化

ビジネス監視という用語は、次のようないくつかのタイプのSOAコンポーネントに対して定義できる多様なタイプのセンサーで構成されます。

- BPELセンサー: BPELのフォルト、アクティビティおよび変数にセンサーを作成できます。

- BPELモニター: Oracle BAM Serverに送信され、分析やグラフィカル表示に使用されるBPELプロセス・メトリックを取得できます。

- BPMN測定: プロセス内またはプロセスのセクション内の特定のポイントでビジネス・インジケータを測定できます。

SOAコンポジット・アプリケーション・レベルで、選択したコンポジットを構成するあらゆるタイプのサービス・コンポーネントに定義されているセンサーすべてに同じステータスを設定します。単一のコンポジットに対する特定のタイプのサービス・コンポーネントに定義されているセンサーを選択して有効化または無効化することはできません。ただし、BPELサービス・エンジン・プロパティまたはBPMNサービス・エンジン・プロパティの各ページで、すべてのコンポジットのサービス・コンポーネント・タイプ固有のセンサーをグローバルに無効化することは可能です。

デフォルトでは、SOAコンポジット・アプリケーションに定義されているBPELセンサーとBPMNセンサーは有効になります。センサーを無効化すると、実行時にセンサー値が取得されません。たとえば、BPEL監査証跡の「センサー値」セクションに値が表示されなくなります。

センサーをサービス・エンジン・レベルで無効化する手順は、次のとおりです。

1. 第13.1項「BPELプロセス・サービス・エンジン・プロパティの構成」の手順に従って「BPELサービス・エンジン・プロパティ」ページにアクセスします。

2. 「BPELモニターおよびセンサーの無効化」チェック・ボックスを選択します。

3. 「適用」をクリックします。

4. 第39.1項「BPMNプロセス・サービス・エンジン・プロパティの構成」の手順に従って「BPMNサービス・エンジン・プロパティ」ページにアクセスします。

注意:

「BPMNサービス・エンジン・プロパティ」ページが表示されるのは、Oracle BPM Suiteがインストールされている場合のみです。

5. 「BPMN測定の無効化」チェック・ボックスを選択します。

6. 「適用」をクリックします。

センサーをSOAコンポジット・アプリケーション・レベルで無効化または有効化する手順は、次のとおりです。

1. センサーを無効化または有効化するSOAコンポジット・アプリケーションのホーム・ページに移動します。

2. 「設定」メニューからBPELビジネス監視の有効化/無効化を選択します。この選択肢は、コンポーネントにセンサーが含まれているかどうかに関係なく、BPELまたはBPMNサービス・コンポーネントを少なくとも1つ持つコンポジットに対してのみ表示されます。

センサーの現在のステータスを表示するダイアログが起動され、このダイアログでステータスを変更できます。ダイアログには、選択したコンポジットに存在するコンポーネント・タイプに適したオプションのみが表示されます。たとえば、コンポジットにBPELコンポーネントのみが含まれ、BPMNコンポーネントが含まれていない場合は、BPELセンサーのステータスを設定するオプションのみが表示されます。

次のステップでは、表示可能なダイアログのタイプと使用可能なアクションについて説明します。

1. センサーが両方のサービス・エンジン・レベルで無効化されている場合、「グローバルに無効」というメッセージがそれぞれに表示されます。このダイアログでは、「すべて有効化」または「すべて無効化」を選択できません。この場合もボタンは両方とも使用不可になります。

また、センサーがBPELサービス・エンジン・レベルで無効化されており、Oracle BPM SuiteがインストールされていないためにBPMNサービス・エンジンが表示されない場合も、このダイアログで「すべて有効化」または「すべて無効化」を選択できません。この場合もボタンは両方とも使用不可になります。

2. センサーがコンポジット・レベルで無効化されていない場合は、チェックマークが表示されます。また、センサーがBPELおよびBPMNサービス・エンジン・レベルの両方で無効化されていない場合、「グローバルに無効」というメッセージは表示されません。
「すべて無効化」をクリックすると、選択したコンポジットを構成するサービス・コンポーネントに定義されているすべてのタイプのセンサーが無効化されます。(センサーがサービス・エンジン・レベルで無効化されている場合は、無効のままです。)

3. 特定のサービス・エンジン・レベルでセンサーが無効化されている場合は、サービス・エンジン・プロパティ・ページの対応する「BPELモニターおよびセンサーの無効化」または「BPMN測定の無効化」チェック・ボックスの選択が解除されていると、コンポジット・アプリケーション・レベルでこれらのタイプのセンサーに設定したセンサー・ステータスのみが有効化されます。
たとえば、(次に表示されているように)BPMNサービス・エンジン・レベルでセンサーが無効化されているときに、選択されたコンポジット・レベルですべてのセンサーに対して「すべて有効化」を選択した場合、そのステータスはBPELなどの他のタイプのセンサーにのみ適用されます。BPMNセンサーおよびモニターは無効化されたままです。ただし、BPMNサービス・エンジンの設定を後で変更すると、このコンポジットのBPMNセンサーは自動的に有効化されます。

4. センサーがコンポジット・レベルで無効化されている場合、チェックマークは表示されません。「すべて有効化」をクリックすると、選択したコンポジットを構成するサービス・コンポーネントに定義されているすべてのタイプのセンサーが有効化されます。(サービス・エンジン・レベルで無効化されているセンサーは、サービス・エンジン・レベルの設定を変更するまでは無効のままです。)コンポジットにBPMNサービス・コンポーネントが含まれていないため、BPMNは表示されません。

アクションを選択すると、そのセンサーが有効化または無効化されたことを確認するページにインライン・メッセージが表示されます。

BPELセンサーおよびモニターの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のOracle BPELプロセス・マネージャ・センサーに関する項およびBPELプロセスでのOracle BAM Monitor Expressの使用に関する項を参照してください。

BPMN測定の詳細は、『Oracle Fusion Middleware Oracle Business Process Managementモデリングおよび実装ガイド』を参照してください。

8  SOAコンポジット・アプリケーション・インスタンスの管理

この章では、アプリケーションのテスト・インスタンスの開始、インスタンスの監視と削除、フォルトからのリカバリ、拒否メッセージの削除、複数のSOAコンポジット・アプリケーション・リビジョン間のインスタンスの移行など、SOAコンポジット・アプリケーション・インスタンスの管理方法について説明します。

この章では、次の項目について説明します。

- 第8.1項「SOAコンポジット・アプリケーションのテスト・インスタンスの起動」

- 第8.2項「アプリケーションのホーム・ページからの、SOAコンポジット・アプリケーション・インスタンスの監視と削除」

- 第8.3項「SOAインフラストラクチャ・レベルでの、SOAコンポジット・アプリケーション・インスタンスの監視と削除」

- 第8.4項「SOAインフラストラクチャ・レベルでの、SOAコンポジット・アプリケーションのフォルトのリカバリ」

- 第8.5項「アプリケーションのホーム・ページでの、SOAコンポジット・アプリケーションのフォルトのリカバリ」

- 第8.6項「SOAインフラストラクチャ・レベルでの拒否メッセージの削除」

- 第8.7項「アプリケーションのホーム・ページからの拒否メッセージの削除」

- 第8.8項「複数のSOAコンポジット・アプリケーション・リビジョン間でのインスタンスの移行」

注意:

このガイドでは、「SOAインフラストラクチャ」メニュー、ナビゲータの「soa-infra」アイコン、「SOAコンポジット」メニュー、および「SOAパーティション」メニューからOracle Enterprise Manager Fusion Middleware Controlの各ページにアクセスする手順について説明しています。また、ファーム・ホーム・ページからも多くのページにアクセスできます。詳細は、第2.2.6章「ファーム・ホーム・ページからSOAインフラストラクチャまたはSOAコンポジット・アプリケーションのホーム・ページへの移動」を参照してください。

8.1 SOAコンポジット・アプリケーションのテスト・インスタンスの起動

この章では、デプロイ済SOAコンポジット・アプリケーションのテスト・インスタンスを起動する方法について説明します。

SOAコンポジット・アプリケーションのテスト・インスタンスを起動する手順は、次のとおりです

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

「コンポジット」メニューからアクセスする手順

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

4. ページ上部の「テスト」をクリックします。

1. 「soa-infra」の下にあるパーティションを展開します。

2. 特定のSOAコンポジット・アプリケーションを選択します。

3. ページ上部の「テスト」をクリックします。

1. 「サービスのテスト」→「クライアント」の順に選択します。

注意:

次の場合は、「テスト」ボタンが無効になります。

- SOAコンポジット・アプリケーションのリビジョンが停止状態またはリタイア状態の場合。

- アプリケーションに対して使用可能なWebサービスがない場合。このページからテストできるのは、Webサービス・バインディングがあるサービスを含むコンポジットのみです。

2. コンポジットに複数のサービスが含まれる場合は、「テスト」ボタンにドロップダウン・リストが表示され、テストするサービスを選択できます。

インスタンスを起動するための「Webサービスのテスト」ページが表示されます。

このページには、インスタンスを起動するための様々なオプションが用意されています。「引数を入力」セクションでは、少なくとも、使用するXMLペイロード・データを指定する必要があります。

テスト対象として選択したサービスに基づいて、WSDLファイルおよびエンドポイントURLが自動的に移入されます。エンドポイントURLはWSDLから導出され、そのサービスを異なる場所で起動する場合はオーバーライドできます。選択したサービスに複数のポートがある場合は、ドロップダウン・リストが表示されます。そうでない場合は、現在のサービスのポートが表示されます。

3. 次の各フィールドではデフォルト値をそのまま使用するか、使用するテスト環境に適した値を入力します。

4. WSDLファイルを変更する場合は、「WSDL解析」をクリックしてWSDLファイルをリロードします。
リビジョン番号が含まれていないWSDL URLは、デフォルトのコンポジット・アプリケーションによって処理されます。たとえば、HelloWorldという名前のコンポジット・アプリケーションにリビジョンが2つ存在する場合は、次のエンドポイントが公開されます。

- http://host:port/soa-infra/services/default/HelloWorld!1.0/client

- http://host:port/soa-infra/services/default/HelloWorld!2.0/client

ただし、Webサービスの起動用に指定したWSDLにリビジョンの詳細が含まれていない場合(たとえば、http://host:port/soa-infra/services/default/HelloWorld/client)は、デフォルトとして設定されたコンポジット・リビジョンによって処理されます。

5. 「操作」メニューからテストする操作を選択します。使用可能なオプションはWSDLにより決定されます。
RESTful Webサービスをテストするには、GETまたはPOSTサービス・ポート操作を選択します。

6. エンドポイントURLを編集する場合は、「エンドポイントURLの編集」をクリックして適切に変更します。
「Webサービスのテスト」ページの下部には、「リクエスト」タブがあります。このタブでは、セキュリティ、サービスのクオリティ、HTTPトランスポート、ストレス・テスト・オプションおよびXML入力引数を指定できます。

「セキュリティ」セクションには、メッセージを使用してセキュリティ・プロパティを渡すための次のフィールドがあります。

フィールド

説明

OWSMセキュリティ・ポリシー

WS-SecurityのSOAPヘッダーを挿入します。「ユーザー名」フィールドは必須で、「パスワード」フィールドはオプションです。

HTTP Basic認証

ユーザー名とパスワード資格証明をHTTPトランスポート・ヘッダーに挿入します。「ユーザー名」および「パスワード」フィールドは両方とも必須です。

拡張

カスタム・ポリシーを使用してユーザーを認証します(カスタム・ポリシーのURIを指定します)。「ユーザー名」および「パスワード」フィールドはオプションです。

なし

セキュリティ資格証明を指定しない場合に選択します。これがデフォルトの選択です。

RESTful Webサービスのテスト時には、SOAPプロトコルは使用されないため、セキュリティ・オプションはHTTP Basic認証またはなしのみです。

7. 次の各フィールドではデフォルト値をそのまま使用するか、使用するテスト環境に適した値を入力します。
「サービスのクオリティ」セクションには、次のフィールドがあります。Oracle Fusion Middlewareでは、ポリシー・ベースのモデルを使用してWebサービスを管理します。ポリシーでは、メッセージ配信に対して動作要件が適用されます。この項の内容は、RESTful Webサービスのテスト時には使用できません。「Webサービスのテスト」ページの使用方法の詳細は、『Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイド』を参照してください。

フィールド

説明

WS-RM

次のオプションのいずれかを選択して、WS信頼できるメッセージング(RM)プロトコル・ポリシーをテストします。信頼できるメッセージング・ポリシーによって、このプロトコルがサポートされ、メッセージのエンドツーエンド配信が保証されます。

- WSDLデフォルト: WSDLのデフォルト動作を実行します。たとえば、WSDLにWS-RMポリシーへの参照が含まれる場合は、そのポリシーが適用されます。WSDLにWS-RMポリシーへの参照が含まれない場合、信頼できるメッセージングはテストされません。

- なし: WSDLにポリシーへの参照が含まれる場合でも、WS-RMのポリシーはテストされません。

- カスタム: カスタム・ポリシーを適用します。カスタム・ポリシーのURIは、「ポリシーURI」フィールドで指定します。WS-RMポリシーがWSDLで参照されている場合は無視され、かわりに「ポリシーURI」フィールドで指定したポリシーが使用されます。

MTOM

次のオプションのいずれかを選択して、メッセージ転送最適化メカニズム(MTOM)ポリシーをテストします。MTOMポリシーによって、添付がMTOMフォーマットであることが保証されます。このフォーマットは、Webサービスとの間でバイナリ・データを効率的に送受信するためのフォーマットです。

- WSDLデフォルト: WSDLのデフォルト動作を実行します。たとえば、WSDLにMTOMポリシーへの参照が含まれる場合は、そのポリシーが適用されます。WSDLにMTOMポリシーへの参照が含まれない場合、MTOMはテストされません。

- なし: WSDLにポリシーへの参照が含まれる場合でも、MTOMのポリシーはテストされません。

- カスタム: カスタム・ポリシーを適用します。カスタム・ポリシーのURIは、「ポリシーURI」フィールドで指定します。MTOMポリシーがWSDLで参照されている場合は無視され、かわりに「ポリシーURI」フィールドで指定したポリシーが使用されます。

WSアドレス

次のオプションのいずれかを選択して、WS-Addressingポリシーをテストします。WS-Addressingポリシーによって、WS-Addressing仕様に準拠したWS-AddressingヘッダーがSOAPメッセージに含まれていることが検証されます。

- WSDLデフォルト: WSDLのデフォルト動作を実行します。たとえば、WSDLにWS-Addressingポリシーへの参照が含まれる場合は、そのポリシーが適用されます。WSDLにWS-Addressingポリシーへの参照が含まれない場合、WS-Addressingはテストされません。

- なし: WSDLにポリシーへの参照が含まれる場合でも、WS-Addressingのポリシーはテストされません。

- カスタム: カスタム・ポリシーを適用します。カスタム・ポリシーのURIは、「ポリシーURI」フィールドで指定します。WS-AddressingポリシーがWSDLで参照されている場合は無視され、かわりに「ポリシーURI」フィールドで指定したポリシーが使用されます。

8. 次の各フィールドではデフォルト値をそのまま使用するか、使用するテスト環境に適した値を入力します。
「HTTPトランスポート・オプション」セクションには、次のフィールドがあります。

フィールド

説明

SOAPアクションの有効化

WSDL soap:operationにsoapAction属性があるかどうかを指定します。このフラグは、soapAction属性が存在する場合に有効になります。SOAPアクションのHTTPヘッダーを使用してリクエストを送信しない場合は、このチェック・ボックスの選択を解除します。

SOAPアクション

WSDL soap:operationのsoapAction属性が表示されます(存在する場合)。このテキスト・ボックスで別のSOAPアクションを指定することもできます。

この項の内容は、RESTful Webサービスのテスト時には使用できません。

9. 次の各フィールドではデフォルト値をそのまま使用するか、使用するテスト環境に適した値を入力します。
「追加テスト・オプション」セクションには、次のフィールドがあります。このセクションでは、複数インスタンスを同時に起動する簡単なストレス・テストを指定します。

注意:

これは、本当の意味でのストレス・テスト・ツールではありません。したがって、同時スレッド数および操作を起動する回数として大きい値を入力しないでください。そうしないと、エラーが発生する場合があります。

フィールド

説明

ストレス・テストの有効化

「有効化」をクリックして、簡単なストレス・テストを作成します。このオプションを有効にすると、対話IDは表示されません。

同時スレッド

起動を送信する同時スレッドの数を入力します。デフォルトは5スレッドです。

スレッドごとのループ

操作を起動する回数を入力します。デフォルトは10回です。

ミリ秒単位の遅延

次の操作を起動するまでの遅延をミリ秒単位で指定します。デフォルトは1000ミリ秒(1秒)です。

10. 次の各フィールドではデフォルト値をそのまま使用するか、使用するテスト環境に適した値を入力します。
「引数を入力」セクションには、XMLペイロード・データを入力するための次のフィールドがあります。

フィールド

説明

ツリー表示

情報を入力するテキスト・フィールドのグラフィカル・インタフェースが表示されます。このフィールドを選択すると、必要なヘッダーとXML構造が自動的に生成されます。

XML表示

値の挿入のためのXMLファイル形式が表示されます。このフィールドには、メッセージのraw XMLペイロードを貼り付けることができます。

注意:

Oracle Enterprise Manager Grid Controlを使用している場合は、入力したペイロードを保存できます。この機能は、Oracle Enterprise Manager Fusion Middleware Controlでは使用できません。

11. 「Webサービスのテスト」をクリックします。
テストを終了すると、「レスポンス」タブに結果が表示されます。

注意:

ストレス・テストの実行中、または非同期サービスのテスト中の場合、「レスポンス」タブにペイロード・データは表示されません。

12. 「メッセージ・フロー・トレースの起動」をクリックして、インスタンスのフローのトレースにアクセスします。

13. コンポジットのホーム・ページに戻るには、ページの上部に表示されるコンポジット名をクリックするか、コンポジット・ターゲット・メニューから「ホーム」を選択します。

14. SOAコンポジット・アプリケーションの「ダッシュボード」ページに戻ります。
「最新のインスタンス」表に、最新のSOAコンポジット・アプリケーションのインスタンスがリストされます。作成された各インスタンスには、固有のIDが付いています。

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

- インスタンスの概念の詳細は、第1.2.3項「SOAコンポジット・アプリケーション・インスタンスの概要」を参照してください。

- ポリシーの概要については、第1.4.3.2項「ポリシーの概要」を参照してください。

- 「Webサービスのテスト」ページからのWebサービスのテスト、およびポリシーに関する具体的な詳細は、『Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイド』を参照してください。

8.1.1 「Webサービスのテスト」ページでのRPC/リテラル・スタイルのWSDLファイルの指定

"element="によって定義されたメッセージを持つRPC/リテラル・スタイルのWSDLファイルを指定する場合、Oracle Enterprise Manager Fusion Middleware Controlの「Webサービスのテスト」ページで、「引数の入力」セクションの「XML表示」オプションを使用して、SOAPメッセージを変更します。SOAP本文は、例8-1に示されるようになります。

例8-1 SOAP本文

<soap:Body>
<ns:initiate>
<payload>
<value xmlns="...">3</value>
</payload>
</ns:initiate>
</soap:Body>

ここで、initiateは操作名、payloadはパーツ名、およびvalueはWSDLメッセージ/部分に定義されている要素です。

8.2 アプリケーションのホーム・ページからの、SOAコンポジット・アプリケーション・インスタンスの監視と削除

第7.5項「デプロイ済SOAコンポジット・アプリケーションの状態管理」では、SOAコンポジット・アプリケーションのライフサイクルの状態を管理する方法を説明しました。アプリケーションのホーム・ページの「インスタンス」ページでは、特定のSOAコンポジット・アプリケーションのインスタンスを監視および削除することもできます。

アプリケーションのホーム・ページからSOAコンポジット・アプリケーションのインスタンスを監視および削除する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にあるパーティションを展開します。

2. 特定のSOAコンポジット・アプリケーションを選択します。

2. 「インスタンス」タブをクリックします。
「インスタンス」ページに、次の詳細が表示されます。

- 特定のインスタンスを検索するためのユーティリティ。基準を指定して「検索」をクリックします。デフォルトでは、このページに初めてアクセスしたときにはインスタンスは表示されません。インスタンスを表示するには、「検索」をクリックする必要があります。

- SOAコンポジット・アプリケーションのインスタンスID、名前、対話ID、ページの最終データ・リフレッシュ以降の各インスタンスの最新状態(正常完了、実行中、不明など)、インスタンスの開始時間、フォルトが記述されているログ・ファイル。SOAコンポジット・アプリケーションの新しいインスタンスが起動されるたびに、一意のインスタンスIDが作成されます。インスタンスは、アプリケーションの外部コンシューマによって自動的に起動されるか、管理者が「Webサービスのテスト」ページから手動で起動します。
「?」アイコンが表示される場合は、SOAインフラストラクチャの「共通プロパティ」ページで「コンポジット・インスタンスの状態をキャプチャ」チェック・ボックスが選択されていません。このため、インスタンスの状態が評価されません。コンポジット・インスタンスの状態の判定には、基礎となるコンポーネントの状態の評価が必要です。したがって、このオプションを無効にするとパフォーマンスを向上できます。

注意:

孤立したサービス・コンポーネント・インスタンスが生成される可能性があります。このようなインスタンスは、関連するコンポジット・アプリケーション・インスタンスなしで生成されます。孤立したコンポーネント・インスタンスは、次の状況で生成されます。

- SOAインフラストラクチャの監査レベルが「オフ」に設定されている場合、またはコンポジットの監査レベルが「オフ」に設定されている場合。このような場合でも、BPELプロセス・サービス・エンジンでは、SOAコンポジット・アプリケーションに組み込まれているサービス・コンポーネントのインスタンス・データを生成できます。

- SOAインフラストラクチャの監査レベルが「オフ」に設定されている場合。ただし、BPELプロセスまたはOracle Mediatorサービス・エンジンの監査レベルがオフ以外の値に設定されている場合。

- すべての監査レベルが「オフ」に設定されているが、いずれかのサービス・エンジンでフォルトが生成された場合。この場合は、コンポーネント・インスタンスが生成されます。

孤立したインスタンス、または大量のインスタンスを削除するには、第10.3項「パージ・スクリプトを使用した大量のインスタンスの削除」で説明されているパージ・スクリプトを使用します。「オプションを指定して削除」ダイアログの「すべてのインスタンスを削除」オプションを選択しても、孤立したコンポーネント・インスタンスは削除されません。

コンポジット・センサーがSOAコンポジット・アプリケーションに組み込まれている場合は、「インスタンス」タブの表示が次のように異なります。

- 検索ユーティリティにある「検索」および「リセット」ボタンの横に、「フィールドの追加」ボタンが表示されます。このボタンを使用して、センサー値を検索基準に追加できます。

- 「インスタンス」表に「コンポジット・センサー」列が表示されます。この列のセンサー・アイコンをクリックすると、コンポジットの指定のインスタンスで使用可能なセンサー値の詳細が表示されます。

3. 「フィールドの追加」リストから、検索基準に追加するコンポジット・センサーを選択します。この例では、CustomerForOrder、OrderProcessingStart、およびCreditCardAuthResultSensorの3つが選択されています。

4. 各センサーが検索する特定の値を入力します。指定した基準とセンサー値が一致するコンポジット・インスタンスのみ返されます。

「コンポジット・センサー」列は、このSOAコンポジット・アプリケーションにコンポジット・センサーが含まれていることを示します。

5. 検索基準からすべてのコンポジット・センサー・フィールドを削除するには、「リセット」をクリックします。センサーを個別に削除するには、フィールドの右側にある「削除」アイコンをクリックします。
また、SOAインフラストラクチャ内のSOAコンポジット・アプリケーションのインスタンスでコンポジット・センサーを検索することもできます。書式[sensor name]=[sensor value]を使用して、センサー名と検索対象の値を指定します。詳細は、第8.3項「SOAインフラストラクチャ・レベルでの、SOAコンポジット・アプリケーション・インスタンスの監視と削除」を参照してください。

6. 「インスタンス」表の行をクリックして、削除する特定のインスタンスを選択します。複数のインスタンスを選択する場合は、[Ctrl]キーまたは[Shift]キーを押しながら、選択する行をクリックします。

7. 実行する特定のアクションを選択します。

アクション

説明

フィルタ条件

コンポジット・インスタンスの状態を表示するための基準を指定します。

- 実行状態
実行状態(実行中、完了、終了または失効)でインスタンスの表示をフィルタリングします。

- フォルト状態
フォルト状態(フォルトあり、フォルトなし)でインスタンスの表示をフィルタリングします。リカバリが必要なフォルトとリカバリ不可のフォルトを表示するように選択することで、フォルト状態をさらにカスタマイズできます。「実行状態」リストから「失効」を選択すると、「フォルト状態」リストは無効になります。

- BPELリカバリ
リカバリ・アクションが必要かどうかでインスタンスの表示をフィルタリングします。デフォルトでは、このフィルタは、メッセージと過去5分間に作成されたすべてのメッセージとインスタンスを除外し、これら以外を表示します。時間の長さ(分)は、システムMBeanブラウザのAuditConfigプロパティのexcludeBpelMaxCreationTimeキーで制御できます。このプロパティは、SOAインフラストラクチャの「共通プロパティ」ページの「詳細SOAインフラ拡張構成プロパティ」セクションで使用できます。詳細は、第3.1項「SOAインフラストラクチャ・プロパティの構成」を参照してください。

選択項目の削除

選択したインスタンスを削除します。

インスタンスを削除すると、インスタンス詳細は確認できなくなります。

オプションを指定して削除

選択したインスタンスをデータベースから直接削除するための基準を最初に指定するように、プロンプトが表示されます。

このオプションは、実行中のロールバックされたインスタンスを削除する場合に使用します。ただし、このオプションでは、リカバリ待機中の関連する呼出しメッセージは削除されません。その結果、BPELメッセージ・リカバリで保留される孤立したメッセージが発生します。これらのメッセージを削除するには、BPELプロセス・サービス・エンジンの「リカバリ」ページに移動します。

- 共通削除オプション: リストから削除するインスタンスの範囲を、事前に設定された範囲から選択します(たとえば、「24時間以上経過」)。

- このコンポジットのすべてのインスタンスを削除: コンポジットのすべてのインスタンスを削除する場合に選択します。このオプションを選択すると、関連する拒否メッセージ、およびコンポジットに関連付けられたすべてのコンポーネント・インスタンス、サービス・インスタンスおよび参照インスタンスが削除されます。これには、コンポジット・インスタンスIDに関連付けられていないインスタンスも含まれます。
注意: 削除するインスタンスがコンポジット内に大量(数千)にある場合は、このオプションを使用しないでください。このオプションではなく、第10.3項「パージ・スクリプトを使用した大量のインスタンスの削除」で説明されているパージ・スクリプトを使用してください。

- これらの条件と一致するすべてのインスタンスを削除します: インスタンスを削除する基準(開始時間と停止時間、インスタンスの状態)を指定します。

この操作では、「インスタンス」ページで選択した内容(検索基準の指定や実行など)は無視されます。

インスタンスの削除の進行状況を監視するには、ログ・ファイルを確認する必要があります。ログ・ファイルの詳細は、第3.4項「ログ・ファイルの構成」を参照してください。

中断

選択したインスタンスを終了します。ただし、インスタンス詳細は確認できます。

8. 「ビュー」リストから、「列」→「パーティション」の順に選択し、SOAコンポジット・アプリケーション・リビジョンのインスタンスが含まれているパーティションを表示します。

9. 「ビュー」リストから、「列」→「ECID」の順に選択して、実行コンテキストID (ECID)を表示します。ECIDを使用すると、様々なコンポジットのインスタンス間のメッセージ・フローを追跡できます。

10. 「インスタンス」表で、次の追加タスクを実行します。

1. 「インスタンスID」列で、特定のインスタンスIDをクリックし、様々なサービス・コンポーネントやバインディング・コンポーネント間のメッセージ・フローを表示します。インスタンスIDが使用不可能と表示される場合は、「使用不可能」リンクをクリックすると詳細を表示できます。

2. 「状態」列にインスタンスの状態が「不明」と表示される場合は、クリックすると詳細が表示されます。

3. 「コンポジット・センサー」列が表示されている場合は、センサー・アイコンをクリックすると、インスタンスに組み込まれているコンポジット・センサーの詳細(名前、場所、値など)が表示されます。

4. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

注意:

インバウンドJCAアダプタを含むSOAコンポジット・アプリケーションのリビジョンが複数ある場合は、すべて「実行中」と表示されます。ただし、最新のリビジョン(デフォルトのリビジョン)のみがアクティブと見なされます。以前のすべてのリビジョンはアクティブと見なされません。これは、インバウンドJCAアダプタの場合、SOAコンポジット・アプリケーションのアクティブなリビジョンは一度に1つのみであるためです。以前のすべてのリビジョンにあるJCAアダプタ・エンドポイントは非アクティブ化されます。

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

- 第1.2.3項「SOAコンポジット・アプリケーション・インスタンスの概要」

- 第1.4.3.3項「SOAコンポジット・アプリケーションのライフサイクルの状態の概要」

- 第8.1項「SOAコンポジット・アプリケーションのテスト・インスタンスの起動」

- ログ・ファイルの表示および検索については、『Oracle Fusion Middleware管理者ガイド』を参照してください

8.2.1 SOAコンポジット・アプリケーション・インスタンス数とサービス・コンポーネント・インスタンス数の不一致

SOAコンポジット・アプリケーション・インスタンス数は、必ずしもOracle Enterprise Manager Fusion Middleware Controlに表示されるサービス・コンポーネント・インスタンス数と一致しません。

SOAコンポジット・アプリケーション・インスタンスは、最初はコンポジットの起動時に作成されます。コンポジット内のサービス・コンポーネントが後続の起動を受信すると、前に作成されたコンポジット・インスタンスIDを参照する、対応するサービス・コンポーネント・インスタンスが作成されます。

コンポジット・インスタンスが作成され、基礎となるサービス・コンポーネント・インスタンスが作成されていない状況が発生することがあります。例:

- コンポジット・インスタンスが作成されたが、システム障害により、起動がまだサービス・コンポーネントに到達していない場合。

- コンポジット・インスタンスが作成されたが、起動でペイロード検証に失敗し、拒否された場合。この場合、起動は基礎となるサービス・コンポーネントに到達しません。

また、SOAコンポジット・アプリケーション・インスタンスが作成されていない、孤立したサービス・コンポーネント・インスタンスがある場合もあります。

8.2.2 サービス・コンポーネントとSOAコンポジット・アプリケーションのインスタンスの状態

複数のサービス・コンポーネント(たとえば、2つのBPELプロセス・サービス・コンポーネント)を持つSOAコンポジット・アプリケーションがあるとします。これらのサービス・コンポーネントは、インスタンスの状態が次のようにマークされています。

- 1つのBPELプロセスのインスタンスの状態は、完了としてマークされています。

- もう一方のBPELプロセスのインスタンスの状態は、フォルトとしてマークされています。

この場合、コンポジット・インスタンス全体の状態はフォルトとしてマークされます。この動作は、同じシナリオでコンポジット・インスタンス全体の状態が完了としてマークされる11g リリース1 (11.1.1.2)と異なります。

子SOAコンポジット・アプリケーションをコールする親SOAコンポジット・アプリケーションがあり、子コンポジットでフォルトが発生した(そして、親コンポジットによって処理された)とします。この場合、インスタンスの状態は次のようになります。

- 子コンポジットのインスタンスの状態は、フォルトとしてマークされます。

- 親コンポジットのインスタンスの状態は、完了としてマークされます。

8.3 SOAインフラストラクチャ・レベルでの、SOAコンポジット・アプリケーション・インスタンスの監視と削除

第7.5項「デプロイ済SOAコンポジット・アプリケーションの状態管理」では、特定のSOAコンポジット・アプリケーションのすべてのインスタンスのライフサイクルの状態を管理する方法を説明しました。「SOAインフラストラクチャ」のホーム・ページの「インスタンス」ページでは、デプロイ済のすべてのSOAコンポジット・アプリケーションの中から任意の数のインスタンスを監視および削除できます。また、すべてのSOAコンポジット・アプリケーションのインスタンスでコンポジット・センサーを検索することもできます。このページには、SOAインフラストラクチャにデプロイされているすべてのSOAコンポジット・アプリケーション・インスタンスがリストされます。

SOAインフラストラクチャ・レベルでSOAコンポジット・アプリケーションのインスタンスを監視および削除する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

SOAコンポジットのメニューから...

1. 「ホーム」を選択します。

1. 「soa-infra」をクリックします。

1. 「SOAインフラストラクチャ」を選択します。

2. 「インスタンス」タブをクリックします。
「インスタンス」ページに、次の詳細が表示されます。

- 特定のインスタンスを検索するためのユーティリティ。基準を指定して「検索」をクリックします。デフォルトでは、このページに初めてアクセスしたときにはインスタンスは表示されません。インスタンスを表示するには、「検索」をクリックする必要があります。

- SOAインフラストラクチャのすべてのSOAコンポジット・アプリケーション・インスタンス。インスタンスID、対話ID、コンポジットの名前とリビジョン、SOAコンポジット・アプリケーション・インスタンスの状態、およびインスタンスの開始時間が表示されます。

このページからインスタンスの終了および削除も実行できます。

3. 「インスタンス」表の行をクリックして、特定のインスタンスを選択します。複数のインスタンスを選択する場合は、[Ctrl]キーまたは[Shift]キーを押しながら、選択する行をクリックします。

4. 実行する特定のアクションを選択します。

アクション

説明

検索ユーティリティでのコンポジット・センサーの検索

SOAインフラストラクチャ内のSOAコンポジット・アプリケーションのインスタンスでコンポジット・センサーを検索できます。書式[sensor name]=[sensor value] (大カッコは必須です)を使用して、センサー名と検索対象の値を指定します。指定する書式は「センサー」フィールドをクリックした場合も表示されます。検索結果に、指定されたセンサー名と値が含まれるインスタンスが表示されます。

指定されたセンサー・パターンがSOAコンポジット・アプリケーションのどのコンポジット・センサーとも一致しない場合、インスタンスは表示されません。一致が見つかった場合は、コンポジットのインスタンスが表示されます。

次のコンポジット・センサー検索の表記規則に注意してください。

- サポートされる演算子は等号(=)のみです。

- センサー名と文字列値は大文字と小文字が区別され、SOAコンポジット・アプリケーションの「インスタンス」ページの「コンポジット・センサー」列、またはインスタンスの「フローのトレース」ページの「センサー」表の表示どおりに正確に入力する必要があります。

- センサーのDate型を基準にしたフィルタリングはサポートされません。

- 数値センサー値を指定するには、後続のゼロなしで正確な値を入力する必要があります。たとえば、数値センサーの値がSOAコンポジット・アプリケーションの「インスタンス」ページに3.230と表示される場合は、0なしでセンサー文字列を入力します。

[numeric_sensor]=[3.23]

- 「インスタンス」ページまたは「フローのトレース」ページでカンマ付きで表示されるコンポジット・センサー値には、カンマをつけないでください(例: 2,011ではなく、2011と入力します)。

SOAコンポジット・アプリケーション・レベルでのセンサー名と値の取得の詳細は、第8.2項「アプリケーションのホーム・ページからのSOAコンポジット・プ・インスタンスの監視と削除」および第14.1項「BPELプロセス・サービス・コンポーネントの監査証跡とプロセス・フローの監視」を参照してください。

フィルタ条件

コンポジット・インスタンスの状態を表示するための基準を指定します。

- 実行状態
実行状態(実行中、完了、終了または失効)でインスタンスの表示をフィルタリングします。

- フォルト状態
フォルト状態(フォルトあり、フォルトなし)でインスタンスの表示をフィルタリングします。リカバリが必要なフォルトとリカバリ不可のフォルトを表示するように選択することで、フォルト状態をさらにカスタマイズできます。「実行状態」リストから「失効」を選択すると、「フォルト状態」リストは無効になります。

- BPELリカバリ
リカバリ・アクションが必要かどうかでインスタンスの表示をフィルタリングします。デフォルトでは、このフィルタは、メッセージと過去5分間に作成されたすべてのメッセージとインスタンスを除外し、これら以外を表示します。時間の長さ(分)は、システムMBeanブラウザのAuditConfigプロパティのexcludeBpelMaxCreationTimeキーで制御できます。このプロパティは、SOAインフラストラクチャの「共通プロパティ」ページの「詳細SOAインフラ拡張構成プロパティ」セクションで使用できます。詳細は、第3.1項「SOAインフラストラクチャ・プロパティの構成」を参照してください。

選択項目の削除

選択したインスタンスを削除します。

オプションを指定して削除

選択したインスタンスをデータベースから直接削除するための基準を最初に指定するように、プロンプトが表示されます。

このオプションは、実行中のロールバックされたインスタンスを削除する場合に使用します。ただし、このオプションでは、リカバリ待機中の関連する呼出しメッセージは削除されません。その結果、BPELメッセージ・リカバリで保留される孤立したメッセージが発生します。これらのメッセージを削除するには、BPELプロセス・サービス・エンジンの「リカバリ」ページに移動します。

- 共通削除オプション: リストから削除するインスタンスの範囲を、事前に設定された範囲から選択します(たとえば、「24時間以上経過」)。

- これらの条件と一致するすべてのインスタンスを削除します: インスタンスを削除する基準(開始時間と停止時間、インスタンスの状態)を指定します。

この操作では、「インスタンス」ページの上部で選択したインスタンスの状態は無視されます。

インスタンスの削除の進行状況を監視するには、ログ・ファイルを確認する必要があります。ログ・ファイルの詳細は、第3.4項「ログ・ファイルの構成」を参照してください。

注意:

- 削除するインスタンスがコンポジット内に大量(数千)にある場合は、このオプションを使用しないでください。このオプションではなく、第10.3項「パージ・スクリプトを使用した大量のインスタンスの削除」で説明されているパージ・スクリプトを使用してください。

- フォルトが発生したインスタンスを削除すると、そのフォルトは「フォルト・メッセージと拒否メッセージ」ページに表示されなくなります。

- このオプションでは、BPELプロセス・サービス・エンジンのリカバリ可能な呼出しおよびコールバック・メッセージはパージされません。それらのメッセージを完全にパージするには、第10.3項「パージ・スクリプトを使用した大量のインスタンスの削除」で説明するパージ・スクリプトを使用してください。

中断

選択したインスタンスを終了します。ただし、インスタンス詳細は確認できます。

注意: フォルトが発生したインスタンスを削除すると、そのフォルトは「フォルト・メッセージと拒否メッセージ」ページに表示されなくなります。さらに、終了したインスタンス(「中断」と表示)にフォルトがある場合、そのフォルトはフォルト件数に含まれません。

5. 「インスタンス」表で、次の追加タスクを実行します。

1. 「ビュー」リストから、「列」→「パーティション」の順に選択し、SOAコンポジット・アプリケーション・リビジョンのインスタンスが含まれているパーティションを表示します。

2. 「ビュー」リストから、「列」→「ECID」を選択して、ECIDを表示します。ECIDを使用すると、様々なコンポジットのインスタンス間のメッセージ・フローを追跡できます。

3. 「インスタンスID」列で、特定のインスタンスIDをクリックし、様々なサービス・コンポーネントやバインディング・コンポーネント間のメッセージ・フローを表示します。インスタンスIDが使用不可能の場合は、メッセージ・フローにアクセスできません。ただし、リンクをクリックして詳細を確認することはできます。

4. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

5. 「インスタンスの状態」列で、「リカバリ」アイコンをクリックし、コンポジット・インスタンスIDに基づいてフォルトがフィルタリングされている「フォルトと拒否メッセージ」ページにアクセスします。1つのコンポジット・インスタンスIDに対して複数のフォルトが存在する場合があります。

6. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

8.4 SOAインフラストラクチャ・レベルでの、SOAコンポジット・アプリケーションのフォルトのリカバリ

複数のSOAコンポジット・アプリケーションでBPELプロセスとOracle Mediatorサービス・コンポーネントを監視し、個別のフォルト・リカバリと一括のフォルト・リカバリを実行できます。リカバリ可能として識別されたBPELプロセス・フォルトについては、(fault-bindings.xmlファイルを介して)フォルトにバインドされ、アクションora-human-interventionをトリガーするフォルト・ポリシーが定義されている必要があります。ただし、フォルト・ポリシーが定義されていない場合、フォルトは、リカバリ可能またはリカバリ不可のフォルトとして通常どおり処理されます。この項では、個別リカバリと一括リカバリの両方の実行例を示します。ヒューマン・タスク・サービス・コンポーネントまたはヒューマン・ワークフロー・サービス・エンジンのフォルトは、Oracle BPM Worklistからリカバリされます。

また、未配信BPELプロセスの起動またはコールバック・メッセージの手動リカバリも実行できます。詳細は、第15.4項「BPELプロセス・サービス・エンジンのメッセージ・リカバリの実行」を参照してください。

SOAインフラストラクチャ・レベルでSOAコンポジット・アプリケーション・フォルトをリカバリする手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

SOAコンポジットのメニューから...

1. 「ホーム」を選択します。

1. 「soa-infra」をクリックします。

1. 「SOAインフラストラクチャ」を選択します。

2. 「フォルト・メッセージと拒否メッセージ」タブをクリックします。
「フォルト・メッセージと拒否メッセージ」ページに、すべてのSOAコンポジット・アプリケーション・フォルトについて、次の詳細が表示されます。

- 特定のフォルトを検索するためのユーティリティ。基準を指定して「検索」をクリックします。詳細は、「ヘルプ」アイコンをクリックしてください。デフォルトでは、このページに初めてアクセスしたときにはフォルトは表示されません。フォルトを表示するには、「検索」をクリックする必要があります。

- インスタンス・リカバリ・アクション(再試行、中断、リプレイなど)、拒否メッセージの削除および一括メッセージ・リカバリの実行を選択するオプション。

- フォルト・メッセージと拒否メッセージ。エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、フォルト・メッセージが拒否されたメッセージとして分類されているかどうか(その場合はチェックマークが表示されます)、フォルトが発生したSOAコンポジット・アプリケーション、フォルトの場所、インスタンスID、およびフォルトが記述されているログ・ファイルへのリンクが表示されます。

注意:

ヒューマン・ワークフローのフォルトはデハイドレーション・ストアに保持されないため、ヒューマン・ワークフローのエラー・メッセージは「エラー・メッセージの内容」フィールドに詳細を入力しても検索できません。

リカバリ可能として識別されたフォルトはリカバリできます。

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

対象

操作

単一フォルト・リカバリ

単一フォルト・リカバリは、次の3通りの方法で選択できます。

1. リカバリ可能として識別されたフォルトの行をクリックします。行が強調表示された状態で、ステップ4の説明に従って、「リカバリ・アクション」リストから特定のアクションを選択します。

2. 「リカバリ」列で「リカバリ」リンクをクリックし、インスタンス監査証跡の「フォルト」ページにアクセスしてフォルト・リカバリを実行します。

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

一括フォルト・リカバリ

一括フォルト・リカバリは、次の2通りの方法で選択できます。

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

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

3. ステップ4の説明に従って、「リカバリ・アクション」リストからアクションを選択します。
注意: 選択できるのは、選択したすべてのフォルトに適用可能なアクションのみです。

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

1. 「選択」メニューから、「すべてのリカバリ可能な値を選択」を選択します。

2. ステップ4の説明に従って、「リカバリ・アクション」リストからアクションを選択します。
注意: 選択できるのは、選択したすべてのフォルトに適用可能なアクションのみです。

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

アクション

説明

アクションの対象

再試行

インスタンスを直接再試行します。このリカバリ・アクションを使用するシナリオ例は、ネットワーク・エラーのためにサービス・プロバイダにアクセスできないことが原因でフォルトが発生した場合の例です。ネットワーク・エラーは現在解決しています。

BPELプロセスとOracle Mediator

中断

インスタンス全体を終了します。

BPELプロセスとOracle Mediator

リプレイ

フォルトが発生したスコープ全体を再度リプレイします。

BPELプロセス

再スロー

現在のフォルトを再スローします。フォルトの処理に、BPELフォルト・ハンドラ(catchブランチ)が使用されます。デフォルトでは、再スロー・フォルト・ポリシーが明示的に指定されていない場合、すべての例外がフォルト管理フレームワークによって捕捉されます。

BPELプロセス

続行

フォルトを無視して処理を続行します(フォルト・アクティビティには成功のマークが付けられます)。

BPELプロセス

注意:

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

5. SOAインフラストラクチャのすべてのコンポジットの拒否メッセージを削除する場合は、第8.6項「SOAインフラストラクチャ・レベルでの拒否メッセージの削除」を参照してください。

6. メッセージの一括リカバリを実行する場合は、「オプションを指定してリカバリ」をクリックします。
すべてのコンポジットのBPELメッセージとOracle Mediatorメッセージをデータベースから直接リカバリする基準を指定する「オプションを指定してリカバリ」ダイアログが表示されます。ヒューマン・ワークフロー・メッセージは、Oracle BPM Worklistから手動でリカバリできます。ビジネス・イベントとビジネス・ルール・メッセージはリカバリできません。

7. 条件を指定します。許可されるリカバリ・アクションは、「再試行」と「中断」のみです。

注意:

SOAインフラストラクチャ・レベルの一括フォルト・リカバリでは、コンポジットの状態チェックを実行できません。コンポジットの状態がオフに設定されている場合は、そのフォルトのリカバリを実行できません。ただし、エラーや警告メッセージは表示されません。一括フォルト・リカバリ・リクエストの発行時に、サーバーは元のコンポジットの状態がオフに設定されているかどうかをチェックします。その事実がログに記録され、フォルトがスキップされます。

その他の理由(たとえば、サポートされていないサービス・エンジンやリカバリできないフォルトなど)でリカバリ中にフォルトがスキップされた場合も通知されません。

8. 「リカバリ」をクリックします。メッセージの数に応じて、リカバリにかかる時間は異なります。

9. フォルト表内から次の追加タスクを実行します。

1. 「ビュー」リストから、「列」→「フォルトID」の順に選択し、各エラー・メッセージのフォルトIDを表示します。フォルトIDは自動的に生成され、フォルトを一意に識別します。フォルトIDは、エラー・メッセージをクリックしたときも表示されます。

2. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

3. 「フォルトの場所」列で、特定の場所をクリックし、フォルトの場所に関するフォルト・ページにアクセスします。フォルトの場所は、サービス、サービス・コンポーネントまたは参照です。

4. 「コンポジット・インスタンスID」列で、特定のIDをクリックし、インスタンスのフローのトレースにアクセスします。

5. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

10. BPELプロセスとOracle Mediatorでの単一および一括フォルト・リカバリの例については、次の各項を参照してください。

- 第8.4.1項「BPELプロセスに対するフォルト・リカバリの例」

- 第8.4.2項「BPMNプロセスに対するフォルト・リカバリの例」

- 第8.4.3項「Oracle Mediatorに対するフォルト・リカバリの例」

フォルト・ポリシーの概念と設計方法の詳細は、次のドキュメントを参照してください。

- 第1.4.3.1項「フォルト・リカバリの概要」

- 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のフォルト管理フレームワークによるフォルトの処理に関する項

8.4.1 BPELプロセスに対するフォルト・リカバリの例

この項では、BPELプロセスのフォルトに対して管理者操作を可能にするフォルト・ポリシーを定義し、BPELプロセス・サービス・コンポーネントで単一フォルト・リカバリおよび一括フォルト・リカバリを実行する方法の例を示します。

- 第8.4.1.1項「例: BPELプロセスに対する単一フォルト・リカバリ」

- 第8.4.1.2項「例: BPELプロセスに対する一括フォルト・リカバリ」

この例では、管理者操作によってフォルトを手動でリカバリできるフォルト・ポリシーを定義します。無効な社会保障番号が、融資ブローカBPELプロセスから信用格付けサービスに発行されると、信用格付けサービスはネガティブ情報フォルトを返します。この例の管理者操作によるアクションは、fault-policies.xmlファイルのora-human-interventionアクションで定義します。フォルト・ポリシーが定義されていない場合、BPELインスタンスではリカバリ可能なフォルトを生成しません(フォルトはリカバリ不可になります)。この場合は、ora-human-interventionアクションを使用してフォルトをリカバリ可能にします。例8-2は、フォルト・ポリシー・ファイルを示しています。

例8-2 フォルト・ポリシー・ファイル

<faultPolicies xmlns="http://schemas.oracle.com/bpel/faultpolicy">
<faultPolicy version="2.0.1"
id="CRM_ServiceFaults"
xmlns:env="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns="http://schemas.oracle.com/bpel/faultpolicy"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Conditions>
<faultName xmlns:credit="http://services.otn.com"
name="credit:NegativeCredit">
<!-- get this fault when SSN starts with 0-->
<condition>
<test>$fault.payload="Bankruptcy Report"</test>
<action ref="ora-human-intervention"/>
</condition>
</faultName>
</Conditions>
</faultPolicy>
</faultPolicies>

例8-3に示されるfault-bindings.xmlファイルは、fault-policies.xmlファイルで定義されたフォルト・ポリシーをCRM_ServiceFaultsコンポジット・アプリケーションと関連付けます。

例8-3 フォルト・ポリシー・バインディング・ファイル

<faultPolicyBindings version="2.0.1"
xmlns="http://schemas.oracle.com/bpel/faultpolicy"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<composite faultPolicy="CRM_ServiceFaults"/>
</faultPolicyBindings>

管理者操作はアクションとして定義されているため、BPELプロセスに対するフォルト・リカバリはOracle Enterprise Manager Fusion Middleware Controlで実行します。

fault-policies.xmlファイルおよびfault-bindings.xmlファイルの作成と設計の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

BPELプロセス・メッセージ・リカバリの詳細は、第15.4項「BPELプロセス・サービス・エンジンのメッセージ・リカバリの実行」を参照してください。

8.4.1.1 例: BPELプロセスに対する単一フォルト・リカバリ

この例の前提は次のとおりです。

- インスタンスが、第8.1項「SOAコンポジット・アプリケーションのテスト・インスタンスの起動」で示した「Webサービスのテスト」ページで起動されました。

- 0で始まる無効な社会保障番号が入力されました。

BPELプロセスに対して単一フォルト・リカバリを実行する手順は、次のとおりです。

1. 「SOAインフラストラクチャ」メニューから、「ホーム」を選択します。

2. 「フォルト・メッセージと拒否メッセージ」タブをクリックします。

3. フォルト表で、リカバリ可能として識別されたフォルトを検索します。検索ユーティリティを使用して、特定のフォルトを検索できます。

4. 「リカバリ」列で、「リカバリ」をクリックします。最初にフォルトの詳細を表示する場合は、エラー・メッセージをクリックします。次に、「ここでリカバリ」をクリックします。
BPELプロセス・インスタンスの「フォルト」ページが表示されます。

5. 「リカバリ」列で、「リカバリ可能」をクリックします。
ページがリフレッシュされ、ページの下部にフォルト・リカバリ・セクションが表示されます。

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

7. 「再試行成功時のチェーン・アクション」リストから「なし」を選択します。このリストでは、Javaコールアウト・リカバリ・アクションを選択できます。詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

8. 「変数」リストから変数を選択します。この変数の内容が「値」フィールドに表示されます。この例では、変数crInputが選択されています。この変数は、invokeアクティビティで使用され、不適切な社会保障番号の値を含んでいます。

9. 「値」フィールドに適切な値を入力します。この例では、社会保障番号を1で始まるように編集します。

<ssn xmlns="http://service.otn.com">123456789</ssn>

10. 「設定値」をクリックし、プロンプトが表示されたら「はい」をクリックして続行します。

11. 「リカバリ」をクリックしてフォルトをリカバリし、プロンプトが表示されたら「はい」をクリックして続行します。
ページがリフレッシュされ、フォルトが発生していないことが示されます。

8.4.1.2 例: BPELプロセスに対する一括フォルト・リカバリ

社会保障番号の例の場合、「再試行」の選択は、一括リカバリを実行するためのオプションではありません。これは、社会保障番号の値が不適切で、修正が必要になるためです。「再試行」オプションを使用して一括リカバリを実行する例としては、社会保障番号は適切であるが、信用格付けサービスを提供するシステムが一時的に使用不可になったために、コンポジット参照のフォルトが発生した場合などがあります。この場合は、メッセージが配信されません。信用格付けサービスが再度使用可能になったときに、「再試行」を選択すると、コンポジット参照を介した信用格付けサービスの起動が再試行されます。

BPELプロセスに対して一括フォルト・リカバリを実行する手順は、次のとおりです。

1. 第8.4.1.1項「例: BPELプロセスに対する単一フォルト・リカバリ」の手順1および手順2を実行します。

2. 検索ユーティリティで、判明しているフォルト・パラメータ(時間の範囲、コンポジット名、コンポーネント・タイプ(BPELプロセス)など)に基づいて基準を入力します。

3. 検索結果が多数返される場合は、「リカバリ可能なフォルトのみ表示」チェック・ボックスを選択して表示を制限します。

4. 「選択」リストから「すべてのリカバリ可能な値を選択」を選択します。

5. 「リカバリ・アクション」リストから「中断」を選択します。
選択したすべてのフォルトを手動で停止します。

8.4.2 BPMNプロセスに対するフォルト・リカバリの例

この項では、BPMNプロセスのフォルトに対して管理者操作を可能にするフォルト・ポリシーを定義し、BPMNプロセス・サービス・コンポーネントで単一フォルト・リカバリおよび一括フォルト・リカバリを実行する方法の例を示します。

注意:

複数インスタンス・プロセスがその完了の条件を満たした場合は、(残りのインスタンスを取り消すために)リカバリできないシステム・フォルトが発生します。このフォルトはOracle Enterprise Manager Fusion Middleware Controlに表示されますが、アクションを実行する必要はありません。条件が完了したため複数インスタンス・プロセスが確定したことを通知するために表示されます。

- 第8.4.2.1項「例: BPMNプロセスに対する単一フォルト・リカバリ」

- 第8.4.2.2項「例: BPMNプロセスに対する一括フォルト・リカバリ」

この例では、管理者操作によってフォルトを手動でリカバリするフォルト・ポリシーを定義します。無効な社会保障番号が、融資ブローカBPMNプロセスから信用格付けサービスに発行されると、信用格付けサービスはネガティブ情報フォルトを返します。この例の管理者操作によるアクションは、fault-policies.xmlファイルのora-human-interventionアクションで定義します。フォルト・ポリシーが定義されていない場合、BPMNインスタンスではリカバリ可能なフォルトを生成しません(フォルトはリカバリ不可になります)。この場合は、ora-human-interventionアクションを使用してフォルトをリカバリ可能にします。例8-4は、フォルト・ポリシー・ファイルを示しています。

例8-4 フォルト・ポリシー・ファイル

<faultPolicies xmlns="http://schemas.oracle.com/bpmn/faultpolicy">
<faultPolicy version="2.0.1"
id="CRM_ServiceFaults"
xmlns:env="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns="http://schemas.oracle.com/bpmn/faultpolicy"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Conditions>
<faultName xmlns:credit="http://services.otn.com"
name="credit:NegativeCredit">
<!-- get this fault when SSN starts with 0-->
<condition>
<test>$fault.payload="Bankruptcy Report"</test>
<action ref="ora-human-intervention"/>
</condition>
</faultName>
</Conditions>
</faultPolicy>
</faultPolicies>

例8-5に示されるfault-bindings.xmlファイルは、fault-policies.xmlファイルで定義されたフォルト・ポリシーをCRM_ServiceFaultsコンポジットと関連付けます。

例8-5 フォルト・ポリシー・バインディング・ファイル

<faultPolicyBindings version="2.0.1"
xmlns="http://schemas.oracle.com/bpmn/faultpolicy"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<composite faultPolicy="CRM_ServiceFaults"/>
</faultPolicyBindings>

管理者操作はアクションとして定義されているため、BPMNプロセスに対するフォルト・リカバリはOracle Enterprise Manager Fusion Middleware Controlで実行します。

fault-policies.xmlファイルおよびfault-bindings.xmlファイルの作成と設計の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

8.4.2.1 例: BPMNプロセスに対する単一フォルト・リカバリ

この例の前提は次のとおりです。

- インスタンスが、第8.1項「SOAコンポジット・アプリケーションのテスト・インスタンスの起動」で示した「Webサービスのテスト」ページで起動されました。

- 0で始まる無効な社会保障番号が入力されました。

BPMNプロセスに対して単一フォルト・リカバリを実行する手順は、次のとおりです。

1. 「SOAインフラストラクチャ」メニューから、「ホーム」を選択します。

2. 「フォルト・メッセージと拒否メッセージ」タブをクリックします。

3. フォルト表で、リカバリ可能として識別されたフォルトを検索します。検索ユーティリティを使用して、特定のフォルトを検索できます。

4. 「リカバリ」列で、「リカバリ」をクリックします。最初にフォルトの詳細を表示する場合は、エラー・メッセージをクリックします。次に、「ここでリカバリ」をクリックします。
BPMNプロセス・インスタンスの「フォルト」ページが表示されます。

5. 「リカバリ」列で、「リカバリ可能」をクリックします。
ページがリフレッシュされ、ページの下部にフォルト・リカバリ・セクションが表示されます。

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

7. 「再試行成功時のチェーン・アクション」リストから「なし」を選択します。このリストでは、Javaコールアウト・リカバリ・アクションを選択できます。詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

8. 「変数」リストから変数を選択します。この変数の内容が「値」フィールドに表示されます。この例では、変数crInputが選択されています。この変数は、invokeアクティビティで使用され、不適切な社会保障番号の値を含んでいます。

9. 「値」フィールドに適切な値を入力します。この例では、社会保障番号を1で始まるように編集します。

<ssn xmlns="http://service.otn.com">123456789</ssn>

10. 「設定値」をクリックし、プロンプトが表示されたら「はい」をクリックして続行します。

11. 「リカバリ」をクリックしてフォルトをリカバリし、プロンプトが表示されたら「はい」をクリックして続行します。
ページがリフレッシュされ、フォルトが発生していないことが示されます。

8.4.2.2 例: BPMNプロセスに対する一括フォルト・リカバリ

社会保障番号の例の場合、「再試行」の選択は、一括リカバリを実行するためのオプションではありません。これは、社会保障番号の値が不適切で、修正が必要になるためです。「再試行」オプションを使用して一括リカバリを実行する例としては、社会保障番号は適切であるが、信用格付けサービスを提供するシステムが一時的に使用不可になったために、コンポジット参照のフォルトが発生した場合などがあります。この場合は、メッセージが配信されません。信用格付けサービスが再度使用可能になったときに、「再試行」を選択すると、コンポジット参照を介した信用格付けサービスの起動が再試行されます。

BPMNプロセスに対して一括フォルト・リカバリを実行する手順は、次のとおりです。

1. 第8.4.2.1項「例: BPMNプロセスに対する単一フォルト・リカバリ」の手順1から2を実行します。

2. 検索ユーティリティで、判明しているフォルト・パラメータ(時間の範囲、コンポジット名、コンポーネント・タイプ(BPMNプロセス)など)に基づいて基準を入力します。

3. 検索結果が多数返される場合は、「リカバリ可能なフォルトのみ表示」チェック・ボックスを選択して表示を制限します。

4. 「選択」リストから「すべてのリカバリ可能な値を選択」を選択します。

5. 「リカバリ・アクション」リストから「中断」を選択します。
選択したすべてのフォルトを手動で停止します。

8.4.3 Oracle Mediatorに対するフォルト・リカバリの例

この項では、Oracle Mediatorサービス・コンポーネントで単一および一括フォルト・リカバリを実行する方法の例を示します。

- 第8.4.3.1項「例: Oracle Mediatorに対する単一フォルト・リカバリ」

- 第8.4.3.2項「例: Oracle Mediatorに対する一括フォルト・リカバリ」

この例では、インバウンドSiebelアダプタのサービス・バインディング・コンポーネントによって、変換のためにOracle Mediatorにペイロード・メッセージが発行されます。次に、処理されたペイロード・メッセージが、アウトバウンド・ファイル・アダプタの参照バインディング・コンポーネントに配信されます。ただし、ペイロード・メッセージの書込み先のアウトバウンド・ディレクトリが、書込み権限で構成されていません。この結果、フォルトが発生します。設計時に定義されたフォルト・ポリシーでは、フォルトは管理者操作によって手動でリカバリされることが指定されています。retryCount属性の定義に従って、再試行は3回行われます。条件およびアクションは、fault-policies.xmlファイルで次のように定義されています。

Oracle Mediatorのリカバリ可能なフォルトに対して、フォルト・ポリシーは必要ありません(ただし、ora-human-interventionアクションで説明したように、フォルト・ポリシーはフォルトをリカバリ可能にする1つの方法です)。また、アウトバウンド・エンドポイントからリモート・フォルトを受信するパラレル・ルーティング・ルールによっても、リカバリ可能なフォルトが作成されます(この例では、Oracle Mediatorがパラレル・ルーティング・ルールを使用してアウトバウンド・ファイル・アダプタを起動する場合、フォルト・ポリシーは必要ありません)。例8-6は、フォルト・ポリシー・ファイルを示しています。

例8-6 フォルト・ポリシー・ファイル

<faultPolicies xmlns="http://schemas.oracle.com/bpel/faultpolicy">
<faultPolicy version="2.0.1"
id="ConnectionFaults"
xmlns:env="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns="http://schemas.oracle.com/bpel/faultpolicy"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Conditions>
<faultName xmlns:medns="http://schemas.oracle.com/mediator/faults"
name="medns:mediatorFault">
<condition>
<test>contains($fault.mediatorErrorCode, "TYPE_FATAL_
MESH")</test>
<action ref="ora-retry"/>
</condition>
</faultName>
</Conditions>
. . .
. . .      <Action id="ora-retry">
<retry>
<retryCount>3</retryCount>
<retryInterval>5</retryInterval>
<retryFailureAction ref="ora-human-intervention"/>
<retrySuccessAction ref="ora-terminate"/>
</retry>
</Action>
</Actions>
</faultPolicy>
</faultPolicies>

終了するまでに、処理が3回再試行されるように設定されています。

例8-7に示されるように、フォルト・ポリシーは、fault-bindings.xmlファイルでConnectionFaultsコンポジット・アプリケーションと関連付けられています。

例8-7 フォルト・ポリシー・バインディング・ファイル

<faultPolicyBindings version="2.0.1" xmlns="http://schemas.oracle.com/bpel/fault
policy" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<composite faultPolicy="ConnectionFaults"/>
</faultPolicyBindings>

8.4.3.1 例: Oracle Mediatorに対する単一フォルト・リカバリ

この例では、sap出力ディレクトリが読取り専用に設定されています。インバウンド・ファイル・アダプタはsiebelディレクトリからsender.xmlファイルを取得し、ファイルをsapディレクトリに格納するために、メッセージがOracle Mediatorを介してアウトバウンド・ファイル・アダプタ参照にルーティングされます。

Oracle Mediatorに対して単一フォルト・リカバリを実行する手順は、次のとおりです。

1. オペレーティング・システムのコマンド・プロンプトで、ディレクトリの権限を変更します。

chmod 000 sap
cp sender.xml siebel/

2. 「SOAインフラストラクチャ」メニューから、「ホーム」を選択します。

3. 「フォルト・メッセージと拒否メッセージ」タブをクリックします。
3回の再試行の結果、3つのフォルトが表示されます。この場合、再試行は3回のみです。これは、アウトバウンド・ファイル・アダプタとOracle Mediatorの相互作用に関するフォルト・ポリシーで、再試行が3回と定義されているためです。フォルト・ポリシーがない場合、フォルトは1つのみです(自動的な再試行はありません)。

4. 「コンポジット・インスタンスID」列で、特定のインスタンスIDをクリックします。

「フローのトレース」が表示されます。ページの上部にあるフォルト表には、フォルト・メッセージが表示されます。フォルトが発生したOracle Mediatorインスタンスの位置を全体のメッセージ・フロー内で確認するには、フォルト表でフォルトを選択します。選択すると、トレース表内の関連するインスタンスが強調表示されます。次に、インスタンスをクリックしてその監査証跡にアクセスすると、失敗したフローの詳細を確認できます。

注意:

ステップ4から10は、単一フォルトをリカバリする方法の1例を説明しています。フォルトは、Oracle Mediatorの「フォルト」ページで「リカバリ・アクション」リストから直接リカバリすることもできます。

5. 「フォルト」表で、リカバリするOracle Mediatorコンポーネント・インスタンスのフォルトを検索し、「リカバリ」列で「リカバリ」をクリックします。

6. 「ペイロード・パート」リストから、「送信者」を選択します。
「ペイロード」フィールドに、ペイロードが自動的に表示されます。必要な場合は、このフィールドでペイロードの変更を実行できます。この例では、ペイロードの変更は必要ありません。

7. オペレーティング・システムのコマンド・プロンプトで、sapディレクトリを書込み可能に変更します。

chmod 777 sap

8. 「フォルト」タブに戻り、ページの右上隅にある「リフレッシュ」アイコンをクリックします。

9. 「再試行」をクリックします。

10. プロンプトが表示されたら「はい」をクリックして、選択したフォルトをリカバリのために再発行します。

ページがリフレッシュされ、フォルトが発生していないことが示されます。

11. 「監査証跡」タブをクリックします。
最終メッセージで、手動リカバリが成功し、メッセージ・ペイロードがsapディレクトリに書き込まれたことが示されます。

8.4.3.2 例: Oracle Mediatorに対する一括フォルト・リカバリ

この例でも、sender.xmlペイロード・メッセージの書込み先のsapディレクトリが、読取り専用権限でオペレーティング・システムのコマンド・プロンプトで構成されているとします。sender.xmlファイルの3つのコピーが、インバウンドSiebelアダプタのサービス・バインディング・コンポーネントのsiebelディレクトリにあります。この結果、3つのインスタンスが作成されます。

chmod 000 sap
cp sender.xml siebel/
cp sender.xml siebel/
cp sender.xml siebel/

Oracle Mediatorに対して一括フォルト・リカバリを実行する手順は、次のとおりです。

1. sapディレクトリを書込み可能に変更します。

2. 「SOAインフラストラクチャ」メニューから、「ホーム」を選択します。

3. 「フォルト・メッセージと拒否メッセージ」タブをクリックします。

4. 検索ユーティリティで、判明しているフォルト・パラメータ(時間の範囲、コンポジット名など)に基づいて基準を入力します。

5. 検索結果が多数返される場合は、「リカバリ可能なフォルトのみ表示」チェック・ボックスを選択して表示を制限します。

6. オペレーティング・システムのコマンド・プロンプトで、sapディレクトリを書込み可能に変更します。

chmod 777 sap

7. リカバリするすべてのフォルトを選択します。

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

9. プロンプトが表示されたら「はい」を選択して、フォルト・リカバリを実行します。

10. 「監査証跡」タブをクリックします。
最終メッセージで、手動リカバリが成功し、メッセージ・ペイロードがsapディレクトリに正常に書き込まれたことが示されます。

8.5 アプリケーションのホーム・ページでの、SOAコンポジット・アプリケーションのフォルトのリカバリ

SOAコンポジット・アプリケーションでは、単一および一括のフォルト・リカバリの監視および実行ができます。リカバリ可能として識別されたBPELプロセス・フォルトについては、(fault-bindings.xmlファイルを介して)フォルトにバインドされ、アクションora-human-interventionをトリガーするフォルト・ポリシーが定義されている必要があります。ただし、フォルト・ポリシーが定義されていない場合、フォルトは、リカバリ可能またはリカバリ不可のフォルトとして通常どおり処理されます。ヒューマン・ワークフローのフォルトもリカバリできますが、Oracle Enterprise Manager Fusion Middleware Controlからは直接リカバリできません。かわりに、監査証跡にOracle BPM Worklistへのリンクが表示され、このリンクからフォルトを処理できます。

アプリケーションのホーム・ページでSOAコンポジット・アプリケーション・フォルトをリカバリする手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」を選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にあるパーティションを展開します。

2. 特定のSOAコンポジット・アプリケーションを選択します。

2. 「フォルト・メッセージと拒否メッセージ」タブをクリックします。
「フォルト・メッセージと拒否メッセージ」ページに、選択したSOAコンポジット・アプリケーションに関する次の詳細が表示されます。

- 特定のフォルトを検索するためのユーティリティ。基準を指定して「検索」をクリックします。詳細は、「ヘルプ」アイコンをクリックしてください。デフォルトでは、このページに初めてアクセスしたときにはフォルトは表示されません。フォルトを表示するには、「検索」をクリックする必要があります。

- インスタンス・リカバリ・アクション(再試行、中断、リプレイなど)、拒否メッセージの削除および一括メッセージ・リカバリの実行を選択するオプション。

- SOAコンポジット・アプリケーション・インスタンスのフォルト・メッセージと拒否メッセージ。エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、フォルト・メッセージが拒否されたメッセージとして分類されているかどうか(その場合はチェックマークが表示されます)、フォルトの場所、コンポジット・インスタンスID、およびフォルトが記述されているログ・ファイルへのリンクが表示されます。

注意:

ヒューマン・ワークフローのフォルトはデハイドレーション・ストアに保持されないため、ヒューマン・ワークフローのエラー・メッセージは「エラー・メッセージの内容」フィールドに詳細を入力しても検索できません。

リカバリ可能として識別されたフォルトはリカバリできます。

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

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

アクション

説明

アクションの対象

再試行

インスタンスを直接再試行します。このリカバリ・アクションを使用するシナリオ例は、ネットワーク・エラーのためにサービス・プロバイダにアクセスできないことが原因でフォルトが発生した場合の例です。ネットワーク・エラーは現在解決しています。

BPELプロセスとOracle Mediator

中断

インスタンス全体を終了します。

BPELプロセスとOracle Mediator

リプレイ

フォルトが発生したスコープ全体を再度リプレイします。

BPELプロセス

再スロー

現在のフォルトを再スローします。フォルトの処理に、BPELフォルト・ハンドラ(catchブランチ)が使用されます。デフォルトでは、再スロー・フォルト・ポリシーが明示的に指定されていない場合、すべての例外がフォルト管理フレームワークによって捕捉されます。

BPELプロセス

続行

フォルトを無視して処理を続行します(フォルト・アクティビティには成功のマークが付けられます)。

BPELプロセス

注意:

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

5. 現在のSOAコンポジット・アプリケーションの拒否メッセージを削除する場合は、第8.7項「アプリケーションのホーム・ページからの拒否メッセージの削除」を参照してください。

6. メッセージの一括リカバリを実行する場合は、「オプションを指定してリカバリ」をクリックします。
現在のコンポジットのBPELメッセージとOracle Mediatorメッセージをデータベースから直接リカバリする基準を指定する「オプションを指定してリカバリ」ダイアログが表示されます。ヒューマン・ワークフロー・メッセージは、Oracle BPM Worklistから手動でリカバリできます。ビジネス・イベントとビジネス・ルール・メッセージはリカバリできません。

7. 条件を指定します。許可されるリカバリ・アクションは、「再試行」と「中断」のみです。

注意:

SOAコンポジット・アプリケーション・レベルの一括フォルト・リカバリでは、コンポジットの状態のチェックが実行されます。コンポジットの状態がオフに設定されている場合は、リカバリを実行できないことを警告するメッセージが表示されます。

なんらかの理由(たとえば、サポートされていないサービス・エンジンやリカバリできないフォルトなど)でリカバリ中にフォルトがスキップされた場合は通知されません。

8. 「リカバリ」をクリックします。メッセージの数に応じて、リカバリにかかる時間は異なります。

9. 「フォルト」表内から次の追加監視タスクを実行します。

1. 「ビュー」リストから、「列」→「フォルトID」の順に選択し、各エラー・メッセージのフォルトIDを表示します。フォルトIDは自動的に生成され、フォルトを一意に識別します。フォルトIDは、エラー・メッセージをクリックしたときも表示されます。

2. 「フォルトの場所」列で、特定の場所をクリックし、フォルトの場所に関するフォルト・ページにアクセスします。フォルトの場所は、サービス、コンポーネントまたは参照です。

3. 「コンポーネント・インスタンスID」列で、特定のサービス・コンポーネントIDをクリックし、インスタンスに関するタスク詳細(たとえば、タスクの現在の状態)にアクセスします。拒否メッセージにはコンポーネント・インスタンスIDがありません。

4. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

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

- 第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」

- 第1.4.3.1項「フォルト・リカバリの概要」

- 第8.4.1項「BPELプロセスに対するフォルト・リカバリの例」

- 第8.4.3項「Oracle Mediatorに対するフォルト・リカバリの例」

8.6 SOAインフラストラクチャ・レベルでの拒否メッセージの削除

SOAインフラストラクチャのすべてのコンポジットの拒否メッセージは、「削除: 拒否メッセージ」ダイアログで基準を指定することによって、データベースから直接削除できます。

SOAインフラストラクチャ・レベルですべてのコンポジットの拒否メッセージを削除する手順は次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

SOAコンポジットのメニューから...

1. 「ホーム」を選択します。

1. 「soa-infra」をクリックします。

1. 「SOAインフラストラクチャ」を選択します。

2. 「フォルト・メッセージと拒否メッセージ」タブをクリックします。
「フォルト・メッセージと拒否メッセージ」ページに、すべてのSOAコンポジット・アプリケーション・フォルトについて、次の詳細が表示されます。

- 特定のフォルトを検索するためのユーティリティ。基準を指定して「検索」をクリックします。詳細は、「ヘルプ」アイコンをクリックしてください。デフォルトでは、このページに初めてアクセスしたときにはフォルトは表示されません。フォルトを表示するには、「検索」をクリックする必要があります。

- インスタンス・リカバリ・アクション(再試行、中断、リプレイなど)、拒否メッセージの削除および一括メッセージ・リカバリの実行を選択するオプション。

- フォルト・メッセージと拒否メッセージ。エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、フォルト・メッセージが拒否されたメッセージとして分類されているかどうか(その場合はチェックマークが表示されます)、フォルトが発生したSOAコンポジット・アプリケーション、フォルトの場所、インスタンスID、およびフォルトが記述されているログ・ファイルへのリンクが表示されます。

3. 「拒否メッセージの削除」をクリックします。

注意:

本番環境でコンポジット・インスタンスを削除するには、パージ・スクリプトの実行をお薦めします。パージ・スクリプトはパフォーマンスとスケーラビリティが優れています。「拒否メッセージの削除」オプションは、パージ・スクリプトの対象に含まれない例外の管理のみに使用してください。パージ・スクリプトの詳細は、第10.3項「パージ・スクリプトを使用した大量のインスタンスの削除」を参照してください。

すべてのコンポジットの拒否メッセージをデータベースから直接削除するための基準を指定する「削除: 拒否メッセージ」ダイアログが表示されます。

4. 基準を指定して、「削除」をクリックします。

SOAインフラストラクチャ・レベルでのフォルトのリカバリの詳細は、第8.4項「SOAインフラストラクチャ・レベルでの、SOAコンポジット・アプリケーションのフォルトのリカバリ」を参照してください。

8.7 アプリケーションのホーム・ページからの拒否メッセージの削除

現在のSOAコンポジット・アプリケーションの拒否メッセージは、「削除: 拒否メッセージ」ダイアログで基準を指定することによってデータベースから直接削除できます。

現在のSOAコンポジット・アプリケーションの拒否メッセージを削除する手順は次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」を選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にあるパーティションを展開します。

2. 特定のSOAコンポジット・アプリケーションを選択します。

2. 「フォルト・メッセージと拒否メッセージ」タブをクリックします。
「フォルト・メッセージと拒否メッセージ」ページに、すべてのSOAコンポジット・アプリケーション・フォルトについて、次の詳細が表示されます。

- 特定のフォルトを検索するためのユーティリティ。基準を指定して「検索」をクリックします。詳細は、「ヘルプ」アイコンをクリックしてください。デフォルトでは、このページに初めてアクセスしたときにはフォルトは表示されません。フォルトを表示するには、「検索」をクリックする必要があります。

- インスタンス・リカバリ・アクション(再試行、中断、リプレイなど)、拒否メッセージの削除および一括メッセージ・リカバリの実行を選択するオプション。

- フォルト・メッセージと拒否メッセージ。エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、フォルト・メッセージが拒否されたメッセージとして分類されているかどうか(その場合はチェックマークが表示されます)、フォルトが発生したSOAコンポジット・アプリケーション、フォルトの場所、インスタンスID、およびフォルトが記述されているログ・ファイルへのリンクが表示されます。

3. 「拒否メッセージの削除」をクリックします。

注意:

本番環境でコンポジット・インスタンスを削除するには、パージ・スクリプトの実行をお薦めします。パージ・スクリプトはパフォーマンスとスケーラビリティが優れています。「拒否メッセージの削除」オプションは、パージ・スクリプトの対象に含まれない例外の管理のみに使用してください。パージ・スクリプトの詳細は、第10.3項「パージ・スクリプトを使用した大量のインスタンスの削除」を参照してください。

現在のコンポジットの拒否メッセージをデータベースから直接削除するための基準を指定する「削除: 拒否メッセージ」ダイアログが表示されます。

4. 基準を指定して、「削除」をクリックします。

SOAコンポジット・アプリケーションのホーム・ページでのフォルトのリカバリの詳細は、第8.5項「アプリケーションのホーム・ページでの、SOAコンポジット・アプリケーションのフォルトのリカバリ」を参照してください。

8.8 複数のSOAコンポジット・アプリケーション・リビジョン間でのインスタンスの移行

実行中のSOAコンポジット・アプリケーション・インスタンスは、コンポジットのあるリビジョンから別のリビジョンに移行できます(たとえば、デプロイ済のCreditRatingServiceリビジョン1.0コンポジットのCreditRatingServiceリビジョン2.0コンポジットへの移行)。このアクションは、元のリビジョンに影響を及ぼすことなく、インスタンスを移行し、両リビジョンのインスタンスのサイドバイサイドでの実行を可能にします。移行されたインスタンスは、SOAコンポジット・アプリケーションのターゲット・リビジョンで表示されます。SOAコンポジット・アプリケーション・インスタンスのサービス・コンポーネント・インスタンスもすべて移行されます。

インスタンス移行には次のような理由があります。

- プロセスの初期リビジョンで設計または実装エラーが発見されたり、外部サービスから提供される無効データがプロセスの状態を不良にする可能性がある。

- プロセスの完了までの所要時間が長すぎる。たとえば、月単位または年単位で実行するインスタンスがあるとします。これが原因で次のようになります。

- インスタンスの進行中に変更を適用する必要が生じることがあります。

- 事前には変更が不明のため、常にルールまたは短期間のサブプロセスとしてモデル化できるとはかぎりません。

- 規制またはポリシーの変更(新規ポリシーまたは変更ポリシーの強制の適用)により、すべてのプロセスにステップを追加することが必要になります。

インスタンスの移行には次の制限が適用されます。

- 双方のコンポジット・リビジョンをデプロイする必要があります。

- 実行中のインスタンスのみ移行が可能です。フォルト状態でも移行が成功するOracle Mediatorを除き、完了、中断、フォルトのインスタンスは移行できません。

- 互換性のあるインスタンスのみ、正常に移行できます。互換性は、コンポジット内の関連サービス・コンポーネントの互換性に依存します。重要な変更は移行できません。

- コンポジット・インスタンスごとにトランザクション境界が存在します。一般に、特定のコンポジットに関連するインスタンスはバッチで操作されます。コンポジット・インスタンスのそれぞれは、単一トランザクションにバインドされます。バッチ全体が失敗していなくても、1つ以上のコンポジット・インスタンスの移行が失敗する場合があります。

次の2つの移行方法がサポートされます。

- 自動移行: リビジョン間の変更が些少の場合。コンポジット・インスタンスのそれぞれは、単一トランザクションにバインドされます。コンポジット・インスタンスのバッチを移行できます。

- 移行計画を使用した手動移行(Oracle BPMのみ): リビジョン間で重要な変更がある場合に使用されます。移行計画には、移行の実行方法が記載されます。

8.8.1 移行の互換性

コンポジット移行の互換性は、アプリケーション内で定義されているサービス・コンポーネントに依存します。サービス・コンポーネントに対する変更に互換性がない場合は、そのインスタンス全体が移行に不適格になります。SOAコンポジット・アプリケーション・インスタンスは、関連するサービス・コンポーネント・インスタンスが移行可能な場合のみ移行されます。

次のサービス・コンポーネントは移行できます。

- 非永続的BPELプロセス

- Oracle Mediator

- ヒューマン・ワークフロー

- ビジネス・ルール

- Oracle BPMN

関与するサービス・エンジンはそれぞれのインスタンスを移行するために調整されます。インスタンス追跡データは、新しいリビジョンに移行されます。

表8-1は、各サービス・コンポーネント・インスタンスが新しいインスタンスにどのように移行されるかを示しています。互換性がない場合は、コンポジット・インスタンスの移行全体が非互換とレポートされ、移行はできません。

表8-1 サービス・コンポーネント・インスタンスの移行の詳細

サービス・コンポーネント

サポートされる移行タイプ

移行制限

BPELプロセス

BPELプロセス・インスタンスの新規リビジョンへの自動移行

- 非永続的BPELプロセスのみがサポートされます(チェックポイントまたはブレークポイントなしのプロセス)。永続的プロセスには、タイマー付きの非同期プロセスや同期プロセス、または完了前にデハイドレーションが行われるアクティビティが含まれます。

- 完了したコンポーネント・インスタンスのみが移行されます。

Oracle Mediator

Oracle Mediatorインスタンスの新規リビジョンへの自動移行

サポートされるメッセージ・パターンは、リクエストのみ、リクエスト-レスポンス、および順次ルーティング・ルールのみです。これは、一方向および同期のOracle Mediatorコンポーネントのみ移行できることを意味します。

ヒューマン・ワークフロー

ヒューマン・ワークフロー・インスタンスの新規リビジョンへの自動移行

実行中および完了したヒューマン・ワークフロー・インスタンスは、実行中のコンポジット・インスタンスの一部であれば移行できます。

ビジネス・ルール

ビジネス・ルールの新規リビジョンへの自動移行(ルール・インスタンスの概念なし)

なし。

Oracle BPM

Oracle BPMインスタンスの新規リビジョンへの手動移行(移行計画を使用)、および自動移行

互換性のないモデル間ではインスタンスを移行できません。互換性のないインスタンスの例には次のものが含まれます。

- サブプロセスの動作の削除または変更

- いずれかのアクティビティのレベルの変更

- ゲートウェイの削除(排他ゲートウェイを除く)

- インタフェースの変更

- いずれかのアクティビティの境界イベントの追加または削除

アクティビティの追加や削除は、移行計画を使用して手動で移行する必要があることを意味します。

注意:

パラレル・ルーティング・ルールのあるOracle Mediatorサービス・コンポーネントおよびOracle BPMNサービス・コンポーネントを含むコンポジット・インスタンスではインスタンスの移行が失敗します。次の値が返されます。

- インスタンス移行の全体に対して、CompositeInstanceMigrationResult.migrated()は値falseを返します。

- Oracle Mediatorサービス・コンポーネントの場合は、ComponentInstanceMigrationResult.migrated()が値falseを返します。

ただし、Oracle BPMNサービス・コンポーネントの場合は、移行が成功しなかった場合でもComponentInstanceMigrationResult.migrated()から値trueを返します。

次の2つのインスタンス移行方法があります。

- Facade APIによるインスタンスの移行

- antスクリプトによるインスタンスの移行

8.8.2 Facade APIによるインスタンスの移行

Facade APIを使用してインスタンスを移行できます。

次の2つの基本APIカテゴリが提供されます。

- 次の情報を提供する移行レポートの生成

- 移行の実行前のコンポジット・インスタンスの一部セットの移行の実行可能性

- 移行するコンポジット・インスタンスの数および実行可能性

- 移行する関連サービス・コンポーネント・インスタンスの数および実行可能性

- インスタンス移行の全体的な実行可能性: 手動移行の必要性、自動移行の必要性、または移行が非互換であるか

- 手動移行の必要性、または移行が非互換である理由

- インスタンス移行の結果の提供

- 移行実行の結果: 移行が成功または失敗したコンポジットおよびサービス・コンポジット・インスタンス

- 失敗原因

Facade APIでは、同期バージョンと非同期バージョンの両方が提供されます。

Facade APIの詳細は、Oracle Fusion Middleware Infrastructure Management Oracle SOA Suite Java APIリファレンスおよび第11章「Facade APIを使用したSOAコンポジット・アプリケーションのプログラムによる管理」を参照してください。

8.8.2.1 一括移行の評価

例8-8は、コンポジット・インスタンス・移行サマリーを取得するFaçade APIを示しています。このサマリーは、指定されたフィルタ基準と一致するコンポジット・インスタンスの移行の可能性を示します。

例8-8 一括移行の評価

/**
* Synchronously generates a migration report. The results would be limited to some
* fixed number of composite instances to avoid EJB time-outs.
* We should probably provide a way for the client to specify an even smaller
* maximum number of instances.
*
* @param filter - The composite instance selection criteria
* @param targetRevision - The revision to which the composite instances should be
* migrated
*
* @return A MigrationReport
*/
MigrationReport generateMigrationReport(CompositeInstanceFilter filter, String
targetRevision);
/**
* Asynchronously generates a migration report. There is no limit on the number of
* composite instances included in the result.
*
* @param filter - The composite instance selection criteria
* @param targetRevision - The revision to which the composite instances should be
* migrated
* @return A unique report identifier, which can be used to subsequently retrieve
* the report.
*/
String initiateMigrationReport(CompositeInstanceFilter filter, String
targetRevision);
/**
* Retrieves an asynchronously-generated migration report.
*
* @param reportId - A unique report identifier; the result of the
* initiateMigrationReport method.
*
* @return The MigrationReport for the specified report identifier
*/
MigrationReport getMigrationReport(String reportId);

このレポートに含まれる情報は次のとおりです。

コンポジット・インスタンスの詳細:

- コンポジット・インスタンス名

- コンポーネント・インスタンスID

- コンポーネント・インスタンスの状態

- 移行ステータス: 自動か、移行計画が必要か(また、該当する場合は必要な変更計画)

- コンポーネント・インスタンス・データの詳細:

サマリー・データ:

- ターゲットのリビジョン

- 一致するコンポジット・インスタンスの合計数

- 自動的に移行可能なコンポジット・インスタンスの数

- 自動的に移行不可能なコンポジット・インスタンスの数

- 結果が切り捨てられた場合は、その事実を示す記載が必要

8.8.2.2 移行レポート

移行レポートは、コンポジット・インスタンスの移行の実現可能性が記載されます。例8-9に詳細を示します。

例8-9 移行レポート

package oracle.soa.management.facade;

public interface MigrationReport {
/**
* @return The detailed migration feasibility description
*/
MigrationFeasibility getFeasibility();
/**
* @return The revision to which the composite(s) will be migrated.
*/
String getTargetRevision();
/**
* @return The number of composite instances matching the criteria for which
* this report was generated.
*/
long getCompositeInstanceCount();
/**
* @return The composite instances matching the criteria for which this
* report was generated.
*/
List<CompositeInstanceMigrationReport> getCompositeInstances();

8.8.2.3 移行の一括実行

Façade APIは、インスタンス(構成可能なバッチ・サイズ)を移行します。例8-10に詳細を示します。

例8-10 移行の一括実行

/**
* Asynchronously attempt to migrate the composite instances described in the
* specified migration report.
* @param report - A MigrationReport, describing which composite instances should
* be migrated.
* @param plan - A MigrationPlan, specifying how those instances that cannot be
* automatically migrated should be handled.
*
* @return A unique migration result identifier, which can be used to subsequently
retrieve the migration result.
*/
String migrateCompositeInstances(MigrationReport report, MigrationPlan plan).
/**
* Retrieves the migration result for the specified migration attempt.
*
* @param resultId - The unique identifier for a particular migration attempt; the
* result of invoking migrateCompositeInstances
* @return A MigrationResult, describing the results of the migration attempt.
*/
MigrationResult getMigrationResult(String resultId);
/**
* Synchronously attempts to migrate those composite instances that match the
* specified filter criteria
* to the specified target revision, applying the specified migration plan.
*
* The number of composite instances for which migration is attempted will be
* limited to some fixed number,
* unless a lesser maximum is otherwise specified. (TBD, can this be specified via
* the filter?)
*
* @param filter - The composite instance selection criteria
* @param targetRevision - The revision to which the composite instances should be
* migrated
* @param plan - The plan for handling those composites that cannot be
* automatically migrated
*
* @return A MigrationResult, describing the results of the migration attempt.
*/
MigrationResult migrateCompositeInstances(CompositeInstanceFilter filter, String
targetRevision,MigrationPlan plan);

8.8.2.4 移行の結果

MigrationResultインタフェースは、コンポジット・インスタンスの移行の実行結果を記述します。例8-11に詳細を示します。

例8-11 移行の結果

package oracle.soa.management.facade;
public interface MigrationResult extends Serializable {
/**
* @return The revision to which the composite instances were to be migrated.
*/
String getTargetRevision();
/**
* @return The total number of composite instances included in the migration
* attempt.
*/
long getCompositeCount();
/**
* @return The number of composite instances for which migration succeeded.
*/
long getMigratedCount();
/**
* @return The number of composite instances for which migration failed.
*/
long getFailedCount();
/**
* @return The list of composite instances that were successfully migrated.
*/
List<CompositeInstanceMigrationResult> getMigratedInstances();
/**
* @return The list of composite instances for which migration failed.
*/
List<CompositeInstanceMigrationResult> getFailedInstances();
}

8.8.2.5 移行計画

MigrationPlanインタフェースは、重要なコンポジットまたはコンポーネントの変更をどのように処理するかに関するXMLの記述を提供します。例8-12に詳細を示します。

例8-12 移行計画

public interface MigrationPlan extends Serializable {
/**
* @param componentDN A component distinguished name (less any label)
*
* @return The migration plan element for the specified componentDN
*/
org.w3c.dom.Element getComponentPlan(String componentDN);
/**
* @return The migration plan for the composite instances
*/
org.w3c.dom.Element getCompositePlan();
}

8.8.2.6 移行API

CompositeInstance Facadeタイプには、単一コンポジット・インスタンスの移行をサポートするメソッドが含まれています。一括操作は、個別のコンポジット・インスタンスでメソッドを起動するLocatorインタフェースから直接使用できます。例8-13に詳細を示します。

例8-13 移行API

CompositeInstanceMigrationReport checkCompatibility(String revision);
/**
* Calls suspend on all the associated component instances
* Calls migrate for those same component instances
* Calls resume on all those same component instances
* The migration plan may contain component-specific directives.
*/
CompositeInstanceMigrationResult migrate(MigrationPlan plan);
public interface CompositeInstanceMigrationReport extends Serializable {
String getPartition();
String getCompositeName();
String getCompositeId();
String getRevision();
String getTargetRevision();
MigrationFeasibility getFeasibility();
long getComponentInstanceCount();
List<ComponentInstanceMigrationReport> getComponentInstances();
String getIncompatibilityReason();
}
public interface ComponentInstanceMigrationReport extends Serializable {
String getComponentName();
String getComponentId();
MigrationFeasibility getMigrationFeasibility();
String getIncompatibilityReason();
}
public class MigrationFeasibility implements Serializable {
public static MigrationFeasibility Automatic;
public static MigrationFeasibility MigrationPlanRequired;
public static MigrationFeasibility Incompatible;
public boolean isAutomatic();
public boolean isMigrationPlanRequired();
public boolean isIncompatible();
}
public interface CompositeInstanceMigrationResult extends Serializable {
/**
* @return true, if the composite instance and all its components were
* successfully migrated; otherwise, false.
*/
boolean migrated();
/**
*
* @return The name of the partition to which the composite is deployed
*/
String getPartition();
/**
* @return The composite name
*/
String getName();
/**
* @return The composite instance identifier
*/
String getId();
/**
* @return The previous revision
*/
String getRevision();
/**
* @return The revision to which the instance was to be migrated
*/
String getTargetRevision();
/**
* @return The migration results for the associated component instances
*/
List<ComponentInstanceMigrationResult> getComponentInstances();
/**
* @return The reason why the migration failed, if it failed; otherwise, null
*/
String getFailureReason();
}
public interface ComponentInstanceMigrationResult extends Serializable {
/**
* @return true, if the component instance was successfully migrated; otherwise,
* false.
*/
boolean migrated();
/**
* @return The component name
*/
String getName();
/**
* @return The component instance identifier
*/
String getId();
/**
* @return The reason why the migration failed, if it failed; otherwise, null
*/
String getFailureReason();
}

8.8.2.6.1 移行が失敗したコンポーネントのリストの取得

移行が失敗した場合は、例8-14に示されるJavaコードを使用して失敗したコンポーネントのリストを取得します。コンポジット・インスタンスの状態が完了または失敗としてマークされ、コンポジット・インスタンスの別のリビジョンへの移行が失敗している場合、f.getComponentInstances()は、コンポーネント・インスタンスに関する詳細の取得が可能なComponentInstanceMigrationResultオブジェクトのリストを返します。

例8-14 失敗した移行コンポーネントのリストの取得

private static void validateMigrationResult(MigrationResult mr)
{
if (mr != null)
{
List<CompositeInstanceMigrationResult> failed =
mr.getFailedInstances();

for (CompositeInstanceMigrationResult f: failed)
{
List<ComponentInstanceMigrationResult> failedComponents =
f.getComponentInstances();
System.out.println("Failed components list size: " +
failedComponents.size() + " Failed components list: " +
failedComponents);
}
}
}

8.8.3 antスクリプトによるインスタンスの移行

インスタンスは、例8-15に示される$Middleware_Home/SOA_Suite_Home/bin/ant-bpm-migration.xmlスクリプトを使用して移行できます。

例8-15 ant-bpm-migration.xmlスクリプト

<?xml version="1.0" encoding="iso-8859-1"?>
<project name="ant-migration" basedir=".">
<property environment="env"/>
<property name="name" value="${ant.project.name}"/>
<dirname property="imported.basedir" file="${ant.file.ant-migration}"/>
<property name="mw.ora.home" location="${imported.basedir}/.."/>
<property name="mw.home" location="${imported.basedir}/../.."/>
<!--
<path id="ant-extensions.classpath">
<pathelement
path="${bpm.home}/generated/lib/oracle.bpm.runtime.public-tools.jar"/>
<pathelement path="${bpm.home}/../pcbpel/fabric/lib/soa-infra-mgmt.jar"/>
<pathelement path="${bpm.home}/../pcbpel/fabric/lib/fabric-common.jar"/>
<pathelement path="${bpm.home}/../pcbpel/fabric/lib/xmlparserv2.jar"/>
<pathelement path="${bpm.home}/main/libraries/batik-1.7/lib/xerces_2_5_
0.jar"/>        <pathelement
path="${bpm.home}/../pcbpel/fabric/lib/fabric-runtime.jar"/>
<pathelement path="${bpm.home}/tools/lib/apb-ext/wlfullclient.jar"/>
<pathelement path="${bpm.home}/../pcbpel/generated/jrf/wsclient_
extended.jar"/>
</path>
-->
<path id="ant-extensions.classpath">
<pathelement
path="${mw.ora.home}/soa/modules/oracle.bpm.runtime.public-tools.jar"/>
<pathelement path="${mw.home}/oracle_common/soa/modules/oracle.soa.mgmt_
11.1.1/soa-infra-mgmt.jar"/>
<pathelement path="${mw.home}/oracle_common/modules/oracle.fabriccommon_
11.1.1/fabric-common.jar"/>
<pathelement path="${mw.home}/oracle_common/modules/oracle.xdk_
11.1.0/xmlparserv2.jar"/>
<pathelement path="${mw.ora.home}/soa/modules/oracle.soa.fabric_
11.1.1/fabric-runtime.jar"/>
<pathelement path="${mw.home}/wlserver_10.3/server/lib/wlfullclient.jar"/>
<pathelement path="${mw.home}/oracle_common/webservices/wsclient_
extended.jar"/>
</path>
<!--
================================================================== -->
<typedef name="locatorConfig"
classname="oracle.bpmn.engine.tools.pub.migration.LocatorConfig"
loaderRef="soa-infra-tools-loader">
<classpath refid="ant-extensions.classpath"/>
</typedef>
<taskdef name="locatorSession"
classname="oracle.bpmn.engine.tools.pub.migration.LocatorSession"
loaderRef="soa-infra-tools-loader">
<classpath refid="ant-extensions.classpath"/>
</taskdef>
<typedef name="compositeInstanceFilterDef"
classname="oracle.bpmn.engine.tools.pub.migration.CompositeInstanceFilterDef"
loaderRef="soa-infra-tools-loader">
<classpath refid="ant-extensions.classpath"/>
</typedef>
<typedef name="generateMigrationReport"
classname="oracle.bpmn.engine.tools.pub.migration.GenerateMigrationReport"
loaderRef="soa-infra-tools-loader">
<classpath refid="ant-extensions.classpath"/>
</typedef>
<typedef name="migrateCompositeInstances"
classname="oracle.bpmn.engine.tools.pub.migration.MigrateCompositeInstances"
loaderRef="soa-infra-tools-loader">
<classpath refid="ant-extensions.classpath"/>
</typedef>
<!--<taskdef name="secure-input"
classname="oracle.fabric.management.deployedcomposites.ant.TempInputTask">-->
<!--<classpath>-->
<!--<pathelement path="${handler.class.path}"/>-->
<!--</classpath>-->
<!--</taskdef>-->
<!--<target name="...">-->
<!--<secure-input message="Please enter password:"
addproperty="password">-->
<!--<handler
classname="oracle.fabric.management.deployedcomposites.ant.SecureInputHandler">-->
<!--<classpath refid="handler.class.path"/>-->
<!--</handler>-->
<!--</secure-input>-->
<!--</target>-->
<!-- -->
<!--
=============================================================-->
<target name="help">
<echo message="res=${myresource}"/>
<echo
message="mw=${mw.ora.home}/soa/modules/oracle.bpm.runtime.public-tools.jar"/>
<echo message="
============================================================================="/>
<echo message="Usage : "/>
<echo message="===================================================================="/>    </target>
</project>

ant-bpm-migration.xmlスクリプトは、$Middleware_Home/wlserver_10.3/server/libディレクトリ内のwlfullclient.jarファイルを必要とします。このクライアント・ライブラリJARは、次のタスクを実行することによって生成できます。

1. 次のディレクトリに変更します。

cd $fmw.home/wlserver_10.3/server/lib

2. 次のコマンドを実行して、クライアント・ライブラリJARを構築します。

java -jar wljarbuilder.jar

8.8.4 Oracle BPMのリビジョン・インスタンス移行の例

ここでは、Oracle BPMを含むReviewProcessコンポジットのリビジョン・インスタンスを移行する例を紹介します。この例ではヒューマン・ワークフローの承認タスクが削除されているため、移行計画が必要になります。

図8-1は、コンポジットのリビジョン1.0のインスタンス・フローを示しています。このコンポジットのリビジョンには、時間を消費するユーザー承認タスクであるVeryExpensiveUserReviewを含め、2つのヒューマン・タスクが存在します。

図8-1 リビジョン1.0のOracle BPMインスタンス・フロー

図8-2は、SOAコンポジット・エディタ内でリビジョン1.0のコンポジットを表示しています。

図8-2 リビジョン1.0のコンポジット・アプリケーション

図8-3は、リビジョン2.0のコンポジット・アプリケーションの改善されたインスタンス・フローを示しています。

時間を消費するVeryExpensiveUserReviewヒューマン承認タスクが削除されています。かわりに、サービス・タスクによる自動確認が使用されています。このサービス・タスクは、確認承認を外部のWebサービスに委譲します。

図8-3 リビジョン2.0のOracle BPMインスタンス・フロー

図8-4は、SOAコンポジット・エディタ内でリビジョン2.0のコンポジット・アプリケーションを表示しています。

図8-4 リビジョン2.0のコンポジット・アプリケーション

移行時は、次のタスクが発生します。

- ReviewProcessの定義が改善された新しい2.0リビジョンがデプロイされます。

- この新しい2.0リビジョンは、古い1.0リビジョンとサイドバイサイドで実行されます。

- 進行中のインスタンスは、必要に応じてリビジョンが移行されます。

Oracle BPMのリビジョン・インスタンスを移行する手順は次のとおりです。

1. 以下を判定する移行実行可能性レポートを生成します。

- 選択したコンポジット・インスタンスの移行が実行可能であるかどうか。

- 移行が自動であるか、移行計画を使用した手動であるか。アクティビティで実行中のインスタンスが削除されるため、移行計画が必要です。

移行計画では以下が指定されます。

- 古いリビジョンのVeryExpensiveUserReviewタスクから新しいコンポーネントのLegacyReviewタスクへのフロー更新。

- 後でLegacyReviewタスク・タイトルで使用される新しい値でのインスタンス・データの更新。

2. 次のタスクが実行される移行計画を作成します。

- データ・オブジェクトの更新。

- インスタンス・タイトル値の更新。

- VeryExpensiveUserReviewタスク・フローのLegacyReviewタスク・フローへの置換。

移行計画は任意のディレクトリの場所に配置できます。移行計画のサンプルは、次のURLで提供されています。

http://java.net/projects/oraclebpmsuite11g/pages/Samples

サンプルを使用することも、XSDに基づいて独自の移行計画を作成することもできます。build.xmlファイルを実行してインスタンスを移行する際に、ファイルへのパスを指定します。

3. 次の2つの方法のいずれかを使用してFacade APIを実行します。

- Facade APIを直接実行します。詳細は、第8.8.2項「Facade APIによるインスタンスの移行」を参照してください。

- antで使用するbuild.xmlファイルを作成します。この例では、antが使用されます。build.xmlファイルは、ディレクトリ構造の任意の場所に配置できます。antを同じディレクトリから実行するか、ant -fを実行し、build.xmlのディレクトリ・パスの場所を指定する必要があります。

<property name="migrationPlanPath" value="${basedir}/migration_plan.xml"/>

locatorConfig id="c1" host="${wls.host}" port=${wls.port}"
user="{wls.user}" password="${wls.password}"/>
compositeInstanceFilterDef id="f1" domainName="default"
compositeName="Project3" compositeInstanceId="40001"/>

<target name="test">
<locatorSession configId="c1">
<generateMigrationReport filterId="f1" revision="2.0">
<migrateReportedCompositeInstances migrationPlanPath=
"${migrationPlanPath}"/>
</generateMigrationReport>
</locatorSession>
</target>

4. SOAコンポジット・アプリケーションのリビジョン1.0のインスタンスを作成します。インスタンスを移行するには、リビジョン1.0と2.0の両方がデプロイされている必要があります。インスタンスの作成の詳細は、第8.1項「SOAコンポジット・アプリケーションのテスト・インスタンスの起動」を参照してください。

5. リビジョン1.0のインスタンスID(この例では40007)をクリックします。

6. ReviewProcessインスタンスをクリックします。

7. 「フロー」タブをクリックします。

フローのリビジョン1.0が表示されます。インスタンスは、2つのインスタンス・タスクのパラレル承認で待機しています。

8. build.xmlファイルの場所に移動します。

9. 移行するcompositeInstanceId値を40007に変更します。

10. 右上隅で、antスクリプトを実行します。

11. antビルド・レポートを表示して、移行が成功したことを確認します。

12. Oracle Enterprise Manager Fusion Middleware Controlの「インスタンス」ページに戻ります。

13. 「リフレッシュ」アイコンをクリックして、古いインスタンスが表示されなくなっていることに注目します。これは、新しいインスタンスに移行されたためです。

14. ナビゲータでリビジョン2.0をクリックします。

15. リビジョンに移行後のインスタンスが表示されていることがわかります。

16. インスタンスをクリックします。

17. 「トレース」表で、ReviewProcessをクリックします。
LegacyReviewヒューマン・ワークフロー・コンポーネントは実行中と表示され、VeryExpensiveUserReviewヒューマン・ワークフロー・コンポーネントは、取消し済として表示されます。

18. 「フロー」タブをクリックします。

19. LegacyReviewのある新しいフローを表示します。

20. Oracle Business Process Workspaceにログインします。

21. 「プロセス・トラッキング」をクリックして、ページをリフレッシュします。

22. バージョンReviewProcess 2.0が実行中であることがわかります。

23. 承認するタスクに移動して、「承認」を選択します。

24. Oracle Enterprise Manager Fusion Middleware Control内のインスタンスに戻ります。

25. 「フロー」タブをクリックします。

26. アクティビティが承認済と表示されていることがわかります。

8.8.5 すべてのサービス・コンポーネントとともにリビジョン・インスタンスを移行する例

この例では、多様なサービス・コンポーネントとともにリビジョンを移行する方法を説明します。

- Oracle Mediator

- BPELプロセス

- ヒューマン・ワークフロー

- ビジネス・ルール

- Oracle BPM

すべてのサービス・コンポーネントとともにリビジョン・インスタンスを移行する手順は次のとおりです。

1. Oracle Enterprise Manager Fusion Middleware Controlの「インスタンス」ページに移動します。この例では、コンポジットのデプロイ済リビジョンが3つ存在します。リビジョン1.0にはインスタンスが1つあります(この例では40005)。

2. インスタンスIDをクリックすると、リビジョンに複数のサービス・コンポーネントがあることがわかります。

3. Facade APIを起動して、次のタスクを実行します。

- リビジョン1.0から2.0へのインスタンスの移行の移行レポートを生成します。

- 実際の移行を実行します。

この例では、単純なJavaServer Page (JSP)インタフェースを使用して、Facade APIを起動します。独自のJSPインタフェースを作成できます。Facade APIの詳細は、第8.8.2項「Facade APIによるインスタンスの移行」を参照してください。

4. 「ターゲット・リビジョン」フィールドに移行するリビジョンを入力します(この例では2.0)。

5. 「発行」をクリックします。
レポートが完了し、次のセクションに表示されます。

- 「移行レポート」セクションは、すべてのサービス・コンポーネントが自動移行できることを示します。

- 移行結果セクションは、すべてのサービス・コンポーネントの移行が成功したことを示します。

6. Oracle Enterprise Manager Fusion Middleware Controlの「インスタンス」ページに戻ります。

7. ページをリフレッシュすると、リビジョン1.0のインスタンスが使用できなくなっていることがわかります。

8. コンポジットのリビジョン2.0をクリックすると、インスタンス4005が実行中であることがわかります。

9. インスタンスIDをクリックすると、すべてのサービス・コンポーネントが移行されたことがわかります。Oracle BPMNサービス・コンポーネントは承認を待っています。

10. Oracle Business Process Workspaceにログインします。

11. 「アクション」リストから、「承認」を選択します。

12. Oracle Enterprise Manager Fusion Middleware Controlのインスタンスに戻ると、サービス・コンポーネント・インスタンスが完了していることがわかります。

8.8.6 互換性のないサービス・コンポーネントを含むリビジョンを移行する例

この例は、BPELプロセスが永続的なwaitアクティビティを使用していることが原因で移行がどのように不可能になるかを示しています。

1. Facade APIを使用して、リビジョン3.0のインスタンスの1.0への移行を試行します。この例でも、第8.8.5項「すべてのサービス・コンポーネントとともにリビジョン・インスタンスを移行する例」で使用されたJSPページを使用します。

2. 「ターゲット・リビジョン」フィールドにリビジョン番号を入力します(この例では1.0)。

3. 「発行」をクリックします。

レポートが完了し、次のセクションに表示されます。

- 「移行レポート」セクションに、サポートされない永続BPELプロセスが原因で、移行に互換性がないことが示されます。

- 移行結果に、その後の移行の試行が失敗したことが示されます。

4. Oracle Enterprise Manager Fusion Middleware Controlの「インスタンス」ページに戻ります。

5. 「リフレッシュ」アイコンをクリックすると、古いインスタンスが新しいインスタンスに移行されていないことがわかります。

9 データベース増分管理戦略の策定

この章では、データベースの最適なプロファイルまたはサイズの決定、領域使用量、ハードウェア・リソースおよびデータベース・パフォーマンスの監視、増分管理の課題およびテスト戦略について、および領域管理についてなど、データベースの増分管理戦略の策定戦略を説明しています。

この章では、次の項目について説明します。

- 第9.1項「データベース増分計画の概要」

- 第9.2項「データベースのプロファイルまたはサイズの確認」

- 第9.3項「領域使用量、ハードウェア・リソース、およびデータベース・パフォーマンスの監視」

- 第9.4項「増分管理の課題およびテスト戦略の理解」

- 第9.5項「領域管理の理解」

パージ・スクリプトおよびコンポーネント表のパーティション化の詳細は、第10章「データベースの増分の管理」を参照してください。

トラブルシューティングの詳細は、第B.2項「パラレル・パージと表のパーティション化の問題」を参照してください。

注意:

この章は、データベース管理者を対象としています。

9.1 データベース増分計画の概要

Oracle SOA Suite 11gのインストールでは、Oracle SOA Suiteデータベースの増分管理など、データベース管理者にかかわる課題がいくつか存在します。データベース管理の重要性を軽視すると、データベースが本番環境に移行したときに問題が発生する可能性があります。この章は、適切な戦略の決定に役立つもので、また、キャパシティ・プランニング、テストおよび監視の必要性に重点を置いています。

推奨される戦略は、Oracle SOA Suiteインストールのプロファイルまたは予測サイズを基準にします。戦略を実装するツールおよび技術はわかりやすく、推奨事項の単純化に役立ちます。ただし、これは設計どおりに実装しなければならない特定のツール・セットを使用するように管理者を制限するものではありません。

増分管理戦略の効率性およびリソース要件の決定には、テストと監視が必要です。テストにより、ツール、データベースおよびハードウェア・リソースのすべてをまとめて、現在および将来のデータベース増分予測のニーズに合致することが保証されます。

9.2 データベースのプロファイルまたはサイズの確認

ここでは、Oracle SOA Suiteデータベースのプロファイルまたはサイズを確認して、最適な増分管理戦略を決定する戦略を説明します。詳細は、第9.4項「増分管理の課題およびテスト戦略の理解」を参照してください。

ディスク領域使用量の概算のためにこの項で詳述する計算は、全体的な領域キャパシティ・プランニングの実施に置き換わるものではありません。ただし、この推定は適切な増分管理戦略の結論の導出には十分ですが、ディスクキャパシティ・プランニングの必要性も重要事項です。

注意:

この項の領域計算の説明の詳細では、第9.3項「領域使用量、ハードウェア・リソース、およびデータベース・パフォーマンスの監視」を頻繁に参照します。

表9-1は、毎日永続的に使用されるコンポジット領域および最小保持領域に基づいて、小規模、中規模および大規模なインストールのプロファイルを示しています。保存ポリシーで数日間以上データを保持できなくてもコンポジットのインフローが高くなることがあるため、これら2つのメトリックは、and/or条件に関連します。

表9-1 Oracle SOA Suiteのデータベース・プロファイル

データベース・プロファイル

毎日永続するコンポジット領域

最小保持領域

小規模

< 10 GB

< 100 GB

中規模

10-30 GB

100-300 GB

大規模

> 30 GB

> 300 GB

9.2.1 データのインフローの確認

コンポジット・インフローおよび領域使用量の比率は、長期間の負荷テスト後に導出される平均として最適であると理解されます。これによって、割り当てられた領域(セグメントのエクステント)の利用を改善できます。インフローを把握するため、次のデータ・ポイントが調査されます。

- 第9.2.1.1項「毎日生成されるコンポジット数の確認」。

- 第9.2.1.2項「各コンポジットが使用するディスク領域の確認」。

- 第9.2.1.3項「毎日永続的に使用されるコンポジット領域の確認」。

- 第9.2.1.4項「Oracle SOA Suiteセグメントの領域配分の分析」。

9.2.1.1 毎日生成されるコンポジット数の確認

次の計算式を使用して、毎日生成されるコンポジット数を確認します。

Daily-inflow-composite = (Composite Total / Period)

たとえば、合計コンポジット件数100,000で5日間の負荷テストを行い、それに基づいて生成されるコンポジットの平均数を計算します。

(20,000 = (100,000 / 5))

詳細は、第9.3.1.1項「コンポーネントの増加傾向の判定」を参照してください。

9.2.1.2 各コンポジットが使用するディスク領域の確認

次の計算式を使用して、各コンポジットが使用するディスク領域を確認します。

Inflow-space-per-composite = (SOA Schema Size /Composite Total)

たとえば、合計コンポジット数100,000、およびOracle SOA Suiteスキーマ・サイズ約200GBで、各コンポジットが使用する平均ディスク領域を計算します。

(2MB = (200 GB / 100,000))

詳細は、第9.3.1.2項「Oracle SOA Suiteスキーマの増加傾向の判定」を参照してください。

9.2.1.3 毎日永続的に使用されるコンポジット領域の確認

次の計算式を使用して、毎日永続的に使用されるコンポジット領域を確認します。

Daily-inflow-composite-space = (Daily-inflow-composite * Inflow-space-per-composite)

たとえば、それぞれが2MBの20,000個のコンポジットで、毎日コンポジットが使用する平均ディスク領域を計算します。

(40 GB = (20,000 * 2 MB))

別の方法の例を示します。

Daily-inflow-composite-space = (SOA Schema Size / Period)

9.2.1.4 Oracle SOA Suiteセグメントの領域配分の分析

Oracle SOA Suiteのスキーマの形状を分析して、セグメント領域(表、索引およびラージ・オブジェクト(LOB))の配分を把握し、問題となる可能性がるセグメントを特定できるようにします。

- コンポジットの増加傾向を判定します。詳細は、第9.3.1.1項「コンポーネントの増加傾向の判定」を参照してください。

- 日次の負荷テスト後にコンポーネントの統計を収集して、平均増分を判定できるようにします。

- Oracle SOA Suiteスキーマの増加傾向を判定します。詳細は、第9.3.1.2項「Oracle SOA Suiteスキーマの増加傾向の判定」を参照してください。

- 日次の負荷テスト後にスキーマ・サイジングの統計を収集して、平均増分を判定できるようにします。

- 最大セグメントを判別します。詳細は、第9.3.1.3項「最大セグメントの判別」を参照してください。

- 表と索引の増加傾向を判定します。詳細は、第9.3.1.4項「表と索引の増加傾向の判定」を参照してください。

- 表および索引の増加統計は、自動ワークロード・リポジトリ(AWR)によって自動的に収集されます。

詳細は、第9.3.1.1項「コンポーネントの増加傾向の判定」を参照してください。

9.2.2 保存ポリシーの策定

コンポジットをデータベース内に保存する期間を検討する必要があります。これはOracle SOA Suiteのスキーマおよびパージ・スクリプトのパフォーマンスに影響します。保存ポリシーに影響するファクタ次のとおりです。

- 法律的な要件

- ライン・オブ・ビジネスの要件

- データの保存に関する全般的な会社のポリシー

保存ポリシーが長くなるほど、格納する必要があるデータの量が増加し、それに応じて必要なディスク容量も多くなります。

9.2.2.1 最小保存ディスク領域の決定

次の計算式を使用して、最小保存ディスク領域を確認します。Daily-inflow-composite-spaceの詳細は、第9.2.1.3項「毎日永続的に使用されるコンポジット領域の確認」を参照してください。

Min-space-retain = Daily-inflow-composite-space * Retention Period in days

たとえば、毎日永続的に使用されるコンポジット領域40GB、保存期間10日間で最小保存ディスク領域を計算します。

(400 GB = (40 GB * 10))

9.2.2.2 最小保存コンポジット数の判定

次の計算式を使用して、最小保存コンポジット数を確認します。Daily-inflow-composite確認の詳細は、第9.2.1.1項「毎日生成されるコンポジット数の確認」を参照してください。

Min-composites-retain = Daily-inflow-composite * Retention Period in days

たとえば、毎日作成されるコンポジット数20,000、および保存期間10日間で最小保存コンポジット数を計算します。

(200,000 = (20,000 * 10))

これにより、10日間の保存ポリシーに基づいて、200,000個のコンポジットが平均400GBのデータを保存すると述べることができます。

注意:

前述の計算により、最小ディスク領域使用量の概算が定義されます。実際の最小ディスク領域使用量は、品質保証テストによってより正確に判定されます。詳細は、第9.4.2項「品質保証テスト」を参照してください。

9.2.3 データのアウトフローの確認

コンポジットのアウトフローは、削除されたコンポジット数の測定です。これはデータベース・プロファイルの決定時のファクタではありませんが、増分管理戦略の効率の評価時に重要なメトリックです。

アウトフロー測定の目標は、次の事項を確認することです。

- インフローが削除可能であること。

- できれば、領域使用量の安定状態が最小保存ディスク領域使用量を少し上回るものであること。

詳細は、第9.2.2.1項「最小保存ディスク領域の決定」を参照してください。

次の2つのサイクルを最初に定義する必要があります。

- パージ・サイクル: パージ・スクリプトの複数回の実行が必要になる可能性がある期間を指します。

- メンテナンス・サイクル: すべての領域管理操作の実行が必要な日数を指します。詳細は、第9.5.1項「データファイルのコンポーネントの概要」を参照してください。

適切な増分管理戦略には、パージとパーティション化の両方が含まれる場合があります。したがって、アウトフローは適切なパーティションが削除されるまで測定できません。パーティションの削除はメンテナンス操作です。このため、メンテナンス・サイクルが終了するまではアウトフローを測定しても有意義ではありません。

メンテナンス・サイクルの前後に次のメトリックを取得することで、戦略の効率性を把握し、領域配分を再評価できます。

- コンポジットの増加傾向を判定します。詳細は、第9.3.1.1項「コンポーネントの増加傾向の判定」を参照してください。

- Oracle SOA Suiteスキーマの増加傾向を判定します。詳細は、第9.3.1.2項「Oracle SOA Suiteスキーマの増加傾向の判定」を参照してください。

- 最大セグメントを判別します。詳細は、第9.3.1.3項「最大セグメントの判別」を参照してください。

- 表と索引の増加傾向を判定します。詳細は、第9.3.1.4項「表と索引の増加傾向の判定」を参照してください。

注意:

安定状態に達している場合、コンポーネントおよびスキーマの増分に関するメトリックの前後の差はゼロに近い数値またはマイナスになります。それ以外の場合は、パージ戦略で対処できていないか、データのインフローが増加している可能性があります。

9.2.4 長期間実行されるコンポジットおよび表のパーティション化の確認

長期間実行されるコンポジットは、保存期間より長期にわたってオープンしているコンポジットです。これらのコンポジットはパージ・スクリプトに大きく関係しませんが、表のパーティション化の実装時に影響が感知されます。(第9.4項「増分管理の課題およびテスト戦略の理解」では、中規模および大規模のインストールでは表のパーティション化を検討するようにお薦めしています。)

パーティション化された表は、その領域がデータベースのALTER TABLE … DROP PARTITIONコマンドによって再利用されるため、パージ・スクリプトの対象から除外されます(また、除外する必要があります)。長期間実行されるコンポジットは、必要とされる保存期間を超えてオープンした状態で保持されるため、パーティションの削除は行われず、領域の再利用は行われません。したがって、パーティション化された表のサイズを推定する際は、使用される保存期間を実行期間が最長のコンポジットと同じにする必要があります。

Retention period = Longest Running Composite.

長期間実行されるトランザクションとパーティション化された表のサイズの領域に対する影響を最もよく理解するには、第9.4項「増分管理の課題およびテスト戦略の理解」の説明に従って品質保証テストを行います。ただし、パーティション化された表のそれぞれが使用する領域の推定には、次の項の計算を使用してください。

9.2.4.1 パーティション化する各表に対する推奨事項

数日以上の期間にわたって表に負荷をかけて合理的な平均を生成する方法が最も適しています。表9-2に詳細を示します。

表9-2 表のパーティション化の推奨事項

アクション

コマンド

各表で毎日生成される平均の行数を判定します。

(Total rows / period)

最も長く実行されるコンポジットに基づいて、行数を推定します。

((Total rows / period) * Longest running composite in
days)

行の計算に基づいて表と索引の領域使用量を推定します。

第9.3.1.5項「表サイズの推定」および第9.3.1.6項「索引サイズの推定」を参照してください。

注意:

Oracle SOA Suite Release 11g R1 (11.1.1.6)以降は、行移行と呼ばれるスクリプトの新しいセットが提供されています。これらのスクリプトは、パーティション間で長期間実行されるコンポジットを移動でき、これによってパーティションの削除を容易にします。ただし、ベスト・プラクティスはパーティション表の領域所要量を計画することであり、行移行スクリプトに依存することではありません。

9.3 領域使用量、ハードウェア・リソース、およびデータベース・パフォーマンスの監視

次の各項では、領域使用量の監視方法について説明します。

- 第9.3.1.1項「コンポーネントの増加傾向の判定」

- 第9.3.1.2項「Oracle SOA Suiteスキーマの増加傾向の判定」

- 第9.3.1.3項「最大セグメントの判別」

- 第9.3.1.4項「表と索引の増加傾向の判定」

- 第9.3.1.5項「表サイズの推定」

- 第9.3.1.6項「索引サイズの推定」

- 第9.3.1.7項「未使用索引の監視」

次の各項では、ハードウェア・リソースとデータベース・パフォーマンスの監視方法を説明します。

- 第9.3.2.1「ハードウェア- OSWatcher Black Box」

- 第9.3.2.2項「データベース– AWR/ADDM」

- 第9.3.2.3項「ディスクI/O-Oracle Orion」

9.3.1 領域の使用量の監視

領域の監視は、データベース管理者およびシステム管理者にとって計画外停止を回避するための重要な作業です。ここでは、キャパシティ・プランニングおよび増分管理戦略の効率性の判定に役立つアドバイスを提供します。監視およびキャパシティ・プランニングのあらゆる側面の包括的なガイドを提供するものではありません。

キャパシティ・プランニングおよびしきい値監視の詳細は、『Oracle Database管理者ガイド』を参照してください。

9.3.1.1 コンポーネントの増加傾向の判定

コンポーネントのマスター表には、各行の作成日付が記録され、特定期間の増加傾向の判定に使用されます。

- COMPOSITE_INSTANCE: CREATED_TIME

- CUBE_INSTANCE: CREATION_DATE

- MEDIATOR_INSTANCE: CREATED_TIME

ただし、コンポーネントのマスター表への問合せは、定期的なパージによってデータが削除されるために制限され、傾向の予測を困難にします。特定期間全体の傾向を判定するには、関連付けられたタイムスタンプとともにデータを定期的に収集する必要があります。これは、毎日移入される単純なコンポーネント履歴表によって実現できます。増分管理戦略の効率性および増加傾向の判定にはこの表で十分になります。

- パフォーマンス上の理由により、例9-1に示されるように履歴表をコンポーネント別に作成することが最適である可能性があります。

例9-1 履歴表の作成

SQL> CREATE TABLE SOA_FABRIC_HIST (SFH_DATE TIMESTAMP, SFH_COUNT NUMBER);

SQL> INSERT INTO SOA_FABRIC_HIST SELECT SYSTIMESTAMP, COUNT(*) FROM
COMPOSITE_INSTANCE GROUP BY SYSTIMESTAMP;

SQL> CREATE TABLE SOA_BPEL_HIST (SBH_DATE TIMESTAMP, SBH_COUNT NUMBER);

SQL> INSERT INTO SOA_BPEL_HIST SELECT SYSTIMESTAMP, COUNT(*) FROM CUBE_INSTANCE
GROUP BY SYSTIMESTAMP;

このようになります。

- 表の分析であれば、各コンポーネント表での行数のカウントの代替方法として、USER_TABLESからNUM_ROWS列を問い合せます。

9.3.1.2 Oracle SOA Suiteスキーマの増加傾向の判定

Oracle SOA Suiteスキーマに作成されるオブジェクト(表、索引およびLOB)は、多様な表領域に拡散している場合がありますが、領域使用量をグループ化するためすべて同じ所有者(*soainfra)が使用されます。各コンポジットの領域所要量を判定する際は、索引とLOBセグメントが反映されるため、スキーマ全体を測定することで優れた領域メトリックを取得できます。

単純な履歴表に毎日移入することで、Oracle SOA Suiteスキーマの増加を監視できます。領域管理の効率性の判定にはこの表で十分になります。詳細は、第9.5項「領域管理の理解」を参照してください。

- 例9-2に示されるように、オブジェクト・タイプに基づいてスキーマ増加表を作成します。

例9-2 スキーマ増加表の作成

SQL> CREATE TABLE SOA_SIZE_SCHEMA_HIST (SSCH_DATE TIMESTAMP, SSCH_SUM_MB
NUMBER);

SQL> INSERT INTO SOA_SIZE_SCHEMA_HIST SELECT SYSTIMESTAMP, SUM(BYTES)/1024/1024
FROM DBA_SEGMENTS WHERE OWNER='<SOA_OWNER>' GROUP BY SYSTIMESTAMP;

- 最大セグメントと結合してパーティション化や不足領域管理が必要な表を確認する際は、必要に応じて、オブジェクト・タイプ別(表、索引、LOBなど)の履歴表を作成すると便利です。例9-3に詳細を示します。

例9-3 履歴表の作成

SQL> CREATE TABLE SOA_SIZE_TYPE_HIST (SSCH_DATE TIMESTAMP, SSCH_TYPE
VARCHAR2(18), SSCH_SUM_MB NUMBER);

SQL> INSERT INTO SOA_SIZE_TYPE_HIST SELECT SYSTIMESTAMP, SEGMENT_TYPE,
SUM(BYTES)/1024/1024 FROM DBA_SEGMENTS WHERE OWNER='SOA_OWNER' GROUP BY
SYSTIMESTAMP, SEGMENT_TYPE;

9.3.1.3 最大セグメントの判別

スキーマ内でどのセグメントが最大であるかを把握することは、レンジ・パーティション化された表として管理することが適している表の判別に役立ちます。さらに、最大セグメントを監視することで、不足している領域管理操作や不適切な監査設定を発見できる可能性もあります。

- 例9-4に示されるように、Oracle SOA Suiteスキーマの最大から20個までのセグメントを特定します。

例9-4 最大から20個までのセグメントの特定

SQL> SELECT SEGMENT_NAME, SEGMENT_TYPE, (SUM(BYTES)/1024/1024) MB_SIZE FROM
DBA_SEGMENTS WHERE OWNER='SOA_OWNER' AND ROWNUM < 20 GROUP BY SEGMENT_NAME,
SEGMENT_TYPE ORDER BY 3 DESC;

- 例9-5に示されるように、最大セグメントはLOBセグメントである可能性があります。

例9-5 LOBセグメントが最大セグメントであることを示す例

SQL> SELECT L.TABLE_NAME, S.SEGMENT_NAME, (SUM(BYTES)/1024/1024) MB_SIZE FROM
DBA_LOBS L, DBA_SEGMENTS S WHERE S.OWNER='<SOA_OWNER>' AND S.SEGMENT_TYPE =
'LOBSEGMENT' AND S.SEGMENT_NAME = L.SEGMENT_NAME AND S.OWNER='SOA_OWNER''
GROUP BY L.TABLE_NAME, S.SEGMENT_NAME;

または

SQL> SELECT L.TABLE_NAME FROM DBA_LOBS L WHERE L.OWNER ='<SOA_OWNER>' AND
L.SEGMENT_NAME = 'SEGMENT_NAME';

- 個別のセグメントのサイズの判定は次のとおりです。

SQL> SELECT SEGMENT_NAME, (SUM(BYTES)/1024/1024) MB_SIZE FROM DBA_SEGMENTS
WHERE OWNER='SOA_OWNER' AND SEGMENT_NAME = 'TABLE_NAME' GROUP BY SEGMENT_
NAME;

9.3.1.4 表と索引の増加傾向の判定

DBMS_SPACEパッケージのOBJECT_GROWTH_TREND関数を使用して、表の領域増加傾向を示します。詳細は、『Oracle Database管理者ガイド』を参照してください。

DBMS_SPACEパッケージ・プロシージャのOBJECT_GROWTH_TREND関数では、特定の時点におけるオブジェクトの領域使用が各行に記述された1行以上の表が作成されます。この関数は、AWRから領域合計を取得するか、現在の領域を計算して、AWRから取得した領域の変化履歴と結合します。

次の例は、COMPOSITE_INSTANCE表の使用済および割当て済領域の時間経過による増加を示しています。

SQL> SELECT TIMEPOINT, SPACE_USAGE, SPACE_ALLOC, QUALITY FROM TABLE (DBMS_
SPACE.OBJECT_GROWTH_TREND ('DEV_SOAINFRA','COMPOSITE_INSTANCE','TABLE'));

例9-6は、dbms_space.object_growth_trendプロシージャの完全な構文を示しています。

例9-6 DBMS_SPACE.OBJECT_GROWTH_TRENDプロシージャ

dbms_space.object_growth_trend (
object_owner in varchar2,
object_name in varchar2,
object_type in varchar2,
partition_name in varchar2 default null,
start_time in timestamp default null,
end_time in timestamp default null,
interval in dsinterval_unconstrained default null,
skip_interpolated in varchar2 default 'false',
timeout_seconds in number default null,
single_datapoint_flag in varchar2 default 'true')

表9-3は、object_growth_trend関数のパラメータの説明です。

表9-3 OBJECT_GROWTH_TREND関数のパラメータ

パラメータ

説明

object_owner

オブジェクトを含むスキーマ。

object_name

オブジェクトの名前。

OBJECT_TYPE

オブジェクトのタイプ。

partition_name

関連する場合は、表または索引パーティションの名前。関連しない場合はNULLを指定します。

start_time

増加傾向分析の開始を示すタイムスタンプ値。

end_time

増加傾向分析の終了を示すタイムスタンプ値。デフォルトはNOWです。

interval

間隔であるか(yes)、そうでないか(no)。この設定は、結果表がグラフではなく表として表示される場合に便利です。これは、実際の記録間隔が要求されたレポート間隔とどのように関連しているかをより明確に確認できるためです。この関数は、行ごとに1つの間隔のオブジェクトの領域使用情報が表示された表を返します。返される表が非常に大きい場合は、情報が作成されると同時に別のアプリケーションが使用できるように結果がパイプライン化されます。

skip_interpolated

欠落値の補間をスキップするかどうかを指定します(trueまたはfalse)。

timeout_seconds

関数のタイムアウト値(秒)。

single_data_point_flag

統計がないときにセグメントをサンプリングするかどうかを指定します。

戻り値を例9-7に示します。

例9-7 戻り値

TYPE object_growth_trend_row IS RECORD(
timepoint timestamp,
space_usage number,
space_alloc number,
quality varchar(20));

表9-4は、object_growth_trend_rowの戻り値の説明です。

表9-4 OBJECT_GROWTH_TREND_ROWの戻り値

パラメータ

説明

timepoint

レポート間隔の時間を示すタイムスタンプ値。最も古いオブジェクトの記録統計よりも前のtime値の記録は作成されません。

space_usage

オブジェクト・データとして実際に使用されているバイト数。

space_alloc

その時点で表領域のオブジェクトに割り当てられていたバイト数。

quality

要求されたレポート間隔と実際の統計記録が一致している程度を示す値。オブジェクト・サイズ使用統計には保証されているレポート間隔はなく、実際のレポート間隔は時間の経過およびオブジェクトによって変わるため、この情報が役立ちます。

- good: 記録されたタイムスタンプが入力パラメータで指定したintervalの10%以内である記録統計に、timeの値が常に基づいている場合の値。この関数から戻る出力は、Oracle Real Application Clusters環境のすべてのインスタンスで記録された値の集合です。各値は、goodおよびinterpolated値の組合せから計算できます。その値の80%以上がgoodのインスタンス値から導出された場合、戻される集計値はgoodとマークされます。

- interpolated: 値がgoodの基準を満たしていないが、time値の前後の記録統計に基づいている場合。現在のメモリー内統計は、クラスタ内のすべてのインスタンスで収集でき、現時点の記録値として扱うことができます。

- projection: 表が作成された時点でtime値が未来であった場合。Oracle Real Application Clusters環境では、統計の記録ルールによって、どのオブジェクトが選択されるかを各インスタンスが独自に選択できるようになっています。

9.3.1.5 表サイズの推定

dbms_spaceパッケージのcreate_table_costプロシージャを使用すると、既存の表の予想行数を使用するか、表の列定義に基づいて表のサイズを推定できます。表のサイズは、このプロシージャからの表領域の記憶域属性に従って大きく異なる場合があります。このプロシージャには、次の2つのオーバーロードがあります。

- 最初のプロシージャは、表の列情報を取得します。

- 2番目のプロシージャは、表の平均行サイズを取得します。

Oracle SOA Suiteの表は既存のため、2番目のバリアントが最も有益です。次の例は、10000行があり、行の長さの平均が360で、PCT FREEが10の表CUBE_INSTANCEのサイズを推定しています。

1. 次のコマンドを実行します。行の長さの平均と現在のPCT_FREEは、表が分析されていることが確認された後にDBA_TABLESから導出されます。

SQL> SELECT AVG_ROW_LEN, PCT_FREE FROM DBA_TABLES WHERE TABLE_NAME =
'CUBE_INSTANCE' AND OWNER = 'DEV_SOAINFRA';

2. dbms_space.create_table_costプロシージャを実行します。

set serverout on
declare

v_used number(10);
v_alloc number(10);

begindbms_space.create_table_cost
('SOA1_SOAINFRA',360,10000,10, v_used,v_Alloc);
dbms_output.put_line('used bytes: ' || to_char(v_used));
dbms_output.put_line('allocated bytes: ' || to_char(v_alloc));

end;
/

例9-8は、列定義に基づいて表の領域使用量を推定しています。

例9-8 領域使用量の推定

set serveroutput on
declare

v_used_bytes number(10);
v_allocated_bytes number(10);
v_type sys.create_table_cost_columns;

begin

v_type := sys.create_table_cost_columns
( sys.create_table_cost_colinfo('number',9),
sys.create_table_cost_colinfo('varchar2',50),
sys.create_table_cost_colinfo('varchar2',15),
sys.create_table_cost_colinfo('date'f,null),
sys.create_table_cost_colinfo('date'f,null) );
dbms_space.create_table_cost
('users',v_type,10000,7,v_used_bytes,v_allocated_bytes);
dbms_output.put_line('used bytes: ' || to_char(v_used_bytes));
dbms_output.put_line('allocated bytes: ' || to_char(v_allocated_bytes));
end;
/

dbms_space.create_table_costプロシージャの完全な構文は、例9-9および例9-10に示されています。

- 最初のオーバーロード

例9-9 最初のオーバーロード

dbms_space.create_table_cost (tablespace_name in varchar2,
colinfos in create_table_cost_columns, row_count in number,
pct_free in number, used_bytes out number,
alloc_bytes out number); create type
create_table_cost_colinfo is object (col_type varchar(200),
col_size number);

- 2番目のオーバーロード

例9-10 2番目のオーバーロード

dbms_space.create_table_cost (tablespace_name in varchar2,
avg_row_size in number, row_count in number, pct_free in number,
used_bytes out number, alloc_bytes out number);

いずれのバリアントでも、表9-5および表9-6に示された入力が必要です。

表9-5 CREATE_TABLE_COSTプロシージャのパラメータ

パラメータ

説明

tablespace_name

オブジェクトが作成される表領域。デフォルトはSYSTEM表領域です。

row_count

表の予測行数。

pct_free

更新の結果、既存の行を将来拡張するために各ブロックで確保される空き領域の割合(パーセンテージ)。

さらに、最初のバリアントには、入力値としてavg_row_sizeも必要で、これは予測された行の平均サイズをバイト単位で示します。

また、2番目のバリアントは、予想された各列値をcolinfosで指定する必要があります。この値は、属性col_type(列のデータ型)とcol_size(列の文字数またはバイト数)で構成されるオブジェクト型です。

表9-6 CREATE_TABLE_COSTプロシージャの戻り値

パラメータ

説明

used_bytes

ブロック・メタデータ、PCT_FREE領域などのオーバーヘッドを含め、データとして使用される実際のバイト数。

alloc_bytes

表領域のエクステントの特性を考慮してオブジェクトに割り当てられる予測領域量。

9.3.1.6 索引サイズの推定

dbms_spaceパッケージのcreate_index_costプロシージャを使用すると、既存の表での索引作成の領域使用コストを推定できます。これを使用して、Oracle SOA Suiteスキーマに索引を追加する際のコストを判定します。

例9-11は、データ定義言語(DDL)に基づいて新しい索引のサイズを推定します。

例9-11 新しい索引のサイズ

set serveroutput on
declare
v_used_bytes number(10);
v_allocated_bytes number(10);
begin
dbms_space.create_index_cost(
'create index cube_index on cube_instance(cikey)'
v_used_bytes, v_allocated_bytes);
dbms_output.put_line('used bytes: ' || to_char(v_used_bytes));
dbms_output.put_line('allocated bytes: '|| to_char(v_allocated_bytes));end; /

DBMS_SPACE.CREATE_INDEX_COSTプロシージャの完全な構文は次のとおりです。

dbms_space.create_index_cost (ddl in varchar2, used_bytes out number,
alloc_bytes out number, plan_table in varchar2 default null);

このプロシージャには、表9-7に示された入力値が必要です。

表9-7 DBMS_SPACE.CREATE_INDEX_COSTの値

パラメータ

説明

ddl

索引を作成するCREATE INDEX文。DDL文は既存の表に対するものである必要があります。

plan_table

(オプション)使用する計画表の名前。デフォルトはnullです。このプロシージャから戻る結果は、セグメントに対して収集された統計によって異なります。したがって、このプロシージャを実行する直前に必ず統計を取得してください。最近の統計がない状態でもエラーになりませんが、不適切な結果が戻る可能性があります。このプロシージャでは、次の値が戻ります。

- used_bytes
実際の索引データに相当するバイト数。

- alloc_bytes
表領域の索引に割り当てられる領域量。

使用上の注意:

- 索引が作成される表は、すでに存在している必要があります。

- 索引サイズの計算は、セグメント上で集められた統計情報に依存します。

- 表は分析直後である必要があります。

- 正しい統計がないと、結果が不正確になる可能性があります。

9.3.1.7 未使用索引の監視

Oracleデータベースには、索引を監視して使用されているかどうかを判定する手段が用意されています。索引が使用されていない場合は、それを削除して不要な文によるオーバーヘッドを解消できます。

1. 索引使用の監視を開始するには次の文を入力します。

SQL> ALTER INDEX INDEX_NAME MONITORING USAGE;

2. 監視を停止するには次の文を入力します。

SQL> ALTER INDEX INDEX_NAME NOMONITORING USAGE;

監視対象の索引について、その索引が使用されているかどうかを確認するには、ビューV$OBJECT_USAGEを問い合せます。このビューにはUSED列があり、監視期間中に索引が使用されたかどうかによってYESまたはNOの値を持ちます。また、このビューには監視の開始時間と停止時間も記録され、MONITORING列(YES/NO)には使用状況の監視が現在アクティブであるかどうかが示されます。MONITORING USAGEを指定するたびに、指定された索引のV$OBJECT_USAGEビューはリセットされます。前回の使用方法の情報はクリアまたはリセットされ、新しい開始時間が記録されます。NOMONITORING USAGEを指定すると、それ以降の監視は実行されず、監視期間の終了時間が記録されます。次にALTER INDEX...MONITORING USAGE文が発行されるまで、ビューの情報は変更されずに保持されます。

9.3.2 ハードウェア・リソースおよびデータベースの監視

ハードウェア・リソースは増分戦略の実装に選択されたツールのサポートが可能である必要があります。オンライン・トランザクション処理(OLTP)およびメンテナンス期間、特にこれらの期間が重複する際にハードウェア・リソースを監視することが重要です。

9.3.2.1 ハードウェア- OSWatcher Black Box

CPU、ディスク、メモリーおよびネットワークO/Sリソースを監視するため、オラクル社はOSWatcher Black Boxを提供しており、これをOracle SOA Suiteインストールのすべてのレイヤーにインストールする必要があります。

OSWatcher Black Boxは、オペレーティング・システムおよびネットワークのメトリックを収集およびアーカイブして、Oracleサポート・サービスでのパフォーマンスに関連する問題の診断を支援するUNIXシェル・スクリプトのコレクションです。OSWatcher Black Boxは、サーバー上のバックグラウンド・プロセスのセットとして動作し、vmstat、netstat、iostatなどのUNIXユーティリティを起動して定期的にOSデータを収集します。

OSWatcher Black Boxユーザー・ガイドおよび製品は、Metalinkサポート・ノート301137.1からダウンロードできます。

https://support.oracle.com

9.3.2.2 データベース– AWR/ADDM

オラクル社は、データベース・パフォーマンス統計の収集および分析のための、AWRおよび自動データベース診断モニター(ADDM)を用意しています。

AWRは、パフォーマンス統計のスナップショットを定期的に自動収集する構成も、手動でトリガーする構成も可能です。その後ADDMユーティリティで、2つのスナップショット間隔間の統計を分析し、以下が含まれるパフォーマンス・サマリー・レポートを作成できます。

- CPUのボトルネック

- サイズ設定が小さすぎるメモリー構造

- I/O能力に関連する問題

- 高負荷のSQL文

- 高負荷のPL/SQL実行およびコンパイルの問題、および高負荷のJavaの使用

- Oracle Real Application Clusters固有の問題

- アプリケーションによるOracleデータベースの非効率的な使用

- データベース構成の問題

- 同時実行の問題

- ホット・オブジェクト

AWRおよびADDMユーティリティは手動で、またはOracle Enterprise Manager Database Controlから実行できます。詳細は、『Oracle Database 2日でパフォーマンス・チューニング・ガイド』を参照してください。

9.3.2.3 ディスクI/O-Oracle Orion

完全なOracle SOA SuiteのI/O設計は、この章の範囲に含まれていません。ただし、『Oracle Databaseパフォーマンス・チューニング・ガイド』には、適切なアドバイスが記載されています。適切に計画されているI/O計画では、容量、可用性およびパフォーマンスが考慮されます。

AWRレポートは、アクセス頻度の高いセグメント、データファイルおよび表領域を特定します。OSWatcherは、長時間かかるI/Oキューを特定します。これらのツールを組み合せることによって、問題のあるディスク・デバイスおよびファイルが特定されます。これによって、I/Oの均衡化、または低速ボリューム上のRedundant Arrays of Inexpensive Disks (RAID)の変更のためのファイルの再分散の必要性を識別できる可能性があります。

OracleデータベースのI/O調整機能 (Oracle Orion)は、記憶域メディアへのアクセスにOracleデータファイルを使用して、ランダムI/Oを発行します。これにより、データベースの実際のパフォーマンスにほとんど一致する結果が生成されます。Oracle Orionは特に、Oracleと同じI/Oソフトウェア・スタックを使用してOracleデータベースのI/Oワークロードをシミュレートするように設計されています。Oracle Orionは、Oracle Automatic Storage Managementによって実行されるストライプ化の影響をシミュレートすることもできます。詳細は、『Oracle Databaseパフォーマンス・チューニング・ガイド』を参照してください。

9.4 増分管理の課題およびテスト戦略について

ここでは、Oracle SOA Suiteデータベースの増分管理に適したツールに関する推奨事項を説明しています。提示されるアドバイスは、新規インストール、または現在の戦略に監視や領域管理が不足している既存のインストールに向けたものです。その他の推奨事項は、第B.2項「パラレル・パージと表のパーティション化の問題」を参照してください。

この項の前に、第9.3項「領域使用量、ハードウェア・リソース、およびデータベース・パフォーマンスの監視」を参照して、Oracle SOA Suiteのパージおよびパーティション化ツールについて十分に理解しておくことをお薦めします。

9.4.1 データベース増分管理の課題

ここで説明する課題は、推奨される戦略に関係する状況を説明することによって背景知識を提供します。

9.4.1.1 非効率的な管理戦略によるOracle SOA Suiteの表の過度の増大化

非効率的なパージ戦略が実装されていると、Oracle SOA Suiteの表が非常に大きく増大する場合があります。これによって、緊急に領域再利用の必要が発生することになります。表が大きいほど、行の削除や領域の再利用が困難になります。

パラレル・パージ・スクリプトのパフォーマンスは、CPUリソース、ディスクI/Oの速度などのファクタに依存します。ただし、非常に大きな表は問題であることが判明しています。この問題は、削除可能なコンポジットを決定するために解析が必要になるデータ量が原因で生じます。この解析は、パージ・スクリプト全体の経過時間を独占的に使用する場合があります。詳細は、第B.2.1.3項「パラレル問合せスレーブの使用」を参照してください。

この状況は、増分管理戦略の効率性の監視が常に必要であること、および表が非常に大きくなる前に可能なかぎり速やかに対応措置をとる必要があることを強調するものです。

9.4.1.2 インフローを処理できない調整済のパラレル・パージ・スクリプト

パラレル・パージ・スクリプトのパフォーマンスを向上させるため、経過時間の長い表はレンジ・パーティション化してスクリプトから除外できます。ただし、表のパーティション化が本番環境で必要な場合は、これによって停止時間の問題が生じます。表は再定義パッケージによってオンラインでパーティション化できますが、非常に大きい表で発生した場合は、この操作が合理的な時間内に完了しない場合があります。Oracle SOA Suite Release 11g R1 (11.1.1.6)移行は、パーティション化が可能な表の粒度が改善されています。現在は、マスター表のみで高ボリュームの表のパーティション化を実行できます。これによってパーティション化の注目度が上がり、実現性も高くなります。詳細は、第10.4.8項「コンポーネントの部分的なパーティション化」を参照してください。

9.4.1.3 長時間実行されるコンポジットが原因で削除できない表パーティション

長期間実行されるコンポジットは、保存期間より長期にわたってオープンしているコンポジットです。含まれるすべてのコンポジットがクローズされるまでは削除できないため、これはOracle SOA Suiteの表パーティションに影響を及ぼします。オープンのコンポジットが数個であっても、パーティションの削除および領域の再利用ができなくなる可能性があります。この状況からOracle SOA Suiteリリース11g R1 (11.1.1.6)で使用可能な行移行スクリプトが生まれました。詳細は、第10.4.7項「別のパーティションへの長時間実行されているアクティブなインスタンスの移動」を参照してください。

最も長時間実行されるコンポジットの保存期間を含め、パーティション化された表を収容するために十分なディスク領域を計画します。領域の再利用が緊急に必要な場合は、修正処理として行の移行スクリプトをお薦めします。

行移行スクリプトによるコンポジット・データの移動によって、次の問題が発生します。

- このスクリプトは、スクリプトによるパフォーマンスの問題を回避するためパーティション内のデータの約5%が移動されると想定して作成されています。

- 同一レベルのパーティション化の要件を維持するには、多数の表の行の5%の移動が必要です。同一レベル・パーティション化の詳細は、第B.2.2.1項「参照整合性および同一レベル・パーティション化」を参照してください。

- 5%の任意数は、パーティションのサイズを意味するものではなく、インフロー率およびパーティションの期間(日次、週次および月次)に依存します。

- 最新のパーティション、またはアクティブ・コンポジットのプール専用として作成されたパーティションに実行時間の長いコンポジットの移行を繰り返すと、累積が発生することがあります。

- 特定のパーティションが非常に増大して、別の影響が生じるパージが必要になります。詳細は、第B.2.2.5項「パーティション・プルーニング」を参照してください。

9.4.2 品質保証テスト

ツールおよび技術の習熟および理解を保証するには増分管理戦略のテストが非常に重要です。品質保証テストに使用可能なハードウェア・リソースは本番環境と同じであることはほとんどありません。したがって、管理者が本番稼働ホストに結果を反映する際は慎重に予測する必要があります。

この項の項目は次のとおりです。

- 第9.4.2.1項「Metalinkサポート・ノート1384379.1の確認」

- 第9.4.2.2項「本番監査レベル設定の構成」

- 第9.4.2.3項「Oracle SOA Suiteスキーマの作成-テスト環境」

- 第9.4.2.4項「パラレルまたはシングル・スレッド・スクリプトの実行および領域の再利用」

- 第9.4.2.5項「テスト結果の確認」

- 第9.4.2.6項「ボトルネックを発生する表のパーティション化」

- 第9.4.2.7項「パージ・テストと確認の反復およびパーティション化された表の除外」

9.4.2.1 Metalinkサポート・ノート1384379.1の確認

サポート・ノートDoc ID 358.1 メンテナンスおよび管理アドバイザ: Oracle Fusion Middleware (FMW) SOA 11gインフラストラクチャのデータベースを確認します。

https://support.oracle.com

9.4.2.2 本番監査レベル設定の構成

監査設定が本番環境に適しているかを確認します。詳細は、第B.2.3項「監査レベルの低減」を参照してください。

9.4.2.3 Oracle SOA Suiteスキーマの作成-テスト環境

本番環境と比較可能なテスト環境を作成することは困難ですが重要です。パージ・スクリプトのパフォーマンスは、解析が必要なデータの量によっては悪影響を受ける場合があります。したがって、パージのパフォーマンスを把握するにはサイジングが適切なテスト環境が重要です。詳細は、第B.2.1.3項「パラレル問合せスレーブの使用」を参照してください。

スキーマに移入される混在ワークロードは、ペイロード・サイズとコンポジット起動数が本番環境と類似している必要があります。データは、何日分もの負荷をシミュレートして、領域平均と推計サイズの判定を向上させる必要があります。

9.4.2.3.1 インフローおよび推定領域の測定

データの負荷時は、表別の使用領域および各領域の配分の判定に時間をかけてください。インフローの計算の詳細は、第9.2.1項「データのインフローの確認」を参照してください。

- コンポジットの増加傾向を判定します。詳細は、第9.3.1.1項「コンポーネントの増加傾向の判定」を参照してください。

- Oracle SOA Suiteスキーマの増加傾向を判定します。詳細は、第9.3.1.2項「Oracle SOA Suiteスキーマの増加傾向の判定」を参照してください。

パーティション化を念頭に置いてメトリックを収集します。

- 最大セグメントを判別します。詳細は、第9.3.1.3項「最大セグメントの判別」を参照してください。

- 表と索引の増加傾向を判定します。詳細は、第9.3.1.4項「表と索引の増加傾向の判定」を参照してください。

- 表のサイズを推定します。詳細は、第9.3.1.5項「表サイズの推定」を参照してください。

- 索引のサイズを推定します。詳細は、第9.3.1.6項「索引サイズの推定」を参照してください。

9.4.2.3.2 テスト環境の基本ポイント・バックアップ

テスト環境のバックアップを実行します。

9.4.2.4 パラレルまたはシングル・スレッド・スクリプトの実行および領域の再利用

次の2つのサイクルをまず理解しておく必要があります。

- パージ・サイクル: パージ・スクリプトの複数回の実行が必要になる可能性がある期間を指します。

- メンテナンス・サイクル: すべての領域管理操作の実行が必要な日数を指します。詳細は、第9.5.1項「データファイルのコンポーネントの概要」を参照してください。

目標は、パージ・スクリプトおよびメンテナンス・操作を実行して、パージに増大の余裕があることを保証してそれぞれに最適なサイクルを判定することです。パージ・スクリプトは、1日に複数回実行する必要がある場合があり、またメンテナンス操作は数日間にまたがる可能性があります。

後続の各項で領域の調整、監視、再利用の方法について説明します。

- パラレル・パージ。詳細は、第B.2.1項「パラレル・パージ・スクリプトの実行」を参照してください。

- ハードウェアおよびデータベースの監視。詳細は、第9.3.2項「ハードウェア・リソースおよびデータベースの監視」を参照してください。

- 領域管理操作。詳細は、第9.5.1項「データファイルのコンポーネントの概要」を参照してください。

9.4.2.5 テスト結果の確認

目標は次のとおりです。

- パージによって、インフローと同等またはそれ以上の領域の削除および再利用を実行できるかを判定します。詳細は、第9.2.2項「保存ポリシーの策定」および第9.2.3項「データのアウトフローの確認」を参照してください。

- パージ要件に一致させるためにパージの実行が必要な回数およびパージ・サイクルの合計経過時間を判定します。このパージ・サイクルは、その実行に割り当てられた時間の80%以内で完了する必要があります。

- ボトルネックの表を判別します。詳細は、第B.2.1.4項「パージ操作のデバッグとトレース」を参照してください。

- データベースおよびO/Sレポートでのリソース競合および待機を確認します。詳細は、第9.3.2項「ハードウェア・リソースおよびデータベースの監視」を参照してください。

9.4.2.6 ボトルネックを発生する表のパーティション化

大規模インストールでは、パージが困難であると確認された表のパーティション化を検討する必要があります。これらの表は、最大の表でもある可能性があります。表のパーティション化は、一括データ削除として実証済の方法です。Oracle SOA Suiteスキーマは、レンジ・パーティション化を容易にするパーティション・キーを備えています。

Oracle SOA Suiteリリース11g R1 (11.1.1.6)以降は、パーティション化が可能な表の粒度が改善されています。現在は、マスター表のみで高ボリュームの表のパーティション化を実行できます。これによってパーティション化の注目度が上がり、実現性も高くなります。

- 部分的なパーティション化。詳細は、第10.4.8項「コンポーネントの部分的なパーティション化」を参照してください。

- 長時間実行されるコンポジット。詳細は、第9.2.4項「長期間実行されるコンポジットおよび表のパーティション化の確認」を参照してください。

9.4.2.6.1 パーティション化された表による基本ポイント・バックアップ

パーティション化された表が含まれるバックアップを実行します。

9.4.2.7 パージ・テストと確認の反復およびパーティション化された表の除外

第9.4.2.4項「パラレルまたはシングル・スレッド・スクリプトの実行および領域の再利用」および第9.4.2.5項「テスト結果の確認」で説明されているパージ・テストとテスト結果の確認を繰り返します。パーティション化された表は除外します。

9.4.3 推奨される増分管理戦略

次の推奨される増分管理戦略は、Oracle SOA Suiteデータベース・プロファイルを基準にしています。

- 第9.4.3.1項「大規模データベース・プロファイルの推奨事項」。

- 第9.4.3.2項「中規模データベース・プロファイルの推奨事項」。

- 第9.4.3.3項「小規模データベース・プロファイルの推奨事項」。

戦略には、効率性を判定するためのテストが必要です。テストでは以下について確認する必要があります。

- パージ・スクリプトに増大の余裕があること。

- パーティション化された表に十分なディスク領域があること。

- 増大が監視されていること。

- メンテナンス実行時のOLTPパフォーマンスへの影響が最小であること。

9.4.3.1 大規模データベース・プロファイルの推奨事項

大規模なデータベース・プロファイルのあるインストールでは、戦略の一環として表のパーティション化を真剣に検討する必要があります。表のレンジ・パーティション化は大型の表の実証済の管理方法です。

1. パーティション化された表を除いてパラレル・パージを実行します。詳細は、第10.3.2項「dbms_schedulerを使用したパラレル・スクリプトでのループしたパージ」を参照してください。

2. パージ・スクリプトに対してボトルネック表をパーティション化します。詳細は、第10.4項「コンポーネント表のパーティション化」を参照してください。

3. メンテナンス・サイクルの一環として、領域を再利用します。詳細は、第9.5.1項「データファイルのコンポーネントの概要」を参照してください。

4. メンテナンス・サイクルの一環として、適切なパーティションを削除します。詳細は、第10.4.5項「検証スクリプトの実行」を参照してください。

5. インフローおよびアウトフローを監視します。詳細は、第9.2.2項「保存ポリシーの策定」および第9.2.3項「データのアウトフローの確認」を参照してください。

6. データベースおよびハードウェア・リソースを監視します。詳細は、第9.5.2項「セグメントおよびデータファイル領域の再利用」を参照してください。

9.4.3.2 中規模データベース・プロファイルの推奨事項

中規模データベース・プロファイルのインストールは、潜在的に増大化する可能性があります。このため、推奨事項は大規模プロファイルと同じになります。詳細は、第9.4.3.1項「大規模データベース・プロファイルの推奨事項」を参照してください。

本番環境の表のパーティション化では停止時間が必要になる可能性があるため、中規模のインストールでは厳密な品質保証テストを実行することが重要です。

唯一追加される推奨事項は、表の再作成スクリプト(TRSスクリプト)をパージの代替にできることです。これは、実際に中規模とされるデータベースのサイズ、およびメンテナンス・ウィンドウにおける停止時間の可用性に依存します。

TRSスクリプトの詳細は、第10.6項「オープン・コンポジット・インスタンスでの表の再作成およびデータベース領域の再利用」を参照してください。

9.4.3.3 小規模データベース・プロファイルの推奨事項

CPU、メモリー、ディスク領域が限定的な小規模インストールでは、シングル・スレッド・パージから開始し、その後パラレル・パージに移ります。

1. シングル・スレッド・パージを実行します。詳細は、第10.3.1項「ループされるパージ・スクリプト」を参照してください。

2. パラレル・パージを実行します。詳細は、第10.3.2項「dbms_schedulerを使用したパラレル・スクリプトでのループしたパージ」を参照してください。

1. シングル・スレッド・パージを実行していない場合は、パラレル・パージをテストする必要があります。

3. インフローおよびアウトフローを監視します。詳細は、第9.2.2項「保存ポリシーの策定」および第9.2.3項「データのアウトフローの確認」を参照してください。

4. データベースおよびハードウェア・リソースを監視します。詳細は、第9.5.2項「セグメントおよびデータファイル領域の再利用」を参照してください。

唯一追加される推奨事項は、TRSスクリプトをパージの代替にできることです。これは、実際に小規模とされるデータベースのサイズ、およびメンテナンス・ウィンドウにおける停止時間の可用性に依存します。

9.5 領域管理について

この項の情報の多くは、様々なOracle Database管理ガイドにも記載されています。ここに概要が記載された領域管理の概念およびコマンドは、Oracle SOA Suiteのパージ・スクリプトによる領域の再利用に関する誤解を解決します。領域を再利用するには、データベースのメンテナンス操作を実行する必要があります。

デフォルトでは、自動セグメント領域管理(ASSM)によってローカルで管理される表領域にOracle SOA Suiteスキーマが作成されます。したがって、アドバイスはすべてこの状況に限定しています。この項はすべてのデータベース領域管理機能の包括的なガイドを目指したものではありません。

9.5.1 データファイルのコンポーネントの概要

データファイルは、次のコンポーネントに分けることができます。

- セグメント: 特定タイプのデータベース・オブジェクトが格納されます。つまり、表は表セグメントに格納され、索引は索引セグメントに格納されます。

- エクステント: セグメント内のデータ・ブロックの連続したセットです。Oracleデータベースは、セグメントの領域を1つのエクステント単位に割り当てます。

- データ・ブロック: データベース・ブロックとも呼ばれ、データベース記憶域のI/Oの最小単位です。エクステントは複数の連続するデータ・ブロックから構成されます。

- 表領域: 1つ以上の物理データ・ファイルで構成されます。ローカル管理表領域では、データファイル・ヘッダー内に、データファイル本体の空き領域および使用済領域を追跡するためのビットマップが保持されています。各ビットは、1ブロック・グループに対応します。領域の割当てまたは解放時に、Oracleデータベースはビットマップ値を変更して、ブロックの新しいステータスを反映させます。

セグメント、エクステントおよびデータ・ブロックはすべて論理構造です。

図9-1は、論理記憶域と物理記憶域間の関係を示しています。

図9-1 論理記憶域と物理記憶域

9.5.1.1 セグメント最高水位標

領域を管理するため、Oracleデータベースはセグメント内のブロックの状態を追跡します。最高水位標(HWM)は、セグメント内のポイントで、これを超えるとデータ・ブロックがフォーマットされず、使用されないことになります。HWMと低いHWMとの間のブロックに空きがなくなると、HWMが右側に拡張されて、低いHWMも以前のHWMの場所まで拡張されます。図9-2に詳細を示します。データベースにデータが徐々に挿入されるにつれて、HWMは次第に右側へと拡張され、それに伴い、低いHWMもHWMに従って拡張されます。手動でオブジェクトを再構築、切捨て、縮小/割当て解除しないかぎり、HWMは再処理しません。

図9-2 HWM

9.5.2 セグメントおよびデータファイル領域の再利用

次の各項は、セグメントおよびデータ・ファイル領域の再利用に使用される一般的な技術について説明しています。

- 第9.5.2.1項「オンラインのセグメント縮小の実行」

- 第9.5.2.2項「未使用領域の割当て解除」

- 第9.5.2.3項「索引の結合および再構築」

- 第9.5.2.4項「表パーティションの削除」

- 第9.5.2.5項「セキュアなファイルのLOBの構成」

- 第9.5.2.6項「その他のデータベース管理方法」

9.5.2.1 オンラインのセグメント縮小の実行

パージ・スクリプトはデータベース・セグメント(表および索引)から行を削除し、データ・ブロック内の領域を解放して再利用できるようにしますが、一部の領域で小さすぎて再利用できない断片化も発生します。オンラインのセグメント縮小を実行することで、領域の断片化を解消でき、エクステントの再利用が可能になります。縮小操作によって、HWMを下回る空き領域を統合し、セグメントを圧縮できます。その後、HWMを移動してHWMを上回る領域を割当て解除します。

データ操作言語(DML)は、セグメント縮小のデータ移動フェーズでも発行できます。ただし、縮小操作の最後に領域が割当て解除される際は、短い時間ですがDML操作がブロックされます。索引は縮小操作中も維持され、使用可能な状態に保持されます。

セグメント・アドバイザは、オンラインのセグメント縮小を活用できるセグメントを識別できます。ただし、定期パージ後はOracle SOA Suiteセグメントの大半がオンラインの縮小操作の候補になります。セグメント・アドバイザの詳細は、『Oracle Database管理者ガイド』を参照してください。

一般的なオンラインのセグメント縮小手順は次のとおりです。

- 縮小コマンドを実行する目に、行移動を有効化する必要があります。

SQL> ALTER TABLE TABLE_NAME ENABLE ROW MOVEMENT;

- セグメントを縮小します。

SQL> ALTER TABLE TABLE_NAME SHRINK SPACE;

- COMPACT句を指定すると、セグメントの縮小操作を2つのフェーズに分割できます。COMPACTを指定すると、セグメント領域の断片化が解消され、行が圧縮されますが、HWMのリセットおよび領域の割当て解除は延期されます。大型の表では操作を2フェーズに分割すると便利で、割当て解除フェーズのDMLのブロックによる影響が減少します。
オフピーク時にCOMPACT句なしでSHRINK SPACEを再発行することで、第2フェーズを完了できます。

SQL> ALTER TABLE TABLE_NAME SHRINK SPACE COMPACT;

- CASCADE句を指定すると、オブジェクトのすべての依存セグメントにセグメントの縮小操作が拡張されます。たとえば、表セグメントの縮小時にCASCADEを指定すると、表のすべての索引も縮小されます。

SQL> ALTER TABLE TABLE_NAME SHRINK SPACE COMPACT CASCADE;

- 非常に大型の表の場合は、縮小を2フェーズで実行し、CASCADE句を使用しないことをお薦めします。最初にCOMPACT操作を実行すると、多くの場合はその前に基本LOBが圧縮されてから通常の縮小コマンドが実行され、未使用領域が再利用されます。

- オンラインのセグメント縮小は、以下を除くすべてのセグメント・タイプで使用できます。

- 索引構成表(IOT)マッピング表

- 行IDベースのマテリアライズド・ビュー

- ファンクション索引がある表

- セキュアなファイルのLOB

- 圧縮表

表9-8は、オンラインのセグメント縮小の例を示しています。

表9-8 オンラインのセグメント縮小の例

シナリオ

例

大型の表を2フェーズで縮小します。

SQL> ALTER TABLE TABLE_NAME ENABLE ROW MOVEMENT;
SQL> ALTER TABLE TABLE_NAME SHRINK SPACE COMPACT;
SQL> ALTER TABLE TABLE_NAME SHRINK SPACE;

表およびその依存セグメント(BASICFILE LOBセグメントを含む)をすべて縮小します。

SQL> ALTER TABLE TABLE_NAME SHRINK SPACE CASCADE;

BASICFILE LOBセグメントのみを縮小します。

SQL> ALTER TABLE TABLE_NAME MODIFY LOB (LOB_NAME)
(SHRINK SPACE);

パーティション化された表の単一パーティションを縮小します。

SQL> ALTER TABLE TABLE_NAME MODIFY PARTITION P1 SHRINK SPACE;

9.5.2.2 未使用領域の割当て解除

DEALLOCATE UNUSEDコマンドを使用すると、手動で未使用領域を割当て解除できます。このコマンドは、HWMを上回る未使用領域を解放します。オンラインのセグメント縮小でもHWMを上回る領域が解放されます。

SQL> ALTER TABLE TABLE_NAME DEALLOCATE;

オプションのKEEP句を使用して、表、索引、またはクラスタのセグメントに保持する領域量を指定します。

SQL> ALTER TABLE TABLE_NAME DEALLOCATE UNUSED KEEP INTEGER;
SQL> ALTER INDEX INDEX_NAME DEALLOCATE UNUSED KEEP INTEGER;

注意:

DBMS_SPACEパッケージのUNUSED_SPACEプロシージャは、HWMの位置、およびセグメント内の未使用領域量に関する情報を返します。ASSMを使用してローカルで管理されるセグメントでは、SPACE_USAGEプロシージャを使用して未使用領域に関するより精度の高い情報を取得します。(割当て解除された領域の確認にはDBA_FREE_SPACEビューを使用します。)

9.5.2.3 索引の結合および再構築

BTREE索引を再構築するかどうかは、データベース管理者によって見解が異なります。時間の経過とともにOracle SOA Suiteのパージ・スクリプトではOracle SOA SuiteのBTREE索引の大半で断片化が進むため、SQLパフォーマンスを維持するには再構築が必要になります。

パージ・スクリプトはクローズしたコンポジットのみを削除し、オープンのものは各索引のデータ・ブロック内に保持します。Oracle SOA Suiteの索引キーの多くは増大する一方であるため、データ・ブロックの空き領域は再利用されません。

SQL> ALTER INDEX INDEX_NAME REBUILD OR COALESCE

表9-9は、索引の結合および再構築に関するコストと利点を示しています。

表9-9 索引の結合と再作成に関するコストと利点

索引の再構築

索引の結合

索引を別の表領域に迅速に移動できます。

索引は別の表領域に移動できません。

高コスト: 多くのディスク領域を必要とします。

低コスト: 多くのディスク領域を必要としません。

新しいツリーを作成して、可能であればその高さを縮小します。

ツリーの同じブランチ内のリーフ・ブロックを結合します。

オリジナルの索引を削除せずに、記憶域パラメータと表領域パラメータを迅速に変更できる。

索引のリーフ・ブロックを迅速に解放できる。

索引の再構築の必要に対して有効な方法の1つに、グローバル・ハッシュ索引への変換があります。一方的に増加するキーをハッシュ化してデータ・ブロックにランダムに分散することによって、領域の再利用が改善されます。これ以外にもホットな索引ブロックのバッファ・ビジー待機の減少などの改善があります。しかし、Oracle SOA Suiteの索引のすべてが、変換に適しているわけではありません。Oracle FMW 11g R1 SOA with Oracle Database Real Application Clustersの評価を参照してください。

http://www.oracle.com/technetwork/database/availability/maa-fmw-soa-racanalysis-427647.pdf

9.5.2.4 表パーティションの削除

表のパーティションを削除すると、表データを一括削除して、領域を再利用できます。Oracle SOA Suite内では、削除が可能であることが確認されるまでパーティションを削除しないでください。詳細は、第10.4.5項「検証スクリプトの実行」を参照してください。

9.5.2.4.1 パーティションの削除

SQL> ALTER TABLE TABLE_NAME DROP PARTITION P1;

DROP PARTITION操作は時間が長くかかりますが、UPDATE INDEXES句を指定することで索引の再構築の必要を回避する価値があります。

パーティション化された表に対する表のメンテナンス操作の多くは、対応する索引または索引パーティションを無効化します(UNUSABLEとマーク)。索引全体または各パーティション(グローバル索引の場合)を再作成する必要があります。メンテナンス操作のALTER TABLE文でUPDATE INDEXESを指定すると、データベースでこのデフォルトの動作をオーバーライドできます。この句を指定すると、メンテナンス操作のDDL文の実行時に、データベースにより索引が更新されます。これによって、この項で説明した利点が得られます。

次の操作では、UPDATE INDEXES句がサポートされています。

- ADD PARTITION

- COALESCE PARTITION

- DROP PARTITION

- EXCHANGE PARTITION

- MERGE PARTITION

- MOVE PARTITION

- SPLIT PARTITION

- TRUNCATE PARTITION

状況によっては、問題に対処するために表9-10に示されたパーティション操作が必要になる場合があります。

表9-10 パーティションの操作

パーティションの操作

説明

表パーティションの縮小

SQL> ALTER TABLE TABLE_NAME MODIFY PARTITION P1 SHRINK
SPACE;

表パーティションの切捨て

SQL> ALTER TABLE ... TRUNCATE PARTITION

表パーティションの圧縮

SQL> ALTER TABLE TABLE_NAME MOVE PARTITION PART_NAME
TABLESPACE TABLESPACE_NAME NOLOGGING COMPRESS FOR
OLTP;

重要な制限事項

- オンラインのセグメント縮小は、圧縮表ではサポートされていません。

- セキュアなファイルのLOBには独自の圧縮方法があります。

- 圧縮技術によって、CPUリソースの使用量が増加します。

- 圧縮を有効化するようにパーティションを変更した場合、その変更は新規データにのみ適用されます。既存データを圧縮するには、パーティションを移動する必要があります。表パーティションを移動すると、新しい表領域を指定しない場合でも、古いパーティション・セグメントが削除され、新しいセグメントが作成されます。

9.5.2.5 セキュアなファイルのLOBの構成

セキュアなファイルとは、従来のLOBアクセスと比較して高速で優れた多数のファクタによってパフォーマンス上の利点を提供するLOB記憶域アーキテクチャです。セキュアなファイルは、現在は基本ファイルと呼ばれる以前のLOB記憶域アーキテクチャの完全なリライトです。

セキュアなファイルでは次の拡張機能がサポートされます。

- 非重複化: 同一のセキュアなファイル・データは1コピーのみ格納されます。

- 圧縮: 記憶域、I/O、Redoログおよび暗号化のオーバーヘッドを削減します。圧縮があるため、セキュアなファイルのLOBではオンラインのセグメント縮小コマンドがサポートされません。

- 暗号化

セキュアなファイルはOracle 11gデータベースで導入された比較的新しい機能であるため、提供されている最新のデータベース・パッチ・セットを適用して既知の問題を回避することをお薦めします。

9.5.2.5.1 セキュアなファイルの要件

セキュアなファイルを使用するには、次の設定が必要です。

1. COMPATIBLE初期化パラメータを11.0.0.0.0より大きく設定します。

SQL> show parameter COMPATIBLE;

2. DB_SECUREFILE初期化パラメータは、LOB記憶域に関するデータベースのデフォルトのアクションを制御します(PERMITTEDの場合のデフォルト)。

SQL> ALTER SYSTEM SET DB_SECUREFILE = 'ALWAYS';
SQL> SHOW PARAMETER DB_SECUREFILE

パラメータ

説明

ALWAYS

ASSM表領域内のすべてのLOBが、セキュアなファイルのLOBとして作成されます。ASSM以外の表領域のLOBは、明示的にセキュアなファイルと指定しないかぎり、基本ファイルのLOBとして作成されます。基本ファイル記憶域オプションは無視され、セキュアなファイルのデフォルトの記憶域オプションがすべての未指定オプションに使用されます。

FORCE

すべてのLOBがセキュアなファイルのLOBとして作成されます。LOBがASSM以外の表領域で作成されと、例外がスローされます。基本ファイル記憶域オプションは無視され、セキュアなファイルのデフォルトの記憶域オプションがすべての未指定オプションに使用されます。

PERMITTED

SECUREFILEキーワードが使用されたときにセキュアなファイルのLOB記憶域を有効化するデフォルト設定。デフォルトの記憶域メソッドはBASICFILEです。

NEVER

セキュアなファイルのLOBは許可されません。

IGNORE:

セキュアなファイルのLOBの作成が行われず、セキュアなファイルの記憶域オプションに関連するすべてのエラーが無視されます。

3. ASSMをサポートするように表領域を構成します。

SQL> SELECT SEGMENT_SPACE_MANAGEMENT FROM DBA_TABLESPACES WHERE TABLESPACE_NAME
= 'TABLESPACE_NAME';

9.5.2.5.2 セキュアなファイルの変換

デフォルトでOracle SOA Suiteの表を作成するリポジトリ作成ユーティリティ(RCU)も基本ファイルを作成します。ただし、SOAスキーマの作成時にはセキュアなファイルのLOBも作成できます。次のプロセスは、作成時にのみ使用されます。その他の場合については、第9.5.2.5.3項「セキュアなファイルの移行」を参照してください。

1. 要件に一致していること、およびDB_SECUREFILEデータベース初期化パラメータがALWAYSまたはFORCEに設定されていることを確認します。要件の詳細は、第9.5.2.5.1項「セキュアなファイルの要件」を参照してください。

2. 適切なOracle SOA SuiteのRCUユーティリティを実行して、スキーマを作成します。LOBは基本として定義されていますが、これはセキュアなファイルとして作成されます。基本ファイルのLOB記憶域パラメータは無視されます。
圧縮、非重複化および暗号化の拡張機能はデフォルトでは有効化されていません。

3. 次のコマンドを入力して、セキュアなファイルのLOB列で拡張機能が有効化されているかどうかを判定します。

SQL> SELECT TABLE_NAME, COLUMN_NAME, SECUREFILE, RETENTION, ENCRYPT,
COMPRESSION, DEDUPLICATION FROM DBA_LOBS;

RCUの使用直後に、拡張機能を有効化するALTERコマンドを実行する必要があります。

SQL> ALTER TABLE LOB_TABLE MODIFY LOB(LOB_COLUMN) (COMPRESS);
SQL> ALTER TABLE LOB_TABLE MODIFY LOB(LOB_COLUMN) (DEDUPLICATE);

注意:

圧縮、非重複化または暗号化は、CREATE TABLE文およびオンラインでの再定義によって有効化することをお薦めします。既存のデータの場合、これらの機能をALTER TABLE文を使用して有効化すると、表内のすべてのセキュアなファイルのLOBの読取り、変更、書込みが実行されます。これによって、長時間かかる可能性がある操作の際にデータベースで表のロックが発生します。したがって、移入済の表の変換についてはALTER表コマンドをお薦めできず、ロックの原因になります。

9.5.2.5.3 セキュアなファイルの移行

オンラインの再定義は、セキュアなファイルのLOBへの変換に推奨されるオンラインによる方法です。ただし、オフラインの方法も存在します。

- Create Table as Select (CTAS)スクリプト

- Insert Table as Select (ITAS)

- エクスポート/インポート

- TRSスクリプト
詳細は、第10.6項「オープン・コンポジット・インスタンスでの表の再作成およびデータベース領域の再利用」を参照してください。

オンラインでの再定義の利点

- 表またはパーティションをオフラインにする必要がありません。

- パラレル実行が可能です。

オンラインでの再定義の短所

- 表またはパーティション全体およびすべてのLOBセグメントと同じだけの追加記憶域が必要です。

- グローバル索引の再作成が必要です。

Redo生成の防止やパラレル実行など、オンラインでのREDFINITONパッケージの実行に関するベスト・プラクティスは、『Oracle Database SecureFilesおよびラージ・オブジェクト開発者ガイド』で、BasicFiles LOBからSecureFiles LOBへの列の移行に関する項を参照してください。

9.5.2.6 その他のデータベース管理方法

ここでは、データベース増分管理に利用できるその他の方法について説明します。

9.5.2.6.1 表の再作成スクリプト

TRSスクリプトは、オープンのコンポジットのみを選択するため、デフォルトでは指定の保存期間を超過したクローズ済のコンポジットがすべて削除されます。表および索引の再作成プロセスでも、領域の再編成および再利用が行われます。詳細は、第10.6項「オープン・コンポジット・インスタンスでの表の再作成およびデータベース領域の再利用」を参照してください。

9.5.2.6.2 TRUNCATE文

Truncate文では、すべての行が表から削除されます。したがって、Oracle SOA Suiteの本番環境では、これが実行されたり、必要になる可能性はほとんどありません。詳細は、第10.5項「表削除なしでの実行時表からのレコードの削除」を参照してください。

9.5.3 データファイルのサイズ変更

表領域の領域を使い果たした場合は、まずアプリケーション・エラーと手動の介入を回避するため、データファイルをAUTOEXTENDに設定します。

1. データファイルが自動拡張可能であるかを判定するには、DBA_DATA_FILESビューの列AUTOEXTENSIBLEを問い合せます。

SQL> SELECT AUTOEXTENSIBLE FROM DBA_DATA_FILES

2. ファイルの自動拡張は、データファイルの作成または変更時にAUTOEXTEND ON句を指定することによって指定します。

SQL> ALTER TABLESPACE TABLESPACE_NAME ADD DATAFILE '/U01/DATAFILE.DBF' SIZE 10M
AUTOEXTEND ON;

SQL> ALTER DATABASE DATAFILE '/U01/DATAFILE.DBF' AUTOEXTEND ON;

データファイルの初期割当てが過剰な場合、またはセグメントで過剰な増大が許可されている場合は、データファイルのサイズを変更できます。

1. データファイルのサイズを変更します。ただし、これは領域がセグメントによって使用されていないことを前提としています。

SQL> ALTER DATABASE DATAFILE '/U01/DATAFILE.DBF'' RESIZE 50M;

必ずしもファイルのサイズを指定した値まで縮小できるわけではありません。使用されれていると、データベースから次のエラーが返されます。

ORA-03297: file contains used data beyond requested RESIZE value

10 データベース増分の管理

この章では、大量のインスタンスを削除するパージ・スクリプトによるデータベースの増大化の管理方法、時間間隔によるレンジ・パーティション化が有効化されるスキーマを使用する表のパーティション化、表を削除することなく実行時の表のすべてのレコードを削除する切捨てスクリプト、およびオープン・コンポジット・インスタンスで表を再作成し、データベース領域を再使用する表作成スクリプト(TRSスクリプト)について説明します。

この章では、次の項目について説明します。

- 第10.1項「データベース増分の管理の概要」

- 第10.2項「パージおよびパーティション化の方法の開発」

- 第10.3項「パージ・スクリプトを使用した大量のインスタンスの削除」

- 第10.4項「コンポーネント表のパーティション化」

- 第10.5項「表削除なしでの実行時表からのレコードの削除」

- 第10.6項「オープン・コンポジット・インスタンスでの表の再作成およびデータベース領域の再利用」

- 第10.7項「Microsoft SQL Serverでのインスタンスのパージ」

注意:

表のパーティション化は高度なデータベース・タスクであるため、熟練したデータベース管理者(DBA)のみが実行する必要があります。

データベース増大問題に関する詳細は、第B.2項「パラレル・パージと表のパーティション化の問題」、第B.7.4項「表領域の拡張による実行時の問題の回避」および第B.7.5項「大量のトランザクションによるデータベース増大の問題の解決」を参照してください。

データベース増分管理戦略の詳細は、第9章「データベース増分管理戦略の策定」を参照してください。

10.1 データベース増分の管理の概要

Oracle SOA Suiteデータベースのデータ量が増加して非常に大きくなると、データベースのメンテナンスが困難になる場合があります。この課題に対処するため、データベースの増分管理には表10-1に示されるようにいくつかの方法が用意されています。

表10-1 データベース増分の戦略

環境

使用方法

関連項目

データベース内の行が100,000未満の小規模な開発インストール

Oracle Enterprise Manager Fusion Middleware Controlの「オプションを指定して削除」ボタン

第8.2項「アプリケーションのホーム・ページからの、SOAコンポジット・アプリケーション・インスタンスの監視と削除」および第8.3項「SOAインフラストラクチャ・レベルでの、SOAコンポジット・アプリケーション・インスタンスの監視と削除」

データベース内の行が100,000を超える小規模な開発インストール

ループしたパージ・スクリプト

第10.3項「パージ・スクリプトを使用した大量のインスタンスの削除」

1日当たり10GBのデータを生成し、かつ500GB未満のデータを保存する中規模のインストール

スケジュールされ、最適なスレッド数によるパラレル・パージ

第10.3項「パージ・スクリプトを使用した大量のインスタンスの削除」

1日に10GBを超えるデータを生成する、または500GBを超えるデータを保存する大規模なインストール

- パーティション化(頻度が低く長時間実行されるプロセス)。

- パラレル・パージとパーティション化の組合せ(数か月に広がる長期間実行プロセス)。たとえば、日次パージと月次のパーティション削除を実行します。

第10.3項「パージ・スクリプトを使用した大量のインスタンスの削除」

第10.4.1項「コンポーネント・データベース表のパーティション化」

第10.4項「コンポーネント表のパーティション化」

- テスト・シナリオの再作成および再実行の場合

- 本番のカスタマイズおよび新規ジョブ定義を保管できるように本番環境からのスキーマを保持する一方で、すべてのインスタンス・データを状態にかかわりなく切り捨てるようにするための、本番環境またはテスト環境クローンの作成

切捨てスクリプト

第10.5項「表削除なしでの実行時表からのレコードの削除」

インストールをより効率的なデータベース増分管理戦略に移行するための修正処理が必要で、重大なメンテナンス停止時間がある小規模なインストール

TRSスクリプト

第10.6項「オープン・コンポジット・インスタンスでの表の再作成およびデータベース領域の再利用」

Microsoft SQL Serverデータベース

ループしたパージ・スクリプト

第10.7項「Microsoft SQL Serverでのインスタンスのパージ」

10.2 パージおよびパーティション化の方法の開発

この項では、デハイドレーション・ストアのパージおよびパーティション化を行う場合に実行できる、アクション・プランの主なポイントを要約します。パージはあらゆるプランの根幹であり、データによって消費される領域が多すぎる場合、または別の理由でデータを削除する場合に実行します。

スキーマのサイズを削減するには、主に、次の3通りの戦略があります。

- パージ・スクリプト

- パージ・スクリプトおよびパーティション化(つまり、表パーティションの削除)

- すべての表のパーティション化

最初の2つの場合では、同じパージ・スクリプトが使用されます。パーティション化する場合でも、パーティション化された表をコメント・アウトするためにパージ・スクリプトを編集する必要があります。

パージ・スクリプトでは、BPEL表から行を削除するために標準のSQL DELETE文を使用します。ほとんどのサイトではこれで十分です。ただし、サイトによっては蓄積されたデータが多すぎて、パージ・スクリプトの実行時間が非常に長くなることがあります。このような場合は、パーティション化の方がより適切な解決策となります。ただし、パーティション化によって非常に多くのデータベース・メンテナンス作業が発生することがトレードオフとなります。また、パーティション化は高度な技術であり、知識のあるDBAが必要となります。一方、パージ・スクリプトは簡単に実行でき、かつ、DBAの専門的な知識を必要としません。

入力メッセージ、データベース増分率およびパージ・プロセスでパージされるデータ量の概要を確認します。入力レートとパージ・レートが同じである場合は、通常のパージで十分です。これ以外の場合、パーティション化を検討します。

パーティション化を使用する場合、ディスク領域を追加し、最終的にパーティションを削除することをお薦めします。ただし、このことによってディスク容量の管理や適切なパーティション・サイズの決定などの追加要件が発生します。パーティション化を使用し、かつ、ディスク領域を解放するためにパージ・スクリプトに依存することは避けてください。

10.3 パージ・スクリプトを使用した大量のインスタンスの削除

Oracle Enterprise Manager Fusion Middleware Controlで、SOAコンポジット・アプリケーションの「インスタンス」ページにある「オプションを指定して削除」ボタンを使用して数千のインスタンスを削除すると、時間がかかり、トランザクション・タイムアウトが発生する場合があります。かわりに、インスタンスを削除するためのパージ・スクリプトを使用します。パージ・スクリプトに関する次の詳細情報に注意してください。

- パージ・スクリプトは、完了したインスタンスまたはエラー状態の(失敗した)インスタンスを削除します。詳細は、第10.3.3項「パージの状態」を参照してください。

注意:

Oracle Mediatorのリシーケンサ表では、失敗したメッセージはパージされません。詳細は、第10.3.4項「Oracle Mediatorのリシーケンスされたメッセージのパージの状態」を参照してください。

- パージ・スクリプトは、処理中のインスタンスまたはリカバリ可能な(リカバリが必要な状態の)インスタンスを削除しません。

- パージ・スクリプトは、Oracle B2Bを除きすべてのOracle SOA Suite関連の表を削除します。Oracle SOA SuiteおよびOracle B2Bが同一インストールに配置されている場合、Oracle B2Bのパージ・スクリプトも必ず呼び出してください。Oracle SOA SuiteおよびOracle B2Bが別個のインストールに配置されている場合、それぞれの製品スキーマで適切なパージ・スクリプトのみを実行する必要があります。Oracle B2Bのパージの詳細は、『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』の「データのパージ」および「B2Bコマンドライン・ツール」を参照してください。

次の各項では、スクリプトを使用する方法の例を示します。

- 第10.3.1項「ループしたパージ・スクリプト」

- 第10.3.2項「dbms_schedulerを使用したパラレル・スクリプトでのループしたパージ」

- 第10.3.3項「パージの状態」

- 第10.3.4項「Oracle Mediatorのリシーケンスされたメッセージのパージの状態」

- 第10.3.5項「特定のSOAコンポジット・アプリケーションのインスタンスのパージ」

- 第10.3.6項「パージ・スクリプトの実行」

注意:

- IBM DB2データベースでは、パージ・スクリプトはサポートされません。リリース11gリリース1 (11.1.1.7)以降は、Microsoft SQL Server上のインスタンスのパージを可能にする新しいパージ・スクリプトが提供されています。詳細は、第10.7項「Microsoft SQL Serverでのインスタンスのパージ」を参照してください。

- 11.1.1.4よりも前のリリースで提供されたpurge_soainfra_oracle.sql PL/SQLパージ・スクリプトは非推奨になりました。このスクリプトの既存ユーザーである場合、11g リリース1 (11.1.1.4以上)のデータベースに対して使用を継続できます。ただし、11g リリース1 (11.1.1.4)から、このスクリプトは同梱されていません。11g リリース1 (11.1.1.4以上)に付属するパージ・スクリプトを使用することをお薦めします。

- 11g リリース1 (11.1.1.3)から11g リリース1 (11.1.1.4)以降にアップグレードする場合、パージ設定スクリプトは、必ず11.1.1.4以降のロケーション(最新のパージ詳細が格納されている)からそれぞれ実行します。アップグレードの詳細は、Oracle Fusion Middleware Oracle SOA Suite、WebCenterポータルおよびADFアップグレード・ガイドを参照してください。

10.3.1 ループしたパージ・スクリプト

マスター・パージ・スクリプトには、バッチによるパージを実行できるループ構文が含まれています。また、このスクリプトにはmax_runtimeパラメータを指定して、このパラメータの値を超過するとループが停止されるようにすることもできます。

マスター・スクリプトはSOAデータベース表のパージを実行します。delete_instancesプロシージャを使用してSOAデータベース表をパージできます。

注意:

パージするインスタンスが多い場合は、max_runtimeを高い値に設定します。この場合、スクリプトが終了するまでの待機時間が長くなることが予想されます。より短い時間でパージ・スクリプトを終了させるには、小さいバッチ・サイズを使用します。

10.3.1.1 delete_instancesプロシージャ

インスタンスを削除するにはdelete_instancesプロシージャを使用します。例10-1に構文を示します。

例10-1 delete_instancesプロシージャの構文

procedure delete_instances (
min_creation_date in timestamp,
max_creation_date in timestamp,
batch_size in integer,
max_runtime in integer,
retention_period in timestamp,
purge_partitioned_component in boolean
ignore_state in boolean
composite_name in varchar2
composite_revision in varchar2
soa_partition_name in varchar2
);

表10-2で、スクリプトのパラメータについて説明します。

表10-2 delete_instancesプロシージャのパラメータの説明

パラメータ

説明

min_creation_date

コンポジット・インスタンスの開始作成日。

max_creation_date

コンポジット・インスタンスの終了作成日。

batch_size

パージのループに使用されるバッチ・サイズ。デフォルト値は20000です。

max_runtime

パージ・スクリプトがループを終了する有効期限。デフォルト値は60です。この値は分で指定します。

retention_period

保存期間はBPELプロセス・サービス・エンジンによってのみ使用されます(作成時間パラメータの使用に追加して)。この機能は他のコンポーネントに拡張されません。

このパラメータは、cube_instance表のレコードをチェックして削除します。このパラメータの値はmax_creation_date以上である必要があります。デフォルト値はnullです。

BPELインスタンス(cube_instance)のmodify_dateに基づいてコンポジット・インスタンスを保存する場合は、保存期間を指定します。

この例では、BPELインスタンス表のmodify_date (コンポジットのcreated_dateとは異なる場合がある)は、フィルタ処理の第2レベルとして使用されています。

min_creation_date = 1st June 2011
max_creation_date = 30  June 2011
retention_period = 1st July 2011

これにより、コンポジットのcreation_timeが2011年6月1日から2011年6月30日の範囲にあり、cube_instanceのmodify_dateが2011年7月1日より前であるすべてのコンポジット・インスタンスが削除されます。

purge_partitioned_component

同じパージを起動して、パーティション化されたデータを削除できます。デフォルト値はfalseです。

ignore_state

trueに設定すると、指定された日付範囲内でオープンおよびクローズされたすべてのインスタンスがパージされます。第10.3.2項「dbms_schedulerを使用したパラレル・スクリプトでのループしたパージ」で説明されているパラレル・パージ・スクリプトではこのパラメータがサポートされません。デフォルト値はfalseです。

注意: オープン・インスタンスのパージは、システムを不整合状態にする可能性があるため、このパラメータは慎重に使用してください。

composite_name

SOAコンポジット・アプリケーションの名前。このパラメータをcomposite_revisionパラメータおよびsoa_partition_nameパラメータとともに使用すると、特定のSOAコンポジット・アプリケーションのインスタンスをパージできます。詳細は、第10.3.5項「特定のSOAコンポジット・アプリケーションのインスタンスのパージ」を参照してください。

composite_revision

SOAコンポジット・アプリケーションのリビジョン番号。

soa_partition_name

SOAコンポジット・アプリケーションが格納されているパーティション。

注意:

- retention_periodに値を指定しない場合、このプロパティの値はmax_creation_dateの値にデフォルトで設定されます(つまり、retention_periodがnullに等しい場合、retention_period = max_creation_date)。この結果は、第10.3.2項「dbms_schedulerを使用したパラレル・スクリプトでのループしたパージ」で説明されているスクリプト・パラメータにも適用されます。

- パージ・スクリプトのパージは、データベースと表内の既存行のみに制限されます。パージ・スクリプトでランタイム実行を調べる方法はありません。このため、パージ・スクリプトでアクティブな行が削除された直後に、(ignore_stateパラメータをtrueに設定して)自動リカバリを試行することが想定されます。このため、パージの実行後に行が作成されます。COMPOSITE_INSTANCE表の行はすでに削除されているため、この行は不確定のままになります。

10.3.2 dbms_schedulerを使用したパラレル・スクリプトでのループしたパージ

このスクリプトは、第10.3.1項「ループしたパージ・スクリプト」で説明したループしたパージ・スクリプトと機能的には同じです。ただし、このスクリプトはdbms_schedulerパッケージを使用して、それぞれがサブセット・データに作用する複数のパージ・ジョブを作成します。

SOAデータベース表をパージするには、次の手順を使用します。

注意:

複数のCPUを持つホストがある場合、パラレル・スクリプトを使用することが役立ちます。ただし、パラレル・スクリプトはオフピーク時にのみ有効化することをお薦めします。さらに、オフピーク時にデータをパージするとき、大量のデータをパージする前に索引を削除し、後で索引を追加して戻すことをお薦めします。これにより、パージ処理が高速化され、索引のバランスを維持できます。

10.3.2.1 パラレルでのdelete_instancesプロシージャ

インスタンスを削除するにはdelete_instancesプロシージャをパラレルで使用します。例10-2に構文を示します。

例10-2 パラレル構文でのdelete_instancesプロシージャ

PROCEDURE delete_instances_in_parallel (
min_creation_date in timestamp,
max_creation_date in timestamp,
batch_size in integer,
max_runtime in integer,
retention_period in integer,
DOP in integer
max_count integer,
purge_partitioned_component in boolean)
composite_name in varchar2
composite_revision in varchar2
soa_partition_name in varchar2

表10-3で、スクリプトのパラメータについて説明します。

表10-3 パラレルでのdelete_instancesプロシージャのパラメータの説明

パラメータ

説明

min_creation_date

コンポジット・インスタンスの開始作成日。

max_creation_date

コンポジット・インスタンスの終了作成日。

batch_size

パージのループに使用されるバッチ・サイズ。デフォルト値は20000です。

max_runtime

パージ・スクリプトがループを終了する有効期限。デフォルト値は60です。この値は分で指定します。

retention_period

保存期間はBPELプロセス・サービス・エンジンによってのみ使用されます(作成時間パラメータの使用に追加して)。デフォルト値はnullです。このパラメータの詳細は、表10-2を参照してください。

DOP

スケジュールするパラレル・ジョブの数を定義します。デフォルト値は4です。

max_count

処理される行数を定義します(削除される行数ではありません)。大規模なtemp表が作成され、データに基づいてパージするジョブがスケジュールされます。これはパージする行数の最大値であり、デフォルトで100万に設定されます。デフォルト値は1000000です。

purge_partitioned_component

同じパージを起動して、パーティション化されたデータを削除できます。デフォルト値はfalseです。

composite_name

SOAコンポジット・アプリケーションの名前。このパラメータをcomposite_revisionパラメータおよびsoa_partition_nameパラメータとともに使用すると、特定のSOAコンポジット・アプリケーションのインスタンスをパージできます。詳細は、第10.3.5項「特定のSOAコンポジット・アプリケーションのインスタンスのパージ」を参照してください。

composite_revision

SOAコンポジット・アプリケーションのリビジョン番号。

soa_partition_name

SOAコンポジット・アプリケーションが格納されているパーティション。

10.3.2.2 パラレル・スクリプトでのループしたパージの実行後のデッドロックの解決

パラレル・スクリプトでループしたパージを実行した後にいずれかのスレッドのスレッド・ログでデッドロック検出される場合があります。例10-3に詳細を示します。

例10-3 スレッド・ログのデッドロック・エラー

SOA_PURGE_LOG_THREAD1 (total of 4 threads)
17-JUL-2012 03:03:48
: Purge AUDIT_DETAILS. Error Code = -60, Error Message = ORA-00060: deadlock
detected while waiting for resource
17-JUL-2012 03:03:48
: ERROR(delete_inst_in_parallel_job. Error Code = -60, Error Message =
ORA-00060: deadlock detected while waiting for resource

デッドロック問題を解決するには、AUDIT_DETAILS表を再構築して、次のいずれかの値を大きくします。

- PCTFREEを大きくします(関連トランザクション・リスト(ITL)の割当てを拡大できるようにするため)。

- INITRANS (初期ITL)を大きくします。このオプションは、以下で説明します。

AUDIT_DETAILS表を拡大し、INITRANS値を増やす手順は次のとおりです。

1. 一時表を作成し、INITRANSの値を増やします(この例では名前AUDIT_DETAILS_TMPの表が作成されます)。

SQL> CREATE TABLE "PS6_SOAINFRA"."AUDIT_DETAILS_TMP"
(    "CIKEY" NUMBER(*,0),
"DETAIL_ID" NUMBER(*,0),
"BIN_CSIZE" NUMBER(*,0),
"BIN_USIZE" NUMBER(*,0),
"DOC_REF" VARCHAR2(300),
"BIN" BLOB,
"CI_PARTITION_DATE" TIMESTAMP (6)
) SEGMENT CREATION IMMEDIATE
PCTFREE 0 PCTUSED 1 INITRANS 4 MAXTRANS 255 NOCOMPRESS LOGGING
STORAGE(INITIAL 331350016 NEXT 1048576 MINEXTENTS 1 MAXEXTENTS 2147483645
PCTINCREASE 0 FREELISTS 6 FREELIST GROUPS 1 BUFFER_POOL DEFAULT FLASH_CACHE
DEFAULT CELL_FLASH_CACHE DEFAULT)
TABLESPACE "PS6_SOAINFRA"
LOB ("BIN") STORE AS BASICFILE (
TABLESPACE "PS6_SOAINFRA" ENABLE STORAGE IN ROW CHUNK 8192 PCTVERSION 0
CACHE
STORAGE(INITIAL 16384 NEXT 8192 MINEXTENTS 1 MAXEXTENTS 2147483645
PCTINCREASE 0 FREELISTS 1 FREELIST GROUPS 1 BUFFER_POOL DEFAULT FLASH_CACHE
DEFAULT CELL_FLASH_CACHE DEFAULT)) ;

SQL> INSERT /*+ APPEND */ into audit_details_TMP select * from audit_details;

SQL> COMMIT;

2. AUDIT_DETAILS表を削除します。

SQL> DROP TABLE PS6_SOAINFRA.AUDIT_DETAILS CASCADE CONSTRAINTS;

3. AUDIT_DETAILS_TMP一時表の名前をAUDIT_DETAILSに変更します。

SQL> ALTER TABLE PS6_SOAINFRA.AUDIT_DETAILS_TMP RENAME TO AUDIT_DETAILS;

4. AUDIT_DETAILSで一意索引を作成します。

SQL> CREATE UNIQUE INDEX "PS6_SOAINFRA"."AD_PK" ON "PS6_SOAINFRA"."AUDIT_ DETAILS" ("CIKEY", "DETAIL_ID");

5. 制約と主キーをAUDIT_DETAILSに追加します。

SQL> ALTER TABLE "PS6_SOAINFRA"."AUDIT_DETAILS" ADD CONSTRAINT "AD_PK" PRIMARY
KEY ("CIKEY", "DETAIL_ID") ENABLE;

10.3.3 パージの状態

次の状態のインスタンスは、パージ・スクリプトでパージされます。

- 正常に完了しました

- フォルト

- ユーザーによって終了されました

- 失効

- 不明(インスタンス・トラッキングが無効)

次のインスタンス状態のパージはサポートされていません。

- BPELプロセス・サービス・エンジン・レベルまたはSOAコンポジット・アプリケーション・レベルでのリカバリを保留中のインスタンス

- 実行中のインスタンス

このようなインスタンスをパージするには、まずパージ・スクリプトによってサポートされるインスタンス状態のいずれかに移行する必要があります。

10.3.4 Oracle Mediatorのリシーケンスされたメッセージのパージの状態

パージ・スクリプトには、Oracle Mediatorのリシーケンサ表(mediator_group_statusおよびmediator_resequencer_message)内の情報をパージするパージ・コマンドが含まれています。パージ・スクリプトを実行すると、次の情報がリシーケンサ表からパージされます。

- すべてのリシーケンサ・タイプの完了したメッセージと中断されたメッセージ

- 標準リシーケンサのタイムアウトしたメッセージ

- ベスト・エフォート・リシーケンサとFIFO(先入れ先出し)リシーケンサの準備完了状態のグループ(パージ可能な唯一のグループ)

フォルト・リカバリおよびメッセージ処理を完了できるようにするため、パージ・スクリプトは、リシーケンスされたすべてのメッセージ情報をパージするわけではありません。標準リシーケンサ・グループには、パージせずに残す必要がある情報も格納されます。パージ・スクリプトを実行しても、次の情報はパージされません。

- すべてのリシーケンサ・タイプの失敗したメッセージ

- すべてのリシーケンサ・タイプの実行中のメッセージ

- 標準リシーケンサのグループ情報

- ベスト・エフォート・リシーケンサとFIFOリシーケンサの準備完了以外の状態のグループ

注意:

Oracle Mediatorリシーケンサのパージ・スクリプトは、最初にメッセージをパージし、次にグループに移動します。mediator_resequencer_message表にグループのメッセージがある場合は、グループを削除できません。

前述の説明は、インスタンスのトラッキングが有効か無効かに関係なく、パージ・スクリプトのループ処理とパラレル処理の両方について記載しています。シーケンス・グループをパージする前に、グループに関連付けられているすべてのメッセージが処理されることを確認するチェックが実行されます。

次に、リシーケンサ表で使用されるグループ状態コードのリストを示します。

- 0: 準備完了

- 1: ロック

- 2: エラー

- 4: タイムアウト

- 6: グループ・エラー

次に、リシーケンサ表で使用されるメッセージ状態コードのリストを示します。

- 0: 準備完了

- 1: ロック

- 2: 完了

- 3: エラー

- 4: タイムアウト(無視されます)

- 5: 中断

10.3.5 特定のSOAコンポジット・アプリケーションのインスタンスのパージ

特定のSOAコンポジット・アプリケーションのインスタンスをパージし、その他のコンポジットのインスタンスはパージせずに残すことができます。このアクションを使用して、大量または保存期間が長い特性のために、特定のフローを他のフローより頻繁にパージできます。

パージ・スクリプトには、COMPOSITE_DNに基づいてパージするためのオプションが含まれています。COMPOSITE_DNをベースとするパージでは、composite_nameおよびcomposite_revisionパラメータとの併用がサポートされます。

このパージ・ロジックは、COMPOSITE_IDではなく、フロー(実行コンテキストID (ECID)) に基づいています。したがって、目的のCOMPOSITE_DN以外に、同じECIDを共有している他のコンポジットが削除されます。次に示すシナリオが発生する場合があります。

- コンポジット・インスタンスはクローズされますが、フローはオープンしたままになります。
コンポジットAがコンポジットBをコールするシナリオでは、パージにより、コンポジットAのインスタンスが削除の対象となります。ただし、コンポジットAのインスタンスがクローズされ、対応するコンポジットBのインスタンスがオープンしたままの場合があります。したがって、全体的なフローがオープン状態にあり、コンポジットAのインスタンスは(クローズしたとしても)パージされません。

- コンポジット・インスタンスがクローズされ、フローもクローズされます。
コンポジットAがコンポジットBを再度コールします。パージにより、コンポジットAのインスタンスが削除の対象となります。したがって、コンポジットAがクローズされ、コンポジットBもクローズされている場合は、フロー全体がクローズされているため、コンポジットAおよびBの両方のインスタンスがパージされます。

これらのシナリオにより、フローの一貫性が維持されます。

composite_nameおよびcomposite_revisionパラメータの詳細は、第10.3.1項「ループしたパージ・スクリプト」および第10.3.2項「dbms_schedulerを使用したパラレル・スクリプトでのループしたパージ」を参照してください。

10.3.6 パージ・スクリプトの実行

この項では、パージ・スクリプトを実行する方法について説明します。

パージ・スクリプトを実行するには、次の手順を実行します。

1. SQL*Plusで、データベースAS SYSDBAに接続します。

CONNECT SYS AS SYSDBA

2. 次のSQLコマンドを実行します。

GRANT EXECUTE ON DBMS_LOCK TO USER;
GRANT CREATE ANY JOB TO USER;

ここで、USERはスクリプトを実行するためのsoainfraアカウントです。これらの特権は、スクリプトを実行するために必要です。

3. MW_HOME/SOA_ORACLE_HOME/rcu/integration/soainfra/sql/soa_purgeディレクトリにあるメイン・パージ・スクリプトを実行することで、パージ・スクリプトをロードします。
パラレル・パージの場合、パラレル・パージによって生成されたジョブからのデバッグ・ログは、SOA_PURGE_DIRという名前のディレクトリに作成されるファイルに記録されます。このディレクトリはOracleデータベースからアクセスできる必要があります。

4. SOA_PURGE_DIRを作成し、soainfraユーザーに書込み権限を付与します。

mkdir -p /tmp/purgelog
CREATE OR REPLACE DIRECTORY SOA_PURGE_DIR AS 'SERVER_DIRECTORY'

ここで、SERVER_DIRECTORYは作成するディレクトリ('/tmp/purgelog/'など)です。ディレクトリ・パスを囲む一重引用符は必須です。

5. スクリプトをデバッグ・モードで実行する場合、common/debug_on.sqlを実行し、SQL*Plusでserveroutをonに設定します。このステップはオプションです。

SET SERVEROUTPUT ON

生成されたジョブからのログは、ステップ4で作成されたディレクトリに記録されます(ジョブごとに別のファイル)。残りのログはstdout(または構成された場合はスプール・ファイル)に表示されます。

パージには次の2つのオプションがあります。

- ループしたパージ

- パラレル・パージ

6. 次に示すようにパージ・スクリプトを実行します。両方のオプションに対して例を示します。

1. ループしたパージの場合

DECLARE

MAX_CREATION_DATE timestamp;
MIN_CREATION_DATE timestamp;
batch_size integer;
max_runtime integer;
retention_period timestamp;

BEGIN

MIN_CREATION_DATE := to_timestamp('2010-01-01','YYYY-MM-DD');
MAX_CREATION_DATE := to_timestamp('2010-01-31','YYYY-MM-DD');
max_runtime := 60;
retention_period := to_timestamp('2010-01-31','YYYY-MM-DD');
batch_size := 10000;
soa.delete_instances(
min_creation_date => MIN_CREATION_DATE,
max_creation_date => MAX_CREATION_DATE,
batch_size => batch_size,
max_runtime => max_runtime,
retention_period => retention_period,
purge_partitioned_component => false);
END;
/

2. パラレル・パージの場合

DECLARE

max_creation_date timestamp;
min_creation_date timestamp;
retention_period timestamp;
BEGIN

min_creation_date := to_timestamp('2010-01-01','YYYY-MM-DD');
max_creation_date := to_timestamp('2010-01-31','YYYY-MM-DD');
retention_period := to_timestamp('2010-01-31','YYYY-MM-DD');

soa.delete_instances_in_parallel(
min_creation_date => min_creation_date,
max_creation_date => max_creation_date,
batch_size => 10000,
max_runtime => 60,
retention_period => retention_period,
DOP => 3,
max_count => 1000000,
purge_partitioned_component => false);

END;

10.4 コンポーネント表のパーティション化

次のコンポーネントのランタイムおよびスキーマ・コードは、フロー作成日付列をトランザクション表に格納するように変更されました。

- Oracle BPEL Process Manager

- Oracle Mediator

- ヒューマン・ワークフロー

- Oracle B2B

- SOAインフラストラクチャ(コンポーネント・インスタンスを含む)

- Oracle BPM Suite

CPST_CREATED_DATE列には、インスタンス・トラッキング・コードによって移入されたフロー作成日時が含まれています。これは、正規化されたメッセージ・プロパティoracle.integration.platform.instance.CommonConstants.COMPOSITE_INSTANCE_CREATED_TIMEとして使用できます。

すべてのSOAコンポーネントは同じパーティション・キーでパーティション化されます。これらのパーティション化されたコンポーネントでは同じ時間範囲とパーティションIDが使用されます。

注意:

完全または部分的なパーティション化を実行する前に、パージ・スクリプトを実行してください。

10.4.1 コンポーネント・データベース表のパーティション化

Oracle SOA Suiteには、DBAがOracle RDBMSのパーティション化機能を活用できるように、パーティション・キーが備えられています。このアクションにより、スキーマ表を時間間隔に基づいてレンジ・パーティション化できます。これは、大規模な表のデータベース・メンテナンス・ウィンドウを短縮する必要がある場合に役立ちます。(この章では説明していませんが、これにより、パーティション化されたデータをアーカイブすることもできるようになります。)

Oracle SOA Suiteの表をパーティション化するタスクは、熟練したDBAが実行する必要があります。表のパーティション化はDBAのコア・スキルであるため、この章では表をパーティション化する方法について、手順を追った詳細な説明は行いません。ここでは、Oracle SOA Suiteのスキーマおよび関連するスクリプトに関する、DBA向けの知識と説明を提供します。DBAは、この知識を活用して、各自の環境での任意のパーティション化戦略をカスタマイズし、データベースのパフォーマンスに応じたチューニング・パラメータを組み込むことができます。チューニングは状況に応じて実施する必要があり、また、構成に1回変更を加えるのみでは完了しません。これは監視とチューニングの反復プロセスです。

この章で説明するパーティション・スキームは、Oracle SOA Suite 11gリリース1 (11.1.1.4以降)でのみ使用できます。

次のコンポーネントは、コンポーネント独自のデータベース・スキーマに関連付けられています。

- Oracle BPEL Process Manager

- Oracle Mediator

- ヒューマン・ワークフロー

- Oracle B2B

- SOAインフラストラクチャ

- Oracle BPM Suite

表のパーティション化の詳細は、次のURLにあるOracleデータベース管理ドキュメント・ライブラリを参照してください。

http://www.oracle.com/technetwork/indexes/documentation/index.html

注意:

- DBAは、特に、ラージ・オブジェクト(LOB)セグメントがある表について、ハッシュ・サブパーティションの適用を検討することがあります。これは最高水位(HW)エンキューの競合への対応に役立つ場合があります。

- 単調に増加する主キー(CIKEYなど)に対してグローバル・ハッシュ索引を使用すると、ブロックの競合が緩和されることがあります。

10.4.1.1 参照整合性および同一レベル・パーティション化

パフォーマンス上の理由から、Oracle BPEL Process Manager、Oracle Mediator、ヒューマン・ワークフロー、Oracle B2B、SOAインフラストラクチャおよびOracle BPM Suiteスキーマでは、整合性を強制するための外部キー制約がありません。このことには、参照パーティション化と呼ばれる11gのRDBMS機能を使用することが考慮されています。この機能は、外部キー制約を横断して、マスター表と詳細表の同一レベル・パーティション化を行うことによって、大きな利点をもたらします。同一レベル・パーティション化とは、関連する依存表の行が、マスター表の行と同じパーティション・キー間隔を持つ、1つのデータベース・パーティションに存在することを意味します。

この機能には、同一レベル・パーティション内の各詳細行の状態(完了、フォルトなど)について、その行に関連するマスター表の行から推測できるという利点があります。

11g RDBMSの参照パーティション化機能は使用できませんが、類似した動作を模倣して、いくつかの同じ利点を得ることができます。Oracle BPEL Process Manager、Oracle Mediator、ヒューマン・ワークフロー、Oracle B2B、SOAインフラストラクチャおよびOracle BPM Suiteのコンポーネントでは、詳細表の各行のパーティション・キーが、マスター表の行のパーティション・キーと同じであることが保証されます(つまり、詳細表でも日付(タイムスタンプ)がパーティション・キーとなります)。この場合、設定を完了するために、DBAはマスター表と詳細表が同じ間隔でレンジ・パーティション化されていることを確認する必要があります。この章の後の各項で、いくつかの例を示します。

注意:

実際のサイトでは、古いパーティションについては参照整合性を考慮する必要がないと判断することがあります。例として、サイトに十分なディスク領域があるために、古いデータを格納することが許容されている場合や、参照されないデータを依存表に保管しておいても、特に悪影響がない場合をあげることができます。

10.4.1.2 パーティション・キーの選択の概要

スキーマのパーティション・キーを選択する場合は、次の要素を考慮します。

- 参照整合性の状態(完了など)を伝達するか、または暗黙的に示すこと

- メンテナンス操作のための、時間間隔でのレンジ・パーティション化が可能であること

- 参照されないデータが生じる可能性がある行の移動を回避するために静的であること

- 表のメンテナンス操作を実行する場合に行が移動されないように、静的であること

- パーティション・プルーニングによってコンソール問合せに対するパフォーマンス上の利点がもたらされること

10.4.2 パーティションの構成

パーティション化は、デフォルトでは構成されていません。手動で実行する必要があるインストール後ステップです。データベースのパーティション化を実装することにした場合は、いくつかの初期構成タスクを1回のみ実行する必要があります。

- この章の情報に従がって、パーティション化するグループを決定します。

- それらのグループごとに、パーティション化する必要がある各グループに一部の必須表があることを念頭に、パーティション化する表を決定します。

- グループごとに、パーティション間隔を決定します。

- Oracle SOA Suiteスキーマをパーティション化するパーティション・スクリプトを作成します。スクリプトは提供されないため、各DBAに、各自の環境に適したパーティション・スクリプトを作成する責任があります。

- パージ・スクリプトを編集し、パーティション化した表への参照を削除します。

10.4.3 検証スクリプトの概要

パーティションおよび同一レベル・パーティション化された依存表を削除するタイミングを識別するために、DBAには検証スクリプトが提供されています。この検証スクリプトでは、長時間実行されているアクティブなインスタンスの存在も識別されます。その後、これらのインスタンスを別のパーティションに移動し、元のパーティションを削除できます。

注意:

検証スクリプトではパーティションが削除できることを確認するのみであり、パーティションを削除しません。

10.4.4 コンポーネント表

この項では、パーティション化の制約について説明し、コンポーネント表、コンポーネント表が属するグループおよびそのパーティション・キーのリストを示します。

10.4.4.1 パーティション化の制約

次に示す表のパーティション化の制約に注意してください。

- パーティション化のアプローチには、次の選択肢があります。

- 完全なパーティション化: サービス・コンポーネント/サービス・エンジンのすべての表をパーティション化します。

- パーティション化なし: サービス・コンポーネント/サービス・エンジンの表をパーティション化しません。

- 部分的なパーティション化: パーティション化を増加率が高い特定の表に制限します。表10-4に、パーティション化可能なマスター表および依存表を示します。

表10-4 部分的なパーティション化

マスター表

マスター表の依存表

COMPOSITE_INSTANCE

REFERENCE_INSTANCE

CUBE_INSTANCE

CUBE_SCOPE

XML_DOCUMENT

なし

MEDIATOR_INSTANCE

MEDIATOR_CASE_INSTANCE

MEDIATOR_PAYLOAD

なし

表10-4のいずれの表も、次の制限に従ってパーティション化できます。

- 依存表をパーティション化する場合は、そのマスター表もパーティション化する必要があります。

- すべての表は、同じ日付範囲と同じ名前に従って同一レベル・パーティション化される必要があります。

- COMPOSITE_INSTANCE表は、常にパーティション化します。いずれかのコンポジットの「監査レベル」プロパティが「開発」または「本番」に設定されている場合、この制約は必須です。検証スクリプトは、そのパーティション内のアクティブなコンポジット・インスタンスに基づいて、アクティブなフローをチェックします。したがって、COMPOSITE_INSTANCE表がパーティション化されていない場合、すべての表の同一レベル・パーティション化に基づく全体検証スクリプト・ロジックは機能しません。

- グループやコンポーネントに関係なく、パーティション化されたすべての表では、同じ時間範囲およびパーティションIDが使用されます。

10.4.4.2 コンポーネント表、レンジ・パーティション・キーおよびグループ

表10-5から表10-10までは、3つのグループに分けられます。

- グループ1: コンポジットのエンドツーエンド・フロー・トレースに直接関係する表が含まれます。表の大多数がこのグループに該当します。

- グループ1A: フロー・トレースに直接関係しない表の小規模なセットが含まれます(REJECTED_MESSAGEなど)。

- グループ2: グループ1とグループ1Aの表の複数の表に依存する表の小規模なセットが含まれます。グループ2の検証スクリプトを実行する前に、まず、グループ1の検証スクリプトを実行して、グループ1のパーティションを削除する必要があります。

注意:

グループ1と1Aは、検証スクリプト内で結合されています。検証スクリプトを実行する際に、この分類に関する知識は必要ありません。

表10-5 コンポーネント: SOAインフラストラクチャ

表

レンジ・パーティション・キー

グループ

COMPOSITE_INSTANCE

PARTITION_DATE

1

REFERENCE_INSTANCE

CPST_PARTITION_DATE

1

COMPOSITE_INSTANCE_FAULT

CPST_PARTITION_DATE

1

COMPOSITE_SENSOR_VALUE

CPST_PARTITION_DATE

1

COMPONENT_INSTANCE

CPST_PARTITION_DATE

1

REJECTED_MESSAGE

CREATED_TIME

1A

REJECTED_MSG_NATIVE_PAYLOAD

RM_PARTITION_DATE

1A

INSTANCE_PAYLOAD

CREATED_TIME

2

COMPOSITE_INSTANCE_ASSOC

CREATED_TIME

2

表10-6 コンポーネント: Oracle BPEL Process Manager

表

レンジ・パーティション・キー

グループ

CUBE_INSTANCE

CPST_INST_CREATED_TIME

1

CI_INDEXES

CI_PARTITION_DATE

1

CUBE_SCOPE

CI_PARTITION_DATE

1

DOCUMENT_CI_REF

CI_PARTITION_DATE

1

AUDIT_TRAIL

CI_PARTITION_DATE

1

AUDIT_DETAILS

CI_PARTITION_DATE

1

DLV_SUBSCRIPTION

CI_PARTITION_DATE

1

WORK_ITEM

CI_PARTITION_DATE

1

AUDIT_COUNTER

CI_PARTITION_DATE

1

WI_FAULT

CI_PARTITION_DATE

1

DLV_MESSAGE

RECEIVE_DATE

1A

HEADERS_PROPERTIES

DLV_PARTITION_DATE

1A

DOCUMENT_DLV_MSG_REF

DLV_PARTITION_DATE

1A

XML_DOCUMENT

DOC_PARTITION_DATE

2

表10-7 コンポーネント: Oracle Mediator

表名

レンジ・パーティション・キー

グループ

MEDIATOR_INSTANCE

COMPOSITE_CREATION_DATE

1

MEDIATOR_CASE_INSTANCE

MI_PARTITION_DATE

1

MEDIATOR_CASE_DETAIL

MI_PARTITION_DATE

1

MEDIATOR_AUDIT_DOCUMENT

MI_PARTITION_DATE

1

MEDIATOR_DEFERRED_MESSAGE

CREATION_DATE

1A

MEDIATOR_PAYLOAD

CREATION_TIME

2

表10-8 コンポーネント: ヒューマン・ワークフロー

表

レンジ・パーティション・キー

グループ

WFTASK

COMPOSITECREATEDTIME

1

WFTask_TL

COMPOSITECREATEDTIME

1

WFTaskHistory

COMPOSITECREATEDTIME

1

WFTaskHistory_TL

COMPOSITECREATEDTIME

1

WFComments

COMPOSITECREATEDTIME

1

WFMessageAttribute

COMPOSITECREATEDTIME

1

WFAttachment

COMPOSITECREATEDTIME

1

WFAssignee

COMPOSITECREATEDTIME

1

WFReviewer

COMPOSITECREATEDTIME

1

WFCollectionTarget

COMPOSITECREATEDTIME

1

WFRoutingSlip

COMPOSITECREATEDTIME

1

WFNotification

COMPOSITECREATEDTIME

1

WFTaskTimer

COMPOSITECREATEDTIME

1

WFTaskError

COMPOSITECREATEDTIME

1

WFHeaderProps

COMPOSITECREATEDTIME

1

WFEvidence

COMPOSITECREATEDTIME

1

WFTaskAssignmentStatistic

COMPOSITECREATEDTIME

1

WFTaskAggregation

COMPOSITECREATEDTIME

1

表10-9 コンポーネント: Oracle B2B

表

レンジ・パーティション・キー

グループ

B2B_BUSINESS_MESSAGE

CPST_INST_CREATED_TIME

1

B2B_APP_MESSAGE

CPST_INST_CREATED_TIME

1

B2B_WIRE_MESSAGE

CPST_INST_CREATED_TIME

1

B2B_DATA_STORAGE

CPST_INST_CREATED_TIME

1

B2B_EXT_BUSINESS_MESSAGE

CPST_INST_CREATED_TIME

1

表10-10 コンポーネント: Oracle BPM Suite

表

レンジ・パーティション・キー

グループ

BPM_AUDIT_QUERY

CI_PARTITION_DATE

1

BPM_MEASUREMENT_ACTIONS

CI_PARTITION_DATE

1

BPM_MEASUREMENT_ACTION_EXCEPS

CI_PARTITION_DATE

1

BPM_CUBE_AUDITINSTANCE

CIPARTITIONDATE

1

BPM_CUBE_TASKPERFORMANCE

CIPARTITIONDATE

1

BPM_CUBE_PROCESSPERFORMANCE

CIPARTITIONDATE

1

10.4.5 検証スクリプトの実行

DBAがパーティションおよび同一レベル・パーティション化された依存表を削除するタイミングを識別するための検証スクリプトが提供されています。検証スクリプトは、MW_HOME/SOA_ORACLE_HOME/rcu/integration/soainfra/sql/verifyにあります。

検証スクリプトを実行する手順は次のとおりです。

1. SQLコマンドPART_DIRでディレクトリを作成します。例:

CREATE DIRECTORY PART_DIR AS '/tmp/verify'

2. soainfraユーザーにこのディレクトリの書込み権限を付与します。ログおよびSQLファイルはこのディレクトリに生成されます。

3. 次のストアド・プロシージャをコールして、一時表を削除します。これは、アクティブなインスタンスが行移動スクリプトによって処理される一時表のセットで取得されるためです。
グループ1の場合:

DECLARE
BEGIN
verify_soa.trunc_verify1_temp_tables;
END;

グループ2の場合:

DECLARE
BEGIN
verify_soa.trunc_verify2_temp_tables;
END;

4. ストアド・プロシージャの実行には、クライアント・スクリプトsoa_exec_verify.sqlを使用できます。soa_exec_verify.sqlを編集し、検証が必要なパーティション名を配列mySoa_drv_listに入力します。

1. 関数verify_soa.verify_1を実行するには、パラメータとして1を渡します。

2. 関数verify_soa.verify_2を実行するには、パラメータとして2を渡します。

5. PART_DIRディレクトリに生成されるログおよびSQLファイルを確認します。

注意:

検証スクリプトは、ビジネス・ルールには用意されていません。

10.4.6 パーティションの検証と削除

パーティションを検証して削除するには、次の手順を実行します。

1. 関数verify_soa.verify_1を実行します。

2. PART_DIRフォルダのSOA_PARTITION_NAME_LOG_1という名前のログ・ファイルにエラーがないかチェックします。長時間実行されているアクティブなインスタンスがある場合は、第10.4.7項「別のパーティションへの長時間実行されているアクティブなインスタンスの移動」を参照してください。

3. PART_DIRフォルダに生成されたSOA_PARTITION_NAME_RESULT_1.sqlという名前のスクリプトを使用して、削除可能なパーティションを削除します。

4. verify_soa.verify_2を実行します。

5. PART_DIRフォルダのSOA_PARTITION_NAME_LOG_2という名前のログ・ファイルにエラーがあるかどうかをチェックします。

6. PART_DIRフォルダに生成されたSOA_PARTITION_NAME_RESULT_2.sqlという名前のスクリプトを使用して、削除可能なパーティションを削除します。

注意:

Oracle B2B表に外部キー制約が存在することによって発生する問題があります。パーティションを削除する場合にB2Bパーティションのパージが起動されるとき、パーティションを削除する前に外部キー制約を無効化し、後で有効化する必要があります。このアクションを実行するには、前述の手順の適切なステップで、PL/SQLプロシージャb2b_disable_constraintsおよびb2b_enable_constraintsを実行する必要があります。これらのプロシージャでは外部キーが有効化および無効化されるため、稼働中のシステムでは実行しないことをお薦めします。

10.4.7 別のパーティションへの長時間実行されているアクティブなインスタンスの移動

この検証スクリプトでは、パーティション内にアクティブなインスタンスが存在するかどうかが確認されます。アクティブなインスタンスがない場合は、パーティションを削除できます。しかし、パーティションには長時間実行されているアクティブなインスタンスが存在することがあります。これらのアクティブなインスタンスがあると、パーティションは削除されません。この問題を回避するために、長時間実行されているインスタンスを別のパーティションに移動できます。

Oracleデータベースには、パーティション間での行の移動を有効または無効にするためのオプションが用意されています。パーティション表を作成または変更する際は、行移動句(ENABLE ROW MOVEMENTまたはDISABLE ROW MOVEMENTのいずれか)を指定できます。この句は、キーが更新された場合の新しいパーティションへの行の移動を有効または無効にします。このオプションによって、パーティションの削除を阻止する長時間実行されているプロセスを処理できます。

検証スクリプトでは、合計インスタンス数、オープン・インスタンス数およびパーティション内のオープン・インスタンスの割合が提供されます。この情報に基づいて、行移動プロシージャの実行が選択可能になります。これによりターゲット表のパーティション・キーが更新され、これらのインスタンスの別のパーティションへの行移動が順に開始されます。パーティション化されたすべての表からアクティブなインスタンスすべてが別のパーティションに移動した後は、ターゲット・パーティションを削除できます。

注意:

- 長時間実行されているアクティブなトランザクションには、個別のパーティションを作成してください。次に、そのパーティションの範囲に該当するnew_partition_dateを指定することで、現在のパーティションから新規のパーティションに、これらのインスタンスを移動できます。これらの長時間実行されているインスタンスには、定期的なパージを実行することをお薦めします。

- 行移動には、複数の行に負荷の高い更新が発生します。行の移動はアクティブなプロセス数が少ない場合にのみ実施してください。検証スクリプトによりアクティブなインスタンス数が提供されますが、依存表の多くにマスター表との多対1の関係があります。これは、大規模な一連の行がパーティション間で移動することになります(依存表もパーティション化されている場合)。パーティション化された表、パーティションのアクティブ・インスタンス、データ形状および使用可能なインフラストラクチャ設定に基づいて、個別の行移動を使用してください。

- パーティション・キーが頻繁に更新される場合は、パーティション間での行移動を有効にすると、実行時のパフォーマンスが大幅に低下する可能性があります。一方、Oracle SOA Suiteのデータベース表のパーティション・キー列は、作成後に変更されることはありません。したがって、実行時に行移動は発生しません。

長時間実行されているインスタンスを別のパーティションに移動する手順は、次のとおりです。

1. グループ1の検証スクリプトを実行します。このスクリプトの説明は、第10.4.5項「検証スクリプトの実行」を参照してください。

2. ログ・スクリプトをチェックして、パーティションの削除を阻止するアクティブなインスタンスがあるかどうかを確認します。

3. 行移動プロシージャを実行します。ステップ2のログに基づいて、オープン・インスタンス数をチェックします。この件数に基づいて、行移動スクリプトを実行するか、パーティションの削除を延期するかを判断します。

1. SQL*PlusにSOAINFRAユーザーとしてログインします。

CONNECT SOAINFRA/password

2. 次のPL/SQLプロシージャを実行して、グループ1の表の行を移動します。

SQL> PROCEDURE exec_row_movement_1( partition_name in varchar2,
new_partition_date in timestamp );

説明:

partition_nameは、行移動を実行するパーティションの名前です。

new_partition_dateは、パーティション・キー列を更新する新しい日付です。

4. 第10.3.6項「パージ・スクリプトの実行」の説明に従って、パージ・スクリプトを実行してパーティション化されていない表を削除します。パージ・プロシージャのpurge_partitioned_componentパラメータは、falseに設定する必要があります。

5. グループ1のパーティションを(ステップ3に基づいて)削除します。

6. グループ2の検証スクリプトを実行します。

7. パーティションの削除を妨げるアクティブなインスタンスがあるかどうかを確認します。

8. 行移動プロシージャを実行します。ステップ7のログに基づいて、オープン・インスタンス数をチェックします。この件数に基づいて、行移動スクリプトを実行するか、パーティションの削除を延期するかを判断します。

1. SQL*PlusにSOAINFRAユーザーとして復帰します。

CONNECT SOAINFRA/password

2. 次のPL/SQLプロシージャを実行して、グループ2の表の行を移動します。

SQL> PROCEDURE exec_row_movement_2( partition_name in varchar2,
new_partition_date in timestamp );

説明:

partition_nameは、行移動を実行するパーティションの名前です。

new_partition_dateは、パーティション・キー列を更新する新しい日付です。

9. グループ2のパーティションを(ステップ8に基づいて)削除します。

10.4.8 コンポーネントの部分的なパーティション化

一部のコンポーネントがパーティション化され、他のコンポーネントがパーティション化されていない環境の場合、パーティション化されていないデータ・セットは、第10.3項「パージ・スクリプトを使用した大量のインスタンスの削除」で説明したパージ・スクリプトを使用してパージする必要があります。

たとえば、ヒューマン・ワークフローがパーティション化されておらず、他のコンポーネントがパーティション化されているとします。検証スクリプトでは、すべてのSOAパーティションがパーティションの削除コマンドを使用して削除可能とレポートされます。ただし、ヒューマン・ワークフローの各表は、ループ/パラレル・パージ・スクリプトを使用してデータがパージされるまで、引続きワークフロー・データを保持します。

10.5 表削除なしでの実行時表からのレコードの削除

切捨てスクリプトを使用すると、表を削除することなくすべてのOracle SOA Suite実行時表からすべてのレコードを削除できます。切捨てスクリプトでは、データベース領域の再利用はできません。

切捨てスクリプトは、次のシナリオで役立ちます。

- 本番のカスタマイズおよび新規ジョブ定義を保管できるように本番環境のスキーマを保持する一方で、SOAインフラストラクチャ内(つまりクローン・データベース内)のすべてのインスタンス・データを状態にかかわりなく切り捨てる必要がある状況で、本番環境またはテスト環境クローンを作成する場合。

- テスト・シナリオの再作成および再実行を必要とするテストでの使用。

切捨てスクリプトは、次のコンポーネントのすべての実行時表を対象とする切捨て文を含めることによって、このオプションを提供します。

- Oracle BPEL Process Manager

- Oracle Mediator

- ビジネス・ルール

- Oracle B2B

- SOAインフラストラクチャ

- Oracle BPM Suite

表を削除することなく実行時表からレコードを削除する手順は次のとおりです。

1. SQL*Plusを起動します。

sqlplus

2. SQL*Plusで、SOAINFRAユーザーとしてデータベースに接続します。

CONNECT SYS AS SOAINFRA

3. MW_HOME/SOA_ORACLE_HOME/rcu/integration/soainfra/sql/truncateディレクトリにある切捨てスクリプトを実行します。

SQL> @truncate_soa_oracle.sql

10.6 オープン・コンポジット・インスタンスでの表の再作成およびデータベース領域の再利用

一部のOracle SOA Suite環境では、パージ・スクリプトでデータベース領域の再利用できるだけの十分な数のコンポジット・インスタンスを削除できない場合があります。これによりパフォーマンスの問題が発生する可能性があります。次のタスクを実行するために、表の再作成スクリプト(TRSスクリプト)が用意されています。

- 指定した保存ポリシーを考慮して、クローズしたすべてのコンポジット・インスタンスを削除します。

- オープン・コンポジット・インスタンスのみを保持して、Oracle SOA Suiteの表を再作成します。

- データベース・セグメント(表および索引)を縮小または再構築することなく、過剰に増大したデータベース表にただちに領域を再利用します。

クローズしたすべてのコンポジット・インスタンスの削除および領域の再編成と再利用が単一の手順で実行されます。

TRSスクリプトを使用すると、データベース増分戦略を適切な状態に戻すことができます。TRSスクリプトは、Oracle SOA Suiteスキーマ表で、ループまたはパラレル・スクリプトによってパージが行われていないことなどが原因で過剰な増大が発生した場合に、インストールでの領域の再利用を可能にするために提供されています。領域の再利用にTRSスクリプトが使用された場合は、適切なパージおよびパーティション化戦略を実装してデータベースの増大を管理する必要があります。TRSスクリプトは修正処理を目的として提供されるもので、パージ・スクリプトに置き換わるものではありません。

TRSスクリプトは、オープン・コンポジットおよびサービス・コンポーネントのデータを保持し、指定された保存ポリシーを優先します。また、TRSはオンサイトのOracle SOA Suiteスキーマから表を再作成するDDLスクリプトを生成するため、オンサイトのカスタマイズは保持されます。(オンサイトのデータベース管理者と協力してDDLの解析およびテストを実行することは不可欠です。)

TRSは次の2つのフェーズで実行されます。

- フェーズ1: 表の再構築時に無視(削除)するクローズしたコンポジットおよびサービス・コンポーネントのIDが格納される一時表のセットへの移入を行います。このフェーズでは、表を再構築するためのDDLスクリプトも生成されます。

- フェーズ2: 生成されたDDLスクリプトを実行して、指定されたOracle SOA Suiteの表を再作成します。このスクリプトは、実行前に解析およびテストを行う必要があり、カスタマイズが可能です。フェーズ2の前後には、データベースのバックアップが必要です。

10.6.1 TRSスクリプトの使用に関する考慮事項

次の要件を確認して、対象のOracle SOA Suite環境にTRSスクリプトが適合するかどうかを判定します。

注意:

TRSスクリプトを使用する前に、まず第10.3項「パージ・スクリプトを使用した大量のインスタンスの削除」で説明されているOracle SOA Suiteのパージ・スクリプトを調整および使用する必要があります。

- TRSスクリプトは修正処理の実行を目的として提供されるもので、パージ・スクリプトに置き換わるものではありません。修正処理とは、ご使用のインストールをより効率的なデータベース増分管理戦略に移行するための処理です。これには、レンジ・パーティション化表、パージ戦略がないことが原因で過剰に増大した各表のサイズの縮小が含まれます。TRSスクリプトは、ご使用のOracle SOA Suite環境を適切な状態に戻すためにのみ使用してください。パージ・スクリプトでの処理が最適になるように増分管理戦略を策定する必要があります。調整後は、インスタンスの削除の第1の方法としてパージ・スクリプトの使用に戻してください。

- TRSスクリプトは、直接パス挿入、パラレル問合せスレーブ、およびロギングなしの実装を行いますが、パージ・スクリプトより時間がかかると予測されます。パージ・スクリプトは、クローズしたコンポジットのサブセットのみを削除しますが、TRSはクローズしたコンポジットのすべてを削除します。TRSスクリプトは、パージ・スクリプトの場合と同様にコンポジットの解析を行う必要がありますが、これはすべてのコンポジットに対して実行されます(保存期間は考慮されます)。

- TRSスクリプトは、表の再作成(削除/作成/挿入)が必要であるため、Oracle SOA Suiteのダウンタイムが必要になります。これが、TRSスクリプトがパージ・スクリプトの代替にはならない理由です。インストールの多くは、24時間-7日間で、短時間のメンテナンス・ウィンドウで稼働し、Oracle SOA Suiteデータベースの増大の完全メンテナンスを行うこれらのスクリプトの使用は想定されません。

- 領域の再利用が緊急でなく、SOA表のレンジ・パーティション化や構造の変更が必要な場合は、TRSオプションが最適なオプションではない可能性があります。特定の表内のすべて(クローズおよびオープン)コンポジットをコピーするプレーンCTAS (CREATE TABLE AS SELECT)、またはITAS (INSERT TABLE AS SELECT)コマンドを使用して表を再構築する方法が適している場合もあります。データベース管理者はカスタム・スクリプトを作成でき、クローズするコンポジットを判定するための解析が不要になるため、このスクリプトのほうがTRSより高速になる場合も多くあります。
さらに、不確定な参照を回避するため、一部の表(COMPOSITE_INSTANCEなどのマスター表、詳細は後述)でも、依存表の再構築が必要になる可能性があります。カスタムCTASスクリプトまたはITASスクリプトは、特定のマスター表内のすべての行を保持するため、依存表の再構築が回避されます。したがって、領域の再利用が必要ない場合は、TRSが最適なオプションではない可能性があります。

- フェーズ2でTRS DDL生成スクリプトを実行する前と後にOracle SOA Suiteデータベースをバックアップする必要があります。これは、第10.6.4項「フェーズ1-TRSスクリプトの作成」のtrs_instances PL/SQLプロシージャでredo_flagパラメータをfalseに設定して、ロギングなしを指定した場合に特に重要です。

- 動的に作成されたDDLスクリプトは、本番環境での実行前に、データベース管理者が品質保証(QA)環境で綿密な確認およびテストを行う必要があります。

- TRSスクリプトは、Oracle SOA SuiteスキーマのOracle B2Bの表を除くすべての実行時表を再構築できます。

- TRSスクリプトは、Oracle以外のデータベースでは実行できません。

- Oracle SOA Suite 11gパージ・スクリプトで言及されていないOracle SOA Suiteの表は削除できません。

10.6.2 TRSスクリプトの機能

TRSスクリプトは非常に大きな表を再構築でき、次の機能が設計されています。

- パフォーマンス機能

- パラレル問合せスレーブが大型の表を管理および走査します。

- データ操作言語(DML)スクリプトが生成されます。

- 最小のRedo/Undoロギングにより、生成されるRedoログの数が減少します。

- 直接パス入力/出力(I/O)によって、生成されるRedoおよびUndoログの数が減少します。直接I/Oは、データベース・バッファ・キャッシュのバイパスもします。TRSスクリプトは、副問合せによる直接パス挿入を使用して、再作成された表への移入を行います。副問合せは、ソース表からオープン・コンポジット・フローのみを選択し、クローズした(削除された)コンポジットを無視します。表の再作成の副次的効果として、ディスク領域も再利用および再編成されます。

- オンサイトの表と索引定義(データ定義言語(DDL))は、基本表と索引の定義に加えたカスタマイズにかかわりなく保持されます。

- TRSスクリプトは実行前にカスタマイズできるため、表のパーティション化が促進されます。オンサイト・データベース管理者は、生成されたDDLスクリプトを変更する必要があります。

- ファイングレイン表によってターゲットの大きな表が再構築されます。これは、TRSスクリプトの主目的です。これは、パージ戦略が実装されていない場合に発生する重大なエスカレーションの回避に役立ちます。

- drop_flagパラメータによって、ソース(元)表が削除可能であるかどうかが判定されます。これは、領域の推定および検証に役立ちます。

TRSスクリプトは、表10-11に示されるように2フェーズで実行されます。

表10-11 2フェーズ実行のTRSスクリプト

フェーズ1のタスク

フェーズ2のタスク

trs_instances PL/SQLプロシージャを実行して、TRS DDLスクリプトを作成します。このフェーズは、適切な保存期間設定の数日前に実行できます。

PL/SQLプロシージャは、次のタスクを実行します。

- 入力パラメータを読み取ります。

- パラメータ表(TRS_PARAMETER)から表名を読み取ります。

- フェーズ2でOracle SOA Suiteの表を再構築するキーを、一時ID表に移入します(直接パス挿入を使用)。一時ID表には、生成されたDDLスクリプトでのソース表の再構築時に無視される、クローズ済コンポーネントIDが格納されます。

- フェーズ2での再構築を行うために実行される表再作成DDLスクリプトを生成します。このスクリプトは、リポジトリ作成ユーティリティ(RCU)で生成されたOracle SOA Suiteスキーマに加えたオンサイト表および索引の変更をすべて保持します。たとえば、表をパーティション化したり、ファイルを保護するために基本ファイルのラージ・オブジェクト(LOB)を変更している場合があります。生成されたDDLスクリプトにはこれらの変更が含まれます。

- ログ・ファイルを生成します。

注意: フェーズ1が失敗した場合、DDLスクリプトが生成されない、または一部のみ生成される結果になります。

QA環境で綿密なテストを行った後に、Oracle SOA Suiteインストールの停止時間にDDLスクリプトを実行します。

DDLスクリプトは実行前にカスタマイズできます。このスクリプトは、次のタスクを実行します。

- 一時ID表ではなく、コンポジット・フロー(ECID)に基づいて、表の行の削除、作成および挿入を行います。

- 依存オブジェクトを再作成します。このスクリプトには、表、索引、制約定義、およびOracle SOA Suite表への移入のための直接パス挿入が含まれます。

10.6.3 XML_DOCUMENT表の再構築の前提条件

第10.6.4項「フェーズ1-TRSスクリプトの作成」で、オープン・コンポジット・インスタンスを使用して表を再作成することを指定しています。XML_DOCUMENTは、指定可能な表に含まれている表です。XML_DOCUMENT表は、SOAインフラストラクチャ内のコンポーネント間で、次の表に表示されるドキュメントIDによって共有されます。

- INSTANCE_PAYLOAD

- DOCUMENT_DLV_MSG_REF

- DOCUMENT_CI_REF

- MEDIATOR_AUDIT_DOCUMENT (開発モードのみで使用)

- B2B_DATA_STORAGE

XML_DOCUMENT表はそれ自体がマスター表です。他の表の再構築に使用される論理とは異なり、この表は前述の表にも表示されるドキュメントIDで再構築されます。したがって、XML_DOCUMENT表の再構築の前に前述の表のパージ、またはTRSスクリプトによる再作成が必要になります。

これにはTRSスクリプトの複数回の実行が必要な場合があります(前述の表でパージ・スクリプトが使用されない場合)。最初のタスクで、前述の表からクローズしたすべてのドキュメントIDを削除し、第2のタスクではこれらの表内に残っている内容に基づいてXML_DOCUMENT表のサイズを縮小します。

XML_DOCUMENT表は、B2B_DATA_STORAGE表との外部キー関連があるため、クローズ済のコンポジットおよびサービス・コンポーネントIDに基づいて再構築されるわけではありません。TRSスクリプトおよびこれによるこの表の再構築の必要性は、残っている内容に従うものであるため、Oracle B2BでクローズされているドキュメントIDは削除できません。

XML_DOCUMENT再構築の前に、次のいずれかを実行します。

1. パージ・スクリプトを実行して、INSTANCE_PAYLOAD、DOCUMENT_DLV_MSG_REF、DOCUMENT_CI_REF、およびMEDIATOR_AUDIT_DOCUMENTの各表から行を削除します。

または(あるいは両方)

1. TRSスクリプトを実行して、INSTANCE_PAYLOAD、DOCUMENT_DLV_MSG_REF、およびDOCUMENT_CI_REFの各表から行を削除します。

2. Oracle B2Bパージ・スクリプトを実行して、B2B_DATA_STORAGEから行を削除します。

10.6.4 フェーズ1-TRSスクリプトの作成

注意:

XML_DOCUMENT表は、オープン・コンポジット・インスタンスで再作成可能な表に含まれます。XML_DOCUMENT表の再作成前に、理解しておくことが必要な固有の前提条件があります。詳細は、第10.6.3項「XML_DOCUMENT表再構築の前提条件」を参照してください。

trs_instances PL/SQLプロシージャを使用して、TRS DDLスクリプトを作成します。このスクリプトは、入力パラメータを受け取り、データベース表を読み取って再作成する表を決定します。例10-4に構文を示します。

例10-4 trs_instancesプロシージャ

PROCEDURE trs_instances (i_older in TIMESTAMP default null,
drop_flag in boolean default false,
redo_flag in boolean default false,
DOP in number default 0,
sql_trace in boolean default false);

表10-12は、TRSスクリプトのパラメータについて説明しています。

表10-12 パラメータの説明

パラメータ

説明

i_older

保存ポリシーを実装する日付を指定します。つまり、作成日付がこの日付より古いコンポジット・インスタンスは、クローズしていると削除の候補になります。

作成日付がこの日付より前のコンポジットは、オープンとクローズのいずれでも保存されます。これは必須パラメータです。デフォルト値はありません。

drop_flag

TRSスクリプトの一環として、元(ソース)表が削除されるかどうかを指定します。このフラグを使用して、トライアルを実行し、TRS操作の実行に十分なデータベース領域が存在することを確認します。TRS走査には、元の表と同じサイズの追加表を収容できるだけの十分な領域が必要です。

- true: 再作成後、元(ソース)表がただちに削除されます。一時表は、元の名前に変更されます。したがって、データベースにはDDLスクリプト内の最大の表を収容できるだけの十分な領域が必要です。

- false (デフォルト値): 元の表は削除されません。ただし、オープン・コンポジットのみが格納された一時表は作成されます。したがって、データベースにはDDLスクリプト内のすべての表の元(ソース)表と一時(ターゲット)表を収容できるだけの十分な領域が必要です。

redo_flag

選択した表の再作成時にデータベースのRedoロギングが実行されるかどうかを指定します。Redoロギングの生成を回避すると、TRSスクリプトのパフォーマンスを大幅に向上できますが、データベースのバックアップとリカバリが必要なことになります。このパラメータの設定にかかわりなく、TRSスクリプトの実行前と後にバックアップを実行することをお薦めします。

- true: (デフォルト値)データベースのRedoロギングが実行されます。

- false: データベースのRedoロギングは実行されません。ロギングが指定されていない場合(つまり、redo_flagがfalseに設定されている場合)は、TRSスクリプトの実行直後にデータベースのバックアップを実行する必要があります。

DOP

TRSスクリプト操作のパラレル問合せスレーブの数の設定で使用されるパラレルの程度を指定します。パラレル問合せスレーブは、マルチCPUハードウェア上のTRSパフォーマンスを支援します。0または1 (デフォルト値)に設定すると、スクリプト内でパラレル問合せスレーブは指定されません。

sql_trace

trs_instances PL/SQLプロシージャによって実行されるSQL文にSQLトレースを生成するため、SQLの調整およびデバッグに使用されます。SQLトレースは、生成されたDDLスクリプトでも設定されます。SQLトレース・ファイルは、データベース・ユーザーのダンプ出力先にあります。

SQL> SHOW PARAMETER DUMP

SQLトレースによってSQL実行に重大なオーバーヘッドが生じます。デフォルト値はfalseです。

RCUが最初にTRSスクリプトをインストールします。TRSスクリプトのインストールを完了するには、次の手順を実行する必要があります。

TRSスクリプトのインストールを完了する手順は次のとおりです。

1. DDLスクリプトおよびログ・ファイルを取得するディレクトリを作成します。

mkdir -p /…/trs_output

2. SQL*Plusで、データベースAS SYSDBAに接続します。

SQL> CONNECT SYS AS SYSDBA

3. trs_dirデータベース・ディレクトリを作成します。

SQL> CREATE OR REPLACE DIRECTORY trs_dir AS '/.../trs_output';

4. Oracle SOA Suiteスキーマ所有者に権限を付与します。

SQL> GRANT READ, WRITE ON DIRECTORY trs_dir TO soa_owner;

5. SQLトレースでは、Oracle SOA Suiteスキーマ所有者にALTER SESSION権限が要求される場合があります。

SQL > GRANT ALTER SESSION TO soa_owner;

6. TRS_PARAMETER表内で再作成されるOracle SOA Suiteの表の表名を挿入します。

- 表10-13は、挿入可能なマスター・コンポーネント表名と、選択時に自動的に組み込まれる対応表を示しています。

- 表10-14は、挿入可能な個別の表と、選択時に自動的に組み込まれる対応表を示しています。

表にはTABLE_NAMEと呼ばれる列が1つあり、パージ・スクリプトで言及されたすべてのOracle SOA Suite表の名前を受け入れます。TRS_PARAMETER表には1つ以上の表を挿入できますが、Oracle SOA Suiteスキーマ内のマスター表とみなされる一部の表は、不確定な参照を回避するために追加の表の再構築が要求される場合があります。(TRSでは表の依存性が自動的に判定されます。)

SQL> CREATE TABLE TRS_PARAMETER (TABLE_NAME VARCHAR2(200));
SQL> INSERT INTO TABLE TRS_PARAMETER VALUES('COMPOSITE_INSTANCE');
SQL> COMMIT;

COMPOSITE_INSTANCE表がTRS_PARAMETER表に挿入される場合は、すべてのコンポーネントの実行時表を再構築する必要があります。これはCOMPOSITE_INSTANCE表にすべてのコンポジット・フローの状態(オープンまたはクローズ)が格納されるためです。不確定な参照を回避するために、Oracle BPEL Process Manager、Oracle Mediator、ヒューマン・ワークフロー、およびデシジョン・サービス(ビジネス・ルール)のサービス・コンポーネント表が再構築されます。これは、DDLの生成時にTRSスクリプトによって自動的に処理されます。

また、TRS_PARAMETER表にOracle BPEL Process Managerのマスター表CUBE_INSTANCEのみを挿入する場合は、Oracle BPEL Process Manager実行時表のみが再構築されます。したがって、SOAインフラストラクチャ、Oracle Mediator、ヒューマン・ワークフロー、およびデシジョン・サービス(ビジネス・ルール)の実行時表はそのままで保持され、クローズ済のコンポジットはSOAインフラストラクチャの表(COMPOSITE_INSTANCE)を介して引続きOracle Enterprise Manager Fusion Middleware Controlに表示できます。クローズ済のSOAコンポジット・アプリケーションを削除するには、第10.3項「パージ・スクリプトを使用した大量のインスタンスの削除」で説明されているパージ・スクリプトを実行する必要があります。(前述のように、TRSはパージおよびパーティション化の実装を可能にする修正処理を目的としています。)

注意:

パージ・スクリプト内の個別のOracle SOA Suite表はすべて再作成が可能ですが、Oracle SOA Suiteスキーマ内の表にはマスター表とみなされる表も、依存性が存在する表もあります。不確定の参照を回避するため、TRSスクリプトは依存表を自動的に組み込みます。

表10-13 マスター・コンポーネント表とTRS_PARAMETER表

マスター・コンポーネント表名

自動的に組み込まれる表

COMPOSITE_INSTANCE

SOAインフラストラクチャ、Oracle BPEL Process Manager、Oracle Mediator、ヒューマン・ワークフロー、およびビジネス・ルール(デシジョン・サービス)コンポーネントのすべての実行時表を再作成します。

CUBE_INSTANCE

Oracle BPEL Process Manager実行時表(Oracle BPM Suiteの実行時表を含む)のすべてを再作成します。

MEDIATOR_INSTANCE

Oracle Mediator実行時表のすべてを再作成します。

WFTASK

ヒューマン・ワークフロー実行時表のすべてを再作成します。

BRDECISIONINSTANCE

ビジネス・ルール(デシジョン・サービス)の実行時表のすべてを再作成します。

XML_DOCUMENT脚注 1

XML_DOCUMENT表を再作成します。

脚注 1 一般にこの表はサイズが増大します。XML_DOCUMENT表の再作成前は、実行が必要な固有の前提条件が存在します。詳細は、第10.6.3項「XML_DOCUMENT表再構築の前提条件」を参照してください。

表10-14 個別の表とTRS_PARAMETER表

表名

自動的に組み込まれる表

INSTANCE_PAYLOAD脚注 1 またはREJECTED_MSG_NATIVE_PAYLOAD

- INSTANCE_PAYLOAD脚注 1

- REJECTED_MSG_NATIVE_PAYLOAD

- REFERENCE_INSTANCE脚注 1

- COMPOSITE_INSTANCE_FAULT

- REJECTED_MESSAGE

- COMPONENT_INSTANCE

ATTACHMENTまたはATTACHMENT_REF

- ATTACHMENT

- ATTACHMENT_REF

DLV_MESSAGE、DOCUMENT_DLV_MSG_REFまたはHEADER_PROPERTIES

- DLV_MESSAGE

- DOCUMENT_DLV_MSG_REF

- HEADERS_PROPERTIES

BPM_AUDIT_QUERY、BPM_CUBE_AUDITINSTANCE、BPM_CUBE_PROCESSPERFORMANCE、BPM_CUBE_TASKPERFORMANCE、BPM_MEASURE_ACTION_EXCEPSまたはBPM_MEASUREMENT_ACTIONS

- BPM_AUDIT_QUERY

- BPM_CUBE_AUDITINSTANCE

- BPM_CUBE_PROCESSPERFORMANCE

- BPM_CUBE_TASKPERFORMANCE

- BPM_MEASURE_ACTION_EXCEPS

- BPM_MEASUREMENT_ACTIONS

MEDIATOR_PAYLOAD脚注 1

- MEDIATOR_DEFERRED_MESSAGE

- MEDIATOR_CASE_INSTANCE

- MEDIATOR_RESEQUENCER_MESSAGE

- MEDIATOR_GROUP_STATUS

- MEDIATOR_PAYLOAD

MEDIATOR_DEFERRED_MESSAGE

- MEDIATOR_DEFERRED_MESSAGE

- MEDIATOR_PAYLOAD

MEDIATOR_CASE_INSTANCE

- MEDIATOR_CASE_INSTANCE

- MEDIATOR_PAYLOAD

MEDIATOR_RESEQUENCER_MESSAGE

- MEDIATOR_RESEQUENCER_MESSAGE

- MEDIATOR_GROUP_STATUS

- MEDIATOR_PAYLOAD

脚注 1 一般にこの表はサイズが増大します。

7. データベース・ディレクトリtrs_dirにログ・ファイルを生成します。

SQL> @debug_on

8. ログ・ファイル内のすべてのAPI文の失敗を取得します。

SQL> SET SERVEROUTPUT ON

9. 注意:

- フェーズ1は実行に時間がかかります。

- フェーズ1の進捗状況は、デバッグがオンであればtrs_dirディレクトリのログを表示することで監視できます。

- フェーズ1のSQLの進捗状況は、SQL_TRACEがtrueに設定されていれば、データベース・ユーザーのダンプ出力先内のSQLトレース・ファイルを調べることで監視できます。

10. 終了して、最終バッファをログおよびSQLスクリプト・ファイルにフラッシュします。

SQL> EXIT

10.6.5 フェーズ2-TRSスクリプトの実行

データベース・ディレクトリtrs_dirにある生成されたDDLスクリプトを実行します。このスクリプトには、第10.6.4項「フェーズ1-TRSスクリプトの作成」で生成され、Oracle SOA Suiteの表を再作成するための文が含まれています。

1. SQL*Plusで、データベースAS SYSDBAに接続します。

SQL> CONNECT SYS AS SYSDBA

2. trs_dirディレクトリで、生成されたDDLスクリプトを実行します。

SQL> @SOA_TRS_20120711091958.sql

これで、SOA_TRS_20120711091958.logという名前のスプール・ファイルが作成されます。

10.6.6 ロギングとデバッグ

現在のプロシージャ、および実行されるSQL文の監査証跡を記録できます。監査証跡は、trs_dirディレクトリのsoa_trs_DATE.logという名前のログ・ファイルに書き込まれます。

ロギングとデバッグを有効にする手順は次のとおりです。

1. 次の場所にディレクトリを変更します。

$ cd …./trs_common

2. デバッグをオンにします。

SQL> @debug_on.sql;

3. DDLスクリプトの実行が完了したら、デバッグをオフにします。

SQL> @debug_off.sql;

DDLスクリプトの作成および実行時に発生したエラーを追跡できます。sql_traceフラグに関する次の詳細に注意してください。

- SQLトレースは、trs_instancesプロシージャ内の文に対して設定されます(イベント10046)。

- SQLトレース・ファイルは、データベース・ユーザーのダンプ出力先にあります。

- SQL文をDEBUGログ設定と関連付けると、プロシージャを判定できます。

- SQLトレースは、TRSスクリプトの最上部で設定されます(イベント10046)。

10.7 Microsoft SQL Serverでのインスタンスのパージ

Microsoft SQL Serverのデータベース・インスタンスをパージするには、第10.3.1項「ループしたパージ・スクリプト」で説明されているループ (シングル・スレッド)のパージ・スクリプトを実行します。

ループしたパージ・スクリプトを実行する前に、次の詳細に注意します。

- Microsoft SQL Server上でのパラレル・パージ・スクリプトの実行、およびパーティション化はサポートされていません。

- 次のMicrosoft SQL Serverバージョンがサポートされています。

- 2005 (すべてのサービス・パック・レベルが含まれます)

- 2008 (すべてのサービス・パック・レベルが含まれます)

- 2008 R2 (すべてのサービス・パック・レベルが含まれます)

- Oracle PL/SQLパージ・スクリプトは、Microsoft SQL Server Transact-SQL (T-SQL)に変換されます。

- T-SQLとは相違点があるため、スクリプトの実行はOracleデータベースの場合とは少し異なります。これらの相違点については、以降の項で説明します。

10.7.1 Microsoft SQL Serverの機能について

ここでは、いくつかの基本的なMicrosoft SQL Serverの機能について説明します。より具体的な詳細は、Microsoft SQL Serverのドキュメントを参照してください。

- Microsoft SQL Serverは、ディスク・ファイルを共有しない独立したデータベースです。これは、1つのデータベース・インスタンスで多数のユーザーとスキーマを保持でき、ユーザーが表領域を共有できるOracleデータベースとは異なります。

- Microsoft SQL Serverは、ログインを使用して、インスタンスへのアクセスを提供します。表、ビューなどへの個別アクセスを取得するためにログインにマップされるユーザーが、データベースのそれぞれに存在します。

- ユーザーのそれぞれにデフォルト・スキーマがあり、他のスキーマへのアクセスを取得できます。

- sysadminロールを使用したログインには、データベース所有者(dbo)に割り当てられるデフォルト・スキーマがあります。

- T-SQLは、Oracle PL/SQLと同等です。

- ログインのそれぞれには複数のデータベースおよびデータベース内のスキーマに対するアクセスがあります。どのオブジェクトについても、アクセスには完全修飾名を使用する必要があります。

[DATEBASE_NAME].[SCHEMA_NAME].[TABLE_NAME]

- データベース・オブジェクトにアクセスする前に、データベース名をデフォルトにできます。

1. [DATEBASE_NAME]コマンドを使用します。

2. スキーマ・オブジェクトには、[SCHEMA_NAME].[TABLE_NAME]としてアクセスします。

- オブジェクトがユーザーに指定されたデフォルト・スキーマに存在する場合は、スキーマ名を修飾することなく、直接アクセスできます。

10.7.2 Microsoft SQL Server上のパージ・スクリプトの相違点

ここでは、Microsoft SQL Server上でパージ・スクリプトを使用する際に相違のある状況について説明します。

- Microsoft SQL Serverではパッケージがサポートされませんが、パージ・スクリプトはコンポーネントごとに別個のパッケージに依存します。Microsoft SQL Serverのスキーマは、この機能の実現のために使用されます。

- T-SQLは、ロギング(dbms_putlineおよびutl_file.put_line)を直接的にはサポートしていません。xp_cmdshellによってパージの詳細がファイルのログ記録されます。この機能には、第10.7.3項「Microsoft SQL Server上でのパージ・スクリプトの実行」で説明される構成の追加変更が必要です。

- T-SQLでは、Oracleデータベースのデバッグのオンとオフの切替えに使用されるコンパイラ・フラグがサポートされません。追加の表でデバッグの設定が管理されます。

- Microsoft SQL Serverから表にアクセスするには、表がスキーマ名で修飾されている必要があります。メイン・スクリプトでスキーマ名の接頭辞を回避するためのシノニムの作成および削除のため、Microsoft SQL Serverには追加のプロシージャが用意されています。

- xp_cmdshellは、Windowsコマンド・シェルを作成し、実行用の文字列を渡します。この文の実行には、sysadminロールが必要です。

10.7.3 Microsoft SQL Server上でのパージ・スクリプトの実行

SQLCMDユーティリティを使用してパージ・スクリプトを実行します。このユーティリティを使用すると、次の場所のコマンド・プロンプトでT-SQL文、システム・プロシージャおよびスクリプト・ファイルを入力できます。

- SQLCMDモードの問合せエディタ

- Windowsのスクリプト・ファイル

- SQL Serverエージェント・ジョブのオペレーティング・システム(cmd.exe)ジョブ・ステップ

パージ・スクリプトは別のディレクトリにある別のSQLファイルでパッケージ化され、その相対パスを介してアクセスするため、このロードにはSQLCMDユーティリティの使用が最適な方法です。

パージ・スクリプトは、MW_HOME/SOA_ORACLE_HOME/rcu/integration/soainfra/mssql/soa_purgeディレクトリにあります。

1. sysadmin権限のあるユーザーとして、SQLCMDユーティリティを使用してMicrosoft SQL Serverに接続します。例:

sqlcmd -S myhost.us.example.com\Instance_Name -D database_name - U user_name -P password

2. DATEFORMATコマンドを設定して、パージ・スクリプトを英語で実行します。

注意:

Microsoft SQL Serverでは、パージ・スクリプトを実行する際にサポートされる言語は英語のみです。

'set DATEFORMAT mdy'

例:

'set DATEFORMAT 08122013'

3. パージ・スクリプトをロードします。

:r soa_purge_scripts.sql

<1 rows affected>

4. xp_cmdshellをサポートするように、構成を変更します。

sp_configure 'xp_cmdshell', 1;
GO
RECONFIGURE;
GO

5. 必要に応じてデバッグを有効化します。

:r common\debug_on.sql

6. 特定のスキーマ上のパージをターゲットにするシノニムを作成します。

exec soa.create_synonyms
@schema_name = 'SS1_SOAINFRA'
GO

7. パージ・スクリプトを実行します。

Exec soa.delete_instances
@min_creation_date ='01 Jan 2012',
@max_creation_date ='30 Jan 2012',
@batch_size = 50 ,
@max_runtime = 15 ,
@retention_period = '31 Dec 2012',
@write_file = 'C:\temp\out1.txt'
GO

指定するパラメータは、purge_partitioned_componentパラメータがサポートされないことを除き、表10-1に示されたOracleデータベース上でのループしたパージ・スクリプトの実行のパラメータと同じです。

注意:

- 第10.3.5項「特定のSOAコンポジット・アプリケーションのインスタンスのパージ」で説明されているCOMPOSITE_DNに基づくパージのパージ・スクリプト・オプションはサポートされません。

- パーティション化はサポートされません。

- 第10.3.2項「dbms_schedulerを使用したパラレル・スクリプトでのループしたパージ」で説明されているパラレル・パージ・スクリプトはサポートされません。

11 Facade APIを使用したSOAコンポジット・アプリケーションのプログラムによる管理

この章では、コンポジット、コンポーネント、サービス、参照などの操作と属性を公開し、実行時にSOAコンポジット・アプリケーションをプログラムで管理するFacade APIについて説明します。Facade APIは、Oracle SOA SuiteのInfrastructure Management Java APIの一部です。

この章では、次の項目について説明します。

- 第11.1項「SOAコンポジット・アプリケーションのプログラムによる管理の概要」

- 第11.2項「Facade APIインタフェース」

- 第11.3項「Facade APIの例」

インフラストラクチャJava APIの詳細は、Oracle Fusion Middleware Oracle SOA Suiteインフラストラクチャ管理Java APIリファレンスを参照してください。

11.1 SOAコンポジット・アプリケーションのプログラムによる管理の概要

実行時にFacade APIを使用してSOAコンポジット・アプリケーションをプログラムで管理できます。Facade APIは、Oracle SOA SuiteのInfrastructure Management Java APIの一部です。Facade APIは、コンポジット、コンポーネント、サービス、参照などの操作と属性を公開します。Facade APIでは、Oracle Enterprise Manager Fusion Middleware Controlでのコンポジットの管理の代替方法が提供されます。

oracle.soa.management.facade.Locatorインタフェースは、ほとんどのFacade APIに対する最上位レベルのエントリ・ポイントとしてメソッド・インタフェースを公開します。oracle.soa.management.facade.Locatorインタフェースは、コンポジットにDirectConnectionを返すcreateConnectionメソッドを公開します。LocatorFactory実装を使用してDirectConnectionを取得できます。LocatorFactoryおよびDirectConnectionの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の直接バインディング起動APIの概要に関する項を参照してください。DirectConnectionクラスおよびDirectConnectionFactoryクラス(直接バインディング接続の作成用)は、oracle.soa.api.invocationパッケージに入っています。

パーティション管理APIは、Locatorによって公開されません。かわりに、パーティション管理APIに対する最上位レベルのエントリ・ポイントはServerManagerです。例11-1に示すServerManagerFactory実装を使用して、SOAサーバーを管理するServerManagerオブジェクトを作成します。

例11-1 ServerManagerFactory

ServerManagerFactory smf = ServerManagerFactory.getInstance();
Hashtable jndiProps = new Hashtable();

jndiProps.put(Context.PROVIDER_URL, "server_JNDI_provider_url");
jndiProps.put(Context.INITIAL_CONTEXT_FACTORY, "server_initial_context_factory_
classname");
jndiProps.put(Context.SECURITY_PRINCIPAL, "jndi_user");
jndiProps.put(Context.SECURITY_CREDENTIALS, "jndi_password");
ServerManager sm = smf.createInstance(jndiProps);

Facade APIの詳細は、Oracle Fusion MiddlewareのOracle SOA Suite Infrastructure Management Java APIリファレンスを参照してください。

注意:

Infrastructure Management Java APIには、SOAコンポジット・アプリケーションのインバウンド呼出しおよびOracle Service Bus (OSB)または別のSOAコンポジット・アプリケーションのアウトバウンド呼出し用の直接バインディング呼出しAPIも含まれます。直接バインディング呼出しAPIの使用については、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

11.1.1 locatorオブジェクト作成時に必要なセキュリティ資格証明

11gリリース1 (11.1.1.7)以降では、locatorオブジェクトの作成時に、サブジェクトの資格証明を設定するか、または起動コンテキストで確立された有効なサブジェクトを保持している必要があります。例11-2は、locatorオブジェクトを作成する方法を示しています。

例11-2 Locatorオブジェクトの作成のためのセキュリティ資格情報

Hashtable<String, String> jndiProps = new Hashtable<String, String>();
jndiProps.put(Context.INITIAL_CONTEXT_FACTORY,initialContextFactory);
jndiProps.put(Context.PROVIDER_URL, providerURL);
jndiProps.put(Context.SECURITY_PRINCIPAL, principal);
jndiProps.put(Context.SECURITY_CREDENTIALS, creds);
Locator locator = LocatorFactory.createLocator(jndiProps);

jndiProps.putでユーザーの資格情報を指定しない場合、locatorオブジェクトは作成されますが、このオブジェクトを使用してlocator内のメソッドを起動したときに、コール元にメソッドのコールに必要な権限がないことが原因で実行時例外が表示されます。

Exception in thread "Main Thread" java.lang.RuntimeException

11.2 Facade APIインタフェース

表11-1は、Facade APIインタフェースの概要を示しています。

表11-1 Facade APIインタフェース

インタフェース

説明

AsynchronousJob

非同期ジョブ・タイプに関する詳細を取得します。

注意: このインタフェースは非推奨となっています。

AsynchronousResult

非同期プロセスの結果を取得します。

B2BBinding

タイプ、ドキュメント参照などのB2Bバインディングの詳細を取得します。

Binding

URI、タイプ、サブタイプなどのバインディングの詳細を取得します。

BindingComponent

特定のフォルト・フィルタで指定されたバインディング・タイプとフォルトのリストを取得します。

BusinessEventInfo

一貫性レベル、フィルタ・タイプ、ローカル名、ネームスペースURI、接頭辞など、ビジネス・イベントの詳細を取得します。

Component

識別名(DN)、アクティブなインスタンス、失敗したインスタンス、インスタンスの合計、デプロイメント時間など、コンポーネントの詳細を取得します。

ComponentInstance

監査証跡、コンポーネント・インスタンスの状態(正常に完了、失敗、実行中など)、対話ID、作成日など、コンポーネント・インスタンスの詳細を取得します。

ComponentInstanceMigrationReport

候補となる特定のコンポーネント・インスタンスのコンポーネント・インスタンス移行の実行可能性に関する情報を提供します。

ComponentInstanceMigrationResult

特定のコンポーネント・インスタンスの移行の試行結果に関する情報を提供します。

Composite

識別名(DN)、アクティブなインスタンス、失敗したインスタンス、インスタンスの合計、デプロイメント時間など、コンポジットの詳細を取得します。

CompositeInstance

コンポジット・インスタンスの状態(正常に完了、失敗、実行中など)を取得します。

CompositeInstanceMigrationReport

候補となる特定のコンポジット・インスタンスの、コンポジット・インスタンス移行の実現可能性に関する情報を提供します。

CompositeInstanceMigrationResult

特定のコンポジット・インスタンスの移行の試行結果に関する情報を提供します。

Fault

フォルトがバインディング・コンポーネントで発生した場合のバインディング・タイプ、コンポーネント・インスタンスID、フォルトが発生したコンポーネントの名前、フォルトが生成された時刻、フォルトがサービス・エンジンで発生した場合のサービス・エンジン・タイプなど、フォルトの詳細を取得します。

FaultRecoveryActionTypeConstants

インスタンスの終了、失敗したアクティビティを完了としてマーク、拒否メッセージをファイルに格納、失敗したアクティビティをリカバリ済としてマーク、アクティビティの再試行など、アクションのタイプを提供します。

FaultRecoveryResult

フォルト、エラー、リカバリ可能なフォルト、リカバリできないフォルトなどを取得します。

FaultRecoveryServiceEngine

フォルト・リカバリ・サービス・エンジンを提供します。

ImportInfo

インポートされたリソースの場所とインポート・タイプを取得します。

InstanceMigrationContext

インスタンス移行のコンテキスト・データを提供します。

InterfaceType

コールバック・インタフェースとインタフェースのプロパティを取得します。

Locator

Facade APIクライアントのエントリ・ポイントとしてメソッド・インタフェースを公開します。

Message

コンポーネント名、コンポジットDN、メッセージの内容、対話ID、メッセージの格納場所、メッセージのリカバリ可能状態など、メッセージの詳細を取得します。

MigrationPlan

インスタンス移行の試行時に、サポートされる非互換性の処理の詳細を提供します。

MigrationReport

提案されるコンポジット・インスタンス移行の試行に関する情報を提供します。

MigrationResult

インスタンス移行の試行に関する情報を提供します。

Partition

パーティション内のすべてのコンポジットの開始、停止、アクティビティ化、リタイアなど、パーティション化のライフサイクル管理タスクを実行します。

Property

プロパティのデフォルト値、名前、オーバーライド属性値、プロパティ値のソースなど、プロパティの詳細を取得します。

Reference

ターゲット・サービスのWSDL URL、参照のプロパティ、参照名、参照バインディングなど、参照の詳細を取得します。

ReferenceInstance

バインディングのタイプを取得します。コンポジットのDN、コンポジット・インスタンスID、インスタンスの作成時刻などです。

ServerManager

パーティションを取得および作成します。

Service

バインディング、コンポジットDN、インタフェース・タイプ、名前、多重度など、サービスの詳細を取得します。

ServiceEngine

サービス・エンジンでデプロイされたコンポーネントのリスト、エンジン・タイプ、および特定のフォルト・フィルタで指定されたフォルトのリストを取得します。

ServiceInstance

バインディングのタイプなどのサービス・インスタンスの詳細を取得します。コンポジットのDN、コンポジット・インスタンスID、作成時刻などです。

WebServiceBinding

デフォルト・アドレスURI、エンドポイント・アドレスURI、ポート、トランスポート・タイプなどを取得します。

WebServiceBindingPort

ポート名、ポートURI、サービス名などを取得します。

WireInfo

ワイヤ参照、ワイヤ・サービス、ソースURIおよびターゲットURIを取得します。

WSDLInterfaceBinding

WSDL URLを取得します。

11.3 Facade APIの例

この項では、Facade APIを使用してコンポジット管理を実行する例をいくつか示します。

11.3.1 コンポジットの状態の取得

Facade APIを使用してコンポジットの状態を取得できます。

- モード: アクティブ | リタイア
この設定では、新規インスタンスを作成できるか(アクティブ)、または新しいインスタンスを作成せずに古いインスタンスを完了できるか(リタイア)を決定します。

- 状態: オン | オフ
この設定はコンポジット状態であり、コンポジット・リビジョンへのコール・アクセス(起動/コールバック)を許可する(on)、またはコール・アクセスを許可しない(off)のいずれかにアクティブまたはリタイアのコンポジット・モードをオーバーライドします。

oracle.soa.management.facade.Locator#getComposite(compositeDN)を使用して、目的のコンポジットへの参照を取得します。

コンポジット参照から、次のメソッドを使用してモードおよび状態を問い合せることができます。

- String getMode()

- String getState()

11.3.2 コンポジット・インスタンスおよびコンポーネント・インスタンスの検索

Facade APIでコンポジット・インスタンスおよびコンポーネント・インスタンスを検索できます。

Locatorインタフェースを使用してComposite (locator.lookupComposite(compositeDN))を検索します。コンポジットがまだ起動されていない場合、インスタンスはありません。

次に、インスタンスを検索し、関連情報(インスタンスID、実行されたコンポーネントなど)を取得できます。

例11-3に詳細を示します。

例11-3 コンポジット・インスタンスおよびコンポーネント・インスタンスの検索

Composite composite = locator.lookupComposite("default/OrderBookingComposite!1.0");

// The context is already the composite, so there is no need to set the DN as a filter criterion
CompositeInstanceFilter filter = new CompositeInstanceFilter();
filter.setMinCreationDate(new java.util.Date((System.currentTimeMillis() - 20000)));

// Get composite instances by filter
List compositeInstances = composite.getInstances(filter);

// for each of the returned composite instances..
for (CompositeInstance instance : compositeInstances) {
long   instanceId = instance.getId();
Date   created    = instance.getCreationDate();
String state      = instance.getState();

// Configure a component instance filter
ComponentInstanceFilter cInstanceFilter =
new ComponentInstanceFilter ();

// Get the child component instances
List componentInstances =
instance.getChildComponentInstances(cInstanceFilter);

for (ComponentInstance compInstance : componentInstances) {
String compName       = compInstance.getComponentName();
long   compInstanceId = compInstance.getId();
String type           = compInstance.getServiceEngine().getEngineType();

// State values correspond to constants defined by the ComponentInstance interface
int state = compInstance.getState();
}

// Retrieve composite sensors
List sensorData = instance.getSensorData();
}

12 SOAコンポジット・アプリケーションに関する問題の診断

この章では、Oracle SOA Suiteの問題を早期に診断し、WebLogic診断フレームワーク(WLDF)およびOracle Fusion Middleware診断フレームワークを活用して適切な修正処理を適用する方法について説明します。WLDFでは、監視および通知を使用して診断シナリオをモニターし、Oracle Fusion Middleware診断フレームワークでは、SOA固有の診断シナリオを、表示および分析用に書式設定されたデータ・ダンプに収集します。

この章では、次の項目について説明します。

- 第12.1項「診断フレームワークの概要」

- 第12.2項「Oracle SOA Suite診断ダンプの実行」

- 第12.3項「SOAコンポジット・アプリケーションの診断フレームワーク・スレッド・ダンプの実行」

- 第12.4項「サポートされているDMSメトリック」

- 第12.5項「監視および通知の作成」

- 第12.6項「手動によるダンプのトリガーと実行」

- 第12.7項「ADRツールでのインシデント・パッケージの表示」

- 第12.8項「問題およびインシデントの問合せ」

トラブルシューティングの詳細は、付録B「Oracle SOA SuiteとOracle BPM Suiteのトラブルシューティング」を参照してください。

注意:

この章で説明する情報は、Oracleデータベースにのみ適用されます。Oracle以外のデータベースを使用する場合は、動作や結果が異なります。

12.1 診断フレームワークの概要

Oracle SOA Suiteで問題を監視および診断する場合、次の困難に直面します。

- システムがハングする瞬間に複数のスレッド・ダンプを取得したり、メモリー不足になる前にヒープ・ダンプを取得するなど、特に断続的な問題の発生の瞬間での診断データの取得(ジャストインタイム診断とも呼ばれる)

- データ形状(SOAスキーマとMDSスキーマの状態および増加パターンによる件数)などの詳細情報の取得

- バージョン、ログ、構成ファイル、適用パッチなどの基本情報を提供するためのOracleサポート・サービスとの相互の通信

- 問題が拡大する前の早期の検出と修正処理の適用

これらの困難に取り組むために、Oracle SOA Suiteは、問題の早期特定および適切な修正処理の適用を支援する次の診断フレームワークと統合されます。

- WLDF: 監視および通知を使用して診断シナリオを監視します。

- 診断フレームワーク: SOA固有の診断シナリオを、表示および分析用に書式設定されたデータ・ダンプに収集します。これらのデータ・ダンプは、サポート・ワークベンチを介してアクセス可能になり、サービス・リクエスト(SR)の一環としてアップロード可能になります。

12.1.1 WLDFの概要

WLDFは、Oracle WebLogic Serverに組み込まれている監視と診断を行うフレームワークであり、サーバー・プロセス内で稼働してサーバーの標準的なライフサイクルの一部となる一連のサービスを定義および実装します。

WLDFを使用して、Oracle SOA Suiteから診断データを取得できます。診断データを収集して問題を特定するために、Oracle WebLogic Server管理コンソールからWLDFの監視および通知を構成します。障害が発生した場合は、このデータを使用して障害を隔離し、診断できます。

WLDFの詳細は、『Oracle Fusion Middleware Oracle WebLogic Server診断フレームワークの構成と使い方』を参照してください。

12.1.1.1 監視および通知の概要

監視は、サーバーおよびアプリケーションの状態を監視して、設定した基準に基づいて通知を送信します。監視および通知は、ドメイン内の1つ以上のサーバー・インスタンスに割り当てられている診断モジュールの一部として構成されます。監視を作成する場合は、Oracle WebLogic Server管理コンソールでOracle SOA SuiteおよびOracle WebLogic Server MBeanの属性を使用して、監視するためのルール式を作成します。

たとえば、空きヒープ・メモリーの割合が100%未満になった場合に通知を送信するとします。Oracle WebLogic Server MBean weblogic.management.runtime.JRockitRuntimeMBeanおよびその属性HeapFreePercentを使用する監視を作成します。次に、HeapFreePercentが100%未満の場合に通知を受け取る必要があることを示すロジックを定義します。JRockit仮想マシン(VM)以外で稼働している場合は、MBean JVMRuntimeMBeanを使用することもできます。

Oracle WebLogic Server管理コンソールでの監視および通知の作成方法は、『Oracle Fusion Middleware管理者ガイド』の監視および通知の作成および診断フレームワークの構成に関する項を参照してください。

12.1.1.2 診断シナリオおよびMBeanの概要

作成する監視ルール式は、Oracle SOA SuiteおよびOracle WebLogic Server MBeanの属性を使用して、データを収集し、監視を実行します。使用可能なMBeanを使用してシナリオを診断し、そのシナリオに関する統計を提供したり、メッセージをログに記録します。マネージドBean (MBean)は分散環境でJMX管理可能なリソースを表すJavaオブジェクトです。次のMBeanの属性は、シナリオを監視するための監視の定義に使用できます。

- Oracle WebLogic Server MBean

- 診断用Oracle SOA Suite MBean

- MBeansとして公開されるダイナミック・モニタリング・サービス(DMS)メトリック

Oracle SOA Suiteには、監視や通知を使用して監視できる様々な診断シナリオが用意されています。表12-1に、サポートされている診断シナリオおよび監視に使用できるMBeanの詳細を示します。

表12-1 サポートされる診断シナリオおよびMBean

シナリオ

説明

診断データ・ソース

メモリーの問題(起動、デプロイメントおよび実行時)

使用可能な空きヒープを監視します。空きヒープの割合がしきい値未満の場合、スレッド・スタック・ダンプおよびヒープ・ダンプを生成するために通知がトリガーされます。

Oracle WebLogic Server MBean

デプロイメントのハング

デプロイメントの経過時間を監視します。しきい値を超えると、通知がトリガーされます。

Oracle SOA SuiteデプロイメントMBean

データ・ソースの問題

一時停止および接続プール/トランザクションのタイム・アウトを監視します。

JDBC MBean

サーバーの過負荷

自動でサーバーの状態を監視します。

Oracle WebLogic Server MBean

スタック・スレッド

スタック・スレッドを監視します。検出すると、通知がトリガーされます。

スタック・スレッド監視/診断フレームワーク通知は自動的に組み込まれます。診断フレームワーク・インシデント・パッケージは、ADRコマンド・インタプリタ(ADRCI)などのツールを使用して作成できます。インシデントは自動的に作成されます。

表12-2に、診断データを監視および収集するための監視を作成するときに選択する、使用可能なMBeanおよびDMSメトリックの一部を示します。

表12-2 MBeanおよびDMSメトリック

診断データ・ソース(MBean)および使用方法

説明

Oracle WebLogic Server MBean

SOA MBeanまたはDMSメトリック

weblogic.management.runtime.JVMRuntimeMBean/weblogic.management.runtime.JRockitRuntimeMBean

メモリー統計用

はい

- -

oracle.fabric.management.wldf.mbean.DeploymentWatchMXBeanImpl

デプロイメント経過時間用

- -

SOA MBean

weblogic.management.runtime.ServerRuntimeMBean

ヘルス状態情報用

はい

- -

weblogic.management.runtime.JDBCDataSourceRuntimeMBean

weblogic.management.runtime.JTARuntimeMBean

JDBCデータ・ソース用およびトランザクション・ランタイム特性のアクセス用

はい

- -

Oracle WebLogic Server MBeanの詳細は、Oracle Fusion Middleware Oracle WebLogic Server MBeanリファレンスを参照してください。

12.1.2 診断フレームワークの概要

診断フレームワークは、問題の検出、診断および解決に役立つOracle Fusion Middlewareの機能です。対象としている問題は、コードのバグ、メタデータの破損、顧客データの破損、スレッドのデッドロック、一貫性のない状態に起因する障害などのクリティカル・エラーです。診断フレームワークは重大なエラーを検出し、関連する診断情報(ログ、メトリック、サーバー・イメージなど)のダンプを取得します。WLDFの監視および通知は、診断フレームワークが適切なデータ・ダンプをリスニングおよび生成するイベントをトリガーします。ダンプは、表示および分析用にインシデント・パッケージに書式設定されます。

インシデントとして取得される問題には、表12-1で説明されているようなクリティカル・エラーが含まれます。各インシデント・パッケージは一意のIDで識別されます。クリティカル・エラーが発生すると、この一意のID(インシデント番号として知られている)が割り当てられます。エラーの診断データ(ログ・ファイルなど)は、この番号で即時に取得され、タグが設定されます。

その後、データは自動診断リポジトリ(ADR)に格納されます。ADRは、エラーの発生および関連する診断データの記憶域をカタログ化するためのファイルシステム・リポジトリです。データは、インシデント・パッケージ番号で取得して書式設定した後、ADRCIなどのOracleデータベース・ツールで表示し、分析されます。

ADRCIを使用して、ダンプ・ファイルの名前、およびXMLタグが取り除かれた状態のアラート・ログを表示できます。このビューでは、問題を調査し、新たな障害の診断データをパッケージ化してOracleサポート・サービスにアップロードできます。

診断フレームワークのWLSTコマンドを使用して、次のタスクを実行することもできます。

- 問題の問合せ

- インシデント・ダンプ・ファイルの表示

- 手動インシデントの作成

- ダンプの手動実行

診断フレームワークはすべてのJRF対応プラットフォームでサポートされています。

診断フレームワークは様々なダンプに自動的に組み込まれます。これらのダンプの詳細は、『Oracle Fusion Middleware管理者ガイド』のレポートの調査および問題の解決に関する項を参照してください。

これらのダンプに加え、Oracle SOA Suiteの様々なダンプもサポートされています。Oracle SOA Suiteのダンプの詳細は、第12.2項「Oracle SOA Suite診断ダンプの実行」を参照してください。

問題の解決、インシデントおよびWLDFと診断フレームワークとの統合の詳細は、『Oracle Fusion Middleware管理者ガイド』の「問題の診断」の章を参照してください。

ADRの詳細は、第12.7項「ADRツールでのインシデント・パッケージの表示」を参照してください。

12.1.2.1 インシデント・パッケージ数の制御

Oracle SOA Suiteに繰り返し発生する問題があると、複数のインシデント・パッケージが作成される可能性があります。多数のエラーが発生している場合にサーバーの過負荷を防止する目的で、診断フレームワークでは一部のインシデントが自動的にフラッド制御されます。この問題を回避するために、インシデント・パッケージ数を制御するように診断フレームワークを構成できます。詳細は、『Oracle Fusion Middleware管理者ガイド』の診断フレームワークの構成に関する項を参照してください。

12.1.3 事前定義のインシデント処理ルール

Oracle WebLogic Server管理コンソールで監視を作成する場合は、通知も定義します。FMWDFW通知という通知は自動的に選択可能になります。独自の通知を作成することも可能ですが、FMWDFW通知では、第12.2項「Oracle SOA Suite診断ダンプの実行」で説明されているOracle SOA Suiteのダンプが作成されるため、この通知を選択することをお薦めします。

エラーが検出されると、FMWDFW通知ハンドラがインシデントを作成し、診断フレームワークがインシデント処理セマンティクスを担当します。これらのセマンティクスは、インシデント処理ルールによって制御されます。インシデント処理ルールはXMLファイルに定義され、SOAインフラストラクチャの起動時にロードされて、診断フレームワークに登録されます。

表12-1に示したシナリオとは異なるシナリオに直面した場合は、Oracleサポート・サービスと連携して、カスタマイズされたインシデント処理ルール・ファイルのコピーを取得する必要があります。

12.1.3.1 診断フレームワークを使用したインシデント処理ルール・ファイルの構成

診断フレームワークを使用して、カスタマイズしたインシデント処理ルール・ファイルを構成できます。カスタマイズしたルール・ファイルは、次のいずれかの場所に配置します。

- サーバー・レベルの構成: FMW_HOME/user_projects/domains/domain_name/config/fmwconfig/servers/server_name/dfw

- ドメイン・レベルの構成: FMW_HOME/user_projects/domains/domain_name/config/fmwconfig/dfw

診断フレームワークはサーバー起動時にファイルを自動的にロードします。ファイル名の接頭辞としてアプリケーション名が指定されている場合を除き、すべてのダンプはシステム・スコープ指定として登録されます。

- myrules.xml: システム・スコープ指定。これは、ルール・ファイルが、Oracle WebLogic Serverにデプロイされているすべてのアプリケーションに適用されることを意味します。

- application_name#name.xml: アプリケーション・スコープ指定。これは、ルール・ファイルが特定のSOAコンポジット・アプリケーションのみに適用されることを意味します。#の前にあるすべてのアプリケーション名が、Oracle WebLogic Serverにデプロイされているものとして扱われます(loanApplication#custom-rules.xmlなど)。soa-infra#custom-rules.xmlが指定されている場合は、SOAインフラストラクチャにデプロイされているすべてのSOAコンポジット・アプリケーションに適用されます。
詳細は、『Oracle Fusion Middleware管理者ガイド』のカスタム診断ルールの構成に関する説明を参照してください。

12.1.3.2 SOAサーバーのホーム・ディレクトリでのインシデント処理ルール・ファイルの構成

注意:

インシデント処理ルール・ファイルについて、11gリリース1 (11.1.1.7.0)ではSOAサーバーのホーム・ディレクトリでの構成がサポートされていますが、第12.1.3.1項「診断フレームワークを使用したインシデント処理ルール・ファイルの構成」の説明に従って、診断フレームワークを使用して構成することをお薦めします。

Oracleサポート・サービスでは、カスタマイズしたルール・ファイル(custom-rules.xmlという名前のファイル)をSOAサーバー・インスタンスのホーム・ディレクトリの下に配置します(例: FMW_HOME/user_projects/domains/domain_name/servers/server_name)。

例12-1は、カスタム・ルール・ファイルのサンプルを示しています。oracle.soa.bpel.engine.wsモジュールの*-diagnostic.logにERRORレベル・メッセージが見つかった場合、soa.composite.trailダンプが実行されます。ルールをロードするためにシステムを再起動すると、収集された診断データの正確さが実際に損なわれます。

例12-1 サンプル・カスタム・ルール・ファイル

<?xml version="1.0" encoding="UTF-8"?>
<diagnosticRules xmlns="http://www.oracle.com/DFW/DiagnosticsFrameworkRules"
xmlns:xs="http://www.w3.org/2001/XMLSchema-instance">
<logDetectionConditions>
<condition module="oracle.soa.bpel.engine.ws"/>
</logDetectionConditions>

<defaultActions>
<dumpAction name="soa.composite.trail">
<argument name="ecid" value="ECID" valueType="Fact" mandatory="true"/>
</dumpAction>
</defaultActions>

</diagnosticRules>

12.1.3.3 カスタム・ルール・ファイルの動的なロード

さらに、サーバーを再起動しないでSOAインフラストラクチャにルール・ファイルを動的にロードすることもできます。サーバーの再起動によって収集された診断データの正確さが損なわれる可能性があるため、動的リロードは重要です。

サーバーを再起動しないで動的にファイルをリロードするには、次のWLSTコマンドを入力します。

wls:/soainfra/serverConfig> reloadCustomRules(name='rule_file')

reloadCustomRulesの詳細は、Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスの「診断フレームワークのカスタムWLSTコマンド」の章を参照してください。

12.2 Oracle SOA Suite診断ダンプの実行

Oracle WebLogic Serverで使用可能な診断ダンプに加え、Oracle SOA Suiteでは、表12-3に示す診断ダンプの作成をサポートしています。

表12-3 Oracle SOA Suite診断ダンプ

ダンプ

説明

soa.env

ランタイム環境のダンプ。

soa.config

ランタイム・プラットフォーム構成のダンプ。

soa.db

データベースのダンプ。

soa.composite

デプロイされたコンポジット・メタデータのダンプ。

soa.composite.trail

インスタンス監査証跡のダンプ。

soa.edn

イベントのダンプ。

soa.wsdl

デプロイされたコンポジットWSDL/スキーマ・キャッシュのダンプ。

bpel.dispatcher

静的ダンプ(システム、呼出し、エンジンおよび監査スレッド数)ならびにランタイムのスケジュール済メッセージ数と稼働中メッセージ数のダンプ。

bpel.apt

平均インスタンス処理時間のダンプ。

bpel.apd

平均インスタンス処理遅延のダンプ(非同期プロセス用)。

bpel.sps

同期ビジネス・プロセス・ダンプ統計(最小、最大および平均処理時間(ミリ秒単位)など)、ならびに処理されたインスタンスの数。

bpel.aps

非同期BPELプロセス・ダンプ統計(最小、最大および平均処理時間(ミリ秒単位)など)、ならびに処理されたインスタンスの数。

bpel.rs

リクエスト・レベルのダンプ統計(最小、最大および平均処理時間(ミリ秒単位)など)、ならびにBPELプロセス・サービス・エンジンの各種レイヤーを通して流れながら処理されたリクエストの数。

mediator.resequencer

リシーケンサ・グループ処理遅延のダンプ。

soa.adapter.ra

アダプタのコネクション・ファクトリの構成。複数のコンポジットが同じJava Naming and Directory Interface (JNDI)を使用しているかどうかを識別するために使用します。

soa.adapter.connpool

JCAアダプタの接続プール統計と接続プール・リーク。現在のオープン接続の統計が表示され、接続プールのチューニングを行うことができます。

soa.adapter.stats

アダプタDMSの統計(メッセージ・サイズ、フォルト数など)。

診断フレームワークは診断のダンプを出力および記録します。WLSTのlistDumpsおよびdescribeDumpコマンドを使用して、診断ダンプすべての詳細を表示できます。

注意:

WLSTは、MW_HOME/oracle_common/common/binから起動する必要があります。そのようにしないと、ODFの機能が検出されません。

./wlst.sh

ダンプをリストする手順は次のとおりです。

1. SOAインフラストラクチャがインストールされているサーバーに接続します。

wls:/offline> connect('user_name', 'password',
't3://myhost:8001')
Connecting to t3://myhost:8001 with userid user_name ...
Successfully connected to managed Server 'soa_server1' that belongs to
domain 'soainfra'.

2. 診断フレームワークのダンプのリストを表示します。

wls:/soainfra/serverConfig> listDumps()
odl.activeLogConfig
jvm.classhistogram
dms.ecidctx
jvm.flightRecording
wls.image
odl.logs
dms.metrics
odl.quicktrace
http.requests
jvm.threads

Use the command describeDump(name=<dumpName>) for help on a specific dump.

3. Oracle SOA Suiteのダンプのリストを表示します。

wls:/soainfra/serverConfig> listDumps(appName='soa-infra')
adf.ADFConfigDiagnosticDump
soa.composite
soa.composite.trail
soa.config
soa.db
soa.edn
soa.env
soa.wsdl
bpel.dispatcher
bpel.apt
bpel.apd
bpel.sps
bpel.aps
bpel.rs
mediator.resequencer
soa.adapter.ra
soa.adapter.connpool
soa.adapter.stats

Use the command describeDump(name=<dumpName>) for help on a specific dump.

Oracle SOA Suiteのダンプは、次の項で説明されています。

listDumpsおよびdescribeDumpの詳細は、Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスの「診断フレームワークのカスタムWLSTコマンド」の章を参照してください。

診断フレームワークのダンプの詳細は、『Oracle Fusion Middleware管理者ガイド』の「問題の診断」の章を参照してください。

12.2.1 ランタイム環境の診断ダンプ(soa.env)

表12-4に、ランタイム環境の診断ダンプの詳細を示します。

表12-4 ランタイム環境診断のダンプ

ダンプ名

ダンプ・パラメータ/ダンプ・モード

取得される情報

soa.env

- ダンプ・パラメータ
なし

- ダンプ・モード
ASYNC_SYNC

- SOAランタイム・バージョン、ラベル(Discovery MBeanから取得)およびトポロジ(ランタイム・バージョンがメンバーであるクラスタに関する情報)。

- トポロジ: クラスタおよびOracle Coherenceの情報(クラスタ名、メンバー名、クラスタがリーダーかどうか、ローカル・メンバー、マシンID、ラックIDなど)。
通常、リーダーはクラスタ内で最も古いノードです。リーダーは、クラスタに対するメンバーの削除や追加により、時間の経過とともに変化する可能性があります。この古いメンバーは、クラスタ・メンバーシップの保守およびクラスタに対するその他の意思決定を担当します。パニック・プロトコルなどの様々なプロトコルの最終的な裁定担当としても機能します。

- パッチ・インベントリ

- Oracle Coherenceメッセージング・モード: ユニキャストまたはマルチキャストのいずれかです。

12.2.1.1 WLSTコマンド(ダンプの説明および実行)

1. 次のWLSTコマンドライン構文を入力し、ダンプの説明を表示し、soa.envのダンプを実行します。

wls:/soainfra/serverConfig> describeDump(name='soa.env', appName='soa-infra')
Name: soa.env
Description: SOA diagnostic dump that captures SOA runtime environment info:
version, label, topology. ...
Mandatory Arguments:
Optional Arguments:

wls:/soainfra/serverConfig> executeDump(name='soa.env', appName='soa-infra')
Begin dumping EMInstanceProperties
key=soaClusterName
value=NULL
key=label
value=PCBPEL_11.1.1.6.0_GENERIC_111018.1315.1477
key=CompositeLabel
value=NULL
key=version
value=11.1.1.6.0
key-HttpUrl
value=http://myhost.us.example.com:8001
End dumping EMInstanceProperties
Cluster Info:
-----------------------------------------------
cluster name:null
cluster is leader:true
cluster is standalone:true

12.2.2 ランタイム・プラットフォーム構成の診断ダンプ(soa.config)

表12-5に、ランタイム・プラットフォーム構成の診断ダンプの詳細を示します。

表12-5 ランタイム・プラットフォーム構成診断のダンプ

ダンプ名

ダンプ・パラメータ/ダンプ・モード

取得される情報

soa.config

- ダンプ・パラメータ
zip: (オプション) 次の値がサポートされています。

- true: (デフォルト値)出力ファイルおよびアーティファクトを単一のZIPファイルに圧縮します。

- false: ダンプ・テキスト・ファイルおよびアーティファクトを、単一のZIPファイルに圧縮せずにダンプ・パス・ロケーションに書き込みます。

output: (オプション)ダンプ・ファイルを書き込む代替ディレクトリの場所を指定します。指定されていない場合は、診断フレームワークのダンプ・パスが使用されます。

- ダンプ・モード
ASYNC_SYNC

deployed-composites.xml - デプロイされているコンポジットのカタログ(リビジョンを含む)。

サービス・エンジンの構成: 次の構成はMDSに保持されます(soa/configuration/default/*.xml)。

- adapter-config.xml

- b2b-config.xml

- bpel-config.xml

- bpmn-config.xml

- businessrules-config.xml

- cep-config.xml

- edn-config.xml

- mediator-config.xml

- soa-infra-config.xml

- workflow-config.xml

- workflow-identity-config.xml

- workflow-notification-config.xml

12.2.2.1 WLSTコマンド(ダンプの説明および実行)

1. 次のWLSTコマンドライン構文を入力し、ダンプの説明を表示し、soa.configのダンプを実行します。

wls:/soainfra/serverConfig> describeDump(name='soa.config', appName='soa-infra')
Name: soa.config
Description: SOA diagnostic dump that captures SOA runtime
configuration info, such as deployed-composites.xml, service engine
configurations, etc.
Mandatory Arguments:
Optional Arguments:
Name    Type     Description
zip     BOOLEAN  Boolean flag (default to 'true') indicating if the dump
files need to be compressed into one single zip file,
true - compress dump result into a single zip, false,
otherwise, default: true
output  STRING   Path to Output destination, a directory where the dump
content will be written to, default to DFW dump path if
not specified ...

wls:/soainfra/serverConfig> executeDump(name='soa.config', appName='soa-infra')

. . .
. . .
Start dumping artifacts from MDS
URI:deployed-composites/deployed-composites.xml to /tmp/soa_
dumps139780820495.tmp/soa_config734535543.d

Finished dumping specified MDS metadata to /tmp/soa_dumps139780820495.tmp/soa_
config734535543.d

Start dumping artifacts from MDS URI:soa/configuration/default/ to /tmp/soa_
dumps139780820495.tmp/soa_config734535543.d/se-configurations

Finished dumping specified MDS metadata to: /tmp/soa_dumps139780820495.tmp/soa_
config734535543.d/se-configurations
MDS artifacts dumped, next, compressing all dump files into:
/tmp/oracle-dfw--1770056289547048694.tmp/soa_config364634563344231671.zip

executeDumpコマンドは、MDSリポジトリからdeployed-composites.xmlをダンプし、インストールされているすべてのサービス・エンジンのサービス・エンジン構成を、圧縮した単一のZIPファイル(soa_config364634563344231671.zip)にします。

2. 次のWLSTコマンドライン構文を入力し、zipパラメータfalseに設定してsoa.configのダンプを実行します。この設定は、ダンプ・テキスト・ファイルおよびアーティファクトを、単一のZIPファイルに圧縮せずにダンプ・パス・ロケーションに書き込みます。

. . .
. . .
wls:/soainfra/serverConfig> executeDump(name='soa.config', appName='soa-infra',
args={'zip':'false'})Start dumping artifacts from MDS
URI:deployed-composites/deployed-composites.xml to:
/tmp/oracle-dfw-7178460573556479044.tmp/soa_config199325881615155981.d
Finished dumping specified MDS metadata to:
/tmp/oracle-dfw-7178460573556479044.tmp/soa_config199325881615155981.d
Start dumping artifacts from MDS URI:soa/configuration/default/ to:
/tmp/oracle-dfw-7178460573556479044.tmp/soa_
config199325881615155981.d/se-configurations
Finished dumping specified MDS metadata to:
/tmp/oracle-dfw-7178460573556479044.tmp/soa_
config199325881615155981.d/se-configurations

3. デフォルトのダンプ・パスで、内容を点検します。

[jdoe@myhost /tmp]$ ls -alR oracle-dfw-7178460573556479044.tmp
oracle-dfw-7178460573556479044.tmp:
total 52
drwxr-----   3 jdoe dba   4096 Oct 24 15:43 .
drwxrwxrwt 104 root root 36864 Oct 24 15:37 ..
drwxr-----   4 jdoe dba   4096 Oct 24 15:43 soa_config199325881615155981.d
-rw-r-----   1 jdoe dba    561 Oct 24 15:43 soa_config199325881615155981.txt

oracle-dfw-7178460573556479044.tmp/soa_config199325881615155981.d:
total 16
drwxr----- 4 jdoe dba 4096 Oct 24 15:43 .
drwxr----- 3 jdoe dba 4096 Oct 24 15:43 ..
drwxr----- 2 jdoe dba 4096 Oct 24 15:43 deployed-composites
drwxr----- 2 jdoe dba 4096 Oct 24 15:43 se-configurations

oracle-dfw-7178460573556479044.tmp/soa_
config199325881615155981.d/deployed-composites:
total 12
drwxr----- 2 jdoe dba 4096 Oct 24 15:43 .
drwxr----- 4 jdoe dba 4096 Oct 24 15:43 ..
-rw-r----- 1 jdoe dba 1437 Oct 24 15:43 deployed-composites.xml

oracle-dfw-7178460573556479044.tmp/soa_
config199325881615155981.d/se-configurations:
total 56
drwxr----- 2 jdoe dba 4096 Oct 24 15:43 .
drwxr----- 4 jdoe dba 4096 Oct 24 15:43 ..
-rw-r----- 1 jdoe dba  267 Oct 24 15:43 adapter-config.xml
-rw-r----- 1 jdoe dba  425 Oct 24 15:43 b2b-config.xml
-rw-r----- 1 jdoe dba 2040 Oct 24 15:43 bpel-config.xml
-rw-r----- 1 jdoe dba 1525 Oct 24 15:43 bpmn-config.xml
-rw-r----- 1 jdoe dba  895 Oct 24 15:43 businessrules-config.xml
-rw-r----- 1 jdoe dba  119 Oct 24 15:43 cep-config.xml
-rw-r----- 1 jdoe dba  215 Oct 24 15:43 edn-config.xml
-rw-r----- 1 jdoe dba  836 Oct 24 15:43 mediator-config.xml
-rw-r----- 1 jdoe dba 1148 Oct 24 15:43 soa-infra-config.xml
-rw-r----- 1 jdoe dba 2693 Oct 24 15:43 workflow-config.xml
-rw-r----- 1 jdoe dba 2146 Oct 24 15:43 workflow-identity-config.xml
-rw-r----- 1 jdoe dba  605 Oct 24 15:43 workflow-notification

4. 次のWLSTコマンドライン構文を入力し、指定した出力ディレクトリのZIPファイルにすべてのダンプを圧縮するsoa.configのダンプを実行します。

wls:/soainfra/serverConfig> executeDump(name='soa.config', appName='soa-infra'
,args={'output':'/home/myhome/CFG_DUMP_DIR_APP_ZIP'})

12.2.3 データベース診断ダンプ(soa.db)

表12-6に、データベース診断ダンプの詳細を示します。取得されるデータベース情報のタイプには、Oracle SOA SuiteスキーマおよびMDSスキーマに関する状態別の件数や増加パターンなどのデータ形状情報が含まれます。

表12-6 データベース診断のダンプ

ダンプ名

ダンプ・パラメータ/ダンプ・モード

取得される情報

soa.db

- ダンプ・パラメータ
なし

- ダンプ・モード
ASYNC_SYNC

JDBCベースのアクセスを使用して問合せを実行し、結果をダンプしたBPELデータベース表増加データ

SELECT dt.table_name table_name,ds.bytes/1024/1024
segment_size_mb, ds.extents extents_used, dt.num_rows
total_rows, to_char(dt.last_analyzed,'YYYY-MM-DD
HH24:MI:SS') last_analyzed_date FROM dba_segments ds,
dba_tables dt WHERE dt.owner = ds.owner and dt.owner =
'schema_user_name' and dt.tablespace_name =
ds.tablespace_name and dt.table_name = ds.SEGMENT_NAME
and ds.segment_type = 'TABLE' and dt.table_name in
('CUBE_INSTANCE', 'MEDIATOR_CASE_INSTANCE','COMPOSITE_
INSTANCE', 'AUDIT_TRAIL', 'WORK_ITEM', 'DLV_MESSAGE',
'XML_DOCUMENT','DOCUMENT_CI_REF')

12.2.3.1 WLSTコマンド(ダンプの説明および実行)

1. 次のWLSTコマンドライン構文を入力し、ダンプの説明を表示し、soa.dbのダンプを実行します。

wls:/soainfra/serverConfig> describeDump(name='soa.db', appName='soa-infra')
Name: soa.db
Description: SOA diagnostic dump for SOA runtime DB usage info, e.g. bpel
growth statistics
Mandatory Arguments:
Optional Arguments:

wls:/soainfra/serverConfig> executeDump(name='soa.db', appName='soa-infra')
EXECUTE QUERY
SELECT dt.table_name table_name,ds.bytes/1024/1024 segment_size_mb, ds.extents
extents_used, dt.num_rows total_rows, to_char(dt.last_analyzed,
'YYYY-MM-DD HH24:MI:SS') last_analyzed_date FROM dba_segments ds,
dba_tables dt WHERE dt.owner = ds.owner and dt.owner ='schema_user_name'
and dt.tablespace_name = ds.tablespace_name and dt.table_name = ds.SEGMENT_NAME
and ds.segment_type = 'TABLE' and dt.table_name in ('CUBE_INSTANCE',
'MEDIATOR_CASE_INSTANCE','COMPOSITE_INSTANCE', 'AUDIT_TRAIL', 'WORK_ITEM',
'DLV_MESSAGE','XML_DOCUMENT','DOCUMENT_CI_REF')
COMMENT: BPEL DB GROWTH DATA.
TABLE_NAME   SEGMENT_SIZE_MB  EXTENTS_USED TOTAL_ROWS LAST_ANALYZED_DATE
-------------------------------------------------------------------------
ResultSet Metadata:weblogic.jdbc.wrapper.ResultSetMetadata_oracle_jdbc_driver_
OracleResultSetMetadata@76a4b0
RECORD #1:
TABLE_NAME: COMPOSITE_INSTANCE
SEGMENT_SIZE_MB:0
EXTENTS_USED:1
TOTAL_ROWS:9
LAST_ANALYZED_DATE:2011-09-30 22:02:25
RECORD #2:
TABLE_NAME:DOCUMENT_CI_REF
SEGMENT_SIZE_MB:0
EXTENTS_USED:1
TOTAL_ROWS:0
LAST_ANALYZED_DATE:2011-09-30 22:02:34
RECORD #3:
TABLE_NAME:WORK_ITEM
SEGMENT_SIZE_MB:0
EXTENTS_USED:1
TOTAL_ROWS:0
LAST_ANALYZED_DATE:2011-09-30 22:02:36
RECORD #4:
TABLE_NAME:AUDIT_TRAIL
SEGMENT_SIZE_MB:0
EXTENTS_USED:1
TOTAL_ROWS:8
LAST_ANALYZED_DATE:2011-09-30 22:02:39

このダンプは、問合せ文字列および結果セットのレコードを表示します。

12.2.4 デプロイ済コンポジット・メタデータの診断ダンプ(soa.composite)

表12-7に、デプロイ済コンポジット・メタデータの診断ダンプの詳細を示します。取得される情報のタイプには、インシデントの発生時に処理された現在のコンポジット、MDSアーティファクト参照(例: ネームスペース・エクスポート)および異常のあるトランザクションが含まれます。

表12-7 デプロイ済コンポジット・メタデータ診断のダンプ

ダンプ名

ダンプ・パラメータ/ダンプ・モード

取得される情報

soa.composite

- ダンプ・パラメータ
ecid: (オプション)実行コンテキストID (ECID)に関連付けられたSOAコンポジット・アプリケーションがマッチングされます。ecidを指定した場合、compositeName、partitionおよびrevisionは使用されません。ecidを指定しないで、他のパラメータを指定した場合は、これらのパラメータを使用してコンポジットがマッチングされます。どのパラメータも指定しないと、ダンプ・コンテキストからのECIDの取得が試行されます。

compositeName: (オプション)ダンプするMDS記録済アーティファクトが含まれているコンポジット名。値が指定されていない(Nullまたは空白)場合、compositeNameはワイルドカード(*)とみなされます。あらゆるコンポジット名と一致するワイルドカード(*)を入力することもできます。

partition: (オプション)コンポジットがデプロイされているパーティション名。指定されていない場合は、deployed-composites.xmlファイルに指定されているデフォルト・コンポジットのパーティションになります(例: default、partition_01、my_partition)。あらゆるパーティションと一致するワイルドカード(*)がサポートされています。

revision: (オプション)ダンプするMDS記録済アーティファクトが含まれているコンポジット・リビジョン(例: 1.0)。指定されていない場合は、deployed-composites.xmlファイルに指定されているデフォルト・コンポジットのリビジョンになります。あらゆるリビジョンと一致するワイルドカード(*)がサポートされています。

zip: (オプション)ダンプ出力をZIPファイルに圧縮するかどうかを示します。サポートされている値は次のとおりです。

- true: (デフォルト値)ダンプ・ファイルを単一のZIPファイルに圧縮します。

- false: ダンプのテキスト・ファイルおよびアーティファクトを、単一のZIPファイルに圧縮せずにダンプ・パス・ロケーションに書き込みます。

- output: (オプション)ダンプ・ファイルを書き込む代替ディレクトリの場所。指定されていない場合は、診断フレームワークのダンプ・パスが使用されます。

- ダンプ・モード
ASYNC_SYNC

MDSからのコンポジット・メタデータには、次のものが含まれます。

- 指定されたコンポジットのMDS記録済アーティファクトすべて。

- テキスト・ダンプ・ファイルには、ダンプ対象コンポジットのMDSアーティファクトおよび保存先に関するロギング情報が格納されます。

- 単一のZIPファイルに圧縮されたすべてのダンプ・ファイル。

- WLSTで使用されるユーザー指定の出力ファイルの場所。

- 1つ以上の生成されたscratch_entries.txtファイル。scratch_entries.txtファイルは、あるデプロイ済コンポジット用のスクラッチ領域のディレクトリ・リストを含むコンポジットごとのファイルです。デプロイ済コンポジット用のスクラッチ領域は、コンポジットがデプロイされたときに生成されたアーティファクト(生成されたJAXBコードなど)を保持するための領域です。
スクラッチ領域の場所は、deployed-composites/deployed-composites.xmlのcomposite-revision要素で指定されます。

- soa.compositeダンプは、コンポジットにJCAバインディングが含まれている場合、soa.adapter.raダンプをコールします。これは
soa_adapter_ra/ adapter-cf-config-properties.txtファイルにコネクション・ファクトリのプロパティをダンプします。

12.2.4.1 WLSTコマンド(ダンプの説明および実行)

1. 次のWLSTコマンドライン構文を入力し、ダンプの説明を表示し、soa.compositeのダンプを実行します。

wls:/soainfra/serverConfig> describeDump(name='soa.composite'
, appName='soa-infra')
Name: soa.composite
Description: SOA diagnostic dump that captures composite MDS artifacts, and
scratch area entries listing for composite's scratch area, dump MDS artifacts
for composites that either match specified parameters:
composite name/partition/revision, or associated with an ECID (Execution
Context ID identifying a message flow across multiple composite instance(s),
support wild card '*' as composite name/partition/revision, meaning matching
composites with any composite name/any partition/any revision.
Rules for actual parameter evaluation:
if ecid is specified, use it to match composites associated with the ECID,
composite name/partition/revision not used. ;
if ecid is not specified, then use composite name/partition/revision to match
composites;
if composite name/partition/revision are not specified (all missing), try to
get ECID from dump context;
if ECID is obtained from dump context, use it to match composites associated
with it,
if no ECID from dump context, try to obtain composite name from dump context,
if composite name obtained from dump context, then apply dump to all deployed
composites.
Mandatory Arguments:
Optional Arguments:
Name        Type      Description
ecid        STRING    ECID (Execution Context ID - for tracking message flow
across multiple composite instances), when present,
will be used to locate composites associated with it,
and other composite matching parameters ignored; it can
be obtained from dump context if not specified as dump
parameter, see rules for actual parameter evaluation
for details.
zip         BOOLEAN   Boolean flag (default to 'true') indicating if the dump
files need to be compressed into one single zip file,
true - dump into a single zip file, false, otherwise,
default: true.
revision    STRING    Revision of composite , e.g. '1.0', '2.0', can be wild
card meaning matching any revision, when missing,
assume default composite's revision in the composite
series.
partition   STRING    Partition of composite, default to partition(s)
associated with resolved revision(s) can be wild
card '*', meaning matching any partition.
compositeName STRING  Composite name, e.g., 'OrderProcessing', can be wild
card '*', meaning matching any composite.
output      STRING   Output destination directory where dump contents
are written to, default to DFW dump path.

wls:/soainfra/serverConfig> executeDump(name='soa.composite',
appName='soa-infra',args=('compositeName':'WSInMedPubBpelSubFileOut',
'revision':'1.0','partition':'default','output':'/home/myhome/COMPOSITE_DUMP_
MDS_ZIP'})
. . .
. . .
Start dumping composite [name=WSInMedPubBpelSubFileOut, partition=partition_1,
revision= 1.0 ] MDS metadata to :/tmp/soa_dumps1019331262763443905.tmp/
soa_composite4533356433976235311.d/partition_1/WSInMedPubBpelSubFileOut_
rev1.0
Finished dumping composite MDS metadata to :/tmp/soa_dumps
1019331262763443905.tmp/soa_composite4533356433976235311.d/default
/WSInMedPubBpelSubFileOut_rev1.0

ダンプ出力ファイルは、指定のダンプ場所である/home/myhome/COMPOSITE_DUMP_MDS_ZIPに作成されます。

「Location」フィールドには、指定の場所に圧縮されたダンプ結果が表示されます。ナビゲータの左側には、ZIPファイルのMDSアーティファクトが表示されます(例: .edlファイル、.bpelファイルなど)。下部の.txtファイルは、ZIPファイル内のメインのダンプ・ファイルです。

2. 次のWLSTコマンドライン構文を入力し、すべてのSOAコンポジット・アプリケーション、リビジョンおよびパーティションを含むsoa.compositeのダンプを実行します。

wls:/soainfra/serverConfig> executeDump(name='soa.composite',
appName='soa-infra',args=('compositeName':'*',
'revision':'*','partition':'*','output':'/home/myhome//COMPOSITE_DUMP_
DIR_ALLCOMP_ALL_REV_ALL_PART'})

「Location」フィールドには、指定の場所に圧縮されたダンプ結果が表示されます。

すべてのリビジョンを含むすべてのパーティションのすべてのSOAコンポジット・アプリケーションがダンプされます。

12.2.5 インスタンス監査証跡の診断ダンプ(soa.composite.trail)

表12-8に、インスタンス監査証跡の診断ダンプの詳細を示します。取得される情報のタイプには、SOAコンポジット・アプリケーション・インスタンスの監査証跡、個々のサービス・コンポーネントの監査証跡、フォルト、センサー、およびECIDによって識別されるメッセージ・フローに関連するイベント配信ネットワーク(EDN)情報が含まれます。

表12-8 インスタンス監査証跡診断のダンプ

ダンプ名

ダンプ・パラメータ/ダンプ・モード

取得される情報

soa.composite.trail

- ダンプ・パラメータ
ecid (オプション): 複数のSOAコンポジット・アプリケーション・インスタンスにわたるメッセージ・フローを追跡するための実行コンテンツID。

- zip (オプション): 次の値がサポートされます。
- true: (デフォルト値)ダンプ・ファイルを単一のZIPファイルに圧縮します。

- false: ダンプのテキスト・ファイルおよびアーティファクトを、単一のZIPファイルに圧縮せずにダンプ・パス・ロケーションに書き込みます。

- ダンプ・モード
ASYNC_SYNC

- ECIDに関連付けられている最上位の監査証跡と、コンポジット・インスタンスおよびサービス・コンポーネント・インスタンスのレベルの監査証跡。すべて、コンポジット・インスタンスまたはサービス・コンポーネント・インスタンスごとに1つのファイルに書き込まれます。メインのダンプ・ファイルは、個々のダンプ・アーティファクトのそれぞれ(たとえば、ECIDに関連付けられたコンポジット・インスタンスまたはサービス・コンポーネント・インスタンス)のエントリをログします。 エントリは、ダンプ・アーティファクトの名前、タイプ、作成日、場所など(たとえば、監査証跡raw XMLが配置されているファイルへのパス)を記録するメイン・ダンプ・ファイルに書き込まれます。
このダンプはインバウンド・メッセージによってトリガーされるメッセージ・ルーティングを実行するためのものです。最上位の監査証跡は、現在のランタイム・コンテキストで次のFacade APIをコールすることで取得したXML CLOBです。

oracle.soa.management.facade.Locator.getAuditTrail(ECID ecid)

- コンポジット・インスタンス情報。

- 各コンポジット・インスタンスのコンポーネント・インスタンス情報。

- ECIDに関連するフォルトは、専用のフォルト・ファイルにダンプされます。

- Facade APIからのEDN情報。

- 各コンポジット・インスタンスのセンサー・インスタンス情報。

12.2.5.1 WLSTコマンド(ダンプの説明および実行)

1. 次のWLSTコマンドライン構文を入力し、ダンプの説明を表示し、soa.composite.trailのダンプを実行します。

wls:/soainfra/serverConfig> describeDump(name='soa.composite.trail'
, appName='soa-infra')
Name: soa.composite.trail
Description: SOA diagnostic dump for a given ECID (Execution Context ID
identifying a message flow across multiple composite instances),
captures composite application instances audit trail, components
audit trail, faults, sensors, etc. associated with the message
flow identified by the ECID;
Rules for actual parameter evaluation:
if ecid is specified, use it to match composites associated
with the ECID, if ecid is not specified, try to get ECID
from dump context, if ECID is obtained from dump context, use
it to match composites associated with it, if no ECID from
dump context, throw exception.
Mandatory Arguments:
Optional Arguments:
Name        Type       Description
ecid        STRING     ECID (Execution Context ID- for tracking message flow
across multiple composite instances).
zip        BOOLEAN    Boolean flag (default to 'true') indicating if the
dump files need to be compressed into one single zip
file, true - compress dump result into a single zip,
false, otherwise, default: true

wls:/soainfra/serverConfig> executeDump(name='soa.composite.trail',
appName='soa-infra',args={'ecid':'cf1cec292805f383:-598c1140:1388238a4ce:-8000-
00000000000028c1'})

Executing SOA Diagnostic Dump: soa.composite.trail
Description: SOA diagnostic dump that, for a given ECID (Execution Context ID
identifying a message flow across multiple composite instances), captures
composite application instances audit trail, components audit trail, faults,
sensors, etc. associated with the message flow indentified by the ECID;
Rules for actual parameter evaluation:
if ecid is specified, use it to match composites associated with the ECID,
if ecid is not specified, try to get ECID from dump context,
if ECID is obtained from dump context, use it to match composites associated
with it,if no ECID from dump context, throw exception.
Parameters:
Optional::ecid::STRING::ECID(Execution Context ID - for tracking message flow
across multiple composite instances),
Optional::zip::BOOLEAN::Boolean flag (default to 'true') indicating if the dump
files need to be compressed into one single zip file, true - compress dump
result into a single zip, false, otherwise, default: true.
Parameter Values:
parameter::ecid=cf1cec292805f383:-598c1140:1388238a4ce:-8000-00000000000028c1
parameter::zip=NULL
Normalized dump parameters:
ecid=cf1cec292805f383:-598c1140:1388238a4ce:-8000-00000000000028c1
zip=true
Start dumping audit trails for ECID =
[cf1cec292805f383:-598c1140:1388238a4ce:-8000-00000000000028c1], to destination
: /tmp/oracle-dfw-3352979816637176191.tmp
FAULTS=
Trail data =>/tmp/oracle-dfw-3352979816637176191.tmp/soa_
dumps2431385805259626695.tmp/soa_composite_trail4522512822868494030.d/audit_
trail.xml
EDN.INFO = /tmp/oracle-dfw-3352979816637176191.tmp/soa_
dumps2431385805259626695.tmp/soa_composite_trail4522512822868494030.d/edn_
info.txt
composite.1.DN=default/CompositeWithEDN_11G!1.0
composite.1.ID=3
composite.1.TenantID=-1
composite.1.Created=Fri Jul 13 15:32:03 PDT 2012
composite.1.State=-1
composite.1.StateAsString=STATE_UNKNOWN
composite.1.Status=null
No trail found...
composite.1.component.1.Name=BpelSub
composite.1.component.1.Type=bpel
composite.1.component.1.ID=bpel:1
composite.1.component.1.State=5
composite.1.component.1.StateAsString=STATE_SUSPENDED
composite.1.component.1.Status=completed
Trail data =>/tmp/oracle-dfw-3352979816637176191.tmp/soa_
dumps2431385805259626695.tmp/soa_composite_
trail4522512822868494030.d/default/CompositeWithEDN_11G_1.0_3/BpelSub_bpel_1_
component.xml
SENSOR.INFO = /tmp/oracle-dfw-3352979816637176191.tmp/soa_
dumps2431385805259626695.tmp/soa_composite_
trail4522512822868494030.d/default/CompositeWithEDN_11G_1.0_3_sensor.txt
composite.2.DN=partition_1/CompositeWithEDN_11G!1.0
composite.2.ID=2
composite.2.TenantID=-1
composite.2.Created=Fri Jul 13 15:31:58 PDT 2012
composite.2.State=-1
composite.2.StateAsString=STATE_UNKNOWN
composite.2.Status=null
No trail found...
composite.2.component.1.Name=BpelSub
composite.2.component.1.Type=bpel
composite.2.component.1.ID=bpel:2
composite.2.component.1.State=5
composite.2.component.1.StateAsString=STATE_SUSPENDED
composite.2.component.1.Status=completed
Trail data =>/tmp/oracle-dfw-3352979816637176191.tmp/soa_
dumps2431385805259626695.tmp/soa_composite_
trail4522512822868494030.d/partition_1/CompositeWithEDN_11G_1.0_2/BpelSub_bpel_
2_component.xml
SENSOR.INFO = /tmp/oracle-dfw-3352979816637176191.tmp/soa_
dumps2431385805259626695.tmp/soa_composite_
trail4522512822868494030.d/partition_1/CompositeWithEDN_11G_1.0_2_sensor.txt
composite.3.DN=partition_1/CompositeWithEDN_11G!1.0
composite.3.ID=1
composite.3.TenantID=-1
composite.3.Created=Fri Jul 13 15:31:24 PDT 2012
composite.3.State=-1
composite.3.StateAsString=STATE_UNKNOWN
composite.3.Status=null
No trail found...
composite.3.component.1.Name=MediatorPub
composite.3.component.1.Type=mediator
composite.3.component.1.ID=mediator:7CC2E450CD3A11E1BF3F897791557FF9
composite.3.component.1.State=2
composite.3.component.1.StateAsString=STATE_COMPLETED_SUCCESSFULLY
composite.3.component.1.Status=null
Trail data =>/tmp/oracle-dfw-3352979816637176191.tmp/soa_
dumps2431385805259626695.tmp/soa_composite_
trail4522512822868494030.d/partition_1/CompositeWithEDN_11G_1.0_1/MediatorPub_
mediator_7CC2E450CD3A11E1BF3F897791557FF9_component.xml
SENSOR.INFO = /tmp/oracle-dfw-3352979816637176191.tmp/soa_
dumps2431385805259626695.tmp/soa_composite_
trail4522512822868494030.d/partition_1/CompositeWithEDN_11G_1.0_1_sensor.txt
Number of composite instance associated with the ECID
[cf1cec292805f383:-598c1140:1388238a4ce:-8000-00000000000028c1]: 3
Audit trails dumped for ECID =
[cf1cec292805f383:-598c1140:1388238a4ce:-8000-00000000000028c1], at the
location :/tmp/oracle-dfw-3352979816637176191.tmp
Compressing dump files from directory:
[/tmp/oracle-dfw-3352979816637176191.tmp/soa_dumps2431385805259626695.tmp/soa_
composite_trail4522512822868494030.d] to
[/tmp/oracle-dfw-3352979816637176191.tmp/soa_composite_
trail4522512822868494030.zip].

ECIDの取得方法は、第14.1「BPELプロセス・サービス・コンポーネントの監査証跡とプロセス・フローの監視」を参照してください。

12.2.6 イベント診断ダンプ(soa.edn)

表12-9に、イベント診断ダンプの詳細を示します。取得される情報のタイプには、EDNビジネス・イベント・バス・ステータス情報およびEDNデータベース・ログ・レコードが含まれます。

表12-9 イベント診断のダンプ

ダンプ名

ダンプ・パラメータ/ダンプ・モード

取得される情報

soa.edn

- ダンプ・パラメータ
dumpEDNDBLOG: 次の値がサポートされています。

- true: EDNデータベース・メッセージ・ログをダンプします。

- false (デフォルト値): EDNデータベース・メッセージ・ログをダンプしません。

- ダンプ・モード
ASYNC_SYNC

- EDNイベント・バス状態変数

- デプロイされたすべてのコンポジットなどのEDNサブスクライバ/パブリッシャ情報

- EDNデータベース・メッセージ・ログ。

- クラスタ情報(クラスタ名、メンバー名、isLeader値、ローカル・メンバー、マシンID、ラックIDなど)。

すべての情報はダンプ・テキスト・ファイルに書き込まれます。

12.2.6.1 WLSTコマンド(ダンプの説明および実行)

1. 次のWLSTコマンドライン構文を入力し、ダンプの説明を表示し、soa.ednのダンプを実行します。

wls:/soainfra/serverConfig> describeDump(name='soa.edn', appName='soa-infra')
Name: soa.edn
Description: SOA diagnostic dump that captures EDN BusinessEventBus status
info, and optionally, EDN DB Log records.
Mandatory Arguments:
Optional Arguments:
Name         Type       Description
dumpEDNDBLOG BOOLEAN    Flag indicating whether EDN DB logs included; false:
EDN DB log not included. default: false.

wls:/soainfra/serverConfig> executeDump(name='soa.edn', appName='soa-infra')

Executing SOA Diagnostic Dump: soa.edn
Description: SOA diagnostic dump that captures EDN BusinessEventBus status
info, and optionally, EDN DB Log records.
Parameters:
Optional::dumpEDNDBLOG::BOOLEAN::Flag indicating whether EDN DB log included
or not, true: EDN DB log included, false: EDN DB log not included, default:
false.
Parameter Values:
parameter::dumpEDNDBLOG=NULL
Type:oracle.integration.platform.blocks.event.saq.SAQBusinessEventBus
Configuration:null
Status: running=true started=true
ThreadCount:3
RetryCount:3
In Global: Tx:false
Cluster Info:oracle.integration.platform.blocks.cluster.CoherenceCluster
Interface1mpt@163bd717
SharedEDN:false
OOAO Queue Name:edn_ooao_queue
Java Subscriber Name:edn java subscriber
Subscription Info:
No namespace subscription...
QName subscriptions:
=============================================================
qname={http://schemas.oracle.com/events/edl/ActionOccur}ADEvent
subscriptions=
id=default/WSInMedPubBpelSubFileOut!1.0*soa_7a055d6a-8402-49c2-ac56-5f85cbf3d7f/
BpelSub, consistencyLevel=ONE_AND_ONLY_ONE, filter=XPath Filter: starts-with(/
be:business-event/be:content/ns0:ActionOccurrence/ns0:ParentEntityType/@value,
'A'), runAsRoles=[$publisher]
id=partition_1/WSInMedPubBpelSubFileOut!1.0*soa_80a169ab1-395a-4b87-9986-9fa2742a8bd3/
BpelSub, consistencyLevel=ONE_AND_ONLY_ONE, filter=XPath Filter: starts-with(/
be:business-event/be:content/ns0:ActionOccurrence/ns0:ParentEntityType/@value,
'A'), runAsRoles=[$publisher]
EventThreadContextInfo:
EventTargets:
Event:partition_1/WSInMedPubBpelSubFileOut!1.0*soa0a169ab1-395a-4b87-9986-9fa2742a9bd3/
BpelSub:::oracle.fabric.BPELServiceEngine@163bd6b5
Event:default/WSInMedPubBpelSubFileOut!1.0*soa7a055d6a-8402-49c2-ac56-5f85cbf3
d7f/BpelSub:::oracle.fabric.BPELServiceEngine@163bd6b5
EDN DB Log enabled:false

executeDumpコマンドは、イベント・バス・ステータス変数(1mpt@163bd717)およびイベント・パブリッシュ/サブスクリプション情報をダンプします。edn-db-logがfalseに設定されているため、ログ・メッセージ情報はダンプされません。edn-db-logは、次のURLで有効にできます。

http://host_name:port/soa-infra/events/edn-db-log

注意:

- edn-db-logを有効または無効にするには、管理者権限が必要です。

- デバッグ・セッション終了後は、常にedn-db-logを無効にしてロギングを無効にします。これにより、EDNデータベース・ログ表のデータベースの過剰な増加が防止されます。edn-db-logを有効のままにすると、データベースにパブリッシュ/エンキューされるイベントとデータベースからサブスクライブ/デキューされるイベントに関連するデバッグ・メッセージが、特定のEDNデータベース・ログ表に引き続き保持されます。これは表が無限に増加する原因となります。

12.2.7 デプロイ済コンポジットWSDL/スキーマ・キャッシュの診断ダンプ(soa.wsdl)

表12-10は、指定のパラメータ(コンポジット名、パーティションおよびリビジョン)に一致するコンポジットについてキャッシュされたサービス定義情報の詳細を示します。

表12-10 デプロイ済コンポジットWSDL/スキーマ・キャッシュ診断のダンプ

ダンプ名

ダンプ・パラメータ/ダンプ・モード

取得される情報

soa.wsdl

- ダンプ・パラメータ
ecid: (オプション)複数のコンポジット・インスタンスにわたるメッセージ・フローを追跡するためのECID。このパラメータが指定されている場合は、関連付けられたコンポジットがすべて発見されます。他のコンポジット一致パラメータは無視されます。ECIDがダンプ・パラメータとして指定されていない場合、これはダンプ・コンテキストから取得できます。

compositeName: (オプション)ダンプするキー・サービス定義情報(WSDL)が含まれているコンポジット名(WSDL参照およびXSD参照も含む)。値が指定されていない(Nullまたは空白)場合、compositeNameはワイルドカード(*)とみなされます。あらゆるコンポジットと一致するワイルドカード(*)がサポートされています。

partition: (オプション)コンポジットがデプロイされているパーティション名。指定されていない場合は、deployed-composites.xmlファイルに指定されているデフォルト・コンポジットのパーティションになります。あらゆるパーティションと一致するワイルドカード(*)がサポートされています。

revision: (オプション)ダンプする(WSDLからの)サービス定義情報が含まれているコンポジット・リビジョン(例: 1.0)。指定されていない場合は、deployed-composites.xmlファイルに指定されているデフォルト・コンポジットのリビジョンになります。あらゆるリビジョンと一致するワイルドカード(*)がサポートされています。

- ダンプ・モード
ASYNC_SYNC

- コンポジットの識別名(DN)。例: compositeDN:partition_1/WSInMedPubBpelSubFileOut!1.0*soa_8a169ab1-395a-4b87-9986-9fa2742a8bd3

- シリーズのデフォルトかどうか。

- コンポジット名。

- コンポジット状態(「オン」または「オフ」)。

- コンポジット・モード(「アクティブ」または「リタイア」)。

- すべてのサービス定義の修飾名およびターゲット・ネームスペース(共有WSDLからのものを含む): javax.wsdl.Definitionオブジェクト
- サービス名: QName javax.wsdl.Definition.getQName()

- ターゲット・ネームスペース: javax.wsdl.Definition.getTargetNamespace()

- SchemaManager状態変数
- SchemaManager.isPostDeploy()

- SchemaManager.isShared()

- SchemaManager.schemaAddedSinceLastBuild()

- サービス定義によって参照されるXMLスキーマ定義
- メッセージ・タイプQName

- メッセージ・タイプSchemaTargetNamespace

- メッセージ・タイプTargetNS

12.2.7.1 WLSTコマンド(ダンプの説明および実行)

1. 次のWLSTコマンドライン構文を入力し、ダンプの説明を表示し、soa.wsdlのダンプを実行します。

wls:/soainfra/serverConfig> describeDump(name='soa.wsdl', appName='soa-infra')

Name: soa.wsdl
Description: SOA diagnostic dump that captures services definition info cached
for composite(s) that match specified parameters: composite namne
partition/revision, support wild card '*' as composite name/
partition/revision, meaning matching composites with any
composite name/any partition/any revision.

Rules for actual parameter evaluation:
if ecid is specified, use it to match composites associated with the ECID,
composite name/partition/revision not used. ;
if ecid is not specified, then use composite name/partition/revision to match
composites;
if composite name/partition/revision are not specified (all missing), try to
get ECID from dump context;
if ECID is obtained from dump context, use it to match composites associated
with it,
if no ECID from dump context, try to obtain composite name from dump context,
if composite name obtained from dump context, then apply dump to all deployed
composites.
Mandatory Arguments:
Optional Arguments:
Name        Type     Description
ecid        STRING   ECID (Execution Context ID - for tracking message
flow across multiple composite instances), when
present, will be used to locate coposites associated
with it and other composite matching parameters are
ignored; it can be obtained from dump context if not
specified as dump parameter; see rules for actual
parameter evaluation for details.
revision    STRING    Revision of composite , e.g. '1.0', '2.0', can be wild
card meaning matching any revision, when missing,
assume default composite's revision in the composite
series.
partition   STRING    Partition of composite, default to partition(s)
associated with resolved revision(s) can be wild
card '*', meaning matching any partition.
compositeName STRING  Composite name, e.g., 'OrderProcessing', can be wild
card '*', meaning matching any composite.

wls:/soainfra/serverConfig> executeDump(name='soa.wsdl', appName='soa-infra'
,arg=('compositeName':'WSInMedPubBpelSubFileOut',
'revision':'1.0','partition':'partition_1'})compositeDN:partition_
1/WSInMedPubBpelSubFileOut!1.0*soa_8a169ab1-2060-4b87-9986-9fa2742a8bd3
. . .
. . .
----------------------------------------------------------------------
is default in series:true
composite application name:partition_1
composite name:WSInMedPubBpelSubFileOut
composite state:on
composite mode:active
WSDLManager Instance:oracle.fabric.common.wsdl.WSDLManager@164ec201
Cached wsdl Definitions for the specified composite: including any shared
wsdls if there are any:
key=http://xmlns.oracle.com/bpel/workflow/taskService
value=QName:{http://xmlns.oracle.com/bpel/workflow/taskService}
TaskServicetarget name space:http://xmlns.oracle.com/bpel/workflow/taskService
key=urn:MyTestWsdl
value=QName:{urn:MyTestWsdl}target name space:urn:MyTestwsdl
key=http://xmlns.oracle.com/adapter/file/LixinSandboxes/WSInMedPubBpelSubFile
Out/FileWrite
value=QName:{http://xmlns.oracle.com/pcbpel/adapter/file/LixinSandboxes/
WSInMedPubBpelSubFileOut/FileWrite}FileWritetarget name space:http:
//xmlns.oracle.com/pcbpel/adapter/file/LixinSandboxes/
WSInMedPubBpelSubFileOut/FileWrite
count of all cached entries:3
SchemaManager instance:oracle.fabric.common.wsdl.SchemaManager@164ec1f8
SchemaManager.isPostDeploy():true
SchemaManager.isShared():false
SchemaManager.schemaAddressSinceLastBuild():false
Cached schema count:0
WSDLManager instance:oracle.fabric.common.wsdl.WSDLManager@14b5b8b0
cached wsdl definitions for the specified composite: including shared wsdls
if there is any:
---------------------------------------------------------------------------
key=http://xmlns.oracle.com/bpel/workflow/taskService
value=QName:{http://xmlns.oracle.com/bpel/workflow/taskService}
TaskServicetarget name space:http://xmlns.oracle.com/bpel/workflow/taskService
count of all cached entries:1
SchemaManager instance:oracle.fabric.common.wsdl.SchemaManager@145b8cc
SchemaManager.isPostDeploy():false
SchemaManager.isShared():true
SchemaManager.schemaAddressSinceLastBuild():true
Cached schema count:0

WSDLManager instance:oracle.fabric.common.wsdl.WSDLManager@14b58b0
WSDLManager instance:oracle.fabric.common.wsdl.WSDLManager@14b58b0
cached wsdl definitions for the specified composite: including shared wsdls
if there is any:
-------------------------------------------------

key=http://xmlns.oracle.com/bpel/workflow/taskService
value=QName:{http://xmlns.oracle.com/bpel/workflow/taskService}
TaskServicetarget name space:http://xmlns.oracle.com/bpel/workflow/taskService
count of all cached entries:1
SchemaManager instance:oracle.fabric.common.wsdl.SchemaManager@145b8cc
SchemaManager.isPostDeploy():false
SchemaManager.isShared():true
SchemaManager.schemaAddressSinceLastBuild():true
Cached schema count:0

12.2.8 ディスパッチャの静的構成の診断ダンプ(bpel.dispatcher)

表12-11に、ディスパッチャの静的構成の診断ダンプの詳細を示します。

表12-11 ディスパッチャの静的構成の診断ダンプ

ダンプ名

ダンプ・パラメータ/ダンプ・モード

取得される情報

bpel.dispatcher

- ダンプ・パラメータ
format: (オプション)値xmlを指定すると、ダンプ診断出力がXML形式で表示されます。

- ダンプ・モード
ASYNC_SYNC

ダンプを(1)インシデントのスレッド・コンテキストで実行できる場合(同期)、(2)インシデントのコンテキストでは実行できなくても診断情報を生成できる場合は、このSOA診断ダンプをASYNC_SYNCとしてマークしても問題ありません。

静的プール構成(ディスパッチャ構成)

- 監査、呼出しおよび非ブロッキング呼出しスレッド数

- エンジンおよびシステム・スレッド

ランタイム・メッセージ・キュー・サイズ:

- スケジュール済メッセージ(処理を待機中のキュー内のメッセージ)数の合計

- 稼働中メッセージ(現在処理中のメッセージ)数の合計

ランタイム・メッセージ・キューのブレークダウン・サイズ(処理済メッセージ合計数、エラーが発生したメッセージの合計数、メッセージの平均保留時間および平均実行時間):

- 監査キュー

- エンジン・キュー

- 起動キュー

- 非ブロッキング起動キュー

- システム・キュー

12.2.8.1 WLSTコマンド(ダンプの説明および実行)

この項で説明されているWLSTコマンドに加え、システムMBeanブラウザを通してディスパッチャの静的構成の診断情報を取得することもできます。このオプションでは、起動キュー、配信キューおよびインスタンス・キューのスケジュール済メッセージと稼働中メッセージに関するより具体的な詳細を取得できます。詳細は、第12.2.8.2項「システムMBeanブラウザを使用したディスパッチャの静的構成の診断ダンプの取得」を参照してください。

1. 次のWLSTコマンドライン構文を入力し、ダンプの説明を表示して、bpel.dispatcherのダンプを実行します。

wls:/soainfra/serverConfig> describeDump(name='bpel.dispatcher', appName='soa-infra')

Name: bpel.dispatcher
Description: BPEL dispatcher config info.
This dumps the information about the static (System, Invoke, Engine and Audit
thread counts) and runtime Scheduled and Working Message Counts
Mandatory Arguments:
Optional Arguments:
Name        Type     Description
format      STRING   passing value of 'xml' will produce the output in xml
format - args={'format':'xml'}

wls:/soainfra/serverConfig> executeDump(name='bpel.dispatcher',
appName='soa-infra')
BPEL Service Engine Dispatcher Info:

Static Pool Configurations

Audit Thread Count:        3
Engine Threads:       30
Invoke Thread Count:       20
Non-Blocking Invoke Thread Count:        2
System Threads:        2

Runtime Message Queue Sizes

Total Scheduled Message Count:        352
Total Working Message Count:         50

Runtime Message Queue Breakdown Sizes

Audit Queue :
Total Processed Messages  :0
Total Errored Messages  :0
Average Message Pending Time         :n/a
Average Message Execution Time       :n/a

| Scheduled  | Working
---------------- | ---------- | -------
audit |          0 |       0

Engine Queue :
Total Processed Messages   :879
Total Errored Messages :0
Average Message Pending Time        :2304.08
Average Message Execution Time       :905.56

| Scheduled  | Working
---------------- | ---------- | -------
domain |          0 |       0
process |          0 |       0
delivery |        253 |      19
instance |         56 |      11

Invoke Queue :
Total Processed Messages  :714
Total Errored Messages    :0
Average Message Pending Time      :1385.2
Average Message Execution Time      :954.33

| Scheduled  | Working
---------------- | ---------- | -------
invoke |          0 |       0

Non-Blocking Invoke Queue :
Total Processed Messages  :0
Total Errored Messages  :0
Average Message Pending Time         :n/a
Average Message Execution Time       :n/a

| Scheduled  | Working
---------------- | ---------- | -------
non-block-invoke |          0 |       0

System Queue :
Total Processed Messages  :1
Total Errored Messages    :1
Average Message Pending Time         :272
Average Message Execution Time     :11014

| Scheduled  | Working
---------------- | ---------- | -------
system |          0 |       0
maintenance |          0 |       0

2. 次のWLSTコマンドライン構文を入力し、bpel.dispatcherのダンプをXML形式で実行します。

executeDump(name='bpel.dispatcher', appName='soa-infra', args={'format':'xml'})

<dispatcher-trace invokeThreadCount="20" systemThreadCount="2"
nonBlockInvokeThreadCount="2" auditThreadCount="5" engineThreadCount="30">
<systemSet totalErroredMsgs="1" avgMsgPendingTime="277"
avgMsgExecTime="11014" totalProcessedMsgs="1">
<systemQueue>
<scheduled count="0"/>
<working count="0"/>
</systemQueue>
<maintenanceQueue>
<scheduled count="0"/>
<working count="0"/>
</maintenanceQueue>
</systemSet>
<invokeSet totalErroredMsgs="0" avgMsgPendingTime="803.82"
avgMsgExecTime="987.51" totalProcessedMsgs="385">
<invokeQueue>
<scheduled count="43"/>
<working count="20"/>
</invokeQueue>
</invokeSet>
<engineSet totalErroredMsgs="0" avgMsgPendingTime="2391.25"
avgMsgExecTime="1127.45" totalProcessedMsgs="343">
<domainQueue>
<scheduled count="0"/>
<working count="0"/>
</domainQueue>
<processQueue>
<scheduled count="43"/>
<working count="20"/>
</processQueue>
<deliveryQueue>
<scheduled count=147"/>
<working count="14"/>
</deliveryQueue>
<instanceQueue>
<scheduled count="75"/>
<working count="16"/>
</instanceQueue>
</engineSet>
<auditSet totalErroredMsgs="0" avgMsgPendingTime="n/a"
avgMsgExecTime="n/a" totalProcessedMsgs="0">
<auditQueue>
<scheduled count="0"/>
<working count="0"/>
</auditQueue>
</auditSet>
<non-block-invokeSet totalErroredMsgs="0" avgMsgPendingTime="n/a"
avgMsgExecTime="n/a" totalProcessedMsgs="0">
<non-block-invokeQueue>
<scheduled count="0"/>
<working count="20"/>
</non-block-invokeQueue>
</non-block-invokeSet>
</dispatcher-trace>

12.2.8.2 システムMBeanブラウザを使用したディスパッチャの静的構成の診断ダンプの取得

「readXMLDispatcherTrace」プロパティを呼び出すことで、ディスパッチャの静的構成の診断ダンプをシステムMBeanブラウザに表示することもできます。このオプションでは、起動キュー、配信キューおよびインスタンス・キューの現在処理中のメッセージや処理がスケジュールされたメッセージに関して、WLST executeDumpコマンド(第12.2.8.1項「WLSTコマンド(ダンプの説明および実行)」を参照)で取得するより具体的な詳細を取得できます。

1. ナビゲーション・ツリーで「SOA」フォルダを開きます。

2. 「soa-infra」を右クリックして、「管理」→「システムMBeanブラウザ」の順に選択します。

3. 「アプリケーション定義のMBean」→「oracle.as.soainfra.bpm」→「Server: server_name」→「bpel」→「CubeDispatcher」の順に選択します。

4. 「readXMLDispatcherTrace」をクリックします。

5. 「呼出し」をクリックします。
結果はプロパティ・ウィンドウに表示されます。

12.2.9 平均インスタンス処理時間の診断ダンプ(bpel.apt)

表12-12に、インスタンス平均処理時間の診断ダンプの詳細を示します。この情報は、BPELプロセス・サービス・エンジンに保持されるインスタンスの作成および最終変更のタイムスタンプから取得されます。

表12-12 インスタンス平均処理時間の診断ダンプ

ダンプ名

ダンプ・パラメータ/ダンプ・モード

取得される情報

bpel.apt

- ダンプ・パラメータ
format: (オプション)値xmlを指定すると、ダンプ診断出力がXML形式で表示されます。

- ダンプ・モード
ASYNC_SYNC

ダンプを(1)インシデントのスレッド・コンテキストで実行できる場合(同期)、(2)インシデントのコンテキストでは実行できなくても診断情報を生成できる場合は、この診断ダンプをASYNC_SYNCとしてマークしても問題ありません。

様々なプロセスのインスタンスが実行時に必要とする平均時間。この情報は永続ストアから取得され、プロセスが呼び出したパートナの所要時間を含みます。平均時間は秒単位です。

12.2.9.1 WLSTコマンド(ダンプの説明および実行)

1. 次のWLSTコマンドライン構文を入力し、ダンプの説明を表示して、bpel.aptのダンプを実行します。

wls:/soainfra/serverConfig> describeDump(name='bpel.apt', appName='soa-infra')

Name: bpel.apt
Description: BPEL Instance Average Procesing Time information.
This information is obtained from the creation and last modify
timestamp for the instance in the BPEL Engine persistence repository
Mandatory Arguments:
Optional Arguments:
Name        Type     Description
format      STRING   passing value of 'xml' will produce the output in xml
format - args={'format':'xml'}

wls:/soainfra/serverConfig> executeDump(name='bpel.apt',
appName='soa-infra')

BPEL Service Engine Instance Average Processing Time Info:

Composite |      Component |   Instances |  Average Processing Time (secs)
-------------| -------------- |-------------|--------------------------------
forEach |   DummyService |            2|            0.01
|           Test |            3|            0.09
-------------| -------------- |-------------|--------------------------------
LinkInvoke |     AsynchBPEL |            1|            0.01
|     LinkInvoke |            2|            0.11
|       SyncBPEL |            2|            0.01
-------------| -------------- |-------------|--------------------------------
RelaxSyntax | SyncBPELService|            2|            0.02
-----------------------------------------------------------------------------

2. 次のWLSTコマンドライン構文を入力し、bpel.aptのダンプをXML形式で実行します。

executeDump(name='bpel.apt', appName='soa-infra', args={'format':'xml'})

<AvgInstanceProcessingTime timestamp="2012-03-15 13:11:40.442">
<Composite name="forEach">
<Component name="DummyService" instances="2" Avg="0.01"/>
<Component name="Test" instances="3" Avg="9.09"/>
</Composite>
<Composite name="LinkInvoke">
<Component name="AsynchBPEL" instances="1" Avg="0.01"/>
<Component name="LinkInvoke" instances="2" Avg="0.11"/>
<Component name="SyncBPEL" instances="2" Avg="0.01"/>
</Composite>
<Composite name="RelaxSyntax">
<Component name="SyncBPELService" instances="2" Avg="0.02"/>
</Composite>
</AvgInstanceProcessingTime>

12.2.10 平均インスタンス処理遅延の診断ダンプ(bpel.apd)

表12-13は、非同期プロセスの平均インスタンス処理遅延の診断ダンプの詳細を示します。このダンプは、BPELプロセス・サービス・エンジンがデータベースから保存されているメッセージを取り出してそのメッセージの処理を開始するまでの平均所要時間を示します。この統計は、インメモリーからではなく、データベースから生成されます。

表12-13 平均インスタンス処理遅延の診断ダンプ

ダンプ名

ダンプ・パラメータ/ダンプ・モード

取得される情報

bpel.apd

- ダンプ・パラメータ
format: (オプション)値xmlを指定すると、ダンプ診断出力がXML形式で表示されます。

- ダンプ・モード
ASYNC_SYNC

ダンプを(1)インシデントのスレッド・コンテキストで実行できる場合(同期)、(2)インシデントのコンテキストでは実行できなくても診断情報を生成できる場合は、このSOA診断ダンプをASYNC_SYNCとしてマークしても問題ありません。

プロセス・インスタンスをトリガーする受信メッセージの受信からBPELサービス・エンジンが実際にメッセージの処理を開始するまでの起動処理の平均遅延。

注意: 第12.2.9項「平均インスタンス処理時間の診断ダンプ(bpel.apt)」で説明されているダンプは、プロセス・インスタンスの合計実行時間を示します。これは、アクティビティを処理するための時間の関数で、パートナ(1つ以上がコールされている場合)の所要時間も含まれます。 ただし、受信メッセージは処理される前にまず非同期通信用のデータベースに格納されるため、システムのボトルネックを診断するためにより具体的な詳細が必要とされる場合があります。したがって、データベースからメッセージを選択するBPELプロセス・サービス・エンジンの遅延の詳細も、bpel.apdダンプによって提供されます。

このダンプ情報は、インメモリーからではなく、データベースから生成されます。BPELプロセス・サービス・エンジンの各種レイヤーでの遅延に関するさらなる詳細とより効果的な分析については、第14.6.1項「「リクエストのブレークダウン」表の下位レベルの詳細の表示」を参照してください。

12.2.10.1 WLSTコマンド(ダンプの説明および実行)

注意:

- このダンプはデータベースに対して実行されるので、レコード数が非常に多い場合は問合せの実行に長時間かかる場合があります。

- 問い合わせるデータを制限するためのフィルタはありません。

- ダンプは、データベースがBPELプロセス・サービス・エンジンの通常の永続スキーマの外部を表示する際に指定された問合せを実行します。表示を直接チューニングして、結果を改善できます。

1. 次のWLSTコマンドライン構文を入力し、ダンプの説明を表示して、bpel.apdのダンプを実行します。

wls:/soainfra/serverConfig> describeDump(name='bpel.apd', appName='soa-infra')

Name: bpel.apd
Description: BPEL Instance Average Processing Delay information (for
Asynchronous Processes).
This provides dump for information regarding the following:
Average Invoke Processing Delay:
Time delay between receipt of incoming message that triggers the
process instance and the time engine actually start processing the message.

Mandatory Arguments:
Optional Arguments:
Name        Type     Description
format      STRING   passing value of 'xml' will produce the output in xml
format - args={'format':'xml'}

wls:/soainfra/serverConfig> executeDump(name='bpel.apd',
appName='soa-infra')

********Average Invoke Processing Delay********

Composite| Component|    Partner Link|  Operation|  Avg Invoke Processing Delay
(secs)
-------- | -------- | ---------------|-----------------------------------------
Call | AsynchBP | asynchBP_client|    process|           0.05
-------- | -------- | -------------- |-----------|-----------------------------
Test |  Caller2 |  caller2_client|    process|           0.04
-------- | -------- | -------------- |-----------|-----------------------------
EvnTest |  EDNProc |            null|       null|           0.03
-------- | -------- | -------------- |-----------|-----------------------------
forEach |     Echo |          client|   initiate|           0.07
-------- | -------- | -------------- |-----------|-----------------------------

2. 次のWLSTコマンドライン構文を入力し、bpel.apdのダンプをXML形式で実行します。

executeDump(name='bpel.apd', appName='soa-infra', args={'format':'xml'})

<AvgInstanceProcessingDelays timestamp="2012-03-15 13:11:40.442">
<AvgInvokeProcessingDelays>
<Composite name="Call">
<Component name="AsynchBP">
<Partner Link name="asynchBP_client">
<Operation name="process" Avg="0.05"/>
</Partner Link>
</Component>
</Composite>
<Composite name="Test">
<Component name="Caller2">
<Partner Link name="Caller2_client">
<Operation name="process" Avg="0.04"/>
</Partner Link>
</Component>
</Composite>
<Composite name="EvnTest">
<Component name="EDNProc">
<Partner Link name="null">
<Operation name="null" Avg="0.03"/>
</Partner Link>
</Component>
</Composite>
<Composite name="forEach">
<Component name="Echo">
<Partner Link name="client">
<Operation name="initiate" Avg="0.07"/>
</Partner Link>
</Component>
</Composite>
</AvgInvokeProcessingDelays>
</AvgInstanceProcessingDelays

12.2.11 同期プロセス統計の診断ダンプ(bpel.sps)

表12-14は、同期プロセス統計の診断ダンプの詳細を示します。このダンプは、最小、最大および平均処理時間(ミリ秒単位)、ならびに処理されたインスタンスの数を示します。第14.6.1項「「リクエストのブレークダウン」表の下位レベルの詳細の表示」で説明されているシステムMBeanブラウザの「StatsLastN」プロパティを、この診断ダンプを取得するように構成する必要があります。ただし、オプションのダンプ・パラメータのdurationとbufferが指定されており、「StatsLastN」が構成されていない場合、このダンプ・コマンドはスループット(毎秒のトランザクション数)の統計情報を提供します。

表12-14 同期プロセス統計の診断ダンプ

ダンプ名

ダンプ・パラメータ/ダンプ・モード

取得される情報

bpel.sps

- ダンプ・パラメータ
buffer: (オプション)バッファ範囲の値を指定します(100-100000)。

duration: (オプション)期間の値を指定します(1 - 10000)。

format: (オプション)値xmlを指定すると、ダンプ診断出力がXML形式で表示されます。

- ダンプ・モード
ASYNC_SYNC

同期プロセスの最小、最大および平均処理時間(ミリ秒単位)、ならびに処理されたインスタンスの数。

12.2.11.1 WLSTコマンド(ダンプの説明および実行)

1. 次のWLSTコマンドライン構文を入力し、ダンプの説明を表示して、bpel.spsのダンプを実行します。

wls:/soainfra/serverConfig> describeDump(name='bpel.sps', appName='soa-infra')

Description: Statistics for Synchronous Business Processes
This dump provides process level (Synchronous BPEL Processes only) statistics
such as min, max and average processing time (in milli-secs) and count of
instances processed.  Note that statsLastN must be configured to obtain this
output. However, if optional parameters duration and buffer are specified and
statsLastN is not configured, this dump command would enable the stats for the
throughput (transaction per sec) information
Run Mode: asynchronous
Mandatory Arguments:
Optional Arguments:
Name     Type   Description
buffer   STRING Range for buffer: 100-100000. Example: args={'buffer':'100'}
duration STRING Range for duration: 1-10000. Example: args={'duration':'1'}
format   STRING Passing value of 'xml' will produce the output in xml format.
Example: args={'format':'xml'}

2. 次のWLSTコマンドライン構文を入力し、「StatsLastN」を構成してbpel.spsのダンプを実行します。

wls:/soainfra/serverConfig> executeDump(name='bpel.sps',
appName='soa-infra')

Synchronous Process Stats

Process Id:                                                                   |
------------------------------------------------------------------------------|
default/Synchronous!1.0*soa_13036d87-f3ec-4954-9777-e93248c43086/BPELProcess1 |

|Minimum(m-sec) |Maximum(m-sec) |Average(m-sec) |Count
------------------------------------------------|-----
| 3             | 3             | 3.0           | 1

3. 次のWLSTコマンドライン構文を入力し、「StatsLastN」を構成してXML形式でbpel.spsのダンプを実行します。

wls:/soainfra/serverConfig> executeDump(name='bpel.sps', appName='soa-infra',
args={'format':'xml'})

<statistics>
<stats key="default/Synchronous!1.0*soa_13036d87-f3ec-4954-9777-
e93248c43086/BPELProcess1" min="3" max="3" average="3.0" count="1">
</stats>
</statistics>

4. 次のWLSTコマンドライン構文を入力し、durationおよびbufferパラメータのスループット値を指定して、bpel.spsのダンプを実行します。

wls:/soainfra/serverConfig> executeDump(name='bpel.sps', appName='soa-infra',
args={'duration':'10', 'buffer':'1000'})

Synchronous Process Stats (with Throughput)

Timestamp Start: 2012-07-25 10:41:16.457
Timestamp End: 2012-07-25 10:42:16.462
Sampling Window (seconds): 60
Buffer Size: 1000

Process Id:
-------------------------------------------------------------------
default/MsgProps20!1.0*soa_fe114dd1-fcfa-494a-920d-6ebd9b670/SyncM |
default/MsgProps!1.0*soa_78ab10-e820-4aa-86e3-87b8c88a1/SyncMsg    |

|Minimum(m-sec) |Maximum(m-sec) |Average(m-sec) |Count |Throughput (tps)
------------------------------------------------------------------------
125            | 125           | 125.0         | 1    | 0.01
15             | 15            | 15.0          | 1    | 0.01

5. 次のWLSTコマンドライン構文を入力し、durationおよびbufferパラメータのスループット値を指定し、StatsLastNを構成しないで、XML形式でbpel.spsのダンプを実行します。

wls:/soainfra/serverConfig> executeDump(name='bpel.sps', appName='soa-infra',
args={'format':'xml', 'duration':'10', 'buffer':'1000'})

<statistics timestamp-start ='2012-07-25 10:10:09.128' timestamp-end
='2012-07-25 10:10:19.13'>
<stats key="default/MtomTestClient!1.0*soa_65dc8543-3e2949e1-a07a-637c25c722
a1/BPELProcess1" min="1292" max="1292" average="1292.0" count="1" throughput=
"0.1">
</stats>
<stats key="default/WSBPELFAProj!1.0*soa_352731eb-44c5-4db6-aff1-e6a440f3a343/WSBPELFAProcess" min="287" max="287"
average="287.0" count="1" throughput="0.1">
</stats>
</statistics>

12.2.12 非同期プロセス統計の診断ダンプ(bpel.aps)

表12-15は、非同期プロセス統計の診断ダンプの詳細を示します。このダンプは、プロセス・レベル(非同期BPELプロセスのみ)の統計(最小、最大および平均処理時間(ミリ秒単位)など)、ならびに処理されたインスタンスの数を提供します。第14.6.1項「「リクエストのブレークダウン」表の下位レベルの詳細の表示」で説明されているシステムMBeanブラウザの「StatsLastN」プロパティを、この出力を取得するように構成する必要があります。ただし、オプションのパラメータのdurationとbufferが指定されており、「StatsLastN」が構成されていない場合、このダンプ・コマンドはスループット(毎秒のトランザクション数)の統計情報を提供します。

表12-15 非同期プロセス統計の診断ダンプ

ダンプ名

ダンプ・パラメータ/ダンプ・モード

取得される情報

bpel.aps

- ダンプ・パラメータ
buffer: (オプション)バッファ範囲の値を指定します(100-100000)。

duration: (オプション)期間の値を指定します(1 - 10000)。

format: (オプション)値xmlを指定すると、ダンプ診断出力がXML形式で表示されます。

- ダンプ・モード
ASYNC_SYNC

非同期プロセスの最小、最大および平均処理時間(ミリ秒単位)、ならびに処理されたインスタンスの数。

12.2.12.1 WLSTコマンド(ダンプの説明および実行)

1. 次のWLSTコマンドライン構文を入力し、ダンプの説明を表示して、bpel.apsのダンプを実行します。

wls:/soainfra/serverConfig> describeDump(name='bpel.aps', appName='soa-infra')

Name: bpel.aps
Description: Statistics for Asynchronous Business Processes
This dump provides process level (Asynchronous BPEL Processes only) statistics
such as min, max and average processing time (in milli-secs) and count of
instances processed. Note that statsLastN must be configured to obtain this
output. However, if optional parameters duration and buffer are specified and
statsLastN is not configured, this dump command would enable the stats for the
throughput (transaction per sec) information
Run Mode: asynchronous
Mandatory Arguments:
Optional Arguments:
Name     Type    Description
buffer   STRING  Range for buffer: 100-100000 .Example: args={'buffer':'100'}
duration STRING  Range for duration: 1-10000 .Example: args={'duration':'1'}
format   STRING  Passing value of 'xml' will produce the output in xml
format. Example: args={'format':'xml'}

2. 次のWLSTコマンドライン構文を入力し、「StatsLastN」を構成してbpel.apsのダンプを実行します。

wls:/soainfra/serverConfig> executeDump(name='bpel.aps',
appName='soa-infra')

Asynchronous Process Stats

Process Id:                                                                   |
------------------------------------------------------------------------------|
default/Asynchronous!1.0*soa_5c3b99b2-e1ad-4a24-9d13-f02dd8a268e/BPELProcess1 |
default/Asynchronous!1.0*soa_5c3b99b2-e1ad-4a24-9d13-f02dd8a268e/BPELProcessC |

|Minimum(m-sec) |Maximum(m-sec) |Average(m-sec) |Count
------------------------------------------------|-----
| 4             | 4             | 4.0           | 0
| 70            | 70            | 70.0          | 1

3. 次のWLSTコマンドライン構文を入力し、「StatsLastN」を構成してXML形式でbpel.apsのダンプを実行します。

executeDump(name='bpel.aps', appName='soa-infra', args={'format':'xml'})

<statistics>
<stats key="default/Asynchronous!1.0*soa_5c3b99b2-e1ad-4a24-9d13-f02dd8a268e/
BPELProcess1 min="4" max="4" average="4.0" count="0">
</stats>
<stats key="default/Asynchronous!1.0*soa_5c3b99b2-e1ad-4a24-9d13-f02dd8a268e/
BPELProcess1Client min="70" max="70" average="70.0" count="1">
</stats>
</statistics>

4. 次のWLSTコマンドライン構文を入力し、durationおよびbufferパラメータのスループット値を指定して、bpel.apsのダンプを実行します。

wls:/soainfra/serverConfig> executeDump(name='bpel.aps', appName='soa-infra',
args={'duration':'60', 'buffer':'1000'})
Asynchronous Process Stats (with Throughput)

Timestamp Start: 2012-07-25 10:15:31.207
Timestamp End: 2012-07-25 10:16:31.232
Sampling Window (seconds): 60
Buffer Size: 1000

Process Id:                                                     |Minimum(m-sec)
------------------------------------------------------------------------------
default/ch10.4fromParts2!1.0*soa_86cfa7a5-76f3-49fa-908a-1f9b8c | 3111

|Maximum(m-sec) |Average(m-sec) |Count |Throughput (tps)
------------------------------------------------------------------------------
| 3111          | 3111.0        | 1    | 0.01

5. 次のWLSTコマンドライン構文を入力し、durationおよびbufferパラメータのスループット値を指定し、「StatsLastN」を構成しないで、XML形式でbpel.apsのダンプを実行します。

wls:/soainfra/serverConfig> executeDump(name='bpel.aps', appName='soa-infra',
args={'format':'xml', 'duration':'60', 'buffer':'1000'})

<statistics timestamp-start ="2012-07-25 10:19:10.937' timestamp-end
='2012-07-25 10:21:10.946">
<stats key="/default/ch11.6flow!1.0*soa_bb2b4125-068b-40d8-9eed-28b71fef6c36f/Test"
min="322" max="322" average="322.0" count="1" throughput="0.01">
</stats>
<stats key="default/ch11.7forEachSeq!1.0*soa_c7bb5f85-dcbc-4c96-a3aa-977fe5ef17cd/Test"
min="356" max="356" average="356.0" count="1" throughput="0.01">
</stats>
<stats key="default/ch11.7forEachPar!1.0*soa_8271932d-5af1-4ebe-b8ed-e1d8b3302b75/Test"
min="2492" max="2492" average="2492.0" count="1" throughput="0.01">
</stats>
</statistics>

12.2.13リクエスト統計の診断ダンプ(bpel.rs)

表12-16に、リクエスト診断ダンプの詳細を示します。このダンプは、最小、最大および平均処理時間(ミリ秒単位)、ならびにBPELプロセス・サービス・エンジンの各種レイヤーを通して流れながら処理されたリクエストの数を示します。第14.6.1項「「リクエストのブレークダウン」表の下位レベルの詳細の表示」で説明されているシステムMBeanブラウザの「StatsLastN」プロパティを、この診断ダンプを取得するように構成する必要があります。ただし、オプションのダンプ・パラメータのdurationとbufferが指定されており、「StatsLastN」が構成されていない場合、このダンプ・コマンドはスループット(毎秒のトランザクション数)の統計情報を提供します。

表12-16 リクエスト統計の診断ダンプ

ダンプ名

ダンプ・パラメータ/ダンプ・モード

取得される情報

bpel.rs

- ダンプ・パラメータ
buffer: (オプション)バッファ範囲の値を指定します(100-100000)。

duration: (オプション)期間の値を指定します(1 - 10000)。

format: (オプション)値xmlを指定すると、ダンプ診断出力がXML形式で表示されます。

- ダンプ・モード
ASYNC_SYNC

最小、最大および平均処理時間(ミリ秒単位)、ならびにBPELプロセス・サービス・エンジンの各種レイヤーを通して流れながら処理されたリクエストの数。

12.2.13.1 WLSTコマンド(ダンプの説明および実行)

1. 次のWLSTコマンドライン構文を入力し、ダンプの説明を表示し、bpel.rsのダンプを実行します。

wls:/soainfra/serverConfig> describeDump(name='bpel.rs', appName='soa-infra')

Name: bpel.rs
Description: Statistics for Requests processing by Engine.
This dump provides request level statistics such as min, max and average
processing time (in milli-secs) and count of requests processed as the request
flows though various layers of engine. Note that statsLastN must be configured
to obtain this output. However, if optional parameters duration and buffer are
specified and statsLastN is not configured, this dump command would enable the
stats for the defined interval duration and return statistics which will also
include the throughput (transaction per sec) information
Run Mode: asynchronous
Mandatory Arguments:
Optional Arguments:
Name     Type    Description
buffer   STRING  Range for buffer: 100-100000. Example: args={'buffer':'100'}
duration STRING  Range for duration: 1-10000 .Example: args={'duration':'1'}
format   STRING  Passing value of 'xml' will produce the output in xml
format. Example: args={'format':'xml'}

2. 次のWLSTコマンドライン構文を入力し、「StatsLastN」を構成してbpel.rsのダンプを実行します。

wls:/soainfra/serverConfig> executeDump(name='bpel.rs', appName='soa-infra')

または

wls:/soainfra/serverConfig> executeDump(name='bpel.rs', appName='soa-infra',
args={'format':'xml'})

<stats key="eng-composite-request" min="0" max="0" average="0.0" count="0">
<stats key="eng-single-request" min="2" max="3059" average="62.58" count="51">
<stats key="create-and-invoke" min="2" max="3059" average="62.54" count="51">
<stats key="glue-requests-store" min="0" max="1016" average="20.84" count="51">
<stats key="storeBatchEvent" min="0" max="42" average="1.31" count="51">
</stats>
<stats key="scope-serialize" min="0" max="857" average="16.92" count="51">
</stats>
</stats>
<stats key="create-instance" min="0" max="117" average="2.47" count="51">
<stats key="get-process-descriptor" min="0" max="0" average="0.0" count="51">
</stats>
<stats key="factory-create" min="0" max="86" average="1.72" count="51">
</stats>
<stats key="init-root-scope" min="0" max="22" average="0.52" count="51">
</stats>
<stats key="declare-wi-lookup-table" min="0" max="1" average="0.01" count="51">
</stats>
<stats key="init-request-context" min="0" max="0" average="0.0" count="51">
</stats>
</stats>
<stats key="log-sync-stats" min="0" max="3" average="0.05" count="51">
</stats>
<stats key="lookup-process" min="0" max="0" average="0.0" count="51">
</stats>
<stats key="log-requests-stats" min="0" max="1" average="0.01" count="51">
</stats>
<stats key="recycle-objects" min="0" max="0" average="0.0" count="153">
</stats>
<stats key="invoke-method" min="0" max="1445" average="28.58" count="51">
<stats key="audit-counter-create" min="0" max="1430" average="28.23"
count="51">
<stats key="eng-manage" min="0" max="499" average="9.9" count="51">
<stats key="sensor-send-activity-data" min="0" max="0" average="0.0"
count="102">
</stats>
<stats key="monitor-send-activity-data" min="0" max="0" average="0.0"
count="102">
</stats>
</stats>
<stats key="monitor-send-activity-data" min="0" max="0" average="0.0" count="51">
</stats>
<stats key="sensor-send-activity-data" min="0" max="1" average="0.01" count="51">
</stats>
</stats>
***
<stats key="check-access-control" min="0" max="15" average="0.1" count="153">
</stats>
<stats key="check-block-conditions" min="0" max="42" average="0.59" count="153">
<stats key="eng-finalize" min="0" max="42" average="0.55" count="153">
<stats key="eng-manage" min="0" max="9" average="0.13" count="102">
</stats>
<stats key="eng-until" min="0" max="41" average="0.35" count="153">
<stats key="monitor-send-activity-data" min="0" max="0" average="0.0"
count="153">
</stats>
<stats key="sensor-send-activity-data" min="0" max="0" average="0.0" count="153">
</stats>
</stats>
</stats>
<stats key="check-expirable" min="0" max="1" average="0.0" count="153">
</stats>
<stats key="get-node" min="0" max="1" average="0.0" count="153">
</stats>
</stats>
<stats key="get-workitem" min="0" max="35" average="0.24" count="153">
<stats key="load-workitem" min="0" max="5" average="0.03" count="153">
</stats>
<stats key="load-instance-for-workitem" min="0" max="30" average="0.2"
count="153">
<stats key="load-instance" min="0" max="25" average="0.16" count="153">
<stats key="actual-instance-load" min="0" max="25" average="0.16" count="153">
<stats key="cube-instance-load-context" min="0" max="0" average="0.0"
count="153">
</stats>
</stats>
</stats>
<stats key="check-bpel-process-state" min="0" max="1" average="0.0"
count="153">
</stats>
<stats key="populate-context" min="0" max="25" average="0.0" count="153">
</stats>
</stats>
</stats>
</stats>
</stats>
</stats>
<stats key="recycle-objects" min="0" max="1" average="0.01" count="51">
</stats>
</stats>
</stats>
</statistics>

3. 次のWLSTコマンドライン構文を入力し、durationおよびbufferパラメータのスループット値を指定し、「StatsLastN」を構成しないで、bpel.rsのダンプを実行します。

wls:/soainfra/serverConfig> executeDump(name='bpel.rs', appName='soa-infra',
args={'duration':'10', 'buffer':'1000'})

または

wls:/soainfra/serverConfig> executeDump(name='bpel.rs', appName='soa-infra',
args={'format':'xml','duration':'10', 'buffer':'1000'})

<statistics timestamp-start ='2012-07-25 10:12:27.536' timestamp-end
='2012-07-25 10:12:27.546'>
<stats key="eng-composite-request" min="0" max="0" average="0.0" count="0">
<stats key="eng-single-request" min="19" max="55" average="31.75" count="4">
<stats key="create-and-invoke" min="19" max="55" average="31.75" count="4">
<stats key="glue-requests-store" min="2" max="14" average="5.75" count="4">
<stats key="storeBatchEvent" min="1" max="2" average="1.75" count="4">
</stats>
<stats key="scope-serialize" min="8" max="18" average="2.5" count="4">
</stats>
</stats>
<stats key="create-instance" min="0" max="9" average="2.5" count="4">
<stats key="get-process-descriptor" min="0" max="0" average="0.0" count="4">
</stats>
<stats key="factory-create" min="0" max="0" average="0.0" count="4">
</stats>
<stats key="init-root-scope" min="0" max="9" average="2.5" count="4">
</stats>
<stats key="declare-wi-lookup-table" min="0" max="0" average="0.0" count="4">
</stats>
<stats key="init-request-context" min="0" max="0" average="0.0" count="4">
</stats>
</stats>
<stats key="log-sync-stats" min="0" max="0" average="0.0" count="4">
</stats>
<stats key="lookup-process" min="0" max="0" average="0.0" count="4">
</stats>
<stats key="log-requests-stats" min="0" max="0" average="0.0" count="4">
</stats>
<stats key="recycle-objects" min="0" max="0" average="0.0" count="23">
</stats>
<stats key="invoke-method" min="1" max="9" average="3.0" count="4">
<stats key="audit-counter-create" min="1" max="1" average="1.0" count="4">
<stats key="eng-manage" min="0" max="1" average="0.5" count="4">
<stats key="sensor-send-activity-data" min="0" max="0" average="0.0" count="8">
</stats>
<stats key="monitor-send-activity-data" min="0" max="0" average="0.0" count="8">
</stats>
</stats>
<stats key="monitor-send-activity-data" min="0" max="0" average="0.0" count="4">
</stats>
<stats key="sensor-send-activity-data" min="0" max="0" average="0.0" count="4">
</stats>

12.2.14 リシーケンサ・グループ処理遅延の診断ダンプ(mediator.resequencer)

表12-17は、リシーケンサ・グループ処理遅延の診断ダンプの詳細を示します。

表12-17 リシーケンサ・グループ処理遅延の診断ダンプ

ダンプ名

ダンプ・パラメータ/ダンプ・モード

取得される情報

mediator. resequencer

- ダンプ・パラメータ:
resequencerMaxUnprocessTime: (必須)診断ダンプに含める前にリシーケンサ・グループが非アクティブになっていることが必要な分数を指定します。

- ダンプ・モード
ASYNC_SYNC

グループ情報:

- コンポーネントDN(名前)

- 操作

- グループID

- グループのステータス

- コンポーネントのステータス

- 最終受信時刻

- コンテナID

- 保留メッセージ数

- 最終リフレッシュ時刻

コンテナ情報:

- コンテナID

- リシーケンサ・タイプ

12.2.14.1 WLSTコマンド(ダンプの説明および実行)

1. 次のWLSTコマンドライン構文を入力し、mediator.resequencerのダンプの説明を表示します。

wls:/soainfra/serverConfig> describeDump(name='mediator.resequencer',
appName='soa-infra')

次の情報が表示されます。

Name: mediator.resequencer
Description: diagnostic information about the groups, which have not been processed beyond user specified maximum unprocess time
Run Mode: asynchronous
Mandatory Arguments:
Name                         Type     Description
resequencerMaxUnprocessTime INTEGER  maximum duration for which the group has
not been processed, duration should be
specified in minutes
Optional Arguments:

2. 次のWLSTコマンドライン構文を入力し、mediator.resequencerのダンプを実行します。

wls:/soainfra/serverConfig> executeDump(name='mediator.resequencer',
appName='soa-infra', args={'resequencerMaxUnprocessTime':'minutes'}

minutesは、ダンプに含まれる前にリシーケンサ・グループを保留できる分数で置き換えます。次のような情報が表示されます。

Database Timestamp in UTC :2012-03-29 06:29:31.0
Max unprocess time condition:1
Mediator Resquencer pending group data
COMPONENT_DN,OPERATION,GROUP_ID,STATUS,COMPONENT_STATUS,LAST_RECEIVED_TIME,
CONTAINER_ID, PENDING MESSAGE COUNT
default/Standard!2.0/Mediator1,execute,1001,0,0,2012-03-29
06:24:22.509394,EC09D271796511E18F5CBD26553417B4,1
------------------------------------------------------------------------------
Containerid Data
containerId,renewalTime
EC09D271796511E18F5CBD26553417B4,java.util.GregorianCalendar[time=1333002526625
,areFieldsSet=true,areAllFieldsSet=true,lenient=true,zone=sun.util.calendar.Zon
eInfo[id="GMT-07:00",offset=-25200000,dstSavings=0,useDaylight=false,transition
s=0,lastRule=null],firstDayOfWeek=1,minimalDaysInFirstWeek=1,ERA=1,YEAR=2012,MO
NTH=2,WEEK_OF_YEAR=13,WEEK_OF_MONTH=5,DAY_OF_MONTH=28,DAY_OF_YEAR=88,DAY_OF_
WEEK=4,DAY_OF_WEEK_IN_MONTH=4,AM_PM=1,HOUR=11,HOUR_OF_
DAY=23,MINUTE=28,SECOND=46,MILLISECOND=625,ZONE_OFFSET=-25200000,DST_OFFSET=0]

12.2.15 アダプタ診断ダンプ(soa.adapter.ra)

表12-18に、コネクション・ファクトリ構成のダンプの詳細を示します。

表12-18 アダプタ診断ダンプ

ダンプ名

ダンプ・パラメータ/ダンプ・モード

取得される情報

soa.adapter.ra

- ダンプ・パラメータ
ecid: (オプション)ecid jndiNameおよびadapterTypeを指定します。

- ダンプ・モード
ASYNC

コネクション・ファクトリ情報をダンプします。

- 管理対象のコネクション・ファクトリのプロパティ

- 接続プールのプロパティ

- トランザクション・サポートのプロパティ

複数のコンポジットが同じJNDIを使用しているかどうかを示します。

12.2.15.1 WLSTコマンド(ダンプの説明および実行)

1. 次のWLSTコマンドライン構文を入力し、soa.adapter.raのダンプの説明を表示します。

wls:/soainfra/serverConfig> describeDump(name='soa.adapter.ra',
appName='soa-infra')

次の情報が表示されます。

Name: soa.adapter.ra
Description: SOA adapter diagnostic dump that captures connection factory
configurations.
Rules for actual parameter evaluation:
if ecid is specified, use it to match composites associated with the ECID,
composite name/partition/revision not used;
if ecid is not specified, then use jndiName & adapterType to retrieve the
connection factory attributes;
if jndiName and adapterType are not specified, then use composite
name/partition/revision to match composites;
if no composite name/partition/revision are specified, then all the composites
with jca binding are dumped.
Mandatory Arguments:
Optional Arguments:
Name        Type     Description
ecid        STRING   ECID(Execution Context ID - for tracking message flow
across multiple composite instances), when presents, will be used to locate
composites associated with it, and other composite matching parameters ignored;
it can be obtained from dump context if not specified as dump parameter, see
rules for actual parameter evaluation for details.
revision    STRING   Revision of composite, e.g. '1.0', '2.0', can be wild
card '*', meaning matching any revision, when missing, assume default
composite's revision in the composite series.
adapterType STRING   Resource Adapter type
partition   STRING   Partition of composite, default to partition(s)
associated with resolved revision(s), can be wild card '*', meaning matching
any partition.
compositeName       STRING   Composite name, e.g., 'OrderProcessing', can
be wild card '*',meaning matching any composite.
jndiName    STRING   Adapter Connection Pool JNDI

2. 次のWLSTコマンドライン構文を入力し、soa.adapter.raのダンプを実行します。

wls:/soainfra/serverConfig> executeDump(name='soa.adapter.ra',
appName='soa-infra', args={'compositeName':'fa', 'partition':'default',
'revision':'1.0'})

次の情報が表示されます。

CompositeDN = default/fa!1.0*soa_7ce2ebd9-ce17-4b5a-b436-2567eab33af2
Endpoint Name = service
Endpoint type = Service
JNDI Name = eis/FileAdapter
Adapter Type = FileAdapter

Pool Parameters -
==================

initial-capacity = 10
test-connections-on-create = false
test-connections-on-reserve = false
connection-creation-retry-frequency-seconds = 2
shrinking-enabled = true
ignore-in-use-connections-enabled = true
highest-num-waiters = 0
shrink-frequency-seconds = 60
connection-reserve-timeout-seconds = 5
highest-num-unavailable = 0
max-capacity = 2147483647
profile-harvest-frequency-seconds = 300
capacity-increment = 100
test-connections-on-release = false
match-connections-supported = false
test-frequency-seconds = 0

Transaction Support = NoTransaction

Connection Factory Properties -
===============================

outboundDataSource = none
outboundDataSourceLocal = none
outboundLockTypeForWrite = none
controlDir = ${user.dir}
inboundDataSource = none
workingDirectory = default

================================================================

CompositeDN = default/fa!1.0*soa_7ce2ebd9-ce17-4b5a-b436-2567eab33af2
Endpoint Name = reference
Endpoint type = Reference
JNDI Name = eis/FileAdapter
Adapter Type = FileAdapter

Pool Parameters -
==================

initial-capacity = 10
test-connections-on-create = false
test-connections-on-reserve = false
connection-creation-retry-frequency-seconds = 2
shrinking-enabled = true
ignore-in-use-connections-enabled = true
highest-num-waiters = 0
shrink-frequency-seconds = 60
connection-reserve-timeout-seconds = 5
highest-num-unavailable = 0
max-capacity = 2147483647
profile-harvest-frequency-seconds = 300
capacity-increment = 100
test-connections-on-release = false
match-connections-supported = false
test-frequency-seconds = 0

Transaction Support = NoTransaction

Connection Factory Properties -
===============================

outboundDataSource = none
outboundDataSourceLocal = none
outboundLockTypeForWrite = none
controlDir = ${user.dir}inboundDataSource = noneworkingDirectory = default

12.2.16 アダプタ診断ダンプ(soa.adapter.connpool)

表12-19はアダプタ接続プールのダンプを示します。

表12-19 アダプタ診断ダンプ

ダンプ名

ダンプ・パラメータ/ダンプ・モード

取得される情報

soa.adapter.connpool

- ダンプ・パラメータ
ecid: (オプション)ecid jndiName、adapterType compositeName、partition、revision adapterTypeおよびjndiNameを指定します。

- ダンプ・モード
ASYNC

構成されたコネクション・ファクトリJNDIの接続プール統計をダンプします。

12.2.16.1 WLSTコマンド(ダンプの説明および実行)

1. 次のWLSTコマンドライン構文を入力し、soa.adapter.connpoolのダンプの説明を表示します。

wls:/soainfra/serverConfig> describeDump(name='soa.adapter.connpool',
appName='soa-infra')

次の情報が表示されます。

Name: soa.adapter.connpool
Description: SOA adapter diagnostic dump that captures the Connection pool
stats for configured adapters JNDI.
Rules for actual parameter evaluation:
if ecid is specified, use it to match composites associated with the ECID,
composite name/partition/revision not used;
if ecid is not specified, then use jndiName & adapterType to retrieve the
connection pool attributes;
if jndiName and adapterType are not specified, then use composite
name/partition/revision to match composites;
if no composite name/partition/revision are specified, then all the composites
with jca binding are dumped.
Mandatory Arguments:
Optional Arguments:
Name        Type     Description
ecid        STRING   ECID(Execution Context ID - for tracking message flow
across multiple composite instances), when presents, will be used to locate
composites associated with it, and other composite matching parameters ignored;
it can be obtained from dump context if not specified as dump parameter, see
rules for actual parameter evaluation for details.
revision    STRING   Revision of composite, e.g. '1.0', '2.0', can be wild card
'*', meaning matching any revision, when missing, assume default composite's
revision in the composite series.
adapterType STRING   Resource Adapter type
partition   STRING   Partition of composite, default to partition(s)
associated with resolved revision(s), can be wild card '*', meaning matching
any partition.
compositeName       STRING   Composite name, e.g., 'OrderProcessing', can
be wild card '*',meaning matching any composite.
jndiName    STRING   Adapter Connection Pool JNDI

2. 次のWLSTコマンドライン構文を入力し、soa.adapter.connpoolのダンプを実行します。

wls:/soainfra/serverConfig> executeDump(name='soa.adapter.connpool',
appName='soa-infra', args={'compositeName':'fa', 'partition':'default',
'revision':'1.0'})

次の情報が表示されます。

CompositeDN=default/fa!1.0*soa_7ce2ebd9-ce17-4b5a-b436-2567eab33af2
Endpoint Name = service
Endpoint type = Service
JNDI Name =eis/FileAdapter
Adapter Type =FileAdapter

ConnectionPool Attributes:
==========================

Important ConnectionPool Attributes:
====================================
InitialCapacity = 10
MaxCapacity = 2147483647
CurrentCapacity = 10
State = Running
FreeConnectionsCurrentCount = 10
NumUnavailableCurrentCount = 0
NumberDetectedLeaks = 0
ConnectionsDestroyedByErrorTotalCount = 0
ConnectionsRejectedTotalCount = 0

Other ConnectionPool Attributes:
================================
ActiveConnectionsCurrentCount = 0
FreePoolSizeHighWaterMark = 0
PoolSizeLowWaterMark = 0
ConnectionsMatchedTotalCount = 0
LastShrinkTime = 0
FreeConnectionsHighCount = 10
ConnectionsDestroyedTotalCount = 0
ConnectionsDestroyedByShrinkingTotalCount = 0
ShrinkingEnabled = true
ConnectionsCreatedTotalCount = 10
NumUnavailableHighCount = 0
MaxIdleTime = 0
LoggingEnabled = true
ConnectionIdleProfileCount = 0
ConnectionProfilingEnabled = false
ShrinkCountDownTime = -10565
FreePoolSizeLowWaterMark = 0
ActiveConnectionsHighCount = 0
ProxyOn = false
NumWaitersCurrentCount = 0
NumWaiters = 0
CloseCount = 0
PoolSizeHighWaterMark = 0
AverageActiveUsage = 0
RecycledTotal = 0
ConnectionLeakProfileCount = 0
HighestNumWaiters = 0
ShrinkPeriodMinutes = 1
NumberDetectedIdle = 0
CapacityIncrement = 1

================================================================
CompositeDN=default/fa!1.0*soa_7ce2ebd9-ce17-4b5a-b436-2567eab33af2
Endpoint Name = reference
Endpoint type = Reference
JNDI Name =eis/FileAdapter
Adapter Type =FileAdapter

ConnectionPool Attributes:
==========================

Important ConnectionPool Attributes:
====================================
InitialCapacity = 10
MaxCapacity = 2147483647
CurrentCapacity = 10
State = Running
FreeConnectionsCurrentCount = 10
NumUnavailableCurrentCount = 0
NumberDetectedLeaks = 0
ConnectionsDestroyedByErrorTotalCount = 0
ConnectionsRejectedTotalCount = 0

Other ConnectionPool Attributes:
================================
ActiveConnectionsCurrentCount = 0
FreePoolSizeHighWaterMark = 0
PoolSizeLowWaterMark = 0
ConnectionsMatchedTotalCount = 0
LastShrinkTime = 0
FreeConnectionsHighCount = 10
ConnectionsDestroyedTotalCount = 0
ConnectionsDestroyedByShrinkingTotalCount = 0
ShrinkingEnabled = true
ConnectionsCreatedTotalCount = 10
NumUnavailableHighCount = 0
MaxIdleTime = 0
LoggingEnabled = true
ConnectionIdleProfileCount = 0
ConnectionProfilingEnabled = false
ShrinkCountDownTime = -10565
FreePoolSizeLowWaterMark = 0
ActiveConnectionsHighCount = 0
ProxyOn = false
NumWaitersCurrentCount = 0
NumWaiters = 0
CloseCount = 0
PoolSizeHighWaterMark = 0
AverageActiveUsage = 0
RecycledTotal = 0
ConnectionLeakProfileCount = 0
HighestNumWaiters = 0
ShrinkPeriodMinutes = 1
NumberDetectedIdle = 0
CapacityIncrement = 1

12.2.17 アダプタ診断ダンプ(soa.adapter.stats)

表12-20はアダプタ診断ダンプを示します。

表12-20 アダプタ診断ダンプ

ダンプ名

ダンプ・パラメータ/ダンプ・モード

取得される情報

soa.adapter.stats

- ダンプ・パラメータ
format: (オプション)値xmlを指定すると、ダンプ診断出力がXML形式で表示されます。

- ダンプ・モード
ASYNC

soa.adapter.statsメトリックに基づいて、メッセージ・サイズやフォルト数といったDMS統計が示されます。

12.2.17.1 WLSTコマンド(ダンプの説明および実行)

1. 次のWLSTコマンドライン構文を入力し、soa.adapter.statsのダンプの説明を表示します。

wls:/soainfra/serverConfig> describeDump(name='soa.adapter.stats', appName='soa-infra')

次の情報が表示されます。

Name: soa.adapter.stats
Description: SOA adapter diagnostic dump that captures DMS adapter
statistics.Rules for actual parameter evaluation:
if composite name/partition/revision are specified, dumps the DMS stats for
that composite;
if no composite name/partition/revision are specified, then all the composites
with jca binding are dumped.
Mandatory Arguments:
Optional Arguments:
Name        Type     Description
revision    STRING   Revision of composite, e.g. '1.0', '2.0', can be wild
card '*', meaning matching any revision, when missing, assume default
composite's revision in the composite series.
partition   STRING   Partition of composite, default to partition(s)
associated with resolved revision(s), can be wild card '*', meaning matching
any partition.
compositeName  STRING   Composite name, e.g., 'OrderProcessing', can be
wild card '*',meaning matching any composite.

2. 次のWLSTコマンドライン構文を入力し、soa.adapter.statsのダンプを実行します。

wls:/soainfra/serverConfig> wls:/soainfra/serverConfig>
executeDump(name='soa.adapter.stats', appName='soa-infra',
args={'compositeName':'fa',
'partition':'default', 'revision':'1.0'})

次の情報が表示されます。

CompositeDN -default/fa!1.0
Service Name -service
Process Incoming Message Metrics -
================================
processIncomingMessages.time (Elapsed time in milliseconds ) - 4787 msecs
processIncomingMessages.completed (Elapsed time in milliseconds ) - 2 ops
processIncomingMessages.minTime (Elapsed time in milliseconds ) - 32 msecs
processIncomingMessages.maxTime (Elapsed time in milliseconds ) - 4755 msecs
processIncomingMessages.avg (Elapsed time in milliseconds ) - 2393.5 msecs
processIncomingMessages.active (Elapsed time in milliseconds ) - 0 threads
processIncomingMessages.maxActive (Elapsed time in milliseconds ) - 1 threads
Error Metrics -
=============
Errors.count (Number of events errored during binding processing ) - 0 ops
Process Incoming Message Events -
===============================
processIncomingMessagesEvents.count ( Number of processed events ) - 2 ops

12.3 SOAコンポジット・アプリケーションの診断フレームワーク・スレッド・ダンプの実行

スレッド・ダンプが必要な問題を診断する際は、スレッド・アクティビティに関する十分なコンテキストがあると役立ちます。診断フレームワーク・ダンプjvm.threadsは、SOAコンポジット・アプリケーションのDMS実行コンテキスト(EC)スレッド・スタック・データを提供します。次のプロパティは、SOAコンポジット・アプリケーション・インスタンスの実行が開始されると挿入され、HTTPリクエストが完了するとリセットされます。

- composite_name

- component_name

- composite_instance_id

- activity_name (BPELプロセスで実行されるアクティビティをリストします。名前のないアクティビティ(スコープ・アクティビティなど)は取得されません。)

jvm.threadsダンプを実行すると、この情報が表形式で出力されます。このダンプは、jvm.threadsダンプの実行時にそれぞれのスレッドがどこにあるかを識別します。

これは、どのSOAコンポジット・アプリケーションの処理が低速かを診断するうえで役立ちます。

12.3.1 WLSTコマンド(ダンプの説明および実行)

1. 次のWLSTコマンドライン構文を入力し、jvm.threadsのダンプを実行します。

executeDump(name='jvm.threads')

===== THREAD CONTEXT INFORMATION =====

id      ECID                                                          RID   Context Values
------- ------------------------------------------------------------- ----- ---------------
id=23   e6e3527fc0d0bfd2:-6c720372:139026855d8:-8000-0000000000001d3f 0:1   WEBSERVICE_
PORT.name=CatchException_pt
composite_name=ExceptionHandler!1.0
J2EE_MODULE.name=fabric
component_name=CommsUtilityWS
WEBSERVICE_NAMESPACE.name=http://xmlns.
oracle.com/ExceptionHandler/CatchException
J2EE_APP.name=soa-infraWEBSERVICE.name=
catchexception_client_ep
composite_instance_id=1

id=61   e6e3527fc0d0bfd2:-6c720372:139026855d8:-8000-000000000000003c 0
id=70   e6e3527fc0d0bfd2:-6c720372:139026855d8:-8000-0000000000001e84 0
id=2170 e6e3527fc0d0bfd2:-6c720372:139026855d8:-8000-0000000000001d3f 0     DSID=0000J^2fPtuDSc
Y5Hro2yf1G8M9Z000002
id=1616 e6e3527fc0d0bfd2:-6c720372:139026855d8:-8000-0000000000000004 0
id=2179 e6e3527fc0d0bfd2:-6c720372:139026855d8:-8000-000000000000002b 0     dbRID=0:10
id=2195 e6e3527fc0d0bfd2:-6c720372:139026855d8:-8000-0000000000001e7e 0     dbRID=0:2
id=2196 e6e3527fc0d0bfd2:-6c720372:139026855d8:-8000-0000000000001e82 0     dbRID=0:2
id=2197 e6e3527fc0d0bfd2:-6c720372:139026855d8:-8000-0000000000001e80 0     dbRID=0:5

===== END OF THREAD CONTEXT INFORMATION =====

この情報はAdminServer-diagnostic.logファイル・ログで参照することもできます。

jvm.threadsダンプの詳細は、『Oracle Fusion Middleware管理者ガイド』の「問題の診断」の章を参照してください。

12.4 サポートされるDMSメトリック

ナウン・タイプのDMSメトリックは、Oracle SOA Suite MBeanとして公開され、問題を診断する際に使用します。この項では、サポートされるDMSメトリックについて説明します。DMSナウンを使用して、Oracle WebLogic Server管理コンソールの監視を作成できます。

DMSメトリックは、BPELプロセス・サービス・エンジンの「統計」ページに表示されるグラフィカルな詳細を提供します。詳細は、第14.6項「BPELプロセス・サービス・エンジンのリクエスト統計とスレッド・パフォーマンス統計の監視」および第14.9項「BPELプロセス・サービス・エンジンでのリクエストの所要時間に関する統計の表示」を参照してください。

表12-21に、サポートされるサービス・エンジンのセンサーを示します。

表12-21 サービス・エンジンのセンサー

ナウン・パス

ナウンのタイプと説明

センサー

タイプ

/soainfra/engines/dispatcher/queuestats/[REQUEST_TYPE]

様々なリクエスト・タイプには、監査、配信、ドメイン、インスタンス、起動、メンテナンス、非ブロック起動、プロセスおよびシステムがあります。

soainfra_cube_engine_dispatcher_queue_stats: 様々なディスパッチャ・セットのキューについて、アクティブなスケジュールされた数を提供します。

active

schedule

/soainfra/engines/ [bpel|workflow|mediator|decision]/message_processing

soainfra_message_processing: 各種メッセージ・タイプの合計数(カウント)と処理のための平均所要時間に関する情報を提供します。2つのメッセージ・タイプは同期リクエストと非同期リクエストです。

faultedRequestProcessingTime

faultedPostProcessingTime

requestProcessingTime

postProcessingTime

activeRequests

フェーズ・イベント

フェーズ・イベント

フェーズ・イベント

フェーズ・イベント

状態

/soainfra/engines/bpel/requests/[REQUEST_TYPE]

リクエスト・タイプは、監査、エンジン、起動、非ブロック起動およびシステムです。

soainfra_bpel_requests

active

scheduled

状態

状態

/soainfra/engines/workflow/Task/service

soainfra_wfRequest

time

count

フェーズ

イベント

/soainfra/engines/workflow/Task/[METHOD_NAME]

time

count

フェーズ

イベント

/soainfra/engines/workflow/TaskQuery/[METHOD_NAME]

time

count

フェーズ

イベント

/soainfra/engines/workflow/TaskMetadata/getTaskDefinition

time

count

フェーズ

イベント

/soainfra/engines/workflow/Verification/[METHOD_NAME] (メソッドのみ: authenticateUser、getPermissableTaskActionsおよびcanUserPerfomTaskAction)

time

count

フェーズ

イベント

/soainfra/engines/workflow/TaskNotification/notifyForTask

time

count

フェーズ

イベント

/soainfra/engines/workflow/AssignmentRules/executeRules

time

count

フェーズ

イベント

/soainfra/engines/bpel/dispatcher/

soainfra_bpel_dipatcher

maxThreads

avgLifeTime

avgRequestCountPerSecondなど

状態

状態

状態

表12-22に、サポートされるバインディング・センサーを示します。

表12-22 バインディング・センサー

ナウン・パス

ナウン・タイプ

センサー

タイプ

/soainfra/bindings/[inbound|outbound]/[ws|sdo|jca|b2b]

soainfra_binding

processRequests

requests

errors

フェーズ

フェーズ

フェーズ

表12-23に、サポートされるコンポジット・センサーを示します。

表12-23 コンポジット・センサー

ナウン・パス

ナウン・タイプ

センサー

タイプ

/soainfra/apps/[APP_NAME]/[COMPOSITE_DN]

soainfra_composite

status

instantiated

successfulInstanceProcessingTime

faultedInstanceProcessingTime

状態

イベント

フェーズ

フェーズ

/soainfra/apps/[APP_NAME]/[COMPOSITE_NAME]/[REVERSION]/[COMPONENT_NAME]

/decision/[INTERACTION_PATTERN]/[INTERACTION_PATTERN_NAME]

soainfra_decision_interaction

executed

executionTime

イベント

フェーズ

/soainfra/apps/[COMPOSITE_DN]/[COMPONENT_NAME]/[ACTIVITY_NAME] (bpel用)

soainfra_bpel_activity: アクティビティ・レベルの実行時間の詳細を提供します。

started

executionTime

faultedExecutionTime

標準偏差(入手次第ユーザー・インタフェースにより計算される)

イベント

フェーズ

フェーズ

/soainfra/apps/[APP_NAME]/[COMPOSITE_NAME]/[VERSION]/[COMPONENT_NAME] /state/

soainfra_wfStateEvent

ASSIGNED

COMPLETED

ERRORED

EXPIRED

SUSPENDED

イベント

/soainfra/apps/[APP_NAME]/[COMPOSITE_NAME]/[VERSION]/[COMPONENT_NAME] /outcome/

soainfra_wfOutcomeEvent

[OUTCOME NAME]

イベント

/soainfra/apps/[APP_NAME]/[COMPOSITE_NAME]/[VERSION]/[COMPONENT_NAME] /taskCompletion/

soainfra_wfTaskCompletionTime

time

フェーズ

表12-24に、サポートされる参照およびサービスのセンサーを示します。

表12-24 参照およびサービスのセンサー

ナウン・パス

ナウン・タイプ

センサー

タイプ

/soainfra/apps/[APP_NAME]/[COMPOSITE_NAME]/[REVERSION]/[REFERENCE_NAME]

soainfra_reference

processOutboundMessagesEvents

Errors

processOutboundMessages

イベント

イベント

フェーズ

/soainfra/apps/[APP_NAME]/[COMPOSITE_NAME]/[REVERSION]/[SERVICE_NAME]

soainfra_service

processInboundMessagesEvents

Errors

processInboundMessages

イベント

イベント

イベント

表12-25に、サポートされるOracle B2Bバインディング・センサーを示します。

表12-25 Oracle B2Bバインディング・センサー

ナウン・パス

ナウン・タイプ

センサー

タイプ

/soainfra/bindings/b2b/document_type/[inbound|outbound]/[DOCUMENT_NAME]

/soainfra/bindings/b2b/[inbound|outbound]

soainfra_b2b_document

soainfra_b2b_document_dir

processMessagesEvents

processMessagesErrors

processMessages

processMessageSize

イベント

イベント

フェーズ・イベント

状態

/soainfra/bindings/b2b/trading_partner/[from|to]/[TRADING_PARTNER_NAME]

/soainfra/bindings/b2b/[from|to]/

soainfra_b2b_tradingPartner

soainfra_b2b_tradingPartner_dir

processMessagesEvents

processMessagesErrors

processMessages

processMessageSize

イベント

イベント

フェーズ・イベント

状態

/soainfra/bindings/b2b/endpoint/[inbound|outbound]/[END_POINT]

/soainfra/bindings/b2b/[inbound|outbound]/

soainfra_b2b_endpoint

soainfra_b2b_endpoint_dir

endPointProtocol

endPointStatus

processMessagesEvents

状態

状態

イベント

/soainfra/bindings/b2b/agreement/[AGREEMENT_NAME]

soainfra_b2b_agreement

processMessagesEvents

イベント

/soainfra/bindings/b2b/activeEntities

soainfra_b2b_active_entities

activeTradingPartners

activeAgreements

activeDocuments

状態

状態

状態

/soainfra/apps/[APP_NAME]/[COMPOSITE_NAME]/[REVERSION]/[SERVICE_NAME]/[TRADING_PARTNER_NAME]

soainfra_service_b2b_tradingPartner

processMessagesEvents

processMessagesErrors

processMessages

processMessageSize

イベント

イベント

フェーズ・イベント

状態

/soainfra/apps/[APP_NAME]/[COMPOSITE_NAME]/[REVERSION]/[REFERENCE_NAME]/[TRADING_PARTNER_NAME]

soainfra_reference_b2b_tradingPartner

processMessagesEvents

processMessagesErrors

processMessages

processMessageSize

イベント

イベント

フェーズ・イベント

状態

表12-26に、サポートされるOracle User Messaging Serviceのセンサーを示します。

表12-26 Oracle User Messaging Serviceイベント・ブリッジのメトリック

ナウン・パス

ナウン・タイプ

センサー

タイプ

/soainfra/eventBridge/rfidBridge

soinfra_rfidBridge

eventsIn

eventsOut

eventsProcess

errors

イベント

イベント

フェーズ・イベント

イベント

/soainfra/eventBridge/rfidBridge/device/[SERVER_NAME]/[DEVICE_NAME]

soainfra_rfidBridge_device

eventsIn

eventsOut

eventsProcess

status

イベント

イベント

フェーズ・イベント

状態

/soainfra/eventBridge/rfidBridge/server/[SERVER_NAME]

soainfra_rfidBridge_server

status

状態

12.5 監視および通知の作成

監視を作成し、Oracle SOA Suite MBeanから収集したメトリックに基づく診断可能な条件で通知を送信できます。監視式がtrueに評価される(たとえば、ヒープ領域が指定容量を超える)と、通知が送信されます。

監視を作成する際は、次のようないくつかのオプションがあります。

- デプロイメント、メモリーおよびWebサービス・コールの経過時間のために事前に構成されたルールと監視は、sca_createWatches WLSTコマンドによって有効にします。

- Oracle WebLogic Server管理コンソールでOracle SOA Suiteの監視を手動で作成します。

表12-27に示すメッセージIDが診断用に割り当てられています。

- Oracle WebLogic Server管理コンソールで監視を手動で作成する場合は、表12-27の命名規則に従う必要があります。Oracle SOA Suite関連の監視の接頭辞は、SOA-message_IDです。

- 事前に構成された監視を有効にすると、名前が自動的に作成されます。

表12-27 メッセージの接頭辞

シナリオ

メッセージID

実行されるダンプ

監視は事前に構成されていますか

メモリー

SOA-900000

- soa.env

- soa.config

- java.sysprops

はい。第12.5.1項「事前構成済ルールおよび監視の有効化」を参照してください。

デプロイメントのハング

SOA-900001

- soa.env

- soa.config

はい。第12.5.1項「事前構成済ルールおよび監視の有効化」を参照してください。

データ・ソース

SOA-900002

- soa.env

- soa.config

- soa.db

いいえ。作成方法は、第12.5.2項「Oracle SOA Suite監視および通知の手動作成」を参照してください。

Webサービス・コールの経過時間

SOA-900005

- soa.env

- soa.config

- soa.wsdl

はい。第12.5.1項「事前構成済ルールおよび監視の有効化」を参照してください。

リシーケンサ・グループ保留中

MED-900000

mediator.resequencer

いいえ。作成方法は、第12.5.2項「Oracle SOA Suite監視および通知の手動作成」を参照してください。

WLDF通知を監視にリンクすることもできます。初期状態のOracle Fusion Middleware診断フレームワークの通知(名前はFMWDFW通知)をリンクすると、SOA固有の一連のダンプが実行されます。これらのダンプでは、状況および環境に関するランタイム情報が提供されます。実行するダンプのリストは、事前定義のXMLインシデント・ルール・ファイルによって決まります。

その他の通知(電子メールなど)を監視にリンクすることもできます。

12.5.1 事前構成済ルールおよび監視の有効化

次の事前構成済の診断フレームワーク・ルールは、Oracle SOA Suiteとともに自動的にインストールされます。

- OWS-04086エラーの発生時にインシデントを作成するためのログ検出条件ルール。

注意:

OWS-04086エラーが原因で、多数のインシデントが生成される問題が発生する場合は、パッチ番号2248452についてOracleサポート・サービスに連絡してください。

- DMS実行コンテキスト(EC)でSOAコンポジット・アプリケーション名の存在をチェックして、soa.wsdlおよびsoa.composite.trail診断ダンプを実行されるダンプのリストに追加する条件ルール。

これらのルールの使用を有効化して次の監視を生成するには、ドメインの作成後にsca_createWatches WLSTコマンドを実行する必要があります。

- デプロイメント監視(しきい値は5分)

- メモリー監視(空きヒープ率のしきい値25%)

- Webサービス・コールの経過時間の監視(しきい値は5分)

事前構成済の監視を有効にする手順は次のとおりです。

1. WLSTを使用してOracle WebLogic Serverインスタンスに接続し、編集セッションを開始します。接続と編集セッションの開始の詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』の「WLSTコマンドおよび変数リファレンス」に関する章を参照してください。

2. 次のWLSTコマンドを実行して、事前構成済の監視を有効にします。

wls:/soainfra/serverConfig> sca_createWatches()

監視が有効になって、手動で作成した監視とともにOracle WebLogic Server管理コンソールの「Module_Name」ページの設定の下部に表示されます。

Oracle SOA SuiteでのWLSTコマンドの実行の詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』の「Oracle SOA SuiteカスタムWLSTコマンド」に関する章を参照してください。

12.5.2 Oracle SOA Suite監視および通知の手動作成

Oracle SOA Suite監視および通知を手動で作成する手順は次のとおりです。

1. Oracle WebLogic Server管理コンソールにログインします。

http://host:port/console

2. 「ドメイン構造」で、「診断」を開き、「診断モジュール」を選択します。
「診断モジュールのサマリー」ページが表示されます。

サーバーまたはサーバー・リソースの側面を監視する診断システム・モジュールを構成します。複数のシステム・モジュールを構成してサーバーの様々な側面を監視できますが、サーバーでアクティブ化できるモジュールは1つのみです。

3. 「診断システム・モジュール」セクションで、「Module-[Module_Name]」(例: Module-FMWDFW)をクリックします。

4. 「Module_Nameの設定」ページで、「監視と通知」→「監視」の順に選択します。

5. 「監視」セクションで、「新規」をクリックします。
「診断監視の作成」ページが表示されます。

6. 監視を作成するために次の詳細を入力し、「次へ」をクリックします。

フィールド

説明

監視名

監視の名前を入力します(この例では、SOA-900000#soa-infra#MemoryWatchが入力されています)。

監視の名前は、次のパターンに準拠する必要があります。

message-id#soa-infra#some_other_text

例: SOA-900000#soa-infra#MemoryWatch.

これが必要なのは、監視条件がtrueに評価された場合に、監視名によって診断フレームワーク・インシデント処理が調整されるためです。このパターンに従っていない場合は、Oracle SOA Suiteインシデントの作成時に、Oracle SOA Suiteのダンプはトリガーされません。

その他の情報は、表12-27を参照してください。

FMWDFW通知を使用して監視が設定されている場合は、通知ハンドラにより、監視名に指定されているmessage-idに対応するインシデントが作成されます。

監視のタイプ

オプションを選択します。

- 収集対象メトリック: MBean属性から収集されるメトリックに基づいて監視を設定します。このオプションは表12-1で説明されているシナリオで有効であるため、これを選択することをお薦めします。

- サーバー・ログ: サーバー・ログに書き込まれるデータに基づいて監視を設定します。このタイプは、Oracle SOA Suiteのダンプを含めるために、StuckThreadなどの既存のログの監視を拡張する場合にのみ有用です。

- イベント・データ: Oracle SOA SuiteはWLDFベースのインストゥルメンテーションを使用していないため、このオプションは適用できません。

監視の有効化

監視を有効にする場合に選択します。

式を監視に追加するための「監視ルール式の構成」ページが表示されます。

7. 「式の追加」をクリックします。
「式の追加」ウィザードが表示されます。

8. 「MBeanサーバーの場所」リストで、構成する式のOracle WebLogic Server MBeanサーバーを選択します(例: ServerRuntime)。

9. 「次へ」をクリックします。

10. 「次のリストからMBeanのタイプを選択」ボタンをクリックします。

11. 「MBeanタイプ」リストで、診断情報の収集に使用するMBeanを選択します(この例では、Oracle WebLogic Server MBean weblogic.management.runtime.JRockitRuntimeMBeanが選択されています)。

12. 「次へ」をクリックします。
「インスタンスの選択」ページが表示されます。

13. 「インスタンス」リストから、インスタンス名を選択するか、式のメトリックの識別に使用するインスタンス名パターンを指定します。

14. 「次へ」をクリックします。

15. 監視ルール式を作成するために次の詳細を入力し、「終了」をクリックします。

フィールド

説明

メッセージ属性

メッセージ属性を選択します(この例ではHeapFreePercentが選択されています)。

選択肢に表示される属性は、ステップ11で選択したMBeanの一部です。たとえば、次のように選択したとします。

oracle.dms.name=/soainfra/engines/bpel/request/system.type=soa_infra_bpel_requests

active_count、active_maxValue、active_minValue、scheduled_countなど、割り当てられている属性が表示されます。

演算子

演算子を選択します(この例では<が選択されています)。

値

値を入力します(この例では100が指定されています)。

「監視ルール式の構成」ページに、作成した監視ルール式が表示されます。

16. 「次へ」をクリックします。
「監視アラームの構成」ページが表示されます。

17. 必要に応じて、監視のアラームおよびアラームのリセット値を指定します。

18. 「次へ」をクリックします。
「監視通知の構成」ページが表示されます。

19. 「使用可能」表で、監視に割り当てる通知を選択し、「>」をクリックします。

監視ルール式がtrueに評価されると、通知がトリガーされます。FMWDFW通知が選択されている場合、通知は診断フレームワークによって処理され、監視にリンクされます。FMWDFW通知はOracle SOA Suiteに自動的に付属しています。この通知では第12.2項「Oracle SOA Suite診断ダンプの実行」で説明されているOracle SOA Suiteのダンプが作成されるため、この通知を選択することをお薦めします。

通知ハンドラで、適切なOracle SOA Suiteダンプが格納された問題インシデント・パッケージがADRに作成されます。インシデント・パッケージ名は、監視名に指定されているメッセージIDに対応します。後で標準的なADRツールを使用して、インシデント・パッケージのダンプを表示できます。この機能を使用して、問題シナリオの修正処理を適用できます。

20. 「終了」をクリックします。
作成した監視が「Module_Nameの設定」ページの下部に表示されます。さらに、Oracle WebLogic Serverに自動的に付属している3種類のWLDF監視(Deadlock、StuckThreadおよびUncheckedException)も表示されます。

21. 「名前」列で、特定の監視名をクリックして、その監視の構成の詳細を表示します。

12.5.3 Webサービス・バインディング・コールの経過時間を識別する監視の作成

コンポジットから外部参照へのWebサービス・バインディング・コールが完了するまでの所要時間を追跡する監視を作成できます。指定の時間しきい値を超えると、インシデントを作成したり、アラートをトリガーしたりできます。この監視は、次のシナリオで役立ちます。

- 呼び出された外部参照の動作が遅すぎるために、この参照による処理を待機する間にメッセージが収集される結果となっているシナリオを識別する場合

- 厳しいサービス・レベル合意(SLA)が配備されており、呼び出されたサービスによってSLA違反が発生している際は通知を受け取りたい場合

Webサービス・バインディング・コールの経過時間を識別する監視を作成する手順は次のとおりです。

第12.5.2項「Oracle SOA Suite監視および通知の手動作成」で説明されている手順を使用し、次のガイドラインに従って監視を作成してください。

- 「SOAインフラストラクチャの共通プロパティ」ページで、「詳細SOAインフラ拡張構成プロパティ」セクションの「CreateWSCallTrackingMBean」プロパティをtrueに設定します。このプロパティは、Webサービス・バインディング・コールの経過時間を追跡するためのMBeanの作成を制御して、SOAインフラストラクチャのすべてのSOAコンポジット・アプリケーションにグローバルに適用します。外部参照に対する各Webサービス・バインディング・コールについて、時間を追跡するための新しいMBeanが登録され、その後登録解除されます。このプロパティはデフォルトでfalseに設定されています。システムに問題が発生するまでは、このプロパティはtrueに設定しないでください。
「SOAインフラストラクチャの共通プロパティ」ページへのアクセスの詳細は、第3.1項「SOAインフラストラクチャ・プロパティの構成」を参照してください。

- 監視名としてSOA-900005#soa-infra#WSExtElapsedTimeWatchを指定します。

- 「監視のタイプ」リストから「収集対象メトリック」を選択します。

- 「カスタムMBeanのタイプ」フィールドにCreateWSCallTrackingMBeanを指定します。このMBeanは「MBeanタイプ」フィールドからは選択できません。

- SOAコンポジット・アプリケーションから外部参照へのWebサービス・バインディング・コールが完了するまでの経過時間(ミリ秒単位)を追跡するためのルール式を指定します(分単位)。たとえば、この式は、監視がトリガーされたときにインシデントを作成します。

(${ServerRuntime//[oracle.fabric.management.wldf.mbean.WSExternalBindingWatchMXBeanImpl]//ElapsedTime} > 2

- 監視がトリガーされたとき、Oracle SOA Suite ADRディレクトリにインシデントが作成されます。ディレクトリ内のreadmeファイルには、インシデントに関する情報が表示されます。この例では、BPELサービス・コンポーネント・インスタンス20004が、WSDL定義のポートCommsUtilityPortをコールしました。経過時間は244013です(2.44013分で、これは監視のルール式に設定されている経過時間の2分を超えています)。例12-2に詳細を示します。

例12-2 インシデントの詳細

WatchDomainName:      soainfra
Watch Data:
ServerRuntime//[oracle.fabric.management.wldf.mbean.WSExternalBindingWatch
MXBeanImpl]//ElapsedTime : oracle.soa.config:Application=soa-infra.j2eeType=
CompositeReferenceWatch.name=bpel#20004/soainfra/AdminServer/soainfra/default/
ExceptionHandler/1.0/soa.2075e8a1-5c69-4e5o-a679-c0ba2f6ae6/REFERENCEs/
CommsUtilityS/PORTs/CommsUtilityPort//ElapsedTime:244013

また、sca_createWatches WLSTコマンドを使用して、この監視を自動的に作成することもできます。詳細は、第12.5.1項「事前構成済ルールおよび監視の有効化」を参照してください。

12.5.4 処理遅延が指定の制限時間を超えているかどうかを識別する監視の作成

メッセージ待機時間や処理遅延の数が特定の制限を超えた場合にアラートを送信する監視を作成できます。

この監視は、システムMBeanブラウザの「CubeDispatcher」プロパティの「DispatcherStatsMap」属性で制御します。この設定には次のようにアクセスできます。

1. 「soa-infra」を右クリックして、「管理」→「システムMBeanブラウザ」の順に選択します。

2. 「アプリケーション定義のMBean」→「oracle.as.soainfra.bpm」→「Server : server_name」→「bpel」→「CubeDispatcher」の順に開きます。

3. 「CubeDispatcher」をクリックします。

第12.5.2項「Oracle SOA Suite監視および通知の手動作成」で説明されている手順に従い、次のガイドラインを使用して、監視作成ウィザードの「式の追加」セクションで監視を作成します。

- 「ServerRuntime」を選択して、「次へ」をクリックします。

- 「カスタムMBeanのタイプ」フィールドにcom.collaxa.cube.engine.dispatch.DispatcherMXBeanAdapterを指定して、「次へ」をクリックします。このMBeanは「MBeanタイプ」フィールドからは選択できません。

- 「カスタム・インスタンス」フィールドにoracle.as.soainfra.bpm:Application=soa-infra,name=CubeDispatcher,type=bpelと指定して、「次へ」をクリックします。

- 「属性式」フィールドにDispatcherStatsMap(invokeSet)(invoke)(scheduled)と指定します。

- このページの残りのフィールドに入力して、「次へ」をクリックします。

12.5.5 リシーケンサの監視および通知の作成

リシーケンサ・グループがメッセージを処理する際の所要時間を追跡する監視を作成できます。指定した時間しきい値を超えた場合は、通知を生成できます。

リシーケンサの監視および通知を作成する手順は次のとおりです。

第12.5.2項「Oracle SOA Suite監視および通知の手動作成」で説明されている手順を使用し、次のガイドラインに従ってください。

- 「Module-FMWDFW」モジュールで監視と通知を作成します。

- 「診断監視の作成」ページで、次のパターンに準拠する監視名を指定する必要があります。

MED-900000#soa-infra#some_other_text

たとえば、MED-900000#soa-infra#PendingGroupsと指定します。

- 式を作成する際は、次のMBeanタイプを選択します。

oracle.tip.mediator.dfw.MediatorDiagnostic

式のインスタンスに選択できるオプションは1つのみです。

oracle.mediator:name=MediatorDiagnostic,type=MediatorDiagnostic

- 「メッセージ属性」フィールドにResequencerMaxUnprocessTimeを選択します。値には、通知をトリガーする前にグループを保留できる分数を入力します。

- 演算子として、大なり記号(>)を選択します。

完成した式は、次のようになります。

(${ServerRuntime//[oracle.tip.mediator.dwf.MediatorDiagnostic]oracle.mediator:name
=MediatorDiagnostic,type=MediatorDiagnostic//resequencerMaxUnprocessTime} > '15')

サンプル・カスタム・ルール・ファイルを作成する手順は次のとおりです。

監視ルール式はダンプ・コンテキストでは提供されないため、ダンプ生成時に指定された条件は示されません。soa-infra#custom-rules.xmlというカスタム・ファイルを使用して、ダンプ生成ルールを登録できます。詳細は、第12.1.3項「事前定義のインシデント処理ルール」を参照してください。

1. 前述の説明に従って、監視を作成します。

2. soa-infra#custom-rules.xmlという名前のファイルを次のいずれかの場所に作成します。

- サーバー・レベルの構成: FMW_HOME/user_projects/domains/domain_name/config/fmwconfig/servers/server_name/dfw

- ドメイン・レベルの構成: FMW_HOME/user_projects/domains/domain_name/config/fmwconfig/dfw

3. 新しいファイルにルールを定義します。例12-3は、リシーケンサ・サンプル・ファイルを示します。

4. ドメインを再起動するか、ファイルを動的にロードします。動的ロードの詳細は、第12.1.3項「事前定義のインシデント処理ルール」を参照してください。
WLDFによってダンプが生成されます。

例12-3は、グループがメッセージの処理を10分間停止すると診断ダンプを生成するサンプル・カスタム・ルール・ファイルを示します。

例12-3 リシーケンサ・ダンプのサンプル・カスタム・ルール・ファイル

<?xml version="1.0" encoding="UTF-8"?>
<diagnosticRules
xmlns="http://www.oracle.com/DFW/DiagnosticsFrameworkRules"
xmlns:xs="http://www.w3.org/2001/XMLSchema-instance">
<processingRules>
<rule name="memory diagnosis rule">
<ruleCondition>
<condition name="MESSAGE_ID" value="MED-900000"
operator="EQ"/>
</ruleCondition>
<ruleActions>
<dumpAction name="mediator.resequencer">
<argument name="resequencerMaxUnprocessTime" value="10"
valueType="literal"/>
</dumpAction>
</ruleActions>
</rule>
</processingRules>
</diagnosticRules>

12.6 手動によるダンプのトリガーと実行

インシデントが自動で作成されなかった場合は、WLSTコマンドexecuteDumpを使用して既存のダンプを手動で実行し、インシデントを作成できます。

ダンプを手動でトリガーして実行する手順は、次のとおりです。

1. executeDumpコマンドを指定し、ダンプの内容をファイルに配置します(この例では、soa.configが実行されたダンプです)。次の出力が作成されます。

wls:/soainfra/serverConfig> executeDump(name='soa.config', appName='soa-infra')

Start Dumping deployedCompositesCatalog from MDS
URI:deployed-composites/deployed-composites.xml to: /myhome/fmwhome/user_
projects/domains/mydomain/servers/myserver/adr/diag/ofm/mydomain/
myserver/incident/incdir_9/deployedCompositesCatalog

Finished dumping specified MDS metadata to : /myhome/fmwhome/user_
projects/domains/mydomain/servers/myserver/adr/diag/ofm/mydomain/myserver/incid
ent/incdir_9/deployedCompositesCatalog

Start Dumping soaServiceEnginesConfigurations from MDS
URI:soa/configuration/default to: /myhome/fmwhome/user_projects/
domains/mydomain/servers/myserver/AdminServer/adr/diag/ofm/mydomain/
myserver/incident/incdir_9/soaServiceEnginesConfigurations

Finished dumping specified MDS metadata to : /myhome/fmwhome/user_projects/
domains/mydomain/servers/myserver/AdminServer/adr/diag/ofm/mydomain/
myserver/incident/incdir_9/soaServiceEnginesConfigurations

2. executeDumpコマンドを指定し、ダンプの内容を画面に表示します。

executeDump(name='soa.edn')

Type:oracle.integration.platform.blocks.event.saq.SAQBusinessEventBus
Configuration:null
Status: running=true started=true
ThreadCount:3
RetryCount:3
In Global: Tx:false
Cluster Info:oracle.integration.platform.blocks.cluster.CoherenceCluster
Interface1mpt@163bd717
SharedEDN:false
OOAO Queue Name:edn_ooao_queue
Java Subscriber Name:edn java subscriber
Subscription Info:
No namespace subscription...
QName subscriptions:
=============================================================
qname={http://schemas.oracle.com/events/edl/ActionOccur}ADEvent
subscriptions=
id=default/WSInMedPubBpelSubFileOut!1.0*soa_7a055d6a-8402-49c2-ac56-5f85cbf3d7f/
BpelSub, consistencyLevel=ONE_AND_ONLY_ONE, filter=XPath Filter: starts-with(/
be:business-event/be:content/ns0:ActionOccurrence/ns0:ParentEntityType/@value,
'A'), runAsRoles=[$publisher]
id=partition_1/WSInMedPubBpelSubFileOut!1.0*soa_80a169ab1-395a-4b87-9986-9fa2742a8bd3/
BpelSub, consistencyLevel=ONE_AND_ONLY_ONE, filter=XPath Filter: starts-with(/
be:business-event/be:content/ns0:ActionOccurrence/ns0:ParentEntityType/@value,
'A'), runAsRoles=[$publisher]
EventThreadContextInfo:
EventTargets:
Event:partition_1/WSInMedPubBpelSubFileOut!1.0*soa0a169ab1-395a-4b87-9986-9fa2742a9bd3/
BpelSub:::oracle.fabric.BPELServiceEngine@163bd6b5
Event:default/WSInMedPubBpelSubFileOut!1.0*soa7a055d6a-8402-49c2-ac56-5f85cbf3
d7f/BpelSub:::oracle.fabric.BPELServiceEngine@163bd6b5
EDN DB Log enabled:false

インシデントが自動で作成されなかった場合は、手動で作成することもできます。たとえば、パフォーマンスの問題に気付いたときに、Oracleサポート・サービスに送信するインシデントを作成する場合に便利です。インシデントには、SOAメッセージIDのマッピングに従ってSOAダンプを含めることができます。

これは、次のWLSTコマンドを使用して実行できます。

createIncident(messageId="SOA-90000", appName="soa-infra")

これにはWLDF監視の通知実行と同様の効果があり、この場合、監視のメッセージIDはSOA-90000、アプリケーション名はsoa-infraとなります。

executeDumpの詳細は、Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスの「診断フレームワークのカスタムWLSTコマンド」の章を参照してください。

12.7 ADRツールでのインシデント・パッケージの表示

ADRCIは、問題を調査したり、新たな障害の診断データをパッケージ化してOracleサポートにアップロードする際に使用可能なコマンドライン・ユーティリティです。またADRCIを使用して、ADR内のダンプ・ファイルの名前を表示したり、コンテンツ・フィルタを指定して(または未指定で)XMLタグが取り除かれた状態でアラート・ログを表示することもできます。

ADRCIは次のディレクトリにインストールされています。

MW_HOME/wlserver_10.3/server/adr

ADRCIの詳細は、『Oracle Databaseユーティリティ』の「ADRCI: ADRコマンド・インタプリタ」の章を参照してください。

その他のツールの詳細は、『Oracle Database管理者ガイド』の「診断データの管理」の章を参照してください。

12.8 問題およびインシデントの問合せ

診断フレームワークには、次のような問題およびインシデントに関する情報を表示する際に使用できるWLSTコマンドが用意されています。

- 複数のOracle WebLogic Serverにまたがる問題の問合せ

- 複数のOracle WebLogic Serverにまたがるインシデントの問合せ

- Oracle WebLogic Serverのインシデントに関連付けられているダンプ・ファイルの表示

これらのWLSTコマンドの詳細は、『Oracle Fusion Middleware管理者ガイド』の診断フレームワークの理解に関する項、およびOracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスの「診断フレームワークのカスタムWLSTコマンド」の章を参照してください。

第V部

BPELプロセスのサービス・コンポーネントとエンジンの管理

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

次の章で構成されています。

- 第13章「BPELプロセスのサービス・コンポーネントとエンジンの構成」

- 第14章「BPELプロセスのサービス・コンポーネントとエンジンの監視」

- 第15章「BPELプロセスのサービス・コンポーネントとエンジンの管理」

13 BPELプロセスのサービス・コンポーネントとエンジンの構成

この章では、BPELプロセス・サービス・コンポーネントとサービス・エンジンの構成方法(監査レベル、監査証跡しきい値、ディスパッチャ・スレッド値などのプロパティ、BPELプロセスの自動リカバリ、マスター・ノード・リカバリ・スケジューリング、起動メッセージとコールバック・メッセージの自動リカバリ試行、およびコールバック・メッセージの順序の保持の構成を含む)について説明します。

この章では、次の項目について説明します。

- 第13.1項「BPELプロセス・サービス・エンジン・プロパティの構成」

- 第13.2項「Oracle BPEL Process Managerの自動リカバリの構成」

- 第13.3項「マスター・ノード・リカバリ・スケジューリングの構成」

- 第13.4項「起動メッセージおよびコールバック・メッセージの自動リカバリ試行の構成」

- 第13.5項「コールバック・メッセージの順序の保持」

- 第13.6項「BPELプロセス・サービス・コンポーネント・レベルでの監査レベルの設定」

Oracle SOA SuiteとOracle BPELプロセスのチューニングとパフォーマンス・プロパティの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』を参照してください。

13.1 BPELプロセス・サービス・エンジン・プロパティの構成

BPELプロセス・サービス・エンジン・プロパティを構成でき、このプロパティは、BPELプロセス・サービス・コンポーネントの処理時に、BPELプロセス・サービス・エンジンで使用されます。

BPELプロセス・サービス・エンジン・プロパティを構成する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「SOA管理」→「BPELプロパティ」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「SOA管理」→「BPELプロパティ」の順に選択します。

「BPELサービス・エンジン・プロパティ」ページに、監査証跡しきい値と大容量ドキュメントしきい値の設定、ディスパッチャ・スレッド・プロパティの設定、ペイロード・スキーマの検証、および監査証跡レベルの設定を行うためのプロパティが表示されます。

2. 使用環境に適するようにサービス・エンジン・プロパティを変更します。

プロパティ

説明

監査レベル

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

- オフ: コンポジット・インスタンスのトラッキング情報とペイロード・トラッキング情報は収集されません。

- 継承: ロギング・レベルは、SOAインフラストラクチャの監査レベルと同じです。この設定を使用すると、グローバル設定が変更されたときに、BPELプロセスの監査レベルも自動的に変更できます。このページで別の監査レベル・トラッキングを設定すると、SOAインフラストラクチャ・レベルで設定したトラッキングがオーバーライドされます。

- 最小: BPELプロセス・サービス・エンジンでは、監査詳細がキャプチャされません。したがって、フローの監査証跡で監査詳細は使用できません。他のすべてのイベントは記録されます。

- 本番: BPELプロセス・サービス・エンジンでは、ペイロードがキャプチャされません。フローの監査証跡でペイロード詳細は使用できません。他のBPELアクティビティのペイロード詳細は、assignアクティビティを除いて収集されます。このレベルは、標準の操作とテストに最適です。

- 開発: コンポジット・インスタンスのトラッキングとペイロード・トラッキングの両方を実行できます。すべてのイベントが記録されます。ただし、パフォーマンスに影響を与える可能性があります。このレベルは通常、デバッグする際に便利です。

監査証跡しきい値(バイト)

監査証跡とは別にチャンクされてデハイドレーション・ストア表に保存される前の、インスタンスの監査証跡の最大サイズをバイト単位で入力します。このしきい値を超えると、ペイロードのかわりに、「XMLの表示」リンクが監査証跡に表示されます。

大容量のドキュメントしきい値(バイト)

デハイドレーション・ストアの別の表に保存される前の、BPELプロセス・コンポーネント・インスタンス内に生成されるドキュメントの最大サイズを入力します。

ディスパッチャ・システム・スレッド

システム・ディスパッチャ・メッセージの処理に割り当てるスレッドの合計数を指定します。システム・ディスパッチ・メッセージは、通常、サーバーにより迅速に処理される一般的なクリーン・アップ・タスクです(たとえば、ステートフル・メッセージBeanを元のプールに解放)。通常、実行時に生成されたシステム・ディスパッチ・メッセージの数を処理するために必要なスレッド数はごく少数です。

デフォルト値は2スレッドです。1スレッド未満の値は、デフォルト値に変更されます。

これらのスレッドの監視の詳細は、第14.6項「BPELプロセス・サービス・エンジンのリクエスト統計とスレッド・パフォーマンス統計の監視」を参照してください。

ディスパッチャ呼出しスレッド

呼出しディスパッチャ・メッセージの処理に割り当てるスレッド合計数を指定します。呼出しディスパッチャ・メッセージは、受信したペイロードごとに生成され、新規インスタンスをインスタンス化するために使用されます。サービス・エンジンで処理されるリクエストの大多数が(インスタンス・コールバックではなく)インスタンス呼出しである場合は、呼出しスレッド数を増加させることでパフォーマンスが大幅に向上する可能性があります。スレッド数が多くなるほど、コンテキスト切替えコストが高くなるため、CPU使用率が大幅に増加する可能性があります。

デフォルト値は20スレッドです。1スレッド未満の値は、デフォルト値に変更されます。

これらのスレッドの監視の詳細は、第14.6項「BPELプロセス・サービス・エンジンのリクエスト統計とスレッド・パフォーマンス統計の監視」を参照してください。

ディスパッチャ・エンジン・スレッド

エンジン・ディスパッチャ・メッセージの処理に割り当てるスレッド合計数を指定します。エンジン・ディスパッチャ・メッセージは、アクティビティを非同期で処理する必要がある場合に必ず生成されます。デプロイされるプロセスの大多数が永続的で、多数のデハイドレーション・ポイント(midprocess receive、onMessage、onAlarmおよびwaitアクティビティ)がある場合は、ディスパッチャ・エンジン・スレッド数を増加させることでパフォーマンスが大幅に向上する可能性があります。スレッド数が多くなるほど、コンテキスト切替えコストが高くなるため、CPU使用率が大幅に増加する可能性があります。

デフォルト値は30スレッドです。1スレッド未満の値は、デフォルト値に変更されます。

これらのスレッドの監視の詳細は、第14.6項「BPELプロセス・サービス・エンジンのリクエスト統計とスレッド・パフォーマンス統計の監視」を参照してください。

ペイロードの検証

インバウンド・メッセージとアウトバウンド・メッセージの検証を有効にする場合に選択します。スキーマに準拠しないペイロード・データが捕捉され、フォルトとして表示されます。

注意: この設定は、SOAコンポジット・アプリケーションおよびSOAインフラストラクチャのペイロード検証レベルの設定に依存しません。ペイロード検証がサービス・エンジンとSOAインフラストラクチャの両レベルで有効な場合、データは2回チェックされます。1回目は、データがSOAインフラストラクチャに入るとき、2回目は、データがサービス・エンジンに入るときです。

BPELモニターおよびセンサーの無効化

デプロイ済のすべてのSOAコンポジット・アプリケーションのすべてのBPELコンポーネントに定義されているすべてのBPELモニターおよびセンサーを無効にするには、このチェック・ボックスを選択します。

3. 「適用」をクリックします。

4. システムMBeanブラウザで拡張BPELプロパティを構成するには、「詳細BPEL構成プロパティ」をクリックします。表示されるプロパティの一部を次に示します。各プロパティには説明が記載されています。

- AsynchAuditBatchSize: Oracle Exalogicプラットフォームで、(複数のインスタンスの)複数の監査証跡メッセージを単一トランザクションに格納します。詳細は、第15.5項「Oracle Exalogicプラットフォームにおけるインスタンスとメッセージ・データのOracle Coherence分散キャッシュへの格納」を参照してください。

- BpelcClasspath: BPELで生成されたJavaソースをコンパイルするときに含める追加BPELクラスのパス。詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のカスタム・クラスとJARファイルの追加方法に関する項を参照してください。

- DisableAsserts: BPELでアサーションの実行を無効化します(bpelx:assertアクティビティを含む)。詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のアサーションの無効化方法に関する項を参照してください。

- DisableSensors: センサーへのすべての呼出しを無効にします。

- DispatcherNonBlockInvokeThreads: 非ブロッキング呼出しディスパッチャ・メッセージの処理に割り当てるスレッドの合計数。システムに多数の非ブロッキング呼出しがある場合は、このプロパティの値を増分できます。デフォルト値は2です。1未満の値は、自動的にデフォルト値に変更されます。

- ExecuteCallbacksInOrder: BPELプロセス・サービス・エンジン内にコールバックの受信時間の順番にBPELプロセス・コールバックを保持します(trueに設定されている場合)。詳細は、第13.5項「コールバック・メッセージの順序の保持」を参照してください。

- ExpirationMaxRetry: 失敗した期限切れ呼出し(wait/onAlarm)が失敗するまでに再試行される最大回数。

- ExpirationRetryDelay: 次の期限切れ呼出しの再試行までの遅延。

- InstanceKeyBlockSize: 1回のフェッチごとにデハイドレーション・ストアから割り当てられるインスタンスIDのブロック・サイズ。

- MaximumNumberOfInvokeMessagesInCache: メモリー内キャッシュに格納される起動メッセージ数。

- MaxRecoverAttempt: 同一のリカバリ可能なインスタンスに発行する自動リカバリ試行の数。詳細は、第13.4項「起動メッセージおよびコールバック・メッセージの自動リカバリ試行の構成」と第15.5.4項「複数の監査証跡メッセージの単一トランザクションへの格納の構成」を参照してください。

- MinBPELWait: BPELプロセスがデハイドレーションに関連して実際に待機する最小期間。詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の有効期限を設定する待機アクティビティの作成に関する項を参照してください。

- OneWayDeliveryPolicy: 一方向呼出しメッセージを配信するかどうかを変更します。

- QualityOfService: BPELプロセス・サービス・エンジンに対してOracle Coherenceのキャッシュを有効または無効にします。詳細は、第15.5.3項「Oracle Coherenceのキャッシュ機能の構成」を参照してください。

- RecoveryConfig: アクティビティの自動リカバリを構成し、マスター・ノード・リカバリ・スケジューリングを使用するようにクラスタ環境を構成します。詳細は、第13.2項「Oracle BPEL Process Managerの自動リカバリの構成」と第13.3項「マスター・ノード・リカバリ・スケジューリングの構成」を参照してください。

- StatsLastN: 最近処理されたリクエスト・リストのサイズ。この値を1000などの値に変更してください。これによって、「統計」ページで下位レベルの統計を表示できます。詳細は、第14.6項「BPELプロセス・サービス・エンジンのリクエスト統計とスレッド・パフォーマンス統計の監視」を参照してください。

- SyncMaxWaitTime: タイムアウトする前に実行されるリクエスト操作およびレスポンス操作の最大回数。このプロパティの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の永続同期プロセスのトランザクション・タイムアウト値の指定に関する項を参照してください。

5. 使用環境に適した変更を行います。

Oracle BPELプロセスのチューニングとパフォーマンス・パラメータの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』を参照してください。

13.2 Oracle BPEL Process Managerの自動リカバリの構成

Oracle SOA Suiteには、Oracle Enterprise Manager Fusion Middleware Controlの自動リカバリ機能が備えられており、この機能を使用して、次のものを構成およびリカバリでます。

- 関連付けられた有効期限を持ち、再スケジュールされるSOAインフラストラクチャでスケジュールされる、すべてのアクティビティ(waitアクティビティやpickアクティビティのOnAlarmブランチなど)

- 指定されたしきい値の時間内に完了しないすべてのアクティビティ

- 未解決のすべての起動メッセージおよびコールバック・メッセージ

自動リカバリを構成するには、次の手順を実行します。

1. ナビゲータで、「soa-infra」を右クリックし、「SOA管理」→「BPELプロパティ」の順に選択します。

2. 「詳細BPEL構成プロパティ」をクリックします。

3. 「名前」列で「RecoveryConfig」をクリックします。

4. RecurringScheduleConfigを展開します。
このセクションでは、繰返しのリカバリ試行を構成できます。

5. 次のプロパティを環境に適した値に設定し、「適用」をクリックします。

プロパティ

説明

maxMessageRaiseSize

繰り返されるリカバリ試行ごとに送信するメッセージの最大数。サーバーに対するリカバリの影響を制限するには、このプロパティを使用します。この値は、アクティビティ、起動およびコールバックの問合せからフィルタするメッセージの最大数を指定するもので、つまり、アクティビティ表、呼出し表およびコールバック表のそれぞれからの50メッセージです。

デフォルト値は50です。負の値に設定すると、データベースから選択されたすべてのメッセージがリカバリのために送信されます。0の値の場合は、データベースからメッセージが選択されません(実質的にリカバリが無効になります)。

startWindowTime

日次リカバリ・ウィンドウの開始時刻であり、24時間の表記法で指定します。したがって、午後2:00は14:00と指定します。時間が1桁の値の場合、先頭のゼロを指定する必要はありません(1:00-9:00)。

デフォルト値は午前0時(00:00)です。解析された時刻が無効な値の場合、デフォルトで午前0時に設定されます。

stopWindowTime

日次リカバリ・ウィンドウの停止時刻であり、24時間の表記法で指定されます。したがって、午後2:00は14:00と指定します。時間が1桁の値の場合、先頭のゼロを指定する必要はありません(1:00-9:00)。

日次リカバリを行わない場合、開始ウィンドウ時刻と停止ウィンドウ時刻を同じ値に設定します。停止ウィンドウ時刻が開始ウィンドウ時刻よりも前である場合は、開始ウィンドウ時刻と停止ウィンドウ時刻の両方が、それぞれのデフォルト値に変更されます。

デフォルト値は午前0時(04:00)であり、実質的に、繰返しリカバリが04:00まで実行されるように設定されます。

解析された時刻が無効な値である場合は、デフォルトで00:00に設定されます。

subsequentTriggerDelay

日次の繰返し起動リカバリ期間内での、リカバリ試行間の秒数。次のリカバリ・トリガーが現在のリカバリ期間の外になる場合、そのトリガーは次の繰返しリカバリ期間(翌日)までスケジュールされません。

デフォルト値は300です(5分)。負の値の場合はデフォルトが選択されます。

threshHoldTimeInMinutes

これは自動リカバリ処理を無視する分単位のしきい値の時間です。自動的な起動およびコールバック・リカバリの場合、この値は受信日付がしきい値の時間よりも小さいメッセージを選出するために使用されます。

自動アクティビティ・リカバリの場合、この値は修正日付がしきい値の時間よりも小さいアクティビティを選出するために使用されます。

このプロパティによって、BPELプロセス・サービス・エンジンがリカバリ目的でメッセージを選択するとき、サービス・エンジンの別のスレッドがそのメッセージを処理しているというメッセージ競合のシナリオを回避します。このプロパティによって、サービス・エンジンのリカバリ部分は、threshHoldTimeInMinutesの値よりも古いメッセージについてリカバリを試行するようになります。

デフォルト値は10分です。負の値の場合はデフォルトが選択されます。

6. 「StartupScheduleConfig」を展開します。
このセクションでは、サーバー起動リカバリ試行を構成できます。

7. 次のプロパティを環境に適した値に設定し、「適用」をクリックします。

プロパティ

説明

maxMessageRaiseSize

起動リカバリ試行ごとに送信するメッセージの最大数。サーバーに対するリカバリの影響を制限するには、このプロパティを使用します。この値は、アクティビティ、起動およびコールバックの問合せからフィルタするメッセージの最大数を指定するもので、つまり、アクティビティ表、呼出し表およびコールバック表のそれぞれからの50メッセージです。

デフォルト値は50です。負の値に設定すると、データベースから選択されたすべてのメッセージがリカバリのために送信されます。ゼロの値の場合、データベースからメッセージが選択されません(実質的にリカバリが無効になります)。

startupRecoveryDuration

起動リカバリ期間が継続する秒数を指定します。サーバーが開始した後、起動リカバリ期間に入ります。この期間中、保留中のアクティビティと未配信のコールバック・メッセージおよび起動メッセージは処理のため再発行されます。

デフォルト値は600です(10分)。負またはゼロの値の場合は起動リカバリが無効になります。

subsequentTriggerDelay

サーバー起動リカバリ期間内でのリカバリ試行間の秒数。次のリカバリ・トリガーがサーバー起動期間の外になる場合、そのトリガーはスケジュールされず、サーバーは繰返しリカバリ期間に移行します。

デフォルト値は300です(5分)。負の値の場合はデフォルトが選択されます。

注意:

クラスタ内では、別々のノードが同じ項目の自動リカバリを同時に試行する場合があります。最初のノードが項目をロックしてリカバリを試行し、別のノードは安全に無視できる例外を発生させることができます。

13.3 マスター・ノード・リカバリ・スケジューリングの構成

マスター・ノード・リカバリ・スケジューリングを使用するようにクラスタ環境を構成できます。この環境では、マスター・ノードは、クラスタ内のすべてのノードに対してリカバリを実行するための専用ノードです。

注意:

この機能は、Oracle Fusion Middlewareリリース1 (11.1.1.3)より前のデータベース・スキーマを使用している場合は動作しません。

マスター・ノード・リカバリ・スケジューリングを使用すると、次のタスクを実行できます。

- 期限を過ぎた、有効期限が指定されているアクティビティ(waitアクティビティやpickアクティビティのOnAlarmブランチなど)のリカバリを実行できます。マスター・ノードは、期限切れの作業アイテムを取得し、再スケジュールします。

- 残されている作業アイテムのリカバリ

- コールバック・メッセージのリカバリ

- 起動メッセージのリカバリ

- 期限切れアクティビティのフェイルオーバーを実行でき、マスター・ノードは失敗したノードを検出すると、有効期限が指定された作業アイテムを再スケジュールしようとします。

マスター・ノード・リカバリ・スケジューリングを構成する手順は、次のとおりです。

1. Oracle Enterprise Manager Fusion Middleware Controlにログインします。

2. 「soa-infra」を右クリックします。

3. 「SOA管理」→「BPELプロパティ」の順に選択します。

4. 「詳細BPEL構成プロパティ」をクリックします。

5. 「名前」列で「RecoveryConfig」をクリックします。

6. ClusterConfigを開きます。ClusterConfigプロパティは、RecurringScheduleConfigとStartupScheduleConfigにそれぞれ設定した繰り返しのリカバリ試行プロパティおよびサーバー起動リカバリ試行プロパティと関連して機能します。

7. 次のプロパティを環境に適した値に設定し、「適用」をクリックします。

注意:

インスタンスまたはメッセージがリカバリ可能になると、リカバリが試行されます。ただし、試行回数は追跡されません。リカバリが失敗すると、同じレコードを取得して試行し、再度失敗することを続けます。

プロパティ

説明

clusterDbTimeRefresh

データベース時間のローカル・コピーをリフレッシュする頻度を指定します。別のコンピュータでのクロック・ドリフトが考慮されます。クラスタ内のすべてのノードは、正確さに関係なく、データベース時間に依存しています。

デフォルト値は12時間(43200秒と指定)です。

heartBeatInterval

クラスタ内の他のノードによって公開されたメッセージを確認するために、ノードがクラスタ・メッセージ表をポーリングする頻度を指定します。

デフォルト値は5秒です。

次のタスクが各間隔で実行されます。

- cluster_node表のノードの最終更新時間を更新します。

- マスター・ロールの所有権の要求を試行します。

- マスター・ロールが要求された場合、リカバリ・マネージャは作業を再開します。

- nodeReapThreshold値の間に更新時間が更新されていないすべてのノードを確認し、cluster_node表からそれらのノードを削除し、このノードのすべての期限切れ作業アイテムを再スケジュールします。

masteAliveThreshold

マスター・ノードがアクティブと見なされる秒数を指定します。この秒数の間にクラスタにチェックインしていないマスター・ノードは、終了されたと見なされます。cluster_master表で排他ロックを取得するノードはどれでも、この時点からマスター・ロールを要求できます。

デフォルト値は15分(900秒と指定)です。

nodeReapInterval

古いクラスタ・ノードとマークするためにハートビート・スレッドを流用する頻度を指定します。マスター・ノードのみがこのジョブを実行します。

デフォルト値は2時間(7200秒と指定)です。

nodeReapThreshold

ノードがアクティブと見なされる秒数を指定します。この秒数の間にクラスタにチェックインしていないノードは、終了されたと見なされます。ハートビート・サイクル中に、マスター・ノードはcluster_node表をクリーン・アップしようとします。

デフォルト値は15分(900秒と指定)です。

13.4 起動メッセージおよびコールバック・メッセージの自動リカバリ試行の構成

リカバリ可能な同じインスタンス内で発行する自動リカバリ試行の数を構成できます。入力した値によって、起動メッセージおよびコールバック・メッセージがリカバリされる最大回数が指定されます。値が2(デフォルト値)の場合、すべてのメッセージがリカバリされます。1つのメッセージに対するリカバリ試行の数が、指定された値を超過すると、そのメッセージにはリカバリ不能のマークが付けられます。

起動メッセージおよびコールバック・メッセージの自動リカバリ試行を構成するには、次の手順を実行します。

1. ナビゲータで、「soa-infra」を右クリックし、「SOA管理」→「BPELプロパティ」の順に選択します。

2. 「詳細BPEL構成プロパティ」をクリックします。

3. 「MaxRecoverAttempt」に移動します。

4. 「値」フィールドに値を入力します。
MaxRecoverAttemptを設定した場合の起動メッセージとコールバック・メッセージのリカバリ動作は異なります。たとえば、「MaxRecoverAttempt」を4に設定した場合は次のようになります。

- 起動メッセージ・リカバリは、4 (N)回再試行されてから、消耗済状態にメッセージが移動されます。

- コールバック・メッセージ・リカバリは、5回(N + 1)再試行されてから、消耗済状態にメッセージが移動されます。

これは予想された動作です。最初の試行はリカバリ試行とはみなされません。リカバリ試行はBPELプロセス・サービス・エンジンによって増分されます。MaxRecoverAttemptが1に設定されている場合は、デフォルトの解決プロセスが1回実行された後で、リカバリ試行が1回実行されます。

5. 「適用」をクリックします。

起動メッセージおよびコールバック・メッセージのリカバリの詳細は、第15.4項「BPELプロセス・サービス・エンジンのメッセージ・リカバリの実行」を参照してください。

13.5 コールバック・メッセージの順序の保持

システムMBeanブラウザで「ExecuteCallbacksInOrder」プロパティをtrueに設定することで、BPELプロセスのコールバック・メッセージの順番を保持して、確実に正しい順番でBPELプロセス・インスタンスに配信されるようにできます。ExecuteCallbacksInOrderは、所定のBPELプロセス・サービス・コンポーネント・インスタンスについてBPELプロセス・サービス・エンジンによって受信された順番でコールバックが配信されるようにできます。この設定は、BPELプロセス・サービス・エンジンにデプロイされているすべてのSOAコンポジット・アプリケーションに影響を与えます。

ExecuteCallbacksInOrderプロパティへのアクセスと構成の詳細は、第13.1項「BPELプロセス・サービス・エンジン・プロパティの構成」を参照してください。

13.6 BPELプロセス・サービス・コンポーネント・レベルでの監査レベルの設定

BPELプロセス・サービス・コンポーネントには監査レベルを設定できます。この設定は、SOAインフラストラクチャ、サービス・エンジン、SOAコンポジット・アプリケーションの各レベルの監査レベル設定より優先されます。サービス・コンポーネント・レベル設定はBPELプロセスについてのみ使用可能であり、Oracle Mediator、ヒューマン・ワークフローおよびビジネス・ルール・サービス・コンポーネントについてはサポートされていません。

BPELプロセス・サービス・コンポーネントの監査レベルを設定する方法は2つあります。サポートされる値は、「オフ」、「最小」、「継承」、「開発」および「本番」です。

BPELプロセス・サービス・コンポーネントに監査レベルを設定する手順は、次のとおりです。

- Oracle Enterprise Manager Fusion Middleware Controlの「システムMBeanブラウザ」で、次の手順を実行します。

1. ナビゲーション・ツリーで「SOA」フォルダを開きます。

2. 「soa-infra」を右クリックして、「管理」→「システムMBeanブラウザ」の順に選択します。

3. 「アプリケーション定義のMBean」→「oracle.soa.config」→「サーバー: server_name」→「SCAComposite」→「Composite_Name」→「SCAComposite.SCAComponent」→「BPEL_Service_Component」→「プロパティ」の順に選択します。

4. 「追加」アイコンをクリックします。

5. 「Element_number」フォルダを開きます。

6. 複数リストから、「False」を選択します。

7. 「名前」フィールドに、bpel.config.auditlevelと入力します。

8. 「値」フィールドに値を入力します。

9. 「適用」をクリックします。

- Oracle JDeveloperを使用する場合

1. bpel.config.auditLevelプロパティに、SOAプロジェクトのcomposite.xmlファイル内の該当する値を設定します。

<component name="BPELProcess">
<implementation.bpel src="BPELProcess.bpel" />
<property name="bpel.config.auditLevel">Off</property>
</component>

監査レベルの詳細は、第1.4.1.1項「監査レベル設定の優先順位の概要」を参照してください。

14 BPELプロセスのサービス・コンポーネントとエンジンの監視

この章では、BPELプロセス・サービス・コンポーネントとサービス・エンジンの監視方法(監査証跡とプロセス・フロー、サービス・コンポーネントとサービス・エンジンのインスタンスとフォルト、フォルト/アクティビティ/可変センサー・データ、サービス・エンジンのリクエスト統計とスレッド・パフォーマンス統計、デプロイ済BPELプロセス・サービス・コンポーネント、サービス・エンジンでのリクエストの所要時間の監視を含む)について説明します。

この章では、次の項目について説明します。

- 第14.1項「BPELプロセス・サービス・コンポーネントの監査証跡とプロセス・フローの監視」

- 第14.2項「BPELプロセス・サービス・コンポーネントの最新のインスタンスとフォルトの監視」

- 第14.3項「BPELプロセス・サービス・コンポーネントのインスタンスの監視」

- 第14.4項「BPELプロセス・サービス・コンポーネントにおけるフォルト、アクティビティおよび可変センサー・データの監視」

- 第14.5項「BPELプロセス・サービス・エンジンのインスタンスとフォルトの監視」

- 第14.6項「BPELプロセス・サービス・エンジンのリクエスト統計とスレッド・パフォーマンス統計の監視」

- 第14.7項「BPELプロセス・サービス・エンジンのインスタンスの監視」

- 第14.8項「サービス・エンジンのデプロイ済BPELプロセス・サービス・コンポーネントの監視」

- 第14.9項「BPELプロセス・サービス・エンジンでのリクエストの所要時間に関する統計の表示」を参照してください。

サービス・コンポーネントとサービス・エンジンの概念の詳細は、次の項を参照してください。

- 第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」

- 第1.2.6項「サービス・エンジンの概要」

- 『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』

14.1 BPELプロセス・サービス・コンポーネントの監査証跡とプロセス・フローの監視

この項では、SOAコンポジット・アプリケーション・インスタンスのBPELプロセス・サービス・コンポーネントに関する監査証跡とプロセス・フローの表示方法について説明します。

注意:

この項では、SOAコンポジット・アプリケーション・インスタンスが起動していることを想定しています。起動していない場合、手順については、第8.1項「SOAコンポジット・アプリケーションのテスト・インスタンスの起動」を参照してください。

BPELプロセス・サービス・コンポーネントの監査証跡とプロセス・フローを表示する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にあるパーティションを展開します。

2. 特定のSOAコンポジット・アプリケーションを選択します。

選択したコンポジット・アプリケーションに対する「ダッシュボード」ページが表示されます。

2. 次のいずれかの方法を使用して、アプリケーションのインスタンスを選択します。

- このアプリケーションの最新のインスタンスから選択する場合は、「最新のインスタンス」セクションの「インスタンスID」列で、インスタンスのインスタンス番号をクリックします。

- このアプリケーションのすべてのインスタンスから選択する場合は、「インスタンス」タブをクリックして、次に「インスタンスID」リストの特定のインスタンスをクリックします。

「フローのトレース」ページに、次の詳細が表示されます。

- 「フォルト」セクションには、SOAコンポジット・アプリケーションを構成するサービス、サービス・コンポーネントおよび参照で発生しているフォルトが表示されます。センサーを使用すると、実行時にBPELプロセスのアクティビティ、変数およびフォルトを監視できます。フォルトを選択すると、「トレース」セクションでは、フォルトが発生した行が強調表示されます。フォルトを閉じると、「トレース」セクションの選択がクリアされます。

- 「センサー」セクションには、SOAコンポジット・アプリケーションのサービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントに組み込まれているコンポジット・センサーの詳細が表示されます。センサーの合計数はセクション・ヘッダーに表示されます。コンポジット・センサーは、設計時にOracle JDeveloperで、サービス・バインディング・コンポーネント、参照バインディング・コンポーネントおよびビジネス・イベントをサブスクライブしているサービス・コンポーネントに追加できます。このセクションでコンポジット・センサーを選択すると、「トレース」セクションでは、コンポジット・センサー・データが収集されたサービスまたは参照が強調表示されます。センサーを閉じると、「トレース」セクションの選択がクリアされます。

注意:

「フォルト」または「センサー」セクションは1つずつ展開します。フォルトまたはセクション情報は、この方法で表示した場合のみ表示されます。

- 「トレース」セクションには、SOAコンポジット・アプリケーションを構成するサービス、サービス・コンポーネントおよび参照間での一連のメッセージ・フローが表示されます。

フローのトレースは、実行コンテキストID (ECID)によって識別されるメッセージ・フローのランタイム追跡であり、このページの右上隅に表示されます。ECIDを使用すると、様々なコンポジット・アプリケーションのインスタンスを横断するメッセージ・フローを追跡できます。フローのトレースでは、フローに属しているコンポジット・アプリケーションのすべてのサービス、参照およびコンポーネントが示されます。

「トレース」セクションにあるフローの例では、フローに関連するサービス・バインディング・コンポーネント、サービス・コンポーネントおよび参照バインディング・コンポーネントでメッセージが正常に受信されて処理されています。

3. 「フォルト」セクションで、フォルトを選択します。
選択すると、「トレース」セクションでは、フォルトが発生した行が強調表示されます。

4. フォルトを閉じると、「トレース」セクションの選択がクリアされます。

5. 「センサー」セクションを開いて、コンポジット・センサーを表示します。

6. 「センサー」セクションで、センサーを選択します。
選択すると、「トレース」セクションでは、コンポジット・センサー・データが収集された行が強調表示されます。

BPELプロセス・サービス・エンジンの「リカバリ」ページからのリカバリを必要とするBPELプロセス・メッセージがある場合は、「必須のBPELメッセージ・リカバリ」インライン警告メッセージおよびリカバリ・アイコンが表示されます。

7. 「詳細の表示」またはリカバリ・アイコンをクリックすると、「警告」ダイアログおよび次のリカバリ詳細が表示されます:

- リカバリ可能メッセージ・タイプ(起動、コールバックおよびアクティビティ)の数

- ECID値

この情報は、BPELプロセス・サービス・エンジンの「リカバリ」ページでリカバリ可能メッセージをフィルタするための検索基準の作成に使用します。「警告」ダイアログからECID番号をコピーして「ECID」フィールドに貼り付け、リカバリ可能メッセージ・タイプを「タイプ」リストから選択できます。「リカバリ」ページでECID番号を使用して検索基準を作成する詳細は、第15.4項「BPELプロセス・サービス・エンジンのメッセージ・リカバリの実行」を参照してください。

「フローのトレース」ページでのこのメッセージ・リカバリ情報の表示は、システムMBeanブラウザのAuditConfigプロパティによって制御されています。デフォルトでは、このプロパティは「すべて」に設定されており、この情報の表示が可能です。「フローのトレース」ページでこの情報を表示しない場合は、「SOAインフラストラクチャの共通プロパティ」ページの「詳細SOAインフラ拡張構成プロパティ」セクションで、AuditConfigプロパティのbpelRecoveryStatusキーをOffに設定します。詳細は、第3.1項「SOAインフラストラクチャ・プロパティの構成」を参照してください。

ECIDに関する次の制限に注意してください。

- コンポジット・アプリケーションの各インスタンスには、別々のECIDが表示され、コンポジット・アプリケーションの全インスタンスの完全なフローを追跡できるコンポジット・レベルのECIDは表示されません。

- 完全なフロー情報を取得するには、ログ・ファイルでコンポジット・レベルのECIDを検索する必要があります。検索した値を使用して、特定のコンポジットとそのコンポジットで実行された全インスタンスに関するすべての情報を取得します。

- ECIDは、ビジネス・イベントを介して伝播されません。このため、収集されるロギング情報の量が制限される場合があります。たとえば、同じコンポジット・アプリケーションでサブスクライブされるイベントを公開した場合は、使用できるロギング情報が制限されます。

8. 「トレース」セクションの「インスタンス」列で、特定のBPELプロセス・サービス・コンポーネントのインスタンスをクリックします。サービス・コンポーネントのインスタンスはこのセクションからアクセスできます。サービスと参照にはアクセスできません。
「インスタンス」ページが表示されます。

これら4つのページを使用して、BPELプロセス・サービス・コンポーネント・インスタンスの監査証跡、フロー、センサー値およびフォルトを表示します。次のリンクを使用すると、インスタンスに関するその他の詳細を表示できます。

- 「フローのトレース」リンク: ページの左上隅にあるブレッドクラムをクリックすると、該当するBPELコンポーネント・インスタンスが含まれるECID(コンポジット・インスタンス)のフローのトレースにアクセスできます。

- 「情報」アイコン: BPELコンポーネント名(ページ・タイトル)の右側にある「情報」アイコンをクリックすると、このBPELインスタンスの履歴情報が表示されます。この情報には、インスタンスID、ECID、インスタンスの起動時間または最終更新日時、インスタンスの状態(実行中など)およびフォルト件数などのインスタンスのサマリーが含まれます。
このアイコンは、BPELプロセスおよびOracle Mediatorの「監査証跡」ページにのみ表示されます。ヒューマン・タスクおよびビジネス・ルールのページには表示されません。

- 監査レベルの設定: クリックすると、このインスタンスで使用される監査レベルなど、情報の詳細が表示されます。

- raw XMLの表示: クリックすると、監査証跡のraw XMLが表示されます。

「監査証跡」ページに、BPELプロセス内のアクティビティに関する実行の詳細が表示されます。

9. 監査証跡をスクロールしてエラーを確認し、ペイロード・リンクを開いてフローの特定の場所にある内容を表示します。

注意:

- 実行されなかったpickアクティビティまたはscopeアクティビティの取り消されたonMessageブランチは監査証跡に表示されます。ただし、フロー・ダイアグラムには、これらの取り消された同じonMessageブランチは表示されません。これは予想された動作です。

- トランザクションがロールバックとして「監査証跡」ページに表示されると、次のエラー・メッセージが表示されます。

The transaction was rolled back. The work performed for bpel
instance "instance_ number" was rolled back to the previous
dehydration point,  but the audit trail has been saved.
You can recover the instance from the recovery console by
resubmitting the callback message or activity for execution

このメッセージは、リカバリがアクティビティまたはコールバックのどちらに基づいて発生するかを具体的に示すものではありません。これは所定の動作です。監査メッセージを通じて各インスタンスをリカバリしないことをお薦めします。かわりに、自動リカバリを設定してこれらのインスタンスをリカバリしてください。

10. 「フロー」タブをクリックします。
BPELプロセス・アクティビティのフロー・ダイアグラムが表示されます。このフロー・ダイアグラムでは、BPELプロセス・アクティビティのフォルトが強調表示されます。

11. アクティビティをクリックして、プロセス内のペイロードのフローを表示します。

注意:

Microsoft Internet Explorerを使用する場合は、「詳細をクリップボードにコピー」をクリックすると、アクティビティ詳細をクリップボードにコピーできます。Mozilla Firefoxを使用する場合、このリンクは表示されません。かわりに、手動でテキストを選択してコピーし、ファイルに貼り付ける必要があります。

12. フロー・ダイアグラムをスクロールしてエラーを確認し、強調表示されたアクティビティをクリックしてエラー・メッセージを表示します。

13. メッセージを閉じます。

14. 「フォルト」タブをクリックします。
このページには、エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、およびフォルトが発生したアクティビティが表示されます。このページには、BPELコンポーネント・インスタンスのフォルトが表示されます(サービス・バインディング・コンポーネントまたは参照バインディング・コンポーネントで発生したフォルトは表示されません)。

アクティビティの処理中にフォルトが発生した場合、フォルトのアクティビティの場所は、通常、「アクティビティ」列に表示されません。

- Oracle BPEL Process Managerの場合、この列は、タイムアウトしたreceiveアクティビティのみが表示されます。他のすべての場合、この列は空です。

- Oracle BPMの場合、この列は常に空です。

これは予想された動作です。

リカバリ可能と識別されているインスタンスのフォルトをリカバリできます。このページには、すべてのインスタンスのフォルトと、リカバリ可能かどうかが示されます。サービスまたは参照で発生したコンポーネント・インスタンスのフォルトは、ここには表示されません。

このページでは、個々のフォルトをリカバリ対象として指定できます。また、他のページでは使用できないフォルト・リカバリ粒度に関する度合いが表示されます。

ただし、このページでは一括フォルト・リカバリを実行できません。一括フォルト・リカバリを実行するには、次のいずれかのページを使用します。

- 特定のSOAコンポジット・アプリケーションまたはSOAインフラストラクチャの「フォルト・メッセージと拒否メッセージ」ページ

- BPELプロセス・サービス・エンジンまたは特定のBPELプロセス・サービス・コンポーネントの「フォルト」ページ

15. リカバリ可能として識別されたリカバリ対象のフォルトを次のいずれかの方法を使用して選択します。ページがリフレッシュされ、ページの下部にフォルト・リカバリ・セクションが表示されます。

- 「エラー・メッセージ」列にあるフォルトをクリックすると、ポップアップ・メッセージにフォルトの詳細(フォルトID、フォルトの発生時間、フォルトの場所、フォルト・タイプ、エラー・メッセージの完全なテキストなど)が表示されます。フォルトがリカバリ可能と識別されている場合は、クリック可能な「ここでリカバリ」ボタンが表示されます。

- 「リカバリ」列にあるリカバリ可能と識別されたフォルトをクリックします。

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

アクション

説明

再試行

再試行成功時アクションを指定するオプション付きでインスタンスを再試行します。このリカバリ・アクションを使用するシナリオ例は、ネットワーク・エラーのためにサービス・プロバイダにアクセスできないことが原因でフォルトが発生した場合の例です。ネットワーク・エラーは現在解決しています。

中断

インスタンス全体を終了します。

リプレイ

フォルトが発生したスコープ・アクティビティ全体を再度リプレイします。

再スロー

現在のフォルトを再スローします。フォルトの処理に、BPELフォルト・ハンドラ(catchブランチ)が使用されます。デフォルトでは、再スロー・フォルト・ポリシーが明示的に指定されていない場合、すべての例外がフォルト管理フレームワークによって捕捉されます。

続行

フォルトを無視して処理を続行します(フォルト・アクティビティには成功のマークが付けられます)。

選択したアクションによって、追加のフィールドが表示されます。たとえば、「再スロー」を選択すると、次のフィールドが表示されます。

17. 「再試行成功後」リストを使用して、再試行の成功後に起動する定義済アクションを選択します。「変数」リストで変数を選択した場合は、その値を「値」テキスト・ボックスで編集できます。

18. ブラウザの「戻る」ボタンをクリックし、フロー・ダイアグラムを終了します。

14.1.1 フォルトが発生していないのにreplayアクティビティが失敗したと表示される

BPELプロセスのreplayアクティビティを呼び出すと、実際にはフォルトは発生していないのに、BPELプロセス・インスタンスの「フォルト」タブで失敗したと表示されます。

これは予想された動作です。フォルトが表示される理由は、BPELプロセス・サービス・エンジンがスコープ・アクティビティを再実行するからです。replayアクティビティをBPELプロセスに追加すると、<bpelx:replay name="replay_name"/>の内部実装は基となるBPELフォルトの<throw faultName="bpelx:replay"/>を使用します。

サービス・エンジンは、フォルトをスローすることでアクティビティを実行し、包含するスコープ・アクティビティのための暗黙的なcatchブロックを構築するという理由から、このフォルトが表示されます。

14.1.2 複数のサーバー上におけるコンポジット間呼び出しのフロー・トレース

互いを起動する複数のSOAコンポジット・アプリケーションが複数のサーバー上に存在する場合、BPELプロセス・フローのトレースは、正しい親子関係を表示するようにレンダリングできません。たとえば、次のシナリオがあるとします。

- コンポジット1がコンポジット2を起動し、コンポジット2がコンポジット3を起動します。

- 各コンポジットにはBPELプロセス・サービス・コンポーネントが含まれています。

- コンポジット1とコンポジット3はサーバー1にあり、コンポジット2はサーバー2にあります。

この環境で、コンポーネント3の親IDはコンポーネント2に設定されます。ただし、コンポジット2は別のサーバー上にあるため、フローのトレースではコンポジット3が親を持つものとして表示されません。したがって、コンポジット3はフローのトレースのルートに配置されます。

14.1.3 監査証跡とプロセス・フローでのBPEL 2.0アクティビティの監視

BPEL仕様のバージョン2.0をサポートするBPELプロセス・サービス・コンポーネント・インスタンスの監査証跡およびプロセス・フローを表示できます。次のBPEL 2.0アクティビティを表示できます。

- プロセスの構造フロー関連のアクティビティ: これらのアクティビティは、順序付け、反復および分岐を行う他のワークフローまたはプログラミング言語に類似しています。

- forEach: このアクティビティは、BPEL 1.1のOracle拡張機能のflowNアクティビティと同じです。このアクティビティでは、複数のアクティビティ・セットの処理方式として、パラレルとシリアルの両方がサポートされています。

- if: このアクティビティはBPEL 1.1のswitchアクティビティと同じです。

- repeatUntil: このアクティビティは、指定されたブール条件がtrueに評価されるまで、含まれているアクティビティの実行を反復します。

- 例外処理およびリカバリ・アクティビティ:

- compensateScope: このアクティビティは、正常に完了した指定の内部スコープ上で補正を開始します。

- rethrow: このアクティビティは、直接囲んでいるフォルト・ハンドラによって最初に捕捉されたフォルトを再スローします。

- その他のアクティビティ

- exit: このアクティビティはBPEL 1.1のterminateアクティビティと同じです。

- dehydrate: このアクティビティによって、インスタンスのデハイドレーションが可能になります。このアクティビティはBPEL 1.1でも使用できます。

たとえば、図14-1に、BPELプロセスの監査証跡内のifアクティビティを示します。

図14-1 BPELプロセスの監査証跡内のifアクティビティ

図14-2に、同じifアクティビティをBPELプロセスのフローで示します。

図14-2 BPELプロセスのフロー内のifアクティビティ

ifアクティビティをクリックすると、このアクティビティについて定義された条件が表示されます。

図14-3 ifアクティビティの条件

BPEL 2.0の詳細は、次のURLにあるWeb Services Business Process Execution Language Version 2.0仕様を参照してください。

http://www.oasis-open.org

BPEL仕様のバージョン2.0をサポートするBPELプロセス・サービス・コンポーネントの設計の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

14.2 BPELプロセス・サービス・コンポーネントの最新のインスタンスとフォルトの監視

BPELプロセス・サービス・コンポーネントの最新のインスタンスとフォルトを監視できます。SOAコンポジット・アプリケーションの各サービス・コンポーネントには、独自のインスタンスIDがあります。このIDは、それぞれのサービス・コンポーネントが属しているSOAコンポジット・アプリケーションの全体のインスタンスIDとは異なります。

BPELプロセス・サービス・コンポーネントのインスタンスとフォルトを監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にあるパーティションを展開します。

2. 特定のSOAコンポジット・アプリケーションを選択します。

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

3. 「ダッシュボード」をクリックします。
「ダッシュボード」ページの上部には、次の詳細が表示されます。

- BPELプロセス・サービス・コンポーネントの最新のインスタンス。インスタンスID、インスタンスの状態(正常完了や失敗など)、開始時間、最終更新日時、およびインスタンスが記述されているログが表示されます。

- BPELプロセス・サービス・コンポーネントの最新のフォルト。エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、BPELサービス・コンポーネントのインスタンスID、フォルトが発生したBPELアクティビティ、およびフォルトが記述されているログが表示されます。

- BPELプロセス・サービス・コンポーネントのアクティビティごとの平均処理時間。

4. 「最新のインスタンス」セクションで、次のタスクを実行します。

1. 「インスタンスID」列で、サービス・コンポーネントのインスタンスIDをクリックし、監査証跡、プロセス・フロー、センサー値およびフォルトを表示します。

2. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

3. セクションの下部にある「詳細を表示」をクリックし、サービス・コンポーネントの「インスタンス」ページにアクセスします。

5. 「最新のフォルトと拒否メッセージ」セクションで、次のタスクを実行します。

1. 「エラー・メッセージ」列で、エラー・メッセージをクリックし、フォルトに関する完全な情報を表示します。フォルトがリカバリ可能と識別されている場合は、「ここでリカバリ」リンクをクリックし、フォルト・リカバリを実行します。

2. 「リカバリ」列で、リカバリ可能と識別されているフォルトをクリックし、コンポーネント・インスタンス・レベルでフォルト・リカバリを実行します。

3. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

4. セクションの下部にある「詳細を表示」をクリックし、サービス・コンポーネントの「フォルト」ページにアクセスします。

「ダッシュボード」ページの下部には、次の詳細が表示されます。

- アクティビティについての時間分布の詳細(アクティビティ名、すべてのインスタンスについてのアクティビティの合計数、平均実行時間など)が表示されます。

- 特定時間帯におけるBPELプロセス・サービス・コンポーネントの成功、失敗および受信(保留中)のインスタンス数のグラフィカル表示。「表ビュー」をクリックすると、成功したインスタンスのスループット、合計フォルトのスループットおよびインスタンスのスループットなどの過去5分間のスループットの詳細が表示されます。

詳細は、第1.2.3項「SOAコンポジット・アプリケーション・インスタンスの概要」を参照し、ログ・ファイルの表示および検索については、『Oracle Fusion Middleware管理者ガイド』を参照してください。

14.3 BPELプロセス・サービス・コンポーネントのインスタンスの監視

BPELプロセス・サービス・コンポーネントのインスタンスを監視できます。各サービス・コンポーネントには、独自のインスタンスIDがあります。このIDは、このサービス・コンポーネントが属しているSOAコンポジット・アプリケーションの全体のインスタンスIDとは異なります。

BPELプロセス・サービス・コンポーネントのインスタンスを監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にあるパーティションを展開します。

2. 特定のSOAコンポジット・アプリケーションを選択します。

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

3. 「インスタンス」をクリックします。
「インスタンス」ページに、次の詳細が表示されます。

- 特定のBPELサービス・コンポーネントのインスタンスを検索するためのユーティリティ。基準を指定して「検索」をクリックします。デフォルトでは、このページに初めてアクセスしたときにはインスタンスは表示されません。インスタンスを表示するには、「検索」をクリックする必要があります。

- BPELプロセス・サービス・コンポーネントのインスタンス。インスタンスID、インスタンスの状態(完了や失敗など)、インスタンスの開始時間、インスタンスの最終更新日時、およびインスタンスが記述されているログ・ファイルが表示されます。

4. 「インスタンスID」列で、サービス・コンポーネントのインスタンスIDをクリックし、監査証跡、プロセス・フロー、センサー値およびフォルトを表示します。

5. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

詳細は、第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」を参照してください。

14.4 BPELプロセス・サービス・コンポーネントにおけるフォルト、アクティビティおよび可変センサー・データの監視

BPELプロセス・サービス・コンポーネントのフォルト、アクティビティおよび変数のセンサー・データを表示できます。センサーはBPELプロセスで、追跡可能なフィールドはOracle JDeveloperで設計します。センサーを使用すると、実行時にBPELプロセスのアクティビティ、変数およびフォルトを監視できます。

BPELプロセス・サービス・コンポーネントのセンサー・データと値を監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にあるパーティションを展開します。

2. 特定のSOAコンポジット・アプリケーションを選択します。

2. 次のいずれかの方法を使用して、アプリケーションのインスタンスを選択します。

- このアプリケーションの最新のインスタンスから選択する場合は、「最新のインスタンス」セクションの「インスタンスID」列で、インスタンスのインスタンス番号をクリックします。

- このアプリケーションのすべてのインスタンスから選択する場合は、「インスタンス」タブをクリックして、次に「インスタンスID」列の特定のインスタンスをクリックします。

「フローのトレース」ページが表示されます。

3. 「トレース」セクションの「インスタンス」列で、特定のBPELプロセス・サービス・コンポーネントをクリックします。

4. 「センサー値」タブをクリックします。

5. センサーを選択して詳細を表示します。
BPELプロセスでJMSセンサーを作成した場合、Oracle Enterprise Manager Fusion Middleware Controlには、JMSセンサー値が表示されません。センサー・アクションがデータベース内に値を格納するセンサー値(データベース・センサー値など)のみが表示されます。

センサーの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の「Oracle BPEL Process Managerセンサーの使用」に関する章を参照してください。

14.4.1 BPEL 2.0のCompensateおよびCompensateScopeアクティビティ内でのアクティビティ・センサーの動作

BPEL 2.0 compensateScopeアクティビティ内に、評価時間を完了時に設定したアクティビティ・センサーがあり、かつ、アクティビティの変数センサーが変数を指すように構成したとします。センサーがトリガーされると、compensationアクティビティが完了し、compensationアクティビティが完了した状態であることが変数によって示されると予想されます。

ただし、compensateScopeアクティビティ(およびcompensateアクティビティ)は、制御がcompensationアクティビティに渡された直後に終了します。その結果、アクティビティの変数センサーには、compensationアクティビティが終了でなく開始した状態だということが示されます。

これは予想された動作です。

補正の完了時に変数状態が取得されないようにするために、compensateまたはcompensateScopeアクティビティの後に空のアクティビティを追加し、この空のアクティビティに対して、評価時間をアクティブ化に設定したアクティビティ・センサーを設定します。

14.5 BPELプロセス・サービス・エンジンのインスタンスとフォルトの監視

BPELプロセス・サービス・エンジンで実行しているすべてのBPELプロセス・サービス・コンポーネントのインスタンスとフォルトを監視できます。BPELプロセス・サービス・コンポーネントは、別々のSOAコンポジット・アプリケーションに属している場合があります。

BPELプロセス・サービス・エンジンのインスタンスとフォルトを監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「BPEL」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「BPEL」の順に選択します。

2. 「ダッシュボード」をクリックします。
「ダッシュボード」ページの上部には、次の詳細が表示されます。

- このページに表示される最新のインスタンスとフォルトの取得は指定した期間内に制限されることを示すメッセージ。このメッセージは、「SOAインフラストラクチャの共通プロパティ」ページで「インスタンスとフォルトの表示を次に制限: 過去time_period」チェック・ボックスが選択されている場合に表示されます(デフォルトで選択されています)。期間のデフォルト値は24時間ですが、この値は変更できます。このチェック・ボックスが選択されていない場合は、最後のパージ以降のこのサービス・エンジンにおけるインスタンスとフォルト(数のメトリックを含む)がすべて表示されます。

- BPELプロセス・サービス・エンジンで実行しているすべてのBPELプロセス・サービス・コンポーネントの最新インスタンス(サービス・コンポーネントのインスタンスID、サービス・コンポーネント名、サービス・コンポーネントが属しているSOAコンポジット・アプリケーション、インスタンスの状態(正常完了や失敗など)、インスタンスの開始時間、最終更新日時、およびインスタンスが記述されているログを含む)。

3. 「最新のインスタンス」セクションで、次の監視タスクを実行します。

1. 「インスタンス数」リンクをクリックして、このサービス・エンジンの実行中のインスタンス数と合計インスタンス数を示すメッセージを表示します。デフォルトでは、このリンクは表示されません。このリンクを表示するには、次を選択します: 「インスタンス数およびフォルト数をフェッチするメトリックを無効にします。この場合でも各メトリックは必要に応じて取得できます。」チェック・ボックス(「SOAインフラストラクチャの共通プロパティ」ページ)。
「SOAインフラストラクチャの共通プロパティ」ページで「インスタンスとフォルトの表示を次に制限: 過去time_period」チェック・ボックスを選択し、期間を指定するか、またはデフォルト値を受け入れた場合は、その期間内のこのサービス・エンジンにおける実行中のインスタンス数と合計インスタンス数が表示されます。このチェック・ボックスを選択していない場合は、最後のパージ以降のこのサービス・エンジンにおけるインスタンスとフォルトがすべて表示されます。「再計算」をクリックすると、これらの数が再計算されます。

2. 「インスタンスID」列で、サービス・コンポーネントのインスタンスIDをクリックし、監査証跡、プロセス・フロー、センサー値およびフォルトを表示します。

3. 「コンポーネント」列で、特定のサービス・コンポーネントをクリックし、そのホーム・ページにアクセスします。

4. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

5. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

6. セクションの下部にある「詳細を表示」をクリックし、サービス・エンジンの「インスタンス」ページにアクセスします。

「ダッシュボード」ページの下部には、次の詳細が表示されます。

- サービス・エンジンで実行しているサービス・コンポーネント、サービス・コンポーネントのSOAコンポジット・アプリケーション、アプリケーションの状態(実行中など)、サービス・エンジンにおける合計、実行中および失敗したインスタンスの数。

- サービス・エンジンの最新のフォルト。エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、フォルトが発生したSOAコンポジット・アプリケーション、サービス・コンポーネント、サービス・コンポーネントのインスタンスID、フォルトが発生したアクティビティ、およびフォルトが記述されているログ・ファイルが表示されます。

4. 「コンポーネント」セクションで、次のタスクを実行します。

1. 「名前」列で、特定のサービス・コンポーネントをクリックし、そのホーム・ページにアクセスします。

2. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

3. セクションの下部にある「詳細を表示」をクリックし、サービス・エンジンの「デプロイ済コンポーネント」ページにアクセスします。

5. 「最新のフォルト」セクションで、次のタスクを実行します。

1. 「エラー・メッセージ」列で、エラー・メッセージをクリックし、フォルトに関する完全な情報を表示します。フォルトがリカバリ可能と識別されている場合は、「ここでリカバリ」リンクをクリックし、フォルト・リカバリを実行します。

2. 「リカバリ」列で、リカバリ可能と識別されているフォルトをクリックし、コンポーネント・インスタンス・レベルでフォルト・リカバリを実行します。

3. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

4. 「コンポーネント」列で、特定のサービス・コンポーネントをクリックし、そのホーム・ページにアクセスします。

5. 「コンポーネント・インスタンスID」列で、サービス・コンポーネントのインスタンスIDをクリックし、監査証跡、プロセス・フロー、センサー値およびフォルトを表示します。

6. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのフォルトに固有のメッセージがフィルタされて表示されます。

詳細は、第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」を参照してください。

14.6 BPELプロセス・サービス・エンジンのリクエスト統計とスレッド・パフォーマンス統計の監視

サービス・エンジンで実行しているすべてのBPELプロセス・サービス・コンポーネントのリクエスト統計とスレッド・パフォーマンス統計を監視できます。

BPELプロセス・サービス・エンジンのリクエスト統計とスレッド・パフォーマンス統計を監視する手順は次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「BPEL」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「BPEL」の順に選択します。

2. 「統計」をクリックします。
「統計」ページの「保留中のリクエスト」セクションと「アクティブ・リクエスト」セクションには、次の詳細が表示されます。追加の詳細は、「ヘルプ」アイコンをクリックしてください。

- サービス・エンジン内の保留中のリクエスト数

- サービス・エンジン内のアクティブ・リクエスト数

- サービス・エンジンのスレッド統計

「統計」ページの「リクエストのブレークダウン」の部分には、件数、リクエスト処理時間の最大、最小および平均に関する詳細が表示されます。

BPELプロセスのチューニングとパフォーマンスの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』を参照してください。

14.6.1 「リクエストのブレークダウン」表の下位レベルの詳細の表示

「統計」ページの「リクエストのブレークダウン」の部分は、リクエストが処理中に様々なサービス・エンジン・レイヤーで費やす時間に関する下位レベルの詳細を表示するように構成できます。「BPELサービス・エンジン・プロパティ」ページの「詳細BPEL構成プロパティ」リンクの「StatsLastN」プロパティを構成します。デフォルトでは、このプロパティは-1に設定されています。このプロパティをより適切な値に設定できます(例: 1000)。このプロパティは、問題を生じる可能性のある領域を分析して隔離するための情報を提供します。このプロパティへのアクセスと構成の詳細は、第13.1項「BPELプロセス・サービス・エンジン・プロパティの構成」を参照してください。

「StatsLastN」プロパティの構成後に「統計」ページの「リクエストのブレークダウン」の部分に表示される情報は、システムMBeanブラウザの次のプロパティを使用しても表示されます。

- AsyncProcessStats: 下位レベルの非同期プロセス統計を提供します。

- SyncProcessStats: 下位レベルの同期プロセス統計を提供します。

- RequestStats: 下位レベルのリクエストのブレークダウンを提供します。

これらのプロパティへのアクセスの詳細は、第14.9項「BPELプロセス・サービス・エンジンでのリクエストの所要時間に関する統計の表示」を参照してください。

14.7 BPELプロセス・サービス・エンジンのインスタンスの監視

サービス・エンジンで実行しているすべてのBPELプロセス・サービス・コンポーネントのインスタンスを監視できます。BPELプロセス・サービス・コンポーネントは、別々のSOAコンポジット・アプリケーションに属している場合があります。

BPELプロセス・サービス・エンジンのインスタンスを監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「BPEL」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「BPEL」の順に選択します。

2. 「インスタンス」をクリックします。
「インスタンス」ページに、次の詳細が表示されます。

- 特定のインスタンスを検索するためのユーティリティ。基準を指定して「検索」をクリックします。デフォルトでは、このページに初めてアクセスしたときにはインスタンスは表示されません。インスタンスを表示するには、「検索」をクリックする必要があります。

- インスタンスについて、サービス・コンポーネントのインスタンスID、サービス・コンポーネント名、SOAコンポジット・アプリケーション名、インスタンスの状態(正常完了、実行中、失敗など)、インスタンス開始時間、最終更新日時、およびインスタンスが記述されているログ・ファイルが表示されます。

注意:

SOAコンポジット・アプリケーション・インスタンスをアンデプロイしても、インスタンスは完了しません。アンデプロイによって、そのコンポジットの実行中のサービス・コンポーネント・インスタンスが「失効」としてマークされます。ただし、そのコンポジット・インスタンスのサービス・コンポーネント・インスタンスが完了している場合は、「失効」としてマークされません。

3. 「インスタンス」セクションで、次の監視タスクを実行します。

1. 「インスタンスID」列で、サービス・コンポーネントのインスタンスIDをクリックし、監査証跡、プロセス・フロー、センサー値およびフォルトを表示します。

2. 「コンポーネント」列で、特定のサービス・コンポーネントをクリックし、そのホーム・ページにアクセスします。

3. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

4. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

詳細は、第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」を参照してください。

14.8 サービス・エンジンのデプロイ済BPELプロセス・サービス・コンポーネントの監視

サービス・エンジンで実行しているBPELプロセス・サービス・コンポーネントで構成されたすべてのデプロイ済SOAコンポジット・アプリケーションを監視できます。

サービス・エンジンにデプロイされたBPELプロセスを監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「BPEL」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「BPEL」の順に選択します。

2. 「デプロイ済コンポーネント」をクリックします。
「デプロイ済コンポーネント」ページに、次の詳細が表示されます。

- デプロイ済の特定のSOAコンポジット・アプリケーションを検索するためのユーティリティ。基準を指定して「検索」をクリックします。

- サービス・エンジンで実行しているBPELプロセス・サービス・コンポーネントで構成されたデプロイ済SOAコンポジット・アプリケーションの詳細。サービス・コンポーネント名、SOAコンポジット・アプリケーション、現在のステータス、サービス・エンジンにおける合計、実行中および失敗したインスタンスが表示されます。

3. 「名前」列で、特定のサービス・コンポーネントをクリックし、そのホーム・ページにアクセスします。

4. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

14.9 BPELプロセス・サービス・エンジンでのリクエストの所要時間に関する統計の表示

システムMBeanブラウザのいくつかのプロパティを使用して、処理中にリクエストが様々なサービス・エンジン・レイヤーで費やす時間に関する下位レベルの詳細を表示できます。

1. ナビゲーション・ツリーで「SOA」フォルダを開きます。

2. 「soa-infra」を右クリックして、「管理」→「システムMBeanブラウザ」の順に選択します。

3. 「アプリケーション定義のMBean」→「oracle.as.soainfra.bpel」→「サーバー: server_name」→「BPELEngine」→「BPELEngine」の順に選択します。
次のプロパティを構成できます。

- AsyncProcessStats:

- RequestStats:

- SyncProcessStats:

4. 「AsyncProcessStats」プロパティの内容を表示します。

5. 「RequestStats」プロパティの内容を表示します。

6. SyncProcessStatsプロパティの内容を表示します。

「BPELサービス・エンジン・プロパティ」ページの「StatsLastN」プロパティを使用してこの情報を構成する方法の詳細は、第13.1項「BPELプロセス・サービス・エンジン・プロパティの構成」を参照してください。

15 BPELプロセスのサービス・コンポーネントとエンジンの管理

この章では、BPELプロセス・サービス・コンポーネントとサービス・エンジンの管理方法(サービス・コンポーネントとサービス・エンジンのフォルトのリカバリ、サービス・コンポーネントのポリシーの管理、配信されていない起動メッセージとコールバック・メッセージについてのBPELプロセス・メッセージ・リカバリの実行、およびインスタンスとメッセージ・データのOracle Coherenceキャッシュへの格納を含む)について説明します。

この章では、次の項目について説明します。

- 第15.1項「BPELプロセス・サービス・コンポーネントのフォルトのリカバリ」

- 第15.2項「BPELプロセス・サービス・コンポーネントのポリシーの管理」

- 第15.3項「BPELプロセス・サービス・エンジンのフォルトのリカバリ」

- 第15.4項「BPELプロセス・サービス・エンジンのメッセージ・リカバリの実行」

- 第15.5項「Oracle Exalogicプラットフォームにおけるインスタンスとメッセージ・データのOracle Coherence分散キャッシュへの格納」

サービス・コンポーネントとサービス・エンジンの概念の詳細は、次の項を参照してください。

- 第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」

- 第1.2.6項「サービス・エンジンの概要」

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

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

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

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にあるパーティションを展開します。

2. 特定のSOAコンポジット・アプリケーションを選択します。

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

3. 「フォルト」をクリックします。
「フォルト」ページに、次の詳細が表示されます。

- 特定のフォルトを検索するためのユーティリティ。基準を指定して「検索」をクリックします。詳細は、「ヘルプ」アイコンをクリックしてください。デフォルトでは、このページに初めてアクセスしたときにはフォルトは表示されません。フォルトを表示するには、「検索」をクリックする必要があります。

- サービス・コンポーネントで発生したフォルト。フォルトID、エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、サービス・コンポーネントのインスタンスID、フォルトが発生したアクティビティ、およびフォルトが記述されているログ・ファイルへのリンクが表示されます。

リカバリが可能として識別されたBPELプロセス・サービス・コンポーネントのフォルトはリカバリできます。

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

対象

操作

単一フォルト・リカバリ

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

1. リカバリ可能として識別されたフォルトの行をクリックします。行が強調表示された状態で、ステップ6の説明に従って、「リカバリ・アクション」リストから特定のアクションを選択します。

2. 「リカバリ」列で「リカバリ」リンクをクリックし、インスタンス監査証跡の「フォルト」ページにアクセスしてフォルト・リカバリを実行します。

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

一括フォルト・リカバリ

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

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

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

3. ステップ6の説明に従って、「リカバリ・アクション」リストからアクションを選択します。
注意: 選択できるのは、選択したすべてのフォルトに適用可能なアクションのみです。

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

1. 「選択」メニューから、「すべてのリカバリ可能な値を選択」を選択します。

2. ステップ6の説明に従って、「リカバリ・アクション」リストからアクションを選択します。
注意: 選択できるのは、選択したすべてのフォルトに適用可能なアクションのみです。

注意:

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

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

アクション

説明

再試行

インスタンスを直接再試行します。このリカバリ・アクションを使用するシナリオ例は、ネットワーク・エラーのためにサービス・プロバイダにアクセスできないことが原因でフォルトが発生した場合の例です。ネットワーク・エラーは現在解決しています。

中断

インスタンス全体を終了します。

リプレイ

フォルトが発生したスコープ・アクティビティ全体を再度リプレイします。

再スロー

現在のフォルトを再スローします。フォルトの処理に、BPELフォルト・ハンドラ(catchブランチ)が使用されます。デフォルトでは、再スロー・フォルト・ポリシーが明示的に指定されていない場合、すべての例外がフォルト管理フレームワークによって捕捉されます。

続行

フォルトを無視して処理を続行します(フォルト・アクティビティには成功のマークが付けられます)。

6. 「フォルト」表内から次の追加監視タスクを実行します。

1. 「リカバリ可能なフォルトのみ表示」チェック・ボックスを選択すると、リカバリ可能なフォルトのみ表示されます。

2. 「フォルト・タイプ」リストから、すべてのフォルト、システム・フォルト、ビジネス・フォルトまたはOracle Web Services Manager (OWSM)フォルトを選択して、「フォルト」表に表示します。これらのフォルト・タイプの詳細は、「ヘルプ」アイコンをクリックしてください。

3. 「ビュー」リストから、「列」→「フォルトID」の順に選択し、各エラー・メッセージのフォルトIDを表示します。フォルトIDは自動的に生成され、フォルトを一意に識別します。フォルトIDは、エラー・メッセージをクリックしたときも表示されます。

4. 「コンポーネント・インスタンスID」列で、特定のサービス・コンポーネントIDをクリックし、インスタンスに関するタスク詳細(たとえば、タスクの現在の状態)にアクセスします。拒否メッセージにはコンポーネント・インスタンスIDがありません。

5. 「ログ」列で、リンクをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

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

- 第1.4.3.1項「フォルト・リカバリの概要」

- 第8.4.1項「BPELプロセスに対するフォルト・リカバリの例」

- 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』

- ログ・ファイルの表示および検索については、『Oracle Fusion Middleware管理者ガイド』を参照してください

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

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

注意:

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

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

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にあるパーティションを展開します。

2. 特定のSOAコンポジット・アプリケーションを選択します。

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

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

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

5. ポリシーのアタッチ先またはデタッチ先のサービスまたはコンポーネントを選択します。
ポリシーをアタッチまたはデタッチするためのダイアログが起動します。

「アタッチされたポリシー」セクションに、現在アタッチされているポリシーが表示されます。「使用可能なポリシー」セクションには、アタッチ可能な追加のポリシーが表示されます。

6. 使用環境に適したポリシーを選択してアタッチします。

7. 「アタッチ」をクリックします。

8. ポリシーのアタッチを終了した後は、「検証」をクリックします。

9. エラー・メッセージが表示された場合は、検証エラーがなくなるまで必要な修正を行います。

10. 「OK」をクリックします。
アタッチしたポリシーが「ポリシー」表に表示されます。

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

- 第1.4.3.2項「ポリシーの概要」

- ポリシーのアタッチで表示されるダイアログについては、第7.7項「SOAコンポジット・アプリケーションのポリシーの管理」を参照してください。

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

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

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

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

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「BPEL」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「BPEL」の順に選択します。

2. 「フォルト」をクリックします。
「フォルト」ページに、次の詳細が表示されます。

- 特定のフォルトを検索するためのユーティリティ。基準を指定して「検索」をクリックします。詳細は、「ヘルプ」アイコンをクリックしてください。デフォルトでは、このページに初めてアクセスしたときにはフォルトは表示されません。フォルトを表示するには、「検索」をクリックする必要があります。

- サービス・エンジンで発生したフォルト。フォルトID、エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、フォルトが発生したSOAコンポジット・アプリケーションとサービス・コンポーネント、およびサービス・コンポーネント・インスタンスIDが表示されます。

リカバリが可能として識別されたBPELプロセス・サービス・エンジンのフォルトはリカバリできます。

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

注意:

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

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

アクション

説明

再試行

再試行成功時アクションを指定するオプション付きでインスタンスを再試行します。このリカバリ・アクションを使用するシナリオ例は、ネットワーク・エラーのためにサービス・プロバイダにアクセスできないことが原因でフォルトが発生した場合の例です。ネットワーク・エラーは現在解決しています。

中断

インスタンス全体を終了します。

リプレイ

フォルトが発生したスコープ・アクティビティ全体を再度リプレイします。

再スロー

現在のフォルトを再スローします。フォルトの処理に、BPELフォルト・ハンドラ(catchブランチ)が使用されます。デフォルトでは、再スロー・フォルト・ポリシーが明示的に指定されていない場合、すべての例外がフォルト管理フレームワークによって捕捉されます。

続行

フォルトを無視して処理を続行します(フォルト・アクティビティには成功のマークが付けられます)。

5. 「フォルト」表内から次の追加監視タスクを実行します。

1. 「リカバリ可能なフォルトのみ表示」チェック・ボックスを選択すると、リカバリ可能なフォルトのみ表示されます。

2. 「フォルト・タイプ」リストから、すべてのフォルト、システム・フォルト、ビジネス・フォルトまたはOWSMフォルトを選択して、「フォルト」表に表示します。これらのフォルト・タイプの詳細は、「ヘルプ」アイコンをクリックしてください。

3. 「ビュー」リストから、「列」→「フォルトID」の順に選択し、各エラー・メッセージのフォルトIDを表示します。フォルトIDは自動的に生成され、フォルトを一意に識別します。フォルトIDは、エラー・メッセージをクリックしたときも表示されます。

4. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

5. 「コンポーネント」列で、特定のサービス・コンポーネントをクリックし、そのホーム・ページにアクセスします。

6. 「コンポーネント・インスタンスID」列で、特定のサービス・コンポーネントIDをクリックし、インスタンスに関するタスク詳細(たとえば、タスクの現在の状態)にアクセスします。拒否メッセージにはコンポーネント・インスタンスIDがありません。

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

- 第1.4.3.1項「フォルト・リカバリの概要」(フォルトの概念的な詳細情報)

- 第8.4.1項「BPELプロセスに対するフォルト・リカバリの例」

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

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

BPELプロセス・サービス・エンジンによる自動リカバリの試行に失敗したメッセージを管理することもできます。これらのメッセージの自動リカバリが複数回試行されないようにするには、これらのメッセージを消耗済状態にします。その後、これらのメッセージに対して次のいずれかのアクションを実行できます。

- 自動リカバリ・キューに戻す

- リカバリを試行しない

- リカバリを即時に試行する

たとえば、データベース・アダプタに書き込むBPELプロセスがあるとします。データベースがダウンしている場合、これらのメッセージはリカバリ・キューに送信されます。これらのメッセージの自動リカバリは、データベースがダウンしている間は失敗します。これらのメッセージには、自動リカバリが再び試行されないように消耗済状態のマークが付けられます。データベースの実行が再び開始されたら、自動リカバリが再び試行されるように、これらのメッセージをリセットする(自動リカバリ・キューに戻す)ことができます。

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

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「BPEL」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「BPEL」の順に選択します。

2. 「リカバリ」をクリックします。
「リカバリ」ページに、次の詳細が表示されます。

- 「アラーム表のリフレッシュ」ボタンは、データベース内の消失したインメモリー・クォーツ・スケジュール済ジョブを再同期化する場合に選択します。たとえば、waitアクティビティ、またはpickアクティビティのonAlarmブランチでタイマーが起動され、そのトランザクションがロールバックされたと仮定します。データベースのwaitアクティビティまたはonAlarmブランチにあるBPELインスタンスを使用して、これらのジョブを再同期化できます。

- 特定のメッセージの失敗を検索するためのユーティリティ。基準を指定して「検索」をクリックします。詳細は、「ヘルプ」アイコンをクリックしてください。
「ECID」フィールドに実行コンテキストID (ECID)値を入力できます。ECID値を使用すると、様々なコンポジット・アプリケーションのインスタンス間のメッセージ・フローを追跡できます。リカバリが必要なBPELプロセス・メッセージがあり、システムMBeanブラウザのAuditConfigプロパティが「すべて」 (デフォルト値)に設定されている場合は、「フローのトレース」ページの「トレース」表に次の警告メッセージが表示されます。

BPEL Message Recovery Required

「詳細表示」またはこのメッセージの横に表示されるリカバリ・アイコンをクリックすると、「警告」ダイアログがリカバリ可能メッセージ・タイプ(起動、コールバックおよびアクティビティ)の数およびECID値に関する情報とともに表示されます。「リカバリ」ページで検索基準を作成する一環として、「警告」ダイアログからECID値をコピーして「ECID」フィールドに貼り付け、リカバリ可能メッセージ・タイプを「タイプ」リストから選択できます。

詳細は、第14.1項「BPELプロセス・サービス・コンポーネントの監査証跡とプロセス・フローの監視」を参照してください。

注意:

特定のECID値のメッセージを検索する際のSQL問合せのパフォーマンスを向上させるために、DLV_MESSAGE表のDLV_MESSAGE.ECID列に索引を追加することをお薦めします。これは、DLV_MESSAGE表のエントリが多すぎる場合、検索の問合せが遅くなり、データベースに過大な負荷をかける可能性があるためです。索引の追加の詳細は、『Oracle Database管理者ガイド』の「索引の作成」を参照してください。

- サービス・エンジンでのメッセージの失敗。対話ID、メッセージの失敗のリカバリが可能かどうか、サービス・コンポーネント、失敗が発生したコンポジット・アプリケーション、およびフォルトの発生時間が表示されます。状態に応じて、これらのメッセージをただちにリカバリするか、これらのメッセージを取り消すか、または自動リカバリのためにこれらのメッセージをリセットできます。

注意:

- 解決済状態および未配信状態のコールバック・メッセージをリカバリできます。「タイプ」リストから「コールバック」を選択し、「メッセージの状態」リストから「解決」または「未配信」のいずれかを選択して検索条件を実行すると、これらのメッセージがリカバリ用に表示されます。コールバック・メッセージが最初にBPELプロセス・サービス・エンジンに入るとき、その状態は未配信状態です。対話IDのマッチングまたは相関のいずれかによって、このメッセージがターゲットBPELプロセス・インスタンスに解決されると、状態は解決済に切り替えられます。これらの両方の状態では、メッセージはまだ消費されていません。これらの2つの状態のメッセージはリカバリできます(消費のためにBPELプロセス・サービス・エンジンに再配信される)。他の状況では、コールバック・メッセージがこれらの両方の状態で残されている場合があります。これらの状態のメッセージもリカバリできます。ただし、残されているコールバック・メッセージが常に未配信状態のまま保たれる保証はありません。

- 「タイプ」リストから「呼出し」を選択し、「メッセージの状態」リストから「未配信」を選択して「リカバリ」をクリックすると、リカバリが実行されます。ただし、Oracle BPEL Process Managerサービス・コンポーネントまたはサービス・エンジンの「ダッシュボード」ページでは、このインスタンスの「最終更新日時」列は空のままになります。これは予想された動作です。最終更新日時が表示されないのは、Oracle BPEL Process Managerの最初のインスタンス(たとえばbpel:70004)が、最初の呼出しによって作成されるためです(つまり、作成されるがまだ変更されていない)。未配信の呼出しメッセージをリカバリすると、常に新しいインスタンス(たとえばbpel:70005)が作成されます。以前作成されたインスタンス(bpel:70004)は使用されず、永続的に同じステータスのまま(「最終更新日時」列が空のまま)になります。この情報は監査目的でのみ提供されます。

- 「メッセージの状態」リストはコールバック・メッセージおよび起動メッセージのタイプのリカバリにのみ適用され、アクティビティ・メッセージのタイプのリカバリには適用されません。

3. この表でフォルトを選択します。

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

アクション

説明

リカバリ

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

消耗済状態のメッセージを選択してこのボタンをクリックすると、メッセージのリカバリが即時に試行されます。このリカバリの試行も失敗となった場合、メッセージは消耗済状態に戻ります。メッセージを選択して「リセット」をクリックし、そのメッセージを自動リカバリ・キューに戻す必要があります。

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

中断

取消としてマークされているメッセージが含まれるフロー全体を終了できる確認メッセージを表示して、コンポジット・インスタンスの状態を更新する場合に選択します。メッセージ取消は、ECIDのコンテキストで実行されます。このECIDを使用して複数のコンポジット・インスタンスがリンクされている場合は、すべてのコンポジットおよびサービス・コンポーネントのインスタンスが終了します。ECIDを使用すると、様々なコンポジット・アプリケーションのインスタンスを横断するメッセージ・フローを追跡できます。

消耗済状態のメッセージを選択してこのボタンをクリックすると、そのメッセージのリカバリは試行されなくなります。

リセット

消耗済メッセージを未配信状態にリセットする場合に選択します。これにより、メッセージは自動リカバリ・キューに戻されます。消耗済状態で表示されたメッセージは、メッセージ表に表示されなくなります。「メッセージの状態」リストで「未配信」を選択して「検索」をクリックすると、これらのメッセージが表示されます。消耗済状態のコールバック・メッセージを解決状態にリセットし、引き続きリカバリ可能にすることもできます。

中断せずに取消

選択したBPELプロセス・メッセージの配信を取り消しますが、そのメッセージが含まれるコンポジット・インスタンス・フロー全体は取り消さない場合に選択します。BPELプロセス・メッセージを取り消しても、対応するコンポジット・インスタンスの状態は変更されません。このオプションを使用するアプリケーションは限定され、たとえば同じコールバックで受信した重複メッセージを削除する場合などに使用します。消耗済状態のメッセージを選択してこのボタンをクリックすると、そのメッセージのリカバリは試行されなくなります。

注意: 「リカバリ」ボタンと「中断せずに取消」ボタンは、次の場合に有効になります。

- ユーザーが管理者ロールまたはオペレータ・ロールを持つ場合。監視ロールを持つユーザーに対しては、これらのボタンは無効になります。

- リカバリ可能なメッセージの場合。リカバリ可能なメッセージを選択すると、これらのボタンが有効になります。

ロールの詳細は、付録C「ロールおよび権限」を参照してください。

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

注意:

ora-retryアクションを使用してBPELプロセスにフォルト・ポリシーを定義した場合は、フォルトが発生すると、BPELプロセスではフォルトからのリカバリをretryCountパラメータに指定した回数試行します。この期間の後、プロセスは実行中の状態のままになります。完了していないプロセスのアクティビティ(呼出し、受信など)のステータスは、保留中の手動リカバリとして表示されます。これは予想された動作です。

起動メッセージおよびコールバック・メッセージのリカバリを試行する最大回数を構成する方法の詳細は、第13.4項「起動メッセージおよびコールバック・メッセージの自動リカバリ試行の構成」を参照してください。

15.5 Oracle Exalogicプラットフォームにおけるインスタンスとメッセージ・データのOracle Coherence分散キャッシュへの格納

BPELプロセスを使用すると、各インスタンスで必要なデータベースの相互作用の回数によって、パフォーマンスの問題が発生する可能性があります。この要因が、非同期の永続フローよりも同期の一時フローのパフォーマンスが優れている主な原因になっています。この問題に対応するために、レスポンス時間の短縮が必要な状況では同期の一時フローを利用するように設計できます。ただし、ビジネス上の理由で、このタイプのフローを設計できない場合があります。

Oracle ExalogicプラットフォームでOracle SOA Suite 11g リリース1 (11.1.1.6)以降を実行している場合は、Oracle Coherenceの分散キャッシュ機能を使用して、BPELプロセスからインスタンスとメッセージ・データを格納できます。これによってデータベースの読取り回数が減るため、データベースの相互作用の回数が減ります。

Oracle Coherenceは、頻繁に使用されるデータへのアクセスを提供することによって、企業がミッションクリティカルなアプリケーションを拡張することを可能にするOracle Fusion Middlewareのコンポーネントです。Oracle Coherenceに含まれる分散キャッシュ機能によって、読取りアクセスと書込みアクセスの両方のスケーラビリティが向上します。データはノード間で自動的、動的および透過的にパーティション化されます。分散アルゴリズムがネットワーク・トラフィックを最小化し、データが徐々に移動されることでサービスの停止が回避されます。

Oracle Exalogicは、幅広いアプリケーション・タイプと様々なワークロードに対応するプラットフォームを提供するように設計された、ハードウェアとソフトウェアの統合システムです。Oracle Exalogicは、大規模で、パフォーマンスの影響を受けやすく、ミッションクリティカルなアプリケーションのデプロイを対象にしています。

注意:

使用している環境でOracle Exalogicを使用していない場合、Oracle Coherenceの分散キャッシュは使用できません。

BPELプロセスに対して分散キャッシュを使用すると、次のようなパフォーマンスの向上を期待できます。

- メッセージ(起動およびコールバック)が最初に配信された後に、データベースからそのメッセージを読み取る操作がなくなります。

- デハイドレーション・ポイントの後にキューブ・インスタンスに必要な読取り操作がなくなります。

Oracle Coherenceの詳細は、Oracle Coherenceスタート・ガイドおよびOracle Coherence開発者ガイドを参照してください。

Oracle Exalogicの詳細は、Oracle Exalogicマシン所有者ガイドを参照してください。

15.5.1 Oracle Coherenceのキャッシュ機能アーキテクチャの概要

デハイドレーション時に、インスタンス・オブジェクトは、コンテナ管理のEnterprise JavaBeans (EJB)トランザクションでJava永続性API (JPA)を使用してデータベースに格納されます。BPELプロセス・サービス・エンジンでは、トランザクション後の処理用にトランザクションのafterCompletionリスナーを登録します。トランザクション中に変更されたインスタンス・オブジェクトは、追跡されてafterCompletionリスナーに対して使用可能になり、このリスナーによってキャッシュが更新されます。図15-1に、デハイドレーション・プロセスの詳細を示します。

図15-1 デハイドレーション・プロセス

リハイドレーション時に、インスタンス・オブジェクトはキャッシュから読み取られます。実装では、トランザクション完了通知のXA保証は提供されず、キャッシュの削除によってオブジェクトがキャッシュから削除されます。実装では、これら2つの事項を考慮して、オブジェクトが返されない、または古いバージョンのオブジェクトが返されるというキャッシュの問題に対処します。

通常は、キャッシュの参照によって有効なオブジェクトが返されます。この場合、直接書込み(デフォルト)によるキャッシュの使用によって、デハイドレーションおよびリハイドレーションのパフォーマンスは次に示すように向上します。

(database read time + relational to object mapping) minus (Object serialization +
reading from serialized form + Coherence network overhead + query to
database for reading CACHE_VERSION)

また、データベース・サーバーでのアクティビティも減少します。

ネットワーク障害によってOracle Coherenceのキャッシュが使用できない場合でも、BPELプロセス・サービス・エンジンは稼働し続けます。エラーが発生しない場合、ビジネス・プロセス・インスタンスは処理を続行します。

15.5.2 デフォルトのSOAクラスタ・ノードおよびCoherenceキャッシュ・グリッド・ノードでの実行

BPELプロセス・キャッシュは、Oracle SOA Suiteクラスタ・ノードに作成されません。第15.5.7項「BPELプロセス・キャッシュ・サーバーの起動」の説明に従って、BPELキャッシュをホストするBPELキャッシュ・サーバーを起動する必要があります。パフォーマンスを向上させるには、最低4台のサーバーを起動してください。Oracle SOA SuiteクラスタとBPELキャッシュ・サーバーの順番に要件はありません。Oracle Enterprise Manager Fusion Middleware ControlでQualityOfServiceプロパティがCacheEnabledに設定されている場合でも、BPELプロセス・サービス・エンジンはBPELキャッシュ・サーバーがなくても稼働し続けます。

Oracle Coherenceの詳細は、Oracle Coherenceスタート・ガイドおよびOracle Coherence開発者ガイドを参照してください。

15.5.3 Oracle Coherenceのキャッシュ機能の構成

システムMBeanブラウザのQualityOfServiceプロパティを使用して、Oracle Coherenceをデハイドレーション用に構成できます。このプロパティは、SOAクラスタ内のいずれかのノードで構成できます。

Oracle Coherenceキャッシングをデハイドレーション用に構成する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「SOA管理」→「BPELプロパティ」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「SOA管理」→「BPELプロパティ」の順に選択します。

「BPELサービス・エンジン・プロパティ」が表示されます。

2. 「詳細BPEL構成プロパティ」をクリックします。

3. 「属性」タブで、「QualityOfService」をクリックします。

4. 「値」フィールドに、環境に適した値を入力します。この変更によってSOAインフラストラクチャを再起動する必要はありません。

表15-1 QualityOfServiceの値

値

説明

DirectWrite

デハイドレーションおよびリハイドレーションでキャッシュを使用しません。読取りおよび書込み操作はデータベースに対して行われます。これがデフォルトの設定です。

CacheEnabled

デハイドレーション時は、インスタンス・データがXAデータ・ソース接続を使用してデータベースに格納され、トランザクション後の処理でオブジェクトがキャッシュに挿入されます。

リハイドレーション時は、データがキャッシュからフェッチされます。データが見つからない場合(たとえば、BPELプロセス・キャッシュ・サーバーが使用できない場合)、またはバージョンが失効している場合、データはデータベースから読み取られます。

5. 「適用」をクリックします。

15.5.4 複数の監査証跡メッセージの単一トランザクションへの格納の構成

非同期フローの場合、複数の監査証跡メッセージを単一トランザクションに格納すると、パフォーマンスが向上します。パフォーマンスを向上させるために(複数のインスタンスの)複数の監査証跡メッセージを単一トランザクションに格納するには、Oracle Enterprise Manager Fusion Middleware ControlでシステムMBeanブラウザのAsynchAuditBatchSizeプロパティを設定します。

このプロパティを適切な値に設定すると、監査証跡トランザクション・コミット数が減ります。かわりに、指定した制限に達した場合のみコミットが実行されます。

複数の監査証跡メッセージが単一トランザクションに格納されるように構成する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「SOA管理」→「BPELプロパティ」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「SOA管理」→「BPELプロパティ」の順に選択します。

「BPELサービス・エンジン・プロパティ」が表示されます。

2. 「詳細BPEL構成プロパティ」をクリックします。

3. 「属性」タブで、「AsynchAuditBatchSize」をクリックします。

4. 「値」フィールドに、環境に適した値を入力します。デフォルト値の-1は、バッチ対象の監査証跡メッセージがないことを示します。各監査メッセージは、それぞれのトランザクションに保持されます。
推奨される値の範囲は5から25です。たとえば、このプロパティを8に設定した場合、8つの監査証跡メッセージが蓄積されると、これらのメッセージに対して1つのトランザクションが作成され、デハイドレーション・ストアにコミットされます。

このパラメータは、Oracle Exalogic環境にのみ影響します。その他の環境では使用できません。

この変更によってSOAインフラストラクチャを再起動する必要はありません。

5. 「適用」をクリックします。

15.5.5 Oracle Coherenceキャッシュへの監査証跡の格納の構成

Oracle Coherenceキャッシュに監査証跡を格納できます。これを行うには、Oracle Enterprise Manager Fusion Middleware ControlでシステムMBeanブラウザの次のプロパティをそれぞれの値に設定します。

- 「AuditStorePolicy」をasyncに設定します。

- 「QualityOfService.AuditStorePolicy.UseDistributedCache」をtrueに設定します。

- 「QualityOfService」をCacheEnabledに設定します。手順の詳細は、第15.5.3項「Oracle Coherenceのキャッシュ機能の構成」を参照してください。

これらの設定によって、次の動作が可能になります。

- Oracle Coherenceキャッシュがキューとして動作して、データベースに監査証跡を書き込みます。

- SOAサーバー・ノードのヒープとスレッドは、監査証跡を処理しません。

これらのプロパティのいずれかが異なる値に設定されていると、ヒープおよびディスパッチャ・スレッドがデータベースへの書込みに使用されます。

Oracle Coherenceキャッシュへの監査証跡の格納を構成する手順は次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「SOA管理」→「BPELプロパティ」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「SOA管理」→「BPELプロパティ」の順に選択します。

「BPELサービス・エンジン・プロパティ」が表示されます。

2. 「詳細BPEL構成プロパティ」をクリックします。

3. 「属性」タブで、「AuditStorePolicy」をクリックします。

4. 「値」フィールドに、asyncと入力します。

注意:

サーバーがキャッシュする場合は(SOA/BPELキャッシュ・サーバー)、一部の監査証跡メッセージはデータベースに永続化されません。この結果、監査ログが失われることになります。フェイルオーバーはサポートされません。これはOracle Coherenceの場合とメモリーまたはヒープ・キャッシュの場合の両方に適用されます。

5. 「適用」をクリックします。

6. 「戻る」をクリックします。

7. 「属性」タブで、「QualityOfService.AuditStorePolicy.UseDistributedCache」をクリックします。

8. 「値」リストから「True」を選択します。

9. 「適用」をクリックします。

15.5.6 Oracle Coherenceキャッシュへの呼出しメッセージの格納の構成

Oracle Enterprise Manager Fusion Middleware ControlでシステムMBeanブラウザの次のプロパティをそれぞれの値に設定することで、Oracle Coherenceキャッシュに呼出しメッセージを格納できます。

- 「OneWayDeliveryPolicy」をasync.cacheに設定します。

- 「QualityOfServiceOneWayDeliveryPolicyUseDistributedCache」をtrueに設定します。

- 「QualityOfService」をCacheEnabledに設定します。手順の詳細は、第15.5.3項「Oracle Coherenceのキャッシュ機能の構成」を参照してください。

これらのプロパティのいずれかが異なる値に設定されていると、Oracle Coherenceキャッシュではなく、ローカル・メモリーがキャッシュに使用されます。

注意:

サーバー(SOAおよびBPELプロセス・キャッシュ・サーバーの両方)のクラッシュ時に実行中の呼出しメッセージは損失または複製される可能性があります。フェイルオーバーはサポートされません。これはOracle Coherenceの場合とメモリーまたはヒープ・キャッシュの場合の両方に適用されます。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「SOA管理」→「BPELプロパティ」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「SOA管理」→「BPELプロパティ」の順に選択します。

「BPELサービス・エンジン・プロパティ」が表示されます。

2. 「詳細BPEL構成プロパティ」をクリックします。

3. 「属性」タブで、「OneWayDeliveryPolicy」をクリックします。

4. 「値」フィールドに、async.cacheと入力します。

5. 「適用」をクリックします。

6. 「戻る」をクリックします。

7. 「属性」タブで、「QualityOfServiceOneWayDeliveryPolicyUseDistributedCache」をクリックします。

8. 「値」リストから「True」を選択します。

9. 「適用」をクリックします。

15.5.7 BPELプロセス・キャッシュ・サーバーの起動

start-bpel-cache.shスクリプトを実行して、Oracle SOA SuiteがインストールされているUNIXマシン上でBPELプロセス・キャッシュ・サーバーを起動します。

要件はネットワーク接続性のみです。Oracle SOA Suiteノードには、BPELプロセス・キャッシュ・サーバーがインストールされているホストからアクセスできる必要があります。

このスクリプトによって、Oracle SOA Suiteクラスタがマルチキャストのデフォルトのアドレスとポートに結合されます。これらの値は、$FMW_HOME/user_projects/domains/domain_name/bin/setDomainEnv.shファイルの対応する値と一致します。

クラスタに対してマルチキャストを選択したが、別のアドレスとポートを使用する場合は、環境変数を使用するか、またはshell変数を設定して、bpelCacheEnv.shファイル内の値をオーバーライドできます。同じ値をSOA管理対象サーバーに対して使用します(setDomainEnv.sh内)。

Oracle SOA Suiteクラスタのデフォルトのキャッシュ構成は、マルチキャストではなくユニキャストである必要があります。Oracle CoherenceのOracle SOA Suiteクラスタに対して推奨されるキャッシュ構成の詳細は、『Oracle Fusion Middleware高可用性ガイド』または『Oracle Fusion Middleware Oracle SOA Suiteエンタープライズ・デプロイメント・ガイド』を参照してください。

BPELプロセス・キャッシュ・サーバーを起動する手順は、次のとおりです。

1. $FMW_HOME/SOA_ORACLE_HOME/binディレクトリに移動します。

2. start-bpel-cache.shファイルを開きます。

3. start-bpel-cache.shファイル内の指示に従って、bpelCacheEnv.shファイルを作成し、各種の環境変数を構成します。
環境変数またはshell変数の名前と値の書式については、start-bpel-cache.shファイルの最初のノート・セクションで説明されています。

4. 第15.5.3項「Oracle Coherenceのキャッシュ機能の構成」で説明したように、最初にOracle Enterprise Manager Fusion Middleware ControlでQualityOfServiceプロパティをCacheEnabledに設定していることを確認します。

5. 次のスクリプトを実行します。

start-bpel-cache.sh

第VI部

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

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

次の章で構成されています。

- 第16章「Oracle Mediatorのサービス・コンポーネントとエンジンの構成」

- 第17章「Oracle Mediatorのサービス・コンポーネントとエンジンの監視」

- 第18章「Oracle Mediatorのサービス・コンポーネントとエンジンの管理」

- 第19章「相互参照の管理」

16 Oracle Mediatorのサービス・コンポーネントとエンジンの構成

この章では、Oracle Enterprise Manager Fusion Middleware Controlを使用してOracle Mediatorサービス・コンポーネントとサービス・エンジンのランタイム・プロパティを構成する方法について説明します。また、メディエータの拡張プロパティおよびカスタム・プロパティも構成できます。

この章では、次の項目について説明します。

- 第16.1項「Oracle Mediatorサービス・エンジン・プロパティの構成」

- 第16.2項「リシーケンスされたメッセージの構成」

Oracleメディエータのチューニングとパフォーマンス・プロパティの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』を参照してください。

16.1 Oracle Mediatorサービス・エンジン・プロパティの構成

メディエータ・サービス・エンジン・プロパティは、メディエータ・サービス・コンポーネントの処理時にメディエータ・サービス・エンジンによって使用されます。

メディエータ・サービス・エンジン・プロパティを構成する手順は、次のとおりです。

1. 「メディエータ・サービス・エンジン・プロパティ」ページに、次のいずれかの方法を使用してアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「SOA管理」→「メディエータ・プロパティ」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「SOA管理」→「メディエータ・プロパティ」の順に選択します。

次の図に示されているように、「メディエータ・サービス・エンジン・プロパティ」ページにメディエータ・プロパティのリストが表示されます。

2. 使用環境に適するようにサービス・エンジン・プロパティを変更します。
プロパティについて次の表16-1で説明します。

表16-1 メディエータ・サービス・エンジンのプロパティ

プロパティ

説明

監査レベル

メディエータ固有の監査レベル。グローバルなSOAインフラストラクチャの監査レベル・プロパティは、このプロパティの値によってオーバーライドされます。このプロパティの可能な値は、次のとおりです。

- オフ: メディエータの監査をオフにします。コンポジット・インスタンスのトラッキング情報とペイロード・トラッキング情報は収集されません。

- 継承: 監査のレベルは、SOAインフラストラクチャと同じになります。この設定を使用すると、グローバル設定が変更されたときに、メディエータ監査レベルも自動的に変更できます。このページで別の監査レベル・トラッキングを設定すると、SOAインフラストラクチャ・レベルで設定したトラッキングがオーバーライドされます。

- Production: すべてのイベントが記録されます。すべての監査詳細が、assignアクティビティの詳細を除いて記録されます。インスタンス・トラッキング情報は収集されますが、ペイロード詳細はキャプチャされないため、これらの詳細はフローの監査証跡で使用できません。このレベルは、通常の操作とテストに最適です。

- Development: すべてのイベントとすべての監査詳細が記録されます。さらに、ペイロード詳細がキャプチャされるため、フローの監査証跡で使用できます。このレベルは、デバッグする際に便利ですが、パフォーマンスに影響を与える可能性があります。

このフラグのデフォルト値は、Inheritです。

注意:

- これらのプロパティの変更後に、サーバーを再起動する必要はありません。

- 監査レベルは、Oracle Application Server 10g リリースではインスタンス・トラッキング・レベルと呼ばれていました。

レベル・メトリック

ダイナミック・モニタリング・サービス(DMS)のメトリック・レベルを構成するための、メディエータ固有のプロパティ。DMSメトリックは、アプリケーション・コンポーネントのパフォーマンスを測定するために使用されます。このプロパティの可能な値は、次のとおりです。

- Enabled: DMSメトリック・トラッキングを有効にします。

- Disabled: DMSメトリック・トラッキングを無効にします。

パラレル・ワーカー・スレッド

メッセージ処理のパラレル・ディスパッチャ数。パラレル処理のアウトバウンド・スレッド数を増加させるには、このパラメータの値を増やします。

パラレルが取得する最大行数

パラレル処理で繰返しごとに取得する行数。このパラメータの値は、メモリー消費量の制限に応じて、Parallel Worker Threadsプロパティの50から100倍に設定できます。

注意: このプロパティの値が大きいと、メモリー不足になる可能性があります。

パラレル・ロッカー・スレッド・スリープ(秒)

パラレル処理に関するメッセージがない場合の、行を取得するための連続した2つの繰返し間でのアイドル時間。この時間は秒単位で測定されます。

エラー・ロッカー・スレッド・スリープ(秒)

パラレル処理でエラーになったメッセージがない場合の、エラーになったメッセージを取得するための連続した2つの繰返し間でのアイドル時間。時間は秒単位で測定されます。このプロパティを設定することによって、エラー/リトライ・インフラストラクチャを構成できます。

パラメータ

カスタム構成プロパティ。例として、第16.2項「リシーケンスされたメッセージの構成」を参照してください。

コンテナIDリフレッシュ時間

コンテナIDリース・タイムアウト

ハートビート・インフラストラクチャ・プロパティ。メディエータ・サービス・エンジンの一部であるハートビート・インフラストラクチャは、ノードの失敗または停止が原因でメディエータ・サービス・エンジン・インスタンスが存在しないことを検出します。ハートビート・インフラストラクチャは、メディエータ・サービス・エンジンの各インスタンスに対して一意の識別子を作成し、メディエータ・サービス・エンジンが失敗した場合に、必要なハウスキーピング・タスクを実行します。ハートビート・インフラストラクチャは、ハートビート・スレッドで構成されています。このハートビート・スレッドは、各メディエータ・サービス・エンジンの一意の識別子に関連付けられているタイムスタンプを定期的に更新します。メディエータ・サービス・エンジンは、関連付けられているタイムスタンプを更新することで、その存在を他のメディエータ・サービス・エンジンに知らせます。ハートビート・スレッドは、特定の期間に更新されなかった一意の識別子が存在するかどうかも確認します。ハートビート・フレームワークは、次のパラメータを設定することで構成できます。

- コンテナIDリフレッシュ時間: 各メディエータ・サービス・エンジンの一意の識別子に関連付けられているタイムスタンプを、ハートビート・スレッドが定期的に更新する時間間隔。
注意: デフォルト値は60秒です。計画外停止が発生した場合は、サーバーの再起動後に、このプロパティで指定された時間だけ待機する必要があります。

より頻繁にリフレッシュする必要がある場合は、より小さな値(30秒など)にこのパラメータを設定できます。

- コンテナIDリース・タイムアウト(秒): 特定の期間に更新されていない一意の識別子が存在するかどうかを、ハートビート・スレッドが定期的に確認する時間間隔。ここで指定された時間より長い期間ノードがリフレッシュしない場合、ノードはタイムアウトしたとみなされます。
注意: デフォルト値は300秒です。SQL文の実行が低速であるなどの理由からノードがタイムアウトしている場合は、より大きな値(600秒など)にこのパラメータを設定できます。

これらのパラメータを構成することで、メディエータ・サービス・エンジンの失敗を検出するためにハートビート・スレッドが使用する期間を指定できます。

リシーケンサ・ロッカー・スレッド・スリープ(秒)

ロッカー・スレッドのスリープ間隔(秒単位)。処理可能なメッセージを持つグループをリシーケンサが見つけられない場合は、ロッカー・スレッドは指定された期間スリープします。処理可能なメッセージを持つグループが見つかった場合は、データベース・シークの各繰返しの間ロッカー・スレッドはスリープしません。デフォルト値は10です。

リシーケンサがロックする最大グループ数

データベース・シークの各繰返しで処理用に取得するグループの数。取得されたグループは、処理のために ワーカー・スレッドに割り当てられます。デフォルト値は4です。

リシーケンサ・ワーカー・スレッド

リシーケンス・グループを並行処理するためのワーカー・スレッド(ディスパッチャ)の数。各ワーカー・スレッドにグループが割り当てられて、そのグループのメッセージが順番に処理されます。多数のグループがメッセージの処理を待機している場合は、このパラメータを増加することでパフォーマンスを改善できます。デフォルト値は4です。

3. システムMBeanブラウザで詳細なメディエータ・プロパティを構成するには、「詳細メディエータ構成プロパティ」をクリックしてください。

次に説明するように、システムMBeanブラウザのメディエータ・プロパティには、ナビゲータからもアクセスできます。

システムMBeanブラウザのプロパティにアクセスする手順は、次のとおりです。

1. 「SOAインフラストラクチャ」メニューから、「管理」→「システムMBeanブラウザ」の順に移動します。
「システムMBeanブラウザ」ページが表示されます。

2. 左側の「システムMBeanブラウザ」ナビゲーション・ペインで、「oracle.as.soainfra.config」→「サーバー: server_name」→「MediatorConfig」→「mediator」の順に選択します。
MBeanのプロパティが右側のペインに表示されます。

3. プロパティの値を変更するには、その「値」フィールドを変更して「適用」をクリックします。

注意:

すべての値を変更できるわけではありません。システムMBeanプロパティは一般的に表16-1にリストされているプロパティに対応しますが、MBeanには追加の読取り専用プロパティがあります。追加プロパティのContainerInitRetriesは表16-1にリストされていません。このプロパティは、Oracle Mediatorサービス・エンジン・インスタンスIDを作成するために行われる試行の数を示します。

16.2 リシーケンスされたメッセージの構成

メディエータ・サービス・コンポーネントでメッセージをリシーケンスするには、次の項目を構成する必要があります。

- ワーカー・スレッド数

- スレッドでロックできる最大グループ数

- スリープ間隔

メディエータ・サービス・コンポーネントがベスト・エフォート・リシーケンスを使用するように構成されており、各バッチで処理されるメッセージが最大行数ではなく時間ウィンドウに基づいている場合は、バッファ・ウィンドウも構成できます。

リシーケンスされたメッセージを構成する手順は、次のとおりです。

1. 第16.1項「Oracle Mediatorサービス・エンジン・プロパティの構成」で説明されている、いずれかの方法を使用して、「メディエータ・サービス・エンジン・プロパティ」ページまたはシステムMBeanブラウザにアクセスします。

2. 次のメディエータ・プロパティに値を入力します。

- リシーケンサ・ワーカー・スレッド: リシーケンサによって使用されるスレッドの数。

- リシーケンサがロックする最大グループ数: ロック・サイクルごとに取得される最大グループ行数。

- リシーケンサ・ロッカー・スレッド・スリープ: データベースにメッセージがない場合にリシーケンサ・ロッカーがスリープする時間の長さ(秒)。

注意:

これらのプロパティの詳細は、表16-1を参照してください。

3. ベスト・エフォート・リシーケンスでの時間ウィンドウのバッファ・ウィンドウを構成するには、「パラメータ」プロパティ値に次のように入力します。

buffer.window=x

xは、バッファに追加する構成済時間ウィンドウの割合です。たとえば、buffer.window=20は、時間ウィンドウの長さの20%をバッファとして追加することを意味します。

4. 「適用」をクリックします。

17 Oracle Mediatorのサービス・コンポーネントとエンジンの監視

この章では、Oracle Enterprise Manager Fusion Middleware Controlを使用してOracle Mediatorサービス・コンポーネントとサービス・エンジンのランタイム・インスタンス情報、コンポーネントの状態およびフォルトを監視する方法について説明します。

この章では、次の項目について説明します。

- 第17.1項「Oracle Mediatorの「ダッシュボード」ページの概要」

- 第17.2項「Oracle Mediatorサービス・コンポーネントのインスタンスとフォルトの監視」

- 第17.3項「Oracle Mediatorサービス・エンジンのインスタンスとフォルトの監視」

- 第17.4項「リシーケンスされたメッセージの監視」

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

- 第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」

- 第1.2.6項「サービス・エンジンの概要」

Oracle Enterprise Manager Fusion Middleware Controlを使用したメディエータ・コンポーネントのモニタリングに加え、処理を停止したもののまだメッセージを保留中のリシーケンス・グループの監視と通知を設定することもできます。この情報を使用して診断ダンプを実行することもできます。詳細は、第12章「SOAコンポジット・アプリケーションに関する問題の診断」を参照してください。

17.1 Oracle Mediatorの「ダッシュボード」ページの概要

メディエータ・コンポーネント・ダッシュボードでは、選択したメディエータ・サービス・コンポーネントの現在の状態に関する情報を表示して、失敗したインスタンスとメッセージを管理できます。メディエータ・エンジン・ダッシュボードでは、メディエータ・サービス・エンジン上で実行されるすべてのメディエータ・サービス・コンポーネントについて、同じ情報を表示できます。

ダッシュボードの各セクションには、環境のステータスの監視に役立つ詳細情報へのリンクが含まれています。次の項では、「ダッシュボード」ページの異なるセクションに表示されるインスタンス情報について説明します。

注意:

メッセージのリシーケンスを使用するメディエータ・サービス・コンポーネントのインスタンスを表示すると、タブ付きページの一部に追加フィールドが表示されます。これらのフィールドはリシーケンス・グループに関する追加情報を提供します。

17.1.1 「最新のインスタンス」セクション

この項では、最新のメディエータ・インスタンスについて表示できる情報のタイプを説明します。すべてのインスタンスを表示するか、実行中のインスタンスのみを表示するかを選択できます。

- インスタンスID: 特定のメディエータ・インスタンスの一意のID。

- コンポーネント: インスタンスが開始されたメディエータ・サービス・コンポーネントの名前(メディエータ・エンジン・ダッシュボードのみ)。

- コンポジット: インスタンスが開始されたコンポジット・アプリケーションの名前(メディエータ・エンジン・ダッシュボードのみ)。

- 状態: 特定のメディエータ・インスタンスの状態。可能な状態は、次のとおりです。

- 失効: このメディエータ・インスタンスが作成されたコンポジットがアンデプロイされています。

- ユーザーによって終了されました: このインスタンスは、Oracle Enterprise Manager Fusion Middleware Controlを使用して手動で、またはフォルト・ポリシーによって自動的に終了されました。

- 失敗: インスタンスは失敗したためリカバリできません。

- 正常に完了しました: このインスタンスはすべてに問題がなく、正常に実行されました。

- リカバリが必要です: インスタンスは失敗しましたが、Oracle Enterprise Manager Fusion Middleware Controlを使用して手動でリカバリできます。
フォルトのリカバリの詳細は、第18.3項「Oracle Mediatorサービス・エンジンのフォルトのリカバリ」を参照してください。

- 実行中: メディエータ・インスタンスの1つ以上のルーティング・ルールが実行中です。

- 開始日: メディエータ・インスタンスが起動された日付。

- 最終更新日時: メディエータ・インスタンスが最後に更新された日付。

- ソース: メディエータ・インスタンスをトリガーした操作またはイベント。

- ログ: メディエータ・インスタンスに関連するログ・メッセージが含まれるログ・ファイルの場所。

17.1.2 「コンポーネント」セクション

このセクションはメディエータ・エンジン・ダッシュボードにのみ表示され、メディエータ・サービス・エンジン上で実行されるメディエータ・サービス・コンポーネントに関する次の情報を表示します。

- 名前: サービス・エンジン上で実行される各メディエータ・サービス・コンポーネントの名前。

- コンポジット: サービス・エンジン上で実行されるメディエータ・サービス・コンポーネントを含む各コンポジットの名前。

- ステータス: メディエータ・サービス・コンポーネントが稼働中か停止中かを示すインジケータ。

- 合計インスタンス数: サービス・コンポーネントについて処理済または処理中の合計インスタンスの数。

- 実行中インスタンス: サービス・コンポーネントについて現在処理中のインスタンスの数。

- リカバリ可能なインスタンス: リカバリ可能な失敗したインスタンスの数。

- リカバリできないインスタンス: リカバリ不可能な失敗したインスタンスの数。

17.1.3 「最新のフォルト」セクション

このセクションには、メディエータ・サービス・コンポーネントまたはサービス・エンジンの実行中に発生した最新のフォルトに関する次の情報が表示されます。

- エラー・メッセージ: 失敗したインスタンスに関連付けられている詳細なエラー・メッセージ。

- リカバリ: フォルトがリカバリ可能かどうかを示すインジケータ。メディエータ・コンポーネント・ダッシュボードでフォルトがリカバリ可能とマークされている場合、それを選択し、「リカバリ・アクション」リストからリカバリ・アクションを選択できます。そのフォルトの「リカバリ」をクリックし、詳細なリカバリ・オプションにサービス・コンポーネント・インスタンス・レベルでアクセスすることもできます。

- フォルト時間: フォルトがインスタンスで発生した時間。

- コンポーネント: フォルトが発生したメディエータ・サービス・コンポーネントの名前(メディエータ・エンジン・ダッシュボードのみ)。

- コンポーネント・インスタンスID: メディエータ・サービス・コンポーネント・インスタンスの一意のID。

- ケース: フォルトが発生したルーティング・ソース・ケース。

- ログ: フォルトに関連したログ・メッセージが含まれるログ・ファイル。このリンクをクリックすると、フォルトとそのフォルトの考えられる原因に関する詳細が表示されます。

「フォルト」ページに表示される情報の詳細は、第18.3項「Oracle Mediatorサービス・エンジンのフォルトのリカバリ」を参照してください。

17.1.4 「ルーティングの統計」セクション

このセクションはメディエータ・コンポーネント・ダッシュボードにのみ表示され、ソース操作またはサブスクライブ・イベントのルーティング・データに関する次の情報を表示します。

- 正常に処理されたメッセージ数: 選択したルート・ソースの正常に処理されたメッセージ数。

- 失敗したメッセージ数: 選択したルート・ソースの、フォルトをスローしたメッセージ数。

- 着信メッセージ数: 選択したルート・ソースの受信メッセージの合計数。

- 正常に処理されたメッセージの平均処理時間: 選択したルート・ソースの、正常に処理された各メッセージの処理に要した平均時間。

- 失敗したメッセージの平均処理時間 - 失敗した各メッセージの処理に要した平均時間。

「ルーティングの統計」セクションの「ルート・ターゲット」サブセクションには、メディエータ・サービス・コンポーネントのターゲット・ルートの統計が表示されます。このセクションには、メディエータ・サービス・コンポーネント・インスタンスに関する次の情報が表示されます。

- 名前: メディエータ・サービス・コンポーネントのルート・ターゲットの名前。

- エラー: ルーティング時に発生したエラーの数。

- 平均処理時間: メディエータ・サービス・コンポーネントのインスタンスに対する平均処理時間。このフィールドには、「成功」と「失敗」の2つのサブフィールドがあります。「成功」サブフィールドには、正常に実行されたメディエータ・サービス・コンポーネントのインスタンスに対する平均処理時間が表示されます。「失敗」サブフィールドには、正常に実行されなかった特定のメディエータ・サービス・コンポーネントのインスタンスに対する平均処理時間が表示されます。

- 平均呼出し時間: メディエータ・サービス・コンポーネントのインスタンスに対する平均呼出し時間。

17.1.5 「インスタンス率/分(リアルタイム・データ)」セクション

このセクションには、1分当たりのメディエータ・インスタンスの実行率に関する情報が表示されます。また、このセクションには、直前5分間の「成功」、「失敗」および「受信」の各インスタンスに関するリアルタイム・データを示すグラフが表示されます。

「表ビュー」をクリックすると、直前5分間のインスタンス率を表形式で表示できます。

17.2 Oracle Mediatorサービス・コンポーネントのインスタンスとフォルトの監視

Oracle Enterprise Manager Fusion Middleware Controlの「メディエータ・コンポーネント・ホーム」ページで、次のコンポーネントレベルの監視タスクをどれでも実行できます。

- Oracle Mediatorサービス・コンポーネントの最新インスタンスおよびフォルトの監視

- Oracle Mediatorサービス・コンポーネント・インスタンスの監視

- Oracle Mediatorサービス・コンポーネント・フォルトの監視

- Oracle Mediatorのルーティング統計の監視

- Oracle Mediatorコンポーネント・インスタンスの監査証跡とフォルト詳細の監視

17.2.1 Oracle Mediatorサービス・コンポーネントの最新インスタンスおよびフォルトの監視

メディエータ・コンポーネント・ダッシュボードには、最新のインスタンスとフォルトに関する情報が表示されます。SOAコンポジット・アプリケーションの各サービス・コンポーネントには、独自のインスタンスIDがあります。このIDは、それぞれのサービス・コンポーネントが属しているSOAコンポジット・アプリケーションの全体のインスタンスIDとは異なります。

メディエータ・サービス・コンポーネントのインスタンスとフォルトを監視する手順は、次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポジットのホーム・ページにアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」を開いて、特定のSOAコンポジット・アプリケーションを選択します。

2. 「コンポーネント・メトリック」セクションで、メディエータ・サービス・コンポーネントを選択します。

3. 「ダッシュボード」タブをクリックします。

「ダッシュボード」ページには、第17.1項「Oracle Mediatorの「ダッシュボード」ページの概要」で説明されている情報が表示されます。

4. 「最新のインスタンス」セクションで、次の任意のタスクを実行します。

1. 「インスタンスID」列で、インスタンスIDをクリックし、監査証跡やフォルトなどのインスタンスの詳細を表示します。

2. 「ログ」列で、ログ・アイコンをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージが表示されます。

3. 「実行中のインスタンスのみ表示」をクリックし、実行状態のインスタンスのみを表示します。

4. セクションの下部にある「詳細を表示」をクリックし、サービス・コンポーネントの「インスタンス」ページにアクセスして、サービス・コンポーネントのすべてのインスタンスを表示します。

5. 「最新のフォルト」セクションで、次の任意のタスクを実行します。

1. 「エラー・メッセージ」列で、エラー・メッセージをクリックし、フォルトに関する完全な情報を表示します。フォルトがリカバリ可能と識別されている場合は、「ここでリカバリ」をクリックし、フォルト・リカバリを実行します。

2. 「リカバリ」列で、「リカバリ可能」と識別されているフォルトをクリックし、サービス・コンポーネント・インスタンス・レベルでフォルト・リカバリを実行します。

3. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

4. 「システム・フォルトのみ表示」をクリックし、システム・エラーが原因のフォルトのみを表示します。システム・フォルトは、データベースやネットワークにアクセスできないなど、システム障害による問題に関連しています。

5. セクションの下部にある「詳細を表示」をクリックし、サービス・コンポーネントの「フォルト」ページにアクセスして、すべてのコンポーネント・フォルトを表示します。

6. 「ルーティングの統計」セクションを開き、「ルート・ソースの選択」フィールドで操作またはイベントを選択します。
選択した操作またはイベントの統計を表示します。追加情報を表示するには、「ルート・ターゲット」セクションを開きます。

7. 「インスタンス率/分(リアルタイム・データ)」セクションを開き、特定時間帯におけるメディエータ・サービス・コンポーネントの成功、失敗および受信(保留中)のインスタンス数をグラフィカルに表示します。
「表ビュー」をクリックすると、同じ情報が表形式で表示されます。

詳細は、第1.2.3項「SOAコンポジット・アプリケーション・インスタンスの概要」"を参照してください。ログ・ファイルの表示および検索の詳細は、『Oracle Fusion Middleware管理者ガイド』を参照してください。

17.2.2 Oracle Mediatorサービス・コンポーネント・インスタンスの監視

「メディエータ・コンポーネント・ホーム」ページにある「インスタンス」ページを使用すると、指定した基準に基づいてメディエータ・サービス・コンポーネント・インスタンスを検索したり、インスタンスに関する情報を表示できます。

メディエータ・サービス・コンポーネントのインスタンス統計を監視する手順は、次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポジットのホーム・ページにアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」を開いて、特定のSOAコンポジット・アプリケーションを選択します。

2. 「コンポーネント・メトリック」セクションで、メディエータ・サービス・コンポーネントを選択します。

3. 「インスタンス」タブをクリックします。

4. 検索を実行するには、使用可能なフィールドのいずれかに基準を入力して、「検索」をクリックします。「日付」フィールドおよび「時間」フィールドについては、フィールドの横にあるカレンダ・アイコンをクリックして日付または時間を選択できます。デフォルトでは、このページに初めてアクセスしたときにはインスタンスは表示されません。インスタンスを表示するには、「検索」をクリックする必要があります。
「インスタンス」ページに表示されるフィールドの詳細は、第17.1.1項「「最新のインスタンス」セクション」を参照してください。

17.2.3 Oracle Mediatorサービス・コンポーネント・フォルトの監視

「メディエータ・コンポーネント・ホーム」ページにある「フォルト」ページを使用すると、指定した基準に基づいてフォルトを検索し、失敗したインスタンスの情報を表示したり、複数のフォルトをリカバリまたは終了できます。

メディエータ・サービス・コンポーネントのフォルトを監視する手順は、次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポジットのホーム・ページにアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」を開いて、特定のSOAコンポジット・アプリケーションを選択します。

2. 「コンポーネント・メトリック」セクションで、メディエータ・サービス・コンポーネントを選択します。

3. 「フォルト」タブをクリックします。

4. 検索を実行するには、使用可能なフィールドのいずれかに基準を入力して、「検索」をクリックします。「日付」フィールドおよび「時間」フィールドについては、フィールドの横にあるカレンダ・アイコンをクリックして日付または時間を選択できます。デフォルトでは、このページに初めてアクセスしたときにはフォルトは表示されません。フォルトを表示するには、「検索」をクリックする必要があります。
「フォルト」ページに表示されるフィールドの詳細は、第17.1.3項「「最新のフォルト」セクション」を参照してください。フォルトの処理の詳細は、第18.1項「Oracle Mediatorサービス・コンポーネントのフォルトのリカバリ」を参照してください。

17.2.4 Oracle Mediatorのルーティング統計の監視

「メディエータ・コンポーネント・ホーム」ページにある「ダッシュボード」ページの「ルーティングの統計」セクションには、ソース操作またはサブスクライブ・イベントのルーティング・データが表示されます。

メディエータ・サービス・コンポーネントのルーティング統計を監視する手順は、次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポジットのホーム・ページにアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」を開いて、特定のSOAコンポジット・アプリケーションを選択します。

2. 「コンポーネント・メトリック」セクションで、メディエータ・サービス・コンポーネントを選択します。

3. 「ダッシュボード」タブをクリックします。

4. 「ルーティングの統計」セクションで、「ルート・ソースの選択」リストからルーティング・ソースを選択します。

5. 「ルート・ターゲット」表を開きます。

6. すべてのターゲットのルーティング統計が「ルート・ターゲット」表に表示されます。
「ルーティングの統計」セクションに表示されるフィールドの詳細は、第17.1.4項「「ルーティングの統計」セクション」を参照してください。

17.2.5 Oracle Mediatorコンポーネント・インスタンスの監査証跡とフォルト詳細の監視

メディエータ・コンポーネントの「ダッシュボード」ページ、「インスタンス」ページおよび「フォルト」ページのリンクをクリックすると、そのインスタンスの監査証跡とフォルト情報を表示できます。この情報は、メディエータ・エンジンの「ダッシュボード」ページ、「インスタンス」ページおよび「フォルト」ページからもアクセスできます。

監査証跡とフォルト詳細を表示する手順は次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポジットのホーム・ページにアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」を開いて、特定のSOAコンポジット・アプリケーションを選択します。

2. 「コンポーネント・メトリック」セクションで、メディエータ・サービス・コンポーネントを選択します。

3. 「ダッシュボード」タブをクリックするか、「インスタンス」タブまたは「フォルト」タブをクリックして、検索を実行します。

4. 表示するインスタンスのインスタンスIDを選択します。「ダッシュボード」タブで、「最新のインスタンス」または「最新のフォルト」セクションでインスタンスIDをクリックできます。
メディエータ・インスタンスの詳細ダイアログが表示されて、監査証跡が表示されます。

図17-1 メディエータ・コンポーネント・インスタンスの監査証跡

5. フォルトのリストを表示するには、「フォルト」タブをクリックします。

6. 特定フォルトの詳細を表示するには、「メッセージ」列で該当するフォルトをクリックします。

図17-2 メディエータ・コンポーネント・インスタンスのフォルト詳細

17.3 Oracle Mediatorサービス・エンジンのインスタンスとフォルトの監視

Oracle Enterprise Manager Middleware Controlのメディエータ・エンジンのホーム・ページの「ダッシュボード」タブで、メディエータ・サービス・エンジンのレベルで次の監視タスクを実行できます。

- Oracle Mediatorサービス・エンジンの最新インスタンスおよびフォルトの監視

- Oracle Mediatorサービス・エンジン・インスタンスの監視

- リクエストのブレークダウン統計の監視

- サービス・エンジンのデプロイ済Oracle Mediatorサービス・コンポーネントの監視

17.3.1 Oracle Mediatorサービス・エンジンの最新インスタンスおよびフォルトの監視

メディエータ・サービス・エンジンのインスタンスとフォルトを監視する手順は、次のとおりです。

1. メディエータ・エンジンのホーム・ページに、次のいずれかのオプションを使用してアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「メディエータ」の順に選択します。

1. 「soainfra」を右クリックし、「サービス・エンジン」をポイントして「メディエータ」を選択します。

2. 「ダッシュボード」タブをクリックします。

「ダッシュボード」ページには、第17.1項「Oracle Mediatorの「ダッシュボード」ページの概要」で説明されている情報が表示されます。

3. 「最新のインスタンス」セクションで、次の任意のタスクを実行します。

1. 「インスタンスID」列で、インスタンスIDをクリックし、監査証跡やフォルトなどのインスタンスの詳細を表示します。

2. 「コンポーネント」列で、サービス・コンポーネント名をクリックし、そのコンポーネントのホーム・ページを表示します。

3. 「コンポジット」列で、コンポジット名をクリックし、そのSOAコンポジットのホーム・ページを表示します。

4. 「ログ」列で、ログ・アイコンをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージが表示されます。

5. 「実行中のインスタンスのみ表示」をクリックし、実行状態のインスタンスのみを表示します。

6. セクションの下部にある「詳細を表示」をクリックし、サービス・エンジンの「インスタンス」ページにアクセスして、サービス・エンジンのすべてのインスタンスを表示します。

4. 「コンポーネント」セクションで、次の任意のタスクを実行します。

1. 「名前」列で、サービス・コンポーネント名をクリックし、そのサービス・コンポーネントのメディエータ・コンポーネント・ダッシュボードを表示します。

2. 「コンポジット」列で、SOAコンポジット名をクリックし、そのコンポジットのホーム・ページを表示します。

3. セクションの下部にある「詳細を表示」をクリックし、サービス・エンジンの「デプロイ済コンポーネント」ページにアクセスして、すべてのデプロイ済メディエータ・コンポーネントを表示します。

5. 「最新のフォルト」セクションで、次の任意のタスクを実行します。

1. 「エラー・メッセージ」列で、エラー・メッセージをクリックし、フォルトに関する完全な情報を表示します。フォルトがリカバリ可能と識別されている場合は、「ここでリカバリ」をクリックし、フォルト・リカバリを実行します。

2. 「リカバリ」列で、「リカバリ可能」と識別されているフォルトをクリックし、サービス・エンジン・レベルでフォルト・リカバリを実行します。

3. 「コンポジット」列で、コンポジット名をクリックし、そのSOAコンポジットのホーム・ページを表示します。

4. 「コンポーネント」列で、サービス・コンポーネント名をクリックし、そのコンポーネントのホーム・ページを表示します。

5. 「コンポーネント・インスタンスID」列で、インスタンスIDをクリックして、監査証跡とフォルトを含むそのインスタンスの詳細を表示します。

6. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

7. 「システム・フォルトのみ表示」をクリックし、システム・エラーが原因のフォルトのみを表示します。システム・フォルトは、データベースやネットワークにアクセスできないなど、システム障害による問題に関連しています。

8. セクションの下部にある「詳細を表示」をクリックし、サービス・エンジンの「フォルト」ページにアクセスして、サービス・エンジンのフォルトをすべて表示します。

詳細は、第1.2.3項「SOAコンポジット・アプリケーション・インスタンスの概要」"を参照してください。ログ・ファイルの表示および検索の詳細は、『Oracle Fusion Middleware管理者ガイド』を参照してください。

17.3.2 Oracle Mediatorサービス・エンジン・インスタンスの監視

メディエータ・エンジンのホーム・ページから、サービス・エンジンで実行されているすべてのメディエータ・サービス・コンポーネント・インスタンスを監視できます。これらのサービス・コンポーネントは、複数のSOAコンポジット・アプリケーションに属している場合があります。

メディエータ・サービス・エンジン・インスタンスを監視する手順は次のとおりです。

1. メディエータ・エンジンのホーム・ページに、次のいずれかのオプションを使用してアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「メディエータ」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「メディエータ」の順に選択します。

2. 「インスタンス」タブをクリックします。
「インスタンス」ページには2つのセクションがあります。上部のセクションでは表示するインスタンスを検索でき、下部のセクションには検索によって返されたインスタンスに関する情報が表示されます。

注意:

SOAコンポジット・アプリケーション・インスタンスをアンデプロイしても、インスタンスは完了しません。アンデプロイによって、そのコンポジットの実行中のサービス・コンポーネント・インスタンスが「失効」としてマークされます。ただし、そのコンポジット・インスタンスのサービス・コンポーネント・インスタンスが完了している場合は、「失効」としてマークされません。

3. 「検索」セクションで、任意の検索条件を入力し、「検索」をクリックします。検索フィールドをクリアするには、「リセット」をクリックします。デフォルトでは、このページに初めてアクセスしたときにはインスタンスは表示されません。インスタンスを表示するには、「検索」をクリックする必要があります。

4. 「インスタンス」セクションで、次の任意の監視タスクを実行します。

1. 「インスタンスID」列で、サービス・コンポーネントのインスタンスIDをクリックし、その監査証跡、プロセス・フローおよびフォルトを表示します。

2. 「コンポーネント」列で、特定のサービス・コンポーネントをクリックし、そのホーム・ページにアクセスします。

3. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

4. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

詳細は、第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」を参照してください。

17.3.3 リクエストのブレークダウン統計の監視

メディエータ・サービス・エンジンの効率レベルは、リクエストのブレークダウン統計を監視することによって評価できます。

現在デプロイされているメディエータ・サービス・コンポーネントのリクエストのブレークダウン統計を監視する手順は、次のとおりです。

1. メディエータ・エンジンのホーム・ページに、次のいずれかのオプションを使用してアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「メディエータ」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「メディエータ」の順に選択します。

メディエータ・エンジンのホーム・ページが表示されます。

2. 「統計」タブをクリックします。

3. リクエストのブレークダウン統計を表示します。

「リクエストのブレークダウン」セクションには、次の各アクションの処理件数と、処理に要した平均時間に関する情報が表示されます。

- 一方向呼出し: メディエータ・サービス・エンジンからの一方向呼出し。

- 変換: メディエータ・サービス・エンジンでのメッセージの変換。

- エンキュー: パラレル・ルーティング・ルール対象のメッセージのデハイドレーション。

注意:

メッセージのデハイドレーションは、後でワーカー・スレッドで処理できるように、受信メッセージをパラレルのルーティング・ルール用のデータベースに格納することを意味します。

- 呼出し: メディエータ・サービス・エンジンからのリクエスト/レスポンス呼出し。

- 公開: メディエータ・サービス・エンジンからのイベントの公開。

- 条件評価: メディエータ・サービス・エンジンによる評価のフィルタ処理条件。

- 検証: メディエータ・サービス・エンジンによるメッセージの検証。

17.3.4 サービス・エンジンのデプロイ済Oracle Mediatorサービス・コンポーネントの監視

サービス・エンジンで実行しているメディエータ・サービス・コンポーネントで構成されたすべてのデプロイ済SOAコンポジット・アプリケーションを監視できます。

サービス・エンジンにデプロイ済のメディエータ・コンポーネントを監視する手順は、次のとおりです。

1. メディエータ・エンジンのホーム・ページに、次のいずれかのオプションを使用してアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「メディエータ」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「メディエータ」の順に選択します。

2. 「デプロイ済コンポーネント」タブをクリックします。
「デプロイ済のコンポーネント」ページには、2つのセクションがあります。上部のセクションでは表示するコンポーネントを検索でき、下部のセクションには検索によって返されたコンポーネントに関する情報が表示されます。

3. 「名前」列で、特定のサービス・コンポーネントをクリックし、そのホーム・ページにアクセスします。

4. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

17.4 リシーケンスされたメッセージの監視

リシーケンスされたメッセージは、「メディエータ・コンポーネント・ホーム」ページおよび「メディエータ・インスタンス」ダイアログを使用して監視できます。次の各項で、監視プロセスについて説明します。

- 第17.4.1項「メディエータ・サービス・コンポーネントのホーム・ページからのリシーケンスされたメッセージの監視」

- 第17.4.2項「「メディエータ・インスタンス」ダイアログからのリシーケンスされたメッセージの監視」

17.4.1 メディエータ・サービス・コンポーネントのホーム・ページからのリシーケンスされたメッセージの監視

「メディエータ・コンポーネント・ホーム」ページでは、「ダッシュボード」ページ、「インスタンス」ページおよび 「フォルト」ページに、リシーケンス機能を使用するコンポーネントを監視するための追加フィールドが含まれています。これらの追加フィールドは、監視対象のメディエータ・サービス・コンポーネントにリシーケンサが含まれている場合のみ表示されます。

17.4.1.1 「ダッシュボード」ページ

「メディエータ・コンポーネント・ホーム」ページにある「ダッシュボード」ページには、「最新のインスタンス」表と「最新のフォルト」表に「グループ」という1つの追加の列があります。このフィールドには、リシーケンスされたメッセージのグループIDが含まれています。行のグループIDをクリックすると、そのグループの追加情報が表示されます。詳細は、第17.4.1.4項 「メディエータ・リシーケンス・グループ」ダイアログを参照してください。「ダッシュボード」ページの詳細は、第17.1項「Oracle Mediator「ダッシュボード」ページの概要」を参照してください。

17.4.1.2 「インスタンス」ページ

図17-3に示されているように、「メディエータ・コンポーネント・ホーム」ページの「インスタンス」ページには、グループ条件に基づいてメディエータ・コンポーネント・インスタンスを検索するための「リシーケンス・グループ」という検索用の追加フィールドがあります。検索基準と一致するメディエータ・サービス・コンポーネント・インスタンスの情報が表示される「インスタンス」セクションには、「グループ」という1つの追加の列があります。この列には、リシーケンスされたメッセージのグループIDが含まれています。行のグループIDをクリックすると、そのグループの追加情報が表示されます。詳細は、第17.4.1.4項「「メディエータ・リシーケンス・グループ」ダイアログ」を参照してください。「インスタンス」ページの詳細は、第17.2.2項「Oracle Mediatorサービス・コンポーネント・インスタンスの監視」を参照してください。

図17-3 リシーケンスされたメッセージの「インスタンス」ページ

17.4.1.3 「フォルト」ページ

図17-4に示されているように、「メディエータ・コンポーネント・ホーム」ページの「フォルト」ページには、グループ条件に基づいてメディエータ・サービス・コンポーネント・インスタンスを検索するための「リシーケンス・グループ」という検索用の追加フィールドがあります。検索基準と一致するメディエータ・コンポーネント・インスタンスの情報が表示される「フォルト」セクションには、「グループ」という1つの追加の列があります。この列には、リシーケンスされたメッセージのグループIDが含まれています。行のグループIDをクリックすると、そのグループの追加情報が表示されます。詳細は、第17.4.1.4項「「メディエータ・リシーケンス・グループ」ダイアログ」を参照してください。「フォルト」ページの詳細は、第18.3章「Oracle Mediatorサービス・エンジンのフォルトのリカバリ」を参照してください。

図17-4 リシーケンスされたメッセージの「フォルト」ページ

17.4.1.4 「メディエータ・リシーケンス・グループ」ダイアログ

グループ内のすべてのメッセージがフォルトまたはタイムアウト間隔なしで処理された場合は、「メディエータ・リシーケンス・グループ」ダイアログにグループが動作していることを示すメッセージが表示されます。標準リシーケンサ・グループの場合、このダイアログには、次のシーケンスIDをスキップしてシーケンスの次のメッセージから処理を再開するオプションも提供されます。その場合、グループは継続して実行中となりますが、決して到着しないメッセージを待機することになる可能性もあります。図17-5にこのダイアログを示します。

図17-5 「メディエータ・リシーケンス・グループ」ダイアログ

「メディエータ・リシーケンス・グループ」ダイアログには、グループに関する次の情報が表示されます。

- グループがタイムアウトまたはフォルトになっているかどうか

- グループ内のブロックされているメッセージ

- グループがアンロックされた後に処理する次のメッセージ

- グループ内のメッセージの処理が停止するまでの時間

- グループをアンロックする指示テキスト

グループ内のメッセージの処理がフォルトまたはタイムアウトにより一時停止している場合、「メディエータ・リシーケンス・グループ」ダイアログには一時停止しているグループに関する情報が表示されます。グループ内のメッセージの処理は、次の理由で一時停止することがあります。

- グループが失敗

- グループがタイムアウト

- グループがシステム・エラーのために失敗

グループが失敗

グループの処理中にそのメッセージの1つでエラーがスローされた場合、図17-6に示すように、グループは失敗状態になります。失敗したグループについては次の情報が表示されます。

- 失敗したメッセージのシーケンスID

- 次に処理されるメッセージのシーケンスIDとメディエータ・インスタンスID

「ここでリカバリ」をクリックし、メディエータ・インスタンスの詳細ページの「フォルト」ページにアクセスして単一フォルト・リカバリを実行します。

図17-6 グループが失敗

グループがタイムアウト

期待されるメッセージの待機中にグループの処理が停止した場合は、図17-7に示すように、グループがタイムアウト状態になります。タイムアウト・グループについては次の情報が表示されます。

- 最後に処理されたメッセージのシーケンスID

- 次に処理されるメッセージのシーケンスIDとメディエータ・インスタンスID

「スキップ」をクリックしてグループをアンロックし、グループ内の次の使用可能インスタンスの処理を開始します。

図17-7 グループがタイムアウト

グループがシステム・エラーのために失敗

グループの処理がシステム・エラーにより一時停止した場合、図17-8に示すように、グループが失敗状態になることがあります。これは失敗したグループの特殊なケースで、このグループはタイムアウトにならず、グループで失敗したメッセージはありません。この状態のグループは、エラー・グループとして説明されます。エラー・グループについては次の情報が表示されます。

- 最後に処理されたメッセージのシーケンスID

- 次に処理されるメッセージのシーケンスIDとメディエータ・インスタンスID

「再試行」をクリックしてグループをアンロックし、グループ内の次のインスタンスの処理を開始します。

図17-8 グループがシステム・エラーのために失敗

17.4.2 「メディエータ・インスタンス」ダイアログからのリシーケンスされたメッセージの監視

メディエータ・インスタンスの詳細ダイアログの「フォルト」ページには、次のリシーケンサ固有情報が表示されます。

- リシーケンスしたメッセージのグループID

- リシーケンスしたメッセージに対して実行された操作(図17-9)
メディエータ・インスタンスの詳細ダイアログの詳細は、図17-0を参照してください。

図17-9 メディエータ・インスタンスの詳細ダイアログのリシーケンスされたメッセージのフォルト

フォルト・メッセージをクリックすると、図17-10に示されたフォルトの詳細が表示されます。「再試行」をクリックすると、メディエータ・サービス・エンジンによってメッセージの再処理が試行されます。「中断」をクリックすると、メディエータ・サービス・エンジンによって失敗したメッセージが終了し、グループがアンロックされ、シーケンス内の次のメッセージから処理が再開されます。

図17-10 リシーケンスされたメッセージのフォルト・メッセージの詳細

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

この章では、Oracle Enterprise Manager Fusion Middleware Controlを使用してOracle Mediatorサービス・コンポーネントとエンジンを管理する方法について説明します。リカバリするフォルトの表示およびメディエータ・ポリシーのアタッチとデタッチを行う手順を説明します。

この章では、次の項目について説明します。

- 第18.1項「Oracle Mediatorサービス・コンポーネントのフォルトのリカバリ」

- 第18.2項「Oracle Mediatorのポリシーの管理」

- 第18.3項「Oracle Mediatorサービス・エンジンのフォルトのリカバリ」

18.1 Oracle Mediatorサービス・コンポーネントのフォルトのリカバリ

メディエータ・サービス・コンポーネントのフォルトを監視して、リカバリ可能と識別されたフォルトについて個別のフォルト・リカバリや一括のフォルト・リカバリを実行できます。

メディエータ・サービス・コンポーネントのフォルトを管理する手順は次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポーネントのホーム・ページにアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」を開いて、特定のSOAコンポジット・アプリケーションを選択します。

2. 「コンポーネント・メトリック」セクションで、メディエータ・サービス・コンポーネントを選択します。

3. 「フォルト」をクリックします。
「フォルト」ページに、次の情報が表示されます。

- 特定のフォルトを検索するためのユーティリティ。条件を指定して「検索」をクリックします。詳細は「ヘルプ」アイコンをクリックして表示できます。デフォルトでは、このページに初めてアクセスしたときにはフォルトは表示されません。フォルトを表示するには、「検索」をクリックする必要があります。

- サービス・コンポーネントに発生したフォルトについて、エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、サービス・コンポーネントのインスタンスID、フォルトが発生したアクティビティ、およびフォルトが記述されているログ・ファイルへのリンクが表示されます。

リカバリが可能としてマークされたメディエータ・サービス・コンポーネントのフォルトはリカバリできます。

4. 次のいずれかの方法を使用して、リカバリ対象のフォルトを選択します。

対象

操作

単一フォルト・リカバリ

単一フォルト・リカバリの対象を選択するには、次の3つの方法があります。単一フォルトをリカバリするには、次のいずれかのアクションを実行します。

- リカバリ可能として識別されたフォルトの行をクリックします。行が強調表示された状態で、ステップ5の説明に従って、「リカバリ・アクション」リストから特定のアクションを選択します。

- 「リカバリ」列で「リカバリ」リンクをクリックし、インスタンス監査証跡の「フォルト」ページにアクセスしてフォルト・リカバリを実行します。図18-1はフォルトのページを示しています。

- 「エラー・メッセージ」列で、リカバリ可能として識別されたフォルトのメッセージをクリックします。完全なフォルト詳細(フォルトID、フォルトの発生時間、フォルトの場所、フォルト・タイプ、エラー・メッセージ・テキストなど)が表示されます。「ここでリカバリ」をクリックし、インスタンス監査証跡の「フォルト」ページにアクセスしてフォルト・リカバリを実行します。「ここでリカバリ」オプションがない場合、フォルトはリカバリできません。

一括フォルト・リカバリ

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

1. 次のいずれかを実行します。

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

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

2. ステップ5の説明に従って、「リカバリ・アクション」リストからアクションを選択します。
注意: 選択できるのは、選択したすべてのフォルトに適用可能なアクションのみです。

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

すべてのフォルトをリカバリするには、次の手順を実行します。

1. 「選択」メニューから、「すべてのリカバリ可能な値を選択」を選択します。

2. ステップ5の説明に従って、「リカバリ・アクション」リストからアクションを選択します。
注意: 選択できるのは、選択したすべてのフォルトに適用可能なアクションのみです。

図18-1 メディエータ・インスタンスの詳細ダイアログの「フォルト」タブ

5. 前述の手順でリカバリ方法をまだ選択していない場合は、「リカバリ・アクション」リストから次のいずれかのアクションを選択します。

アクション

説明

再試行

インスタンスを直接再試行します。このリカバリ・アクションを使用するシナリオ例は、ネットワーク・エラーのためにサービス・プロバイダにアクセスできないことが原因でフォルトが発生した場合の例です。ネットワーク・エラーは現在解決しています。

中断

インスタンス全体を終了します。

リプレイ

フォルトが発生したスコープ・アクティビティ全体を再度リプレイします。

再スロー

現在のフォルトを再スローします。フォルトの処理に、BPELフォルト・ハンドラ(catchブランチ)が使用されます。デフォルトでは、再スロー・フォルト・ポリシーが明示的に指定されていない場合、すべての例外がフォルト管理フレームワークによって捕捉されます。

続行

フォルトを無視して処理を続行します(フォルト・アクティビティには成功のマークが付けられます)。

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

- 第1.4.3.1項「フォルト・リカバリの概要」

- 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』

- ログ・ファイルの表示および検索については、『Oracle Fusion Middleware管理者ガイド』を参照してください

18.2 Oracle Mediatorのポリシーの管理

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

「メディエータ・コンポーネント・ホーム」ページの「ポリシー」ページには、メディエータ・コンポーネント・インスタンスに関する次の情報が表示されます。

- ポリシー名: ポリシーの名前。

- ポリシー参照ステータス: ポリシーを有効化または無効化するためのトグル・ボタン。ポリシーを一時的に無効にすると、そのポリシーはデタッチされずにオフになります。ボタンに「無効化」と表示されている場合はポリシーは有効化されており、ボタンに「有効化」と表示されている場合はポリシーは無効化されています。

- カテゴリ: ポリシーのカテゴリ。「管理」、「信頼できるメッセージング」、「MTOMアタッチメント」、「セキュリティ」および「WSアドレス」の値があります。

- 合計違反: SOAインフラストラクチャ再起動後の違反の合計数。

- セキュリティ違反: 各カテゴリでの違反数。カテゴリには、「認証」、「認可」、「機密保護」および「整合性」の値が表示されます。

注意:

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

メディエータのポリシーを管理する手順は、次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポジットのホーム・ページにアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションを選択します。

2. 「コンポーネント・メトリック」セクションで、メディエータ・サービス・コンポーネントを選択します。

3. 「ポリシー」タブをクリックします。

4. メディエータ・コンポーネントにアタッチされているポリシーを表示します。

5. 「アタッチ/デタッチ」をクリックして、ポリシーをアタッチまたはデタッチします。

6. 複数のコンポーネントが使用可能な場合は、ポリシーのアタッチ先のサービスまたはコンポーネントを選択します。
「ポリシーのアタッチ/デタッチ」ページが表示され、アタッチされているすべてのポリシーは上部ペインに、アタッチ可能なすべてのポリシーは下部ペインに表示されます。

7. ポリシーをアタッチするには、下部ペインからポリシーを選択して、「アタッチ」をクリックします。

8. ポリシーをデタッチするには上部ペインからポリシーを選択して、「デタッチ」をクリックします。

9. ポリシーのアタッチまたはデタッチを終了したら、「検証」をクリックします。

10. 検証エラーが発生した場合は、エラーがなくなるまで必要な修正と検証を行います。

11. 「OK」をクリックします。
ダイアログが閉じ、アタッチされたポリシーがポリシー表に表示されます。

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

- 第1.4.3.2項「ポリシーの概要」

- ポリシーのアタッチで表示されるダイアログについては、第7.7項「SOAコンポジット・アプリケーションのポリシーの管理」を参照してください。

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

18.3 Oracle Mediatorサービス・エンジンのフォルトのリカバリ

リカバリ可能として識別されたメディエータ・サービス・エンジンを監視し、個別のフォルト・リカバリと一括のフォルト・リカバリを実行できます。メディエータ・サービス・エンジンでは、すべてのメディエータ・サービス・コンポーネントのフォルトを、属しているSOAコンポジット・アプリケーション・インスタンスに関係なく表示できます。

メディエータ・サービス・エンジンのフォルトを管理する手順は次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポジットのホーム・ページにアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「メディエータ」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「メディエータ」の順に選択します。

メディエータ・エンジンのホーム・ページが表示されます。

2. 「フォルト」をクリックします。
「フォルト」ページに、次の情報が表示されます。

- 特定のフォルトを検索するためのユーティリティ。条件を指定して「検索」をクリックします。詳細は「ヘルプ」アイコンをクリックして表示できます。デフォルトでは、このページに初めてアクセスしたときにはフォルトは表示されません。フォルトを表示するには、「検索」をクリックする必要があります。

- サービス・コンポーネントに発生したフォルトについて、エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、サービス・コンポーネントのインスタンスID、フォルトが発生したアクティビティ、およびフォルトが記述されているログ・ファイルへのリンクが表示されます。

リカバリが可能としてマークされたメディエータ・サービス・エンジンのフォルトはリカバリできます。

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

4. 前述の手順でリカバリ方法をまだ選択していない場合は、「リカバリ・アクション」リストからアクションを選択します。

アクション

説明

再試行

再試行成功時アクションを指定するオプション付きでインスタンスを再試行します。このリカバリ・アクションを使用するシナリオ例は、ネットワーク・エラーのためにサービス・プロバイダにアクセスできないことが原因でフォルトが発生した場合の例です。ネットワーク・エラーは現在解決しています。

中断

インスタンス全体を終了します。

リプレイ

フォルトが発生したスコープ・アクティビティ全体を再度リプレイします。

再スロー

現在のフォルトを再スローします。

続行

フォルトを無視して処理を続行します(フォルト・アクティビティには成功のマークが付けられます)。

5. フォルト表内から次の追加監視タスクを実行します。

1. 「リカバリ可能なフォルトのみ表示」チェック・ボックスをクリックすると、リカバリ可能なフォルトのみ表示されます。

2. 「フォルト・タイプ」リストから、すべてのフォルト、システム・フォルト、ビジネス・フォルトまたはOWSMフォルトを選択して、フォルト表に表示します。これらのフォルト・タイプの詳細は、「ヘルプ」をクリックしてください。

3. 「ビュー」リストから、「列」→「フォルトID」の順に選択し、各エラー・メッセージのフォルトIDを表示します。フォルトIDは自動的に生成され、フォルトを一意に識別します。フォルトIDは、エラー・メッセージをクリックしたときも表示されます。

4. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

5. 「コンポーネント」列で、特定のサービス・コンポーネントをクリックし、そのホーム・ページにアクセスします。

6. 「コンポーネント・インスタンスID」列で、特定のサービス・コンポーネントIDをクリックし、インスタンスに関するタスク詳細(たとえば、タスクの現在の状態)にアクセスします。拒否メッセージにはコンポーネント・インスタンスIDがないことに注意してください。

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

- 第1.4.3.1項「フォルト・リカバリの概要」(フォルトの概念的な詳細情報)

- 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』

18.4 リシーケンスされたメッセージのスキップ

リシーケンス・グループがタイムアウト状態にある場合は、グループが処理を再開するのをブロックしているメッセージをスキップできます。タイムアウト期間が設定されていない場合などは、標準リシーケンス・グループはタイムアウトなしで実行状態のまま無期限に待機することになる場合があります。この場合は、グループがまだタイムアウトしていなくても、待機中のシーケンスIDをスキップできます。

18.4.1 実行中のグループの次のシーケンスIDへのスキップ

標準リシーケンス・グループの実行中に、次のメッセージが指定のタイムアウト期間中に到着しないことがわかっている場合は(またはタイムアウト期間がない場合は)、次の手順を実行して、次に予期されるシーケンスIDをスキップし、次に使用可能なメッセージの処理を開始します。

実行中のグループの次のシーケンスIDへスキップする手順は次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポーネントのホーム・ページにアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」を開いて、特定のSOAコンポジット・アプリケーションを選択します。

2. 「コンポーネント・メトリック」セクションで、メディエータ・サービス・コンポーネントを選択します。

3. 次のいずれかを実行します。

- 「最新のインスタンス」リストで、シーケンスIDをスキップするグループのグループIDをクリックします。

- 「インスタンス」タブをクリックして、インスタンスの検索を実行し、結果リストで、シーケンスIDをスキップするグループのグループIDをクリックします。

「メディエータ・リシーケンス・グループ」ダイアログが表示されます。

図18-2 「スキップ」オプションのある「メディエータ・リシーケンス・グループ」ダイアログ(実行中)

4. 次のシーケンスIDへスキップするには、「スキップ」をクリックします。

注意:

「スキップ」ボタンは、標準リシーケンサ向けに構成されているグループのダイアログにのみ表示され、ベスト・エフォートまたはFIFOリシーケンサの場合は表示されません。メッセージをスキップすると、常にスキップされた状態になり、パージ・スクリプトによってパージされなくなります。

18.4.2 タイムアウトしたグループの次のシーケンスIDへのスキップ

予期されるメッセージを待機中にリシーケンス・グループの処理が停止した場合、グループはタイムアウトした状態で、メッセージは処理されません。これを修正するには、タイムアウトの原因となったメッセージをスキップして、次に使用可能なシーケンスIDに進む必要があります。

タイムアウトしたグループの次のシーケンスIDにスキップする手順は次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポーネントのホーム・ページにアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」を開いて、特定のSOAコンポジット・アプリケーションを選択します。

2. 「コンポーネント・メトリック」セクションで、メディエータ・サービス・コンポーネントを選択します。

3. 次のいずれかを実行します。

- 「最新のインスタンス」リストで、タイムアウトしたグループのグループIDをクリックします。

- 「インスタンス」タブをクリックして、インスタンスを検索し、結果リストで、タイムアウトしたグループのグループIDをクリックします。

「メディエータ・リシーケンス・グループ」ダイアログが表示されます。

図18-3 「スキップ」オプションのある「メディエータ・リシーケンス・グループ」ダイアログ(タイムアウト)

4. グループをアンロックし、グループ内の次のインスタンスの処理を開始するには、「スキップ」をクリックします。

注意:

メディエータは、最後に処理されたメッセージのシーケンスIDと次に処理されるメッセージのシーケンスIDの間のシーケンスIDを持つメッセージをすべて処理しなくなります。

19 相互参照の管理

この章では、相互参照表から不要になった情報を削除する方法について説明します。相互参照を使用して、様々なアプリケーションで作成された同等のエンティティの識別子を関連付けます。

この章では、次の項目について説明します。

- 第19.1項「相互参照値の削除」

相互参照の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

19.1 相互参照値の削除

「相互参照」ページを使用すると、値を削除する表と列を選択できます。

相互参照の表から値を削除する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「SOA管理」→「相互参照」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「SOA管理」→「相互参照」の順に選択します。

「相互参照」ページが表示されます。

2. 「表と列の選択」セクションで、次のいずれかのオプションを選択します。

- すべての表: すべての表から値を削除します。

- 表と列を選択します: 値を削除する特定の表を選択するか、値を削除する特定の表から1つ以上の列を選択します。

3. 「値の選択」セクションで、次のいずれかのオプションを選択します。

- すべて: 選択した表と列からすべての値を削除します。

- 削除対象としてマーク済: 選択した表と列から削除のマークが付けられた値のみを削除します。

- 更新期間: 特定の期間内に更新された値を削除します。

4. ステップ4で「更新期間」オプションを選択した場合は、「自」フィールドに開始日を、「至」フィールドに終了日を入力します。

5. 「削除」をクリックします。

第VII部

デシジョン・サービス・コンポーネントとビジネス・ルール・サービス・エンジンの管理

この部では、デシジョン・サービス・コンポーネントとビジネス・ルール・サービス・エンジンの管理方法について説明します。

次の章で構成されています。

- 第20章「デシジョン・サービス・コンポーネントとエンジンの監視」

20 デシジョン・サービス・コンポーネントとエンジンの監視

この章では、デシジョン・サービス・コンポーネントの監視方法(サービス・エンジンのインスタンス、フォルト、パフォーマンス統計およびデプロイ済コンポジット、デプロイ済デシジョン・サービス・コンポーネントのインスタンス、ビジネス・ルールのトレース、およびログ・ファイルの監視を含む)について説明します。デシジョン・サービス・コンポーネントは、Oracle Fusion Middlewareドキュメントではビジネス・ルール・サービス・コンポーネントとも呼ばれます。

この章では、次の項目について説明します。

- 第20.1項「ビジネス・ルール・サービス・エンジンの最新のインスタンスとフォルトの監視」

- 第20.2項「ビジネス・ルール・サービス・エンジンのパフォーマンス統計の監視」

- 第20.3項「ビジネス・ルール・サービス・エンジンのインスタンスの監視」

- 第20.4項「ビジネス・ルール・サービス・エンジンのフォルトの監視」

- 第20.5項「ビジネス・ルール・サービス・エンジンのデプロイ済コンポーネントの監視」

- 第20.6項「コンポジット・アプリケーションのデシジョン・サービス・コンポーネントのインスタンスの監視」

- 第20.7項「ビジネス・ルールのトレースの監視」

- 第20.8項「デシジョン・サービス・コンポーネントのログの監視」

ビジネス・ルールのチューニングとパフォーマンス・パラメータの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』を参照してください。

注意:

ビジネス・ルール・サービス・エンジンではユーザー・レベルの構成がサポートされていません。

20.1 ビジネス・ルール・サービス・エンジンの最新のインスタンスとフォルトの監視

SOAインフラストラクチャで実行しているデシジョン・サービス・コンポーネントの最新のインスタンスとフォルトは、ビジネス・ルール・サービス・エンジンのホーム・ページの「ダッシュボード」ページを使用して監視できます。これらのデシジョン・サービス・コンポーネントは、別々のSOAコンポジット・アプリケーションに属している場合があります。デシジョン・サービス・コンポーネントは、Oracle Fusion Middlewareドキュメントではビジネス・ルール・コンポーネントとも呼ばれます。

ビジネス・ルール・サービス・エンジンのインスタンスおよびフォルトを監視するには、次の手順を実行します。

1. 次のいずれかのオプションを使用して、ビジネス・ルール・サービス・エンジンのホーム・ページにアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「ビジネス・ルール」の順に選択します。

1. 「soa-infra」を選択します。

2. 「サービス・エンジン」を右クリックして、「ビジネス・ルール」を選択します。

2. 「ダッシュボード」をクリックします。
「ダッシュボード」ページの「最新のインスタンス」セクションには、すべてのデシジョン・サービス・コンポーネントの最新インスタンスが表示されます。これには、デシジョン・サービス・コンポーネントのインスタンスID、デシジョン・サービス・コンポーネント名、デシジョン・サービス・コンポーネントが属しているSOAコンポジット・アプリケーション、インスタンスの状態(正常完了や失敗など)、インスタンスの開始時間、最終更新日時および「ログ」アイコンが含まれます(「ログ」アイコンをクリックすると、「ログ・メッセージ」ページにそのインスタンスに固有のメッセージがフィルタされて表示されます)。

注意:

正確な状態を表示するには、「コンポジット・インスタンスの状態をキャプチャ」プロパティを設定する必要があります。この設定は、SOA管理の「共通プロパティ」ページで変更できます。この機能をオンにすることで、実行中のインスタンスを個別にトラッキングできます。ただし、パフォーマンスに影響を与える可能性があります。このプロパティの設定方法については、第3.1項「SOAインフラストラクチャ・プロパティの構成」を参照してください。

3. 「インスタンスID」列で、デシジョン・サービス・コンポーネントのインスタンスIDをクリックし、監査証跡を表示します。

注意:

監査証跡ページの内容は、「監査レベル」の設定に依存します。「監査レベル」プロパティが「本番」に設定されている場合、監査証跡にはアクティビティ名のみが表示されます。「監査レベル」が「開発」モードに設定されている場合、監査証跡にはデシジョン・サービスのインスタンスのペイロード詳細が表示されます。「オフ」などの他のモードでは、監査証跡にデシジョン・サービス詳細は表示されません。監査レベルは「SOAインフラストラクチャの共通プロパティ」ページで変更できます。また、このオプションは、特定のコンポジットに対して、そのコンポジットのホーム・ページから設定できます。

4. 「コンポーネント」列で、特定のデシジョン・サービス・コンポーネントをクリックし、そのホーム・ページにアクセスします。

5. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

6. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

7. 「詳細を表示」をクリックし、サービス・エンジンの「インスタンス」ページにアクセスします。

「ダッシュボード」ページの下側のセクションには、次の情報が表示されます。

- 「コンポーネント」セクションには、ビジネス・ルール・サービス・エンジンにデプロイされた複数のSOAコンポジットのデシジョン・サービス・コンポーネントが表示されます。また、SOAコンポジットのステータスおよびインスタンス数情報が、それぞれのインスタンス状態列に表示されます。

- 「最新のフォルト」セクションには、サービス・エンジンの最新のフォルトが表示されます。これには、エラー・メッセージ、フォルトが発生した時間、フォルトが発生したSOAコンポジット・アプリケーション、デシジョン・サービス・コンポーネント、デシジョン・サービス・コンポーネントのインスタンスIDおよび「ログ」アイコンが含まれます(「ログ」アイコンをクリックすると、「ログ・メッセージ」ページにそのインスタンスに固有のメッセージがフィルタされて表示されます)。

詳細は、第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」を参照してください。

20.2 ビジネス・ルール・サービス・エンジンのパフォーマンス統計の監視

ビジネス・ルール・サービス・エンジンのパフォーマンスとメトリックは、ビジネス・ルール・サービス・エンジンの「統計」ページを使用して監視できます。このページには、コンポーネント・レベルの詳細ではなく、サービス・エンジン・レベルの詳細が表示されます。ビジネス・ルール・サービス・コンポーネントは、Oracle Fusion Middlewareドキュメントではデシジョン・サービス・コンポーネントとも呼ばれます。

ビジネス・ルール・サービス・エンジン統計を監視するには、次の手順を実行します。

1. 次のいずれかのオプションを使用して、ビジネス・ルール・サービス・エンジンの「統計」ページにアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

「サービス・エンジン」→「ビジネス・ルール」の順に選択します。

1. 「soa-infra」を選択します。

2. 「サービス・エンジン」を右クリックして、「ビジネス・ルール」を選択します。

2. 「統計」をクリックします。
「統計」ページに、次の詳細が表示されます。

- 平均リクエスト処理時間: このグラフには、サーバー起動時以降のビジネス・ルール・サービス・エンジンの平均リクエスト処理時間が表示されます。つまり、サービス・エンジンが処理した単位時間当たりのリクエスト数が表示されます。

- ビジネス・ルールのキャッシュ統計: このセクションには、サービス・エンジン・キャッシュに関する詳細が表示されます。このセクションには、サービス・エンジンが使用したキャッシュのタイプと、各キャッシュ内のオブジェクト数がリストされます。これらすべてのメトリックは、サーバー起動時以降のオブジェクト数に基づきます。

- 「ビジネス・ルールの操作統計」: この領域には、操作統計が表示されます。操作統計を使用すると、サーバー起動時以降のOracle Business Rulesのデシジョン関数へのコール数を確認したり、サーバー起動時以降のデシジョン関数で要した合計時間を確認できます。

注意:

Oracle Fusion Middleware 11g リリース1 (11.1.1)で作成したコンポジット・アプリケーションについてビジネス・ルールの操作統計を表示すると、callFunction操作のみが表示されます。このリリースでは、デシジョン・サービスはデシジョン関数を使用してOracle Business Rulesをコールするのみで、この操作はcallFunctionと呼ばれる操作の値(「件数」フィールドと「平均(ミリ秒)」フィールドを使用)で示されます。以前のリリースから移行したコンポジット・アプリケーションの場合、デシジョン・サービスは、「ビジネス・ルールの操作統計」セクションにリストされている「callFunction」操作と他の操作を実行します。これらの移行プロジェクトでは、サービス・エンジン内の様々な重要操作を使用してリクエストのフローをデバッグできます。また、長時間に及ぶ操作を検索して必要なアクションを実行できます。これらのメトリックもサーバー起動時以降を基にしています。

ビジネス・ルールのチューニングとパフォーマンス・パラメータの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』を参照してください。

20.3 ビジネス・ルール・サービス・エンジンのインスタンスの監視

ビジネス・ルール・サービス・エンジンの「インスタンス」ページを使用すると、すべてのデシジョン・サービス・コンポーネントのインスタンスを監視できます。これらのデシジョン・サービス・コンポーネントは、別々のSOAコンポジット・アプリケーションに属している場合があります。デシジョン・サービス・コンポーネントは、Oracle Fusion Middlewareドキュメントではビジネス・ルール・サービス・コンポーネントとも呼ばれます。

ビジネス・ルール・サービス・エンジン・インスタンスを監視する手順は、次のとおりです。

1. 次のいずれかのオプションを使用して、ビジネス・ルール・サービス・エンジンの「インスタンス」ページにアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

「サービス・エンジン」→「ビジネス・ルール」の順に選択します。

1. 「soa-infra」を選択します。

2. 「サービス・エンジン」を右クリックして、「ビジネス・ルール」を選択します。

2. 「インスタンス」をクリックします。
「インスタンス」ページに、次の情報が表示されます。

- 特定のインスタンスを検索するためのユーティリティ。基準を指定して「検索」をクリックします。デフォルトでは、このページに初めてアクセスしたときにはインスタンスは表示されません。インスタンスを表示するには、「検索」をクリックする必要があります。

- インスタンスのリスト。デシジョン・サービス・コンポーネントのインスタンスID、デシジョン・サービス・コンポーネント名、SOAコンポジット・アプリケーション名、インスタンスの状態(正常完了、実行中、失敗など)、インスタンスの開始時間、最終更新日時および「ログ」アイコンが表示されます(「ログ」アイコンをクリックすると、インスタンスのログ・メッセージが表示されます)。

3. 「インスタンスID」列で、デシジョン・サービス・コンポーネントのインスタンスIDをクリックし、監査証跡の詳細を表示します。

注意:

監査証跡ページの内容は、「監査レベル」の設定に依存します。「監査レベル」プロパティが「本番」に設定されている場合、監査証跡にはアクティビティ名のみが表示されます。「監査レベル」が「開発」モードに設定されている場合、監査証跡にはデシジョン・サービスのインスタンスのペイロード詳細が表示されます。監査レベルは「SOAインフラストラクチャの共通プロパティ」ページで変更できます。また、このオプションは、特定のコンポジットに対して、そのコンポジットのホーム・ページから設定できます。

4. 「コンポーネント」列で、特定のデシジョン・サービス・コンポーネントをクリックし、そのホーム・ページにアクセスします。

5. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

6. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

詳細は、第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」を参照してください。

20.4 ビジネス・ルール・サービス・エンジンのフォルトの監視

すべてのデシジョン・サービス・コンポーネントのフォルトは、ビジネス・ルール・サービス・エンジンの「フォルト」ページを使用して監視できます。「フォルト」ページには、複数のデシジョン・サービス・コンポーネントについてこの情報が表示されます。これらのデシジョン・サービス・コンポーネントは、別々のSOAコンポジット・アプリケーションに属している場合があります。デシジョン・サービス・コンポーネントは、Oracle Fusion Middlewareドキュメントではビジネス・ルール・コンポーネントとも呼ばれます。

ビジネス・ルール・サービス・エンジンのフォルトを監視するには、次の手順を実行します。

注意:

デシジョン・サービス・コンポーネントのフォルトは、常にリカバリ不可です。

1. 次のいずれかのオプションを使用して、ビジネス・ルール・サービス・エンジンの「フォルト」ページにアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

「サービス・エンジン」→「ビジネス・ルール」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「ビジネス・ルール」の順に選択します。

2. 「フォルト」をクリックします。
「フォルト」ページに、次の情報が表示されます。

- 特定のフォルトを検索するためのユーティリティ。基準を指定して「検索」をクリックします。詳細は、「ヘルプ」アイコンをクリックしてください。デフォルトでは、このページに初めてアクセスしたときにはフォルトは表示されません。フォルトを表示するには、「検索」をクリックする必要があります。

- デシジョン・サービス・コンポーネントで発生したフォルトのリスト。エラー・メッセージ、フォルトの発生時間、フォルトが発生したSOAコンポジット・アプリケーションとデシジョン・サービス・コンポーネント、デシジョン・サービス・コンポーネントのインスタンスIDおよび「ログ」アイコンが表示されます。(「ログ」アイコンをクリックすると、インスタンスのログ・メッセージが表示されます)。

デシジョン・サービス・コンポーネントのインスタンスのフォルトはリカバリできません。

3. 「フォルト」ページ内から次の監視タスクを実行できます。

1. 「フォルト・タイプ」リストから、すべてのフォルト、システム・フォルト、ビジネス・フォルトまたはOracle Web Services Managerフォルトを選択して、「フォルト」ページに表示します。

2. 「ビュー」リストから、「列」→「フォルトID」の順に選択し、各フォルトのフォルトIDを表示します。フォルトIDは自動的に生成され、フォルトを一意に識別します。フォルトIDは、エラー・メッセージをクリックしたときも表示されます。

3. 「コンポーネント」列で、特定のデシジョン・サービス・コンポーネントをクリックし、そのホーム・ページにアクセスします。

4. 「コンポーネント・インスタンスID」列で、特定のデシジョン・サービス・コンポーネントのインスタンスIDをクリックし、監査証跡を表示します。

注意:

監査証跡ページの内容は、「監査レベル」の設定に依存します。「監査レベル」プロパティが「本番」に設定されている場合、監査証跡にはアクティビティ名のみが表示されます。「監査レベル」が「開発」モードに設定されている場合、監査証跡にはデシジョン・サービスのインスタンスのペイロード詳細が表示されます。監査レベルは「SOAインフラストラクチャの共通プロパティ」ページで変更できます。また、このオプションは、特定のコンポジットに対して、そのコンポジットのホーム・ページから設定できます。

5. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。「ログ」リンクをクリックすると、そのフォルト・インスタンスに関連したフォルトおよびエラー・メッセージが表示されます。

4. 「エラー・メッセージ」列で、クリックしてフォルトの詳細を表示します。

詳細は、第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」を参照してください。

20.5 ビジネス・ルール・サービス・エンジンのデプロイ済コンポーネントの監視

複数のSOAコンポジット・アプリケーションのデプロイ済デシジョン・サービス・コンポーネントはすべて、ビジネス・ルール・サービス・エンジンのホーム・ページの「デプロイ済コンポーネント」ページを使用して監視できます。デシジョン・サービス・コンポーネントは、Oracle Fusion Middlewareドキュメントではビジネス・ルール・コンポーネントとも呼ばれます。

ビジネス・ルール・サービス・エンジンのデプロイ済コンポーネントを監視する手順は、次のとおりです。

1. 次のいずれかのオプション使用して、ビジネス・ルール・サービス・エンジンの「デプロイ済コンポーネント」タブにアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

「サービス・エンジン」→「ビジネス・ルール」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「ビジネス・ルール」の順に選択します。

2. 「デプロイ済コンポーネント」をクリックします。
「デプロイ済コンポーネント」ページに、次の情報が表示されます。

- 特定のコンポーネントを検索するためのユーティリティ。基準を指定して「検索」をクリックします。

- コンポーネントのリスト。名前、SOAコンポジット・アプリケーション名、ステータス(稼働中か停止中か)およびインスタンス数(合計、実行中および失敗)が表示されます。

3. 「名前」列で、名前をクリックしてコンポーネントのホーム・ページに移動し、コンポーネントの詳細を表示します。

4. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

詳細は、第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」を参照してください。

20.6 コンポジット・アプリケーションのデシジョン・サービス・コンポーネントのインスタンスの監視

コンポジット・アプリケーションのデシジョン・サービス・コンポーネントのインスタンスを監視できます。各デシジョン・サービス・コンポーネントのインスタンスには、独自の一意のインスタンスIDがあります。このIDは、このデシジョン・サービス・コンポーネントが属しているSOAコンポジット・アプリケーションの全体のインスタンスIDとは異なります。デシジョン・サービス・コンポーネントは、Oracle Fusion Middlewareドキュメントではビジネス・ルール・コンポーネントとも呼ばれます。

注意:

正確な状態を表示するには、「コンポジット・インスタンスの状態をキャプチャ」オプションを設定する必要があります。この設定は「SOAインフラストラクチャの共通プロパティ」ページで変更できます。この機能をオンにすることで、実行中のインスタンスを個別にトラッキングできます。ただし、パフォーマンスに影響を与える可能性があります。このオプションの設定方法については、第3.1項「SOAインフラストラクチャ・プロパティの構成」を参照してください。

コンポジット・アプリケーションからデシジョン・サービス・コンポーネントのインスタンスを監視する手順は、次のとおりです。

1. 次のいずれかのオプションを使用して、コンポジット・アプリケーションからデシジョン・サービス・コンポーネントにアクセスします。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. ナビゲータで「soa-infra」を選択します。

2. 「SOAインフラストラクチャ」メニューから、「ホーム」を選択します。

3. 「デプロイ済コンポジット」タブをクリックします。

4. 「コンポジット」表で、デシジョン・サービス・コンポーネントが組み込まれた特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」を開きます。

2. デシジョン・サービス・コンポーネントが組み込まれた特定のSOAコンポジット・アプリケーションを選択します。

2. コンポジット・ダッシュボードの「コンポーネント・メトリック」セクションには、各デシジョン・サービス・コンポーネントに関する高レベルの概要が表示されます。この表には、「コンポーネント・タイプ」、「合計インスタンス数」、「実行中インスタンス」および「失敗したインスタンス」(リカバリ可能およびリカバリ不可)を示す各列が表示されます。

3. 「コンポーネント・メトリック」セクションで、デシジョン・サービス・コンポーネントを選択し、対応するデシジョン・サービス・コンポーネント・ページを表示します。

詳細は、第1.2.3項「SOAコンポジット・アプリケーション・インスタンスの概要」を参照してください。

20.7 ビジネス・ルールのトレースの監視

Oracle Enterprise Manager Fusion Middleware Controlを使用してルール実行トレースを実行できます。Fusion Middleware Controlへのアクセスおよび使用の詳細は、第2章「Oracle SOA SuiteおよびOracle BPM Suiteの管理のスタート・ガイド」を参照してください。

ルール実行トレースは、ルールの評価中に発生するビジネス・ルール・サービス・エンジン・イベントのトレース・メカニズムです。トレースされるイベントのタイプは次のとおりです。

- ファクト操作(アサート、撤回および変更)

- ルール実行

- ルールのアクティブ化

- ルールセット・スタックの変更

- ルールのコンパイル

- リセット(分析中に状態を維持するために必要)

各トレースには、トレースするイベントに関する情報が含まれます。たとえば、実行されたルールのルール・トレース・エントリは次の内容で構成されます。

- ルール名(RL名)

- 実行順序番号

- このルールに一致したファクトのファクトIDのリスト

- ミリ秒単位のタイムスタンプ

ルール実行トレースの監査レベルは、SOAインフラストラクチャでサポートされている監査レベルと同じであり、次のものがあります。

- オフ: ルール実行トレースは無効です。デシジョン・コンポーネント・インスタンスはまったく作成されません。

- 開発: ファクト(リスト、変更やアサートなどの操作)、ルールのアクティブ化、ルールセットのポップまたはプッシュなどに関するすべての詳細情報を含む完全なルール実行トレース。実行されたルールが一致するファクトIDのリストも提供されます。例は、第20.7.1項「開発監査レベルでのルール実行のトレース」を参照してください。

- 本番: 実行されたルールがトレースされます。ファクト、ルールのアクティブ化、ルールセットのポップまたはプッシュに関する詳細はすべて使用できません。トレースには、一致するファクトIDのリストは含まれません。例は、第20.7.2項「本番監査レベルでのルール実行のトレース」を参照してください。

監査レベルはSOAインフラストラクチャ・レベルまたはコンポジット・レベルのいずれかに設定できます。SOAインフラストラクチャの監査レベルの構成情報は、第3.1項「SOAインフラストラクチャ・プロパティの構成」を参照してください。SOAインフラストラクチャ・レベルで設定された場合、およびコンポジット・レベルで設定された場合の監査レベルの優先順位の説明は、第1.4.1.1項「監査レベル設定の優先順位の概要」を参照してください。次の各項では、ルール実行トレースのために監査レベルをコンポジット・レベルに設定する場合について説明します。

20.7.1 開発監査レベルでのルール実行のトレース

監査レベルを「開発」に設定すると、実行されたルールに関連するすべての詳細情報を表示できます。

開発レベルのルール実行トレースを実行する手順は、次のとおりです。

1. Oracle Enterprise Manager Fusion Middleware Controlでコンポジット・アプリケーションを開きます。
コンポジットの「ダッシュボード」ページに、最近実行されたコンポジット・インスタンスのリストが表示されます。

2. 「設定」リストをクリックし、コンポジットの監査レベル→「開発」の順に選択して、トレース・レベルをコンポジット・レベルとして「開発」に設定します。

3. 「確認」ダイアログで「はい」をクリックします。

4. 「テスト」→「クライアント」の順にクリックして、コンポジットのテスト・インスタンスを呼び出し、Order IDなどの様々な入力パラメータに対応するデシジョン・トレースを表示します。

5. 「Webサービスのテスト」ページの「引数の入力」セクションの「値」フィールドに1001などのOrder IDを入力し、「Webサービスのテスト」ボタンをクリックします。

入力したOrder IDに基づいて、サービスはOrder IDの詳細を含むBPELプロセス・インスタンスを呼び出し、オーダー詳細に関連するルールが実行されます。

6. 「レスポンス」タブの下の「メッセージ・フロー・トレースの起動」をクリックして、「フローのトレース」ページを開きます。

7. 「トレース」セクションでDiscountDictionaryというデシジョン・サービス・コンポーネントのインスタンスをクリックして、実際のルール実行トレースを表示します。

注意:

ビジネス・ルール・コンポーネントを起動する前後のコンポジット変数の値を表示することもできます。「フローのトレース」ページでBPELプロセス・コンポーネント・インスタンスをクリックしてから、該当する「ペイロード」をクリックする必要があります。この場合、BPELコンポジット名はFODOrderProcessingProcessです。

次の図は、DiscountDictionaryというデシジョン・サービス・コンポーネントの実行トレースを示しています。

8. 「監査証跡内のルール・セット・スタック状態の表示」チェック・ボックスを選択すると、ルール実行の詳細が表示されます。

開発レベルのトレース・レポートに、ファクト名、アクティブ化されているルール、プッシュおよびポップされたルールセット名が表示されます。

次の表に、トレース・レポートのエントリをリストします。

要素

説明

呼び出されたデシジョン・サービス名

呼び出されたデシジョン・サービス・コンポーネントの名前が表示されます。

アサートされたファクト

BPELサービスからデシジョン・サービス・コンポーネントに渡されたファクトの名前が表示されます。これは、ユーザーが指定した入力パラメータに基づきます。この例ではOrder ID 1001です。

アクティブ化されたルール

アクティブ化されているルールの名前が、ルールをアクティブ化したファクトの名前とともに表示されます。

プッシュされたルールセット

ファクトがアサートされたときに呼び出されたルールセットの名前が表示されます。

ルールセット内の起動されたルール

ルールが実行されたルールセットの名前が表示されます。

起動されたルール

実行されたルールの名前が表示されます。

変更されたファクト

ルール実行によって変更されたファクトの名前が表示されます。この変更されたファクトは、デシジョン・サービス・コンポーネントからBPELサービスに渡されます。

ポップされたルールセット

実行が完了したため、ルールセットが実行キューから取り出されたルールセットの名前が表示されます。

注意:

呼び出されたデシジョン・サービス名のエントリは、異なるシナリオでは異なって表示されます。

- AS10.1.3.xからAS11にアップグレードされた、AssertExecuteWatchパターンを持つルール・ディクショナリでは、トレース・レポートのエントリは「呼び出されたデシジョン・サービス」として表示されます。

- AS10.1.3.xからAS11にアップグレードされた、CallFunctionパターンを持つルール・ディクショナリでは、トレース・レポートのエントリは「呼び出されたデシジョン関数」として表示されます。

- AS11で作成されたディクショナリでは、エントリは「呼び出されたデシジョン関数」として表示されます。

20.7.2 本番監査レベルでのルール実行のトレース

監査レベルを「本番」に設定すると、ルール実行トレースに関する切り詰められたレポートが提供されます。ルールセットと起動されたルールのみ表示され、ファクトに関する詳細やルールのアクティブ化などは表示されません。

本番レベルのトレースのプロセスは、開発レベルのトレースに似ています。ただし、本番レベルのトレースでは、次の操作を実行する必要があります。

Fusion Middleware Controlで、コンポジットを開いた後、「設定」メニューのコンポジットの監査レベルから「本番」を選択します。

次の図は、トレース・レポートを表示する「フローのトレース」ページを示しています。

本番レベルのトレース・レポートに、ルールセットの名前と起動されたルールのみが含まれています。また、ドリルダウン詳細トレース・レポートを表示する「監査証跡内のルール・セット・スタック状態の表示」チェック・ボックスは、本番レベルのトレース・レポートでは使用できません。

20.8 デシジョン・サービス・コンポーネントのログの監視

デシジョン・サービス・コンポーネントのログを監視できます。デシジョン・サービス・コンポーネントは、Oracle Fusion Middlewareドキュメントではビジネス・ルール・サービス・コンポーネントとも呼ばれます。

20.8.1 デシジョン・サービス・コンポーネントのログの表示

デシジョン・サービス・コンポーネントのログを表示するには、次の手順を実行します。

1. ナビゲーション・ツリーで、soa-infraを選択して右クリックします。

2. 「ログ」→「ログ・メッセージの表示」の順に選択します。「ログ・メッセージ」ページが表示されます。

「ログ・メッセージ」ページが開きます。このページを使用して、ターゲット・ログ・ファイルを選択します。

3. 各インスタンスまたはフォルトのログ・ファイルのフィルタ済リストにアクセスするには、特定のページで(たとえば、デシジョン・サービス・エンジンまたはコンポーネントのフォルト表やインスタンス表の)「ログ」列をクリックします。
たとえば、「フォルト」表で、「ログ」列をクリックします。

20.8.2 ログ構成での診断ロギング・レベルの設定

「ログ構成」ページを使用してロギング・レベルを構成します。

ログ構成を使用して診断ロギング・レベルを設定するには、次の手順を実行します。

1. 「soa-infra」を右クリックして、「ログ」→「ログ構成」の順に選択します。

2. デシジョン・サービス・コンポーネントのロギング・レベルを構成するには、「oracle.soa.service.rules」→「oracle.soa.services.rules.obrtrace」ロガーの順に開いて、通知レベルを設定します。

第VIII部

ヒューマン・タスク・サービス・コンポーネントとヒューマン・ワークフロー・サービス・エンジンの管理

この部では、ヒューマン・タスク・サービス・コンポーネントとヒューマン・ワークフロー・サービス・エンジンの管理方法について説明します。

次の章で構成されています。

- 第21章「ヒューマン・ワークフローのサービス・コンポーネントとエンジンの構成」

- 第22章「ヒューマン・ワークフローのサービス・コンポーネントとエンジンの監視」

- 第23章「ヒューマン・ワークフローのサービス・コンポーネントとエンジンの管理」

21 ヒューマン・ワークフローのサービス・コンポーネントとエンジンの構成

この章では、ヒューマン・タスク・サービス・コンポーネントとヒューマン・ワークフロー・サービス・エンジンの構成方法(メッセージやアクション可能なアドレスの通知モードの構成方法を含む)について説明します。また、アクション可能な電子メール・アカウント名などのタスク・サービス・プロパティ、およびOracle Internet Directory、Microsoft Active Directory、Oracle iPlanetなどの代替認証プロバイダの構成方法についても説明します。

この章では、次の項目について説明します。

- 第21.1項「ヒューマン・ワークフロー通知プロパティの構成」

- 第21.2項「テスト・アドレスに通知を送信する通知サービスの構成」

- 第21.3項「ヒューマン・ワークフロー・タスク・サービス・プロパティの構成」

- 第21.4項「Oracle HTTP Serverでのタスク・フォームの添付の構成」

- 第21.6項「プラガブル通知サービスの構成」

- 第21.7項「Oracle BPM Worklistタスクに対するオート・リリース・タイマーのグローバルな無効化」

- 第21.8項「電子メール通知メッセージの数の構成」

- 第21.9項「複数の送信アドレスの構成」

- 第21.10項「通知の再試行の構成」

- 第21.11項「アイデンティティ・サービスの構成」

- 第21.12項「LDAPツールを使用したユーザー、グループおよびアプリケーション・ロールのシード」

- 第21.13項「ヒューマン・タスクでの大文字/小文字を区別しないグループ名の有効化」

- 第21.14項「ヒューマン・ワークフローWebサービスのセキュリティ・ポリシーの構成」

デモ・ユーザー・コミュニティというユーザーとグループの組織階層のインストールと使用の詳細は、付録A「データベースへのデモ・ユーザー・コミュニティのインストール」を参照してください。

ヒューマン・ワークフローのチューニングとパフォーマンス・プロパティの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』を参照してください。

21.1 ヒューマン・ワークフロー通知プロパティの構成

ヒューマン・ワークフロー通知プロパティを構成できます。これには、メッセージに対する通知モードの設定やアクション可能なアドレスの設定などがあります。このプロパティは、タスクの状態の変化をユーザーに通知するために使用されます。ワークフロー通知では、次の3つのタイプのアドレスを使用できます。

- 送信元アドレス: 通知の送信用。

- アクション可能なアドレス: アクション可能なレスポンスの受信用。

- 返信先アドレス: 返信通知の受信用。

注意:

次の手順では、ワークフロー通知プロパティを構成する前に、チャネル・ドライバを構成する必要があります。手順を開始する前に、必要なすべてのドライバ(受信IMAP電子メール・サーバーや送信SMTP電子メール・サーバーなど)のアドレスを確認してください。

ヒューマン・ワークフロー通知プロパティを構成する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「SOA管理」→「ワークフロー・プロパティ」→「メーラー」タブの順に選択します。

1. 「soa-infra」を右クリックします。

2. 「SOA管理」→「ワークフロー・プロパティ」→「メーラー」タブの順に選択します。

「ワークフロー通知プロパティ」ページが表示されます。

通知を送受信するために、Oracle User Messaging Serviceを構成します。構成時に、ヒューマン・ワークフローで使用するアドレスを指定します。

2. 「「メッセージング・ドライバ」ページに移動」をクリックします。
「関連ドライバ」ページが表示されます。

3. 「ローカル」タブの「ドライバの構成」列で、構成するドライバを選択します。この例では、「ユーザー・メッセージング電子メール・ドライバ」を選択します。

すると、選択したメッセージング・サービス・ドライバを構成するためのページが表示されます。

4. 手順4で選択したメッセージング・サービス・ドライバに応じて、次の項を参照してください。

選択したドライバ

参照先

メッセージング拡張

第27.4.1.3項「メッセージング拡張ドライバの構成」

注意: このドライバは「ローカル」タブからは選択できませんが、構成可能です。

電子メール

第27.4.1.4項「電子メール・ドライバの構成」

SMPP

第27.4.1.5項「SMPPドライバの構成」

XMPP

第27.4.1.6項「XMPPドライバの構成」

VoiceXML

第27.4.1.7項「VoiceXMLドライバの構成」

ワークリスト

第27.4.1.8項「ワークリスト・ドライバの構成」

プロキシ

第27.4.1.9項「プロキシ・ドライバの構成」

たとえば、電子メール・ドライバを選択した場合は、次のようなプロパティが構成用に表示されます。

- 受信IMAPおよび送信SMTPの電子メール・サーバー。

- 送信サーバーのユーザー名およびパスワード。

- 送信者アドレスおよびデフォルト送信者アドレスのリスト。(これらのプロパティに指定するアドレスは、「ワークフロー通知プロパティ」ページの「電子メール: 送信者アドレス」と「電子メール : アクション可能なアドレス」フィールドに指定したアドレスと一致している必要があります。)

不適切な電子メールのレスポンスを処理するには、受信メールを処理するように電子メール・ドライバを構成する必要があります。これによって、ヒューマン・ワークフローの参加者は通知を送受信できます。メッセージング・ドライバは、様々なメッセージング・トランスポートをサポートしています。

注意:

- 構成する電子メール・サーバーのホスト名とIPアドレスは、Oracle SOA Suiteが稼働しているサーバーの/etc/hostsファイルにも追加する必要があります。たとえば、ホスト名がxyz.example.comで、IPアドレスがaa.bb.cc.ddの場合は、この情報を/etc/hostsファイルに追加します。

- インバウンド(IMAP)電子メール・サーバーまたはアウトバウンド(SMTP)電子メール・サーバー(あるいはその両方)を構成した後は、これらの設定を有効にするために、SOAインフラストラクチャが構成されている管理対象Oracle WebLogic Serverを再起動する必要があります。

5. ドライバの構成が完了したら、「適用」をクリックします。

6. 「ワークフロー通知プロパティ」ページに戻ります。

7. 通知サービスのモードを指定します。設定可能な値は、次のとおりです。

- すべて: 電子メール、ショート・メッセージ・サービス(SMS)、インスタント・メッセージ(IM)およびボイスの各チャネルが構成され、通知は任意の使用チャネルを介して送信されます。

- 電子メール: 通知メッセージを送信するために電子メール・チャネルのみが構成されます。

- なし: 通知メッセージ送信するためのチャネルは構成されません。これがデフォルトの設定です。

8. 通知チャネルの値を指定します。

フィールド

説明

例

電子メール: 送信者アドレス

エンド・ユーザーが通知を受信する送信電子メール・アドレスを入力します。

指定するアドレスは、Oracle User Messaging Serviceの「電子メール・ドライバ・プロパティ」ページで指定したデフォルトの送信者アドレスおよび送信者アドレスと一致する必要があります。

注意: 送信電子メール・アドレスが受信メッセージも受信するように構成されている場合は、エラー・メッセージのみ受信できます。これによって、不適切または存在しない電子メール・アドレスからのエラー・メッセージがサーバーによってキャプチャされます。「電子メール: 返信先アドレス」フィールドで別の受信アカウントを構成しても、エラー・メッセージはサーバー・ログに表示されません。

workflow.notifications@mycompany.com

電子メール : アクション可能なアドレス

タスク・アクションを実行するための受信電子メール・アドレスを入力します。このアクション可能な電子メール・アカウントは、ヒューマン・ワークフローによって受信し処理するタスク・アクション関連電子メールです。

指定するアドレスは、Oracle User Messaging Serviceの「電子メール・ドライバ・プロパティ」ページで指定したデフォルトの送信者アドレスおよび送信者アドレスと一致する必要があります。

workflow.actions@mycompany.com

電子メール: 返信先アドレス

Oracle SOA Suiteから送信された電子メールに表示するアドレスを入力します。no.reply@mycompany.comなどのダミー・アドレスか、または有効なアドレスを入力できます。有効なアドレスを入力し、このアドレスを「メッセージング・ドライバ」ページで構成していた場合、ユーザーがアクション可能な電子メールに返信すると、ヒューマン・ワークフローにより、使用方法が正しいことを示す電子メールが自動的に送信されます。これは、別の受信電子メール・アカウントです。

workflow.no.reply@mycompany.com

9. 「適用」をクリックします。

10. システムMBeanブラウザで拡張通知プロパティを構成するには、「詳細ワークフロー通知構成プロパティ」をクリックします。表示されるプロパティの一部を次に示します。各プロパティには説明が記載されています。

- 「ASNSDriverIMAddress」: 受信インスタント・メッセージ(IM)を受信するアドレス。

- 「CustomNSDriverPropertyNames」: カスタム通知サービス・プロパティ名を返します。

- 「FaxCoverPageCount」: 構成されたFAXの表紙のページ数を返します。

- 「RetryNotificationMessageThrottle」: 通知の再試行サイクル時に処理可能な電子メール通知メッセージの数。詳細は、第21.8項「電子メール通知メッセージの数の構成」を参照してください。

11. 使用環境に適した変更を行います。

注意:

IMメッセージにアクション可能と思われるコンテンツが含まれている場合、そのメッセージ内からタスクを操作しても、アクションは実行されません。たとえば、次のIMメッセージでタスクを操作しても、アクションは実行されません。

Help desk request for wfaulk  Task Help desk request for  wfaulk
requires your attention.  NOTE: You can act on the task by
copy-pasting one of following  lines as your response.

RESOLVED : [[NID]] :
Pt12uRUu9H+Xem4NYS2o7dKDtqNLs42d4YIs8ySO8Gn0ZVYFsb1SQVenRukRE+
IcE7c4XDb+tPazvP v9T2iA0qylDg0bTaVxX13HhsrCYAg= : [[NID]]
UNRESOLVED : [[NID]] :
xT9l06rbaGRAey+BtgQyJIXk62mkFtCe7ocKxwNLIsPzyE5/7AnGwXlBodEgQxr6
jorvsw2F54k/C1 r5mvyAJpAp4I4IekOHi4qhQ3eSbBHdzET1IL4F3qV/KZ/BAUsq :
[[NID]]

送信メッセージが適切な宛先に到着していることのテストを含む、ヒューマン・ワークフローにおける電子メール経由の受信および送信通知の管理の詳細は、第23.5項「送信通知および受信電子メール通知の管理」を参照してください。

通知とユーザー・メッセージング・サービスの詳細は、次のドキュメントを参照してください。

- 第X部「Oracle User Messaging Serviceの管理」

- 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のOracle User Messaging Serviceの使用に関する項

21.2 テスト・アドレスに通知を送信する通知サービスの構成

本番用のアドレスではなくテスト・アドレスにすべての通知を送信するように、Oracle Human Workflow通知サービスを構成できます。これを行うには、Oracle Enterprise ManagerのシステムMBeanブラウザを使用します。

テスト・アドレスに通知を送信するように通知サービスを構成する手順は次のとおりです。

1. Oracle Enterprise ManagerのシステムMBeanブラウザにナビゲートします。これを行うには、次の手順を実行します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「管理」→「システムMBeanブラウザ」を選択します。

1. 「soa-infra」を右クリックします。

2. 「管理」→「システムMBeanブラウザ」を選択します。

2. 「HWFMailerConfig」 Mbeanを検索します。これを行うには、「システムMBeanブラウザ」ナビゲータ・ペインで、「検索」アイコンをクリックします。「検索」リストで「MBean名」を選択し、リストの右側のテキスト・ボックスにHWFMailerConfigと入力します。「検索」矢印をクリックします。
対応する情報が右のペインに表示されます。

3. 「操作」ページを選択します。
テスト・アドレスを設定する手順は次のとおりです。

1. 「操作」ページで、「addTestNotificationAddress」を選択します。右側のペインに「操作: addTestNotificationAddress」ページが表示されます。

2. 「パラメータ」表の「チャネル」行の「値」列に、それを経由して通知を送信するチャネルを指定します(例: 電子メール、SMS、FAX、IM、ボイス、ページャ)。

3. 「パラメータ」表の「testNotificationAddress」行の「値」列に、テスト受信者のアドレス(例: testAddress@yourDomain.com)を入力します。

4. 「呼出し」をクリックします。

テスト・アドレスを削除する手順は次のとおりです。

1. 「操作」ページで、「removeTestNotificationAddress」を選択します。右側のペインに「操作: removeTestNotificationAddress」ページが表示されます。

2. 「パラメータ」表の「チャネル」行の「値」列に、削除する通知用チャネルを指定します(例: 電子メール、SMS、FAX、IM、ボイス、ページャ)。

3. 「呼出し」をクリックします。

21.3 ヒューマン・ワークフロー・タスク・サービス・プロパティの構成

アクション可能な電子メール・アカウント名の割当て、ワークフロー・セッションのタイムアウトとカスタム・クラスパスURLのプロパティ値の指定、割当てサービスの動的割当てとタスク・エスカレーション関数の構成、およびヒューマン・ワークフロー・プロパティの追加設定を実行できます。

Dynamic Assignment Functionでは、特定のユーザーまたはグループが、グループから、あるいはユーザー・リストまたはグループ・リストから選択されます。特定のDynamic Assignment Functionに固有の基準に基づいて選択されます。

ヒューマン・ワークフロー・タスク・サービス・プロパティを構成する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「SOA管理」→「ワークフロー・プロパティ」→「タスク」タブの順に選択します。

1. 「soa-infra」を右クリックします。

2. 「SOA管理」→「ワークフロー・プロパティ」→「タスク」タブの順に選択します。

「ワークフロー・タスク・サービス・プロパティ」ページの上部には、「アクション可能な電子メール・アカウント」のフィールドと自動的に定義されたDynamic Assignment Functionが表示されます。

2. 次の詳細を入力します。

関数

説明

アクション可能な電子メール・アカウント

使用するアクション可能な受信電子メール・アカウントを入力します。

デフォルトのアカウント名は、「デフォルト」で、これは、第21.1項「ヒューマン・ワークフロー通知プロパティの構成」で構成したアカウントです。別のアカウント名をこのフィールドに指定する場合は、第21.9項「複数の送信アドレスの構成」の説明に従ってアカウントを作成し、構成してください。

ワークフロー・サービス・セッション・タイムアウト

Oracle BPM Worklistにログインしたユーザーが、セッションが失効して再度ログインが必要になるまでの、非アクティブの状態でいることができる時間の長さを入力します。この値は、TaskQueryService認証方法のいずれかを使用して作成された認証セッションにも適用されます。

ワークフロー・カスタム・クラスパスURL

URLクラスパスを入力します。これは、ワークフロー・サービスが、カスタム動的割当てとタスク・エスカレーション関数、カスタム・コールバックおよびシステム・リソース・バンドルWorkflowLabels.propertiesのカスタマイズされたインスタンスを実装するクラスを参照するために使用されるクラスパスです。

クラスパスには任意の有効なURLを指定できます(ローカル・ファイル・パスまたはリモートURL)。クラスパスにはディレクトリまたはJARファイルのいずれかを指定できます。URLでディレクトリを指定する場合は、最後にスラッシュ(「/」)文字が必要です。

3. 「動的割当てとタスク・エスカレーション関数」セクションに移動します。
次の表に、Dynamic Assignment Functionの定義を示します。独自の関数を作成してワークフロー・サービスに登録することもできます。

関数

タイプ

説明

ROUND_ROBIN

動的割当て

この関数は、各ユーザーまたはグループを順に選択します。この関数では、初期化パラメータMAX_MAP_SIZEが使用されます。このパラメータは、関数がROUND_ROBINカウントを維持できる一連のユーザーまたはグループの最大数を指定します。Dynamic Assignment Functionでは、ROUND_ROBIN関数の実行を要求された各グループ(またはユーザーとグループのリスト)について、ユーザーとグループのリストがメモリーに保持されます。

LEAST_BUSY

動的割当て

この関数は、現在割り当てられているタスク数が最も少ないユーザーまたはグループを選択します。

MANAGERS_MANAGER

タスク・エスカレーション

この関数は、タスクのマネージャのマネージャを取得します。

MOST_PRODUCTIVE

動的割当て

この関数は、一定期間(デフォルトでは過去7日間)に完了したタスク数が最大のユーザー、またはグループを取得します。この関数は初期化パラメータDEFAULT_TIME_PERIODを使用します。このパラメータには、ユーザーの生産性を計算する期間(日数)を指定します。この値は、MOST_PRODUCTIVE Dynamic Assignment Functionのコール時にオーバーライドされます。XPath関数コールの第3パラメータとして代替値を指定し、XPath関数を使用します。

4. 関数をクリックして、「パラメータ」セクションに、その関数のパラメータと値を表示します。

5. 「追加」をクリックして、関数を追加します。次の項目を指定するためのプロンプトが表示されます。

- 関数名

- クラスパス

- 関数のパラメータ名

- 関数のパラメータ値

このページでは、1つの関数に複数のプロパティを追加できません。複数のプロパティを追加するには、システムMBeanブラウザを使用します。このブラウザを使用するには、「SOAインフラストラクチャ」メニューから、「管理」→「システムMBeanブラウザ」の順に選択します。

6. 「OK」をクリックします。

7. 関数のパラメータ値を更新するには、「動的割当てとタスク・エスカレーション関数」表で関数を選択します。
編集するパラメータ値が表示されます。

8. 値を更新します。

9. 「拡張」セクションを開きます。
「拡張」セクションには、次のプロパティが表示されます。

次の表に、これらのプロパティの定義を示します。

プロパティ

説明

ワークリスト・アプリケーションURL

タスクを要請する電子メールでは、Oracle BPM Worklistへのリンクが、このプロパティから読み込まれます。

この要素はURLを識別します。カスタムのOracle BPM Worklistを作成する場合は、この要素を構成すると役に立ちます。このURLにあるPC_HW_TASK_ID_TAGタグは、電子メールにURLを作成するときにタスクIDに置換されます。

割当て先のプッシュバック

タスクは、前の承認者または前の割当て先にプッシュバックできます。当初の割当て先は、タスクの再割当てやエスカレートを行っている可能性があるため、承認者である必要はありません。この要素に対する可能な値は、INITIAL_ASSIGNEESおよびAPPROVERです。

ポータル・レルム・マッピング

このプロパティは、HTTPサーブレット・リクエストのユーザーを、タスク問合せサービス・メソッドcreateContextを介して認証する際(Oracle BPM Worklistがシングル・サインオン(SSO)環境で実行されている場合など)に使用されます。HTTPサーブレット・リクエストには、リモート・ユーザーが属しているアイデンティティ・サービス・レルムに関する情報が含まれていません。このパラメータは、HTTPサーブレット・リクエスト・リモート・ユーザー内のユーザーの認証に使用するレルムを構成するために使用されます。

タスク・オート・リリース構成

タスクがグループ、アプリケーション・ロールまたは複数ユーザーに割り当てられると、ユーザーはタスクを実行する前に、そのタスクを獲得する必要があります。獲得されたタスクを他のユーザーが実行することはできません。獲得したが操作しないタスクは、最終的には自動的にリリースされ、他のユーザーが獲得できます。これによって、獲得したタスクが未実行のまま放置されることを防止します。同時に、他のユーザーによるタスクの実行を防止します。タスク・オート・リリースを使用すると、ユーザーがタスクを獲得してから、システムが自動的にそのタスクをリリースして他のユーザーに再度開放するまでの経過時間を構成できます。オート・リリースまでの経過期間は、デフォルトの経過時間として、また指定タスクの有効期間に対する割合として構成できます。オート・リリースまでの経過期間はまた、タスクの優先度に応じて様々に構成できます。

たとえば、優先度2のタスクに対するタスク・オート・リリース経過期間を50%に設定するとします。このタスクのデフォルトの経過期間は12時間です。優先度2のタスクが2日後に失効するように設定すると、このタスクは1日後(失効経過期間の50%)に自動的にリリースされます。このタスクに失効日を設定しない場合、タスクは12時間後(デフォルトのオート・リリース経過期間)に自動的にリリースされます。

10. 使用環境に適した変更を行います。

11. 「適用」をクリックします。

12. システムMBeanブラウザで拡張タスク・サービス・プロパティを構成するには、「詳細ワークフロー・タスクサービス構成プロパティ」をクリックします。表示される拡張プロパティのリストは、第21.1項「ヒューマン・ワークフロー通知プロパティの構成」の手順11を参照してください。

13. 使用環境に適した変更を行います。

タスク・サービスと割当てサービスの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

21.4 Oracle HTTP Serverでのタスク・フォームの添付の構成

Oracle HTTP Server (OHS)からタスク・フォームに添付を追加する場合は、場所として/ADFAttachmenthelperをOHS構成に含める必要があります。たとえば、instance_home/config/OHS/ohs_instanceの下にあるOHSのmod_wl_ohs.configファイルに次の内容を追加します。

<Location /ADFAttachmentHelper>
SetHandler weblogic-handler
PathTrim /weblogic
ErrorPage  http:/WEBLOGIC_HOME:WEBLOGIC_PORT/
</Location>

21.5 Oracle Human Workflow通知用のOracle Advanced Queuingの構成

Oracle Human Workflow通知用にOracle Advanced Queuingを構成するには、Oracle Enterprise Manager Fusion Middleware ControlのHWFMailer構成のマネージドBeanプロパティUseAQをTRUEに設定し、SOAサーバーを再起動します。サーバーを再起動すると、新しい通知メッセージがOracle Advanced Queuingにエンキューされます。JMSキューに保留中のメッセージは、通知再試行スレッドによってOracle Advanced Queuingにエンキューされます。

21.6 プラガブル通知サービスの構成

デフォルトの通知サービス・プロバイダのかわりに、カスタム通知サービスの実装をプラグインして使用できます。カスタム通知サービスは、すべてのチャネルまたは選択した特定のチャネルに対してプラグインできます。たとえば、この通知サービスはデフォルトのSMS通知サービスのかわりに、既存のSMS実装にプラグインできます。

21.6.1 プラガブル通知サービスの実装

通知サービスをプラグインするには、次のタスクのいずれかを実行します。

- インタフェースoracle.bpel.services.notification.ICustomNotificationServiceを実装します。

- 抽象クラスoracle.bpel.services.notification.AbstractCustomNotificationServiceImplを拡張します。

このインタフェースには、次のチャネル用のメソッドがあります。

- 電子メール

- ボイス

- SMS

- インスタント・メッセージ(IM)

プラグインした通知サービスによって、1つ以上のチャネルのデフォルト・プロバイダをオーバーライドできます。チャネルのサブセットに対するデフォルト実装が、カスタム通知サービスによってオーバーライドされているときは、他のチャネル(オーバーライドされていないチャネル)に対応するメソッドが通知サービスでコールされることはありません。これらのメソッドが返すのは、NULL値のみです。また、この実装によって、次の抽象クラスを拡張できます。

oracle.bpel.services.notification.AbstractCustomNotificationServiceImpl

このクラスは、各チャネルに対して空の実装を提供します。この場合、実装で拡張されるのは適切なチャネルのメソッドのみです。

実装とその依存クラスは、Oracle WebLogic Serverのクラスパスで使用可能であることが必要です。

21.6.2 プラガブル通知サービスの登録

実装したプラガブル通知サービスは、システムMBeanブラウザで登録します。

プラガブル通知サービスを登録する手順は、次のとおりです。

1. Oracle Enterprise Manager Fusion Middleware Controlにログインします。

2. ナビゲータで、「SOA」フォルダを開きます。

3. 「soa-infra」を右クリックし、「管理」→「システムMBeanブラウザ」の順に選択します。
システムMBeanブラウザがページの右側に表示されます。

4. 「アプリケーション定義のMBean」→「oracle.as.soainfra.config」→「サーバー: server_name」→「HWFMailerConfig」→「human-workflow」の順に開きます。

5. ページの右側で、「CustomNSDriverPropertyNames」プロパティをクリックします。

6. 「CustomNSDriverPropertyNames」に表示される、「すべて」、「ボイス」、「電子メール」、「FAX」、「ページャ」、「SMS」および「IM」プロパティの値を書き留めます。

7. 「戻る」をクリックします。

8. 「操作」タブをクリックします。

9. 「setCustomNSDriverPropertyValue」をクリックします。

10. 「propertyName」の「値」フィールドに、「CustomNSDriverPropertyNames」ページで書き留めた「すべて」、「ボイス」、「電子メール」、「FAX」、「ページャ」、「SMS」および「IM」プロパティの値のいずれかを入力します。次の詳細に注意してください。

- 電子メール・チャネルのみのデフォルト実装をオーバーライドする場合は、「propertyName」の「値」フィールドに「電子メール」の値を使用し、「propertyValue」の「値」フィールドには実施する実装の完全なクラス名を使用します。

- 他のチャネルのオーバーライドは、電子メール・チャネルの場合と同様に構成します。

- 「propertyName」の「値」フィールドに「すべて」プロパティの値を使用することは、指定の全チャネルへの実装を意味します。

11. 「propertyValue」の「値」フィールドで、実装の完全なクラス名を指定します。

12. 「呼出し」をクリックします。

13. Oracle WebLogic Serverを再起動します。

21.7 Oracle BPM Worklistタスクに対するオート・リリース・タイマーのグローバルな無効化

すべてのOracle BPM Worklistタスクに対してオート・リリース・タイマーが有効であるためにデータベースやJVMでオーバーヘッドが発生している場合は、タイマーをグローバルに無効にできます。

Oracle BPM Worklistタスクに対してオート・リリース・タイマーをグローバルに無効にする手順は、次のとおりです。

1. 「soa-infra」を右クリックし、「管理」→「システムMBeanブラウザ」の順に選択します。
システムMBeanブラウザがページの右側に表示されます。

2. 「アプリケーション定義のMBean」→「oracle.as.soainfra.config」→「サーバー: server_name」→「WorkflowConfig」→「human-workflow」→「WorkflowConfig.TaskAutoReleaseConfiguration」の順に開きます。

3. 変更するタスクの優先度を選択します。タスク・インスタンスごとに優先度があります。

- Priority[1]

- Priority[2]

- Priority[3]

- Priority[4]

- Priority[5]

4. 「属性」タブで、「DefaultDuration」をクリックします。

5. 「値」フィールドに、P0Dと入力します(0日を示します)。デフォルト値はP1D (1日)です。

6. 「適用」をクリックします。

7. オート・リリースを無効にする残りの優先度について、ステップ3から6を実行します。
完了すると、変更した優先度を指定して新規作成するタスク・インスタンスでは、オート・リリースが無効になります。

21.8 電子メール通知メッセージの数の構成

通知の再試行サイクル時に処理可能な電子メール通知メッセージの数は、システムMBeanブラウザのRetryNotificationMessageThrottleプロパティを使用して制御できます。このプロパティによって、キュー内のメッセージのオーバーロードを防ぎ、通知メッセージ・ペイロードのメモリー・サイズを縮小できます。

電子メール通知メッセージの数を構成する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「SOA管理」→「ワークフロー・プロパティ」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「SOA管理」→「ワークフロー・プロパティ」の順に選択します。

2. 「詳細ワークフロー通知構成プロパティ」をクリックします。

3. 「RetryNotificationMessageThrottle」をクリックします。

4. 「値」フィールドに値を入力します。デフォルトは200000メッセージです。

5. 「適用」をクリックします。

21.9 複数の送信アドレスの構成

一部のプロセスでは、電子メールの送信元アドレスに基づいて電子メール通知を区別することが必要な場合があります。たとえば、人事管理のBPELプロセスでは、HR@yourcompany.comと設定された送信元アドレスを使用して電子メールを送信し、財務のBPELプロセスでは、finance@yourcompany.comと設定された送信元アドレスを使用して電子メールを送信します。

複数の送信アドレスを構成する手順は、次のとおりです。

1. Oracle Enterprise Manager Fusion Middleware Controlにログインします。

2. ナビゲータで、「SOA」フォルダを開きます。

3. 「soa-infra」を右クリックし、「管理」→「システムMBeanブラウザ」の順に選択します。
システムMBeanブラウザがページの右側に表示されます。

4. 「アプリケーション定義のMBean」→「oracle.as.soainfra.config」→「サーバー: server_name」→「HWFMailerConfig」→「human-workflow」の順に開きます。

5. 「属性」タブの下にある、「ASNSDrivers」属性の値を書き留めます。デフォルトでは、「デフォルト」の値のみが使用可能です。

6. 「戻る」をクリックします。

7. 「操作」タブをクリックします。

8. 「setASNSDriver」をクリックします。

9. 「propertyName」に値(この例ではEmailFromAddress)を入力します。

10. 「propertyValue」に値(この例ではHR@yourcompany.com)を入力します。

11. 「driverName」に値(この例ではHR)を入力します。

12. 「呼出し」をクリックします。

13. 必要な送信者アドレス数と同数のアカウントを追加します。

- 「propertyName」に値(この例ではEmailFromAddress)を入力します。

- 「propertyValue」に値(この例ではfinance@yourdomain.com)を入力します。

- 「driverName」に値(この例ではFinance)を入力します。

14. 「呼出し」をクリックします。
「ASNSDriver」属性には前述の手順で作成したすべてのアカウントが表示され、「getASNSDriverAddresses」操作には各ドライバで使用されるアドレスが表示されます。詳細は、第27章「Oracle User Messaging Serviceの構成」を参照してください。

15. Oracle WebLogic Server管理コンソールを使用して、Oracle User Messaging Serviceの複数の電子メール・ドライバを送信者アドレスごとに1つずつインストールします。

16. 送信電子メールの送信用に必須の送信者アドレスを使用するように、電子メール・ドライバを構成します。

17. 設計時にOracle JDeveloperで、人事管理のBPELプロセスの電子メール・アクティビティを構成する際にアカウント名にHRを使用し、財務のBPELプロセスの電子メール・アクティビティを構成する際にアカウント名にFinanceを使用します。

21.10 通知の再試行の構成

Oracle SOA Suiteは、信頼性のある通知をサポートしています。アウトバウンド通知では、一意の通知IDを使用して通知メッセージが作成され、そのメッセージと一意のIDはデハイドレーション・ストアに格納されます。次に、この一意のIDがJMSキューにエンキューされ、トランザクションがコミットされます。このキューをリスニングしているメッセージドリブンBean (MDB)は、メッセージをデキューしてユーザーに通知を送信します。通知に失敗すると、その通知は3回再試行されます。すべての再試行に失敗すると、この通知はエラー発生としてマークされます。

21.11 アイデンティティ・サービスの構成

デフォルトでは、アイデンティティ・サービスは、Oracle WebLogic Serverの埋込みLDAPサーバーをデフォルトの認証プロバイダとして使用します。ただし、デフォルトのオーセンティケータとともに、Oracle Internet Directory、Microsoft Active DirectoryまたはOracle iPlanetなどの代替認証プロバイダを使用するようにOracle WebLogicを構成できます。

注意:

Oracle Virtual Directoryプラグインの構成と使用の詳細は、Oracle Fusion Middleware Oracle Virtual Directory管理者ガイドのOracle Virtual Directoryプラグインの理解に関する項を参照してください。

この項では、Oracle WebLogic管理コンソールまたはOracle Directory Services Managerを使用して認証プロバイダを追加し、その認証プロバイダのユーザーとグループを作成する方法を説明します。

複数のLDAP認証プロバイダの構成の詳細は、Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイドのアイデンティティ・ストア・サービスの構成に関する項を参照してください。

この項の内容は、次のとおりです。

- 第21.11.1項「認証プロバイダの追加」

- 第21.11.2項「認証プロバイダのユーザーとグループの作成」

- 第21.11.3項「ディレクトリ・サービスの構成」

デモ・ユーザー・コミュニティというユーザーとグループの組織階層のインストールと使用の詳細は、付録A「データベースへのデモ・ユーザー・コミュニティのインストール」を参照してください。

注意:

Oracle Fusion Middlewareは、ユーザーとロールのAPIを有効化してカスタム・アイデンティティ・ストアと対話するプロバイダをサポートします。

詳細は、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』の「ユーザーおよびロールAPIを使用した開発」を参照してください。

21.11.1 認証プロバイダの追加

認証プロバイダは、Oracle WebLogic Server管理コンソールを使用してセキュリティ・レルムに追加できます。

認証プロバイダを追加する手順は、次のとおりです。

1. Oracle WebLogic Server管理コンソールにログインします。

2. 「ドメイン構造」ペインで「セキュリティ・レルム」をクリックし、リスト内のレルム名(「myrealm」など)をクリックします。

3. 「プロバイダ」→「認証」の順にクリックします。
「認証プロバイダ」ページが表示されます。

4. 「新規」をクリックして、新しい認証プロバイダを追加します。
「新しい認証プロバイダの作成」ページが表示されます。

5. 「名前」フィールドにプロバイダの名前を入力し、「タイプ」ドロップダウン・リストを使用してオーセンティケータ・タイプを選択して、「OK」をクリックします。
たとえば、Oracle Internet Directoryを使用してユーザー認証する場合は、名前として「OIDAuthenticator」を入力し、タイプとして「OracleInternetDirectoryAuthenticator」を選択します。

同様に、名前を入力して、リストから「ActiveDirectoryAuthenticator」、「iPlanetAuthenticator」、「openLDAPAuthenticator」または「NovellAuthenticator」を選択すると、対応するオーセンティケータを指定できます。

注意:

Oracle Internet Directoryを認証プロバイダとして使用する場合は、Oracle Directory Services Managerを使用して、「orclsslinteropmode」属性を「0」(ゼロ)に設定する必要があります。詳細は、第21.11.3項「ディレクトリ・サービスの構成」を参照してください。

6. 「プロバイダ」→「認証」ページで、作成したオーセンティケータをクリックします。
認証プロバイダの設定が表示されます。

7. 「制御フラグ」ドロップダウン・リストから「SUFFICIENT」を選択し、「保存」をクリックします。
これによって、このオーセンティケータを使用してユーザーが正常に認証された場合、WebLogicは認証を受け入れ、追加のオーセンティケータを続けて呼び出さないことが指定されます。認証が失敗した場合、Oracle WebLogic Serverは、リストの次のオーセンティケータを使用してユーザーの認証を試行します。

「制御フラグ」を「SUFFICIENT」に設定すると、後続のすべてのオーセンティケータでも「制御フラグ」が「SUFFICIENT」に設定されます。同様に、デフォルトのオーセンティケータの「制御フラグ」も「SUFFICIENT」に設定されます。

8. 「プロバイダ固有」をクリックし、オーセンティケータ・サーバーの詳細を入力します。

9. 認証プロバイダのプロバイダ固有情報を入力し、「取得したユーザー名をプリンシパルとして使用する」チェック・ボックスを選択して、「保存」をクリックします。
次の情報を指定する必要があります。残りのフィールドはデフォルト設定を使用します。

フィールド

説明

ホスト

オーセンティケータ・サーバーが稼働しているホスト名またはIPアドレス。

ポート

オーセンティケータ・サーバーが稼働しているポート番号。

プリンシパル

サーバーへの接続時にOracle WebLogic Serverが使用するオーセンティケータ・サーバー・ユーザーの識別名(DN)。

資格証明

オーセンティケータ・サーバーへの接続に使用する資格証明(通常はパスワード)。

ユーザー・ベースDN

ユーザーが含まれているLDAPディレクトリ内のツリーのベース識別名(DN)。

グループ・ベースDN

グループが含まれているLDAPディレクトリ内のツリーのベース識別名(DN)。

取得したユーザー名をプリンシパルとして使用する

LDAPサーバーから取得したユーザー名をサブジェクトのプリンシパルとして使用するかどうかを指定します。

ユーザー名属性

ユーザー名を指定するLDAPユーザー・オブジェクト・クラスの属性(例: UID、CN、MAIL)。

注意:

「すべてのユーザーのフィルタ」、「名前指定によるユーザー・フィルタ」および「ユーザー名属性」の各フィールドには、同じユーザー名属性を使用する必要があります。

10. 「セキュリティ・レルム」→「プロバイダ」→「認証」の順にクリックして、認証プロバイダのリストに戻ります。

11. 「並べ替え」をクリックします。
「認証プロバイダの並べ替え」ページが表示されます。

12. 新しい認証プロバイダを選択し、「上へ」矢印をクリックしてリストの最上位にそのプロバイダを移動し、「OK」をクリックします。
並べ替え後は、「DefaultAuthenticator」がリストの最下位に表示されます。このアクションによって、通常LDAPディレクトリ内に存在しないが、サーバーを起動するために認証が必要なweblogicでのログインを処理できるようになります。

複数の認証プロバイダが構成されている場合、認証は、制御フラグの設定に従ってオーセンティケータのリストをフォールスルーします。ただし、Javaポートレット仕様(JPS)では、プロバイダ・リストの最初のエントリに対してのみ認可が提供されます。

21.11.1.1 ユーザー属性の更新

ログイン・ユーザー(ユーザー属性)として電子メール・アドレスを使用するように、Oracle WebLogic Server管理コンソールで認証プロバイダの設定を変更できます。次の手順を実行する必要があります。

1. Oracle WebLogic Server管理コンソールにログインします。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」を選択します。「セキュリティ・レルムのサマリー」ページが表示され、使用可能なレルムがリストされます。

3. リストで、変更するレルムの名前をクリックします。そのレルムの「設定」タブが表示されます。

4. 「プロバイダ」→「認証」を選択します。

5. 「認証」タブで、変更する認証プロバイダを選択します。その認証プロバイダの「設定」タブが表示されます。

6. 「構成」→「プロバイダ固有」の順に選択して、次のフィールドを更新します。

- すべてのユーザーのフィルタ: 値を(&(mail=)(objectclass=person)に設定します。

- 名前指定によるユーザー・フィルタ: 値を(&(mail=%u)(objectclass=person))に設定します。

- ユーザー名属性: 値をmailに設定します。

注意:

注意: 「すべてのユーザーのフィルタ」、「名前指定によるユーザー・フィルタ」および「ユーザー名属性」の各フィールドには、同じユーザー名属性を使用する必要があります。

7. 「保存」をクリックします。

21.11.2 認証プロバイダのユーザーとグループの作成

認証プロバイダのユーザーとグループは、Oracle WebLogic Server管理コンソールまたはOracle Directory Services Managerを使用して作成できます。

21.11.2.1 WebLogicコンソールを使用したユーザーとグループの作成

Oracle WebLogic Server管理コンソールを使用すると、特定のプロバイダのユーザーとグループを作成したり、ユーザーとグループのメンバーシップを定義できます。

WebLogicコンソールを使用してユーザーを作成する手順は、次のとおりです。

1. Oracle WebLogicコンソールにログインします。

2. 「ドメイン構造」ペインで「セキュリティ・レルム」をクリックし、リスト内のレルム名(「myrealm」など)をクリックします。

3. 「ユーザーとグループ」→「ユーザー」の順にクリックします。
「ユーザー」ページが表示されます。

4. 「新規」をクリックして、新しいユーザーを追加します。「新しいユーザーの作成」ページが表示されます。

5. ユーザーに関する必要な情報を入力し、「OK」をクリックします。
次の情報を指定する必要があります。

フィールド

説明

名前

(必須)新しいユーザーの名前。

説明

新しいユーザーの説明。

プロバイダ

ユーザーのプロバイダ。

パスワード

新しいユーザーのログイン名に関連付けられているパスワード。

パスワードの確認

パスワードの確認。

指定したプロバイダの新しいユーザーが作成され、「ユーザー」ページが表示されます。必要に応じて、ユーザーのグループ・メンバーシップを構成できます。

6. ユーザーのグループ・メンバーシップを指定するには、リストにある新規に作成したユーザーをクリックします。新しいユーザーの設定ページが表示されます。

7. 「グループ」をクリックして、ユーザーのグループ・メンバーシップを指定します。

8. 「使用可能」リストでグループを選択し、右矢印をクリックして「選択済み」リストに移動します。
[Ctrl]キーを押しながらグループをクリックすると、複数のグループを選択して移動できます。

9. 「保存」をクリックします。

WebLogicコンソールを使用してグループを作成する手順は、次のとおりです。

1. 「ユーザーとグループ」→「グループ」の順にクリックします。
「グループ」ページが表示されます。

2. 「新規」をクリックして、新しいグループを追加します。「新しいグループの作成」ページが表示されます。

3. グループに関する必要な情報を入力し、「OK」をクリックします。
次の情報を指定する必要があります。

フィールド

説明

名前

(必須)新しいグループの名前。

説明

新しいグループの説明。

プロバイダ

グループのプロバイダ。

指定したプロバイダの新しいグループが作成され、「グループ」ページが表示されます。必要に応じて、グループのグループ・メンバーシップを構成できます。

4. グループのグループ・メンバーシップ(親グループ)を指定するには、リストにある新規に作成したグループをクリックします。新しいグループの設定ページが表示されます。

5. 「メンバーシップ」をクリックして、グループを他のグループに追加します。

6. 「使用可能」リストで親グループを選択し、右矢印をクリックして「選択済み」リストに移動します。
[Ctrl]キーを押しながらグループをクリックすると、複数のグループを選択して移動できます。

7. 「保存」をクリックします。

21.11.2.2 Oracle Internet Directoryを使用したユーザーとグループの作成

Oracle Internet Directoryを使用するユーザーとグループは、Oracle Directory Services Managerを介して作成できます。

Oracle Directory Services ManagerからOracle Internet Directoryに接続する手順は、次のとおりです。

1. Webブラウザを使用して次のURLに移動し、Oracle Directory Services Managerを起動します。

http://host_name:port/odsm/faces/odsm.jspx

ここで、host_nameとportは、Oracle Internet Directoryが稼働しているホスト名と管理対象サーバーのポート番号です。

2. 「ディレクトリに接続」リンクをクリックし、ドロップダウン・メニューで「新規接続の作成」を選択します。「新規接続」ダイアログが表示されます。

3. ディレクトリ・タイプとして「OID」を選択し、必須フィールドに値を入力して、「接続」をクリックします。
次の情報を指定できます。

フィールド

説明

名前

接続の名前。

サーバー

(必須)Oracle Internet Directoryが稼働しているシステムのホスト名またはIPアドレス。

ポート

(必須)Oracle Internet Directoryが稼働しているシステムのポート番号。

SSL有効

Secure Sockets Layer (SSL)通信を有効にする場合に選択します。

ユーザー名

(必須)Oracle Internet Directoryへのログインに使用するユーザー名。

パスワード

(必須)ユーザー名に関連付けられているパスワード。

開始ページ

Oracle Internet Directoryへのログイン後の開始ページ。

Oracle Directory Services Managerの「ホーム」ページが表示されます。

4. 「データ・ブラウザ」タブをクリックします。このページは、エントリを作成および削除するために使用できます。

ドメインを作成する手順は、次のとおりです。

1. 「データ・ツリー」ペインで、「エントリを新規作成します。」ボタンをクリックします。「新規エントリの作成」ウィザードの「エントリ・プロパティ」ページが表示されます。

2. 「追加」ボタンをクリックし、ドメインに必要なオブジェクト・クラスを追加します。「オブジェクト・クラスの追加」ダイアログが表示されます。

3. オブジェクト・クラスの名前を入力します。適切なオブジェクト・クラスが「名前」リストに表示された場合は、そのオブジェクト・クラスを選択して「OK」をクリックします。

4. ステップ2と3を繰り返して、ドメインに必要なすべてのオブジェクト・クラスを追加します。通常、top、domainおよびorclContainerがドメインに必要なオブジェクト・クラスです。

注意:

Oracle SOA SuiteからのLDAP操作は、正しいLDAP属性に索引を作成していないと、完了するまでに長時間かかります。索引を作成するための推奨される検索可能な属性のリストは、cn、sn、givenName、uid、manager、title、mailおよびtelephoneNumberです。

5. 「参照」をクリックし、ドメインの親を選択します。「識別名(DN)パスの選択」ダイアログが表示されます。

6. ドメインの親を選択し、「選択」をクリックします。適切な親ドメインを選択することで、エントリの階層を作成できます。

7. 「新規エントリの作成」ダイアログで、「次へ」をクリックします。「新規エントリの作成」ウィザードの「必須プロパティ」ページが表示されます。

8. 必須フィールドに対する値を入力および選択し、「次へ」をクリックします。
次の情報を指定できます。

フィールド

説明

dc

(必須)ドメイン・コンポーネント。

相対識別名

(必須)ユーザーの相対識別名。

「新規エントリの作成」ウィザードの「ステータス」ページが表示されます。

9. 新規ドメインのステータスを検証し、「終了」をクリックして、新規ドメインを作成します。

ユーザーを作成する手順は、次のとおりです。

1. 「データ・ツリー」ペインで、「エントリを新規作成します。」ボタンをクリックします。「新規エントリの作成」ウィザードの「エントリ・プロパティ」ページが表示されます。

2. 「追加」ボタンをクリックし、ユーザーに必要なオブジェクト・クラスを追加します。「オブジェクト・クラスの追加」ダイアログが表示されます。

3. オブジェクト・クラスの名前を入力します。適切なオブジェクト・クラスが「名前」リストに表示された場合は、そのオブジェクト・クラスを選択して「OK」をクリックします。

4. ステップ2と3を繰り返して、ユーザーに必要なすべてのオブジェクト・クラスを追加します。通常、top、person、inetorgperson、organizationalPersonおよびorcluserがユーザーに必要なオブジェクト・クラスです。

5. 「参照」をクリックし、ユーザーの親を選択します。「識別名(DN)パスの選択」ダイアログが表示されます。

6. ユーザーの親を選択し、「選択」をクリックします。

7. 「新規エントリの作成」ダイアログで、「次へ」をクリックします。「新規エントリの作成」ウィザードの「必須プロパティ」ページが表示されます。

8. 必須フィールドに対する値を入力および選択し、「次へ」をクリックします。
次の情報を指定できます。

フィールド

説明

cn

(必須)一般名。

sn

(必須)姓。

相対識別名

(必須)ユーザーの相対識別名。

「新規エントリの作成」ウィザードの「ステータス」ページが表示されます。

9. 新規ユーザーのステータスを検証し、「終了」をクリックして、新規ユーザーを作成します。

10. 「データ・ツリー」ペインで、新規に作成したユーザーのエントリをクリックします。そのユーザーの「個人」ページが表示されます。

11. ユーザーに関する詳細を入力し、「適用」をクリックします。

グループを作成する手順は、次のとおりです。

1. 「データ・ツリー」ペインで、「エントリを新規作成します。」ボタンをクリックします。「新規エントリの作成」ウィザードの「エントリ・プロパティ」ページが表示されます。

2. 「追加」ボタンをクリックし、グループに必要なオブジェクト・クラスを追加します。「オブジェクト・クラスの追加」ダイアログが表示されます。

3. オブジェクト・クラスの名前を入力します。適切なオブジェクト・クラスが「名前」リストに表示された場合は、そのオブジェクト・クラスを選択して「OK」をクリックします。

4. ステップ2と3を繰り返して、グループに必要なすべてのオブジェクト・クラスを追加します。通常、top、groupOfUniqueNamesおよびorclGroupがグループに必要なオブジェクト・クラスです。

5. 「参照」をクリックし、グループの親を選択します。「識別名(DN)パスの選択」ダイアログが表示されます。

6. グループの親を選択し、「選択」をクリックします。

7. 「新規エントリの作成」ダイアログで、「次へ」をクリックします。「新規エントリの作成」ウィザードの「必須プロパティ」ページが表示されます。

8. 必須フィールドに対する値を入力および選択し、「次へ」をクリックします。
次の情報を指定できます。

フィールド

説明

cn

(必須)一般名。

相対識別名

(必須)グループの相対識別名。

「新規エントリの作成」ウィザードの「ステータス」ページが表示されます。

9. 新規グループのステータスを検証し、「終了」をクリックして、新規グループを作成します。

10. 「データ・ツリー」ペインで、新規に作成したグループのエントリをクリックします。そのグループの「グループ」ページが表示されます。

11. グループに関する詳細を指定し、「適用」をクリックします。

エントリを削除する手順は、次のとおりです。

1. 「データ・ツリー」ペインで、エントリを選択します。

2. 「データ・ツリー」ペインで、このエントリを削除ボタンをクリックします。

21.11.3 ディレクトリ・サービスの構成

Oracle Internet Directoryを認証プロバイダとして使用する場合は、Oracle Directory Services Managerを使用して、「orclsslinteropmode」属性を「0」(ゼロ)に設定する必要があります。

注意:

LDAPサーバーのGUID属性がバイナリ値に設定されている場合、アイデンティティ・サービスで正しく処理できないため、ユーザーとグループの両方のオブジェクト・クラスに存在し、バイナリ値を持つことができない一意の属性にマップする必要があります。たとえば、cn属性が一意の場合、これらの要件をいずれも満たしているため、使用できます。

GUIDをjps-config.xmlファイルのcnにマップします。

<property value="GUID=cn" name="PROPERTY_ATTRIBUTE_MAPPING"/>

アイデンティティ・ストア属性マッピングの詳細は、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』の「ユーザーおよびロールAPIを使用した開発」を参照してください。

ディレクトリ・サービスを構成する手順は、次のとおりです。

1. Oracle Directory Services Managerを起動し、ドロップダウン・リストを使用してOracle Internet Directory接続を選択します。

2. 「データ・ブラウザ」タブをクリックします。

3. 「cn=subconfigsubentry」→「cn=osdldapd」→「cn=oid1」の各ノードを順に開きます。

4. 「属性」ページで、「orclsslinteropmode」属性を0に設定します。

5. 「適用」ボタンをクリックします。

21.11.4 アイデンティティ・プロバイダのカスタマイズ

アイデンティティ・プロバイダをカスタマイズする(自社ソリューションに格納されているユーザーとロールを処理する)には、次のURLを参照してください。

http://www.oracle.com/technetwork/middleware/id-mgmt/overview/index.html

21.12 LDAPツールを使用したユーザー、グループおよびアプリケーション・ロールのシード

この項では、LDAPツールを使用してユーザー、グループおよびアプリケーションの各ロールをシードするために必要となる手順の概要について説明します。

タスクを作成する場合は、タスクに参加し、作業を行う参加者を割り当てます。参加者は実行時にOracle BPM Worklistからタスクに対してアクション(休暇リクエストの承認、購買オーダーの拒否、ヘルプ・デスク・リクエストへのフィードバックの提供など)を実行できます。参加者には次の3つのタイプがあります。

- ユーザー

- グループ

- アプリケーション・ロール

詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

21.12.1 組込みLDAPサーバーのデフォルト・パスワードの変更

パスワード資格証明には、Oracle WebLogic Server管理コンソールからドメインの「セキュリティ」→「組込みLDAP」の順に選択することによって、アクセスできます。

デフォルトのパスワード資格証明を変更する手順については、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』の第9章、組込みLDAPサーバーの管理に関する項を参照してください。

21.12.2 LDAPブラウザを介したユーザーまたはグループのシード

LDAPブラウザを介してユーザーまたはグループをシードするには、次の手順を実行します。

1. LDAPブラウザを起動します(例: openLdapブラウザ、ldapbrowser、jXplorerなど)。起動方法は、ブラウザのドキュメントを参照してください。

2. サーバーが実行されているホスト名とポート番号、およびログインする管理ユーザーの資格証明を指定して、LDAPサーバーに接続します。

- 組込みLDAPの場合:

1. 管理対象サーバーのデフォルトのポート番号は7001です。

2. 管理資格証明のユーザー名はcn=adminです。

3. 管理資格証明のパスワードは、第21.12.1項「組込みLDAPサーバーのデフォルト・パスワードの変更」で設定したものです。

- OIDmの場合:

1. デフォルトのポート番号は3060です。

2. 管理ユーザー名はcn=orcladminです。

3. 管理パスワードはLDAPサーバーのパスワードです。

3. ブラウザを介してユーザーまたはグループをシードするには、次の手順を実行します。

1. ユーザーまたはグループを追加する親を選択します。

2. 「編集」メニューを選択し、適切なオプションを選択して、新しいエントリを追加します。

3. エントリに必要な属性値をすべて入力します。

4. LDIFファイルを介してユーザーまたはグループをシードするには、次の手順を実行します。

1. ユーザーまたはグループをシードするドメインを選択します。

2. 「LDIF」メニューを選択し、LDIFファイルのインポートを選択します。

3. LDIFファイルのインポート・ダイアログで、LDIFファイルを参照および選択して、「インポート」をクリックします。
同様に、LDAPサーバーにシードされたユーザーまたはグループは、「LDIF」メニューから「エクスポート」オプションを選択することによって、LDIFファイルにエクスポートできます。

5. ユーザーまたはグループに属性を追加するには、次の手順を実行します。

1. 新しい属性を追加するエントリを選択します。

2. 右クリックしてオプションを選択し、新しい属性を追加します。

3. 「属性の追加」ダイアログで、属性の名前と値を指定します。
追加できるのは、LDAPサーバーのスキーマに定義されている属性のみです。

6. ユーザーまたはグループの属性を削除するには、次の手順を実行します。

1. 新しい属性を削除するエントリを選択します。

2. 属性のリストから属性を選択して削除します。

21.12.3 WLSTスクリプトを使用したアプリケーション・ロールのシード

WebLogic Scripting Tool (WLST)を使用してアプリケーション・ロールをシードする手順の詳細は、Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスの第4章「インフラストラクチャ・セキュリティ・カスタムWLSTコマンド」を参照してください。

21.12.4 Oracle Enterprise Manager Fusion Middleware Controlでのアプリケーション・ロールの管理

この項では、Oracle Enterprise Manager Fusion Middleware Controlでアプリケーション・ロールを管理する方法について説明します。

注意:

管理者以外のユーザーがOracle SOAコンポーザにアクセスできるようにするには、次の手順を実行します。このことは、「アプリケーション・ロールの編集」ページで、ユーザーまたはグループにSOADesignerロールを割り当てることによって実行します。ユーザーはOracle WebLogic Serverレルムに存在する必要があります。

Oracle Enterprise Manager Fusion Middleware Controlでアプリケーション・ロールを管理するには、次の手順を実行します。

1. ナビゲータの「WebLogicドメイン」→「Farm_Domain_name」の順に選択し、該当するOracle WebLogic Serverを選択します。

2. ドメイン名を右クリックして、「セキュリティ」→「アプリケーション・ロール」の順に選択します。

3. アプリケーション・ロールを作成するには、次の手順を実行します。

1. 「アプリケーション・ロール」ページで「作成」オプションを選択します。
「アプリケーション・ロールの作成」ページが表示されます。

2. 「アプリケーション」リストで、ロールを作成するアプリケーションの名前(server_name/soa-infra)を選択します。

3. アプリケーション・ロールのロール名、表示名および説明を入力します。

4. 「ロール」セクションで「ロールの追加」、および「ユーザー」セクションで「ユーザーの追加」を選択して、メンバーを追加します。

5. 「OK」をクリックして、アプリケーション・ロールを作成します。

4. アプリケーション・ロールを編集するには、次の手順を実行します。

1. 「アプリケーション・ロール」ページの「検索」セクションの「検索するアプリケーション名の選択」リストで、該当するアプリケーション(soa_server1/soa-infraなど)を選択します。

2. 「ロール名」リストの右側にある「検索」アイコンをクリックします。
このアクションにより、そのアプリケーションに作成されているすべてのアプリケーション・ロールが一覧表示されます。

3. 編集するアプリケーション・ロールを選択します(たとえば、SOADesignerを選択します)。

4. 「編集」をクリックします。
「アプリケーション・ロールの編集」ページが表示されます。

5. アプリケーション・ロールとグループを「ロール」セクションに追加し、ユーザーを「ユーザー」セクションに追加します(たとえば、Oracle SOAコンポーザへのアクセスを提供するユーザーにSOADesignerを割り当てます)。ユーザーはOracle WebLogic Serverレルム内に定義されている必要があります。

6. 「OK」をクリックします。

5. アプリケーション・ロールを削除するには、次の手順を実行します。

1. 「アプリケーション・ロール」ページの「検索」セクションの「検索するアプリケーション名の選択」リストで、該当するアプリケーションを選択します。

2. 「ロール名」リストの右側にある「検索」アイコンをクリックします。
このアクションにより、そのアプリケーションに作成されているすべてのアプリケーション・ロールが一覧表示されます。

3. 削除するアプリケーション・ロールを選択します。

4. 「削除」ボタンをクリックして、アプリケーション・ロールを削除します。

5. 「確認」ダイアログで「はい」をクリックします。

21.13 ヒューマン・タスクでの大文字/小文字を区別しないグループ名の有効化

デフォルトでは、ヒューマン・タスクのユーザー名のみが大文字/小文字を区別しません。この動作は、システムMBeansブラウザのユーザーに対するcaseSensitiveプロパティの値によって制御され、デフォルトでfalseに設定されています。ヒューマン・タスクのグループ名は、ユーザー・ディレクトリにシードされる名前と同じである必要があります。ただし、ヒューマン・タスクのグループ名で大文字/小文字を区別しないようにする場合、caseSensitiveGroupsプロパティをfalseに設定する必要があります。

ヒューマン・タスクのグループ名について大文字/小文字を区別する動作を有効にするには、次の手順を実行します。

1. 「soa-infra」を右クリックし、「管理」→「システムMBeanブラウザ」の順に選択します。
システムMBeanブラウザがページの右側に表示されます。

2. 「アプリケーション定義のMBean」→「oracle.as.soainfra.config」→「サーバー: server_name」→「WorkflowIdentityConfig」→「human-workflow」→「WorkflowIdentityConfig.PropertyType」→「caseSensitiveGroups」の順に開きます。

3. 「操作」タブをクリックします。

4. 「setValue」をクリックします。

5. 「値」フィールドに、falseと入力します。

6. 「呼出し」をクリックします。

21.14 ヒューマン・ワークフローWebサービスのセキュリティ・ポリシーの構成

ポリシー・セットには複数のポリシー参照を含めるできるため、ポリシー・セットを使用すると、ある範囲に含まれる同じタイプのエンドポイントに対して、ポリシーをグローバルにアタッチできます。ポリシー・セットを使用してポリシーをグローバルにアタッチすることによって、開発者、アセンブラまたはデプロイヤなどの複数のユーザーが、アタッチするポリシーを明示的に指定しなかった状況において、すべてのサブジェクトが確実に保護されるようにできます。ポリシー・セットを使用してアタッチされるポリシーは、外部的にアタッチされたと見なされます。

たとえば、開発者が注釈内にポリシーを指定しなかった場合、または、デプロイメント・ディスクリプタにポリシー参照を含めなかった場合、デプロイヤはポリシーをアタッチする必要があり、このようにしないと、潜在的なセキュリティ・リスクが発生します。タイプ別のサブジェクトのセットに対してポリシーをグローバルにアタッチすることによって、管理者はデプロイメントに関係なく(かつデプロイメント前に)、すべてのサブジェクトがデフォルトで保護されるようにできます。たとえば、管理者はあるドメイン内のすべてのWebサービス・エンドポイントに対してセキュリティ・ポリシーをアタッチするポリシー・セットを定義できます。この場合、ドメインに追加されるすべての新規サービスには、ポリシー・セットに定義されたセキュリティ構成が自動的に継承されます。

ポリシー・セットを使用してポリシーをグローバルにアタッチする方法の詳細は、『Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイド』を参照してください。

22 ヒューマン・ワークフローのサービス・コンポーネントとエンジンの監視

この章では、ヒューマン・タスク・サービス・コンポーネントとヒューマン・ワークフロー・サービス・エンジンの監視方法(ワークフロー・サービス・コンポーネントとサービス・エンジンのインスタンスとフォルトの監視、タスク・ステータスの表示、アクティブ・リクエストと操作パフォーマンス統計の監視、およびデプロイ済ヒューマン・ワークフローの監視を含む)について説明します。

この章では、次の項目について説明します。

- 第22.1項「ヒューマン・タスク・サービス・コンポーネントの最新のインスタンスとフォルトの監視」

- 第22.2項「ヒューマン・ワークフロー・タスクのステータスの表示」

- 第22.3項「ヒューマン・タスク・サービス・コンポーネントのインスタンスの監視」

- 第22.4項「ヒューマン・ワークフロー・サービス・エンジンの最新のインスタンスとフォルトの監視」

- 第22.5項「ヒューマン・ワークフロー・サービス・エンジンのアクティブ・リクエストと操作パフォーマンス統計の監視」

- 第22.6項「ヒューマン・ワークフロー・サービス・エンジンのインスタンスの監視」

- 第22.7項「サービス・エンジンにデプロイされたヒューマン・ワークフローの監視」

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

- 第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」

- 第1.2.6項「サービス・エンジンの概要」

22.1 ヒューマン・タスク・サービス・コンポーネントの最新のインスタンスとフォルトの監視

ヒューマン・タスク・サービス・コンポーネントの最新のインスタンスとフォルトを監視できます。SOAコンポジット・アプリケーションの各サービス・コンポーネントには、独自のインスタンスIDがあります。このIDは、それぞれのサービス・コンポーネントが属しているSOAコンポジット・アプリケーションの全体のインスタンスIDとは異なります。

ヒューマン・タスク・サービス・コンポーネントのインスタンスとフォルトを監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションを選択します。

2. 「コンポーネント・メトリック」表で、ヒューマン・タスク・サービス・コンポーネントを選択します。
「ダッシュボード」ページの上部には、次の詳細が表示されます。

- ヒューマン・タスク・サービス・コンポーネントの最新のインスタンス。サービス・コンポーネントのインスタンスID、インスタンスの状態(完了や実行中など)、インスタンスの開始時間、最終更新日時、およびインスタンスが記述されているログ・ファイルへのリンクが表示されます。

- ヒューマン・タスク・サービス・コンポーネントの最新のフォルト。エラー・メッセージ、フォルトがリカバリ可能かどうか、フォルトの発生時間、ヒューマン・タスク・サービス・コンポーネントのインスタンスID、およびフォルトが記述されているログ・ファイルへのリンクが表示されます。

3. 「最新のインスタンス」セクションで、次のタスクを実行します。

1. 「インスタンスID」列で、サービス・コンポーネントのインスタンスIDをクリックし、承認アクションがとられているタスクの現在のステータスを監視します。

2. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

3. セクションの下部にある「詳細を表示」をクリックし、サービス・コンポーネントの「インスタンス」ページにアクセスします。

4. 「最新のフォルト」セクションで、次のタスクを実行します。

1. 「エラー・メッセージ」列で、エラー・メッセージをクリックし、フォルトに関する完全な情報を表示します。フォルトがリカバリ可能と識別されている場合は、「ここでリカバリ」リンクをクリックし、フォルト・リカバリを実行します。

2. 「リカバリ」列で、リカバリ可能と識別されているフォルトをクリックし、コンポーネント・インスタンス・レベルでフォルト・リカバリを実行します。

3. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

4. セクションの下部にある「詳細を表示」をクリックし、サービス・コンポーネントの「フォルト」ページにアクセスします。

「ダッシュボード」ページの下部には、次の詳細が表示されます。

- ビジネス結果のグラフィカル表示

- タスクへの応答と操作に最も長い時間を要する割当て先

- 1分当たりで処理された成功したインスタンス、失敗したインスタンスおよびインスタンス化されたインスタンスの数。「表ビュー」をクリックすると、成功したインスタンスのスループット、失敗したスループットの合計およびインスタンスのスループットなど、最後の5分のスループットの詳細が表示されます。

- ヒューマン・タスク・サービス・コンポーネントでのタスクの承認に使用された通知チャネル数

詳細は、第1.2.3項「SOAコンポジット・アプリケーション・インスタンスの概要」を参照し、ログ・ファイルの表示および検索については、『Oracle Fusion Middleware管理者ガイド』を参照してください。

22.2 ヒューマン・ワークフロー・タスクのステータスの表示

参加者が操作しているヒューマン・ワークフロー・タスクの現在のステータスを監視できます。

ヒューマン・ワークフロー・タスクのステータスを表示する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションを選択します。

2. 「コンポーネント・メトリック」表で、ヒューマン・タスク・サービス・コンポーネントを選択します。
「ダッシュボード」ページが表示されます。

3. 「インスタンスID」列で、サービス・コンポーネントのインスタンスIDをクリックし、承認アクションがとられているタスクの現在のステータスを監視します。
「タスクの詳細」ページに、次の詳細が表示されます。

- 選択したサービス・コンポーネントのインスタンスID(タスク番号)に関するタスクの詳細。現在の状態(割当て済など)、タスクの結果(完了済の場合)、タスクの優先度、作成日、更新日、有効期限およびタスクの割当て先が表示されます。

- タスクの現在のステータスのフロー(割当て済や承認済など)。

このフローは、参加者がタスクを操作すると更新されます。

4. ページの右上隅にある「ワークリスト・アプリケーション」をクリックして、Oracle BPM Worklistのログイン・ページにアクセスします。

詳細は、第1.2.3項「SOAコンポジット・アプリケーション・インスタンスの概要」を参照してください。

22.3 ヒューマン・タスク・サービス・コンポーネントのインスタンスの監視

ヒューマン・タスク・サービス・コンポーネントのインスタンスを監視できます。各サービス・コンポーネントには、独自のインスタンスIDがあります。このIDは、このサービス・コンポーネントが属しているSOAコンポジット・アプリケーションの全体のインスタンスIDとは異なります。

注意:

BPELサービス・エンジンから起動されたヒューマン・ワークフローでは、BPELプロセスとは異なるトランザクションが使用されます。したがって、BPELトランザクションがなんらかの理由でロールバックされた場合でも、ワークフロー・タスクのインスタンスは作成されます。

ヒューマン・タスク・サービス・コンポーネントのインスタンスを監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションを選択します。

2. 「コンポーネント・メトリック」表で、ヒューマン・タスク・サービス・コンポーネントを選択します。

3. 「インスタンス」をクリックします。
「インスタンス」ページに、次の詳細が表示されます。

- 特定のヒューマン・タスク・サービス・コンポーネントのインスタンスを検索するためのユーティリティ。基準を指定して「検索」をクリックします。デフォルトでは、このページに初めてアクセスしたときにはインスタンスは表示されません。インスタンスを表示するには、「検索」をクリックする必要があります。

- インスタンス。サービス・コンポーネントのインスタンスID、インスタンスの状態(正常完了や失敗など)、インスタンスの開始時間、最終更新日時、およびインスタンスが記述されているログ・ファイルへのリンクが表示されます。

4. 「インスタンスID」列で、サービス・コンポーネントの特定のIDをクリックし、承認アクションがとられているタスクの現在のステータスを監視します。

5. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

詳細は、第1.2.3項「SOAコンポジット・アプリケーション・インスタンスの概要」を参照し、ログ・ファイルの表示および検索については、『Oracle Fusion Middleware管理者ガイド』を参照してください。

22.4 ヒューマン・ワークフロー・サービス・エンジンの最新のインスタンスとフォルトの監視

ヒューマン・ワークフロー・サービス・エンジンで実行しているすべてのヒューマン・タスク・サービス・コンポーネント・インスタンスのインスタンスとフォルトを監視できます。これらのヒューマン・タスク・サービス・コンポーネントは、別々のSOAコンポジット・アプリケーションに属している場合があります。

ヒューマン・ワークフロー・サービス・エンジンのインスタンスとフォルトを監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「ヒューマン・ワークフロー」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「ヒューマン・ワークフロー」の順に選択します。

2. 「ダッシュボード」をクリックします。
「ダッシュボード」ページの上部には、次の詳細が表示されます。

- ヒューマン・ワークフロー・サービス・エンジンで実行しているすべてのヒューマン・タスク・サービス・コンポーネントの最新のインスタンス。サービス・コンポーネントのインスタンスID、サービス・コンポーネント、サービス・コンポーネントが属しているSOAコンポジット・アプリケーション、インスタンスの状態(完了、実行中、失敗など)、インスタンスの開始時間および最終更新日時が表示されます。

- サービス・コンポーネント。サービス・コンポーネント名、SOAコンポジット・アプリケーション、サービス・コンポーネントの状態、およびインスタンスの合計、実行中の数、失敗した数が表示されます。

3. 「最新のインスタンス」セクションで、次のタスクを実行します。

1. 「インスタンスID」列で、サービス・コンポーネントのインスタンスIDをクリックし、承認アクションがとられているタスクの現在のステータスを監視します。

2. 「コンポーネント」列で、特定のサービス・コンポーネントをクリックし、そのホーム・ページにアクセスします。

3. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

4. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

5. セクションの下部にある「詳細を表示」をクリックし、サービス・エンジンの「インスタンス」ページにアクセスします。

4. 「コンポーネント」セクションで、次のタスクを実行します。

1. 「名前」列で、特定のサービス・コンポーネントをクリックし、そのホーム・ページにアクセスします。

2. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

3. セクションの下部にある「詳細を表示」をクリックし、サービス・エンジンの「デプロイ済コンポーネント」ページにアクセスします。

「ダッシュボード」ページの下部には、次の詳細が表示されます。

- 最新のフォルト。エラー・メッセージ、フォルトの発生時間、SOAコンポジット・アプリケーション、サービス・コンポーネント、およびサービス・コンポーネントのインスタンスIDが表示されます。

- タスクの操作に最も長い時間を要しているタスク割当て先、および応答が必要な保留中のタスクのバックログが最高のタスク割当て先が表示されます。

5. 「最新のフォルト」セクションで、次の追加タスクを実行します。

1. 「エラー・メッセージ」列で、エラー・メッセージをクリックし、フォルトに関する完全な情報を表示します。フォルトがリカバリ可能と識別されている場合は、「ここでリカバリ」リンクをクリックし、フォルト・リカバリを実行します。このリンクをクリックすると、インスタンスのヒューマン・ワークフロー監査証跡ページが起動します。監査証跡ページには、「ワークリスト・アプリケーションに移動」と呼ばれるOracle BPM Worklistへのリンクがあり、このリンクを使用すると、フォルトをリカバリするために移動できます。このリンクではフォルトに直接移動できないため、フォルトを手動で検索する必要があります。

2. 「リカバリ」列で、リカバリ可能と識別されているフォルトをクリックし、コンポーネント・インスタンス・レベルでフォルト・リカバリを実行します。

3. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

4. セクションの下部にある「詳細を表示」をクリックし、サービス・エンジンの「フォルト」ページにアクセスします。

22.5 ヒューマン・ワークフロー・サービス・エンジンのアクティブ・リクエストと操作パフォーマンス統計の監視

ヒューマン・ワークフロー・サービス・エンジン内のアクティブ・リクエストと操作統計(使用したサービス、実行した操作、アクティブ・リクエスト、完了リクエストなど)に関する詳細を表示できます。

ヒューマン・ワークフロー・サービス・エンジンのアクティブ・リクエストと操作統計を監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「ヒューマン・ワークフロー」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「ヒューマン・ワークフロー」の順に選択します。

2. 「統計」をクリックします。
「統計」ページに、次の詳細が表示されます。

- サービス・エンジン内のアクティブ・リクエスト数。このグラフは、現在のサービス・エンジンの負荷を判断するために使用します。グラフに表示されるのは、極端な負荷状態のデータのみです。これは、ほとんどのリクエストはサービス・エンジンによって即時に処理されるためです。データは、DMS(ダイナミック・モニタリング・サービス)状態センサーによって収集されます。リクエストがサービス・エンジンによって処理されると、件数はゼロになります。このアクションでは、サービス・エンジンの現在の負荷(極端に高負荷など)を確認できます。

- SOAインフラストラクチャの最後の起動時以降の、サービス・エンジンでの平均リクエスト・メッセージ処理時間。このグラフは、サービス・エンジンのパフォーマンスを確認するために使用します。処理時間は、SOAインフラストラクチャの最後の起動に基づいて計算される一方、グラフに表示されるデータは、このページに最初にアクセスした時点から収集されます。このページにアクセスしていない場合、このグラフでデータが継続的に計算されて表示されることはありません。DMSフェーズ・イベント・センサーによって平均リクエスト処理時間が計算され、その処理時間のデータが表示されます。

- サービス・エンジンで使用したヒューマン・ワークフロー・サービスに関する操作統計。使用したヒューマン・ワークフロー・サービス、そのサービスが実行した操作、アクティブ・リクエストと完了リクエストの数、件数および平均処理時間が表示されます。

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

- 第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」

- ヒューマン・ワークフロー・サービスと操作の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

- ヒューマン・ワークフローのチューニングとパフォーマンス・プロパティの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』を参照してください。

22.6 ヒューマン・ワークフロー・サービス・エンジンのインスタンスの監視

サービス・エンジンで実行しているすべてのヒューマン・タスク・サービス・コンポーネントのインスタンスを監視できます。これらのヒューマン・タスク・サービス・コンポーネントは、別々のSOAコンポジット・アプリケーションに属している場合があります。

ヒューマン・ワークフロー・サービス・エンジンのインスタンスを監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「ヒューマン・ワークフロー」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「ヒューマン・ワークフロー」の順に選択します。

2. 「インスタンス」をクリックします。
「インスタンス」ページに、次の詳細が表示されます。

- 特定のインスタンスを検索するためのユーティリティ。基準を指定して「検索」をクリックします。デフォルトでは、このページに初めてアクセスしたときにはインスタンスは表示されません。インスタンスを表示するには、「検索」をクリックする必要があります。

- インスタンス。サービス・コンポーネントのインスタンスID、サービス・コンポーネント、サービス・コンポーネントが属しているSOAコンポジット・アプリケーション、インスタンスの状態(完了、実行中、失敗など)、インスタンスの開始時間、最終更新日時、およびインスタンスが記述されているログ・ファイルへのリンクが表示されます。

3. 「インスタンス」セクションで、次の追加タスクを実行します。

1. 「インスタンスID」列で、サービス・コンポーネントのインスタンスIDをクリックし、承認アクションがとられているタスクの現在のステータスを監視します。

2. 「コンポーネント」列で、特定のサービス・コンポーネントをクリックし、そのホーム・ページにアクセスします。

3. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

4. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

詳細は、第1.2.3項「SOAコンポジット・アプリケーション・インスタンスの概要」を参照し、ログ・ファイルの表示および検索については、『Oracle Fusion Middleware管理者ガイド』を参照してください。

22.7 サービス・エンジンにデプロイされたヒューマン・ワークフローの監視

サービス・エンジンで実行しているヒューマン・タスク・サービス・コンポーネントで構成されたすべてのデプロイ済SOAコンポジット・アプリケーションを監視できます。

サービス・エンジンにデプロイされたヒューマン・ワークフローを監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「ヒューマン・ワークフロー」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「ヒューマン・ワークフロー」の順に選択します。

2. 「デプロイ済コンポーネント」をクリックします。
「デプロイ済コンポーネント」ページに、次の詳細が表示されます。

- デプロイ済の特定のSOAコンポジット・アプリケーションを検索するためのユーティリティ。フルネームを指定して「検索」をクリックします。

- サービス・エンジンで実行しているデプロイ済ヒューマン・タスク・サービス・コンポーネントの詳細。サービス・コンポーネント名、SOAコンポジット・アプリケーション、現在のステータス、およびインスタンスの合計、実行中の数、失敗した数が表示されます。

3. 「名前」列で、特定のサービス・コンポーネントをクリックし、そのホーム・ページにアクセスします。

4. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

23 ヒューマン・ワークフローのサービス・コンポーネントとエンジンの管理

この章では、ヒューマン・タスク・サービス・コンポーネントとヒューマン・ワークフロー・サービス・エンジンの管理方法(ポリシーの管理、ワークフローのフォルトのリカバリ、タスク詳細アプリケーションのURIの管理、送信および受信電子メール通知の管理、およびワークフロー・データのテスト環境から本番環境への移動を含む)について説明します。

この章では、次の項目について説明します。

- 第23.1項「ヒューマン・タスク・サービス・コンポーネントのポリシーの管理」

- 第23.2項「ヒューマン・ワークフロー・サービス・エンジンのフォルトのリカバリ」

- 第23.3項「ヒューマン・タスク・サービス・コンポーネントのタスク詳細アプリケーションのURI管理」

- 第23.4項「ヒューマン・タスク・サービス・コンポーネントのフォルトのリカバリ」

- 第23.5項「送信通知および受信電子メール通知の管理」

- 第23.6項「ヒューマン・ワークフロー・データのテスト環境から本番環境への移動」

注意:

ヒューマン・タスク・サービス・コンポーネントは、Oracle Enterprise Manager Fusion Middleware Controlではヒューマン・ワークフロー・サービス・コンポーネントとも呼ばれます。

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

- 第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」

- 第1.2.6項「サービス・エンジンの概要」

23.1 ヒューマン・タスク・サービス・コンポーネントのポリシーの管理

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

注意:

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

- ヒューマン・タスクには、SAMLポリシーoracle/wss10_saml_token_service_policyを使用してデフォルトで保護されているポートがあります。本番環境ではこのポリシーを使用しないことをお薦めします。

ヒューマン・タスク・サービス・コンポーネントのポリシーを管理する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションを選択します。

2. 「コンポーネント・メトリック」表で、ヒューマン・タスク・サービス・コンポーネントを選択します。

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

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

5. ポリシーのアタッチ先またはデタッチ先のサービスまたはコンポーネントを選択します。
ポリシーをアタッチまたはデタッチするためのダイアログが起動します。

「アタッチされたポリシー」セクションに、現在アタッチされているポリシーが表示されます。「使用可能なポリシー」セクションには、アタッチ可能な追加のポリシーが表示されます。

6. 使用環境に適したポリシーを選択してアタッチします。

7. 「アタッチ」をクリックします。

8. ポリシーのアタッチを終了した後は、「検証」をクリックします。

9. エラー・メッセージが表示された場合は、検証エラーがなくなるまで必要な修正を行います。

10. 「OK」をクリックします。
アタッチしたポリシーがポリシー表に表示されます。

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

- 第1.4.3.2項「ポリシーの概要」

- ポリシーのアタッチで表示されるダイアログについては、第7.7項「SOAコンポジット・アプリケーションのポリシーの管理」を参照してください。

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

23.2 ヒューマン・ワークフロー・サービス・エンジンのフォルトのリカバリ

ヒューマン・ワークフロー・サービス・エンジンのフォルトを表示およびリカバリできます。ヒューマン・ワークフロー・エンジンでは、すべてのヒューマン・タスク・サービス・コンポーネントのフォルトを、属しているSOAコンポジット・アプリケーション・インスタンスに関係なく表示できます。

BPELサービス・エンジンから起動されたヒューマン・ワークフローでは、BPELプロセスとは異なるトランザクションが使用されます。したがって、BPELトランザクションがなんらかの理由でロールバックされた場合でも、ワークフロー・タスクのインスタンスは作成されます。

ヒューマン・ワークフロー・サービス・エンジンのフォルトを表示およびリカバリする手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「ヒューマン・ワークフロー」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「ヒューマン・ワークフロー」の順に選択します。

2. 「フォルト」をクリックします。
「フォルト」ページに、次の詳細が表示されます。

- 特定のフォルトを検索するためのユーティリティ。基準を指定して「検索」をクリックします。詳細は、「ヘルプ」アイコンをクリックしてください。デフォルトでは、このページに初めてアクセスしたときにはフォルトは表示されません。フォルトを表示するには、「検索」をクリックする必要があります。

- ヒューマン・ワークフロー・サービス・エンジンで発生したフォルト。フォルトID、エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、フォルトが発生したSOAコンポジット・アプリケーションとヒューマン・タスク・コンポーネント、ヒューマン・タスク・サービス・コンポーネントのインスタンスID、およびフォルトが記述されているログ・ファイルへのリンクが表示されます。

リカバリが可能として識別されたヒューマン・タスク・サービス・エンジンのフォルトは、Oracle BPM Worklistからリカバリできます。

3. フォルト・リカバリを実行するには、次のいずれかの方法を使用します。

1. 「エラー・メッセージ」列で特定のメッセージをクリックして、完全なフォルト詳細(フォルトID、フォルトの発生時間、フォルトの場所、フォルト・タイプ、エラー・メッセージ・テキストなど)を表示します。フォルトがリカバリ可能な場合は、「ここでリカバリ」ボタンが表示されるため、このボタンをクリックしてフォルトをリカバリできます。このボタンをクリックすると、インスタンスのヒューマン・ワークフロー監査証跡ページが起動します。監査証跡ページには、「ワークリスト・アプリケーションに移動」と呼ばれるOracle BPM Worklistへのリンクがあり、このリンクを使用すると、フォルトをリカバリするために移動できます。Oracle BPM Worklistリンクではフォルトに直接移動できないため、フォルトを手動で検索する必要があります。

2. 「リカバリ」列で、リカバリ可能とマークされているフォルトをクリックすると、インスタンスのヒューマン・ワークフロー監査証跡ページが起動します。監査証跡ページには、「ワークリスト・アプリケーションに移動」と呼ばれる同じOracle BPM Worklistへのリンクが表示されます。

4. フォルト表内から次の追加監視タスクを実行します。

1. 「リカバリ可能なフォルトのみ表示」チェック・ボックスを選択すると、リカバリ可能なフォルトのみ表示されます。

2. 「フォルト・タイプ」リストから、すべてのフォルト、システム・フォルト、ビジネス・フォルトまたはOracle Web Services Manager (OWSM)フォルトを選択して、フォルト表に表示します。これらのフォルト・タイプの詳細は、「ヘルプ」アイコンをクリックしてください。

3. 「ビュー」リストから、「列」→「フォルトID」の順に選択し、各エラー・メッセージのフォルトIDを表示します。フォルトIDは自動的に生成され、フォルトを一意に識別します。フォルトIDは、エラー・メッセージをクリックしたときも表示されます。

4. 「コンポジット」列で、特定のSOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

5. 「コンポーネント」列で、特定のサービス・コンポーネントをクリックし、そのホーム・ページにアクセスします。

6. 「コンポーネント・インスタンスID」列で、特定のサービス・コンポーネントIDをクリックし、インスタンスに関するタスク詳細(たとえば、タスクの現在の状態)にアクセスします。拒否メッセージにはコンポーネント・インスタンスIDがありません。

7. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

23.3 ヒューマン・タスク・サービス・コンポーネントのタスク詳細アプリケーションのURI管理

ヒューマン・ワークフローで使用するタスク詳細アプリケーションのURIを追加または削除できます。

ヒューマン・タスク・サービス・コンポーネントのタスク詳細アプリケーションのURIを管理する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションを選択します。

2. 「コンポーネント・メトリック」表で、ヒューマン・タスク・サービス・コンポーネントを選択します。

3. 「管理」をクリックします。
「管理」ページに、タスク詳細アプリケーションのURIが表示されます。

注意:

SOAサーバーでSSLが有効化または無効化されている場合、すでにデプロイされているワークフロー・タスク詳細アプリケーションで、SSLを手動で有効化または無効化する必要があります。ワークフロー・タスクの表示URLを変更し、正しいプロトコルとポート番号を使用します。SSL (HTTPS) URLの使用を有効化するには、HTTPポート設定を空白のままにしてください。

4. 「追加」アイコンをクリックして、URIに次の詳細を指定します。

- アプリケーション名

- ホスト名

- HTTPポート

- HTTPSポート(オプション)

- URI

5. 「適用」をクリックします。

23.4 ヒューマン・タスク・サービス・コンポーネントのフォルトのリカバリ

ヒューマン・タスク・サービス・コンポーネントのフォルトを表示およびリカバリできます。ヒューマン・タスク・サービス・コンポーネントは、ヒューマン・ワークフロー・サービス・コンポーネントとも呼ばれます。

ヒューマン・タスク・サービス・コンポーネントのフォルトを表示およびリカバリする手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションを選択します。

2. 「コンポーネント・メトリック」表で、ヒューマン・タスク・サービス・コンポーネントを選択します。

3. 「フォルト」をクリックします。
「フォルト」ページに、次の詳細が表示されます。

- 特定のヒューマン・タスク・サービス・コンポーネント・フォルトを検索するためのユーティリティ。基準を指定して「検索」をクリックします。詳細は、「ヘルプ」アイコンをクリックしてください。デフォルトでは、このページに初めてアクセスしたときにはフォルトは表示されません。フォルトを表示するには、「検索」をクリックする必要があります。

- ヒューマン・タスク・サービス・コンポーネントで発生したフォルト。フォルトID、エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、ヒューマン・タスク・サービス・コンポーネントのインスタンスID、およびフォルトが記述されているログ・ファイルへのリンクが表示されます。

リカバリが可能として識別されたヒューマン・ワークフロー・サービス・エンジンのフォルトは、Oracle BPM Worklistからリカバリできます。

4. フォルト・リカバリを実行するには、次のいずれかの方法を使用します。

1. 「エラー・メッセージ」列で特定のメッセージをクリックして、完全なフォルト詳細(フォルトID、フォルトの発生時間、フォルトの場所、フォルト・タイプ、エラー・メッセージ・テキストなど)を表示します。フォルトがリカバリ可能な場合は、「ここでリカバリ」ボタンが表示されるため、このボタンをクリックしてフォルトをリカバリできます。このボタンをクリックすると、インスタンスのヒューマン・ワークフロー監査証跡ページが起動します。監査証跡ページには、「ワークリスト・アプリケーションに移動」と呼ばれるOracle BPM Worklistへのリンクがあり、このリンクを使用すると、フォルトをリカバリするために移動できます。Oracle BPM Worklistリンクではフォルトに直接移動できないため、フォルトを手動で検索する必要があります。

2. 「リカバリ」列で、リカバリ可能とマークされているフォルトをクリックすると、インスタンスのヒューマン・ワークフロー監査証跡ページが起動します。監査証跡ページには、「ワークリスト・アプリケーションに移動」と呼ばれる同じOracle BPM Worklistへのリンクが表示されます。

5. フォルト表内から次の追加監視タスクを実行します。

1. 「リカバリ可能なフォルトのみ表示」チェック・ボックスを選択すると、リカバリ可能なフォルトのみ表示されます。

2. 「フォルト・タイプ」リストから、すべてのフォルト、システム・フォルト、ビジネス・フォルトまたはOWSMフォルトを選択して、フォルト表に表示します。これらのフォルト・タイプの詳細は、「ヘルプ」アイコンをクリックしてください。

3. 「ビュー」リストから、「列」→「フォルトID」の順に選択し、各エラー・メッセージのフォルトIDを表示します。フォルトIDは自動的に生成され、フォルトを一意に識別します。フォルトIDは、エラー・メッセージをクリックしたときも表示されます。

4. 「コンポーネント・インスタンスID」列で、特定のサービス・コンポーネントIDをクリックし、インスタンスに関するタスク詳細(たとえば、タスクの現在の状態)にアクセスします。拒否メッセージにはコンポーネント・インスタンスIDがありません。

5. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

23.5 送信通知および受信電子メール通知の管理

ヒューマン・ワークフローでは、電子メールを介して受信通知および送信通知を管理できます。これには、メッセージのテスト、メッセージの再送信、およびメッセージをスパムとして識別することが含まれます。

受信通知と送信通知は、ヒューマン・ワークフローとの間で送受信されます。受信通知はアクション可能な通知に対するレスポンスです。たとえば、送信通知は、休暇を申請している従業員のマネージャに送信されます。マネージャは、アクション可能な通知電子メールにある「承認」リンクをクリックして、申請を承認します。このアクションによって、受信通知はヒューマン・ワークフローに送信され、他の処理が追加されます。

送信通知および受信電子メール通知を管理する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「ヒューマン・ワークフロー」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「ヒューマン・ワークフロー」の順に選択します。

2. 「通知管理」をクリックします。
「通知管理」ページの上部には、次の詳細が表示されます。

- 特定のメッセージを検索するためのユーティリティ。基準を指定して「検索」をクリックします。このユーティリティを表示するには、「検索」アイコンを開く必要があります。

- 送信通知。ソースID、ソース・タイプ(たとえば、通知がBPELサービス・コンポーネントによって送信される場合はBPEL)、使用チャネル(電子メール、SMS、インスタント・メッセンジャ、ボイスなど)、メッセージ受信者のアドレス、メッセージ・ステータス(エラー、送信、再試行、送信済など)、およびメッセージの送信日時が表示されます。

「通知管理」ページの下部には、次の詳細が表示されます。

- 特定のメッセージを検索するためのユーティリティ。基準を指定して「検索」をクリックします。このユーティリティを表示するには、「検索」アイコンを開く必要があります。

- 受信通知。メッセージID、使用チャネル(送信通知と同じタイプ)、メッセージ送信者のアドレス、メッセージ受信者のアドレス、メッセージ・ステータス(返信済の電子メール通知、未承諾の電子メール、不明な電子メール・コンテンツ、未処理のレスポンスおよび処理済のレスポンス)、メッセージのコンテンツへのリンク、およびメッセージの受信日時が表示されます。

3. 送信通知に対して次のアクションを実行します。

アクション

説明

テスト通知の送信

送信メッセージが適切な宛先に届くことをテストします。これによって、宛先がアクセス可能であり、メッセージが届くことが確認されます。このオプションを選択すると、次の宛先詳細を指定するためのダイアログが起動されます。

- 宛先アドレス

- 配信チャネル(電子メールなど)

- メッセージの件名とコンテンツ

注意: メッセージング拡張ドライバでは次の情報が必要になるため、これを使用してテスト通知メッセージを送信できません。

- テスト・ページに手動で入力する特定のデータ(タスク詳細のURIなど)

- URI固有のヘッダー(時刻、ユーザーなど)

再送信

表から特定の送信通知メッセージを選択し、「再送信」をクリックして再送信します。このオプションは、メッセージが適切な宛先に届いていないと思われる場合に使用します。たとえば、受信者アドレスが正しく構成されていない場合などです。アドレスの修正後は、「再送信」をクリックして配信をテストします。

類似した通知をすべて再送信

選択したアドレスと同じ受信者アドレスが設定されているすべてのエラー通知メッセージを再送信します。

不正アドレスの表示

不正アドレスまたは無効なアドレスのリストを表示する場合にクリックします。これらのアドレスは、1時間後に不正アドレス・リストから自動的に削除されます。1時間の待機が必要ない場合は、それらのアドレスを明示的に選択して削除できます。

「削除」アイコン

選択したメッセージを削除する場合にクリックします。

メッセージ受信者の不適切なアドレスに送信された送信通知は、「受信者」列にエラーとして表示されます。この通知は、受信者のアドレスを修正して再送信できます。

4. 「受信者」列で、電子メール・アドレスをクリックし、アドレスを修正します。

5. 受信通知に対して次のアクションを実行します。

アクション

説明

スパムとしてマーク

選択した通知のメッセージ送信者のアドレスをスパムとしてマークします。このアクションによって、同じ送信者アドレスからの受信通知は再度配信されることがなくなります。

スパムではありません

受信メッセージをスパムではないとしてマークします。このアクションによって、その送信者アドレスからの新規メッセージが再配信されます。

「削除」アイコン

選択したメッセージを削除する場合にクリックします。

通知の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

23.6 ヒューマン・ワークフロー・データのテスト環境から本番環境への移動

ヒューマン・ワークフロー・ユーザー構成データ移行ツールを使用すると、テスト環境から本番環境にヒューマン・ワークフロー・ユーザー・メタデータ(ビュー、マップ済属性(以前はフレックス・フィールドと呼ばれていました)マッピング、休暇ルールなど)を移行できます。データ移行ツールは、コマンドラインで実行可能なantターゲットとして使用できます。データ移行の入力パラメータをプロパティ・ファイルmigration.propertiesに指定します。

たとえば、次の2つのSOAサーバーがインストールされているとします。

- SOAServer_A
ヒューマン・ワークフロー・ユーザー構成可能データ(ユーザー・ビュー、標準ビュー、ユーザー・ルール、グループ・ルール、属性ラベルおよびタスク・ペイロード・マップ済属性マッピング)が含まれているテスト・サーバー。

- SOAServer_B
SOAServer_Aのデータを移動する本番サーバー

SOAServer_Aには大量のデータがあるため、すべてのデータを手動でSOAServer_Bに移行するのは時間がかかる可能性があります。データ移行ツールを使用すると、テスト・サーバーから本番サーバーにデータを移動できます。SOAServer_Aのコマンドラインでantターゲットを実行して、データをSOAServer_Bに移行します。移行は常にXMLファイルを介して実行されます。データ移行ツールでは、次の操作がサポートされます。

- エクスポート操作: すべてのヒューマン・ワークフロー・ユーザー構成可能データをソースSOAサーバーからXMLファイルに格納します。

- インポート操作: ヒューマン・ワークフロー・ユーザー構成可能データをXMLファイルから読み取ることによって、これらのすべてのデータターゲットをSOAサーバーに作成します。

データ移行ツールは、次のファイルから構成されています。

- migration.properties: 移行操作のkey-valueペアに関する必要なすべての入力プロパティが含まれています。

- build.xml: データ移行ツールを実行するantターゲットのrunHwfMigratorが含まれています。

23.6.1 ヒューマン・ワークフロー・データのテスト環境から本番環境への移動

テスト環境から本番環境にデータを移動するには、次の手順を実行します。

ヒューマン・ワークフロー・データをテスト環境から本番環境に移動するには、次の手順を実行します。

1. PATH環境変数にJAVA_HOMEおよびANT_HOME環境変数が含まれていて、Oracle SOA Suiteがインストールされている場所の配下を指していることを確認します。

2. 任意の場所にmigration.propertiesファイルを作成し、テスト環境からワークリスト・アプリケーションのユーザー・メタデータ(例: グループ・ルール、ビュー、マップ済属性マッピングおよび休暇ルール)をエクスポートします。プロパティの指定方法は、第23.6.2.1項「移行プロパティ・ファイルの例」を参照してください。
次のことに注意してください。

- マップ済属性マッピングはエクスポートできます。

- 属性ラベルはエクスポートできます。

- 一度にエクスポートできるのは、1つのタイプのデータのみです。

- 特定のユーザーまたはグループのデータをエクスポートする場合、別々の操作でエクスポートする必要があります。

- 属性ラベルは、マップ済属性マッピングをエクスポートする前にエクスポートする必要があります。
属性ラベルをエクスポートするには、migration.propertiesファイルに次の値を使用します。

objectType = TASK_PAYLOAD_FLEX_FIELD_MAPPING
migrateAttributeLabel = true

マップ済属性マッピングをエクスポートするには、migration.propertiesファイルで次の値を使用します。

objectType = TASK_PAYLOAD_FLEX_FIELD_MAPPING
migrateAttributeLabel = false

3. antスクリプトを使用して、データをエクスポートします。次の例は、コマンドを呼び出す方法とパラメータの指定方法を示しています。

ant -f ant-t2p-worklist.xml
-Dbea.home=/scratch/oracle/MW_HOME
-Dsoa.home=/scratch/oracle/MW_HOME/AS11gR1SOA
-Dmigration.properties.file=migration.properties
-Dsoa.hostname=hostname -Dsoa.rmi.port=7001
-Dsoa.admin.user=weblogic
-Drealm=jazn.com
-Dmigration.file=/tmp/export_all_userRules.xml
-Dmap.file=/tmp/export_all_userRules_mapper.xml

注意:

管理ユーザー名を指定した後に入力を求められた場合は、パスワードを入力します。

antプロパティの指定方法は、第23.6.3項「antスクリプトのデータ移行の構文」を参照してください。

4. アプリケーションが、本番システムにデプロイされたことを確認します。

注意:

タスク・マップ済属性マッピング、ルール、ビューおよび承認グループなどのヒューマン・ワークフロー・アーティファクトはネームスペースに基づいて定義されます。データ移行ツールはネームスペースに基づいてヒューマン・ワークフロー・アーティファクトを移行します。したがって、パーティションに基づいてヒューマン・ワークフロー・アーティファクトを移行することはできません。

5. migration.propertiesファイルを作成して、ワークリスト・アプリケーションのユーザー・メタデータを本番環境にインポートします。
次のことに注意してください。

- 一度にインポートできるのは、1つのタイプのデータのみです。

- 特定のユーザーまたはグループのデータをインポートする場合は、別々の操作でインポートする必要があります。

- 属性ラベルは、マップ済属性マッピングをインポートする前にインポートする必要があります。
属性ラベルをインポートするには、migration.propertiesファイルに次の値を使用します。

objectType = TASK_PAYLOAD_FLEX_FIELD_MAPPING
migrateAttributeLabel = true

マップ済属性マッピングをインポートするには、migration.propertiesファイルに次の値を使用します。

objectType = TASK_PAYLOAD_FLEX_FIELD_MAPPING
migrateAttributeLabel = false

6. ステップ3でmap.fileプロパティを使用して作成したファイルexport_all_userRules.xmlから本番環境にデータをインポートします。次の例は、コマンドを呼び出す方法とプロパティの指定方法を示しています。

ant -f ant-t2p-worklist.xml
-Dbea.home=/scratch/oracle/MW_HOME
-Dsoa.home=/scratch/oracle/MW_HOME/AS11gR1SOA
-Dmigration.properties.file=migration.properties
-Dsoa.hostname=hostname
-Dsoa.rmi.port=7001
-Dsoa.admin.user=weblogic
-Dsoa.admin.password=password
-Drealm=jazn.com
-Dmigration.file=/tmp/export_all_userRules.xml
-Dmap.file=/tmp/export_all_userRules_mapper.xml

ルール、ビューなどのデータがユーザーにアタッチされている場合、そのユーザーは本番SOAサーバーで使用可能なユーザーである必要があります。

7. .earファイルにデプロイする場合と同様に、J2EEヒューマン・タスク・フォームをデプロイします。

8. 必要に応じて、本番メール・サーバーおよびインバウンドとアウトバウンドの電子メール・アカウントのワークフロー通知構成を更新します。第21.1項「ヒューマン・ワークフロー通知プロパティの構成」を参照してください。

23.6.2 migration.propertiesファイルの構文

migration.propertiesファイルには、データ移行の入力パラメータを指定します。このファイルのテンプレートは次のディレクトリにあります。

migration.propertiesファイルには、次の入力パラメータが含まれています。

operationType = {EXPORT | IMPORT}
objectType = {VIEW | RULE | TASK_PAYLOAD_FLEX_FIELD_MAPPING}
name = name of VIEW or TASK_PAYLOAD_FLEX_FIELD_MAPPING
user = username of VIEW or RULE
group = groupname for RULE
grantPermission = {true | false}
migrateAttributeLabel = {true | false}
override = {true | false}
skip = {true | false}
migrateToActiveVersion = {true | false}

引数

定義

operationType

次のアクションのいずれかを実行することを指定します。

- EXPORT: SOAサーバー・インスタンスからXMLファイルにデータが移行されます。

- IMPORT: XMLファイルからSOAサーバー・インスタンスにデータが移行されます。

objectType

移行するオブジェクトのタイプを指定します。

- VIEW: ビューを移行します。

- RULE: 休暇ルールを移行します。

- TASK_PAYLOAD_FLEX_FIELD_MAPPING: マップ済属性マッピングを移行します。

name

objectTypeにVIEW値またはTASK_PAYLOAD_FLEX_FIELD_MAPPING値を指定した場合は、オブジェクト名を指定します。このプロパティは次の内容を意味します。

- VIEWのviewName

- TASK_PAYLOAD_FLEX_FIELD_MAPPINGのtaskDefinitionId

このタイプのすべてのオブジェクトを識別するには、ALLを指定します。

user

objectTypeプロパティにVIEW値またはRULE値を指定した場合のみ、ユーザー名を指定します。VIEWにユーザーが指定されていない場合は、STANDARD_VIEWを意味します。

group

objectTypeプロパティにRULE値を指定した場合のみ、このプロパティを指定します。これはグループ名(例: LoanAgentGroup)を識別します。

grantPermission

objectTypeプロパティにVIEW値を指定した場合のみ、このプロパティを指定します。

- true: ビュー定義と権限を移行します。

- false: ビュー定義のみを移行します。

migrateAttributeLabel

次のいずれかの値を指定します。

- true: 属性ラベルのみ移行します。ペイロード・マッピングは移行されません。

- false: 属性ラベルとペイロード・マッピングは移行されません。

override

ターゲットSOAサーバー上のデータをオーバーライドするかどうかを指定します。

- true: ターゲットSOAサーバー上の既存のワークフロー・ユーザー構成可能データをオーバーライドします。

- false: ワークフロー・ユーザー構成可能データが存在するターゲットSOAサーバー・インスタンスをオーバーライドしません。

skip

エラー処理の詳細を指定します。

- true: エラーはスキップされ、移行ユーティリティは処理を続行します。

- false: エラーが発生すると移行が中断されます。

migrateToActiveVersion

マッピング・タスク定義IDの値を指定します。

- true: タスク定義IDをターゲットSOAサーバー・インスタンスのアクション・バージョンにマップします。

- false: タスク定義をマップしません。

23.6.2.1 移行プロパティ・ファイルの例

この項では、migration.propertiesファイルを構成する方法の例を示します。

23.6.2.1.1 すべての属性ラベルのエクスポート

次の例はすべての属性ラベルをエクスポートします。

operationType = EXPORT
objectType = TASK_PAYLOAD_FLEX_FIELD_MAPPING
name = ALL
user = jcooper
group =
grantPermission = true
migrateAttributeLabel = true
override = true
skip = true
migrateToActiveVersion = true

23.6.2.1.2 すべての属性ラベルのインポート

次の例はすべての属性ラベルをインポートします。

operationType = IMPORT
objectType = TASK_PAYLOAD_FLEX_FIELD_MAPPING
name = ALL
user = jcooper
group =
grantPermission = true
migrateAttributeLabel = true
override = true
skip = true
migrateToActiveVersion = true

23.6.2.1.3 特定の属性ラベルのエクスポート

次の例は特定の属性ラベルをエクスポートします。

operationType = EXPORT
objectType = TASK_PAYLOAD_FLEX_FIELD_MAPPING
name = cb801c91-4605-4e96-a234-aeb8441f0388
user = jcooper
group =
grantPermission = true
migrateAttributeLabel = true
override = true
skip = true
migrateToActiveVersion = true

23.6.2.1.4 特定の属性ラベルのインポート

次の例は特定の属性ラベルをインポートします。

operationType = IMPORT
objectType = TASK_PAYLOAD_FLEX_FIELD_MAPPING
name = cb801c91-4605-4e96-a234-aeb8441f0388
user = jcooper
group =
grantPermission = true
migrateAttributeLabel = true
override = true
skip = true
migrateToActiveVersion = true

23.6.2.1.5 すべてのタスク定義IDのタスク・ペイロード・マップ済属性マッピングのエクスポート

次の例はすべてのタスク定義IDのタスク・ペイロード・マップ済属性マッピングをエクスポートします。

operationType = EXPORT
objectType = TASK_PAYLOAD_FLEX_FIELD_MAPPING
name = ALL
user = jcooper
group =
grantPermission = true
migrateAttributeLabel = false
override = true
skip = true
migrateToActiveVersion = true

23.6.2.1.6 すべてのタスク定義IDのタスク・ペイロード・マップ済属性マッピングのインポート

次の例はすべてのタスク定義IDのタスク・ペイロード・マップ済属性マッピングをインポートします。タスク・ペイロード・マップ済属性マッピングは属性ラベルを使用します。前提条件として、インポートするタスク・ペイロード・マップ済属性マッピングに関連する属性ラベルを見つけます。ターゲットSOAサーバーにタスク・ペイロード・マップ済属性マッピングをインポートする前に、ターゲットSOAサーバーでこれらの属性ラベルが使用可能である必要があります。

推奨される手順は次のとおりです。

- ターゲットSOAサーバーに属性ラベルをインポートします。

- ターゲットSOAサーバーにタスク・ペイロード・マップ済属性マッピングをインポートします。

operationType = IMPORT
objectType = TASK_PAYLOAD_FLEX_FIELD_MAPPING
name = ALL
user = jcooper
group =
grantPermission = true
migrateAttributeLabel = false
override = true
skip = true
migrateToActiveVersion = true

23.6.2.1.7 特定のタスク定義IDのタスク・ペイロード・マップ済属性マッピングのエクスポート

次の例は特定のタスク定義IDのタスク・ペイロード・マップ済属性マッピングをエクスポートします。

operationType = EXPORT
objectType = TASK_PAYLOAD_FLEX_FIELD_MAPPING
name = default/HelpDeskRequestComposite!1.0*c9856b8b-bc9e-46a4-8aef-698e539ba1d7/HelpDesk
RequestHumanTask
user = jcooper
group =
grantPermission = true
migrateAttributeLabel = false
override = true
skip = true
migrateToActiveVersion = true

23.6.2.1.8 特定のタスク定義IDのタスク・ペイロード・マップ済属性マッピングのインポート

次の例では、特定のタスク定義IDのタスク・ペイロード・マップ済属性マッピングをインポートします。タスク・ペイロード・マップ済属性マッピングは属性ラベルを使用します。前提条件として、インポートするタスク・ペイロード・マップ済属性マッピングに関連する属性ラベルを見つけてください。ターゲットSOAサーバーにタスク・ペイロード・マップ済属性マッピングをインポートする前に、ターゲットSOAサーバーでこれらの属性ラベルが使用可能である必要があります。

推奨される手順は次のとおりです。

- ターゲットSOAサーバーに属性ラベルをインポートします。

- ターゲットSOAサーバーにタスク・ペイロード・マップ済属性マッピングをインポートします。

operationType = IMPORT
objectType = TASK_PAYLOAD_FLEX_FIELD_MAPPING
name = default/HelpDeskRequestComposite!1.0*c9856b8b-bc9e-46a4-8aef-698e539ba1d7/HelpDesk
RequestHumanTask
user = jcooper
group =
grantPermission = true
migrateAttributeLabel = false
override = true
skip = true
migrateToActiveVersion = true

23.6.2.1.9 特定のユーザーのすべてのルールのエクスポート

この例は特定のユーザーのすべてのルールをエクスポートします。特定のユーザーのルールをエクスポートする場合、groupプロパティは空白のままになります。

operationType = EXPORT
objectType = RULE
name = ALL
user = jcooper
group =
grantPermission = true
migrateAttributeLabel = false
override = true
skip = true
migrateToActiveVersion = false

23.6.2.1.10 特定のユーザーのすべてのルールのインポート

この例では、特定のユーザーのすべてのルールをインポートします。特定のユーザーのルールをインポートする場合、groupプロパティは空白のままになります。

operationType = IMPORT
objectType = RULE
name = ALL
user = jcooper
group =
grantPermission = true
migrateAttributeLabel = false
override = true
skip = true
migrateToActiveVersion = false

23.6.2.1.11 特定のグループのすべてのルールのエクスポート

この例は特定のグループのすべてのルールをエクスポートします。特定のグループのルールをエクスポートする場合、userプロパティは空白のままになります。

operationType = EXPORT
objectType = RULE
name = ALL
user =
group = LoanAgentGroup
grantPermission = true
migrateAttributeLabel = false
override = true
skip = true
migrateToActiveVersion = false

23.6.2.1.12 特定のグループのすべてのルールのインポート

この例では、特定のグループのすべてのルールをインポートします。特定のグループのルールをインポートする場合、userプロパティは空白のままになります。

operationType = IMPORT
objectType = RULE
name = ALL
user =
group = LoanAgentGroup
grantPermission = true
migrateAttributeLabel = false
override = true
skip = true
migrateToActiveVersion = false

23.6.2.1.13 すべてのユーザー・ビューのエクスポート

この例はすべてのユーザー・ビューをエクスポートします。

operationType = EXPORT
objectType = VIEW
name = ALL
user = jcooper
group =
grantPermission = true
migrateAttributeLabel = false
override = true
skip = true
migrateToActiveVersion = false

23.6.2.1.14 すべてのユーザー・ビューのインポート

この例では、すべてのユーザー・ビューをインポートします。

operationType = IMPORT
objectType = VIEW
name = ALL
user = jcooper
group =
grantPermission = true
migrateAttributeLabel = false
override = true
skip = true
migrateToActiveVersion = false

23.6.2.1.15 特定のユーザー・ビューのエクスポート

この例は特定のユーザー・ビューをエクスポートします。

operationType = EXPORT
objectType = VIEW
name = jcooperUserView1
user = jcooper
group =
grantPermission = true
migrateAttributeLabel = false
override = true
skip = true
migrateToActiveVersion = false

23.6.2.1.16 特定のユーザー・ビューのインポート

この例では、特定のユーザー・ビューをインポートします。

operationType = IMPORT
objectType = VIEW
name = jcooperUserView1
user = jcooper
group =
grantPermission = true
migrateAttributeLabel = false
override = true
skip = true
migrateToActiveVersion = false

23.6.2.1.17 すべての標準ビューのエクスポート

この例はすべての標準ビューをエクスポートします。

operationType = EXPORT
objectType = VIEW
name = ALL
user =
group = LoanAgentGroup
grantPermission = true
migrateAttributeLabel = false
override = true
skip = true
migrateToActiveVersion = false

23.6.2.1.18 すべての標準ビューのインポート

この例では、すべての標準ビューをインポートします。

operationType = IMPORT
objectType = VIEW
name = ALL
user =
group = LoanAgentGroup
grantPermission = true
migrateAttributeLabel = false
override = true
skip = true
migrateToActiveVersion = false

23.6.2.1.19 特定の標準ビューのエクスポート

この例は特定の標準ビューをエクスポートします。

operationType = EXPORT
objectType = VIEW
name = MyStandardView1
user =
group = LoanAgentGroup
grantPermission = true
migrateAttributeLabel = false
override = true
skip = true
migrateToActiveVersion = false

23.6.2.1.20 特定の標準ビューのインポート

この例では、特定の標準ビューをインポートします。

operationType = IMPORT
objectType = VIEW
name = MyStandardView1
user =
group = LoanAgentGroup
grantPermission = true
migrateAttributeLabel = false
override = true
skip = true
migrateToActiveVersion = false

23.6.3 antスクリプトのデータ移行の構文

データの移行にantスクリプトを使用します。このスクリプトは次のディレクトリにあります。

ORACLE_HOME/bin/ant-t2p-worklist.xml

このスクリプトは次のフォーマットを使用して、ヒューマン・ワークフロー構成可能データをあるSOAサーバーから別のSOAサーバーに移行します。

ant -f ant-t2p-worklist.xml
-Dbea.home=BEA_HOME
-Dsoa.home=SOA_HOME
-Dmigration.properties.file=MIGRATION_PROPERTY_FILE_PATH
-Dsoa.hostname=SOA_HOSTNAME
-Dsoa.rmi.port=SOA_RMI_PORT
-Dsoa.admin.user=SOA_ADMIN_USER
-Dsoa.admin.password=SOA_ADMIN_PASSWORD
-Drealm=REALM -Dmigration.file=MIGRATION_FILE
-Dmigration.file=<MIGRATION_FILE>
-Dmap.file=MAP_FILE

引数

定義

bea.home

Oracle WebLogic Serverのインストール・ディレクトリの絶対パス。

soa.home

Oracle SOA Suiteのホーム・ディレクトリの絶対パス。

migration.properties.file

migration.propertiesファイルへの絶対パス。

soa.hostname

SOAサーバー・インスタンスのホスト名。

注意: myhostのような形式ではなくmyhost.us.example.comなどの完全なドメイン名を指定する必要があります。

soa.rmi.port

SOAサーバー・インスタンスのRemote Method Invocation (RMI)ポート。

soa.admin.user

SOAサーバー・インスタンスに接続するための管理ユーザー名。

soa.admin.password

SOAサーバー・インスタンスに接続するための管理ユーザーのパスワード。

realm

SOAサーバー・インスタンスのレルム。

migration.file

SOAサーバーのすべてのユーザー構成可能データがエクスポートまたはインポートされる移行ファイルの完全パス・ロケーション。

map.file

ターゲットSOAサーバーのすべてのTaskDefinitionIdマッピングが保存されているマップ・ファイルのフルパス・ロケーション。このファイルを使用すると、マッピングをカスタマイズできます。

例:

ant -f ant-t2p-worklist.xml
-Dbea.home=/net/myhost/jsmith/fmwhome
-Dsoa.home=/net/myhost/jsmith/fmwhome/AS11gR1SOA
-Dmigration.properties.file=migration.properties
-Dsoa.hostname=myhost.us.example.com -Dsoa.rmi.port=7001
-Dsoa.admin.user=weblogic
-Drealm=jazn.com
-Dmigration.file=/tmp/export_all_userRules.xml
-Dmap.file=/tmp/export_all_userRules_mapper.xml

注意:

管理ユーザー名を指定した後に入力を求められた場合は、パスワードを入力します。

第IX部

Oracle Business Activity Monitoringの管理

この部では、Oracle Business Activity Monitoringの管理方法について説明します。

次の章で構成されています。

- 第24章「Oracle Business Activity Monitoringの構成」

- 第25章「Oracle Business Activity Monitoringの監視」

- 第26章「Oracle Business Activity Monitoringの管理」

24 Oracle Business Activity Monitoringの構成

この章では、Oracle Enterprise Manager Fusion Middleware Controlを使用したOracle Business Activity Monitoring (Oracle BAM) ServerコンポーネントとOracle BAM Webアプリケーションの基本プロパティの構成方法、システムMBeanブラウザを使用した拡張プロパティの構成方法、およびOracle WebLogic Server管理コンソールを使用したOracle BAMアダプタ・プロパティとコネクション・ファクトリの構成方法について説明します。ロギングとログ・レベル、セキュリティ、アラートとレポートのディストリビューション・リスト、およびOracle BAMユーザーに電子メール通知を送信するOracle User Messaging Serviceの構成方法についても説明します。

この章では、次の項目について説明します。

- 第24.1項「Oracle BAMの構成の概要」

- 第24.2項「Oracle BAM Web基本プロパティの構成」

- 第24.3項「Oracle BAMサーバー基本プロパティの構成」

- 第24.4項「ロガーの構成」

- 第24.5項「Oracle User Messaging Serviceの構成」

- 第24.6項「Oracle BAMのディストリビューション・リストの構成」

- 第24.7項「Oracle BAMアダプタの構成」

- 第24.8項「Oracle BAMのバッチ処理プロパティの構成」

- 第24.9項「セキュリティの構成」

- 第24.10項「拡張プロパティの構成」

- 第24.11項「Oracle BAMの構成プロパティの参照」

Oracle BAMのチューニングとパフォーマンス・プロパティの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』を参照してください。

24.1 Oracle BAMの構成の概要

Oracle BAMサーバーは、Oracle BAMアクティブ・データ・キャッシュ(Oracle BAM ADC)、Oracle BAMレポート・キャッシュ、Oracle BAMエンタープライズ・メッセージ・ソース(EMS)およびOracle BAMイベント・エンジンの各コンポーネントの集合です。

Oracle BAM Webアプリケーションは、複数のシン・クライアント(アクティブ・スタジオ、アーキテクト、アドミニストレータおよびアクティブ・ビューア)とOracle BAMレポート・サーバーの集合です。

Oracle BAMサーバーおよびOracle BAM Webアプリケーションの各サブコンポーネントの詳細は、『Oracle Fusion Middleware Oracle Business Activity Monitoringユーザーズ・ガイド』を参照してください。

Oracle BAMアプリケーションは、実行時に構成プロパティ値をチェックします。それらがDEFAULTに設定されている場合、Oracle BAMはMBean Serverに問合せを行うJRF APIに問い合せることによって、すべてのパラメータの値を動的に決定します。この機能により、Oracle BAMを任意のポート番号に設定でき、構成を変更せずにそのまま作業を開始できます。デフォルトでは、すべてのパラメータはDEFAULTに設定されています。

管理者がインストール後の初期構成中に構成値を指定した場合、Oracle BAMではそれらの値を以降の処理で使用します。なんらかの理由でパラメータが存在しない場合、Oracle BAMはまずJRFでホストとポートの詳細を探します。Oracle BAMがJRFにアクセスできない場合は、ハードコードされたデフォルト値がコードから指定されます。

Oracle BAMサーバーおよびWebアプリケーションの一般的なプロパティは、Oracle Enterprise Manager Fusion Middleware Controlで構成します。詳細は、第24.3項「Oracle BAMサーバー基本プロパティの構成」および第24.2項「Oracle BAM Web基本プロパティの構成」を参照してください。

セキュリティの構成については第24.9項「セキュリティの構成」で、Oracle BAMのロール(権限)とユーザー・アカウントの追加と管理については第26.3項「Oracle BAMユーザーの管理」で説明します。

Oracle User Messaging Service (UMS)は、アラートがOracle BAMユーザーに配信されるように構成する必要があります。詳細は、第24.5項「Oracle User Messaging Serviceの構成」を参照してください。

Oracle BAMをSOAコンポジット・アプリケーションで使用する場合は、Oracle BAMアダプタの構成を完了する必要があります。詳細は、第24.7項「Oracle BAMアダプタの構成」を参照してください。

拡張プロパティは構成ファイルに格納され、システムMBeanブラウザを使用して編集できる必要があります。詳細は、第24.10項「拡張プロパティの構成」を参照してください。また、Oracle BAMの構成で使用可能なすべてのプロパティのリストは、第24.11項「Oracle BAMの構成プロパティの参照」を参照してください。

Oracle BAMのディストリビューション・リストは、個別に受信者を指定せずに、複数のOracle BAMユーザーにアラートやレポートを送信する際に使用されます。ディストリビューション・リストは、Oracle BAMアドミニストレータ・アプリケーションで構成します。詳細は、第24.6項「Oracle BAMのディストリビューション・リストの構成」を参照してください。

Oracle BAMのパフォーマンス・チューニングの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』を参照してください。

Oracle BAMの高可用性の構成情報については、『Oracle Fusion Middleware高可用性ガイド』を参照してください。

24.2 Oracle BAM Web基本プロパティの構成

Oracle BAM Webアプリケーションの基本プロパティの一部は、Oracle Enterprise Manager Fusion Middleware Controlを使用して構成します。

Oracle BAMのプロパティを変更した場合は、Oracle BAM Webアプリケーションを再起動する必要があります。Oracle BAMの再起動については、第26.2項「Oracle BAMの可用性の管理」を参照してください。

次の各項では、各プロパティの構成方法について説明します。

- 第24.2.1項「Oracle BAM Webアプリケーションのプロパティの構成」

- 第24.2.2項「アプリケーションURLの構成」

- 第24.2.3項「レポート・ロード・インジケータの構成」

- 第24.2.4項「サーバー名の構成」

拡張プロパティの構成については、第24.10項「拡張プロパティの構成」および第24.11項「Oracle BAMの構成プロパティの参照」を参照してください。

24.2.1 Oracle BAM Webアプリケーションのプロパティの構成

Oracle BAM Webアプリケーションのプロパティは、Fusion Middleware Controlの「BAM Webプロパティ」ページで構成します。

Oracle BAM Webアプリケーションのプロパティを構成する手順は、次のとおりです。

1. 「BAM」フォルダで「OracleBamWeb」ノードを選択して、Fusion Middleware Controlの「BAM Webプロパティ」ページに移動します。

2. 「BAM Web」メニューから「BAM Webプロパティ」を選択します。

「BAM Webプロパティ」ページが開きます。

3. 表示された各フィールドに適切な値を指定します。
各プロパティの構成方法については、次の各項を参照してください。

- 第24.2.2項「アプリケーションURLの構成」

- 第24.2.3項「レポート・ロード・インジケータの構成」

- 第24.2.4項「サーバー名の構成」

4. 「適用」をクリックします。
プロパティを変更した後は、Oracle BAMを再起動する必要があります。

24.2.2 アプリケーションURLの構成

レポートおよびアラート用の正しいURLを生成するには、「アプリケーションURL」プロパティの値をlocalhostから実際のホスト名に更新する必要があります。

「アプリケーションURL」プロパティは、Oracle BAMのWebアプリケーション・プロパティ・ページとOracle Bamサーバーのプロパティ・ページの両方で構成します。Oracle BAMのWebアプリケーション・ページでは、URLを使用して、レポートおよびアラート用の完全なURLが生成されます。

このプロパティは、Oracle BAM WebアプリケーションとOracle BAMサーバーの両方に共通です。このプロパティが一方のページで構成されている場合は、同じ値が他方の構成ページにも表示されます。

24.2.3 レポート・ロード・インジケータの構成

「レポート・ロード・インジケータ」プロパティは、Oracle BAMアクティブ・スタジオおよびOracle BAMアクティブ・ビューアでレポートを表示するときに、レポート・ロード・インジケータがデフォルトで有効か無効かを指定します。

このプロパティが有効な場合は、レポートが表示されるとレポート・ロード・インジケータがデフォルトで表示されます。ただし、各ユーザーは、ユーザー・プリファレンス構成でレポート・ロード・インジケータを無効にできます。詳細は、『Oracle Fusion Middleware Oracle Business Activity Monitoringユーザーズ・ガイド』を参照してください。

24.2.4 サーバー名の構成

「サーバー名」プロパティは、Oracle BAMサーバーのホスト名を指定します。Oracle BAM Webアプリケーションの個々のアプリケーションでは、Oracle BAMレポート・サーバーのアクティブ・データ・キャッシュおよびレポート・キャッシュからデータを取得するOracle BAMサーバーの場所が必要です。

24.3 Oracle BAMサーバー基本プロパティの構成

Oracle BAMサーバーの基本プロパティの一部は、Oracle Enterprise Manager Fusion Middleware Controlを使用して構成します。

Oracle BAMのプロパティを変更した後は、Oracle BAMサーバーを再起動する必要があります。Oracle BAMの再起動については、第26.2項「Oracle BAMの可用性の管理」を参照してください。

次の各項では、各プロパティの構成方法について説明します。

- 第24.3.1項「Oracle BAMサーバー・プロパティの構成」

- 第24.3.2項「データソースJNDIの構成」

- 第24.3.3項「アプリケーションURLの構成」

- 第24.3.4項「ビューセットの共有の構成」

- 第24.3.5項「レポート・キャッシュ永続性マネージャの構成」

- 第24.3.6項「Oracle Data Integratorの統合プロパティの構成」

- 第24.3.7項「電子メール・アカウントのアウトバウンドの構成」

拡張プロパティの構成については、第24.10項「拡張プロパティの構成」および第24.11項「Oracle BAMの構成プロパティの参照」を参照してください。

24.3.1 Oracle BAMサーバー・プロパティの構成

Oracle BAMサーバー・プロパティは、Oracle Enterprise Manager Fusion Middleware Controlの「BAMサーバー・プロパティ」ページで構成します。

Oracle BAMサーバー・プロパティを構成する手順は、次のとおりです。

1. Fusion Middleware Controlの「BAM」フォルダで「OracleBamServer」ノードを選択して、「BAMサーバー・プロパティ」ページに移動します。

2. 「BAMサーバー」メニューから「BAMサーバー・プロパティ」を選択します。

「BAMサーバー・プロパティ」ページが開きます。

3. 表示された各フィールドに適切な値を指定します。
各プロパティの構成方法については、次の各項を参照してください。

- 第24.3.2項「データソースJNDIの構成」

- 第24.3.3項「アプリケーションURLの構成」

- 第24.3.4項「ビューセットの共有の構成」

- 第24.3.5項「レポート・キャッシュ永続性マネージャの構成」

- 第24.3.6項「Oracle Data Integratorの統合プロパティの構成」

- 第24.3.7項「電子メール・アカウントのアウトバウンドの構成」

4. 「適用」をクリックします。
プロパティを変更した後は、Oracle BAMアプリケーションを再起動する必要があります。

24.3.2 データソースJNDIの構成

「データ・ソースJNDI」プロパティは、Oracle BAM ADCによって使用されるデータベースを指定します。Oracle BAM ADC用に作成されたデータ・ソースJNDI名を入力します。データ・ソースの構成の一般情報は、『Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理』を参照してください。

24.3.3 アプリケーションURLの構成

「アプリケーションURL」プロパティは、Oracle BAM Webアプリケーションでのみ使用されます。この構成プロパティは、Oracle BAMサーバーではすでに使用されていません。Oracle BAM Webアプリケーション用にこのプロパティを構成する方法の詳細は、第24.2.2項「アプリケーションURLの構成」を参照してください。

24.3.4 ビューセットの共有の構成

「ビューセットの共有」プロパティを使用すると、可能な場合にビュー・セットを共有できます。ビュー・セットは、指定されたOracle BAMデータ・オブジェクトへの問合せを表すオブジェクトです。ビュー・セットには、フィールド(データ・オブジェクトの列か、別のデータ・オブジェクトに対する参照)、集計、グループまたは計算のフィールドを含めることができます。また、ビュー・セットはソートおよびフィルタ処理することもでき、行レベルのセキュリティが暗黙的に適用されます。

通常、特定のビュー・セットを他のユーザーと共有できるのは、他のユーザーが同じOracle BAMダッシュボードにアクセスするときに、そのビュー・セットが、フィルタで使用する行レベルのセキュリティ、プロンプト、パラメータなどの要因のために類似している場合です。

スナップショットは、ビュー・セットで作成できる問合せ結果セットです。スナップショットは、開いた後のビュー・セットから生成できます。スナップショットの生成はパフォーマンスに大きな影響を与えます。このため、Oracle BAMサーバーでは、ビュー・セットを共有することで、特定のビューのスナップショット1つのみを使用して同じダッシュボードの複数のユーザー間でそのスナップショットを共有できます。

同じビューのユーザー間でビュー・セットを共有するとパフォーマンスが向上しますが、新しいユーザーはビュー・セットの共有を開始するときに、ビュー・セットが同期されるのを待機する必要があります。

Oracle BAMダッシュボードを開いた最初のユーザーは、新規のスナップショットを受信し(このスナップショットはキャッシュされます)、その直後にアクティブ・データをリアルタイムで受信します。アクティブ・データの変更(変更リストと呼ばれます)はキャッシュされます。

同じダッシュボードを開いた別のユーザーは、最初のユーザーに対して生成されてキャッシュされたスナップショットを受信します。次に、「アクティブ・データを同期中」というメッセージが表示され、キャッシュされた変更リストを(最初のユーザーより短い時間で)受信します。

デフォルトでは、最大50の変更リストがキャッシュされます。このため、複数のユーザーがダッシュボードを開いた場合、2番目のユーザーは、リアルタイムのアクティブ・データの受信を開始する前に、ダッシュボードへの最大50の変更リストの送信を待機する必要があります。

キャッシュする変更リストの数を少なくするには、「ElementsCountLimit」プロパティを設定します。拡張プロパティの構成については、第24.11項「Oracle BAMの構成プロパティの参照」を参照してください。

24.3.5 レポート・キャッシュ永続性マネージャの構成

「レポート・キャッシュ永続性マネージャ」プロパティは、永続性の場所(ファイル・ベースまたはメモリー・ベース)を指定します。Oracle BAMレポート・キャッシュに対して適切な永続性の場所を選択します。

24.3.6 Oracle Data Integratorの統合プロパティの構成

Oracle Data Integratorの統合プロパティは、Oracle Data IntegratorをOracle BAMサーバーに統合するための値を指定します。

次のプロパティに対して適切な値を入力します。

ODIユーザー: Oracle Data Integratorでシナリオを実行するユーザー

ODIパスワード: Oracle Data Integratorのエンコードされたパスワード

ODI作業リポジトリ名: Oracle Data Integratorの作業リポジトリ・データベースの名前

ODIエージェント・ホスト: Oracle Data Integratorエージェントが稼働しているサーバーのIPアドレスまたはホスト名

ODIエージェント・ポート: Oracle Data IntegratorエージェントがリスニングしているTransmission Control Protocol (TCP)ポート

24.3.7 電子メール・アカウントのアウトバウンドの構成

この項では、電子メール・アドレスの構成方法について説明します。このアドレスは、Oracle BAMイベント・エンジンで送信される電子メール通知の「From」ヘッダーに表示されます。

Oracle BAMサーバーの「電子メール・アカウントのアウトバウンド」プロパティは、Oracle BAMアラート通知の電子メール・メッセージおよびOracle BAMレポート・リンクの電子メール・メッセージを配信するための専用の電子メール・アカウントを指している必要があります。

第2アクションで電子メール通知を送信するように構成されたOracle BAMアラートが最初のアクションで失敗した場合、Oracle UMSがランタイム時にアクセスできる電子メール・アドレスを使用してこのプロパティを構成する必要があります。この目的のための専用の電子メール・アドレスを作成することをお薦めします。

注意:

管理者は、アラートのテストに個人の電子メール・アカウントを使用しないでください。これは、Oracle UMSでは、メール・ボックス内の電子メール通知が削除され、到着したメッセージも継続して削除されるためです。

構成を完了するには、Oracle UMSのusermessagingdriver-emailドライバを構成する必要があります。詳細は、第24.5項「Oracle User Messaging Serviceの構成」を参照してください。

Oracle BAMイベント・エンジンには、別の構成プロパティ「TimeoutPeriodToGetFailedStatusesInMins」があります。このプロパティは、イベント・エンジンが、電子メールの配信後に、Oracle UMSから失敗通知を受信したかどうかを確認するための待機時間です。このプロパティのデフォルト値は10分です。この時間内に失敗通知を受信しなかった場合、イベント・エンジンは電子メールが正常に配信されたと見なし、フェイルオーバー・アクションは破棄されます。この時間を経過した後に受信した失敗通知は、イベント・エンジンでは無視されます。TimeoutPeriodToGetFailedStatusesInMinsの構成については、第24.11項「Oracle BAMの構成プロパティの参照」を参照してください。

24.4 ロガーの構成

ロギング・レベルを構成するには、「ログ構成」ページを使用します。ログの表示の詳細は、第25.6項「Oracle BAMのログの監視」を参照してください。また、ロギングとログ・レベルの一般的な情報は、第3.4項「ログ・ファイルの構成」と『Oracle Fusion Middleware管理者ガイド』 を参照してください。

「ログ構成」ページを開くには、ナビゲーション・ツリーで「OracleBamServer」ノードまたは「OracleBamWeb」ノードを右クリックし、「ログ」→「ログ構成」の順に選択します。

各ロガーに必要な通知レベルを選択します。

24.5 Oracle User Messaging Serviceの構成

アラートの発行時に電子メール通知を送信するには、Fusion Middleware ControlでOracle User Messaging Service (UMS)を適切に構成する必要があります。

UMSの電子メール・ドライバは、拒否された電子メールも含めたすべての配信失敗について、Oracle BAMサーバー用に構成された電子メール・アカウントのアウトバウンドを監視します。電子メールの配信失敗通知は非同期です。つまり、電子メールの拒否通知の受信までに要する時間は限定されていません。

アウトバウンドの電子メール・アカウントの構成の詳細は、第24.3.7項「電子メール・アカウントのアウトバウンドの構成」を参照してください。

サービスを構成する手順は、次のとおりです。

1. Fusion Middleware Controlで、「ユーザー・メッセージング・サービス」フォルダを開き、「usermessagingdriver-email (bam_server1)」ノードを選択して、「usermessagingdriver-email」(「ユーザー・メッセージング電子メール・ドライバ」)ページに移動します。

2. 「ユーザー・メッセージング電子メール・ドライバ」ショートカット・メニューから、「電子メール・ドライバ・プロパティ」を選択します。

3. 「ドライバ固有の構成」セクションで、「IncomingMailServer」プロパティに、Internet Message Access Protocol (IMAP)サーバー名(Oracle UMSではPOP3もサポートしています)を、「IncomingUserIDs」プロパティに、電子メール・アカウント名を、「IncomingUserPasswords」プロパティに、この電子メール・アカウントにアクセスするためのパスワードをそれぞれ指定します。

詳細は、第27.4項「ユーザー・メッセージング・サービス・ドライバの構成」を参照してください。構成する必要があるプロパティに関する具体的な説明は、表27-7「カスタムの電子メール・プロパティ」に記載されています。

4. 「適用」をクリックして変更を保存します。

5. Oracle BAMサーバーの構成で、「電子メール・アカウントのアウトバウンド」プロパティに電子メール・アカウントを入力します。詳細は、第24.3.7項「電子メール・アカウントのアウトバウンドの構成」を参照してください。

24.6 Oracle BAMのディストリビューション・リストの構成

Oracle BAMのディストリビューション・リストは、個別に受信者を指定せずに、複数のOracle BAMユーザーにアラートやレポートを送信する際に使用されます。Oracle BAMのディストリビューション・リストは、Oracle BAMアドミニストレータ・アプリケーションを使用して構成します。

ディストリビューション・リストを構成する手順は、次のとおりです。

1. 「Oracle BAM開始ページ」に移動してログインし、「アドミニストレータ」を選択します。

「Oracle BAM開始ページ」の場所は次のとおりです。

http://host_name:port_number/OracleBAM/

2. リストから「ディストリビューション・リスト管理」を選択します。

3. 「作成」をクリックします。

4. 「ディストリビューション・リスト名」に一意の名前を入力し、「作成」をクリックします。

5. 「続行」をクリックして、ディストリビューション・リスト名を保存します。

6. ページの左側の「ディストリビューション・リスト」リストに表示されている新しいディストリビューション・リストを選択し、「編集」をクリックします。

7. 「メンバーの選択」リストから、ディストリビューション・リストに追加するユーザー・アカウントを選択します。
複数のユーザー名をクリックして、複数のユーザーを選択することもできます。強調表示されたユーザー名がディストリビューション・リストに追加されます。

8. 「保存」をクリックします。
ユーザーがディストリビューション・リストに追加されます。

24.7 Oracle BAMアダプタの構成

アダプタ・バッチ処理プロパティを含むOracle BAMアダプタのプロパティは、Oracle WebLogic Server管理コンソールで構成します。詳細は、第24.7.1項「Oracle BAMアダプタ・プロパティの構成」を参照してください。

Oracle BAMアダプタ(BPELプロセスのOracle BAMセンサー・アクションを含む)をSOAコンポジット・アプリケーションで使用する場合は、コネクション・ファクトリ、信頼できるドメイン、および資格証明マッピングの構成を考慮する必要があります。

Oracle BAMアダプタを使用するアプリケーションをデプロイするには、その前に、Oracle BAMサーバーへのコネクション・ファクトリを構成する必要があります。Remote Method Invocation (RMI)およびSimple Object Access Protocol (SOAP)の両方のコネクション・ファクトリを構成できます。詳細は、第24.7.2項「Oracle BAMコネクション・ファクトリの構成」を参照してください。

別のドメインにデプロイされているSOAコンポジット・アプリケーションとOracle BAM Server間でRMI接続を使用する場合は、Oracle WebLogic Server管理コンソールで信頼できるドメインの構成を行う必要があります。詳細は、第24.7.3項「信頼できるドメインの構成」を参照してください。

Oracle BAMアダプタで、プレーン・テキストのユーザー名とパスワードではなく、資格証明を使用している場合は、Oracle BAMアダプタ(BPELプロセスのOracle BAMセンサー・アクションを含む)がOracle BAMサーバーに接続できるように、資格証明も確立してマップする必要があります。詳細は、第24.7.4項「資格証明マッピングの構成」を参照してください。

oracle.bam.adapterロガーは、Oracle BAM Adapterの問題をトラブルシュートするために構成してください。ロガーの構成については、第24.4項「ロガーの構成」を参照してください。

注意:

プレーン・テキストのユーザー名とパスワードは、本番以外のモードでのみ使用します。混乱を避けるために、資格証明マッピングとプレーン・テキストのユーザー情報は一緒に使用せず、一度に一方のみ適用してください。

Oracle BAMとOracle SOAインフラストラクチャでは異なるアイデンティティ・ストアが使用されるため、共通のサービス・インフラストラクチャ・ユーザーとOracle BAMユーザーが存在しない場合、Oracle BAMユーザーは、サービス・インフラストラクチャのアイデンティティ・ストアに構成する必要があります。

Oracle BAMアダプタは、トランザクション動作をサポートしていません。このため、トランザクション・サポートを構成するためのセクションがOracle WebLogic Server管理コンソールにあっても、Oracle BAMアダプタは「トランザクションなし」レベルのままである必要があります。

24.7.1 Oracle BAMアダプタ・プロパティの構成

Oracle BAMアダプタのプロパティは、Oracle WebLogic Server管理コンソールで構成します。

Oracle BAMアダプタのプロパティを構成する手順は、次のとおりです。

1. Oracle WebLogic Server管理コンソール(http://host_name:port_number/console)に移動して、ログインします。

2. 「ドメイン構造」メニューで、「デプロイメント」を選択します。

3. 「デプロイメント」のサマリー表で、「OracleBamAdapter」を検索してクリックします。

4. 「OracleBamAdapterの設定」ページで、「構成」タブをクリックし、2行目にある「プロパティ」タブをクリックします。

5. 新しい値を入力し、更新した各値のチェック・ボックスを選択して、「保存」をクリックします。
各プロパティの詳細は、表24-1「Oracle BAMアダプタの構成プロパティ」を参照してください。

また、バッチ処理プロパティの構成に関する一般情報は、第24.8項「Oracle BAMのバッチ処理プロパティの構成」を参照してください。

注意:

デプロイ・プランへのこれらの変更をコミットするには、「変更センター」の「変更のアクティブ化」をクリックします。「変更のアクティブ化」ボタンが表示されない場合の回避策は、『Oracle Fusion Middleware Oracle Business Activity Monitoringユーザーズ・ガイド』のOracle WebLogic Server管理コンソールでのOracle BAMの問題に関する項を参照してください。

6. SOAドメイン・サーバーを再起動します。
これはOracle BAMアダプタがデプロイされる場所であるため、再起動する必要があります。

表24-1は、Oracle BAMアダプタの構成プロパティを示しています。

表24-1 Oracle BAMアダプタの構成プロパティ

RMIのプロパティ

SOAPのプロパティ

デフォルト

説明

Batch_Lower_Limit

SOAP_Batch_Lower_Limit

1000

送信前のバッチの最小要素数。

Batch_Upper_Limit

SOAP_Batch_Upper_Limit

5000

送信前のバッチの最大要素数。

Batch_Timeout

SOAP_Batch_Timeout

5000

バッチ送信後のタイムアウト(ミリ秒単位、バッチが満杯でない場合を含む)。

Block_On_Batch_Full

SOAP_Block_On_Batch_Full

false

「バッチ満杯時にブロックする」プロパティのデフォルト設定。バッチが満杯の場合に、バッチ操作をブロックするかどうかを示します。trueの場合、バッチ内の領域が操作のために解放されるまで、バッチ呼出しがブロックされます。falseの場合、BatchIsFullException例外がスローされます。

Number_Batches

SOAP_Number_Batches

10

許容される保留コールの最大数。

24.7.1.1 メッセージの送信を再試行するためのアダプタの構成

Oracle BAMサーバーを使用できないときにBPELプロセス・モニターからのメッセージが公開された場合、メッセージは維持されないため、Oracle BAMサーバーがオンラインに戻っても、Oracle BAMデータ・オブジェクトに公開されません。

第24.7.1項「Oracle BAMアダプタ・プロパティの構成」で説明しているように、Oracle BAMアダプタの構成でOracle BAMアダプタ・プロパティBlock_On_Batch_Fullにtrueを設定することによって、この動作を変更できます。

BPELプロセス・モニターの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

24.7.2 Oracle BAMコネクション・ファクトリの構成

Oracle BAMアダプタを使用するには、その前に、Oracle WebLogic Server管理コンソールで一部の構成を行う必要があります。

Oracle BAMサーバーに接続するためのOracle BAMコネクション・ファクトリを構成するには、Oracle WebLogic Server管理コンソールを使用します。

Oracle BAMコネクション・ファクトリを構成する手順は、次のとおりです。

1. Oracle WebLogic Server管理コンソール(http://host_name:port_number/console)に移動して、ログインします。

2. 「ドメイン構造」メニューで、「デプロイメント」を選択します。

3. 「デプロイメント」のサマリー表で、「OracleBamAdapter」を検索してクリックします。

4. 「oracle-bam-adapterの設定」ページで、「構成」タブをクリックし、2行目にある「アウトバウンド接続プール」タブをクリックします。

5. 適切な「グループとインスタンス」のターゲットを開いて、Java Naming and Directory Interface (JNDI)名をクリックし、Oracle JDeveloperで使用するコネクション・ファクトリ・インタフェースを構成します。

RMIベース・コールのコネクション・ファクトリを構成するには、「oracle.bam.adapter.adc.RMIConnectionFactory」グループを開き、ユーザーがOracle JDeveloperで使用するJNDI名を選択します。デフォルトでは、「eis/bam/rmi」コネクション・ファクトリが提供されます。

SOAPベース・コールのコネクション・ファクトリを構成するには、「oracle.bam.adapter.adc.SOAPConnectionFactory」グループを開き、ユーザーがOracle JDeveloperで使用するJNDI名を選択します。デフォルトでは、「eis/bam/soap」コネクション・ファクトリが提供されます。

6. 表内のセルをクリックして値を入力し、各プロパティを構成します。

注意:

表に値を入力した後、[Enter]キーを押します。

注意:

「UserName」フィールドには、アプリケーション・レベルのロールが「アドミニストレータ」または「レポート設計者」のメンバーであるOracle BAMユーザーを指定する必要があります。ユーザーのOracle BAMアプリケーション・ロールへの割当てについては、第26.3.3項「アプリケーション・ロールへのメンバーの追加」および第26.3.4項「Oracle BAMアプリケーション・ロールの概要」を参照してください。

この構成によって、HTTPを使用したコネクション・ファクトリが作成されます。HTTPSコネクション・ファクトリの構成方法は、第24.7.2.1項「Oracle BAMアダプタに対するHTTPSの構成」を参照してください。

RMIプロトコルには、異なる構成プロパティがあります。標準の接続プロパティ以外に、「InstanceName」と「IsClustered」を指定する必要があります。

7. 更新した値の横にあるチェック・ボックスを選択して、「保存」をクリックします。

注意:

デプロイ・プランへのこれらの変更をコミットするには、「変更センター」の「変更のアクティブ化」をクリックします。「変更のアクティブ化」ボタンが表示されない場合の回避策は、『Oracle Fusion Middleware Oracle Business Activity Monitoringユーザーズ・ガイド』のOracle WebLogic Server管理コンソールでのOracle BAMの問題に関する項を参照してください。

24.7.2.1 Oracle BAMアダプタに対するHTTPSの構成

HTTPSを構成する手順は、次のとおりです。

1. 第24.7項「Oracle BAMアダプタの構成」の説明に従って、Oracle WebLogic Server管理コンソールで「oracle.bam.adapter.adc.soap.SOAPConnectionFactory」コネクション・ファクトリを検索します。

2. 「oracle.bam.adapter.adc.soap.SOAPConnectionFactory」ノードをクリックして開き、「eis/bam/soap」オプションを選択して、「新規」をクリックします。

3. 「oracle.bam.adapter.adc.soap.SOAPConnectionFactory」オプションを選択し、「次へ」をクリックします。

4. このコネクション・ファクトリのJNDI名を入力し、「終了」をクリックします。

5. 「グループとインスタンス」リストから、「eis/bam/https」接続プール・インスタンスを選択します。

6. 第24.7項「Oracle BAMアダプタの構成」の説明に従って、構成プロパティを設定し、「IsHTTPSEnabledWebService」の値をtrueに変更します。

24.7.3 信頼できるドメインの構成

別のドメインにデプロイされているSOAコンポジット・アプリケーションとOracle BAM Server間でRMI接続を使用する場合は、Oracle WebLogic Server管理コンソールで信頼できるドメインの構成を行う必要があります。

信頼できるドメインを構成する手順は、次のとおりです。

1. Oracle WebLogic Server管理コンソールを使用し、SOAサーバー・ドメインとOracle BAMサーバー・ドメインの両方で「base_domain」→「セキュリティ」→「一般」の順に移動して、「拡張」設定を展開します。

2. 「資格証明」フィールドと「資格証明の確認」フィールドに、Oracle WebLogic Serverドメインの資格証明を入力します。
SOAサーバー・ドメインとOracle BAMサーバー・ドメインの両方に同じ資格証明を入力して、ドメイン間の信頼を確立します。

3. 変更を保存およびアクティブ化して、Oracle WebLogic Serverを再起動します。

信頼できるドメインの詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』のグローバル・トラストの有効化に関する項を参照してください。

24.7.4 資格証明マッピングの構成

Oracle WebLogic Serverの資格証明マッピング機能を使用して、ユーザー名とパスワードの各プロパティを安全に格納するには、Oracle BAMアダプタを構成します。

注意:

プレーン・テキストのユーザー名とパスワードは、本番以外のモードでのみ使用します。混乱を避けるために、資格証明マッピングとプレーン・テキストのユーザー情報は一緒に使用せず、一度に一方のみ適用してください。

資格証明マッピングを構成する手順は、次のとおりです。

1. Oracle WebLogic Server管理コンソールを使用して、「デプロイメント」→「OracleBamAdapter」→「セキュリティ」→「資格証明マッピング」の順に移動します。

2. 「新規」をクリックして、資格証明マッピング・エントリを作成するアウトバウンド接続プール・インスタンスを選択し、「次へ」をクリックします(デフォルトでは、Oracle BAMはeis/bam/rmiとeis/bam/soapの2つの接続プールとともにインストールされています)。

注意:

各アウトバウンド接続プールに対して個別の資格証明マッピング・エントリが作成されていることを確認してください。デフォルトのアウトバウンド接続プール以外に追加のアウトバウンド接続プールがある場合は、それに対応する資格証明マッピングを作成する必要があります。

3. 「未認証WLSユーザー」を選択し、「次へ」をクリックします(「未認証WLSユーザー」は匿名ユーザーに類似しています)。

4. Oracle BAMサーバーに接続するための対応するユーザー名とパスワードを指定し、「終了」をクリックして、資格証明マッピングの構成を完了します。

5. 他のOracle BAM接続プール・エントリがある場合は、前述の手順を繰り返して資格証明マッピングを作成します。
各アウトバウンド接続プール・エントリに対して資格証明マッピングを構成すると、それらのマッピングが「資格証明マッピング」表に表示されます。

6. これらの変更を有効にするには、Oracle WebLogic Serverを再起動する必要があります。

24.8 Oracle BAMのバッチ処理プロパティの構成

バッチ・プロセッサは、クライアントとアクティブ・データ・キャッシュ・サーバー間での操作(挿入、更新、アップサート、削除など)をバッチ処理します。これによって、リモート・コールの数が制限されるため、パフォーマンスが向上します。たとえば、バッチ処理を有効にすると10個の更新操作が1回のリモート・コールで処理できるため、リモート・コールを10回実行する必要はありません。

注意:

バッチ処理は受信データに対してのみ使用し、内部のOracle BAMプロセスには使用しないでください。

Oracle BAMアダプタの場合、バッチ処理プロパティは、Oracle WebLogic Server管理コンソールのOracle BAMアダプタの構成ページで構成します。

Oracle BAMのバッチ処理プロパティは、BAMWebConfig.xmlファイルにあり、バッチ方式を使用した、Oracle BAM Webアプリケーションからのデータ送信(つまり、Oracle BAMアーキテクトを使用したデータ送信)、およびOracle BAMのDataObjectOperation Webサービスからのデータ送信を行うバッチ処理を構成するために使用します。

Oracle BAMの構成ファイルは次のディレクトリにあります。

WL_HOME/user_projects/domains/base_domain/config/fmwconfig/servers/bam_server
1/applications/oracle-bam_11.1.1/config/

Oracle BAMのプロパティを変更した後は、Oracle BAMを再起動する必要があります。Oracle BAMの再起動については、第26.2項「Oracle BAMの可用性の管理」を参照してください。

注意:

Oracle BAM ADC APIプロパティは、すべてのOracle BAMクライアント(ICommand、Oracle Data Integratorなど)によって使用されるプロパティです。SOAPプロパティは、SOAPを使用するように構成されている場合に、Oracle BAMアダプタによってのみ使用されます。

表24-2は、Oracle BAM ADC APIおよびSOAPのバッチ処理プロパティを示しています。

表24-2 アクティブ・データ・キャッシュAPIおよびSOAP (Oracle BAMアダプタ)のバッチ処理プロパティ

Oracle BAM ADC APIのプロパティ

SOAPのプロパティ

デフォルト

説明

ActiveDataCache_Datasets_Batching_Limit_PendingCalls

Adapter_SOAP_Batching_Limit_PendingCalls

10

許容される保留コールの最大数。

ActiveDataCache_Datasets_Batching_Limit_Lower

Adapter_SOAP_Batching_Limit_Lower

1000

送信前のバッチの最小要素数。

ActiveDataCache_Datasets_Batching_Limit_Upper

Adapter_SOAP_Batching_Limit_Upper

5000

送信前のバッチの最大要素数。

ActiveDataCache_Datasets_Batching_Timeout

Adapter_SOAP_Batching_Timeout

5000

バッチ送信後のタイムアウト間隔(ミリ秒単位、バッチが満杯でない場合を含む)。

ActiveDataCache_Datasets_Batching_BlockOnBatchFull

Adapter_SOAP_Batching_BlockOnBatchFull

false

「バッチ満杯時にブロックする」プロパティは、バッチが満杯の場合に、バッチ操作をブロックするかどうかを示します。trueに設定すると、バッチ内の領域が操作のために解放されるまで、バッチ呼出しがブロックされます。falseに設定すると、BatchIsFullException例外がスローされます。

ActiveDataCache_Datasets_Batching_RetryInterval

Adapter_SOAP_Batching_RetryInterval

30000

失敗したフラッシュをバッチ処理で再試行する間隔(ミリ秒単位)。

ActiveDataCache_Datasets_Batching_MaxRetryInterval

Adapter_SOAP_Batching_MaxRetryInterval

3600000

失敗したフラッシュをバッチ処理で再試行する最大間隔(ミリ秒単位)。

ActiveDataCache_Datasets_Batching_MaximumRetries

Adapter_SOAP_Batching_MaximumRetries

Integer.MAX_VALUE

失敗したフラッシュをバッチ処理で再試行する最大回数。0(ゼロ)は再試行しないことを示します。

ActiveDataCache_Datasets_Batching_SuspendOnDisconnect

Adapter_SOAP_Batching_SuspendOnDisconnect

false

接続の切断時に一時停止します。これは、Oracle BAMサーバーへの接続が失われた場合に、バッチ処理を永続的に一時停止の状態にするかどうかを示します。

バッチ処理再試行メカニズム

バッチ処理再試行メカニズムは、ネットワーク障害やOracle BAMサーバーがオフラインになったためにサーバーとの通信が失われた場合に、そのサーバーに対してリモート・コールを再試行するように設計されています。この再試行メカニズムの操作は、この項で説明する構成プロパティによって管理します。フラッシュという用語は、処理を行うためにOracle BAM Serverへのバッチ・コールの送信を試行することを指します。

RetryIntervalプロパティは、再試行の間隔をミリ秒単位で指定します。MaxRetryInterval値が指定されていない(0)場合は、バッチ・フラッシュが成功するかMaximumRetries値を超えるまで、RetryInterval値の間隔でコードの再試行が続行されます。

MaxRetryInterval値が指定されている場合、再試行の間隔値は、そのMaxRetryInterval値に達するまで、再試行ごとに2倍になります。これは、バッチ・フラッシュが成功するかMaximumRetries値を超えるまで、MaxRetryIntervalの間隔のままです。これによって、再試行の間隔は、より適切な長期間の間隔に向けて下方修正できます。サーバーが迅速にリカバリしない場合は、短い間隔での再試行を続行しないでください。

MaximumRetries値が0の場合、再試行は実行されず、失敗したバッチは破棄されます。

SuspendOnDisconnect値がtrueの場合、すべてのバッチ処理は、Oracle BAMサーバーとの通信が再確立されているかどうかに関係なく、クライアント・アプリケーションが再起動するまで永続的に一時停止の状態になります。

保留バッチ制限に達したときに、現行バッチが満杯(最大サイズに達している)の場合は、バッチ・コールがブロックされます。現行コールからの操作をキューに入れる場所がないため、Oracle BAMは、状態が解決するまでクライアントをブロックします。

表24-2は、アクティブ・データ・キャッシュAPIのバッチ処理(第24.7.2項「Oracle BAMコネクション・ファクトリの構成」で構成したRMIコネクション・ファクトリで使用)で指定できる構成プロパティについて説明しています。

Oracle BAMアダプタのバッチ処理メカニズム(SOAPコネクション・ファクトリで使用)にも、同じ構成プロパティとデフォルト値のセットがあります。

24.9 セキュリティの構成

セキュリティはOracle WebLogic Serverで構成します。この項にリストされているトピックの詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』を参照してください。Oracle WebLogic Serverのセキュリティに関する一般情報は、『Oracle Fusion Middleware Oracle WebLogic Serverセキュリティの理解』を参照してください。

この項では、Oracle BAMに関連する次のセキュリティについて説明します。

- 第24.9.1項「資格証明マッピングの構成」

- 第24.9.2項「Oracle BAMユーザー権限の構成」

- 第24.9.3項「Secure Socket Layerの構成」

- 第24.9.4項「Oracle BAMでのOracle Internet Directoryの使用」

- 第24.9.5項「Oracle BAM JMSリソースの保護」

- 第24.9.6項「セキュアなWebサービスのコール」

24.9.1 資格証明マッピングの構成

資格証明マッピングは、Oracle BAMアダプタの使用時にユーザー名とパスワードの各プロパティを安全に格納するために使用します。詳細は、第24.7.4項「資格証明マッピングの構成」を参照してください。

24.9.2 Oracle BAMユーザー権限の構成

Oracle BAMアプリケーションへの安全なアクセスを確保するために、ユーザーには、必要な権限を提供するロールが割り当てられます。詳細は、第26.3項「Oracle BAMユーザーの管理」を参照してください。

24.9.3 Secure Socket Layerの構成

Oracle WebLogic Serverには、Oracle SOA SuiteおよびOracle WebCenterポータルをOracle WebLogic Serverに接続する際に、Secure Socket Layer (SSL)を有効にするための機能が用意されています。

キーストアと証明書の作成と管理には、Java Development Kit (JDK)のkeytoolユーティリティを使用し、Oracle WebLogic Serverのリスナーの構成には、Oracle WebLogic Server管理コンソールを使用します。

詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』のSSLの構成に関する項を参照してください。

Oracle WebLogic Serverを使用すると、Oracle BAM WebアプリケーションをSSLポートと非SSLポートの両方に構成し、Oracle BAMをSSLポートと非SSLポートの両方で実行するように構成することもできますが、このために、Oracle BAMアラート用に構成したURLで問題が発生します。SSLポートと非SSLポートの両方で実行中のOracle BAMは、2つのOracle BAMレポートURLをアラートの電子メール受信者に送信できません。したがって、管理者は、Oracle BAMレポートURLの受信者に対して使用するアクセスのモード(SSLまたは非SSL)を決定する必要があります。

Oracle BAMをSSLモードで起動し、Oracle BAMクライアント(ICommandなど)がOracle BAM ADCを起動し、SSLを使用してEJB、JMSリソースおよびJDBCリソースを起動できるようにするには、Oracle BAMの次のプロパティを構成する必要があります。

- BAMCommonConfig.xml、BAMServerConfig.xmlおよびBAMICommandConfig.xmlファイルのCommunication_Protocolを次のように設定します。
デフォルト値: <Communication_Protocol>t3</Communication_Protocol>

t3sを使用するSSLの場合: <Communication_Protocol>t3s</Communication_Protocol>

- BAMCommonConfig.xmlファイルのListenPortを次のように設定します。
デフォルト値: <ListenPort>ListenPort</ListenPort>

SSLの場合: <ListenPort>SSLListenPort</ListenPort>

第24.9.4項「Oracle BAMでのOracle Internet Directoryの使用」

Oracle Internet Directoryの構成に関する一般情報は、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』のOracle Internet DirectoryおよびOracle Virtual Directoryの認証プロバイダでのユーザーとグループの構成に関する項を参照してください。

Oracle Internet DirectoryをOracle BAMと併用する手順は、次のとおりです。

1. Oracle WebLogic Server管理コンソールを使用して、Oracle Internet Directoryを構成します。

2. Lightweight Directory Access Protocol (LDAP)ブラウザを使用してOracle Internet Directoryに接続し、Oracle Internet Directoryの構成時にOracle WebLogic Server管理コンソールで指定した内容と同じベース・ユーザー識別名でユーザーを作成して、Oracle Internet DirectoryにOracleSystemUserを作成します。

3. 次のSQL文を実行して、Oracle BAMスキーマのユーザー・グローバル一意識別子(GUID)をNULLに設定します。

UPDATE "SysIterUser" SET "SysIterUser"."GUID" = NULL,
"SysIterUser"."Inactive" = NULL;

24.9.5 Oracle BAM JMSリソースの保護

これは、Oracle BAMシステムのJMSトピックへのアクセスを制限する場合のオプションの手順です。

Oracle BAM JMSリソースを保護する手順は、次のとおりです。

1. Oracle WebLogic Server管理コンソールを使用して、任意のグループ名のグループを作成します。例: OracleSystemGroup。

2. WL_HOME/AS11gR1SOA/bam/binに移動し、Oracle WebLogicスクリプティング・ツール(WLST)を使用してsecure_jms_system_resource.pyを起動します。
使用方法は次のとおりです。

<JAVA_HOME>/bin/java -classpath <weblogic.jar_location> weblogic.WLST
./secure_jms_system_resource.py --username admin_user_name --password
admin_password --url admin_server_t3_url --jmsSystemResource
JMS_system_resource_name --group security_group_to_use

3. このグループにOracleSystemUserを割り当てます。

4. このグループにすべてのOracle BAMユーザーを割り当てます。

24.9.6 セキュアなWebサービスのコール

現在、Oracle BAMアラートの「Webサービスのコール」アクションは、一方向SSLによって保護されるWebサービスの呼出しをサポートします。一方向SSLでは、呼び出されるWebサービスがデジタル証明書をクライアント(この場合、Oracle BAMアラートのアクション・クライアント)に提示し、クライアントは提示された証明書が信頼できるかどうかを検証します。クライアントがサーバー証明書を信頼する場合、クライアントとサーバー間のその後の通信はセキュアなSSLチャネルを介して続けられます。

一方向SSLを実現するには、アラートWebサービスのクライアントは、提示された証明書が存在するかどうかを判別するための参照を実行できるトラスト・ストアを指している必要があります。これは、次のプロパティをBAMCommonConfig.xmlに追加することによって実現できます。

<SSL.TrustStore.Location>wls.home/lib/DemoTrust.jks</SSL.TrustStore.Location>
<SSL.TrustStore.Type>JKS</SSL.TrustStore.Type>
<SSL.TrustStore.Password>password</SSL.TrustStore.Password>
<SSL.TrustStore.Provider>SUN</SSL.TrustStore.Provider>

デフォルトでは、これらのプロパティが構成ファイルに指定されない場合は、前述の値が使用されます(値が使用されないpasswordを除く)。これらのプロパティに別の値を指定して、デフォルトのトラスト・ストアの構成をオーバーライドできます。現在、これらのプロパティはOracle Enterprise Manager Fusion Middleware Controlに表示されないため、構成ファイルを編集して設定する必要があります。

デフォルトのトラスト・ストアはファイル・ベースのJavaキー・ストア(JKS)です。証明書を追加および削除するには、Java keytoolコマンドライン・ユーティリティを使用します。

Webサービス・アラート・アクションのコールの構成の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のWebサービスのコールに関する項を参照してください。

24.9.6.1 例: Oracle BAM Webサービスの保護

次の例は、SSLで保護されたOracle BAM Webサービスを呼び出す方法を示しています。これは、Oracle BAMのManualRuleFire Webサービスをコールする、「Webサービスのコール」アラート・アクションに固有です。一方向SSLで保護されたBAM以外の外部のWebサービスを呼び出す場合は、この項のステップを行う必要はありません。

注意:

この構成を行うと、Oracle BAMアプリケーション全体がSSLレイヤーで処理されるようになるため、SSLポート番号とHTTPSプロトコルを使用してアクセスする必要があります。

セキュアなWebサービスをコールするためのプロパティを構成する手順は、次のとおりです。

1. Oracle WebLogic Server管理コンソールを開いて、「ドメイン構造」→「環境」→「サーバー」→「BAM_Server」→「一般」の順に移動します。

2. 「SSLリスニング・ポート」チェック・ボックスを選択して、使用する「SSLリスニング・ポート」番号を指定します。

3. Oracle BAMの構成プロパティを変更します。

1. 次のプロパティはBAMCommonConfig.xmlで変更する必要があります。

<Communication_Protocol>t3s</Communication_Protocol>
<ListenPort>SSLListenPort</ListenPort>
<ApplicationURL>http://SSL_HOST:SSL_PORT</ApplicationURL>

2. 次のプロパティはBAMWebConfig.xmlで変更する必要があります。

<ServerPort>SSL_PORT</ServerPort>

4. Oracle WebLogic Serverを再起動します。

5. Oracle BAMアクティブ・スタジオまたはOracle BAMアーキテクトを開き、「アラート」に移動します。

6. セキュアなWebサービスを使用して「Webサービスのコール」アクションを持つアラートを作成します。

https://host_name:SSL_port_number/OracleBAMWS/WebServices/ManualRuleFire?wsdl

これはアクションのWSDL URLとなります。

7. パラメータをマップして、アラートを保存します。

24.10 拡張プロパティの構成

Oracle BAMには、Fusion Middleware Controlの「BAM Webプロパティ」ページや「BAMサーバー・プロパティ」ページを使用した構成では使用できない多数の拡張プロパティが用意されています。これらの拡張プロパティは、システムMBeanブラウザを使用して構成します。

Oracle BAMの構成で使用可能なすべてのプロパティのリストは、第24.11項「Oracle BAMの構成プロパティの参照」を参照してください。

システムMBeanブラウザを使用して拡張プロパティを構成する手順は、次のとおりです。

1. OracleBAMWebページまたはOracleBAMServerページのメニューから「システムMBeanブラウザ」を選択します。

2. 適切な「アプリケーション定義のMBean」ページへのパスを選択します。

- すべてのOracle BAMコンポーネントに共通のプロパティの場合: 「アプリケーション定義のMBean」→「oracle.bam.common」→「サーバー: bam_server1」→「アプリケーション: oracle-bam」→「構成」→「BAMCommonConfig」の順に選択します(図24-1を参照)。

- Oracle BAMサーバー固有のプロパティの場合: 「アプリケーション定義のMBean」→「oracle.bam.server」→「サーバー: bam_server1」→「アプリケーション: oracle-bam」→「構成」→「BAMServerConfig」の順に選択します。

- Oracle BAM Webアプリケーション固有のプロパティの場合: 「アプリケーション定義のMBean」→「oracle.bam.web」→「サーバー: bam_server1」→「アプリケーション: oracle-bam」→「構成」→「BAMWebConfig」の順に選択します。

図24-1 システムMBeanブラウザのナビゲーション・ツリー

関連する構成プロパティがシステムMBeanブラウザに表示されます。

3. 「値」列でプロパティの値を編集し、「適用」をクリックします。

4. Oracle BAMのプロパティを変更した後は、Oracle BAMを再起動する必要があります。Oracle BAMの再起動については、第26.2項「Oracle BAMの可用性の管理」を参照してください。

Oracle BAMの構成プロパティ・ファイル

Oracle BAMのすべてのプロパティは、構成ファイルに格納されています。構成ファイルは、Oracle BAMのコンポーネントがインストールされているホスト上の次のディレクトリにあります。

WL_HOME/user_projects/domains/base_domain/config/fmwconfig/servers/bam_server
1/applications/oracle-bam_11.1.1/config

通常、構成プロパティはBAMCommonConfig.xmlファイルに格納されます。このファイルには、Oracle BAMのすべてのコンポーネントに対してグローバルなプロパティが記載されています。これらのプロパティは、コンポーネント固有の構成ファイルに指定することもできます。

- Oracle BAMサーバー固有のプロパティは、BAMServerConfig.xml内に構成されます。

- Oracle BAM Webアプリケーション固有のプロパティは、BAMWebConfig.xml内に構成されます。

- Oracle BAM ICommandユーティリティ固有のプロパティは、BAMICommandConfig.xml内に構成されます。

BAMCommonConfig.xmlファイルに設定されたプロパティは、常にロードされます。これ以外の構成ファイルは、明示的にロードする必要があります。Oracle BAMサーバーはBAMServerConfig.xmlファイルを、Oracle BAM WebアプリケーションはBAMWebConfig.xmlファイルを、ICommandはBAMICommandConfig.xmlファイルをそれぞれ明示的にロードします。構成ファイルがロードされると、以前に設定されたプロパティはオーバーライドされます。つまり、BAMCommonConfig.xmlに設定されているプロパティは、BAMServerConfig.xmlに指定したプロパティによってオーバーライドされます。

24.11 Oracle BAMの構成プロパティの参照

この項では、Oracle BAMの構成ファイルで使用可能なOracle BAMの各構成プロパティについて簡単に説明します。

拡張プロパティはFusion Middleware ControlのシステムMBeanブラウザで構成します。Fusion Middleware ControlのOracle BAMの構成ページに表示されないプロパティの構成については、第24.10項「拡張プロパティの構成」を参照してください。

これらのプロパティのいくつかは、Fusion Middleware ControlおよびOracle WebLogic Server管理コンソールで設定できるプロパティに対応しており、表24-3には、これらの構成手順についての特定の項への参照があります。

注意:

Oracle BAM ADC APIプロパティは、すべてのOracle BAMクライアント(ICommand、Oracle Data Integratorなど)によって使用されるプロパティです。SOAPプロパティは、SOAPを使用するように構成されている場合に、Oracle BAMアダプタによってのみ使用されます。

表24-3 Oracle BAMの構成プロパティ

プロパティ名

説明

ActiveDataCache.API.Batching.ThreadPool.
CoreSize

アイドル状態の場合にOracle BAM ADC APIスレッド・プールに保持するスレッド数を指定します。

デフォルト値: 5

ActiveDataCache.API.Batching.ThreadPool.
KeepAliveTimeInSecs

Oracle BAM ADC APIスレッド・プールにアイドル状態のスレッドを保持する時間(秒単位)。

デフォルト値: 20

ActiveDataCache.API.Batching.ThreadPool.
MaxSize

Oracle BAM ADC APIスレッド・プールの最大スレッド数。

デフォルト値: 100

ActiveDataCache.API.Batching.ThreadPool.
QueueSize

Oracle BAM ADC APIスレッド・プールにキューできる最大メッセージ数。

デフォルト値: 30

ActiveDataCache.API.BufferedDataReader.
ThreadPool.CoreSize

アイドル状態の場合にOracle BAM ADCのバッファ済データ・リーダー・スレッド・プールに保持するスレッド数を指定します。

デフォルト値: 10

ActiveDataCache.API.BufferedDataReader.
ThreadPool.KeepAliveTimeInSecs

BAMCommonConfig.xmlで構成します

Oracle BAM ADCのバッファ済データ・リーダー・スレッド・プールにアイドル状態のスレッドを保持する時間(秒単位)。

デフォルト値: 20

ActiveDataCache.API.BufferedDataReader.
ThreadPool.MaxSize

Oracle BAM ADCのバッファ済データ・リーダー・スレッド・プールの最大スレッド数。

デフォルト値: 100

ActiveDataCache.API.BufferedDataReader.
ThreadPool.QueueSize

Oracle BAM ADCのバッファ済データ・リーダー・スレッド・プールにキューできる最大メッセージ数。

デフォルト値: 30

ActiveDataCache.Kernel.ActiveDataQueue.
ThreadPool.CoreSize

アイドル状態の場合にOracle BAM ADCのアクティブ・データ・キュー・スレッド・プールに保持するスレッド数を指定します。

デフォルト値: 20

ActiveDataCache.Kernel.ActiveDataQueue.
ThreadPool.KeepAliveTimeInSecs

Oracle BAM ADCのアクティブ・データ・キュー・スレッド・プールにアイドル状態のスレッドを保持する時間(秒単位)。

デフォルト値: 20

ActiveDataCache.Kernel.ActiveDataQueue.
ThreadPool.MaxSize

Oracle BAM ADCのアクティブ・データ・キュー・スレッド・プールの最大スレッド数。

デフォルト値: 100

ActiveDataCache.Kernel.ActiveDataQueue.
ThreadPool.QueueSize

Oracle BAM ADCのアクティブ・データ・キュー・スレッド・プールにキューできる最大メッセージ数。

デフォルト値: 30

ActiveDataCache_Datasets_Batching_
BlockOnBatchFull

「バッチ満杯時にブロックする」プロパティは、バッチが満杯の場合に、バッチ操作をブロックするかどうかを示します。trueに設定すると、バッチ内の領域が操作のために解放されるまで、バッチ呼出しがブロックされます。falseに設定すると、BatchIsFullException例外がスローされます。

デフォルト値: false

ActiveDataCache_Datasets_Batching_Limit_
Lower

サーバーに送信する前のバッチの最小要素数。負荷に応じて、バッチにはこの最小数より多く(上限は最大数)の要素が含まれる場合がありますが、タイムアウトが経過しないかぎり、この最小数未満にはなりません。

このルールの例外については、ActiveDataCache_Datasets_Batching_Timeoutを参照してください。

詳細は、第24.8項「Oracle BAMのバッチ処理プロパティの構成」を参照してください。

デフォルト値: 1000

ActiveDataCache_Datasets_Batching_Limit_
PendingCalls

サーバーへの送信を待機している保留中のバッチ数の制限。この制限に達して、現在のバッチが満杯(上限に達した)場合、この条件がクリアされるまで、以降のバッチ操作はブロッキング呼出しになります。この制限によって、クライアントが調整され、サーバーにバッチが過剰に送信されることが防止されます。

詳細は、第24.8項「Oracle BAMのバッチ処理プロパティの構成」を参照してください。

デフォルト値: 10

ActiveDataCache_Datasets_Batching_Limit_
Upper

送信前のバッチの最大要素数。バッチにこの最大数より多くの要素が含まれることはありません。

詳細は、第24.8項「Oracle BAMのバッチ処理プロパティの構成」を参照してください。

デフォルト値: 5000

ActiveDataCache_Datasets_Batching_
MaximumRetries

失敗した処理を再試行するために、バッチ処理がバッチをサーバーに送信する最大回数。値0(ゼロ)は再試行しないことを示します。

デフォルト値: 2147483647

ActiveDataCache_Datasets_Batching_
MaxRetryInterval

失敗した処理を再試行するために、バッチ処理がバッチをサーバーに送信する最大間隔(ミリ秒単位)。この最大再試行間隔を指定すると、間隔がこの最大値に達するまで、各再試行の再試行間隔が2倍になります。以降の再試行では、この最大値が使用されます。この間隔により、失敗をすぐに解決できない場合に、再試行が減少するように構成できます。最大再試行間隔に0(ゼロ)を指定した場合、再試行間隔は変更されません。

デフォルト値: 3600000

ActiveDataCache_Datasets_Batching_
RetryInterval

失敗した処理を再試行するために、バッチ処理がバッチをサーバーに送信する間隔(ミリ秒単位)。サーバーが再起動中であったなど、サーバーの接続の問題による失敗の場合は、再試行が試みられます。

デフォルト値: 30000

ActiveDataCache_Datasets_Batching_
SuspendOnDisconnect

Oracle BAMサーバーへの接続が失われた場合に、バッチ処理を永続的に一時停止の状態にするかどうかを示します。

デフォルト値: false

ActiveDataCache_Datasets_Batching_
ThreadPoolSize

スレッド・プールの定数サイズ(つまり、固定数のスレッドを含む)。

デフォルト値: 25

ActiveDataCache_Datasets_Batching_
Timeout

ミリ秒単位のタイムアウト。この時間が経過した後、バッチが満杯でなくても、バッチが送信される(ミリ秒単位、ActiveDataCache_Datasets_Batching_Limit_Lowerに構成されている最小数より少ない要素を持つ)。

タイムアウトは、バッチ処理が非アクティブであるために過剰に待機することを防ぎます。バッチ処理では、サーバーへの送信をこのタイムアウトより長く待機しません。

詳細は、第24.8項「Oracle BAMのバッチ処理プロパティの構成」を参照してください。

デフォルト値: 50

ActiveDataCache_Query_Command_Timeout

問合せコマンドのタイムアウト(秒単位)の構成キー。問合せコマンドを実行する時間がこのタイムアウトを超える場合は、例外がスローされます。

デフォルト値: 60

ActiveDataCache_Update_Command_Timeout

更新コマンドのタイムアウト(秒単位)の構成キー。更新コマンドを実行する時間がこのタイムアウトを超える場合は、例外がスローされます。

デフォルト値: 60

Adapter_SOAP_Batching_BlockOnBatchFull

「バッチ満杯時にブロックする」プロパティは、バッチが満杯の場合に、バッチ操作をブロックするかどうかを示します。trueに設定すると、バッチ内の領域が操作のために解放されるまで、バッチ呼出しがブロックされます。falseに設定すると、BatchIsFullException例外がスローされます。

デフォルト値: false

Adapter_SOAP_Batching_Limit_Lower

送信前のバッチの最小要素数。

詳細は、第24.8項「Oracle BAMのバッチ処理プロパティの構成」を参照してください。

デフォルト値: 1000

Adapter_SOAP_Batching_Limit_Upper

送信前のバッチの最大要素数。

詳細は、第24.8項「Oracle BAMのバッチ処理プロパティの構成」を参照してください。

デフォルト値: 5000

Adapter_SOAP_Batching_Timeout

バッチ送信後のタイムアウト間隔(ミリ秒単位、バッチが満杯でない場合を含む)。

詳細は、第24.8項「Oracle BAMのバッチ処理プロパティの構成」を参照してください。

デフォルト値: 50

ADC_PassThrough_Import_BatchSize

外部データ・オブジェクトからインポートする最大行数。

デフォルト値: 50

ADC_PassThrough_Import_
MaxRowsToImportAtOnce

ExternalDataManagerで一度にインポートする最大行数。

デフォルト値: 100

ADC_PassThrough_Import_MaxSize

ExternalDataManagerでインポートする最大サイズ。

デフォルト値: -1

ADCBatchSize

JDBC文のバッチ処理を参照します。Oracle BAM ADCは、SQL文の実行時に、JDBCのバッチ処理を使用してデータベースへのコール数を減らし、パフォーマンスを向上させます。各コールでは、単一の文ではなく文のバッチを実行します。

デフォルト値: 100

ADCChannelName

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト値: invm:topic/oracle.bam.messaging.activedatacache.activedata

ADCDataSource

アクティブ・データ・キャッシュに対するデータソース。詳細は、第24.3.2項「データソースJNDIの構成」を参照してください。

デフォルト値: jdbc/oracle/bam/adc

ADCLogBatchInsertLocks

Oracle BAM ADCのバッチ挿入ロックを記録するかどうかを指定します。

デフォルト値: false

ADCLogFolderLocks

Oracle BAM ADCのフォルダ・ロックを記録するかどうかを指定します。

デフォルト値: false

ADCLogSqlStatements

Oracle BAM ADCのSQL文を記録するかどうかを指定します。

デフォルト値: false

ADCLogTransactionLocks

Oracle BAM ADCのトランザクション・ロックを記録するかどうかを指定します。

デフォルト値: false

ADCMaxViewsetRowCount

このプロパティを使用して、ビューに表示するデータのデフォルトの行数制限を指定します。この値を大きくすると、パフォーマンスが低下します。

デフォルト値: 64000

ADCPreloadDataObjectIDs

データ・オブジェクトを、アクセス時のオン・デマンドではなく、Oracle BAM ADCの起動時にロードするかどうかを指定します。データ・オブジェクトの事前ロードによって、起動時間は長くなりますが、データ・オブジェクトの最初のアクセス時間は短くなります。データ・オブジェクトを事前ロードしないと、起動時間は短くなりますが、データ・オブジェクトの最初のアクセス時間は長くなります。また、データ・オブジェクトがほとんど参照されない状態ですべてのデータ・オブジェクトを事前ロードすると、メモリー所要量が不必要に増加する可能性があります。

ADCPushInterval

Oracle BAMアクティブ・データ・キャッシュがイベントをOracle BAMレポート・サーバーにプッシュする間隔。これは、アクティブなイベントがOracle BAMのダッシュボード・ページで発生する頻度に影響を与える要因の1つです。この間隔を長くすると、Oracle BAMサーバーへの負荷が減少します。ただし、間隔を長くすると、ダッシュボード内の複数の更新が1つの更新としてまとめられる可能性が高くなります。

特定のレポート内のデフォルトのADCPushIntervalは、Oracle BAMの特定のダッシュボードまたはレポートに対する「レポート・プロパティ・ダイアログ」で「アクティブ・データ取得間隔」プロパティを設定することでオーバーライドできます。アクティブ・データ取得間隔を設定するには、アクティブ・スタジオでレポートを開き、「編集」→「レポート・プロパティの変更」→「詳細」の順に選択します。ゼロ以外の値を設定すると、そのレポートのADCPushInterval値がオーバーライドされます。

デフォルト値: 1000

ADCPushThreadPoolSize

Oracle BAM ADCプッシュ機能のThreadPoolのサイズを指定します。

デフォルト値: 10

ADCRetryCount

Oracle BAMアクティブ・データ・キャッシュ接続の再試行回数。

デフォルト値: 2

ADCSecurityFiltersEnabled

Oracle BAM ADCのセキュリティ・フィルタを有効にするかどうかを指定します。

デフォルト値: true

ADCViewsetTimeoutSec

ビュー・セットの取得に関するタイムアウトを指定します。

デフォルト値: 0

ADCWaitTime

アクティブ・データ・キャッシュ接続の試行間隔。

デフォルト値: 20

ApplicationURL

Oracle BAM WebアプリケーションおよびOracle BAMサーバーに対するURL。詳細は、第24.3.3項「アプリケーションURLの構成」および第24.2.2項「アプリケーションURLの構成」を参照してください。

デフォルト: DEFAULT

Architect_Content_PageSize

Oracle BAMアーキテクトにデータ・オブジェクトの内容を表示するときの行数を制御します。

デフォルト値: 100

AutoIncrementBlockSize

ブロック・サイズの増分量を指定します。

デフォルト値: 100

BAM_Server_Singleton_Enforcement

高可用性のために使用します。ノード失敗時のためのBAMスキーマのロックとアンロックを構成します。trueまたはfalseに設定できます。trueに設定した場合、別のプロセスがロックを保持しているときは、BAMスキーマは待機する必要があります。プロパティをfalseに設定した場合、別のプロセスがすでにロックを保持しているときは、他のBAMサーバー・インスタンスはスキーマをロックしないで開始できます。

同じBAMスキーマを使用して複数のBAMサーバーを実行できるようにするには、デフォルト動作としてfalseを使用します。

CacheDirectory

スナップショットおよびアクティブなデータをキャッシュするためにレポート・キャッシュで使用するディレクトリを指定します。

デフォルト値: cache

ChangeListDelay

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト値: 1

ChannelName

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト: OracleBAM

CheckViewsFallingBehindInterval

ビューの遅れをチェックする間隔を指定します。

デフォルト値: 20

CollaborationNILogin

NIログインを使用するかどうかを指定します。

デフォルト値: false

ColumnarTimeout

コラム・タイムアウトを指定します。

デフォルト値: 0

Communication_Protocol

JNDI通信の通信プロトコルを指定します。

t3を使用したSSLの場合は次のとおりです。<Communication_Protocol>t3s</Communication_Protocol>

第24.9.3項「Secure Socket Layerの構成」を参照してください。

デフォルト: DEFAULT

ConnectionFactoryName

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト: jms/QueueConnectionFactory

DeletesActiveDataSize

InsertsActiveDataSize、UpdatesActiveDataSize、UpsertsActiveDataSize、DeletesActiveDataSizeは、変更対象のデータ・オブジェクトのロックをリリースして再度ロックを要求する前に実行する必要がある挿入、更新、アップサートおよび削除の回数をそれぞれ決定します。これによって、このデータ・オブジェクトに対して開いているビュー・セットがある場合は、データ・オブジェクトの長時間ロックによる制限から操作が解放されます。

デフォルト値: 50

DisplayUIStackTrace

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

このプロパティは、ユーザー・インタフェースのスタック・トレースを有効にします(このプロパティの値をtrueに設定)。このプロパティは一時的な診断の目的でのみ使用します。これは、スタックの内部詳細を公開することは、セキュリティ上の問題が発生する可能性があるためです。

デフォルト値: false

DistributionListGroupType

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト値: none

EDS_Query_Timeout

外部データに対するBAMレポート問合せの実行が、表示する情報の取得に長時間要するために停止するタイムアウト(秒単位)。外部データ・オブジェクトから取得する行の最大数(数字が大きいほど、パフォーマンスは低下)を決定するImport_MaxSizeも設定します。

デフォルト: 180

ElementsCountLimit

キャッシュ・ファイルのリライト前にキャッシュされる変更リストの数。

デフォルト値は50です。51番目に受け取った変更リストは、1番目の変更リストを置換してキャッシュされます。

デフォルト値: 50

ElementsSizeLimit

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト値: 500

EmailIDForSender

イベント・エンジンが送信した通知の「From」ヘッダーに表示される電子メール・アドレス。詳細は、第24.3.7項「電子メール・アカウントのアウトバウンドの構成」を参照してください。

デフォルト: BAM-NOTIFICATION_AR@example.com

EMSConnectionRecoveryDuration

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

EnableADCDatasetLockTimeout

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

データ・セットのロックのタイムアウトを有効にするかどうかを指定します。

デフォルト値: false

EnableDataTruncationMsg

データ切捨てメッセージを有効にするかどうかを指定します。

デフォルト値: false

EnableGetAllViewsInOneRoundTrip

1回のラウンド・トリップですべてのビューを取得できます。

デフォルト: true

EvaluatorMaxExpressionDepth

フィルタ式を評価するためにコンパイルされるクラスの1つのメソッドに含めることができるネストされた論理式の最大数。

デフォルト: 200

多数の値を指定したフィルタを使用するビューを開くと、コンパイラでメモリー不足になり、「BAM-01317: クラス...のコンパイルがエラー3で失敗しました。」というエラーが表示されます。このエラーが継続して発生する場合は、EvaluatorMaxExpressionDepthの値を小さくして、サーバーを再起動します。

このプロパティはパフォーマンスに大幅に影響を与えるわけではありませんが、EvaluatorMaxExpressionDepthをゼロに設定すると、エバリュエータ・クラスの1つのメソッドのフィルタ式全体に対して、このプロパティをオフにできます。

EventEngine.Action.ThreadPool.CoreSize

アイドル状態の場合にイベント・エンジン・アクション・スレッド・プールに保持するスレッド数を指定します。

デフォルト値: 4

EventEngine.Action.ThreadPool.
KeepAliveTimeInSec

イベント・エンジン・アクション・スレッド・プールにアイドル状態のスレッドを保持する時間(秒単位)。

デフォルト値: 20

EventEngine.Action.ThreadPool.MaxSize

イベント・エンジン・アクション・スレッド・プールの最大スレッド数。

デフォルト値: 100

EventEngine.Action.ThreadPool.QueueSize

イベント・エンジン・アクション・スレッド・プールにキューできる最大メッセージ数。

デフォルト値: 4

EventEngine.AlertHistory.ThreadPool.
CoreSize

アイドル状態の場合にイベント・エンジン・アラート履歴スレッド・プールに保持するスレッド数を指定します。

デフォルト値: 4

EventEngine.AlertHistory.ThreadPool.
KeepAliveTimeInSecs

イベント・エンジン・アクション・スレッド・プールにアイドル状態のスレッドを保持する時間(秒単位)。

デフォルト値: 20

EventEngine.AlertHistory.ThreadPool.
MaxSize

イベント・エンジン・アラート履歴スレッド・プールの最大スレッド数。

デフォルト値: 100

EventEngine.AlertHistory.ThreadPool.
QueueSize

イベント・エンジン・ルール起動スレッド・プールにキューできる最大メッセージ数。

デフォルト値: 10

EventEngineAlertHistoryEventLogging

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト値: false

EventEngineAlertHistoryRecordsPerWrite

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト値: 10

EventEngine.RuleFire.ThreadPool.CoreSize

アイドル状態の場合にイベント・エンジン・ルール起動スレッド・プールに保持するスレッド数を指定します。

デフォルト値: 4

EventEngine.RuleFire.ThreadPool.
KeepAliveTimeInSecs

イベント・エンジン・ルール起動スレッド・プールにアイドル状態のスレッドを保持する時間(秒単位)。

デフォルト値: 20

EventEngine.RuleFire.ThreadPool.MaxSize

イベント・エンジン・ルール起動スレッド・プールの最大スレッド数。

デフォルト値: 100

EventEngine.RuleFire.ThreadPool.
QueueSize

イベント・エンジン・ルール起動スレッド・プールにキューできる最大メッセージ数。

デフォルト値: 4

EventEngineCheckADCIntervalSecs

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト値: 5

EventEngineMaxConnections

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト値: 25

EventEngineMaxShutdownWaitInterval

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト値: 10

EventEngineSaveLastFireIntervalSecs

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト値: 10

FileHandleCacheSize

ファイル・ベースの永続性が使用される場合に、キャッシングに使用されるファイルのファイル・ハンドルをキャッシュするためにOracle BAMレポート・キャッシュが使用します(永続性マネージャの詳細は、第24.3.5項「レポート・キャッシュ永続性マネージャの構成」を参照してください)。

ハンドルをキャッシュすると、アクティブなデータとスナップショットの読み書きが速くなります。各ビュー・セットには2つのファイル・ハンドルがあり、1つはスナップショット用で、もう1つはアクティブなデータ用です。

このプロパティの値によって、デフォルトでキャッシュするファイル・ハンドルの数が設定されます。

ファイル・ハンドルのキャッシュを無効にするには、このプロパティの値をゼロ(0)に設定します。

ファイル・ハンドルをキャッシュするコストは、キャッシュされたすべてのファイル・ハンドルを開いたままにするコストです。このため、a)開いている少数の同時ファイル・ハンドル用に構成されたサーバー、およびb)開いているファイル・ハンドル数が最大値に達している重負荷のサーバーでは、問題が発生する可能性があります。このような場合は、FileHandleCacheSizeを適切な値に減らしてください。

デフォルト値: 100

FractionInIntegerDivision

このプロパティをtrueに設定すると、整数の除算の少数部分が表示されます。

この動作を反映するには、(構成を変更して)サーバーを再起動した後に、保存されているレポートを再度保存する必要があります。

デフォルト値: false

GenericSatelliteChannelName

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト:

invmjms:topic/oracle.bam.messaging.
systemobjectnotification

GenericSatelliteSystemObjectNames

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト値:

SystemObjectName=SysIterReport,MonitorColumnName=SysIterL
astModified,MessageColumn1=SysIterID,MessageColumn2=SysIt
erLastModified;

SystemObjectName=SysIterUser,MonitorColumnName=SpecificTi
meZoneOffset,MessageColumn1=SysIterID;

SystemObjectName=SysIterUser,MonitorColumnName=AdjustTime
ZoneSetting,MessageColumn1=SysIterID;

SystemObjectName=SysIterUser,MonitorColumnName=AdjustDayl
ightSavingsSetting,MessageColumn1=SysIterID;

SystemObjectName=SysIterDataset,MonitorColumnName=SysIter
LastModified,MessageColumn1=SysIterID;

HelpAppLocation

このプロパティは、Oracle BAMではすでに使用されていません。

iActiveDataCloseReportsTimeout

レポートを閉じる際のタイムアウト。

デフォルト値: 500

iActiveDataMaxDiffCounter

iActiveDataの最大差分カウンタ。

デフォルト値: 10

iActiveDataMinIntervalsToWait

iActiveDataを待機する際の最小間隔。

デフォルト値: 5

iActiveDataReloadOnSecsBehindThreshold

iActiveDataを再ロードする場合のしきい値。

デフォルト値: 10

iActiveDataRestartInterval

iActiveDataの再起動間隔。

デフォルト値: 3000

iActiveDataRestartTimeout

iActiveDataの再起動タイムアウト値。

デフォルト値: 10000

iActiveDataScriptsCleanupFactor

アクティブなデータが速いペースでダッシュボードに到達している場合に、ブラウザを定期的にリフレッシュすることによって、Microsoft Internet Explorerのメモリー・リークに対応するプロパティ。アクティブなデータが毎秒25イベント以上の間隔でダッシュボードに到達している場合は、この値を大きくできます。Microsoft Internet Explorerのメモリー消費量を監視して、適切な値を決定できます。

デフォルト値: 1048576

ICommand_Default_User_Name

ICommand操作を実行するためのデフォルトのセキュリティ資格証明を指定します。詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

ICommand_Default_Password

ICommand操作を実行するためのデフォルトのセキュリティ資格証明を指定します。詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

Import_BatchSize

ExternalDataManagerでインポートするバッチ・サイズ。

デフォルト値: 50

Import_MaxRowsAtOnce

ExternalDataManagerで一度にインポートする最大行数。

デフォルト値: 100

Import_MaxSize

ExternalDataManagerでインポートする最大サイズ。

デフォルト値: -1

InsertsActiveDataSize

InsertsActiveDataSize、UpdatesActiveDataSize、UpsertsActiveDataSize、DeletesActiveDataSizeは、変更対象のデータ・オブジェクトのロックをリリースして再度ロックを要求する前に実行する必要がある挿入、更新、アップサートおよび削除の回数をそれぞれ決定します。これによって、このデータ・オブジェクトに対して開いているビュー・セットがある場合は、データ・オブジェクトの長時間ロックによる制限から操作が解放されます。

デフォルト値: 50

ListenPort

SSLの場合: <ListenPort>SSLListenPort</ListenPort>

第24.9.3項「Secure Socket Layerの構成」を参照してください。

デフォルト値: ListenPort

MaxDBNodeFailoverRetries

Oracle RACの高可用性の構成で使用します。Oracle RACフェイルオーバーの場合にOracle BAMサーバーが実行する再試行の回数を指定します。

デフォルト値: 5

MTTimerThreadPoolSize

Oracle BAMには、スレッド・プールを使用してタイマー・イベントをディスパッチするタイマー実装があります。これによって、複数のタイマー・イベントをパラレルに処理できます。このプロパティは、このタイマー実装のスレッド・プール・サイズを指定します。

デフォルト値: 5

ODIAgentHost

Oracle Data Integratorエージェントが稼働しているサーバーのIPアドレスまたはホスト名。詳細は、第24.3.6項「Oracle Data Integratorの統合プロパティの構成」を参照してください。

デフォルト: localhost

ODIAgentPort

Oracle Data IntegratorエージェントがリスニングしているTCPポート。詳細は、第24.3.6項「Oracle Data Integratorの統合プロパティの構成」を参照してください。

デフォルト値: 20910

ODIPassword

Oracle Data Integratorのエンコードされたパスワード。詳細は、第24.3.6項「Oracle Data Integratorの統合プロパティの構成」を参照してください。

デフォルト: SUNOPSIS

ODIUser

Oracle Data Integratorでシナリオを実行するユーザー。詳細は、第24.3.6項「Oracle Data Integratorの統合プロパティの構成」を参照してください。

デフォルト: SUPERVISOR

ODIWorkRepositoryName

Oracle Data Integratorの作業リポジトリ・データベースの名前。詳細は、第24.3.6項「Oracle Data Integratorの統合プロパティの構成」を参照してください。

デフォルト: WORK_DEV

oracle.bam.common.messaging.util.
MessageConsumerRegistryQueuedPusher_
CorePoolSize

アイドル状態の場合にメッセージ・レジストリ・スレッド・プールに保持するスレッド数を指定します。

デフォルト値: 20

oracle.bam.common.messaging.util.
MessageConsumerRegistryQueuedPusher_
KeepAliveTime

メッセージ・レジストリ・スレッド・プールにアイドル状態のスレッドを保持する時間(秒単位)。

デフォルト値: 60

oracle.bam.common.messaging.util.
MessageConsumerRegistryQueuedPusher_
MaximumPoolSize

メッセージ・レジストリ・スレッド・プール内の最大スレッド数。

デフォルト値: 100

oracle.bam.common.messaging.util.
MessageConsumerRegistryQueuedPusher_
MaximumQueueSize

メッセージ・レジストリ・スレッド・プールにキューできる最大メッセージ数。

デフォルト値: 30

RecordsLimitForEmail

電子メール・アタッチメントで使用するリスト・ビューまたはコラム・レポートで許容される行数。これを超えると制限エラーが表示されます。レポートを含むアタッチメントは、Oracle BAMサーバーでレポートやデータにアクセスするレポート・リンクに比べて多くのデータが含まれるため、サイズが大きくなる可能性があります。

デフォルト値: 1000

RecordsLimitForSaveOffline

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト値: 0

RecordsLimitForValueBrowser

フィルタ式を作成するために値ブラウザに表示される値の数。

デフォルト値: 50

ReportCache.ViewSets.ThreadPool.CoreSize

アイドル状態の場合にレポート・キャッシュ・スレッド・プールに保持するスレッド数。

デフォルト値: 5

ReportCache.ViewSets.ThreadPool.
KeepAliveTimeInSecs

レポート・キャッシュ・スレッド・プールにアイドル状態のスレッドを保持する時間(秒単位)。

デフォルト値: 20

ReportCache.ViewSets.ThreadPool.MaxSize

レポート・キャッシュ・スレッド・プール内の最大スレッド数。

デフォルト値: 100

ReportCache.ViewSets.ThreadPool.
QueueSize

レポート・キャッシュ・スレッド・プールにキューできる最大メッセージ数。

デフォルト値: 30

ReportCacheChannelName

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト値: invmjms:topic/oracle.bam.messaging.reportcache.activedata

ReportCacheMaxConnections

レポート・キャッシュからそのクライアントへの最大接続数。

デフォルト値: 25

ReportCacheMaxShutdownWaitInterval

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト値: 10

ReportCachePersistenceManager

詳細は、第24.3.5項「レポート・キャッシュ永続性マネージャの構成」を参照してください。

デフォルト値: FileBasedPersistenceManager

ReportLoadingSetting

有効にするレポート・ロード・インジケータ。詳細は、第24.2.3項「レポート・ロード・インジケータの構成」を参照してください。

デフォルト: on

SensorFactory

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト値: oracle.bam.common.statistics.noop.SensorFactoryImpl

ServerName

Oracle BAM Serverのホスト名。詳細は、第24.2.4項「サーバー名の構成」を参照してください。

デフォルト: DEFAULT

ServerPort

Oracle BAM Serverのポート番号。

デフォルト: DEFAULT

UpdatesActiveDataSize

InsertsActiveDataSize、UpdatesActiveDataSize、UpsertsActiveDataSize、DeletesActiveDataSizeは、変更対象のデータ・オブジェクトのロックをリリースして再度ロックを要求する前に実行する必要がある挿入、更新、アップサートおよび削除の回数をそれぞれ決定します。これによって、このデータ・オブジェクトに対して開いているビュー・セットがある場合は、データ・オブジェクトの長時間ロックによる制限から操作が解放されます。

デフォルト値: 50

UpsertsActiveDataSize

InsertsActiveDataSize、UpdatesActiveDataSize、UpsertsActiveDataSize、DeletesActiveDataSizeは、変更対象のデータ・オブジェクトのロックをリリースして再度ロックを要求する前に実行する必要がある挿入、更新、アップサートおよび削除の回数をそれぞれ決定します。これによって、このデータ・オブジェクトに対して開いているビュー・セットがある場合は、データ・オブジェクトの長時間ロックによる制限から操作が解放されます。

デフォルト値: 50

UseDBFailover

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト: true

ViewSetExpiryTimeout

このプロパティは、Oracle BAMの内部でのみ使用されます。このプロパティは、Oracleサポート・サービスによる指示がないかぎり変更しないでください。

デフォルト値: 120

ViewSetSharing

詳細は、第24.3.4項「ビューセットの共有の構成」を参照してください。

デフォルト: true

25 Oracle Business Activity Monitoringの監視

この章では、Oracle Enterprise Manager Fusion Middleware Controlを使用して、Oracle Business Activity Monitoring (Oracle BAM)のパフォーマンス統計とログを表示し、Oracle BAM WebサービスのカウンタおよびOracle BAMサーバーとWebのコンポーネント(アクティブ・データ・キャッシュ、イベント・エンジン、レポート・キャッシュ、エンタープライズ・メッセージ・ソース、レポート・サーバーなど)を監視する方法について説明します。

この章では、次の項目について説明します。

- 第25.1項「Oracle BAMの監視の概要」

- 第25.2項「Oracle BAMサーバーのコンポーネントの監視」

- 第25.3項「Oracle BAM Webアプリケーションの監視」

- 第25.4項「Oracle BAM Webサービスの監視」

- 第25.5項「Oracle BAMのパフォーマンスの監視」

- 第25.6項「Oracle BAMのログの監視」

25.1 Oracle BAMの監視の概要

Oracle BAMのコンポーネントは、Oracle Enterprise Manager Fusion Middleware Controlを使用して様々な側面から監視できます。

Oracle BAMサーバーのコンポーネントであるアクティブ・データ・キャッシュ、イベント・エンジン、レポート・キャッシュおよびエンタープライズ・メッセージ・ソースは、Fusion Middleware Controlの「OracleBamServer」ページで監視できます。詳細は、第25.2項「Oracle BAMサーバーのコンポーネントの監視」を参照してください。

Oracle BAMレポート・サーバーは、Fusion Middleware Controlの「OracleBamWeb」ページで監視できます。詳細は、第25.3項「Oracle BAM Webアプリケーションの監視」を参照してください。

さらに、各コンポーネントの「パフォーマンス・サマリー」では、選択した特定の統計を追跡できます。詳細は、第25.5項「Oracle BAMのパフォーマンスの監視」を参照してください。

また、Oracle BAMのログは、Fusion Middleware Controlを使用して構成および監視できます。詳細は、第25.6項「Oracle BAMのログの監視」を参照してください。

25.2 Oracle BAMサーバーのコンポーネントの監視

Oracle BAM Serverのコンポーネントは、Oracle BAM ServerのFusion Middleware Controlのページで監視します。

Oracle BAMサーバーのコンポーネントを監視する手順は、次のとおりです。

ナビゲーション・ツリーで「BAM」→「OracleBamServer」の順に選択し、Oracle BAMサーバーのホーム・ページに移動します。

「OracleBamServer」ページでは、各タブ(「アクティブ・データ・キャッシュ」、「イベント・エンジン」、「レポート・キャッシュ」、「エンタープライズ・メッセージ・ソース」)を選択して、Oracle BAMサーバーの各コンポーネントを監視できます。

注意:

または、ファーム・ホーム・ページで、ファームの詳細を表示しているページの右側のコンテンツ領域からOracle BAMのターゲットを選択することもできます。

25.2.1 Oracle BAMアクティブ・データ・キャッシュの監視

Oracle BAMアクティブ・データ・キャッシュ(Oracle BAM ADC)は、大量のデータをリアルタイムで処理できるように設計および最適化されています。Oracle BAM ADCに到達したデータによって、メモリー内キャッシュにある定義済のすべての計算と集計がリアルタイムで即時に更新されます。これによって、データをOracle BAMのダッシュボードとレポートにできるかぎり迅速にプッシュできます。Oracle BAM ADCにフィードされたデータは、Java Message Service (JMS)のトピックやキューから従来のデータ問合せやデータベースまでの様々なソースの組合せです。Oracle BAM ADCでは、ソースに関係なく、Oracle BAMサーバーが受信データを認識すると、そのデータは、変更が発生するたびにOracle BAMのアラートとダッシュボードにストリームされます。

Oracle BAM ADCには、データ・セットとビュー・セットの2つの重要なコンポーネントがあります。Oracle BAM ADCは、トランザクション(挿入、更新、アップサートおよび削除)をデータ・セットで受け取ります。このデータ・セットは、Oracle BAMアーキテクトにデータ・オブジェクトを定義する際に、Oracle BAM開発者がデータ関係について定義した設計に基づいて構築されます。データ・オブジェクトには、データのフラット表を反映したり、より複雑なデータ・オブジェクト間のスター・スキーマ関係(Oracle BAMではデータ・オブジェクト参照として示されます)を反映できます。

データ・セット内でデータが更新されると、そのデータ・セットをリスニングしているビュー・セットが起動します。ビュー・セットは、ユーザーがOracle BAMシステムで表示している、オープン状態のOracle BAMのダッシュボードとアラートをすべて認識しています。ビュー・セットは、オープン状態のダッシュボードとアラートへの更新を公開するプッシュ・ベースのメカニズムを使用して、最初に、これらのオープン状態のオブジェクトに対するデータ更新を段階的に実行し、ユーザーに最新情報を提供します。

Fusion Middleware ControlのOracle BAMのページは、Oracle BAM ADC内のすべてのデータ・オブジェクトに関する統計を1つのグループとして監視したり、監視する「データ・オブジェクト」リストから特定のデータ・オブジェクトを選択する際に使用します。

注意:

リストからデータ・オブジェクトを選択すると、パフォーマンスを維持するためにキャッシュれたデータが表示されます。選択したデータ・オブジェクトに関連する最新データを表示するには、(「リフレッシュ」アイコンを使用して)ページをリフレッシュする必要があります。

ビュー・セット

アクティブ・ビュー・セットは、一般的に、Oracle BAMレポートで表示されます。オープン・ビュー・セットは、アクティブなオープン・ビュー・セットおよび静的なオープン・ビュー・セットの集合です。

Oracle BAMレポートおよびアラートでは、アクティブ・ビュー・セットが使用されます。Oracle BAM Serverでは、内部プロセスで静的なビュー・セットが使用されます。また、コードの内部には、システム・オブジェクト(メタデータ表)に関する静的なビュー・セットが使用されている部分もあります。Oracle BAM Serverで静的なビュー・セットが閉じられていない場合は、それらのビューで異なる値が表示されることがあります。

静的なビュー・セットはアクティブなデータ生成をサポートしておらず、データ・オブジェクトからデータをフェッチするために使用されるため、オープンされるのは、データをフェッチする非常に短い時間のみとなります。このため、「オープン」カウンタには、通常、アクティブ・ビュー・セットからの値が表示されます。

ビュー・セット数の差異

Oracle BAMのコンポーネントであるアクティブ・データ・キャッシュ、レポート・キャッシュおよびレポート・サーバーのビュー・セット数を監視できます。アクティブ・データ・キャッシュ、レポート・キャッシュおよびレポート・サーバーの各メトリック間で、ビュー・セット数が一致しない場合があります。

レポート・サーバーは、レポート・キャッシュを介して、ブラウザ内で開いているレポートに含まれるすべてのビューに対してビュー・セットを開きます。アクティブ・データ・キャッシュは、レポート・キャッシュより多くのビュー・セットを開きます。このようなビュー・セットは、イベント・エンジンを介してアクティブ・データ・キャッシュ内で開きます。

イベント・エンジンは、起動するたびに定義済のすべてのアラートをロードします。これらのアラートはアクティブ・データ・キャッシュ内のデータ変更を監視するように定義されているため、対応するビュー・セットはアクティブ・データ・キャッシュ内で開きます。これが、アクティブ・データ・キャッシュの監視ページに表示されるビュー・セットの数が、レポート・キャッシュやレポート・サーバーのページより多くなる理由です。

レポート内のほとんどのビューについては、対応するビュー・セットがアクティブ・データ・キャッシュ内にあります。レポートで開いたビュー・セットは、クロス集計ビューを除いて、そのレポートの後続のインスタンスと共有されます。クロス集計ビューを使用しているレポートでのビュー・セット・コールは、他のビューで使用するビュー・セット・コールと同一ではありません。クロス集計ビューを含むレポートが開くと、アクティブ・データ・キャッシュでは、3つのビュー・セットが開きます。2つのビュー・セットはデータのフェッチ直後に閉じますが、1つのビュー・セットは開いたままで、受信する変更を監視します。

操作/秒

この統計には、選択したデータ・オブジェクトで発生した挿入、更新、アップサートおよび削除操作がすべて含まれます。付随するグラフには、直前5分間の統計が表示されます。

操作の平均バッチ・サイズ

この統計は、選択したデータ・オブジェクトに対する各バッチ操作に含まれる平均レコード数です。付随するグラフには、直前5分間の統計が表示されます。

待機スレッド

特定の操作は同期する必要があるため、データ・オブジェクトをロックする必要があります。この統計は、後続の操作を実行するためにデータ・オブジェクトがアンロックされることを待機し、ブロックされているスレッドの数を表示します。

合計トランザクション

この統計には、Oracle BAMのデータ・オブジェクトに対するトランザクションの数が表示されます。これは、コミットされたトランザクションとロールバックされたトランザクションの数の合計です。また、付随するグラフには、オープン・トランザクションと完了したトランザクションの数も表示されます。

たとえば、Oracle BAMのデータ・オブジェクトに1行追加して保存(コミット)した場合、これが1つのトランザクションになります。このメトリックは、Oracle BAMサーバーのクライアントがトランザクションを使用している場合のみ有効です。

JMSトピックまたはキューに接続している場合は、EMSでもトランザクションを使用できます。

このメトリックは、BPELのOracle BAMセンサー・アクションおよびOracle Data Integratorナレッジ・モジュールでのトランザクションを追跡するように構成できます。

「ロールバックされたトランザクション」の場合、Oracle BAMのデータ・オブジェクトに対して無効な挿入操作を実行しようとすると、Oracle BAMサーバーはそのトランザクションをロールバックします。

25.2.2 イベント・エンジン・コンポーネントの監視

Oracle BAMサーバーでは、イベント・エンジンを使用してOracle BAMのアラートを評価および実行します。イベント・エンジンは、複雑なデータ条件を監視し、指定したルールを実装します。ルールには、イベントに関連した一連の条件とアクションが含まれています。イベント・エンジンは、特定の条件に関してアクティブ・データ・キャッシュ内の情報を継続して監視し、関連したルールに定義されている関連アクションを実行します。

イベント・エンジンは、日付、時間またはデータ変更に基づいてイベントを追跡します。イベント・エンジンはサテライトの概念を使用して設計されており、この概念には、EVENT句を登録して追跡できる4つの異なるシステム(サテライト)があります。

「日付」サテライトと「時間」サテライトはいずれもスケジューラに基づいており、たとえば、「このOracle BAMダッシュボードのスナップショットを毎朝8時に電子メールで受信する」のような時間ベースのアラートに使用されます。

手動サテライトは、アラートを名前によって(Webサービス・コールを使用して)手動で送信するために使用されます。

「データ」サテライトは、特定のデータ・オブジェクトのデータに対する特定の変更に基づいたアラートを追跡するために使用されます。このようなアラートの例には、「MediaSalesデータ・オブジェクトでSUM(Sales) > 10000の場合は、このWebサービスをコールしてください」、「このダッシュボードで変更が発生した場合は知らせてください」などがあります。

イベント・エンジンのアクティブ・ルール、条件一致率および処理中のキューに関する統計を監視できます。

アクティブ・ルール

この統計には、Oracle BAMイベント・エンジン内のアクティブな(期限切れまたは無効ではない)アラート・ルールの数が表示されます。この統計には、Oracle BAMイベント・エンジン内のアラート・ルールの合計数が表示されます。これは、すべてのOracle BAMユーザーに対して作成されたアラートの合計です。

ルール起動率/秒

この統計グループには、「実績」、「承認されたイベント」および「拒否されたイベント」の各率に関する直前5分間のイベントの率が表示されます。

「実績」ルール起動率/秒は、イベント・サービスで起動したイベントの1秒当たりの数です。これは、起動したイベントの1秒当たりの数で、直前5分間のアラートによるイベント起動回数が対象となります。たとえば、「OracleBamServer」ページがロードされ、直前5分間に2つのアラートのみが起動された場合、表示される値は2/(5 X 60)、つまり0.0067になります。このため、300秒間に2回起動された場合は、1秒間に0.0067回起動されることになります。

「承認されたイベント」は、サテライトから起動したイベントの1秒当たりの数です。つまり、構成したアラートから起動し、承認されて次の処理に進むイベントの1秒当たりの数で、直前5分間に承認されたイベントが対象となります。表示される値は、「実績」と同じ方法で計算されます。起動したすべてのイベントは、イベント・エンジンのキューしきい値を超えないかぎり承認されて次の処理に進みます。

「拒否されたイベント」は、拒否されたイベントの1秒当たりの数です。つまり、構成したアラートから起動し、拒否されて次の処理に進むイベントの1秒当たりの数で、直前5分間に拒否されたイベントが対象となります。表示される値は、「実績」と同じ方法で計算されます。起動したイベントは、イベント・エンジンのキューしきい値を超えた場合に拒否されます。この値はゼロであることが理想的です。

処理中のキューのサイズ

このグラフには、イベント処理中のキューのサイズ、つまり、処理待ちのイベントの数が表示されます。これらのキューはイベントが処理されるとすぐに空になります。したがって、キュー内に処理待ちのアラートが表示される場合は、多数のイベントが同時に生成されていることになります。

「処理中のキューのサイズ」グラフには、直前5分間の統計が表示されます。このグラフには、「起動されたルール・キュー」、「アラート・アクション・キュー」および「アラート履歴キュー」の状態が表示されます。

「起動されたルール・キュー」には、起動されて処理待ちのイベントの数が表示されます。イベント・エンジンは、起動されたイベント用に内部メモリー内キューを保守しています。すべてのイベントは、このキューに一時的に格納され、イベント・エンジンのリソースが使用可能になると同時に、追加処理のために取り出されます。このメトリックは、起動され、システムによる取得をキュー内で待機しているイベントの数を示します。

「アラート・アクション・キュー」には、処理待ちのアクションの数が表示されます。イベント・エンジンは、アクション用に内部メモリー内キューを保守しています。すべてのアクションは、このキューに一時的に格納され、イベント・エンジンのリソースが使用可能になると同時に、追加処理のために取り出されます。このメトリックは、システムによる取得をキュー内で待機しているアクションの数を示します。

「アラート履歴キュー」には、保存の対象となるアラート履歴項目の数が表示されます。イベント・エンジンは、すべての履歴項目用に内部メモリー内キューを保守しています。すべての項目は、このキューに一時的に格納された後、取得されてバックエンドに保存されます。このメトリックは、システムによる取得をキュー内で待機している履歴項目の数を示します。

25.2.3 レポート・キャッシュ・コンポーネントの監視

レポート・キャッシュは、ビュー・セット・スナップショットをメモリー内に保持してアクティブ・データ・キャッシュを支援します。レポート・キャッシュは、レポート・サーバー(Oracle BAM Webアプリケーションのコンポーネント)のアクティブ・データ・キャッシュでビュー・セットを開きます。次に、スナップショット(小さい部分内)およびアクティブなデータをキャッシュし、それをレポート・サーバーに送信します。これによって、スナップショットへのランダム・アクセスが可能になり、Oracle BAMサーバーへの接続が失われた場合にリカバリできます。また、レポート・キャッシュは、アクティブ・データ・キャッシュとともに、ビュー・セットの共有をサポートします。

アクティブ・データ・セッション

この統計には、アクティブなデータがあるレポート・キャッシュ・セッションの合計数が表示されます。

ユーザーが1台のコンピュータ上で複数のブラウザ・ウィンドウを開いてOracle BAMレポートを表示する際は、同じアクティブ・データ・セッションが、開いているすべてのブラウザ・ウィンドウで共有されます。ユーザーが各ブラウザ・ウィンドウに開いているのが同じレポートか異なるレポートかに関係なく、「アクティブ・データ・セッション」の件数は、常に1です。

アクティブ・データ・レポート

この統計には、アクティブなデータをリクエストするオープン状態のレポートの合計数が表示されます。

ファイル数

この統計には、Oracle BAMサーバーがファイル・ベースの永続性マネージャを使用するように構成されている場合に、FileBasedPersistenceManagerで現在管理されているファイルの合計数が表示されます。詳細は、第24.3.5項「レポート・キャッシュ永続性マネージャの構成」を参照してください。

要素数

この統計には、Oracle BAMサーバーがメモリー・ベースの永続性マネージャを使用するように構成されている場合に、InMemoryPersistenceManagerで現在管理されている要素の合計数が表示されます。詳細は、第24.3.5項「レポート・キャッシュ永続性マネージャの構成」を参照してください。

ビュー・セット

この統計グループには、次のカウンタが表示されます。

「平均オープン時間(秒)」は、ビュー・セットを開くのに要した平均時間です。

「送信メッセージ率(/秒)」は、レポート・キャッシュですべてのクライアントに配信された変更リストの1秒当たりの数です。

「ビューセットごとのメッセージ率(秒)」は、ビュー・セットごとに配信された変更リストの1秒当たりの数です。

「オープン・ビューセットの合計」は、ブラウザで開いているレポートに含まれるすべてのビューのレポート・キャッシュで保持されているビュー・セット数の合計(つまり、共有、非共有および継承の各ビュー・セットの合計)です。

「オープン・ビューセット」グラフには、共有ビュー・セット、継承ビュー・セットおよび非共有ビュー・セットが表示されます。

共有ビュー・セットは親のビュー・セットになります(これらのビュー・セットが最初に開きます)。

継承ビュー・セットは子のビュー・セットになります(これらのビュー・セットは後で開きます)。

非共有ビュー・セット(独立したビュー・セット)は、共有ビュー・セットにも継承ビュー・セットにもなりません。

パフォーマンス上の理由で、ビュー・セットの共有は可能な場合はいつでも行われます(顧客がまったく同じビュー・セットを要求すると、そのビュー・セットは共有できます)。ビュー・セットを共有できない場合、それらは非共有です。

行レベルのセキュリティに差異がない複数のユーザーが、ほとんど同時に同じレポートを開いた場合、アクティブ・データ・キャッシュで作成されたビュー・セットはレポート・キャッシュで共有されます。

注意:

アクティブ・データ・キャッシュ、レポート・キャッシュおよびレポート・サーバーの各メトリック間で、ビュー・セット数が一致しない場合があります。詳細は、「ビュー・セット数の差異」を参照してください。

25.2.4 エンタープライズ・メッセージ・ソースの監視

エンタープライズ・メッセージ・ソース(EMS)は、メッセージをOracle BAMのデータ・オブジェクトに直接マップして、Java Message Service (JMS)をOracle BAMサーバーに直接接続するアプリケーションで使用されます。Oracle BAMサーバーは、JMSベースのメッセージ・キューまたはトピックからデータを直接読み取ることができます。このオプションによって、保証付きメッセージが提供されます。XMLスタイルシート言語(XSL)での厳密なデータ・トランスフォーメーションの実行は、Oracle Data Integratorなどの抽出、変換およびロード(ETL)ツールによる実行よりも構成が困難で処理速度も遅くなります。

EMS機能では、ETLシナリオを構成せずに、メッセージをOracle BAMサーバーのデータ・オブジェクトに直接マップします。ただし、データをデータ・オブジェクトに挿入(更新、アップサートまたは削除)する前に、XSLトランスフォーメーションを使用することはできます。各EMSは、JMSの特定のトピックまたはキューから読み取られ、その情報がアクティブ・データ・キャッシュのデータ・オブジェクトに配信されます。EMS定義の構成には、Oracle BAMアーキテクトWebアプリケーションを使用します。

EMS定義の構成の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

注意:

データが「エンタープライズ・メッセージ・ソース」ページに表示されるのは、作成したEMS定義をOracle BAMアーキテクトで起動した場合のみです。Fusion Middleware Controlでは、データをフェッチして統計を「エンタープライズ・メッセージ・ソース」ページに表示するまで時間がかかる場合があります。

ページをリフレッシュすると、最新のEMSデータが表示されます。「リフレッシュ」アイコンを使用してページをリフレッシュできます。

エンタープライズ・メッセージ・ソース

監視するEMSをリストから選択します。すべてのEMS定義について集計された統計を表示したり、表示されたリストから監視対象の特定のEMSを選択することもできます。

メッセージ

選択したEMSで受信したメッセージの数を監視します。拒否に関する統計は、「パフォーマンス・サマリー」メトリック・ページで確認できます。

付随するグラフには、「受信メッセージ」が「承認メッセージ」と「拒否メッセージ」に分類されて表示され、「受信メッセージの合計」は上部に表示されます。

操作/秒

選択したEMSで実行した挿入、更新、アップサートおよび削除操作の率を監視します。

「操作/秒」グラフには、直前5分間の統計が表示されます。

各タイプの操作の率に関する詳細を確認する場合は、「パフォーマンス・サマリー」ページに移動します。詳細は、第25.5項「Oracle BAMのパフォーマンスの監視」を参照してください。

25.2.5 進行中のクライアント・リクエストの監視

Oracle BAMの「進行中のクライアント・リクエスト」グラフは、Oracle BAMサーバーのホーム・ページの右下隅に表示されます。クライアント・リクエストには、Oracle BAMサーバーのEnterprise Java Beans (EJB)に対するすべてのリクエストが含まれます。

1つのレポートを開くと、権限、レポート・メタデータ、ビュー・データなどに対して多数の内部リクエストが作成されます。ただし、ユーザーは、このグラフに表示される内部リクエストを表示できる場合とできない場合があります。

25.3 Oracle BAM Webアプリケーションの監視

Oracle BAM Webアプリケーションは、Fusion Middleware Controlの「OracleBamWeb」ページで監視します。

Oracle BAMレポート・サーバーを監視するには、ナビゲーション・ツリーで「BAM」→「OracleBamWeb」の順に選択し、「OracleBamWeb」ページに移動します。

図25-1 BAM Web統計

25.3.1 Oracle BAMレポート・サーバーの監視

Oracle BAMレポート・サーバーは、ブラウザ内の表現を定義するために、Oracle BAM ADCから取得したデータ・セットにレポート定義を適用します。また、レポートを表示および印刷するために、情報のページングを管理します。作成されたレポートはOracle BAM ADCに格納されるため、毎回レポート作成を繰り返すことはありません。ほとんどのレポート・ビューは、データ変更のアクティブなライブ表示をリアルタイムでサポートするように設計されています。

Oracle BAMレポート・サーバーの接続、ビュー・セットおよびレポートに関する統計を監視できます。

接続

この統計グループには、次の統計情報が表示されます。

「オープン接続」は、レポート・サーバーでオープン状態の接続の数です。オープン接続は、セッションごとに各ユーザーに対応しています。これは、オープン状態のレポートの数とは異なります。これは、1名のユーザーが一度にオープンできる接続は、そのユーザーが開いているレポートの数に関係なく1つのみであるためです。

「メッセージ率(/秒)」は、すべてのユーザー(接続)に配信されたメッセージ(ビュー・セット変更リスト)の1秒当たりの合計数です。

「接続ごとのメッセージ率(秒)」は、配信されたメッセージ(ビュー・セット変更リスト)のユーザー(接続)ごとの1秒当たりの数です。

ビュー・セット

この統計グループには、オープン・ビュー・セットの数、およびサーバーでそれらのビュー・セットをオープンするためにかかった平均時間(秒単位)が表示されます。

「平均オープン時間(秒)」は、サーバーがビュー・セットを作成して、Webブラウザに送信するために必要な平均時間の測定です。この統計は、クライアント側のWebブラウザでHTMLを表示して、JavaScriptをロードするために必要な時間は考慮していません。

注意:

アクティブ・データ・キャッシュ、レポート・キャッシュおよびレポート・サーバーの各メトリック間で、ビュー・セット数が一致しない場合があります。詳細は、「ビュー・セット数の差異」を参照してください。

レポート

この統計には、オープン状態のレポートの合計数が表示されます。「オープン接続」グラフには、Oracle BAM Webアプリケーションに対するオープン接続が表示されます。ズーム軸を使用して特定の時間にズーム・インすると、その時間のオープン接続の統計を表示できます。

レポートの合計数には、同じユーザーが重複して開いたレポートの数が含まれます。同じレポートを複数のブラウザ・ウィンドウで開いた場合でも、各インスタンスは個別のレポートと見なされます。これは、レポート・インスタンスごとに新しいビュー・セットがレポート・サーバーで(Oracle BAMレポート・キャッシュを介して)開くためです(ただし、ビュー・セットは共有されます)。

25.3.2 オープン接続の監視

Oracle BAMの「オープン接続」グラフは、Oracle BAMサーバーのホーム・ページの右下隅に表示されます。

25.4 Oracle BAM Webサービスの監視

Oracle BAM Webサービスの詳細は、Fusion Middleware ControlのOracle BAMのページに表示されません。Oracle BAM Webサービスのカウンタは、図25-2に示すように、ナビゲーション・ツリーで「WebLogicドメイン」→「soa_bam_domain」→「BAM_Server」の順に選択し、「最も頻度の高いリクエスト」リージョンの「JEE Webサービス」タブを選択して表示できます。

Oracle BAMには、DataObjectDefinition、DataObjectOperationsByName、DataObjectOperationsByID、DataObjectOperations10131、ManualRuleFireおよびICommandの各Webサービスが用意されています。詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のOracle BAM Webサービスの使用に関する項を参照してください。

「JEE Webサービス」表には、「呼出し数」、「レスポンス数」、「レスポンス・エラー数」、「平均レスポンス時間(ミリ秒)」、「平均実行時間(ミリ秒)」および「合計ディスパッチ時間」に関する統計が表示されます。

図25-2 Oracle BAM Webサービスのカウンタ

25.5 Oracle BAMのパフォーマンスの監視

Oracle BAMアプリケーションのパフォーマンスは、メトリックと統計に反映されます。Oracle BAMサーバーとOracle BAM Webアプリケーションには、適切なメトリックを表示する個別の「パフォーマンス・サマリー」ページがあります。

図25-3に示すように、Oracle BAMの各コンポーネントのメニューで「監視」→「パフォーマンス・サマリー」の順に選択すると、図25-4に示す「パフォーマンス・サマリー」ページが表示されます。

図25-3 「監視」ショートカット・メニュー

図25-4 「パフォーマンス・サマリー」ページ

多数のメトリックを取得して表示できます(ほとんどのメトリックは、Oracle BAMのコンポーネントのホーム・ページにも表示されます)。各メトリックの説明は、そのメトリックのヘルプ・ページを参照してください。

最も重点をおく重要な情報を取得するには、「メトリック・パレット」を使用します。「メトリック・パレットの表示」をクリックすると、図25-5に示す「メトリック・パレット」が表示されます。

最も関心のあるメトリックを選択します。パレットからメトリックを選択したり、選択を解除すると、左側のメトリック・グラフが自動的に更新されます。

図25-5 Oracle BAM Webアプリケーションのメトリック・パレット

各メトリックの詳細を検索するには、図25-6に示すように、メトリック・ラベルを右クリックし、「ヘルプ」を選択します。

図25-6 「メトリック」ショートカット・メニュー

25.6 Oracle BAMのログの監視

Oracle BAMのログは、Fusion Middleware Controlを使用して構成および表示します。

注意:

Oracle BAMサーバーとOracle BAM Webアプリケーションには、個別のログ・ページがありますが、それぞれのページには、Oracle BAMアプリケーションのすべてのコンポーネントに関するログが表示されます。

ロガー機能の使用については、オンライン・ヘルプ・ページを参照してください。ロガーの構成については、第24.4項「ロガーの構成」を参照してください。

ログを表示するには、図25-7に示すように、ナビゲーション・ツリーで「OracleBamServer」ノードまたは「OracleBamWeb」ノードを右クリックし、「ログ」→「ログ・メッセージの表示」の順に選択します。

図25-7 「ログ」ショートカット・メニュー

図25-8に示すように、「ログ・ビューア」ページが開きます。このページを使用して、コンポーネントに関する情報を問い合せます。フィールドとリストを使用して問合せをカスタマイズします。

図25-8 「ログ・メッセージ」ページ

検索基準の入力後、「ターゲット・ログ・ファイル」をクリックします。図25-9に示すように、「ログ・ファイル」ページが表示されます。特定のログ情報を表示したり(図25-10を参照)、ログをダウンロードできます。

図25-9 「ログ・ファイル」ページ

図25-10 ログ・ファイル: bam_server1.log

26 Oracle Business Activity Monitoringの管理

この章では、Oracle Business Activity Monitoring (Oracle BAM)コンポーネントの起動および停止、ユーザーおよびグループの作成、アプリケーション・レベルのロールを使用したOracle BAMアプリケーション権限の付与、データ・オブジェクトとフォルダおよびレポートに対するデータ・アクセス権限の設定を実行する方法について説明します。

この章では、次の項目について説明します。

- 第26.1項「Oracle BAMの管理の概要」

- 第26.2項「Oracle BAMの可用性の管理」

- 第26.3項「Oracle BAMユーザーの管理」

26.1 Oracle BAMの管理の概要

Oracle BAMの可用性を管理するには、Oracle Enterprise Manager Fusion Middleware Controlを使用します。詳細は、第26.2項「Oracle BAMの可用性の管理」を参照してください。

Oracle BAMのユーザーとグループは、Oracle WebLogic Server管理コンソール(または、Oracle WebLogic Serverに対して構成されたセキュリティ・プロバイダ)で作成されます。Fusion Middleware Controlの「アプリケーション・ポリシー」では、アプリケーション・レベルのロールが管理され、新しいグループ/ロールおよびポリシー/権限を作成できます。さらに、ユーザーのOracle BAMオブジェクトはOracle BAMアドミニストレータで管理されます。詳細は、第26.3項「Oracle BAMユーザーの管理」を参照してください。

26.2 Oracle BAMの可用性の管理

Oracle BAMサーバーおよびOracle BAM Webアプリケーションは、Fusion Middleware Controlを使用して起動および停止できます。また、便利な方法として、Oracle BAMアプリケーション全体(または、Oracle BAMアプリケーションがデプロイされているOracle WebLogic Server)をOracle WebLogic Server管理コンソールで再起動できます。

注意:

Oracle BAMのすべてのUNIXインストールでは、Oracle BAMによって使用されるJava AWT APIの動作の都合から、DISPLAY環境変数unsetを使用してOracle BAMサーバーを起動する必要があります。

$ unsetenv DISPLAY

Oracle BAMのFusion Middleware Controlプロパティのページまたは構成ファイルで構成を変更した場合は、再起動が必要です。

Fusion Middleware ControlでOracle BAMコンポーネントを起動または停止する手順は、次のとおりです。

1. Fusion Middleware Controlのナビゲーション・ツリーで、「OracleBamServer」または「OracleBamWeb」ノードを検索します。

2. ノードを右クリックしてショートカット・メニューを開き、「コントロール」を選択します。

起動: コンポーネントを起動します。

停止: コンポーネントを停止します。

注意:

「起動」のみを使用してコンポーネントを再起動しないでください。コンポーネントを再起動するには、「停止」を使用してコンポーネントを停止した後、「起動」を使用してコンポーネントを起動する必要があります。そうしないと、エラーが発生します。

26.3 Oracle BAMユーザーの管理

Oracle BAMユーザーを管理する主要な手順は、次のとおりです。

1. セキュリティ・プロバイダの構成

Oracle BAMユーザーに使用するユーザーまたはグループ(あるいはその両方)は、Oracle WebLogic Serverに対して構成されたセキュリティ・プロバイダに存在している必要があります。Oracle WebLogic Serverに対するセキュリティの構成の主要な手順と詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』を参照してください。

注意:

Oracle BAMのユーザーを認証するために、デフォルトの組込みLDAP (デフォルト・オーセンティケータとも呼ばれる)を使用するかわりに、Oracle WebLogic Serverを使用してActive Directory認証プロバイダを構成できます。Active Directoryを使用するには、いくつかの追加のステップを実行して、OracleSystemUserのデフォルト・ユーザーを変更することも必要です。詳細は、『Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイド』のOracleSystemUserのデフォルト・ユーザーの変更に関する項を参照してください。

2. ユーザーとグループの作成

ユーザーとグループは、構成済のセキュリティ・プロバイダ(たとえば、Oracle WebLogic Server組込みLDAPサーバー)内に定義されます。ユーザーとグループの定義に関する詳細は、使用するセキュリティ・プロバイダのドキュメントを参照してください。詳細は、第26.3.1項「ユーザーとグループの定義」および第26.3.2「以前にシードされたグループ・メンバーの使用」を参照してください。

Oracle WebLogic Server管理コンソールを使用してユーザーとグループを作成する手順の例は、第26.3.5「Oracle WebLogic Server組込みLDAPサーバーの構成」を参照してください。

3. アプリケーション・ロールへのユーザーとグループの割当て

次に、ユーザーまたはグループ(あるいはその両方)をOracle BAMアプリケーション・レベルのロールに割り当てます。このロールによって、Oracle BAMアプリケーションを使用するための特定の権限がユーザーまたはグループ(あるいはその両方)に付与されます。ユーザーとグループには、Oracle BAMロール・メンバーシップに基づいてOracle BAMアプリケーション権限が付与されます。

Oracle BAMアプリケーション・ロールおよび関連するOracle BAMアプリケーション権限の詳細は、第26.3.3項「アプリケーション・ロールへのメンバーの追加」を参照してください。

Oracle BAMアプリケーション・ロールのメンバーシップは、Fusion Middleware Controlで提供されるOracle BAMの「アプリケーション・ロール」ページから管理します。このページを使用すると、ユーザーとグループを様々なOracle BAMアプリケーション・ロールにメンバーとして追加し、新しいアプリケーション・ロールを作成できます。詳細は、第26.3.4項「Oracle BAMアプリケーション・ロールの概要」を参照してください。

注意:

Oracle BAMでは、Oracle BAMアプリケーション権限をユーザーとグループに直接割り当てる機能はサポートしていません。Oracle BAMアプリケーション権限の付与対象は、Oracle BAMアプリケーション・ロールのみです。

Oracle BAMアプリケーション権限をユーザーとグループに付与する唯一の方法は、対象となるユーザーとグループを、目的のOracle BAMアプリケーション権限に関連付けられているOracle BAMアプリケーション・ロールのメンバーにすることです。

管理者ロールを除いて、Oracle BAMアプリケーション・ロールのメンバーシップには、Oracle BAMデータ・アクセス権限が含まれていません。第26.3.4項「Oracle BAMアプリケーション・ロールの概要」で説明するように、Oracle BAMアプリケーション・ロールによって付与されるのは、関連するOracle BAMユーザー・インタフェースへのユーザー・アクセスのみです。

ユーザーが「Oracle BAM開始ページ」にログインすると、各Oracle BAMアプリケーションのボタンが表示されます。これらのボタンが有効か無効かは、そのユーザーのOracle BAMアプリケーション・ロール・メンバーシップに基づいて決まります。

注意:

ユーザーのグループおよびロール・メンバーシップを変更すると、変更をシステム全体に伝播するのに5分程度要する場合があります。

4. Oracle BAMアプリケーションへのユーザーの移入

ユーザーは、Oracle BAMに最初にログインするまで、Oracle BAMアドミニストレータから表示できません。Oracle BAMには、ユーザーをOracle BAMアドミニストレータに移入できるユーティリティが用意されています。詳細は、第26.3.6項「Oracle BAMアドミニストレータへのユーザーの移入」を参照してください。

5. Oracle BAMに対するデータ・アクセス権限の設定

ユーザーとグループには、Oracle BAMアーキテクトおよびOracle BAMアクティブ・スタジオを使用して特定のデータ・アクセス権限を付与できます。ユーザーとグループには、特定のデータ・オブジェクトとフォルダに対する「読取り」、「更新」および「削除」の各操作権限を付与できます。詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のデータ・オブジェクトに対する権限の作成に関する項、およびデータ・オブジェクト・フォルダの使用に関する項を参照してください。

ユーザーとグループには、データ・オブジェクトの行レベルでデータ・アクセス権限を付与することもできます。行レベルのデータ・セキュリティについては、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のセキュリティ・フィルタの作成に関する項を参照してください。

各レポート作成者は、レポートへのアクセス権限があるOracle BAMユーザーを制御できます。詳細は、『Oracle Fusion Middleware Oracle Business Activity Monitoringユーザーズ・ガイド』のフォルダ権限の設定に関する項を参照してください。

6. Oracle BAMのオブジェクト所有権の管理

ユーザーがOracle BAMから完全に削除される前に他のユーザーに転送する必要のあるOracle BAMオブジェクトを所有している場合があるため、Oracle BAMユーザーがセキュリティ・プロバイダから削除されても、そのユーザーのアカウントは引き続きOracle BAMアドミニストレータに表示されます。オブジェクト所有権は、Oracle BAMアドミニストレータを使用して管理します(第26.3.7項「Oracle BAMのオブジェクト所有権の管理」を参照)。

7. Oracle BAMからのユーザーの削除

管理者は、ユーザーをセキュリティ・プロバイダで非アクティブ化した後、そのユーザーをOracle BAMアドミニストレータから削除する必要があります(第26.3.8項「Oracle BAMアドミニストレータからの無効なユーザーの削除」を参照)。

OracleSystemUser

OracleSystemUserは、すべてのOracle BAMオブジェクトのデフォルト所有者です。これはOracle BAMサーバーで必要なため、削除できません。

26.3.1 ユーザーとグループの定義

ユーザーは、構成済のセキュリティ・プロバイダのアイデンティティ・ストア(たとえば、Oracle WebLogic Server組込みLDAPサーバー)内に定義されます。

グループは、エンタープライズ・レベルのロールとも呼ばれ、同様にアイデンティティ・ストア内に定義されます。グループは、アプリケーション・レベルのロールと区別するために、エンタープライズ・レベルのロールと呼ばれます。

このエンタープライズ・レベルのロールは、Oracle WebLogic Serverに対してグローバルで、このサーバー上で稼働するすべてのアプリケーション(Oracle BAMを含む)に適用できます。これに対して、アプリケーション・レベルのロールは各アプリケーションに固有のロールです。

Oracle WebLogic Server管理コンソールを使用してユーザーとグループを作成する手順の例は、第26.3.5「Oracle WebLogic Server組込みLDAPサーバーの構成」を参照してください。

注意:

ユーザーを削除した場合は、Oracle BAMで古いインスタンスを解決するまで、そのユーザー名を再使用できません。Oracle WebLogic Serverでユーザーを削除すると、削除されたユーザーは、Oracle BAMによって非アクティブとしてマークされます。

新しいアカウントに同じユーザー名を再使用することを試みても、Oracle BAMでは、以前に削除されたユーザーと新しく追加されるユーザーは同じであると見なされません。Oracle BAMアドミニストレータを使用して(必要に応じてユーザーのOracle BAMオブジェクトを別の有効なユーザーに転送し)、Oracle BAMから元のユーザーを削除する必要があります。Oracle BAMから非アクティブなユーザーを削除すると、そのユーザー名を再使用できます。

Oracle BAMからのユーザーの削除の詳細は、第26.3.8項「Oracle BAMアドミニストレータからの無効なユーザーの削除」を参照してください。

26.3.2 以前にシードされたグループ・メンバーの使用

次のOracle WebLogic Serverグループは、Oracle BAMアプリケーション・ポリシーにすでにシードされています。

- BamAdministrators: アプリケーション・ロール「アドミニストレータ」のメンバー

- BamReportArchitects: アプリケーション・ロール「レポート設計者」のメンバー

- BamReportCreators: アプリケーション・ロール「レポート作成者」のメンバー

- BamReportViewers: アプリケーション・ロール「レポート・ビューア」のメンバー

これらのメンバーは便利に使用できます。これらのグループを構成済のセキュリティ・プロバイダに定義すると、特定のユーザーとグループをこれらのグループに配置することによって、Oracle BAMアプリケーション・レベルのロールをユーザーとグループに割り当てることができます。この割当てはすべてセキュリティ・プロバイダから実行でき、Oracle BAMアプリケーションのポリシー変更は必要ありません。

Oracle BAMでは、ユーザーまたはグループが構成済のセキュリティ・プロバイダに自動的にシードされないため、これらのグループはセキュリティ・プロバイダに手動で作成する必要があります。

26.3.3 アプリケーション・ロールへのメンバーの追加

第26.3.4項「Oracle BAMアプリケーション・ロールの概要」で説明するように、ロール・メンバーも含めてOracle BAMアプリケーション・レベルのロールは、Oracle BAMアプリケーション・ポリシーによって定義されます。このOracle BAMアプリケーション・ポリシーは、Fusion Middleware Controlで管理します。デフォルトのポリシー・ストア・プロバイダは、XMLファイル・ベースのポリシー・ストアです。

メンバーをOracle BAMアプリケーション・レベルのロールに追加するには、Fusion Middleware Controlを使用して、目的のロールのメンバーシップ・リストにエントリを追加する必要があります。

次の図に、Fusion Middleware ControlでOracle BAMの「アプリケーション・ロール」ページを開くためのナビゲーションを示します。

「ロール名」リストからロールを選択します。

メンバーをロールに追加します。

使用可能なユーザーを選択し、「選択したユーザー」リストに移動します。

26.3.3.1 DBベースのポリシー・ストアを使用するSOAドメインへのOracle BAMの拡張

デフォルトのポリシー・ストアはファイルベースですが、DBベースのポリシー・ストアを使用するOracle SOA SuiteドメインにOracle BAMを拡張できます。

この項では、この方法でOracle BAMを拡張するための一般的な手順の概要を示します。

DBベースのポリシー・ストアを使用するSOAドメインにOracle BAMを拡張する手順は次のとおりです。

1. Oracle SOA Suiteをインストールします。

2. Oracle Fusion Middleware Oracle WebLogic Serverの保護のRDBMSセキュリティ・ストアの管理に関する項の説明に従って、ドメイン用にDBベースのポリシー・ストアを構成します。

3. ドメインを拡張してOracle BAMを含めます。

4. Oracle WebLogic ServerとOracle SOA Suiteを起動します。

5. OPSSデータ・ソースをOracle BAMサーバーへのターゲットとします。

6. Oracle BAMサーバーを起動します。

7. Oracle BAMサーバーにログインします。

26.3.4 Oracle BAMアプリケーション・ロールの概要

Oracle BAMでは、次のアプリケーション・レベルのロールが定義されます。

- アドミニストレータ: すべての機能へのアクセス権があります。

- レポート設計者: データ・オブジェクトおよびレポートを作成する機能へのアクセス権があります。

- レポート作成者: レポートを作成する機能へのアクセス権があります。

- レポート・ビューア: レポートを表示する機能へのアクセス権があります。

これらのアプリケーション・ロールによって、特定のユーザーまたはグループに付与される権限が決まります。ユーザーまたはグループがいずれかのOracle BAMアプリケーション・ロールのメンバーである場合は、それに関連するOracle BAM権限が付与されます。

Oracle BAMアプリケーション・ロールによって、次の権限が付与されます。

アドミニストレータの権限

- Administrator: Oracle BAMアドミニストレータ・アプリケーションの機能への完全なアクセス権があります。

- CreateDataObject: Oracle BAMアーキテクトでデータ・オブジェクトを作成できます。

- ActiveViewer: Oracle BAMアクティブ・ビューア・アプリケーションの機能への完全なアクセス権があります。

- ActiveStudio: Oracle BAMアクティブ・スタジオ・アプリケーションの機能への完全なアクセス権があります。

- Architect: Oracle BAMアーキテクト・アプリケーションの機能への完全なアクセス権があります。

- CreateReport: Oracle BAMアクティブ・スタジオでレポートを作成できます。

- CreateAlertRule: Oracle BAMアーキテクトおよびOracle BAMアクティブ・スタジオでアラートを作成できます。

- EmailRenderedReport: レポート・アタッチメントをOracle BAMユーザーに電子メールで送信できます。

レポート設計者の権限

- CreateDataObject: Oracle BAMアーキテクトでデータ・オブジェクトを作成できます。

- ActiveViewer: Oracle BAMアクティブ・ビューア・アプリケーションの機能への完全なアクセス権があります。

- ActiveStudio: Oracle BAMアクティブ・スタジオ・アプリケーションの機能への完全なアクセス権があります。

- Architect: Oracle BAMアーキテクト・アプリケーションの機能への完全なアクセス権があります。

- CreateReport: Oracle BAMアクティブ・スタジオでレポートを作成できます。

- CreateAlertRule: Oracle BAMアーキテクトおよびOracle BAMアクティブ・スタジオでアラートを作成できます。

- EmailRenderedReport: レポート・アタッチメントをOracle BAMユーザーに電子メールで送信できます。

レポート作成者の権限

- ActiveViewer: Oracle BAMアクティブ・ビューア・アプリケーションの機能への完全なアクセス権があります。

- ActiveStudio: Oracle BAMアクティブ・スタジオ・アプリケーションの機能への完全なアクセス権があります。

- CreateReport: Oracle BAMアクティブ・スタジオでレポートを作成できます。

- CreateAlertRule: Oracle BAMアクティブ・スタジオでアラートを作成できます。

- EmailRenderedReport: レポート・アタッチメントをOracle BAMユーザーに電子メールで送信できます。

レポート・ビューアの権限

- ActiveViewer: Oracle BAMアクティブ・ビューア・アプリケーションの機能への完全なアクセス権があります。

26.3.5 Oracle WebLogic Server組込みLDAPサーバーの構成

Oracle WebLogic Server組込みLDAPサーバーは、Oracle WebLogic Serverのデフォルトのセキュリティ・プロバイダです。この項では、新規のユーザーとグループをOracle WebLogic Server組込みLDAPサーバーに追加する手順を説明します。

組込みLDAPサーバーの構成については、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』の組込みLDAPサーバーの管理に関する項を参照してください。

26.3.5.1 Oracle WebLogic Server管理コンソールの使用

Oracle WebLogic Serverの管理は、次の場所にあるOracle WebLogic Server管理コンソールを使用して実行します。

http://host_name:port_number/console

管理コンソールにアクセスするには、Oracle WebLogic Serverが実行中であることが必要です。このコンソールには、Oracle WebLogic Server管理者の資格証明を使用してログインする必要があります。ログインに成功すると、Oracle WebLogic Server管理コンソールのホーム・ページが表示されます。

26.3.5.2 グループの追加

グループを追加する手順は、次のとおりです。

1. Oracle WebLogic Server管理コンソールで、「ホーム」→「セキュリティ・レルム」→「myrealm」→「ユーザーとグループ」の順に移動します。

2. 「グループ」タブを選択し、「新規」をクリックします。

3. グループの名前と説明を入力します。プロバイダは変更しないでください。

4. 「OK」をクリックします。

26.3.5.3 ユーザーの追加

ユーザーを追加する手順は、次のとおりです。

1. Oracle WebLogic Server管理コンソールで、「ホーム」→「セキュリティ・レルム」→「myrealm」→「ユーザーとグループ」の順に移動します。

2. 「ユーザー」タブを選択し、「新規」をクリックします。

3. ユーザーの名前、説明およびログイン・パスワードを入力します。プロバイダは変更しないでください。

4. 「OK」をクリックします。

26.3.5.4 グループへのユーザーの追加

ユーザーをグループに追加する手順は、次のとおりです。

1. Oracle WebLogic Server管理コンソールで、「ホーム」→「セキュリティ・レルム」→「myrealm」→「ユーザーとグループ」の順に移動します。

2. 「ユーザー」タブを選択して、ユーザーを選択します。

3. 「グループ」タブを選択します。

4. グループを「使用可能」リストから「選択済み」リストに移動します。「選択済み」リストは、ユーザーがメンバーになるグループのリストを表します。

5. 「保存」をクリックします。

26.3.6 Oracle BAMアドミニストレータへのユーザーの移入

ユーザーは、セキュリティ・プロバイダによってOracle BAMアドミニストレータに自動的に移入されません。ユーザーをOracle BAMアドミニストレータで管理するには、システム管理者がregisterusersユーティリティを実行するか、指定された資格証明を使用して、ユーザーが「Oracle BAM開始ページ」にログインする必要があります。

Oracle BAMは監視および分析用アプリケーションです。このため、ユーザーおよび権限レベルのみではなく、特定の分析データの行レベルでデータを保護するための要件を実装でサポートできます。この要件のために、Oracle BAMユーザーは、標準のOracle WebLogic Serverユーザー管理ツール・セットでは提供されていない管理作業をOracle BAMアドミニストレータで実行する必要があります。特定のユーザー向けに追加のセキュリティ機能を構成するためには、そのユーザーをOracle BAMアドミニストレータに定義する必要があります。

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

- 第26.3.6.1項「Registerusersユーティリティの使用」

- 第26.3.6.2項「ユーザー・ログインによる移入」

26.3.6.1 Registerusersユーティリティの使用

registerusersユーティリティは、ユーザーをOracle BAMサーバーに登録するためのスタンドアロンJavaアプリケーションです。通常、Oracle BAMでは、特定の定義済ユーザーが最初にOracle BAMにログインするまでそのユーザーを認識しません。ユーザーが最初にログインすると、Oracle BAMは構成済のセキュリティ・プロバイダでそのユーザーを参照し、Oracle BAMと構成済のセキュリティ・プロバイダでのユーザー定義を同期します。同期の対象には、ユーザー名、ロール・メンバーシップ、グループ・メンバーシップ、ユーザー・プロパティ(例: 電子メール・アドレス)などが含まれます。

Oracle BAMでは、定義済ユーザーが少なくとも1回ログインするまでそのユーザーを認識しないため、そのユーザーに関連する特定のOracle BAMユーザー構成を実行できません。たとえば、Oracle BAMでデータ・オブジェクト権限を定義しても、権限エディタで表示される既知のユーザーのリストにそのユーザーは表示されません。

registerusersユーティリティを使用すると、Oracle BAM管理者レベル権限を持つユーザーはユーザーのリストをOracle BAMに登録できます。この登録により、これらのユーザーはOracle BAMに完全に定義され、以降のOracle BAMのユーザー構成(データ・オブジェクト権限の定義など)で使用可能になります。

ユーザーがOracle BAMに追加されるのは、そのユーザーがセキュリティ・プロバイダで正常に認証された場合のみです。このユーティリティに入力するのは、空白区切りの簡単なユーザー名リストです。

registerusersユーティリティでは、標準出力への各ユーザーの正常登録、および標準エラーへのユーザーの登録失敗が確認されます。次に、registerusersユーティリティの出力例を示します。

>registerusers -file cmd_file.txt
Enter Password:
Connecting to BAM server as user weblogic.
Registering users...
Registration Succeeded For User: james.
Registration Failed    For User: jane. Reason: BAM-00400: Authentication failed.
Registration Succeeded For User: adam.
Registration Failed    For User: bob. Reason: BAM-00400: Authentication failed.
Registration Succeeded For User: bill.
Registration Succeeded For User: barbara.
Registration Succeeded For User: lynn.

引数を指定しないでユーティリティを実行すると、コマンド構文が標準出力に表示されます。

コマンドの構文は次のとおりです。

registerusers -adminuser adminusername -host host
-port port -protocol protocol [-file filename]... [username]...

説明:

adminusernameは、Oracle BAM管理者権限があるユーザーの名前を指定します。

hostは、ターゲットのOracle BAMサーバーのホスト名またはIPアドレスを指定します。デフォルト: localhost

portは、ターゲットのOracle BAMサーバーのポート番号を指定します。デフォルト値: 7001

protocolは、使用する通信プロトコルを指定します。SSLの場合は、t3またはt3sのいずれかです。デフォルト値: t3

filenameは、コマンドライン引数を含むファイルを指定します。-fileオプションは、指定したファイルの内容に置き換えられます。

usernameは、Oracle BAMに登録するユーザーの名前を指定します。

例:

>registerusers -adminuser weblogic -host localhost -port 7001 -protocol t3 -file cmd_file.txt smith jones

-adminuserオプションを省略すると、標準入力に従って入力するように要求されます。BAMアドミニストレータのパスワードを-adminuserで指定すると、パスワードのプロンプト(入力した文字は非表示になります)を使用した標準入力に従って入力するように要求されます。

<filename>で指定したファイルには、空白区切りのコマンドライン引数を含める必要があります。区切りとして定義できるのは、空白、EOL文字およびカンマです。一重引用符で囲まれた文字列と二重引用符で囲まれた文字列の両方がサポートされています。

このファイルには、コメントを挿入する目的で、二重スラッシュ、およびスラッシュとアスタリスクの組合せを含めることもできます。これらのコメントは無視されます。

コマンドライン引数に空白文字(カンマを含む)、スラッシュ(/)(ファイル・パスに使用)、またはアスタリスク(*)を含める場合は、引用符で囲む必要があります。たとえば、"/dir1/dir2/file.txt"と入力します。

このファイルには、追加の-fileオプションを含めることができます。このファイルは、拡張文字セットをサポートするUTF-8形式であることが必要です。

次に、コマンド・ファイルの例を示します。

// Specify Oracle BAM administrator account to execute command. Password is not
// provided so that the user is securely prompted for the password.
-adminuser user_name
// Configure the target BAM server.
-host localhost -port 7001 -protocol t3
// Register the following users.
jones /* This is Mr. Jones. */
smith /* This is Ms. Smith. */
// Register users from another file.
-file "/dir1/dir2/user_list.txt"

-host、-portおよび-protocolの各引数に対するデフォルト値は、UserRegisterConfig.xmlファイルに含まれています。これらのデフォルト値が使用されるのは、コマンドラインにオプションが指定されていない場合のみです。オプションがコマンドラインにもUserRegisterConfig.xml構成ファイルにも指定されていない場合は、デフォルト値が使用されます。コマンド構文の出力には、有効なデフォルト値が表示されます。

デフォルトは次のとおりです。

-host localhost -port 7001 -protocol t3

UserRegisterConfig.xmlファイルの例を次に示します。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<UserRegister>
<ServerName>localhost</ServerName>
<ServerPort>7001</ServerPort>
<Communication_Protocol>t3</Communication_Protocol>
<ServerPlatform>weblogic</ServerPlatform>
</UserRegister>

-hostのデフォルト値はServerNameプロパティから、-portのデフォルト値はServerPortプロパティから、-protocolのデフォルト値はCommunication_Protocolプロパティからそれぞれ取得されます。これらのプロパティの情報は表24-3にあります。スタンドアロン・アプリケーションでは、ServerPlatformの構成が必要です。この値は、weblogicまたはwebsphereで、Oracle BAMサーバーを実行しているアプリケーション・サーバーのタイプに依存します。

26.3.6.2 ユーザー・ログインによる移入

ユーザーをOracle BAMアドミニストレータに移入する手順は、次のとおりです。

1. 各Oracle BAMユーザーは、「Oracle BAM開始ページ」を開き、セキュリティ・プロバイダによって指定された資格証明を使用してログインします。

「Oracle BAM開始ページ」の場所は次のとおりです。

http://host_name:port_number/OracleBAM/

2. 管理者は、「Oracle BAM開始ページ」を開いてログインし、「アドミニストレータ」を選択します。

3. Oracle BAMアドミニストレータに「ユーザー管理」ページが表示されていない場合は、リストから「ユーザー管理」を選択します。

図26-1 Oracle BAMアドミニストレータの機能リスト

4. 各Oracle BAMユーザーが「ユーザー」リストに表示されていることを確認します(「リストのリフレッシュ」リンクを使用して最新データを表示します)。

26.3.7 Oracle BAMのオブジェクト所有権の管理

Oracle BAMユーザーがセキュリティ・プロバイダから削除されても、ユーザー・アカウントは感嘆符(!)アイコン付きでOracle BAMアドミニストレータ・アプリケーションに引き続き表示されます。感嘆符アイコンは、そのユーザー・アカウントが有効でないことを示します。

これらのユーザーは、Oracle BAMアプリケーションにアクセスできませんが引き続き表示されます。これは、Oracle BAMから完全に削除される前に他のユーザーに転送する必要のあるオブジェクトをOracle BAM内に所有している場合があるためです。

オブジェクト所有権は、Oracle BAMアドミニストレータを使用して管理します。

オブジェクト所有権を移す手順は、次のとおりです。

1. 「Oracle BAM開始ページ」に移動してログインし、「アドミニストレータ」を選択します。
「Oracle BAM開始ページ」の場所は次のとおりです。

http://host_name:port_number/OracleBAM/

2. リストから「ユーザー管理」を選択します(図26-1を参照)。

3. 再割当て対象のオブジェクトを現在所有しているユーザーを「ユーザー」リストから選択します。

4. 「所有権の再割当」をクリックします。

「名前の選択」ダイアログにユーザーのリストが表示されます。

5. オブジェクトの新しい所有者になるユーザー・アカウントをリストから選択します。

6. 「OK」をクリックします。
レポートは、選択したユーザー名の付いたサブフォルダに移動します。

アラートが移動し、選択した所有者に同じ名前のアラートがある場合は、アラート名にゼロ(0)が追加されます。アラートの項目を更新または指定する必要がある場合は、Oracle BAMアーキテクトおよびOracle BAMアクティブ・スタジオの「アラート」ページにあるアラート・アイコンに感嘆符(!)が表示されます。

共有のレポートおよびフォルダでは、所有権が変更されますが削除されません。

26.3.8 Oracle BAMアドミニストレータからの無効なユーザーの削除

無効なユーザーは、レポートまたはアラートを所有している可能性があるため、Oracle BAMからは自動的に削除されません。所有しているレポートまたはアラートは、アクティブなOracle BAMユーザーに移す必要があります。オブジェクトを移した後は、無効なユーザーをOracle BAMアドミニストレータから削除できます。

無効なユーザーを削除する手順は、次のとおりです。

1. 「Oracle BAM開始ページ」に移動してログインし、「アドミニストレータ」を選択します。
「Oracle BAM開始ページ」の場所は次のとおりです。

http://host_name:port_number/OracleBAM/

2. リストから「ユーザー管理」を選択します(図26-1を参照)。

3. 「ユーザー」リストから、オブジェクトが再割当てされた無効なユーザーを選択します。
オブジェクトの再割当てについては、第26.3.7項「Oracle BAMのオブジェクト所有権の管理」を参照してください。

ユーザーが非アクティブな場合は、そのユーザー名の横に感嘆符(!)アイコンが表示されます。

4. 「削除」をクリックします。

第X部

Oracle User Messaging Serviceの管理

この部では、Oracle Messaging Serviceの管理方法について説明します。

次の章で構成されています。

- 第27章「Oracle User Messaging Serviceの構成」

- 第28章「Oracle User Messaging Serviceの監視」

- 第29章「Oracle User Messaging Serviceの管理」

27 Oracle User Messaging Serviceの構成

この章では、Oracle User Messaging Service (UMS)の機能およびアーキテクチャについて説明します。使用環境でのOracle UMSの構成および保護方法についても説明します。

この章では、次の項目について説明します。

- 第27.1項「ユーザー・メッセージング・サービスの概要」

- 第27.2項「Oracle User Messaging Serviceの構成の概要」

- 第27.3項「ユーザー・メッセージング・サービスの構成ページへのアクセス」

- 第27.4項「ユーザー・メッセージング・サービス・ドライバの構成」

- 第27.5項「LDAPユーザー・プロファイルへのユーザー・メッセージング・サービスのアクセスの構成」

- 第27.6項「Oracle User Messaging Serviceの保護」

- 第27.7項「Oracle User Messaging Serviceのトラブルシューティング」

Oracle User Messaging Serviceのチューニングとパフォーマンス・プロパティの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』を参照してください。

27.1 ユーザー・メッセージング・サービスの概要

Oracle User Messaging Serviceは、ユーザーとデプロイされたアプリケーション間での双方向通信を可能にします。主な機能は次のとおりです。

- 様々なメッセージング・チャネルに対するサポート: メッセージは、電子メール、インスタント・メッセージ(IM)(XMPP)、ショート・メッセージ・サービス(SMS)(SMPP)およびボイスを介して送受信できます。メッセージはユーザーのSOA/Oracle WebCenterポータル・ワークリストにも配信できます。

- 双方向メッセージング: アプリケーションからユーザーへのメッセージ送信(アウトバウンド・メッセージングとも呼ばれる)以外に、ユーザーは、メッセージングの相互作用(インバウンド・メッセージング)を開始できます。たとえば、ユーザーが特定のアドレスに電子メールまたはテキスト・メッセージを送信すると、そのメッセージは適切なアプリケーションにルーティングされ、次に、アプリケーションでは、ビジネス・ロジックに従ってユーザーに応答するか、または別のプロセスを起動します。

- ユーザー・メッセージング・プリファレンス: エンド・ユーザーは、Webインタフェースを使用して、メッセージング通知の受信方法と受信時間に関するプリファレンスを定義できます。アプリケーションでは、ユーザーの電子メール・アドレスやIMクライアントへの送信を判断せずに、その柔軟性によって、単にメッセージをユーザーに送信し、その先のメッセージのルーティングをユーザーのプリファレンスに従ってUMSに任せます。

注意:

ユーザー・メッセージング・プリファレンスのUIは、次の場所で入手できます。

http://host:port/sdpmessaging/userprefs-ui

ユーザー・メッセージング・プリファレンスのUIは、Oracle BPM Worklistにも組み込まれています。「プリファレンス」→「通知」の順に選択することによってアクセスできます。

- 強力なメッセージ配信: UMSは、メッセージング・ゲートウェイが提供する配信ステータス情報を継続して記録し、アプリケーションにこの情報を提供しているため、アプリケーションは失敗した配信に対応できます。また、アプリケーションでは、初期のアドレスへの配信が失敗した場合に備えて、メッセージに対して1つ以上のフェイルオーバー・アドレスを指定できます。UMSのフェイルオーバー機能を使用することで、アプリケーション開発者は、複雑な再試行ロジックの実装から解放されます。

- Oracle Fusion Middleware内の広範な統合: UMSは、他のFusion Middlewareコンポーネントと統合して、単一の統合された双方向のユーザー・メッセージング・サービスを提供します。

- Oracle BPEL Process Managerとの統合: Oracle JDeveloperには、メッセージング操作に対応した事前作成のBPELアクティビティが含まれています。開発者は、目的のアクティビティを任意のワークフローにドラッグ・アンド・ドロップして、メッセージング機能をSOAコンポジット・アプリケーションに追加できます。

- ヒューマン・ワークフローとの統合: UMSによって、ヒューマン・ワークフロー・サービス・エンジンは、アクション可能なメッセージをユーザーに送信し、電子メールを介して返信を受信できるようになります。「ワークフロー通知プロパティ」ページのUMSを使用したヒューマン・ワークフローの構成の詳細は、第21.1項「ヒューマン・ワークフロー通知プロパティの構成」を参照してください。

- Oracle BAMとの統合: Oracle BAMでは、UMSを使用し、イベントの監視に対応した電子メール・アラートを送信します。

- Oracle WebCenterポータルとの統合: 開発者は、Oracle WebCenterポータル: スペースに対するアプリケーションの作成に、UMS APIを使用できます。このAPIは、Parlay X Web Services for Multimedia Messagingのバージョン2.1(強力なメッセージングに対する標準のWebサービス・インタフェース)を実現したものです。

27.1.1 コンポーネント

Oracle User Messaging Serviceを構成するコンポーネントには、次の3つのタイプがあります。これらのコンポーネントは標準のJava EEアプリケーションであるため、デプロイが容易であり、Oracle WebLogic Serverが提供する標準のツールを使用して管理できます。

- UMSサーバー: UMSサーバーは、アプリケーションとユーザー間のメッセージ・フローを統合します。このサーバーは、アウトバウンド・メッセージをクライアント・アプリケーションから適切なドライバにルーティングし、インバウンド・メッセージを適切なクライアント・アプリケーションにルーティングします。また、このサーバーは、以前送信したメッセージのリポジトリを永続ストアで保守し、配信ステータスの情報を以前送信したメッセージに関連付けます。

- UMSドライバ: UMSドライバは、UMSをメッセージング・ゲートウェイに接続し、UMSでサポートされている様々なプロトコルに対してコンテンツを適合させます。このドライバは、特定のインストールで使用できるメッセージング・チャネルに従って、相互に独立してデプロイまたはアンデプロイできます。

- UMSクライアント・アプリケーション: UMSクライアント・アプリケーションは、メッセージの送受信に関するビジネス・ロジックを実装します。UMSクライアント・アプリケーションは、BPELワークフローの1手順としてメッセージを送信するSOAアプリケーション、またはWebインタフェースからメッセージを送信できるWebCenterポータル・スペース・アプリケーションの場合があります。

UMS自体を構成するコンポーネントに加え、メッセージング環境における他の主なエンティティは、各メッセージング・チャネルに必要な外部ゲートウェイです。これらのゲートウェイは、UMSまたはOracle WebLogic Serverの一部ではありません。UMSドライバは、広範に適合できるメッセージング・プロトコルをサポートしているため、企業の電子メール・サーバーやXMPP (Jabber)サーバーなどの既存のインフラストラクチャにUMSを統合できます。また、UMSは、SMPPをサポートするSMSサービスや、VoiceXMLをサポートする音声変換サービスの外部プロバイダに接続できます。

27.1.2 アーキテクチャ

図27-1に、Oracle User Messaging Serviceのシステム・アーキテクチャを示します。

柔軟性を最大にするために、UMSの各コンポーネントは、それぞれが個別のJava EEアプリケーションです。このため、それらは相互に独立してデプロイおよび管理できます。たとえば、他のすべてのチャネルでのメッセージ配信に影響を与えずに、特定のドライバを停止して再構成できます。

UMSクライアント・アプリケーションとUMSサーバー間のデータ交換は、SOAP/HTTP WebサービスによるWebサービス・クライアントのリクエスト時に発生するか、リモートのEnterprise JavaBeans (EJB)とJMSによるBPELメッセージング・アクティビティのコールを介して発生します。UMSサーバーとUMSドライバ間のデータ交換は、JMSキューを介して発生します。

Oracle UMSのサーバーとドライバは、Oracle SOA SuiteまたはOracle BAMとともに、それぞれのOracle WebLogic Serverインスタンスにインストールされます。Oracle WebCenterポータルのインストールには、UMSクライアント・アプリケーションとして機能するために必要なライブラリが組み込まれ、SOAインスタンスにデプロイされているサーバーを起動します。

図27-1 UMSのアーキテクチャ

27.2 Oracle User Messaging Serviceの構成の概要

Oracle User Messaging Serviceによって、ユーザーは、Oracle JDeveloperを使用して開発し、Oracle WebLogic ServerにデプロイしたSOAアプリケーションから送信された通知を受信できます。

アプリケーション・レベルには、特定の配信チャネル(SMSまたは電子メールなど)に対する通知アクティビティがあります。たとえば、電子メール通知を送信するSOAアプリケーションを作成するときは、Oracle JDeveloperの「コンポーネント・パレット」からワークフロー内の適切な場所に、Emailアクティビティをドラッグ・アンド・ドロップします。アプリケーションでは、接続してから通知を送信します。

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

ワークフロー参加者が通知を受信して転送できるようにするには、Oracle Enterprise Manager Fusion Middleware Controlを使用して、Oracle User Messaging Service環境を設定します。この環境を設定するには、ワークフロー・アプリケーションのデプロイ先と同じOracle WebLogic Serverに適切なドライバ・インスタンスを構成します(図27-2)。Oracle User Messaging Serviceには、電子メール、IM、SMSおよびボイスの各チャネルを介したメッセージングをサポートするドライバが含まれています。詳細は、第27.4項「ユーザー・メッセージング・サービス・ドライバの構成」を参照してください。

図27-2 Oracle Enterprise Manager Fusion Middleware Control

ワークフローの参加者が通知を受信するには、メッセージのアクセスに使用するデバイスをユーザー・メッセージング・プリファレンスを介して登録する必要があります(図27-3)。

図27-3 ユーザー・メッセージング・プリファレンス

27.3 ユーザー・メッセージング・サービスの構成ページへのアクセス

Oracle Enterprise Manager Fusion Middleware Controlを使用して、Oracle User Messaging Serviceを構成します。

27.3.1 保管方法の設定

「サーバー・プロパティ」ページを使用して、メッセージング・サーバーのデプロイメント・タイプを設定し(つまり、ランタイム・データと管理データの保管方法を選択し)、メッセージ・フィルタの作成に使用するユーザー・メッセージング・プリファレンスのビジネス条件を追加(または削除)します。

「永続」(デフォルト)を選択すると、サーバーが再起動されたときに、エントリおよびメッセージング・ストアを永続化できます。一時モード(軽量なデプロイメントに推奨)では、メッセージング・サーバーは、再起動後にメッセージング・ストアに格納されたデータを保守しません。

27.3.2 ユーザー・メッセージング・プリファレンスのビジネス条件の追加または削除

「サーバー・プロパティ」ページを使用すると、ユーザー・メッセージ・プリファレンスでのメッセージ・フィルタの構築に使用するビジネス条件を追加または削除できます。ビジネス条件を使用したメッセージング・フィルタの作成の詳細は、第27.3.2.1項「ビジネス条件の追加」を参照してください。

27.3.2.1 ビジネス条件の追加

注意:

ビジネス条件は、サーバー・インスタンスごとに格納されます。複数のインスタンスがある場合(1つのクラスタ内にある場合も同様)は、新しいビジネス条件を各インスタンスに個別に追加する必要があります。

ユーザー・メッセージング・プリファレンスにビジネス条件を追加する手順は、次のとおりです。

1. 「追加」をクリックします。

2. ビジネス条件の記述名を入力します。

3. データ型(文字列、数値または日付など)を選択します。

4. 「適用」をクリックします。

27.3.2.2 ビジネス条件の削除

ユーザー・メッセージング・プリファレンスからビジネス条件を削除する手順は、次のとおりです。

1. 該当するビジネス条件を選択します。

2. 「削除」をクリックします。

3. 「適用」をクリックして、新規のビジネス条件を確認します。

27.4 ユーザー・メッセージング・サービス・ドライバの構成

Oracle User Messaging Serviceには、次のドライバが組み込まれています。

- メッセージング拡張ドライバの構成

- 電子メール・ドライバの構成

- SMPPドライバの構成

- XMPPドライバの構成

- VoiceXMLドライバの構成

- ワークリスト・ドライバの構成

- プロキシ・ドライバの構成

注意:

クラスタ環境では、管理対象サーバー・ノードごとに別々のメッセージング・ドライバを使用する場合は、すべてのドライバを個別に構成する必要があります。

UMSメッセージング・ドライバはインスタンスごとに構成されます。1つのみ構成した場合、その構成値は他のクラスタ・ノード上のドライバに移入されません。

27.4.1 ドライバの構成

ドライバを構成する手順は、次のとおりです。

1. Oracle Enterprise Manager Fusion Middleware Controlコンソールに管理者としてログインします。

2. 「Fusion Middleware」フォルダを開きます。

3. ユーザー・メッセージング・サービスのホーム・ページに移動します。

4. 「usermessagingserver(soa_server1)」をクリックします。「関連ドライバ」ページが表示されます。

5. 「ローカル」タブを選択して、UMSサーバー・インスタンスと関連付けられているドライバにアクセスします。これらのドライバは、正しく構成されているかどうかによって、UMSサーバーに登録されている場合と登録されていない場合があります。「すべて」タブには、ドメインにデプロイされており、かつ、すべてのUMSサーバー・インスタンスに登録されているドライバがすべてリストされます。

6. リスト内で電子メール・ドライバを検索し、その横にある「ドライバの構成」アイコンをクリックします。

構成ページが表示されます。

7. 必要に応じて、「ドライバ固有の構成」セクションを展開し、ドライバのパラメータを構成します。詳細は、第27.4.1.1項「ドライバ・プロパティの概要」を参照してください。

27.4.1.1 ドライバ・プロパティの概要

Oracle User Messaging Serviceの各ドライバは、アウトバウンド・メッセージをルーティングする際にメッセージング・エンジンで使用する共通プロパティ(表27-1に記載)を共有しています。通常、管理者が設定するプロパティは、ドライバ・コスト(Cost)とドライバ速度(Speed)、サポートされている電話会社(SupportedCarriers)、サポートされているプロトコル(SupportedProtocols)などのサービスのクオリティ(QoS)に関するプロパティです。ドライバ開発者が構成するプロパティは、管理者が通常変更する必要のない、サポートされている配信タイプ(SupportedDeliveryTypes)、サポートされているコンテンツ・タイプ(SupportedContentTypes)などです。

注意:

SendingQueuesInfoなどのプロパティは高度な使用を目的としており、高度なデプロイメント・トポロジに対してのみ変更が必要です。

表27-1 共通ドライバ・プロパティ

名前

説明

必須プロパティ?

Capability

ドライバの機能をメッセージの送信にするかまたは受信にするかを設定します。値はSEND、RECEIVEおよびBOTHです。

はい

Cost

ドライバのコスト・レベル(0から10)。0は最も低いコスト、10は最も高いコストです。値がこの範囲にない場合、コストは0とみなされます。

いいえ

DefaultSenderAddress

送信者のデフォルトのアドレス。ドライバがこれらのアドレスを使用するのは、送信者のアドレスが特定されていないメッセージを送信する場合、あるいは特定の送信者のアドレスが送信者アドレス・リストになく、アプリケーションが提供する送信者アドレスの使用をドライバがサポートしていない場合です。

いいえ

SenderAddresses

ドライバがサポートしている送信者アドレスのリスト。ドライバによって提供された場合、メッセージング・エンジンは、このリストを使用してメッセージの送信者アドレスと照合し、そのドライバに送信メッセージをルーティングできます。

いいえ

SendingQueuesInfo

ドライバの送信キューに関する情報。

はい

Speed

ドライバの速度レベル(0から10。10が最高速)。

いいえ

SupportedCarriers

サポートされている電話会社のカンマ区切りのリスト。

いいえ

SupportedContentTypes

ドライバでサポートされているコンテンツ・タイプ。

はい

SupportedDeliveryTypes

ドライバでサポートされている配信タイプ。

はい

SupportedProtocols

サポートされているプロトコルのカンマ区切りのリスト。任意のプロトコルに対してアスタリスク(*)を入力します。

いいえ

SupportedStatusTypes

ドライバでサポートされているステータス・タイプ。

いいえ

SupportsCancel

メッセージの取消し操作をサポート。

いいえ

SupportsReplace

メッセージの置換操作をサポート。

いいえ

SupportsStatusPolling

特定のプロトコルについては、リモート・ゲートウェイのアクティブ・ポーリングを実行して、以前に送信したメッセージのステータスをチェックする必要があります。このプロパティは、ドライバでこのようなステータス・ポーリングがサポートされているかどうかを示します。trueに設定されている場合は、メッセージング・エンジンによって、ドライバ接続のgetStatus()操作が起動されます。

いいえ

SupportsTracking

メッセージのトラッキング操作をサポート。

いいえ

27.4.1.2 パスワードの保護

ドライバの重要なプロパティ(パスワード)は、Oracle Enterprise Manager Fusion Middleware Controlを使用して資格証明ストアに安全に格納できます。プロパティは「エンコード済資格証明」フラグでマークされ、カスタムの入力フォーム・フィールドがあります。

ドライバの重要なプロパティを安全に格納する手順は、次のとおりです。

1. 選択したドライバのドライバ構成ページに移動します。

2. 「ドライバ固有の構成」セクションで、「エンコード済資格証明」フラグが設定されているプロパティを検索します。

3. 資格証明のタイプを選択します。(選択した資格証明のタイプに従って、ユーザー名またはパスワード(あるいはその両方)の入力が求められます。)次の3つのオプションがあります。

- 間接パスワード、新規のユーザーの作成(デフォルトのオプション): ユーザー名と実際のパスワードを指定し、このパスワードは、ユーザー名とともに資格証明ストアにキーの一部として格納されます。このキーと固定フォルダ(マップ名)は、ドライバ・デプロイメントのdriverconfig.xmlファイルに格納されます。

- 間接パスワード、既存のユーザーの使用: (以前に保存したパスワードを参照するために)資格証明ストアにある既存のユーザー名/キーを選択します。

- クリアテキスト・パスワードの使用: パスワードを指定し、driverconfig.xmlファイルに直接保存します。

4. 「適用」をクリックして変更を保存します。

5. ドライバ・アプリケーションまたはコンテナを再起動して、変更内容を有効にします。

パスワードは、ドライバ・デプロイメント・ディレクトリのdriverconfig.xmlファイルで確認できます。間接パスワードの場合のフォーマットは、次のようになります。

value="->mapName:keyName"    (mapName is the driver target name, and the key is <parameter_name>.<username>)

電子メール・ドライバのOutgoingPasswordプロパティに関するdriverconfig.xmlのサンプル入力を次に示します。

<Property value="-&gt;
/Farm_base_domain/base_domain/server_soa/usermessagingdriver-email:
OutgoingPassword.ouser" encodedCredential="true"
type="java.lang.String" mandatory="no" name="OutgoingPassword"
description="oracle.sdp.messaging.EmailDriverConfig.outgoingPassword"/>

27.4.1.3 メッセージング拡張ドライバの構成

拡張ドライバは、任意の管理者定義チャネル(プロトコル)のサポートを有効にし、このようなチャネルの通知を管理者定義のWebサービス・リスナー・エンドポイントに配信することで、ユーザー・メッセージング・サービスのメッセージング機能を拡張します。

注意:

このドライバのインスタンスはデプロイされますが、デフォルト・インストールではどのサーバーにもターゲット設定されていません。このドライバ・インスタンスを有効化するには、UMS (usermessagingserver)が稼働している適切なサーバーにターゲット設定する必要があります。

27.4.1.3.1 ドライバ・アプリケーション・アーカイブ(EAR)

EARファイルは、$oracle_home/communications/applications/sdpmessagingdriver-extension.earです。

27.4.1.3.2 共通プロパティ

これらは共通のドライバ・プロパティで、このドライバの機能を示しており、これらの機能は、メッセージング・エンジンがアウトバウンド・メッセージをルーティングする際に使用されます。通常、ドライバ開発者が設定する一部のプロパティは変更不要ですが、他のプロパティは、ルーティング動作を変更するために、管理者が変更できます。(sendingqueuesinfoなどの)一部のプロパティは、高度な使用を目的としており、高度なデプロイメント・トポロジに対してのみ変更が必要です。表27-2を参照してください。これらのプロパティと使用可能な値の詳細は、driverconfigpropertynamesのJavaDocを参照してください。

表27-2 拡張ドライバの共通プロパティ

名前

説明

必須?

デフォルト値

InstanceName

インスタンス名(内部使用のみ)。

はい

Extension-Driver

Capability

メッセージの送受信機能

はい

SEND

SupportedDeliveryTypes

サポートされている配信タイプ

はい

URI

SupportedContentTypes

サポートされているコンテンツ・タイプ

はい

text/plain, text/html, text/xml

SupportedStatusTypes

サポートされているステータス・タイプ

いいえ

DELIVERY_TO_GATEWAY_SUCCESS, DELIVERY_TO_GATEWAY_FAILURE

コスト

コスト

いいえ

Speed

速度

いいえ

SupportedCarriers

サポートされている電話会社

いいえ

SupportedProtocols

サポートされているプロトコル

いいえ

popup

SupportsCancel

メッセージの取消し操作をサポートします

いいえ

False

SupportsReplace

メッセージの置換操作をサポートします

いいえ

False

SupportsTracking

メッセージの追跡操作をサポートします

いいえ

False

SupportsStatusPolling

メッセージのステータス・ポーリング操作をサポートします

いいえ

False

SenderAddresses

送信者のアドレス

いいえ

DefaultSenderAddress

デフォルトの送信者アドレス

いいえ

SendingQueuesInfo

ドライバによるキュー情報の送信

はい

OraSDPM/QueueConnectionFactory:OraSDPM/Queues/OraSDPMDriverDefSndQ1

27.4.1.3.3 カスタム・プロパティ

このドライバは、拡張エンドポイント・グループと呼ばれる複数の構成グループをサポートします。拡張エンドポイント・グループには、拡張通知を配信するリモート・エンドポイントの構成が保持されます。各エンドポイントには、それぞれ異なるプロトコルとマップされたドメインの組合せが必要です。拡張エンドポイント・グループのプロパティを表27-3に示します。

表27-3 拡張ドライバのカスタム・プロパティ

名前

説明

必須?

グループ名

この拡張エンドポイント構成グループの名前。

はい

エンドポイントURL

リモート・エンドポイント・リスナーURL。

はい

マップされたドメイン

受信者URIのドメイン部分がこの値と一致した場合に、メッセージの配信に使用される拡張エンドポイント。

いいえ

プロトコル

受信者URIのプロトコル(スキーム)部分がこの値と一致した場合に、メッセージの配信に使用される拡張エンドポイント。

はい

セキュリティ・ポリシー

このエンドポイントに適用されるWS-Securityポリシーのカンマ区切りのリスト。

いいえ

ユーザー名

WS-Securityヘッダーを介して伝播されるユーザー名。

いいえ

キーストア別名

WS-Securityポリシーの公開鍵の参照に使用するキーストア別名。

いいえ

資格証明ストア・キー

Oracle Web Services Managementの資格情報ストア・マップからWS-Securityのユーザー名およびパスワードを検索するために使用するキー。

いいえ

27.4.1.3.4 拡張ドライバのセキュリティ

リモート拡張エンドポイントがWS-Securityを使用して保護されている場合は、拡張ドライバの追加構成が必要です。2つの一般的なWS-Security構成がサポートされています。拡張ドライバではSAMLトークンまたはユーザー名トークンのいずれかを使用できます。

拡張ドライバのセキュリティを使用する手順は、次のとおりです。

1. SAMLトークンを使用するには、「セキュリティ・ポリシー」構成プロパティに値oracle/wss11_saml_token_identity_switch_with_message_protection_client_policyが含まれ、「キーストア別名」構成プロパティにリモート拡張エンドポイントで受け入れられる有効なキーストア・エントリの別名が含まれている必要があります。

2. ユーザー名トークンを使用するには、Security Policies構成プロパティに値oracle/wss11_username_token_with_message_protection_client_policyが含まれ、「資格証明ストア・キー」構成プロパティにリモート拡張エンドポイントで受け入れられる有効な資格情報ストア・エントリの別名が含まれている必要があります。

WS-Securityポリシーの詳細は、『Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイド』を参照してください。

27.4.1.3.5 クライアントAPI MessageInfoのサポート

表27-4は、次のメッセージ配信関連のプロパティに対するプロトコルまたはドライバの実装による影響を示しています。これらのプロパティは、クライアントAPIを介して指定されます。

表27-4 クライアントAPI MessageInfoのサポート

名前

説明

サポート対象か

Expiration

Expirationは、メッセージの期限が切れるまでの秒数を意味します。

False

Delay

Delayは、メッセージを送信するまでの秒数を意味します。

False

27.4.1.3.6 使用手順

拡張ドライバを使用するには、次の手順を実行します。

拡張ドライバを使用する手順は、次のとおりです。

1. MessagingNotifyService WSDL (umsnotify.wsdl)を基に、Webサービス・リスナー・エンドポイントを実装およびデプロイします。

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:tns="http://xmlns.oracle.com/ucs/messaging/extension"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
name="MessagingNotifyService"
targetNamespace="http://xmlns.oracle.com/ucs/messaging/extension">

<wsdl:types>

<xsd:schema targetNamespace="http://xmlns.oracle.com/ucs/messaging/extension">
<xsd:element name="notification">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="messageId" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>Unique message identifier from User
Messaging Service.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="sender" type="xsd:string">
<xsd:annotation>
<xsd:documentation>The sender address.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="recipient" type="xsd:string">
<xsd:annotation>
<xsd:documentation>The recipient address (typically
username).</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="subject" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>The subject of the message, if
available.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="contentType" type="xsd:string"
default="text/plain">
<xsd:annotation>
<xsd:documentation>The MIME type of the message. e.g.
text/plain, text/html, text/xml.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="content" type="xsd:string">
<xsd:annotation>
<xsd:documentation>The main body of the message. Textual
content only (no binary content).</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="parameters" type="tns:parameter" minOccurs="0"
maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Additional key-value pairs. This interface
does not define any specific key-value pair meanings. Use of such parameters
is defined on a private basis by particular implementations of this interface.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:complexType name="parameter">
<xsd:sequence>
<xsd:element name="name" type="xsd:string">
<xsd:annotation>
<xsd:documentation>Parameter name</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="value" type="xsd:string">
<xsd:annotation>
<xsd:documentation>Parameter value</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:element name="notificationResponse">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="messageId" type="xsd:string" minOccurs="0"
maxOccurs="1">
<xsd:annotation>
<xsd:documentation>A message identifier returned in response to
successfully accepting the message. If returned, the identifier should be
unique. Note: A fault is raised if the message cannot be
accepted.</xsd:documentation>
</xsd:annotation></xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="notificationFault">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="code" type="xsd:string"/>
<xsd:element name="message" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>
</wsdl:types>
<wsdl:message name="notifyRequest">
<wsdl:part element="tns:notification" name="parameters" />
</wsdl:message>
<wsdl:message name="notifyResponse">
<wsdl:part element="tns:notificationResponse" name="parameters"/>
</wsdl:message>
<wsdl:message name="notifyException">
<wsdl:part element="tns:notificationFault" name="parameters"/>
</wsdl:message>
<wsdl:portType name="Notify">
<wsdl:operation name="invoke">
<wsdl:input message="tns:notifyRequest"/>
<wsdl:output message="tns:notifyResponse"/>
<wsdl:fault message="tns:notifyException" name="NotifyException"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="NotifySOAPBinding" type="tns:Notify">
<soap:binding style="document"
transport="http://schemas.xmlsoap.org/soap/http" />
<wsdl:operation name="invoke">
<soap:operation
soapAction="http://www.oracle.com/ucs/messaging/extension" />
<wsdl:input>
<soap:body use="literal" />
</wsdl:input>
<wsdl:output>
<soap:body use="literal" />
</wsdl:output>
<wsdl:fault name="NotifyException">
<soap:fault name="NotifyException" use="literal"/>
</wsdl:fault>
</wsdl:operation>
</wsdl:binding>

<wsdl:service name="NotifyService">
<wsdl:port binding="tns:NotifySOAPBinding" name="Notify">
<soap:address location="http://localhost:8001/NotifyService"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

2. 拡張ドライバを構成します。

1. usermessagingdriver-extensionという事前デプロイ済の拡張ドライバまたは新しいデプロイメントを、UMS (usermessagingserver)が稼働している適切なサーバーにターゲット設定して、ドライバを起動します。

2. Enterprise Manager Fusion Middleware Controlで、usermessagingserverのホーム・ページに移動します。

3. 「ユーザー・メッセージング・サービス」→「ドライバ・プロパティ」の順にクリックします。

4. ドライバusermessagingdriver-extensionを選択して編集するか、新しいドライバ・デプロイメントと同じ名前で新しいドライバを作成します。

5. 「ドライバ固有の構成」で、新しい拡張エンドポイント構成グループを追加し、適切なプロパティを指定します - EndpointURLは、ステップ1で作成したWebサービス・リスナー・エンドポイントへのURLです。Protocolは、通知サポートを追加する新しいメッセージング・チャネルの値(popupなど)です。

6. 「共通構成」で、Supported Protocolsを、各拡張エンドポイント・グループに定義されているプロトコルのカンマ区切りのリストで更新します。

7. 「OK」をクリックして、構成を保存します。

これで、拡張ドライバを使用したUMSでの新しいメッセージング・チャネル(プロトコル)の構成および統合は完了です。

この新しいチャネル(プロトコル)に通知を送信するには、URIアドレッシング形式を使用して、URI配信タイプに受信者を指定する必要があります。

URI:scheme:scheme-specific-address-value

ここで、schemeはプロトコルです。URI配信タイプはオプションです。たとえば、拡張ドライバがプロトコルpopupをサポートするように構成されている場合、アプリケーションでpopup:john.doe@example.com宛のメッセージを作成できます。

また、エンド・ユーザーは、ワークリスト/UMSプリファレンスUIで新しいチャネル・タイプの新しいメッセージング・チャネルを作成することによって、メッセージング・プリファレンスを宣言することもできます。ユーザー・プリファレンスは、アプリケーションがユーザーベースの通知(つまり、USER:usernameの形式の受信者宛)を送信する場合にのみ適用されます。

注意:

UMSと電子メール・サーバー間にセキュアな接続を実現するには、Oracle WebLogic Serverコンテナ内でSSL/TLSが適切に構成されていることが前提条件となります。『Oracle Fusion Middleware Oracle WebLogic Serverの保護』のSSLの構成に関する項を参照してください。

27.4.1.4 電子メール・ドライバの構成

電子メール・ドライバは、メッセージの送受信両方を実行します(すなわち、デフォルトでcapabilityプロパティはbothに設定されています)。電子メール・ドライバはSMTPを通じてメッセージを送信し、メッセージの受信にはIMAPまたはPOP3のいずれかを使用します。

注意:

「ワークフロー通知プロパティ」ページのヒューマン・ワークフローを使用した電子メール・ドライバの構成の詳細は、第21.1項「ヒューマン・ワークフロー通知プロパティの構成」を参照してください。

ヒューマン・ワークフロー通知の問題のトラブルシューティングの詳細は、表27-29「UMSのトラブルシューティング」を参照してください。

27.4.1.4.1 電子メール・ドライバの互換性

この項では、電子メール・ドライバの互換性機能について詳細に説明します。

電子メール・ドライバは、POP3、IMAP4およびSMTPの各プロトコルと互換性があります。

注意:

高可用性環境ではIMAPをプロトコルに指定することをお薦めします。

電子メール・ドライバの機能は、次のとおりです。

- 自動接続再試行

- メッセージ送信にSMTPを使用

- メッセージ受信にIMAP4およびPOP3を使用(ポーリングを使用)

- スケーラブルおよび高可用性

- メッセージ消失の防止および重複の回避

表27-5のゲートウェイ・ベンダーとバージョンが検証済です。

表27-5 電子メール・ドライバのゲートウェイ・ベンダーとバージョン

ベンダー

バージョン

Oracle Beehive

リリース1 (1.4.3)

Oracle Collaboration Suite

10g リリース1 (10.1.2)

Microsoft Exchange

2003

Dovecot (IMAP4/POP3)

0.99.11

sendmail (SMTP)

8.13.1

27.4.1.4.2 共通プロパティ

表27-6に、メッセージング・エンジンがアウトバウンド・メッセージをルーティングする際に使用する、このドライバの機能を示す共通プロパティをリストします。通常、ドライバ開発者が設定する一部のプロパティは変更不要ですが、他のプロパティは、ルーティング動作を変更するために、管理者が変更できます。sendingqueuesinfoなどの一部のプロパティは、高度な使用を目的としており、高度なデプロイメント・トポロジに対してのみ変更が必要となります。これらのプロパティと使用可能な値の詳細は、driverconfigpropertynamesのJavaDocを参照してください。

表27-6 共通の電子メール・プロパティ

名前

説明

必須

デフォルト値

InstanceName

インスタンス名(内部使用のみ)。

はい

Email-Driver

Capability

メッセージの送受信機能

はい

Both

SupportedDeliveryTypes

サポートされている配信タイプ

はい

電子メール

SupportedContentTypes

サポートされているコンテンツ・タイプ

はい

text/plain, text/html, multipart/mixed, multipart/alternative, multipart/related

SupportedStatusTypes

サポートされているステータス・タイプ

いいえ

DELIVERY_TO_GATEWAY_SUCCESS, DELIVERY_TO_GATEWAY_FAILURE, USER_REPLY_ACKNOWLEDGEMENT_SUCCESS, USER_REPLY_ACKNOWLEDGEMENT_FAILURE

Cost

コスト

いいえ

N/A

Speed

速度

いいえ

N/A

SupportedCarriers

サポートされている電話会社

いいえ

N/A

Supported Protocols

サポートされているプロトコル

いいえ

N/A

SupportsCancel

メッセージの取消し操作をサポートします

いいえ

False

SupportsReplace

メッセージの置換操作をサポートします

いいえ

False

SupportsTracking

メッセージの追跡操作をサポートします

いいえ

False

SupportsStatusPolling

メッセージのステータス・ポーリング操作をサポートします

いいえ

False

SenderAddresses

送信者のアドレス

いいえ

N/A

DefaultSenderAddress

デフォルトの送信者アドレス

いいえ

N/A

SendingQueuesInfo

ドライバによるキュー情報の送信

はい

OraSDPM/QueueConnectionFactory:OraSDPM/Queues/OraSDPMDriverDefSndQ1

27.4.1.4.3 電子メールのカスタム・プロパティ

表27-7に、このドライバに固有のプロパティを示します。これらは通常、リモート・ゲートウェイへのアクセス構成、および特定のプロトコルやチャネル固有の動作に関連します。

注意:

受信電子メールにUMSを使用する場合は、次のフィールドを構成する必要があります。

- IncomingMailServer

- IncomingMailServerPort

- IncomingMailIDs

- IncomingUserIDs

- IncomingUserPasswords

表27-7 カスタムの電子メール・プロパティ

名前

説明

必須?

デフォルト値

* これらのフィールドは、受信電子メールにUMSを使用する場合のみ構成する必要があります。

MailAccessProtocol

電子メール受信プロトコル。設定可能な値はIMAPおよびPOP3です。電子メールの受信がドライバ・インスタンスでサポートされている場合のみ必要です。

いいえ

IMAP

RetryLimit

この値は、なんらかの理由で接続が失われた場合の受信メール・サーバーへの接続再試行回数を指定します。デフォルト値は-1で、試行回数に制限がないことを示します。

いいえ

-1

MailDelFreq

削除済メッセージを永続的に削除する頻度。単位は秒で、デフォルト値は600秒です。負の値は、メッセージを消去しないことを示します。POP3プロトコルの場合、メッセージは処理後に消去されます。

いいえ

600

AutoDelete

この値は、メッセージの処理後にドライバがメッセージに削除のマークを付けるかどうかを示します。デフォルトは「無効」です。POP3プロトコルの場合、メッセージは常に処理直後に削除されます。

いいえ

無効

Debug

この値は、ドライバがデバッグ・モードで実行されているかどうかを示します。有効になっている場合、電子メール・ドライバとメール・サーバー間のリクエストとレスポンスがJavaMailによってFusion Middleware Controlに出力されます。デフォルトは「無効」です。

いいえ

無効

CheckMailFreq

電子メール・サーバーからメッセージを取得する頻度。単位は秒で、デフォルト値は30秒です。

いいえ

30

ReceiveFolder

ドライバがメッセージをポーリングするフォルダの名前。デフォルト値はINBOXです。

いいえ

INBOX

OutgoingMailServer

SMTPサーバーの名前。電子メールの送信が必要な場合のみ必須です。

いいえ

N/A

OutgoingMailServerPort

SMTPサーバーのポート番号。通常は25です。

いいえ

25

OutgoingMailServerSecurity

SMTPサーバーで使用されるセキュリティ設定。設定可能な値は「なし」、「TLS」および「SSL」です。デフォルト値は「なし」です。

いいえ

なし

OutgoingDefaultFromAddr

デフォルトの送信者アドレス(送信メッセージで指定されていない場合)。

いいえ

N/A

OutgoingUsername

SMTP認証に使用するユーザー名。SMTP認証がSMTPサーバーでサポートされている場合のみ必要です。

いいえ

N/A

OutgoingPassword

SMTP認証に使用するパスワード。SMTP認証がSMTPサーバーでサポートされている場合のみ必要です。パスワードのタイプ(「間接パスワード、新規のユーザーの作成」、「間接パスワード、既存のユーザーの使用」、「クリアテキスト・パスワードの使用」から選択)とパスワードが含まれています。

いいえ

N/A

IncomingMailServer

受信メール・サーバーのホスト名。電子メールの受信がドライバ・インスタンスでサポートされている場合のみ必要です。

いいえ*

N/A

IncomingMailServerPort

IMAP4サーバーのポート番号(143または993)、またはPOP3サーバーのポート番号(110または995)。

いいえ*

N/A

IncomingMailServerSSL

IMAP4またはPOP3サーバーへの接続時にSSLを有効にするかどうかを指定します。デフォルトは「無効」です。

いいえ*

無効

IncomingMailIDs

ユーザー名に対応する電子メール・アドレス。各電子メール・アドレスはカンマで区切られ、対応するユーザー名がユーザー名リストに表示されているとおりに、リスト内で同じ位置に配置されている必要があります。電子メールの受信がドライバ・インスタンスでサポートされている場合のみ必要です。

いいえ*

N/A

IncomingUserIDs

ドライバ・インスタンスがポーリングするメール・アカウントのユーザー名のリスト。各名前はカンマで区切られている必要があります(例: foo,bar)。電子メールの受信がドライバ・インスタンスでサポートされている場合のみ必要です。

いいえ*

N/A

IncomingUserPasswords

ユーザー名に対応するパスワードのリスト。各パスワードはカンマで区切られ、対応するユーザー名がユーザー名リストに表示されているとおりに、リスト内で同じ位置に配置されている必要があります。電子メールの受信がドライバ・インスタンスでサポートされている場合のみ必要です。パスワードのタイプ(「間接パスワード、新規のユーザーの作成」、「間接パスワード、既存のユーザーの使用」、「クリアテキスト・パスワードの使用」から選択)とパスワードが含まれています。

いいえ*

N/A

ProcessingChunkSize

メッセージ・ポーリングごとに処理されるメッセージ数。デフォルトは 100 です。

いいえ

100

ImapAuthPlainDisable

IMAPユーザー認証のプレーン・テキスト認証(AUTHENTICATE PLAINコマンド)を無効にするか有効にするかを指定します。デフォルトは「無効」です。

いいえ

無効。このプロパティが無効の場合は、プレーン・テキストが許可されることを意味します。

27.4.1.4.4 クライアントAPI MessageInfoのサポート

次に、メッセージ配信関連のプロパティを示します。これらのプロパティは、クライアントAPIを介して指定されます。表27-8は、これらのプロパティに対するプロトコルまたはドライバの実装による影響を示しています。

表27-8 クライアントAPI MessageInfoのサポート

名前

説明

サポート

Expiration

Expirationは、メッセージの期限が切れるまでの期間を意味します。

False

Delay

Delayは、メッセージを送信するまで必要な経過時間を意味します。

False

27.4.1.5 SMPPドライバの構成

Short Message Peer-to-Peer (SMPP)は、一般的なGSM SMSプロトコルです。ユーザー・メッセージング・サービスには、事前作成のSMPPプロトコルの実装がドライバとして含まれています。このドライバは、ショート・メッセージを送受信できます。送信機能が有効な場合、SMPPドライバは送信用の送信ドライバとしてショート・メッセージ・サービス・センター(SMS-C)にTCP接続を開きます。ドライバの受信機能が有効な場合は、受信用の受信ドライバとしてSMS-Cに別の接続を開きます。ドライバとSMS-C間のすべての通信に必要なのは、2つのTCP接続(両方ともドライバが開始する)のみです。

注意:

SMPPドライバは、SMPPプロトコルのバージョン3.4を実装し、このバージョンをサポートするSMS-CまたはSMSゲートウェイへの接続のみをサポートします。

27.4.1.5.1 SMPPドライバの互換性

この項では、SMPPドライバの互換性機能について詳細に説明します。

SMPPドライバは、SMPP v3.4プロトコルと互換性があります。

SMPPドライバの機能は、次のとおりです。

- 自動接続再試行

- ファイアウォール・トラバースにHTTPプロキシを使用

- 認証構成

- 構成可能なチャンク・サイズ

- 一括送信

- エンコーディング: UCS2、IA5、GSM_DEFAULT

- 優先度設定

- 構成可能なウィンドウ・サイズ

- プレーン・テキスト・コンテンツのみを使用

表27-9のゲートウェイ・ベンダーが検証済です。

表27-9 SMPPドライバのゲートウェイ・ベンダー

ベンダー

Syniverse

Clickatell

Logica CMG

OpenSMPP (simulator)

27.4.1.5.2 共通プロパティ

表27-10に、メッセージング・エンジンがアウトバウンド・メッセージをルーティングする際に使用する、このドライバの機能を示す共通プロパティをリストします。通常、ドライバ開発者が設定する一部のプロパティは変更不要ですが、他のプロパティは、ルーティング動作を変更するために、管理者が変更できます。SendingQueuesInfoなどの一部のプロパティは、高度な使用を目的としており、高度なデプロイメント・トポロジに対してのみ変更が必要です。これらのプロパティと使用可能な値の詳細は、DriverConfigPropertyNamesのJavaDocを参照してください。

表27-10 共通のSMPPプロパティ

名前

説明

必須

デフォルト値

InstanceName

インスタンス名(内部使用のみ)。

はい

SMPP-Driver

Capability

メッセージの送受信機能

はい

Both

SupportedDeliveryTypes

サポートされている配信タイプ

はい

SMS

SupportedContentTypes

サポートされているコンテンツ・タイプ

はい

text/plain

SupportedStatusTypes

サポートされているステータス・タイプ

いいえ

DELIVERY_TO_GATEWAY_SUCCESS, DELIVERY_TO_GATEWAY_FAILURE

Cost

コスト

いいえ

N/A

Speed

速度

いいえ

N/A

SupportedCarriers

サポートされている電話会社

いいえ

N/A

Supported Protocols

サポートされているプロトコル

いいえ

N/A

SupportsCancel

メッセージの取消し操作をサポートします

いいえ

False

SupportsReplace

メッセージの置換操作をサポートします

いいえ

False

SupportsTracking

メッセージの追跡操作をサポートします

いいえ

False

SupportsStatusPolling

メッセージのステータス・ポーリング操作をサポートします

いいえ

False

SenderAddresses

送信者のアドレス

いいえ

N/A

DefaultSenderAddress

デフォルトの送信者アドレス

いいえ

N/A

SendingQueuesInfo

ドライバによるキュー情報の送信

はい

OraSDPM/QueueConnectionFactory:OraSDPM/Queues/OraSDPMDriverDefSndQ1

27.4.1.5.3 カスタム・プロパティ

表27-11に、このドライバに固有のプロパティを示します。これらは通常、リモート・ゲートウェイへのアクセス構成、および特定のプロトコルやチャネル固有の動作に関連します。

表27-11 カスタムのSMPPプロパティ

名前

説明

必須?

デフォルト値

SmsAccountId

SMS-CのアカウントID。

はい

N/A

SmsServerHost

SMS-Cサーバーの名前(またはIPアドレス)。

はい

N/A

TransmitterSystemId

メッセージの送信に使用するアカウントID。

はい

N/A

ReceiverSystemId

メッセージの受信に使用するアカウントID。

はい

N/A

TransmitterSystemType

送信側システムのタイプ。デフォルトはLogicaです。

はい

デフォルト値はLogicaです。

ReceiverSystemType

受信側システムのタイプ。デフォルトはLogicaです。

はい

デフォルト値はLogicaです。

TransmitterSystemPassword

送信側システムのパスワード。パスワードのタイプ(「間接パスワード、新規のユーザーの作成」、「間接パスワード、既存のユーザーの使用」、「クリアテキスト・パスワードの使用」から選択)とパスワードが含まれています。

はい

N/A

ReceiverSystemPassword

受信側システムのパスワード。パスワードのタイプ(「間接パスワード、新規のユーザーの作成」、「間接パスワード、既存のユーザーの使用」、「クリアテキスト・パスワードの使用」から選択)とパスワードが含まれています。

はい

N/A

ServerTransmitterPort

送信側サーバーのTCPポート番号。

はい

N/A

ServerReceiverPort

受信側サーバーのTCPポート番号。

はい

N/A

DefaultEncoding

SMPPドライバのデフォルトのエンコーディング。デフォルトはIA5です。ドロップダウン・リストから「IA5」、「UCS2」または「GSM_DEFAULT」を選択します。

いいえ

IA5

EncodingAutoDetect

有効になっている場合、SMPPドライバは自動的にエンコードします。デフォルトは「有効」です。

いいえ

有効

LocalSendingPort

SMPPドライバがSMS-Cへのメッセージの送信に使用するローカルTCPポート。

いいえ

N/A

LocalReceivingPort

SMPPドライバがSMS-Cからのメッセージの受信に使用するローカルTCPポート。

いいえ

N/A

LocalAddress

SMPPドライバをホスト管理するサーバーのホスト名(またはIPアドレス)。

いいえ

N/A

WindowSize

SMSのウィンドウ・サイズ。値は正数である必要があります。デフォルトは1です。

いいえ

1

EnquireInterval

SMS-Cへの問合せメッセージの送信間隔(秒単位)。デフォルトは、30秒間です。

いいえ

30

ThrottleDelay

スロットル間の遅延(秒単位)。デフォルトは 30 です。

いいえ

30

BindRetryDelay

バインド・エントリの試行間の最小遅延(秒単位)。デフォルトは 30 です。

いいえ

30

ResponseTimer

SMPPリクエストとレスポンス間に許可された経過時間(秒単位)。デフォルトは30です。

いいえ

30

RegisteredDeliveryMask

登録済配信ビット・マスク。デフォルトは0xFFで、配信フラグ値を変更しません。

いいえ

0xFF

RangeSetNull

trueに設定すると、BIND_RECEIVERのアドレス範囲フィールドがnullに設定されます。false(デフォルト値)に設定すると、アドレス範囲フィールドがSmsSystemIdに設定されます。デフォルトは「無効」です。

いいえ

無効

PriorityAllowed

SMPPドライバに許容されている最高優先度。範囲は0(標準)から3(最高)です。デフォルトは0です。

いいえ

0

BulkSending

この値を 「有効」 (デフォルト値)に設定すると、複数のメッセージをSMS-Cに対して一括送信できます。

No

有効

PayloadSending

このプロパティを有効にすると、SMPPドライバはSMS-Cにメッセージを送信する際、常にSMPP仕様で定義されているmessage_payloadパラメータを使用します。デフォルトは「無効」です。

いいえ

無効

SourceTon

SMPP受信側セッションを経由して提供されるESMEアドレスの番号のタイプ(TON)。デフォルトは0です。

いいえ

0

SourceNpi

SMPP受信側セッションを経由して提供されるESMEアドレスの番号計画識別子(NPI)。デフォルトは0です。

いいえ

0

DestinationTon

宛先のTON。デフォルトは0です。

いいえ

0

DestinationNpi

宛先のNPI。デフォルトは0です。

いいえ

0

ExtraErrorCode

エラー・コードのカンマ区切りのリスト。

いいえ

N/A

MaxChunks

1メッセージに対する最大SMSチャンク数。デフォルトは-1(最大値なし)です。

いいえ

-1(最大値なし)

ChunkSize

各SMSメッセージ・チャンクのサイズ。デフォルトは160です。

いいえ

160

LongMessageSending

長いメッセージの送信をサポートします。デフォルトは「無効」です。

いいえ

無効

DatagramMessageMode

データグラム・メッセージ・モードをサポートします。デフォルトは「無効」です。

いいえ

無効

27.4.1.5.4 クライアントAPI MessageInfoのサポート

次に、メッセージ配信関連のプロパティを示します。これらのプロパティは、クライアントAPIを介して指定されます。表27-12は、これらのプロパティに対するプロトコルまたはドライバの実装による影響を示しています。

表27-12 クライアントAPI MessageInfoのサポート

名前

説明

サポート

Expiration

Expirationは、メッセージの期限が切れるまでの期間を意味します。

True

Delay

Delayは、メッセージを送信するまで必要な経過時間を意味します。

False

27.4.1.6 XMPPドライバの構成

XMPPドライバは、Extensible Messaging and Presence Protocol (XMPP)を介したリアルタイムIMの場合に、Oracle Fusion Middlewareからエンド・ユーザーへの一方向および双方向のアクセスを提供します。このドライバを使用すると、エンド・ユーザーは、選択したIMクライアントを介して、アラート通知を受信したり、複数のアプリケーションと相互にチャットできます。

27.4.1.6.1 XMPPの概要

XMPPは、IMおよびプレゼンスに対するXMLベースのオープン・プロトコルです。XMPPベースのソフトウェアは、インターネットを介して多数のサーバーにデプロイされており、世界中に何百万人ものユーザーがいます。XMPPは、ユビキタス電子メール・ネットワークに類似した、クライアント/サーバー・アーキテクチャで構成されています。XMPPサーバーは、完全に分散化されているため、誰でも自分のサーバーを設定できます。メッセージングは電子メール・ネットワーク内と同様に実行され、受信者のアドレスには[username]@domain[/resource]という形式のXMPP ID(またはJabber ID、つまりJID)が使用されます。アドレッシング・スキームの詳細は、RFC 3920を参照してください。

XMPPネットワークでは、ユーザーは前述のXMPP IDによって識別されます(このIDは、通常、ユーザーが接続するXMPPサーバーのユーザー名とドメインで構成されています)。XMPPのエンド・ユーザーは、XMPPクライアントを使用してXMPPサーバーに接続して、インスタント・メッセージを他のXMPPユーザーに送信します。ただし、XMPPはIMに利用できる唯一のプロトコル・ネットワークではありません。XMPPには、拡張可能なモジュール型アーキテクチャがあります。これは固有のIMネットワークに統合され、XMPPユーザーは他のネットワーク上のユーザーと通信できるようになります。

UMSでXMPPドライバを使用するには、Jabber/XMPPサーバーへのアクセス権と、ログインに使用するUMS XMPPドライバ・インスタンスのXMPPアカウントが必要です。

27.4.1.6.2 XMPPドライバの互換性

この項では、XMPPドライバの互換性機能について詳細に説明します。

XMPPドライバは、XMPP (RFC 3920、3921)のプロトコルと互換性があります。

XMPPドライバの機能は次のとおりです。

- 自動接続再試行

- ファイアウォール・トラバースにHTTPプロキシを使用

- プレーン・テキスト・コンテンツのみを使用

表27-13のゲートウェイ・ベンダーとバージョンが検証済です。

表27-13 XMPPドライバのゲートウェイ・ベンダーとバージョン

ベンダー

バージョン

ejabberd

2.1.3

jabberd2

2.2.14

jabberd14

1.6.1.1-p1

Oracle Beehive

2.0.1.2.1

27.4.1.6.3 サード・パーティ・ソフトウェア

XMPPドライバは、次のサード・パーティ・ソフトウェアを使用または必要とします(オプションで、独自のXMPPサーバーをインストールして構成することもできます)。

表27-14 必要なサード・パーティ・ソフトウェア

名前

説明

バージョン

Apache Smack

このドライバは、Apache Smack XMPP Javaライブラリを使用してJabber/XMPP IMサーバーに接続します。このドライバには、Smack(バージョン3.0.4)のライセンス・コピーが含まれています。

3.0.4

注意:

既存のサーバーへのアクセス権がある場合、独自のXMPPサーバーのインストールは不要です。パブリック・サーバーのリストについては、http://www.jabber.orgを参照してください。

27.4.1.6.4 ドライバ・アプリケーション・アーカイブ(EAR)

EARファイルは、$ORACLE_HOME/communications/applications/sdpmessagingdriver-xmpp.earです。

27.4.1.6.5 共通プロパティ

表27-15に、メッセージング・エンジンがアウトバウンド・メッセージをルーティングする際に使用する、このドライバの機能を示す共通プロパティをリストします。通常、ドライバ開発者が設定する一部のプロパティは変更不要ですが、他のプロパティは、ルーティング動作を変更するために、管理者が変更できます。SendingQueuesInfoなどの一部のプロパティは、高度な使用を目的としており、高度なデプロイメント・トポロジに対してのみ変更が必要です。これらのプロパティと使用可能な値の詳細は、DriverConfigPropertyNamesのJavaDocを参照してください。

表27-15 共通のXMPPプロパティ

名前

説明

必須

デフォルト値

InstanceName

インスタンス名(内部使用のみ)。

はい

XMPP-IM-Driver

Capability

メッセージの送受信機能

はい

Both

SupportedDeliveryTypes

サポートされている配信タイプ

はい

IM

SupportedContentTypes

サポートされているコンテンツ・タイプ

はい

text/plain

SupportedStatusTypes

サポートされているステータス・タイプ

いいえ

DELIVERY_TO_GATEWAY_SUCCESS, DELIVERY_TO_GATEWAY_FAILURE

Cost

コスト

いいえ

N/A

Speed

速度

いいえ

N/A

SupportedCarriers

サポートされている電話会社

いいえ

N/A

Supported Protocols

サポートされているプロトコル

いいえ

N/A

SupportsCancel

メッセージの取消し操作をサポートします

いいえ

False

SupportsReplace

メッセージの置換操作をサポートします

いいえ

False

SupportsTracking

メッセージの追跡操作をサポートします

いいえ

False

SupportsStatusPolling

メッセージのステータス・ポーリング操作をサポートします

いいえ

False

SenderAddresses

送信者のアドレス

いいえ

N/A

DefaultSenderAddress

デフォルトの送信者アドレス

いいえ

N/A

SendingQueuesInfo

ドライバによるキュー情報の送信

はい

OraSDPM/QueueConnectionFactory:OraSDPM/Queues/OraSDPMDriverDefSndQ1

27.4.1.6.6 XMPPのカスタム・プロパティ

XMPPドライバには、表27-16に示すカスタム・プロパティが組み込まれています。

表27-16 カスタムのXMPPプロパティ

名前

説明

必須

デフォルト値

IMServerHost

Jabber/XMPPサーバー・ホスト名。

いいえ

N/A

IMServerPort

対応するJabber/XMPPサーバー・ポート。デフォルトは5222です。

はい

5222

IMServerUsername

ログインに使用するJabber/XMPPユーザー名。ドメイン名がJabber/XMPPサーバーのホスト名と異なる場合は、完全なJabber IDを入力することもできます(例: myUserNameまたはmyUserName@xmpp-domain)。

注意: このユーザー・アカウントが存在せず、サーバーでアカウントの登録がサポートされている場合は、ユーザー・アカウントの登録が試行されます。

いいえ

N/A

IMServerPassword

上にリストされているユーザー名に対応するパスワード。パスワードのタイプ(「間接パスワード、新規のユーザーの作成」、「間接パスワード、既存のユーザーの使用」、「クリアテキスト・パスワードの使用」から選択)とパスワードが含まれています。

いいえ

N/A

SecurityMode

サーバーへの接続時に使用するセキュリティ・モード。使用可能なオプションは、「なし」(セキュリティは無効になり、暗号化されていない接続のみ使用されます)、「TLS」(可能な場合にはTLS暗号化によるセキュリティが使用されます)、「SSL」(SSL暗号化によるセキュリティが使用されます)。デフォルトは「TLS」です。

いいえ

TLS

SASLAuthenticationEnabled

サーバーへのログイン時にSASL認証を使用するかどうか。SASL認証に失敗した場合、ドライバは非SASL認証の使用を試行します。デフォルトではSASLが有効になります。

いいえ

有効

27.4.1.6.7 クライアントAPI MessageInfoのサポート

次に、メッセージ配信関連のプロパティを示します。これらのプロパティは、クライアントAPIを介して指定されます。表27-17は、これらのプロパティに対するプロトコルまたはドライバの実装による影響を示しています。

表27-17 クライアントAPI MessageInfoのサポート

名前

説明

サポート

Expiration

Expirationは、メッセージの期限が切れるまでの期間を意味します。

False

Delay

Delayは、メッセージを送信するまで必要な経過時間を意味します。

False

27.4.1.7 VoiceXMLドライバの構成

VoiceXMLドライバは、VoiceXMLで作成されたメッセージを送信する、Genesys VoiceGenieゲートウェイのアウトバウンド・コール・プロトコルをサポートしています。ゲートウェイは、音声変換合成を使用してメッセージを配信します。

27.4.1.7.1 VoiceXMLドライバの互換性

この項では、VoiceXMLドライバの互換性機能について詳細に説明します。

VoiceXMLドライバは、VoiceXML over HTTPプロトコル(VoiceGenieゲートウェイ・プロトコル)と互換性があります。

VoiceXMLドライバの機能は、次のとおりです。

- VoiceXMLコンテンツのみを使用

表27-18のゲートウェイ・ベンダーとバージョンが検証済です。

表27-18 VoiceXMLドライバのゲートウェイ・ベンダーとバージョン

ベンダー

バージョン

Genesys VoiceGenie

6.4.2

27.4.1.7.2 共通プロパティ

表27-19に、メッセージング・エンジンがアウトバウンド・メッセージをルーティングする際に使用する、このドライバの機能を示す共通プロパティをリストします。通常、ドライバ開発者が設定する一部のプロパティは変更不要ですが、他のプロパティは、ルーティング動作を変更するために、管理者が変更できます。SendingQueuesInfoなどの一部のプロパティは、高度な使用を目的としており、高度なデプロイメント・トポロジに対してのみ変更が必要です。これらのプロパティと使用可能な値の詳細は、DriverConfigPropertyNamesのJavaDocを参照してください。

表27-19 共通のVoiceXMLプロパティ

名前

説明

必須

デフォルト値

InstanceName

インスタンス名(内部使用のみ)。

はい

VoiceXML-Driver

Capability

メッセージの送受信機能

はい

SEND

SupportedDeliveryTypes

サポートされている配信タイプ

はい

VOICE

SupportedContentTypes

サポートされているコンテンツ・タイプ

はい

text/vxml, text/x-vxml

SupportedStatusTypes

サポートされているステータス・タイプ

いいえ

DELIVERY_TO_GATEWAY_SUCCESS, DELIVERY_TO_GATEWAY_FAILURE

Cost

コスト

いいえ

N/A

Speed

速度

いいえ

N/A

SupportedCarriers

サポートされている電話会社

いいえ

N/A

Supported Protocols

サポートされているプロトコル

いいえ

N/A

SupportsCancel

メッセージの取消し操作をサポートします

いいえ

False

SupportsReplace

メッセージの置換操作をサポートします

いいえ

False

SupportsTracking

メッセージの追跡操作をサポートします

いいえ

False

SupportsStatusPolling

メッセージのステータス・ポーリング操作をサポートします

いいえ

False

SenderAddresses

送信者のアドレス

いいえ

N/A

DefaultSenderAddress

デフォルトの送信者アドレス

いいえ

N/A

SendingQueuesInfo

ドライバによるキュー情報の送信

はい

OraSDPM/QueueConnectionFactory:OraSDPM/Queues/OraSDPMDriverDefSndQ1

27.4.1.7.3 VoiceXMLのカスタム・プロパティ

VoiceXMLドライバには、表27-20に示すカスタム・プロパティが組み込まれています。

表27-20 カスタムのVoiceXMLプロパティ

名前

説明

必須

デフォルト値

VoiceXMLOutboundServletURI

VoiceXMLゲートウェイのURL。

はい

N/A

VoiceXMLOutboundServletUserName

VoiceXMLゲートウェイのユーザー名。

いいえ

N/A

VoiceXMLOutboundServletPassword

VoiceXMLゲートウェイのユーザーのパスワード。

いいえ

N/A

VoiceXMLOutboundServletDNIS

受信者の呼出し側ID表示で表示される数字。

いいえ

N/A

VoiceXMLReceiveURL

VoiceXMLゲートウェイからの受信リクエストを処理するこのドライバのサーブレットのURL。フォーマットはhttp://host:port/usermessagingdriver-voicexml/receiveです。このプロパティが設定されていない場合のデフォルトの動作では、ローカル・コンテナのHTTPリスナー・ホストおよびポートが使用されます。デフォルトの動作は、最初のドライバ・インスタンスに対してのみ機能します。追加のインスタンスについては、コンテキスト・ルートが異なるため、/sdpmessagingdriver-voicexmlを正しいコンテキスト・ルートに置き換えて構成する必要があります。

いいえ

N/A

注意:

Oracle HTTP Server (OHS)が構成されているクラスタ(高可用性)環境では、OHSポートを使用してVoiceXMLドライバの受信URLを構成しないでください。OHSポートを使用してVoiceXMLドライバの受信URLを構成すると、ドライバと競合します。

各VoiceXMLドライバは、固有のWLSサーバーのポートで構成する必要があります。

27.4.1.7.4 クライアントAPI MessageInfoのサポート

次に、メッセージ配信関連のプロパティを示します。これらのプロパティは、クライアントAPIを介して指定されます。表27-21は、これらのプロパティに対するプロトコルまたはドライバの実装による影響を示しています。

表27-21 クライアントAPI MessageInfoのサポート

名前

説明

サポート

Expiration

Expirationは、メッセージの期限が切れるまでの期間を意味します。

False

Delay

Delayは、メッセージを送信するまで必要な経過時間を意味します。

False

27.4.1.8 ワークリスト・ドライバの構成

ワークリスト・ドライバを使用すると、ユーザーのWebCenterポータル統合ワークリストへの統合のために、すべてのソースからの通知をワークリスト・タスクの形式でユーザーに送信できます。

注意:

ワークリスト・メッセージ・タスクには、Oracle WebCenterポータルとOracle BPMワークリストの両方からアクセスできます。Oracle WebCenterは、ワークリスト・メッセージ・ドライバがメッセージを送信するBPEL接続を検索するように構成されています。Oracle BPMワークリストでは、これらのメッセージベースのタスクがワークリスト項目としても表示されます。

この統合は、ワークリスト・チャネル(配信タイプ)をアプリケーションとエンド・ユーザーに対して公開することによって達成されます。ユーザーのワークリスト・チャネルを介して送信されたメッセージは、ワークリスト・ドライバによって処理されます。

注意:

ワークリスト・チャネルは、text/htmlコンテンツ・タイプのaf:richTextEditorでサポートされているすべてのリッチ・テキスト・タグをサポートしています。リッチ・テキスト・エディタの詳細は、<af:richTextEditorを参照してください。

ユーザー・メッセージング・サービスAPIのセマンティクスは、IMや電子メールなどの既存のチャネルのセマンティクスと同じです。このドライバが処理するのは、送信メッセージのみです。ドライバ・アプリケーション・アーカイブ(EAR)は、$ORACLE_HOME/communications/applications/sdpmessagingdriver-worklist.earにあります。

ワークリスト・ドライバは、Oracle WebLogicプラットフォームまたはIBM WebSphereプラットフォームにインストールできます。次に示すインストール手順から、適切な手順を選択してください。

27.4.1.8.1 Oracle WebLogic Serverプラットフォームでのワークリスト・ドライバのインストール

メッセージング・ワークリストの機能を有効にするには、$ORACLE_HOME/common/templates/applications/oracle.ums.driver.worklist_template_11.1.1.jarで入手できる拡張テンプレートを使用して、WebLogic SOAドメインを拡張する必要があります。

Oracle Fusion Middleware構成ウィザードを使用してSOAドメインを拡張する手順は、次のとおりです。

1. Oracle Fusion Middleware構成ウィザードを起動します($ORACLE_HOME/common/bin/config.shまたは%ORACLE_HOME%\common\bin\config.cmd)。

2. 「既存のWebLogicドメインの拡張」オプションを選択します。

3. 目的のSOAドメイン・ディレクトリを選択します。

4. 「既存の拡張テンプレートを使用してドメインを拡張する」オプションを選択します。

5. 「参照」をクリックし、$ORACLE_HOME/common/templates/applicationsに移動します。

6. 「oracle.ums.driver.worklist_template_11.1.1.jar」を選択します

7. Oracle Fusion Middleware構成ウィザードの残りのステップを完了し、SOAサーバーを再起動します。

注意:

SOA管理対象サーバーがリモート・コンピュータ上にある場合の特別な考慮事項: oracle.ums.driver.worklist_template_11.1.1.jar拡張テンプレートに含まれているSOAコンポジット・アプリケーション(sca_sdpmessagingsca-worklist-composite_rev1.0.jar)は、$DOMAIN_HOME/soa/autodeployにコピーされ、サーバーの再起動時に、SOAインフラ・ランタイムによって自動デプロイされます。ただし、SOAインフラ・ランタイムがリモート・コンピュータ上にあり、かつ、ドメインが-managed=trueオプション(使用する適切なオプション)を指定して圧縮されている場合、このディレクトリはアーカイブに組み込まれません。したがって、コンポジットはSOA管理対象サーバーの再起動時にデプロイされません。

インストールを完了するには、$DOMAIN_HOME/soa/autodeployの内容をAdminServerコンピュータから、SOA管理対象サーバーが含まれているリモート・コンピュータ上の対応する位置にコピーして、SOA管理対象サーバーを再起動します。ディレクトリ構造soa/autodeployをリモート・コンピュータ上の$DOMAIN_HOMEに作成することが必要になる場合があります。

27.4.1.8.2 IBM WebSphereプラットフォームでのワークリスト・ドライバのインストール

メッセージング・ワークリストの機能を有効にするには、$ORACLE_HOME/common/templates/was/oracle.ums.driver.worklist_template_11.1.1.jarで入手できる拡張テンプレートを使用して、WebSphere SOAセルを拡張する必要があります。

Oracle Fusion Middleware構成ウィザードを使用してSOAセルを拡張する手順は、次のとおりです。

1. 値-DTemplateCatalog.enable.selectable.all=trueを指定して環境変数CONFIG_JVM_ARGSを設定します。たとえば、LinuxのbashシェルではexportCONFIG_JVM_ARGS="-DTemplateCatalog.enable.selectable.all=true"と設定します。
Windowsコマンド・プロンプトではset CONFIG_JVM_ARGS=-DTemplateCatalog.enable.selectable.all=trueと設定します。

2. Oracle Fusion Middleware構成ウィザードを起動します($ORACLE_HOME/common/bin/was_config.shまたは%ORACLE_HOME%\common\bin\was_config.cmd)。

3. 「既存のセルの選択と構成」をクリックします。

4. 目的のSOAセルを選択し、「次へ」をクリックします。

5. 「セルへの製品追加」画面でOracle User Messaging Serviceワークリスト・ドライバを選択し、「次へ」をクリックします。

6. Oracle Fusion Middleware構成ウィザードの残りのステップをデフォルト選択で完了し、SOAセルを再起動します。

27.4.1.8.3 共通プロパティ

表27-22に、メッセージング・エンジンがアウトバウンド・メッセージをルーティングする際に使用する、このドライバの機能を示す共通プロパティをリストします。通常、ドライバ開発者が設定する一部のプロパティは変更不要ですが、他のプロパティは、ルーティング動作を変更するために、管理者が変更できます。SendingQueuesInfoなどの一部のプロパティは、高度な使用を目的としており、高度なデプロイメント・トポロジに対してのみ変更が必要です。これらのプロパティと使用可能な値の詳細は、DriverConfigPropertyNamesのJavaDocを参照してください。

表27-22 共通のワークリスト・プロパティ

名前

説明

必須?

デフォルト値

InstanceName

インスタンス名(内部使用のみ)。

はい

Worklist-Driver

Capability

メッセージの送受信機能

はい

SEND

SupportedDeliveryTypes

サポートされている配信タイプ

はい

WORKLIST

SupportedContentTypes

サポートされているコンテンツ・タイプ

はい

text/plain, text/html

SupportedStatusTypes

サポートされているステータス・タイプ

いいえ

DELIVERY_TO_GATEWAY_SUCCESS, DELIVERY_TO_GATEWAY_FAILURE

コスト

コスト

いいえ

N/A

速度

速度

いいえ

N/A

SupportedCarriers

SupportedCarriers

いいえ

N/A

サポートされているプロトコル

サポートされているプロトコル

いいえ

N/A

SupportsCancel

メッセージの取消し操作をサポートします

いいえ

False

SupportsReplace

メッセージの置換操作をサポートします

いいえ

False

SupportsTracking

メッセージの追跡操作をサポートします

いいえ

False

SupportsStatusPolling

メッセージのステータス・ポーリング操作をサポートします

いいえ

False

SenderAddresses

送信者のアドレス

いいえ

N/A

DefaultSenderAddress

デフォルトの送信者アドレス

いいえ

N/A

SendingQueuesInfo

ドライバによるキュー情報の送信

はい

OraSDPM/QueueConnectionFactory:OraSDPM/Queues/OraSDPMDriverDefSndQ1

27.4.1.8.4 カスタム・プロパティ

表27-23に示すカスタム・プロパティを使用できます。

表27-23 カスタムのワークリスト・プロパティ

名前

説明

必須

デフォルト値

BPELConnectionURL

接続先のBPELサーバーのURL。フォーマットは'http://<bpel-host>:<bpel-port>'です。このプロパティが設定されていない場合のデフォルトの動作では、ローカル・コンテナのHTTP接続URLが使用されます。

27.4.1.8.5 クライアントAPI MessageInfoのサポート

表27-24は、次のメッセージ配信関連のプロパティに対するプロトコルまたはドライバの実装による影響を示しています。これらのプロパティは、クライアントAPIを介して指定されます。

表27-24 クライアントAPI MessageInfoのサポート

名前

説明

サポート

Expiration

Expirationは、メッセージの期限が切れるまでの期間を意味します。

False

Delay

Delayは、メッセージを送信するまで必要な経過時間を意味します。

False

27.4.1.9 プロキシ・ドライバの構成

プロキシ・ドライバは、イントラネットやインターネットの他の場所でホスト管理されるFusion Middlewareメッセージング・サーバーに対するメッセージングWebサービス・クライアントとして機能します。これは、SOAP over HTTP (Parlay X Multimedia Webサービス・プロトコル)を使用し、複数メッセージの送受信の他に、メッセージの配信ステータスも返します。ParlayX Webサービスは、UMSインスタンス間でメッセージをリレーします。これは、イントラネット内の複数インスタンスから、プロトコル固有のドライバをすべて備えた終了インスタンスにトラフィックをリレーできます。この場合のドライバは、SMSCなどの外部ゲートウェイまたはSMTPやIMAPなどのメール・サーバー用に構成されています。

27.4.1.9.1 共通プロパティ

表27-25に、メッセージング・エンジンがアウトバウンド・メッセージをルーティングする際に使用する、このドライバの機能を示す共通プロパティをリストします。通常、ドライバ開発者が設定する一部のプロパティは変更不要ですが、他のプロパティは、ルーティング動作を変更するために、管理者が変更できます。SendingQueuesInfoなどの一部のプロパティは、高度な使用を目的としており、高度なデプロイメント・トポロジに対してのみ変更が必要です。これらのプロパティと使用可能な値の詳細は、DriverConfigPropertyNamesのJavaDocを参照してください。

表27-25 共通のプロキシ・プロパティ

名前

説明

必須

デフォルト値

InstanceName

インスタンス名(内部使用のみ)。

はい

Proxy-Driver

Capability

メッセージの送受信機能

はい

SEND

SupportedDeliveryTypes

サポートされている配信タイプ

はい

EMAIL, SMS, VOICE, IM, WORKLIST

SupportedContentTypes

サポートされているコンテンツ・タイプ

はい

*

SupportedStatusTypes

サポートされているステータス・タイプ

いいえ

DELIVERY_TO_GATEWAY_SUCCESS, DELIVERY_TO_GATEWAY_FAILURE

Cost

コスト

いいえ

N/A

Speed

速度

いいえ

N/A

SupportedCarriers

サポートされている電話会社

いいえ

N/A

Supported Protocols

サポートされているプロトコル

いいえ

N/A

SupportsCancel

メッセージの取消し操作をサポートします

いいえ

False

SupportsReplace

メッセージの置換操作をサポートします

いいえ

False

SupportsTracking

メッセージの追跡操作をサポートします

いいえ

False

SupportsStatusPolling

メッセージのステータス・ポーリング操作をサポートします

いいえ

False

SenderAddresses

送信者のアドレス

いいえ

N/A

DefaultSenderAddress

デフォルトの送信者アドレス

いいえ

N/A

SendingQueuesInfo

ドライバによるキュー情報の送信

はい

OraSDPM/QueueConnectionFactory:OraSDPM/Queues/OraSDPMDriverDefSndQ1

27.4.1.9.2 プロキシのカスタム・プロパティ

プロキシ・ドライバには、表27-26に示すカスタム・プロパティが組み込まれています。

表27-26 カスタムのプロキシ・プロパティ

名前

説明

必須

デフォルト値

GatewayURL

ホスト管理されている11g UMS Webサービス・ゲートウェイのURL。このURLのフォーマットは、次のとおりです。

http://<host>:<port>/sdpmessaging/parlayx/SendMessageService

はい

N/A

ユーザー名

メッセージング・ゲートウェイのユーザー名。

いいえ

N/A

Password

ユーザー名のパスワード

いいえ

N/A

Policies

プロキシ・ドライバ・リクエストにアタッチされる、Oracle Web Services ManagerのWS-Securityポリシーのカンマ区切りのリスト

いいえ

N/A

27.4.1.9.3 クライアントAPI MessageInfoのサポート

次に、メッセージ配信関連のプロパティを示します。これらのプロパティは、クライアントAPIを介して指定されます。表27-27は、これらのプロパティに対するプロトコルまたはドライバの実装による影響を示しています。

表27-27 クライアントAPI MessageInfoのサポート

名前

説明

サポート

Expiration

Expirationは、メッセージの期限が切れるまでの期間を意味します。

False

Delay

Delayは、メッセージを送信するまで必要な経過時間を意味します。

False

27.5 LDAPユーザー・プロファイルへのユーザー・メッセージング・サービスのアクセスの構成

SOAデプロイメントでのLDAPプロバイダの設定の一環として、WebLogic Server管理コンソールを介して「ユーザー名属性」を構成します。デフォルトのcn以外の値でこの属性を構成する場合、またはユーザーの電子メール・アドレスが「mail」とは異なるLDAP属性に格納されている場合、UMSがユーザー・プロファイルに正常にアクセスして、勤務先電子メールなど、LDAPでプロビジョニングされた通信チャネルのリストを取得するには、Oracle Platform Security Services (OPSS)で追加の構成変更を行う必要があります。

Oracle Platform Security Services (OPSS)の詳細は、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』を参照してください。

LDAPユーザー・プロファイルへのアクセスを構成する手順は、次のとおりです。

1. $DOMAIN_HOME/config/fmwconfigディレクトリのjps-config.xmlファイルを変更して、idstore.ldap serviceInstanceセクションに<property>要素を追加します。

- バックエンドLDAPサーバー上のユーザー・プロファイルを検索する際に「ユーザー名属性」の値を使用するには、次の要素を追加します。

<property name=”username.attr” value=”username_attribute_value”/>

ここで、username_attribute_valueは、LDAPプロバイダ構成の「ユーザー名属性」プロパティの値です。たとえば、「ユーザー名属性」の値がmailの場合は、次の行を追加します。

<property name=”username.attr” value=”mail”/>

次のコード例は、jps-config.xmlファイルに挿入された前述の行を示しています。

<!-- JPS WLS LDAP Identity Store Service Instance -->

<serviceInstance name="idstore.ldap" provider="idstore.ldap.provider">

<property name="idstore.config.provider"
value="oracle.security.jps.wls.internal.idstore.WlsLdapIdStoreConfigProvide
r"/>

<property name="CONNECTION_POOL_CLASS"
value="oracle.security.idm.providers.stdldap.JNDIPool"/>

<property name=”username.attr” value=”mail”/>

</serviceInstance>

- ユーザーの勤務先電子メール・アドレスを格納しているLDAP属性がmail属性以外である場合は、次の要素を追加します。

<property name="PROPERTY_ATTRIBUTE_MAPPING" value="BUSINESS_EMAIL=attr_containing_email"/>

ここで、attr_containing_emailは、ユーザーの電子メール・アドレスを格納しているLDAPプロバイダの属性名です。たとえば、電子メール・アドレスを格納しているユーザー属性がexternalEmailの場合は、次の行を追加します。

<property name="PROPERTY_ATTRIBUTE_MAPPING" value="BUSINESS_EMAIL=externalEmail"/>

次のコード例は、jps-config.xmlファイルに挿入された前述の行を示しています。

<!-- JPS WLS LDAP Identity Store Service Instance -->

<serviceInstance name="idstore.ldap" provider="idstore.ldap.provider">

<property name="idstore.config.provider"
value="oracle.security.jps.wls.internal.idstore.WlsLdapIdStoreConfigProvide
r"/>

<property name="CONNECTION_POOL_CLASS"
value="oracle.security.idm.providers.stdldap.JNDIPool"/>

<property name="PROPERTY_ATTRIBUTE_MAPPING" value="BUSINESS_
EMAIL=externalEmail"/>

</serviceInstance>

注意:

同じセクションに他のプロパティが定義されている場合があります。

2. ドメインを再起動します。

27.6 Oracle User Messaging Serviceの保護

ユーザー・メッセージング・プリファレンスのユーザー・インタフェースおよびParlay X Webサービスは、Secure Sockets Layer (SSL)を使用してトランスポート・レベルで保護できます。デフォルトでは、デプロイされるすべてのWebサービスは保護されていません。本番環境にデプロイされるすべてのサービスに対して、Webサービス・セキュリティを有効にする必要があります。

- Oracle WebLogic ServerでSSLを有効にする方法は、『Oracle Fusion Middleware管理者ガイド』のOracle WebLogic ServerのSSLの構成に関する項を参照してください。この手順で、ユーザー・メッセージング・プリファレンスのユーザー・インタフェースを保護できます。

- Parlay X Webサービスを保護する方法は、WebLogic Webサービスの保護のトランスポート・レベルのセキュリティの構成に関する項を参照してください。

UMSは、UMS Webサービスを保護するためのOracle Web Services ManagerのWS-Securityポリシーの使用をサポートしています。Oracle Web Services Managerの詳細は、『Oracle Fusion Middleware Oracle WebLogic Server WebLogic Webサービスの保護』のOracle Web Serviceのセキュリティ・ポリシーの使用に関する項を参照してください。

Webサービスの推奨セキュリティ構成では、Security Assertion Markup Language (SAML)トークンを使用して、Webサービス・クライアントとUMSの間でアイデンティティを受け渡します。SAMLトークンを使用する場合は、Webサービス・クライアントがユーザー名とパスワードをUMSに渡すかわりに、証明書の交換によってクライアントとUMSの間に信頼関係が確立されます。このキーストア構成が整うと、Webサービス・クライアントは、ユーザー・アイデンティティを渡すのみで、ユーザーを適切に認証していることを保証します。

UMS Webサービスで使用する推奨ポリシーは、次のとおりです。

- oracle/wss11_saml_token_with_message_protection_service_policy(サーバー側)

- oracle/wss11_saml_token_with_message_protection_client_policy(クライアント側)

- oracle/wss11_saml_token_identity_switch_with_message_protection_client_policy(クライアント側)

注意:

クライアント側ポリシーの選択は、アプリケーションによって実行されているセキュリティ・コンテキストに応じて異なります。

- Webサービス・コールを行っているスレッドに、(たとえば、ユーザー認証を実行するWebアプリケーションまたはrun-asアイデンティティが定義されているJava EEモジュールから)対象のサブジェクトが関連付けられている場合は、ポリシーoracle/wss11_saml_token_with_message_protection_client_policyを使用します。
現在のスレッド・サブジェクトは、SAML Policy WS-Securityヘッダーを使用して渡されます。この場合は、Webサービス・クライアント・インスタンスの作成時にパラメータjavax.xml.ws.BindingProvider.USERNAME_PROPERTYを指定しないでください。

- Webサービス・コールを行っているスレッドに未定義のサブジェクトが関連付けられる場合、または別のアイデンティティをプログラムで指定する必要がある場合は、ポリシーoracle/wss11_saml_token_identity_switch_with_message_protection_client_policyを使用し、Webサービス・クライアント・インスタンスの作成時にパラメータjavax.xml.ws.BindingProvider.USERNAME_PROPERTYを指定します。動的アイデンティティ切替えを実行する場合は、アプリケーションに追加のコード権限を付与する必要があります。詳細は、『Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイド』を参照してください。

27.6.1 通知に関するWebサービス・セキュリティ

様々なWebサービスに、対応する通知Webサービス(MessageNotification、PresenceNotification)が含まれており、これらはクライアント側で実行され、適合するイベントの発生時に通知(メッセージ配信ステータス、メッセージ受信、プレゼンス・ステータスの変更)を受信します。

この実装には、クライアントの通知時にWebサービス・セキュリティ(WS-Security)を使用する機能がデフォルトでは備わっていません。つまり、サーバーは、クライアント側で実行中の通知WebサービスはWS-Securityを使用していないと想定しているため、通知の送信時に自己認証を試行しません。クライアント側でWS-Securityを有効にした場合は、通知SOAPリクエストに必要なヘッダーがないため、サーバーからの通知が失敗します。

27.6.2 UMSサービス・セキュリティの有効化

UMS Webサービスのポリシーを有効にするには、『Oracle Fusion Middleware Oracle WebLogic Server WebLogic Webサービスの保護』の管理コンソールでのOracle WSMセキュリティ・ポリシーの構成に関する項の手順に従って、ポリシーoracle/wss11_saml_token_with_message_protection_service_policyを選択します。この構成は、保護するサービスごとに繰り返す必要があります。

27.6.3 クライアント・セキュリティの有効化

Webサービス・クライアントのセキュリティは、プログラムで有効化する必要があります。Parlay Xメッセージング・クライアントAPIおよびクライアント・プロキシ・パッケージに関する項(『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』)に記載されているクライアント・ライブラリを使用すると、クライアント・オブジェクトの構築時にWS-Securityポリシー構成が提供されます。クライアント・コンストラクタは、Map<String, Objectタイプの引数を使用します。通常、SAML認証を使用する場合は、エンドポイント・アドレスなどの必須プロパティ以外に、キー/値のペア(表27-28)を構成マップに追加する必要があります。

表27-28 クライアント・セキュリティ・キー

キー

タイプ

一般的な値

oracle.sdp.parlayx.ParlayXConstants.POLICIES

文字列[]

oracle/wss11_saml_token_
with_message_protection_
client_policy

javax.xml.ws.BindingProvider.USERNAME_PROPERTY

文字列

(オプション) <有効なユーザー名>

注意: oracle/wss11_saml_token_with_message_protection_client_policyを使用する場合は、このキーは指定しないでください。

oracle.wsm.security.util.SecurityConstants.Conf
ig.KEYSTORE_RECIPIENT_ALIAS_PROPERTY

文字列

(オプション)ターゲット・サービスのキーストア別名。「クライアント別名」を参照してください。

例27-1 Webサービス・クライアントのセキュリティ

import oracle.sdp.parlayx.multimedia_messaging.send.SendMessageClient

...

Map<String, Object> config = new HashMap<String, Object>();
config.put(javax.xml.ws.BindingProvider.ENDPOINT_ADDRESS_PROPERTY, ums_url);
config.put(oracle.sdp.parlayx.ParlayXConstants.POLICIES, new String[]
{"oracle/wss11_saml_token_with_message_protection_client_policy"});

SendMessageClient sendClient = new SendMessageClient(config);

27.6.4 キーストア構成

推奨WS-Securityポリシーを使用するには、OWSMに必要な公開鍵と秘密鍵の情報が含まれるキーストアを構成する必要があります。キーストアおよび対応する資格情報ストアのエントリを構成する方法は、『Oracle Fusion Middleware Oracle WebLogic Server WebLogic Webサービスの保護』のWLSTを使用した資格情報ストアの構成に関する項を参照してください。

- Webサービス・クライアントとUMSサーバーの両方が同じドメインにある場合、これらはキーストアと資格証明ストアを共有します。

- Webサービス・クライアントとUMSサーバーが異なるドメインにある場合は、UMS公開鍵をクライアント・ドメインのキーストアにインポートし、クライアント・ドメインの公開鍵をUMSキーストアにインポートする必要があります。

27.6.5 クライアント別名

ここで推奨しているSAMLポリシーなど、特定のWS-Securityポリシーを使用する場合、クライアントは、サーバーの公開鍵を使用してWebサービス・リクエストを暗号化する必要があります。ただし、通常はドメインごとにキーストアを1つのみ構成します。したがって、複数の他のドメイン内のWebサービスと通信するWebサービス・クライアントがあるドメインの場合は、OWSMで使用するデフォルトのキーストア・エントリをオーバーライドすることが必要になる場合があります。

たとえば、アプリケーション「A」がUMS Webサービスに対するWebサービス・クライアントで、アプリケーション「B」が別のドメイン内のWebサービスに対するWebサービス・クライアントであるドメインがあるとします。この場合、AのリクエストはUMSドメインの公開鍵を使用して暗号化する必要があり、Bのリクエストは他のドメインの公開鍵を使用して暗号化する必要があります。この目的を達成するには、OWSMで使用するキーストア別名をリクエストごとにオーバーライドします。

- たとえば、UMS公開鍵を別名"ums_public_key"でインポートし、他の公開鍵を別名"other_public_key"でインポートします。

- UMS Webサービス・クライアントの作成時に、例27-2に示すように、キーをoracle.wsm.security.util.SecurityConstants.Config.KEYSTORE_RECIPIENT_ALIAS_PROPERTYに設定し、値を"ums_public_key"に設定して受信キーストア別名パラメータを指定します。

例27-2 クライアント別名

import oracle.sdp.parlayx.multimedia_messaging.send.SendMessageClient

...

Map<String, Object> config = new HashMap<String, Object>();
config.put(javax.xml.ws.BindingProvider.ENDPOINT_ADDRESS_PROPERTY, ums_url);
config.put(oracle.sdp.parlayx.ParlayXConstants.POLICIES, new String[]
{"oracle/wss11_saml_token_with_message_protection_client_policy"});
config.put(javax.xml.ws.BindingProvider.USERNAME_PROPERTY, "test.user1");
config.put(oracle.wsm.security.util.SecurityConstants.Config.KEYSTORE_RECIPIENT_
ALIAS_PROPERTY, "ums_public_key")
SendMessageClient sendClient = new SendMessageClient(config);

- 同様に、他のWebサービス・クライアントでもキーストア別名をオーバーライドする必要がありますが、正確なメカニズムは異なる場合があります。たとえば、JAX-WSクライアント・スタブを直接使用する場合は、オーバーライドプロパティをJAX-WSリクエスト・コンテキストに追加できます。詳細は、『Oracle Fusion Middleware Oracle WebLogic Server WebLogic Webサービスの保護』のWebサービス・クライアントのポリシー構成のオーバーライドに関する項を参照してください。

27.6.6 JMSリソースの保護

この(オプションの)手順では、セキュリティを向上させるために、管理者がOracle User Messaging ServiceのJMSリソース(キューなど)へのアクセスを制限できます。

注意:

この項では、JMSリソースを保護するために従う手順を詳細に説明します。Oracle User Messaging Serviceの新規インストール(11g リリース1 11.1.1.3)から開始する場合は、次の手順に従ってください。

11g リリース1 11.1.1.3にアップグレードしない場合、この手順は使用しません。

以前のリリースで作成したドメインをアップグレードする場合に、最新のリリース・ノートの手順を完了していない場合は、先に進む前に、その手順を完了してください。

JMSシステム・リソースを保護するには、OracleSystemRoleロールを持つUMSJMSSystemResourceという名前で始まるすべてのJMSサブデプロイメントをロックします(複数サーバーまたはクラスタ・デプロイメントではUMSに対して複数の自動作成リソースがある場合があります)。この操作は、Oracle WebLogic Server管理コンソールを使用して行うか、または、次のようにWLSTスクリプトを実行できます($ORACLE_HOME/communications/bin/secure_jms_system_resource.pyで入手できます)。

$ORACLE_HOME/common/bin/wlst.sh
$ORACLE_HOME/communications/bin/secure_jms_system_resource.py
--username=<admin_username> --password=<password>
--url=t3://<admin-host>:<admin-port> --jmsSystemResource
<UMSJMSSystemResource> --role OracleSystemRole

例:

$ORACLE_HOME/common/bin/wlst.sh
$ORACLE_HOME/communications/bin/secure_jms_system_resource.py
--username=weblogic --password=<password> --url=t3://localhost:7001
--jmsSystemResource UMSJMSSystemResource --role OracleSystemRole

デフォルトでは、UMSシステムはJMSリソースにアクセスするためにユーザーOracleSystemUserとして実行されます。ユーザーOracleSystemUserが存在しない場合、または他のユーザーに付与されている他のロールを使用してUMS JMSリソースを保護する場合は、コンテナを起動するとき、次のJVMシステム・プロパティに別のユーザー名を指定することによって、UMSシステムで使用されるデフォルトのユーザー・アイデンティティをオーバーライドする必要があります。

oracle.ums.system.user=<username>

たとえば、ユーザーがMySystemUserである場合は、-Doracle.ums.system.user=MySystemUserのようにコマンドラインでJVMシステム・プロパティを渡すことができます。

27.7 Oracle User Messaging Serviceのトラブルシューティング

ユーザー・メッセージング・サービスをデバッグするには、最初にサーバーの診断ログを確認します。ログには、例外、エラーまたは警告メッセージが含まれている場合があり、不正な動作に関する詳細とともに問題を修正するアクションが示されます。表27-29では、一般的なユーザー・メッセージング・サービスの問題をデバッグするための他の方法について説明します。

表27-29 UMSのトラブルシューティング

症状

考えられる原因

解決策

通知がSOA内のBPELまたはヒューマン・ワークフローから送信されない場合

SOAワークフロー通知の構成で通知モードが「NONE」に設定されています。

Oracle Fusion Middleware Controlを使用して、通知モードの設定を「EMAIL」または「ALL」に変更します。

電子メール通知が送信されない場合

UMS電子メール・ドライバの送信(SMTP)メール・サーバーの設定が正しくありません。

Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

- OutgoingMailServer

- OutgoingMailServerPort

注意: SMTPサーバー接続用の電子メール・クライアントで、これらを使用して値を検証します。

SMTPサーバーに、認証またはセキュアな接続(TLSまたはSSL)が必要です。

Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

- OutgoingUsername

- OutgoingPassword

- OutgoingMailServerSecurity

エラー・メッセージ: 送信者アドレス = <アドレス>に対して一致するドライバが見つかりませんのために通知が送信されない場合

該当するチャネルに対するUMSドライバが特定のSenderAddressesリストで構成されていますが、アプリケーションが送信したメッセージに、一致しない送信者アドレスが設定されています。

注意: UMSサーバーは、アウトバウンド・メッセージの送信者アドレスを使用可能なドライバのSenderAddressesに対して照合(送信者アドレスが設定されている場合)して、メッセージの配信に使用する一致ドライバを検索します。ドライバに1つ以上のSenderAddressesが設定されている場合、UMSサーバーは、一致する送信者アドレスが含まれているメッセージのみをそのドライバに送信します。

- Oracle Fusion Middleware Controlを使用して、該当するUMSドライバの次の設定を確認します。
SenderAddresses

注意: SenderAddressesのフォーマットは、<配信タイプ>:<アドレス>のカンマ区切りのリストです。

例:

EMAIL:sender@example.com, EMAIL:sender@example2.com

- このドライバで、このチャネル(配信タイプ)のすべての送信者アドレスに対するアウトバウンド・メッセージを処理する場合は、このプロパティを空白のままにします。

- 構成が異なる同じチャネル(配信タイプ)に対して複数のドライバ・インスタンスがデプロイされている場合は、SenderAddressesを使用して、ドライバ・インスタンスを区別します。たとえば、あるインスタンスは、SenderAddressesに値を指定して、一致する送信者アドレスが含まれているアウトバウンド・メッセージのみを処理するように設定でき、他のインスタンスはSenderAddressesを空白のままにして、送信者アドレスが指定されていないすべてのアウトバウンド・メッセージ、または最初のドライバ・インスタンスと送信者アドレスが一致しないすべてのアウトバウンド・メッセージを処理するようにできます。

- 構文が正しくないSenderAddresses(<配信タイプ>:が指定されていない場合など)は、ドライバ選択についてはUMSサーバーによって無視されます。

電子メール・クライアントによる通知の受信に矛盾がある場合

UMS電子メール・ドライバの受信メール・サーバーの設定が、通知の送信先と同じ電子メール・アカウントで構成されています。

通知が同じアカウントに送信された場合、電子メール・クライアントが電子メールを表示できるようになる前に、UMS電子メール・ドライバが電子メールをダウンロードして処理する場合があります。

受信メール・サーバーの設定には排他的な電子メール・アカウントを使用してください。Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

- IncomingMailIDs

- IncomingUserIDs

SOAヒューマン・ワークフロー通知が送信されるが、アクション可能ではない場合

アクション可能な電子メール・アドレスがSOAワークフロー通知プロパティで構成されていません。

UMS電子メール・ドライバで構成された電子メール・アカウントのアドレスを使用して、SOAワークフロー通知プロパティでアクション可能な電子メール・アドレスを設定します。

ヒューマン・ワークフロー・タスクがアクション可能な通知を送信するように設定されていません。

JDeveloperでヒューマン・ワークフロー・タスクのアクション可能属性を設定し、SOAコンポジット・アプリケーションを再デプロイします。

SOAヒューマン・ワークフローのアクション可能な通知が送信されるが、応答後アクションが実行されない場合

UMS電子メール・ドライバの受信メール・サーバーの設定が正しくありません。

Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

- MailAccessProtocol(大文字でIMAPまたはPOP3)

- ReceiveFolder

- IncomingMailServer

- IncomingMailServerPort

- IncomingMailServerSSL

- IncomingUserIDs

- IncomingUserPasswords

- ImapAuthPlainDisable

注意: IMAPまたはPOP3サーバー接続用の電子メール・クライアントで、これらを使用して値を検証します。

メール・アクセス・プロトコルが正しくありません。

Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

- MailAccessProtocol(大文字でIMAPまたはPOP3)

電子メール・サーバーがSSL対応です。

Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

- IncomingMailServerSS

受信フォルダ名が正しくありません。

Oracle Fusion Middleware Controlを使用して、UMS電子メール・ドライバの次の設定を確認します。

- ReceiveFolder

注意: 一部の電子メール・サーバーでは、値INBOXをinboxまたはInbox(つまり大/小文字を区別)と記述する必要があります。電子メール・サーバーに応じて適切な値を使用してください。

デフォルト以外の電子メール・クライアントが通知受信用に構成されています。ユーザーが承認リンクをクリックすると、デフォルトのメール・クライアント・ページが開き、このページで別の電子メール・サーバーに電子メールを送信できます。

デフォルトの電子メール・クライアントを、アクション可能な通知を受信するように構成します。

SOA BPELユーザー通知またはヒューマン・ワークフロー通知が正しい配信タイプ(電子メール、SMSなど)に送信されるが、間違ったアドレスに送信される場合

ユーザー・メッセージング・プリファレンスで、ユーザーが、BPELユーザー通知またはヒューマン・ワークフロー・ユースケースで使用するために、セルフプロビジョニング・メッセージング・チャネルを作成しました。

注意: ユーザー・メッセージング・プリファレンスのUIを使用すると、エンド・ユーザーは様々なユースケースに対する独自のメッセージング・チャネルを作成できますが、これらはBPELユーザー通知およびヒューマン・ワークフローに使用することを目的としていません。

BPELユーザー通知またはヒューマン・ワークフロー・ユースケースには、セルフプロビジョニング・メッセージング・チャネルは使用しないでください(つまり、デフォルトのチャネルとして設定しないでください。また、このようなユースケースに対するメッセージ・フィルタで使用しないでください)。BPELユーザー通知およびヒューマン・ワークフローでは、配信タイプ・プリファレンスに対してのみユーザー・メッセージング・プリファレンスが使用され、実際のアドレスはアイデンティティ管理システムのユーザー・プロファイルから取得されます。

注意: アイデンティティ管理システムのユーザー・プロファイルからのアドレスは、事前定義のチャネル名(「勤務先電子メール」、「業務用携帯電話番号」、「勤務先電話番号」、「インスタント・メッセージ」など)を使用して、ユーザー・メッセージング・プリファレンスを介して使用可能です。BPELユーザー通知およびヒューマン・ワークフロー・ユースケースには、かわりにこれらの事前定義済メッセージング・チャネルを使用してください。

28 Oracle User Messaging Serviceの監視

この章では、Oracle Enterprise Manager Fusion Middleware Controlを使用してOracle User Messaging Serviceを監視する方法について説明します。

この章では、次の項目について説明します。

- 第28.1項「Oracle User Messaging Serviceの監視」

- 第28.2項「ログ・ファイルの表示」

- 第28.3項「メトリックおよび統計の表示」

28.1 Oracle User Messaging Serviceの監視

Oracle User Messaging Serviceのログとメトリックは、Oracle Enterprise Manager Fusion Middleware Controlを使用して監視できます。

Oracle User Messaging Serviceを監視するには、次の手順を実行します。

1. SOAファームの「Oracle Enterprise Manager Fusion Middleware Control」ページに移動します。

2. 「Fusion Middleware」→「SOA」→「ユーザー・メッセージング・サービス」の順に選択します。

3. 目的のサーバーまたはドライバを選択します。
ドライバを選択すると、そのドライバの状態とパフォーマンスを示すクイック統計が表示されます。

サーバーを選択すると、クイック統計に加えて、関連ドライバのリストが表示されます。いずれかのドライバを選択してその統計を表示したり、「ドライバの構成」アイコンをクリックしてドライバを構成できます。ドライバの構成の詳細は、第27章「Oracle User Messaging Serviceの構成」を参照してください。

4. サーバーを右クリックしてアクションを選択します。

選択項目

アクション

ホーム

ホーム・ページに、選択したドライバのクイック統計が表示されます。

コントロール

ドライバを起動または停止します。

ログ

選択したドライバのメッセージ・ログを表示および構成します。

パフォーマンス・サマリー

カスタマイズ可能なメトリック・ページにパフォーマンス統計が表示されます。このページを使用して、このドライバの統計を表示します。このページをカスタマイズするには、「メトリック・パレット」を使用します。「メトリック・パレット」を使用すると、最も重要な情報のみが表示されるように、使用可能なすべてのメトリックの中から必要なメトリックを選択できます。

メッセージ・ステータス

送受信したメッセージの配信ステータスを確認し、選択したメッセージを再送信します。検索フィールドを追加して、必要な演算子と検索値を設定すると、検索をフィルタ処理できます。一部のフィールドは、各種の補足的な演算子やContains演算子とともに使用するために、複数回追加できます。

メッセージング・クライアント・アプリケーション

ユーザー・メッセージング・サービスに登録したメッセージング・クライアント・アプリケーションは、そのアプリケーションがアンデプロイされ、他のアプリケーションが使用できるようにする必要があるアクセス・ポイントに留まったままの場合は、手動で登録解除できます。

サーバー・プロパティ

メッセージ保管方法およびメッセージ・フィルタ作成用のビジネス条件を構成します。詳細は、第27章「Oracle User Messaging Serviceの構成」を参照してください。

システムMBeanブラウザ

システムMBeanブラウザとその構成の設定。

一般情報

「一般情報」には、選択されたドライバの名前、バージョン、Oracleホームおよびホストが表示されます。

28.1.1 メッセージ・ステータスの使用

送受信されたメッセージの配信ステータスを確認し、選択したメッセージを再送信できます。

メッセージ・ステータスをチェックするには、次の手順を実行します。

1. ナビゲーション・ツリーで、メッセージ・ステータスを表示するUMSターゲットを右クリックします。

2. 「メッセージ・ステータス」を選択します。「メッセージ・ステータス」ページが表示されます。

3. 「検索」をクリックして、デフォルトの基準を使用してメッセージを検索します。検索結果のメッセージのリストが返されます。

検索フィールドを追加して、必要な演算子と検索値を設定すると、検索をカスタマイズできます。一部のフィールドは、各種の補足的な演算子やContains演算子とともに使用するために、複数回追加できます。検索をカスタマイズする手順は、次のとおりです。

1. 「フィールドの追加」をクリックします。

2. 検索対象のフィールドを選択します。

3. 演算子を選択し、必要に応じて変数を指定します。

4. 「検索」をクリックします。カスタマイズした検索が実行され、結果が返されます。

5. メッセージを再送信する場合は、リストのメッセージを選択して「再送信」をクリックします。

28.1.2 メッセージング・クライアント・アプリケーションの登録解除

メッセージング・クライアント・アプリケーションがアンデプロイされ、他のアプリケーションが使用できるようにする必要があるアクセス・ポイントに留まったままの場合は、そのアプリケーションを手動で登録解除できます。メッセージング・クライアント・アプリケーションの登録を解除する手順は、次のとおりです。

1. ナビゲーション・ツリーでターゲットを右クリックし、メッセージング・クライアントを選択します。「メッセージング・クライアント・アプリケーション」ページが表示されます。

2. 登録解除するメッセージを選択します。

3. 「登録解除」をクリックします。

選択内容を確認する確認ボックスが表示されます。

4. 選択内容を確認します。

28.1.3 「すべて」タブを使用したドライバの監視

「すべて」タブには、(存在するすべてのドライバではなく)ドメイン内で正常に登録されたドライバのみがリストされます。

ドライバはデフォルトでは構成されていないため、自分で構成しないかぎり登録されません。「すべて」タブにすべてのドライバを表示するには、SMPP、VoiceXMLおよびXMPPドライバを構成します(使用することを計画している場合)。構成すると、ドライバはエンジンに登録され、「すべて」タブに表示されます。

28.2 ログ・ファイルの表示

ログ・ファイルを表示できます。

ログ・ファイルを表示するには、次の手順を実行します。

1. ログ情報を表示するドライバ(またはサーバー)を右クリックして、「ログ」→「ログ・ファイルの表示」の順に選択します。
「ログ・メッセージ」ページが表示されます。

このページを使用して、ドライバ(またはサーバー)に関するログ情報を問い合せます。フィールドとリストを使用して問合せをカスタマイズします。

2. 検索条件を入力した後、「ログ・ファイル」をクリックします。「ログ・ファイル」ページが表示されます。

3. ログ情報を表示したり、ログをダウンロードします。

28.2.1ロギングの構成

図28-1に示すように、Oracle Enterprise Manager Fusion Middleware Controlを使用して、ログ・レベルを構成します。

図28-1 ログ・レベルの構成

図28-2に示すように、各ロガーに対して通知レベルを設定します。

図28-2 通知レベルの選択

構成アクションの結果、指定に従って通知が表示されます。図28-3および図28-4に詳細を示します。

図28-3 ログ・ファイルの表示

図28-4 エラー・メッセージ

28.3 メトリックおよび統計の表示

アプリケーションのパフォーマンスは、メトリックおよび統計に反映されます。

メトリックおよび統計を表示するには、次の手順を実行します。

1. ドライバ(またはサーバー)のパフォーマンス・サマリーを選択します。
「パフォーマンス・サマリー」ページが表示されます。

多数のメトリックを取得して表示できます。最も重要なフォーカスされた情報を取得するには、「メトリック・パレット」を使用します。

2. 「メトリック・パレットの表示」をクリックして、メトリック・パレットを表示します。

3. 最も関心のあるメトリックを選択します。パレットからメトリックを選択したり、選択を解除すると、メトリック表示が自動的に更新されます。

29 Oracle User Messaging Serviceの管理

この章では、Oracle WebLogic Scripting Tool (WLST)、Oracle Enterprise Manager Fusion Middleware Control、Oracle Fusion Middleware構成ウィザード、およびIBM WebSphere Application Serverのwsadminユーティリティを使用してOracle User Messaging Service (UMS)ドライバをデプロイする方法について説明します。Oracle UMSドライバのアンデプロイおよび登録方法についても説明します。

この章では、次の項目について説明します。

- 第29.1項「ドライバのデプロイ」

- 第29.2項「ドライバのアンデプロイおよび登録解除」

29.1 ドライバのデプロイ

Oracle UMSをインストールすると、事前にインストールされているドライバが組み込まれます(電子メール、XMPP、SMPPおよびVoiceXML)。このドライバの中で、WebLogic Serverにデプロイされるのは電子メール・ドライバのみです。他のドライバをデプロイするには、そのドライバをWebLogic Serverにデプロイしてください(Oracle WebLogic Server管理コンソールを使用するか、またはOracle Fusion Middleware構成ウィザードを使用してドメインを作成または拡張する際にドライバをデプロイできます)。

UMSとワークリストの統合を使用する場合は、ワークリスト・ドライバをSOAサーバーにデプロイする必要があります。この統合には複数のJEEアプリケーションおよびSOAコンポジットが含まれているため、この機能を1ステップで使用可能にするには、特別な拡張テンプレートを使用する必要があります。詳細は、「Oracle WebLogic Serverプラットフォームでのワークリスト・ドライバのインストール」およびIBM WebSphereプラットフォームでのワークリスト・ドライバのインストールを参照してください。

追加のドライバは、WLSTコマンド(推奨)、wsadminツール、Oracle Enterprise Manager Fusion Middleware ControlおよびOracle Fusion Middleware構成ウィザードを使用して、様々な方法でデプロイできます。

この項は次のトピックで構成されています。

- 第29.1.1項「WLSTコマンドを使用したドライバのデプロイ」

- 第29.1.2項「Oracle Enterprise Manager Fusion Middleware Controlを使用したドライバのデプロイ」

- 29.1.3項「Oracle Fusion Middleware構成ウィザードを使用したドライバのデプロイ」

- 第29.1.4項「wsadminツールを使用したドライバのデプロイ」

注意:

特定のドライバEARの2つ以上のドライバ・インスタンスをデプロイするには、$ORACLE_HOME/communications/plansで入手できるカスタムのデプロイ・プラン・テンプレートを使用する必要があります。WLSTコマンドではデプロイ・プランが自動的に変更されるため、これらのコマンドを使用したドライバのデプロイをお薦めしますが、他の方法を使用する場合は、デプロイ・プランを手動で変更する必要があります。

29.1.1 WLSTコマンドを使用したドライバのデプロイ

WLSTコマンドdeployUserMessagingDriverを使用してドライバをデプロイできます。

29.1.1.1 deployUserMessagingDriver

コマンド・カテゴリ: UMS

WLSTでの使用: オンライン

29.1.1.1.1 説明

deployUserMessagingDriverは、ユーザー・メッセージング・ドライバの追加インスタンスをデプロイするために使用されます。新しいドライバ・デプロイメントのベース・ドライバ・タイプ(例: email、xmpp、voicexmlなど)および短縮名を指定します。指定されたアプリケーション名の前に文字列usermessagingdriver-が付加されます。deployコマンドについて有効なパラメータを指定でき、ドライバをデプロイするときに渡されます。

29.1.1.1.2 構文

deployUserMessagingDriver(baseDriver, appName, [targets],
[stageMode], [options])

引数

定義

baseDriver

ベース・メッセージング・ドライバ・タイプを指定します。

email、proxy、smpp、voicexmlまたはxmppなどの既知のドライバ・タイプを指定する必要があります。

appName

新規デプロイメントの短い説明の名前。指定された値が文字列usermessagingdriver-の前に付加されます。

targets

stageMode

options

オプション。deployコマンドについて有効な追加の引数を指定でき、新規ドライバをデプロイするときに渡されます。

29.1.1.1.3 例

myEmailという名前の電子メール・ドライバの2番目のインスタンスをデプロイする場合

wls:/base_domain/serverConfig> deployUserMessagingDriver(baseDriver='email',
appName='myEmail')

デプロイメント・ターゲットを指定して、電子メール・ドライバの2番目のインスタンスをデプロイする場合

wls:/base_domain/serverConfig> deployUserMessagingDriver(baseDriver='email',
appName='email2', targets='server1,server2')

29.1.2 Oracle Enterprise Manager Fusion Middleware Controlを使用したドライバのデプロイ

Oracle Enterprise Manager Fusion Middleware Controlを使用してドライバをデプロイするには、次の手順を実行します。

1. デプロイメント・テンプレート(例: ORACLE_HOME/communications/plans)を取得します。

2. プランを目的の場所(同じディレクトリまたは他のディレクトリ)にコピーします。

3. プランを編集します。

使用する任意の名前で、「DriverDeploymentName」を置き換えます(この名前のすべての出現箇所を置き換えたことを確認します)。

「DriverShortName」を任意の名前に置き換えます。

@RunAsPrincipalName@トークンを、UMSで使用する有効なプリンシパルに置き換えます。デフォルト・デプロイメントでは、システム・プリンシパル「OracleSystemUser」がこの目的で使用できます。

4. Oracle Enterprise Manager Fusion Middleware Controlを開始します。

5. .earファイルの場所を入力します。

6. 「次へ」をクリックします。
「ターゲットの選択」ページが表示されます。

7. デプロイメント・プランの場所を入力します。

8. SOAターゲットを選択します。

9. 「アプリケーション属性」ページでアプリケーション名を入力します。アプリケーション名は、デプロイ・プランで指定したDriverDeploymentName(前述のステップ3)に使用した文字列と正確に一致する必要があります。一致しない場合、デプロイメントおよびアクティブ化は失敗します。「デプロイ設定」ページが表示されます。

10. 「デプロイ」をクリックします。「デプロイが完了しました」ページが表示されます。

11. 結果(デプロイされたドライバ)を確認するには、SOAサーバーを起動します。

29.1.3 Oracle Fusion Middleware構成ウィザードを使用したドライバのデプロイ

SMPP、XMPPおよびVoiceXMLの各ドライバをインストールするには、$ORACLE_HOME/common/templates/applications/oracle.ums.drivers_template_11.1.1.jarで入手できる拡張テンプレートを使用してドメインを拡張します。Oracle Fusion Middleware構成ウィザードを使用してドメインを拡張する手順は、次のとおりです。

1. Oracle Fusion Middleware構成ウィザードを起動します($ORACLE_HOME/common/bin/config.shまたは%ORACLE_HOME%\common\bin\config.cmd)。

2. 「既存のWebLogicドメインの拡張」オプションを選択します。

3. UMSが含まれている目的のドメインのディレクトリを選択します。

4. 「既存の拡張テンプレートを使用してドメインを拡張する」オプションを選択します。

5. 「参照」をクリックし、$ORACLE_HOME/common/templates/applicationsに移動します。

6. 「oracle.ums.drivers_template_11.1.1.jar」を選択します。

7. Oracle Fusion Middleware構成ウィザードの残りのステップを完了し、必要なドライバを目的のOracle WebLogic Serverまたはクラスタ(あるいはその両方)に確実にデプロイします。

8. 適切なOracle WebLogic Serverを再起動します。

29.1.4 wsadminツールを使用したドライバのデプロイ

UMSドライバの追加インスタンスをデプロイするには、Oracle Fusion Middleware固有のwsadminコマンドのOracleUMS.deployUserMessagingDriverを使用します。

29.1.4.1 wsadminのOracleUMS.deployUserMessagingDriverコマンドについて

この項では、wsadminのOracleUMS.deployUserMessagingDriverコマンドの構文と引数について説明します。

29.1.4.1.1 説明

OracleUMS.deployUserMessagingDriverは、ユーザー・メッセージング・ドライバの追加インスタンスをデプロイするために使用されます。

新しいドライバ・デプロイメントのベース・ドライバ・タイプ(email、xmpp、smpp、voicexml、proxy、worklist)および短縮名を指定します。指定されたアプリケーション名の前に文字列「usermessagingdriver-」が付加されます。

29.1.4.1.2 構文

OracleUMS.deployUserMessagingDriver(baseDriver, appName, required_options)

引数

定義

baseDriver

ベース・メッセージング・ドライバ・タイプを指定します。

email、proxy、smpp、voicexmlまたはworklistなどの既知のドライバ・タイプである必要があります。

appName

新規デプロイメントの短い説明の名前。指定された値が文字列usermessagingdriver-の前に付加されます。

required_options

AdminApp.installコマンドの有効な追加の引数。

このコマンドでは、次のオプションが必須です。

-node、-cell、-server、-usedefaultbindingsおよび-defaultbinding.virtual.host。

例:

OracleUMS.deployUserMessagingDriver('email', 'myEmail', '-node myNode -cell myCell
-server myServer -usedefaultbindings -defaultbinding.virtual.host default_host')

説明:

emailとmyEmailは、それぞれbaseDriverとappName引数の値を表しています。

-node、-cell、-server、-usedefaultbindings、-defaultbinding.virtual.hostは、必須オプションです。myNode、myCell、myServerおよびdefault_hostは、それぞれオプションの値を表しています。

29.1.4.1.3 例

soa_server1という名前のSOAサーバーにsmpp2という名前の電子メール・ドライバの2番目のインスタンスをデプロイする場合

wsadmin> OracleUMS.deployUserMessagingDriver('smpp','smpp2','-node DefaultNode01
-cell DefaultCell01 -server soa_server1 -usedefaultbindings
-defaultbinding.virtual.host default_host')

bam_server1という名前のBAMサーバーにemail2という名前の電子メール・ドライバの2番目のインスタンスをデプロイする場合

wsadmin> OracleUMS.deployUserMessagingDriver('email','email2','-node DefaultNode01
-cell DefaultCell01 -server bam_server1 -usedefaultbindings
-defaultbinding.virtual.host default_host')

29.1.4.2 追加ドライバのデプロイ

wsadminツールを使用してUMSドライバをデプロイする手順は、次のとおりです。

1. ブラウザを開いて次のURLを入力し、IBM WebSphere管理コンソール(IBM WebSphere Integrated Solutions Consoleとも呼びます)にアクセスします。

https://hostname:SSL Port/ibm/console

2. 管理者の名前とパスワードを使用して、管理コンソールにログインします。

3. 「システム管理」→「デプロイメント・マネージャ」→「構成」→「ポート」→「BOOTSTRAP_ADDRESS」の順に移動し、対応するポート番号を識別します。

4. Oracle SOAサーバーが実行中のシステムで、ORACLE_HOME環境変数をOracle Fusion Middleware SOAコンポーネントがインストールされている場所に設定します。この変数は、wsadminコマンドを実行する前に設定する必要があります。
次に例を示します。

UNIXプラットフォームの場合は、UNIXシェルで次のコマンドを実行します。

$ export ORACLE_HOME=/fmwwas-nd/middleware/Oracle_SOA1

Windowsプラットフォームの場合は、DOSシェルで次のコマンドを実行します。

C:\> set ORACLE_HOME=C:\fmwwas-nd\middleware\Oracle_SOA1

5. ORACLE_HOME\common\binフォルダから、wsadminコマンドを実行します。-portオプションの値としてRMIポート番号(ステップ2を参照)を指定します。

UNIXの場合:

ORACLE_HOME/common/bin/wsadmin.sh
-profileName profilename
-connType RMI
-host hostname
-port RMI_port
-user admin_user
-password admin_password

Windowsの場合:

ORACLE_HOME\common\bin\wsadmin.cmd
-profileName profilename
-connType RMI
-host hostname
-port RMI_port
-user admin_user
-password admin_password

6. すでにデプロイされているエンタープライズ・アプリケーションおよびドライバのリストを表示するには、wsadminコマンドを次のように実行します。

wsadmin>print AdminApp.list()
DMS Application_11.1.1.1.0
DefaultToDoTaskFlow
Dmgr DMS Application_11.1.1.1.0
FMW Welcome Page Application_11.1.0.0.0
User Messaging Parlay X Sample App
composer
em
oracle-bam
soa-infra
usermessagingdriver-email
usermessagingdriver-smpp
usermessagingdriver-voicexml
usermessagingdriver-xmpp
usermessagingserver
worklistapp
wsil-nonwls
wsm-pm

7. OracleUMS.deployUserMessagingDriverコマンドを実行し、次のようにUMSドライバをデプロイします。

wsadmin> OracleUMS.deployUserMessagingDriver('email','email01','-node
DefaultNode01 -cell DefaultCell01 -server soa_server1 -usedefaultbindings
-defaultbinding.virtual.host default_host')

8. 新しくデプロイしたUMSドライバを他のエンタープライズ・アプリケーションおよびドライバとともにリストされることを確認するには、次のコマンドを実行します。

wsadmin>print AdminApp.list()
DMS Application_11.1.1.1.0
DefaultToDoTaskFlow
Dmgr DMS Application_11.1.1.1.0
FMW Welcome Page Application_11.1.0.0.0
User Messaging Parlay X Sample App
composer
em
oracle-bam
soa-infra
usermessagingdriver-email
usermessagingdriver-email-email01
usermessagingdriver-smp
usermessagingdriver-voicexml
usermessagingdriver-xmpp
usermessagingserver
worklistapp
wsil-nonwls
wsm-pm

新しくデプロイしたUMSドライバがリストされていることを確認します。前述の例では、usermessagingdriver-email-email01が新しいドライバです。

wsadminユーティリティを使用してOracle Fusion Middleware製品を構成する方法の詳細は、Oracle Fusion Middleware IBM WebSphere Application Server構成ガイドを参照してください。IBM WebSphereでのOracle SOA Suiteの管理の詳細は、Oracle Fusion Middlewareサード・パーティ・アプリケーション・サーバー・ガイドを参照してください。

29.2 ドライバのアンデプロイおよび登録解除

メッセージング・ドライバは標準JEEアプリケーションであるため、管理コンソールやWLSTなどの標準のOracle WebLogicツールを使用して、Oracle WebLogic Serverからアンデプロイできます。

ただし、UMSサーバーは、登録されたメッセージング・ドライバを永続ストア(データベース)に記録し続けるため、UMSサーバーによって公開されているランタイムMBeanを使用して、別の手順でこの登録を解除する必要があります。これをOracle Enterprise Manager Fusion Middleware Controlから実行する手順は、次のとおりです。

ドライバをアンデプロイおよび登録解除するには、次の手順を実行します。

1. UMSサーバーが使用可能であることを確認します。

2. Oracle Enterprise Manager Fusion Middleware Controlで、ドメイン内の任意のusermessagingserverターゲットを選択します。

3. ターゲットのメニューから「システムMBeanブラウザ」を選択します。

4. 「システムMBeanブラウザ」で、usermessagingserverの「ComponentAdministration」MBeanを検索します。
フォルダ「com.oracle.sdp.messaging」→「Server」(Server: soa_server1など)→「SDPMessagingrun time」→「ComponentAdministration」を開きます。

5. 操作listDriverInstancesを起動します。

1. 「操作」タブをクリックします。

2. 操作listDriverInstancesをクリックします。

3. 「呼出し」をクリックします。

4. 登録解除するドライバの名前を識別し、コピーします (例: /Farm_soa_bam_domain/soa_bam_domain/soa_server1/usermessagingdriver-email:oracle_sdpmessagingdriver_email#Email-Driver)。

6. 「戻る」をクリックします。

7. 目的のドライバ名を指定して操作unregisterDriverInstanceを起動します。

1. 操作unregisterDriverInstanceをクリックします。

2. 「値」フィールドに名前を貼り付けます(例: /Farm_soa_bam_domain/soa_bam_domain/soa_server1/usermessagingdriver-email:oracle_sdpmessagingdriver_email#Email-Driver)。

3. 「呼出し」をクリックします。

8. 確認ダイアログで処理が成功したことを確認します。

これで、指定したドライバのUMSサーバーからの登録解除が完了し、今後のメッセージ配信で使用されなくなります。

第XI部

Oracle JCAアダプタの管理

この部では、Oracle JCAアダプタの管理方法について説明します。

次の章で構成されています。

- 第30章「Oracle JCAアダプタの構成」

- 第31章「Oracle JCAアダプタの監視」

30 Oracle JCAアダプタの構成

この章では、Oracle JCAアダプタ実行時のインバウンドおよびアウトバウンドのエンドポイント・プロパティの構成方法について説明します。

この章では、次の項目について説明します。

- 第30.1項「インバウンド・アダプタのエンドポイント・プロパティの構成」

- 第30.2項「アウトバウンド・アダプタのエンドポイント・プロパティの構成」

アダプタのチューニングとパフォーマンス・プロパティの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』を参照してください。

30.1 インバウンド・アダプタのエンドポイント・プロパティの構成

この項では、インバウンド・アダプタのエンドポイント・プロパティの構成方法について説明します。次の項目が含まれます。

- 第30.1.1項「インバウンド・アダプタの事前定義されたプロパティの編集」

- 第30.1.2項「インバウンド・アダプタの事前定義されたプロパティの追加」

- 第30.1.3項「インバウンド・アダプタの新規プロパティの作成」

- 第30.1.4項「インバウンド・アダプタのプロパティの削除」

- 第30.1.5項「インバウンド・アダプタのプロパティ値を元に戻す」

30.1.1 インバウンド・アダプタの事前定義されたプロパティの編集

アダプタのプロパティは、通常、設計時にOracle JDeveloperで定義されます。ただし、Oracle Enterprise Manager Fusion Middleware Controlを使用して、後で事前定義プロパティを編集できます。

インバウンド・アダプタの事前定義されたプロパティを編集する手順は、次のとおりです。

1. 次のいずれかの方法を使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジット・アプリケーションのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

2. 事前定義されたプロパティを編集します。

1. 「プロパティ」をクリックし、現在定義されているバインディング・プロパティのリストを表示します。

2. 編集するプロパティを選択します。

3. 「値」テキスト・ボックスで値を編集し、次に、「保存」をクリックします。
これで、インバウンド・アダプタの事前定義されたプロパティの編集を完了しました。

アダプタの構成の詳細は、第36.1項「サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントのプロパティの構成」および『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

30.1.2 インバウンド・アダプタの事前定義されたプロパティの追加

アダプタのプロパティは、通常、設計時にOracle JDeveloperで定義されます。ただし、Oracle Enterprise Manager Fusion Middleware Controlを使用して、後でプロパティを追加できます。

注意:

「プロパティ」ページには、エンドポイント・プロパティとバインディング・プロパティの両方がリストされますが、追加できるのはエンドポイント・プロパティのみです。

インバウンド・アダプタの事前定義されたプロパティを追加する手順は、次のとおりです。

1. 次のいずれかの方法を使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジット・アプリケーションのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

2. 事前定義されたプロパティを追加します。

1. 「プロパティ」タブをクリックし、現在定義されているバインディング・プロパティのリストを表示します。

2. 「追加」ボタンをクリックします。
既存のプロパティ・リストに、空の新規行が追加されます。

3. 新規行の「名前」フィールドで「値の選択」アイコンをクリックします。
「プロパティ」ダイアログが表示されます。

4. 特定のアダプタに対して有効なプロパティをプロパティ・リストから選択し、「OK」をクリックします。

5. 「保存」をクリックします。
これで、インバウンド・アダプタの事前定義されたプロパティの追加を完了しました。

アダプタの構成の詳細は、第36.1項「サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントのプロパティの構成」および『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

30.1.3 インバウンド・アダプタの新規プロパティの作成

アダプタのプロパティは、通常、設計時にOracle JDeveloperで定義されます。ただし、Oracle Enterprise Manager Fusion Middleware Controlを使用して、後で新しいプロパティを追加できます。

インバウンド・アダプタの新規プロパティを作成する手順は、次のとおりです。

1. 次のいずれかの方法を使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジット・アプリケーションのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

2. 新規プロパティを作成します。

1. 「プロパティ」タブをクリックし、現在定義されているバインディング・プロパティのリストを表示します。

2. 「追加」ボタンをクリックします。
既存のプロパティ・リストに、空の新規行が追加されます。

3. 新規行の「名前」フィールドと「値」フィールドに、プロパティの名前と値を指定します。

4. 「保存」をクリックします。
これで、インバウンド・アダプタの新規プロパティの作成を完了しました。

アダプタの構成の詳細は、第36.1項「サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントのプロパティの構成」および『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

30.1.4 インバウンド・アダプタのプロパティの削除

プロパティの事前定義リストから追加したプロパティ、または新規作成したプロパティのみ削除できます。

インバウンド・アダプタのプロパティを削除する手順は、次のとおりです。

1. 次のいずれかの方法を使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジット・アプリケーションのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

2. プロパティを削除します。

1. 「プロパティ」タブをクリックし、現在定義されているバインディング・プロパティのリストを表示します。

2. 削除するプロパティを選択し、「削除」をクリックします。
処理を確認するメッセージが表示されます。

3. 「OK」をクリックして処理を確認します。

4. 「保存」をクリックします。
これで、インバウンド・アダプタのプロパティの削除を完了しました。

アダプタの構成の詳細は、第36.1項「サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントのプロパティの構成」および『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

30.1.5 インバウンド・アダプタのプロパティ値を元に戻す

自分で変更したプロパティのみ元に戻すことができます。また、元に戻す操作を実行できるのは、既存のプロパティ値に対してのみで、プロパティの事前定義リストから追加したプロパティまたは作成したプロパティに対しては実行できません。

インバウンド・アダプタのプロパティ値を元に戻す手順は、次のとおりです。

1. 次のいずれかの方法を使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジット・アプリケーションのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

2. インバウンド・アダプタのプロパティ値を元に戻します。

1. 「プロパティ」タブをクリックし、現在定義されているバインディング・プロパティのリストを表示します。

2. 元に戻すプロパティを選択し、「元に戻す」をクリックします。
処理を確認するメッセージが表示されます。

3. 「OK」をクリックして処理を確認します。

4. 「保存」をクリックします。
これで、インバウンド・アダプタのプロパティ値は元に戻りました。

アダプタの構成の詳細は、第36.1項「サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントのプロパティの構成」および『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

30.2 アウトバウンド・アダプタのエンドポイント・プロパティの構成

この項では、アウトバウンド・アダプタのエンドポイント・プロパティの構成方法について説明します。次の項目が含まれます。

- 第30.2.1項「アウトバウンド・アダプタの事前定義されたプロパティの編集」

- 第30.2.2項「アウトバウンド・アダプタの事前定義されたプロパティの追加」

- 第30.2.3項「アウトバウンド・アダプタの新規プロパティの作成」

- 第30.2.4項「アウトバウンド・アダプタのプロパティの削除」

- 第30.2.5項「アウトバウンド・アダプタのプロパティ値を元に戻す」

30.2.1 アウトバウンド・アダプタの事前定義されたプロパティの編集

アダプタのプロパティは、通常、設計時にOracle JDeveloperで定義されます。ただし、Oracle Enterprise Manager Fusion Middleware Controlを使用して、後で事前定義プロパティを編集できます。

アウトバウンド・アダプタの事前定義されたプロパティを編集する手順は、次のとおりです。

1. 次のいずれかの方法を使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジット・アプリケーションのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「参照ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「参照ホーム」ページが表示されます。

2. 事前定義されたプロパティを編集します。

1. 「プロパティ」タブをクリックし、現在定義されているバインディング・プロパティのリストを表示します。

2. 編集するプロパティを選択します。

3. 「値」テキスト・ボックスで値を編集し、次に、「保存」をクリックします。
これで、アウトバウンド・アダプタの事前定義されたプロパティの編集を完了しました。

注意:

非同期のアウトバウンド・リクエスト/リプライ・シナリオにおけるOracle MQ Seriesアダプタでは、プロパティは(Enqueue)または(Dequeue)ラベルによって区別されます。たとえば、QueueName(Enqueue)はメッセージをプットするために使用され、QueueName(Dequeue)はリプライをデキューするために使用されます。

このシナリオでOracle MQ Seriesアダプタのプロパティを編集する場合は、次のことに注意してください。

- ReplyToQueueName(Enqueue)プロパティを変更する場合は、QueueName(Dequeue)プロパティも同じ値に変更する必要があります。

- MessageId(Dequeue)プロパティを変更する場合は、MessageId(Enqueue)プロパティも同じ値に変更する必要があります。

- CorrelationId(Dequeue)プロパティを変更する場合は、CorrelationId(Enqueue)プロパティも同じ値に変更する必要があります。

アダプタの構成の詳細は、第36.1項「サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントのプロパティの構成」および『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

30.2.2 アウトバウンド・アダプタの事前定義されたプロパティの追加

アダプタのプロパティは、通常、設計時にOracle JDeveloperで定義されます。ただし、Oracle Enterprise Manager Fusion Middleware Controlを使用して、後で事前定義プロパティを追加できます。

アウトバウンド・アダプタの事前定義されたプロパティを追加する手順は、次のとおりです。

1. 次のいずれかの方法を使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジット・アプリケーションのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「参照ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「参照ホーム」ページが表示されます。

2. 事前定義されたプロパティを追加します。

1. 「プロパティ」タブをクリックし、現在定義されているバインディング・プロパティのリストを表示します。

2. 「追加」ボタンをクリックします。
既存のプロパティ・リストに、空の新規行が追加されます。

3. 新規行の「名前」フィールドで「値の選択」アイコンをクリックします。
「プロパティ」ダイアログが表示されます。

4. 特定のアダプタに対して有効なプロパティをプロパティ・リストから選択し、「OK」をクリックします。

5. 「保存」をクリックします。
これで、アウトバウンド・アダプタの事前定義されたプロパティの追加を完了しました。

アダプタの構成の詳細は、第36.1項「サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントのプロパティの構成」および『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

30.2.3 アウトバウンド・アダプタの新規プロパティの作成

アダプタのプロパティは、通常、設計時にOracle JDeveloperで定義されます。ただし、Oracle Enterprise Manager Fusion Middleware Controlを使用して、後で新しいプロパティを追加できます。

アウトバウンド・アダプタの新規プロパティを作成する手順は、次のとおりです。

1. 次のいずれかの方法を使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジット・アプリケーションのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「参照ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「参照ホーム」ページが表示されます。

2. 新規プロパティを作成します。

1. 「プロパティ」タブをクリックし、現在定義されているバインディング・プロパティのリストを表示します。

2. 「追加」ボタンをクリックします。
既存のプロパティ・リストに、空の新規行が追加されます。

3. 新規行の「名前」フィールドと「値」フィールドに、プロパティの名前と値を指定します。

4. 「保存」をクリックします。
これで、アウトバウンド・アダプタの新規プロパティの作成を完了しました。

アダプタの構成の詳細は、第36.1項「サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントのプロパティの構成」および『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

30.2.4 アウトバウンド・アダプタのプロパティの削除

プロパティの事前定義リストから追加したプロパティ、または新規作成したプロパティのみ削除できます。

アウトバウンド・アダプタのプロパティを削除する手順は、次のとおりです。

1. 次のいずれかの方法を使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジット・アプリケーションのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「参照ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「参照ホーム」ページが表示されます。

2. アウトバウンド・アダプタのプロパティを削除します。

1. 「プロパティ」タブをクリックし、現在定義されているバインディング・プロパティのリストを表示します。

2. 削除するプロパティを選択し、「削除」をクリックします。
処理を確認するメッセージが表示されます。

3. 「OK」をクリックして処理を確認します。

4. 「保存」をクリックします。
これで、アウトバウンド・アダプタのプロパティの削除を完了しました。

アダプタの構成の詳細は、第36.1項「サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントのプロパティの構成」および『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

30.2.5 アウトバウンド・アダプタのプロパティ値を元に戻す

既存のプロパティ値に対する変更(ある場合)のみ元に戻すことができます。プロパティの事前定義リストから追加したプロパティ、または新規作成したプロパティに対する変更は元に戻せません。

インバウンド・アダプタのプロパティ値を元に戻す手順は、次のとおりです。

1. 次のいずれかの方法を使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジット・アプリケーションのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「参照ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「参照ホーム」ページが表示されます。

2. アウトバウンド・アダプタのプロパティ値を元に戻します。

1. 「プロパティ」タブをクリックし、現在定義されているバインディング・プロパティのリストを表示します。

2. 元に戻すプロパティを選択し、「元に戻す」をクリックします。
処理を確認するメッセージが表示されます。

3. 「OK」をクリックして処理を確認します。

4. 「保存」をクリックします。
これで、アウトバウンド・アダプタのプロパティ値は元に戻りました。

アダプタの構成の詳細は、第36.1項「サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントのプロパティの構成」および『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

31 Oracle JCAアダプタの監視

この章では、インバウンドおよびアウトバウンドのOracle JCAアダプタの監視方法(インスタンスとフォルト、最新のフォルトと拒否メッセージ、アダプタのプロパティおよびアダプタ・ログの監視を含む)について説明します。

この章では、次の項目について説明します。

- 第31.1項「インバウンド・アダプタのインスタンスとフォルトの監視」

- 第31.2項「インバウンド・アダプタの最新のフォルトと拒否メッセージの監視」

- 第31.3項「インバウンド・アダプタのフォルトと拒否メッセージの監視」

- 第31.4項「インバウンド・アダプタのプロパティの監視」

- 第31.5項「アウトバウンド・アダプタのインスタンスとフォルトの監視」

- 第31.6項「アウトバウンド・アダプタの最新のフォルトの監視」

- 第31.7項「アウトバウンド・アダプタのフォルトの監視」

- 第31.8項「アウトバウンド・アダプタのプロパティの監視」

- 第31.9項「アダプタ・ログの監視」

31.1 インバウンド・アダプタのインスタンスとフォルトの監視

コンポジットからサービスを起動するとエラーが発生する場合があります。このエラーは、サービスのフォルトとして取得されます。インバウンド・アダプタのインスタンスおよびフォルトの詳細は、「ダッシュボード」ページの「インスタンスとフォルト」セクションに表示されます。

インバウンド・アダプタのインスタンスとフォルトを監視する手順は、次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジットのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

2. インバウンド・アダプタのインスタンスとフォルトを監視します。

1. 「ダッシュボード」をクリックします。
「ダッシュボード」ページが表示されます。

2. 「インスタンスとフォルト」セクションにリストされたインスタンスとフォルトを確認します。
フォルトの詳細は、「インスタンスとフォルト」セクションに折れ線グラフで表示されます。この折れ線グラフは、サーバー起動時以降の送信メッセージの合計数およびフォルトの合計数を示します。

アダプタの監視の詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

31.2 インバウンド・アダプタの最新のフォルトと拒否メッセージの監視

「ダッシュボード」ページの「最新のフォルトと拒否メッセージ」セクションで、インバウンド・アダプタの最新のフォルトと拒否メッセージの詳細を表示できます。

インバウンド・アダプタの最新の拒否メッセージを監視する手順は、次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジットのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

2. インバウンド・アダプタの最新のフォルトと拒否メッセージを監視します。

1. 「ダッシュボード」をクリックします。
「ダッシュボード」ページが表示されます。

2. 「最新のフォルトと拒否メッセージ」セクションにリストされた最新のフォルトと拒否メッセージを確認します。
最新のフォルトと拒否メッセージのリストが、エラー・メッセージ、フォルト時間、コンポジット・インスタンスIDなどの詳細とともに表示されます。

アダプタの監視の詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

31.3 インバウンド・アダプタのフォルトと拒否メッセージの監視

「フォルトと拒否メッセージ」ページで、インバウンド・アダプタのフォルトと拒否メッセージの詳細を表示できます。

インバウンド・アダプタの拒否メッセージを監視する手順は、次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジットのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

2. インバウンド・アダプタのフォルトと拒否メッセージを監視します。

1. 「フォルト・メッセージと拒否メッセージ」をクリックします。
「フォルト・メッセージと拒否メッセージ」ページが表示されます。

フォルトと拒否メッセージのリストが、エラー・メッセージ、フォルト時間、コンポジット・インスタンスIDなどの詳細とともに表示されます。

アダプタの監視の詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

31.3.1 インバウンド・アダプタの拒否メッセージの検索

インバウンド・アダプタのフォルトと拒否メッセージを検索するには、検索機能を使用します。

インバウンド・アダプタのフォルトと拒否メッセージを検索する手順は、次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジット・アプリケーションのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

2. 「フォルト・メッセージと拒否メッセージ」タブをクリックします。

3. 次の検索基準のいずれかまたはすべてを入力します。

- エラー・メッセージの内容
エラー・メッセージ・テキストの一部分を入力します。

- フォルトID
フォルトのIDを入力します。

- フォルト時間の開始
フォルトが発生した可能性がある時間範囲の開始時間を入力します。

- フォルト時間の終了
フォルトが発生した可能性がある時間範囲の終了時間を入力します。

- コンポジット・インスタンスID
コンポジットのIDを入力します。

- フォルト・タイプ
使用可能なフォルトのリストからタイプを選択します。

4. 「検索」をクリックして検索操作を開始します。
指定した基準に一致するフォルトまたは拒否メッセージが表示されます。

5. 「リセット」をクリックして検索基準をリセットします。

アダプタの構成の詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

31.3.2 インバウンド・アダプタの拒否メッセージの削除

検索基準を指定して、データベースから直接拒否メッセージを削除できます。

インバウンド・アダプタの拒否メッセージを削除する手順は、次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジット・アプリケーションのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

2. 「フォルト・メッセージと拒否メッセージ」タブをクリックします。

3. 「拒否メッセージの削除」をクリックします。
「削除: 拒否メッセージ」ダイアログが表示されます。

4. データベースから直接拒否メッセージを削除するための選択基準を指定して、「削除」をクリックします。

フォルトを削除するには、 「インスタンス」 ページから、関連するコンポジット・インスタンスを削除する必要があることに注意してください。

アダプタの構成の詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

31.4 インバウンド・アダプタのプロパティの監視

「プロパティ」ページで、インバウンド・アダプタのプロパティの詳細を表示できます。

インバウンド・アダプタのプロパティを監視する手順は、次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジットのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでインバウンド・アダプタ(サービス)をクリックします。
「サービス・ホーム」ページが表示されます。

2. インバウンド・アダプタのプロパティを監視します。

1. 「プロパティ」をクリックします。
プロパティ・ページが表示されます。

プロパティのリストが、名前や値などの詳細とともに表示されます。

注意:

インバウンドの非同期リクエスト/リプライ・シナリオ(リプライ送信操作の前にメッセージ取得操作が実行されるシナリオ)が含まれるアダプタでは、アクティブ化仕様に関する詳細のみが表示され、相互作用仕様に関する詳細は表示されません。

アダプタの監視の詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

31.5 アウトバウンド・アダプタのインスタンスとフォルトの監視

コンポジットからの参照の起動は、エラーになる場合があります。このエラーは、参照内でフォルトとしてキャプチャされます。「ダッシュボード」ページの「インスタンスとフォルト」セクションで、アウトバウンド・アダプタのインスタンスとフォルトの詳細を表示できます。

アウトバウンド・アダプタのインスタンスとフォルトを監視する手順は、次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジットのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「サービス・ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「サービス・ホーム」ページが表示されます。

2. アウトバウンド・アダプタのインスタンスとフォルトを監視します。

1. 「ダッシュボード」をクリックします。
「ダッシュボード」ページが表示されます。

2. 「インスタンスとフォルト」セクションにリストされたインスタンスとフォルトを確認します。
フォルトの詳細は、「インスタンスとフォルト」セクションに折れ線グラフで表示されます。この折れ線グラフは、サーバー起動時以降の送信メッセージの合計数およびフォルトの合計数を示します。

アダプタの監視の詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

31.6 アウトバウンド・アダプタの最新のフォルトの監視

アウトバウンド・アダプタの最新のフォルトの詳細は、「ダッシュボード」ページの「最新のフォルト」セクションに表示できます。

アウトバウンド・アダプタの最新のフォルトを監視する手順は、次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジットのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「サービス・ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「サービス・ホーム」ページが表示されます。

2. アウトバウンド・アダプタの最新のフォルトを監視します。

1. 「ダッシュボード」をクリックします。
「ダッシュボード」ページが表示されます。

2. 「最新のフォルト」セクションにリストされた最新のフォルトを確認します。
最新のフォルトのリストが、名前、時間、タイプなどの詳細とともに表示されます。

アダプタの監視の詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

31.7 アウトバウンド・アダプタのフォルトの監視

アウトバウンド・アダプタのインスタンスとフォルトの詳細は、「フォルト」ページに表示できます。

アウトバウンド・アダプタのフォルトを監視する手順は、次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジットのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「サービス・ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「サービス・ホーム」ページが表示されます。

2. アウトバウンド・アダプタのフォルトを監視します。

1. 「フォルト」タブをクリックします。
「フォルト」ページが表示されます。

2. 「表示」をクリックします。
フォルトのリストが、名前、時間、タイプなどの詳細とともに表示されます。

アダプタの監視の詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

31.7.1 アウトバウンド・アダプタのフォルトの検索

アウトバウンド・アダプタのフォルトを検索するには、検索機能を使用します。

アウトバウンド・アダプタのフォルトを検索する手順は、次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジット・アプリケーションのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「参照ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「参照ホーム」ページが表示されます。

2. 「フォルト」タブをクリックします。

3. 「検索」セクションで、次の検索基準のいずれかまたはすべてを入力します。

- エラー・メッセージの内容
エラー・メッセージ・テキストの一部分を入力します。

- フォルトID
フォルトのIDを入力します。

- フォルト時間の開始
フォルトが発生した可能性がある時間範囲の開始時間を入力します。

- フォルト時間の終了
フォルトが発生した可能性がある時間範囲の終了時間を入力します。

- コンポジット・インスタンスID
コンポジットのIDを入力します。

- フォルト・タイプ
使用可能なタイプのリストからフォルト・タイプを選択します。

4. 「検索」をクリックして検索操作を開始します。
指定した基準に一致するフォルトが表示されます。

5. 「リセット」をクリックして検索基準をリセットします。

アダプタの構成の詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

31.8 アウトバウンド・アダプタのプロパティの監視

アウトバウンド・アダプタのプロパティの詳細は、「プロパティ」ページで表示できます。

アウトバウンド・アダプタのプロパティを監視する手順は、次のとおりです。

1. 次のいずれかのオプションを使用して、SOAコンポジット・アプリケーションに移動します。

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」をクリックします。
「SOAインフラストラクチャ」ページが表示されます。

2. 「デプロイ済コンポジット」タブをクリックします。
デプロイ済コンポジットのリストが表示されます。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

4. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「サービス・ホーム」ページが表示されます。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションをクリックします。
SOAコンポジットのホーム・ページが表示されます。

2. 右パネルの「サービスと参照」セクションでアウトバウンド・アダプタ(参照)をクリックします。
「サービス・ホーム」ページが表示されます。

2. アウトバウンド・アダプタのプロパティを監視します。

1. 「プロパティ」タブをクリックします。
プロパティ・ページが表示されます。

2. 「表示」をクリックします。
プロパティのリストが、名前や値などの詳細とともに表示されます。

注意:

アウトバウンドの非同期リクエスト/リプライ・シナリオ(レスポンス取得操作の前にメッセージ送信操作が実行されるシナリオ)が含まれるアダプタの場合、相互作用仕様に関する詳細のみが表示され、アクティブ化仕様に関する詳細は表示されません。

アダプタの監視の詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。

31.9 アダプタ・ログの監視

Oracle Fusion Middlewareのコンポーネントではログ・ファイルが生成され、起動と停止情報、エラー、警告メッセージ、HTTPリクエストに関するアクセス情報および追加情報を含むすべてのタイプのイベントを記録するメッセージが格納されます。すべてのOracle JCAアダプタに対してログは1つのみ生成され、このログはoracle.soa.adapterと呼ばれます。

ファイル・アダプタ・ログを監視する手順は、次のとおりです。

1. コンポジット・ホーム→「J2EEアプリケーション」(メニュー)→「監視」→「ログ」の順に移動します。

2. アダプタに対するoracle.soa.adapterのロガーを検索し、冗長性を高くします。

3. 結果のログ・ファイルを検索します。

4. アダプタが失敗するようにします。たとえば、ファイル・アダプタが書き込むディレクトリを削除したり、データベース・アダプタが読み込む表を削除します。

5. 結果のログ・ファイルに、失敗の原因が正しく示されていることを確認します。

ログの構成の詳細は、第3.4項「ログ・ファイルの構成」を参照してください。

第XII部

Oracle B2BとOracle Healthcareの管理

この部では、Oracle B2BとOracle Healthcareの管理方法を説明します。

次の章で構成されています。

- 第32章「Oracle B2Bの構成」

- 第33章「Oracle B2Bの監視」

- 第34章「Oracle Healthcareの監視」

32 Oracle B2Bの構成

この章では、Oracle B2Bを構成してB2Bバインディング上にデータを表示し、Oracle B2B操作および属性を構成する方法について説明します。

この章では、次の項目について説明します。

- 第32.1項「Oracle B2Bサーバーのプロパティの構成」

- 第32.2項「Oracle B2B操作の構成」

- 第32.3項「Oracle B2B属性の構成」

- 第32.4項「Oracle B2Bロギング・モードの構成」

Oracle B2Bのチューニングとパフォーマンス・プロパティの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』を参照してください。

32.1 Oracle B2Bサーバーのプロパティの構成

Oracle Enterprise Manager Fusion Middleware Controlの「B2Bサーバー・プロパティ」ページにある「メトリックの有効化」プロパティを構成できます。

メトリックは、デフォルトで有効化されています。このメトリックには、最近のアクティブなドキュメント・タイプの上位5つと取引パートナの上位5つ、およびインバウンドとアウトバウンドのエンドポイントに関するデータが含まれています。

注意:

このプロパティを変更した後、サーバーを再起動する必要はありません。

Oracle B2Bサーバー・プロパティを構成する手順は、次のとおりです。

1. 「SOAインフラストラクチャ」メニューから、「SOA管理」→「B2Bサーバー・プロパティ」の順に選択します。

2. 「メトリックの有効化」を選択して、B2BバインディングとSOAコンポジットの各ページにデータを表示します。

企業とその取引パートナ間でのセキュアで信頼性の高いビジネス・ドキュメント交換を可能にするOracle B2Bの使用方法の詳細は、『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』を参照してください。

32.2 Oracle B2B操作の構成

Oracle B2B操作のプロパティは、「システムMBeanブラウザ」を使用して値を設定することで構成できます。

注意:

次の「MBean」プロパティを更新した場合は、SOAサーバーを再起動する必要があります。

- b2b.inboundThreadCount

- b2b.outboundThreadCount

Oracle B2B操作のプロパティを指定する手順は、次のとおりです。

注意(ショートカット):

Oracle B2Bのアプリケーション定義のMBeanにアクセスするには、「B2Bサーバー・プロパティ」ページで「詳細B2B構成プロパティ」リンクをクリックすることもできます。

1. 「SOA」ノードを展開し、「soa-infra」ノードを選択します。

2. 「SOAインフラストラクチャ」メニューから、「管理」→「システムMBeanブラウザ」の順に選択します。
「システムMBeanブラウザ」ページが表示されます。

3. 「アプリケーション定義のMBean」の下の「oracle.as.soainfra.config」ノードを展開します。

4. 「Server:soa_server1」ノードを開きます。

5. 「B2BConfig」ノードを開きます。

6. 「b2b」MBeanをクリックします。

MBeanのプロパティが右側のペインに表示されます。

7. 「操作」タブをクリックします。

8. リスト内の操作をクリックします。

9. 必要な情報(キー、値、および必要に応じてコメント)を指定して、「呼出し」をクリックします。
プロパティ名と有効な値のリスト、デプロイメント中に検証をオフにするプロパティを含める方法、MDSキャッシュ・サイズの設定、スレッド数とスレッド・スリープ時間の設定、機能承認の処理方法の指定、ペイロードの難読化の設定などの詳細は、『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』の付録のFusion Middleware ControlでのOracle B2B構成プロパティの設定に関する項を参照してください。

32.3 Oracle B2B属性の構成

Oracle B2B属性は、「システムMBeanブラウザ」を使用して値を設定することで構成できます。

Oracle B2B属性のプロパティを指定する手順は、次のとおりです。

1. 第32.2項「Oracle B2B操作の構成」のステップ1から6を実行します。

2. 「属性」タブをクリックします。

3. 「プロパティ」をクリックします。

4. 「Element_0」、「Element_1」などを展開して、変更するプロパティを見つけます。

5. プロパティ名と値を確認して、「戻る」をクリックします。
たとえば、「Element_3」の下には、デフォルト値「False」の「b2b.payloadObfuscation」プロパティがあります。

6. 「操作」タブをクリックします。

7. 「setProperty」をクリックします。

8. キー、値、および必要に応じてコメントを入力します。

たとえば、ペイロードの難読化を有効にするには、「b2b.payloadObfuscation」に「True」を設定します。

9. 「呼出し」をクリックします。

10. 「戻る」をクリックします。

32.4 Oracle B2Bロギング・モードの構成

Oracle Enterprise Manager Fusion Middleware Controlを使用してOracle B2Bのロギング・モードを構成できます。

たとえば、ログ・モードをTRACEモード(DEBUG)に設定する手順は次のとおりです。

1. 「SOA」ノードを展開し、「soa-infra」ノードを選択します。

2. 「SOAインフラストラクチャ」メニューから、「ログ」→「ログ構成」の順に選択します。

3. 「ログ構成」ページで、「oracle.soa」を開きます。

4. 「Oracle Diagnostic Loggingレベル」(Javaレベル)リストを使用して、TRACE:32 (最も詳細)を「oracle.soa.b2b」に選択します。

5. 「適用」をクリックします。

注意:

ログ・ファイル、およびログ・ファイルに書き込むロギング情報のレベルとタイプの詳細は、『Oracle Fusion Middleware管理者ガイド』を参照してください。

33 Oracle B2Bの監視

こ章では、Oracle B2Bの監視方法(Oracle B2Bインフラストラクチャの監視、Oracle B2Bバインディング・コンポーネントのメッセージ・フローの表示、サービスと参照の表示、B2Bコンポジットの「フローのトレース」ページからのOracle B2Bレポートへのアクセスを含む)について説明します。

この章では、次の項目について説明します。

- 第33.1項「Oracle B2Bインフラストラクチャの監視」

- 第33.2項「「B2Bインフラストラクチャ」ページからOracle B2Bへのアクセス」

- 第33.3項「Oracle B2Bバインディング・コンポーネントのメッセージ・フローの表示」

- 第33.4項「サービスと参照の表示」

- 第33.5項「B2Bコンポジットの「フローのトレース」ページからのOracle B2Bレポートへのアクセス」

33.1 Oracle B2Bインフラストラクチャの監視

Oracle B2Bインフラストラクチャを監視するには、「B2Bサーバー・プロパティ」ページでメトリックを有効(デフォルト)にする必要があります。

「B2Bインフラストラクチャ(SOAバインディング)」ページの「関連リンク」の下部にある「B2Bサーバー・プロパティ」リンクを使用して、この設定を変更します。メトリックの有効化の詳細は、第32.1項「Oracle B2Bサーバーのプロパティの構成」を参照してください。

表33-1は、「B2Bインフラストラクチャ(SOAバインディング)」ページに表示される情報を示しています。

表33-1 B2Bインフラストラクチャ(SOAバインディング)

セクション/列

説明

最近のアクティブなドキュメント・タイプの上位5つ

アクティブなドキュメント・タイプが、サーバーの現在のセッションで交換されたメッセージの最大件数(インバウンドとアウトバウンドの合計)とともに表示されます。

このセクションには、ランタイム・センサーによってトリガーされたOracle DMSメトリックのドキュメント・タイプがリストされます。これは永続的なデータではありません。したがって、Oracle B2Bが再起動すると、Oracle B2Bアクティビティに基づいて新しいデータが表示されます。

処理済メッセージ数

ホストと取引パートナ間で交換されたドキュメント・メッセージの件数が表示されます。「アウトバウンド」はホストから取引パートナに送信されたメッセージを示し、「インバウンド」は取引パートナからホストに送信されたメッセージを示します。

平均メッセージ処理時間(秒)

アウトバウンド・メッセージとインバウンド・メッセージの両方のドキュメント平均処理時間が秒単位で表示されます。

平均メッセージ・サイズ(KB)

アウトバウンド・メッセージとインバウンド・メッセージの両方のドキュメント平均サイズがKB単位で表示されます。

エラー

ドキュメントのエラー件数が表示されます。

最近のアクティブな取引パートナの上位5つ

アクティブな取引パートナが、サーバーの現在のセッションで交換されたメッセージの最大件数(FromとToの合計)とともに表示されます。

ここには、ランタイム・センサーによってトリガーされたOracle DMSメトリックの取引パートナがリストされます。これは永続的なデータではありません。したがって、Oracle B2Bが再起動すると、Oracle B2Bアクティビティに基づいて新しいデータが表示されます。

処理済メッセージ数

ホストと取引パートナ間で送受信されたメッセージの件数が表示されます。「From」は、このパートナからその取引パートナに送信されたメッセージを示します。「To」は、このパートナが取引パートナから受信したメッセージを示します。

平均メッセージ処理時間(秒)

交換されたメッセージのドキュメント平均処理時間が秒単位で表示されます。

平均メッセージ・サイズ(KB)

交換されたメッセージのドキュメント平均サイズがKB単位で表示されます。

エラー

ドキュメントのエラー件数が表示されます。

インバウンド・エンドポイント

接続が試行された時点(接続後ではなく)のリスニング・エンドポイントのステータスが表示されます。たとえば、汎用ファイル転送を使用するEDIトランザクションで、Oracle B2Bがディレクトリから読み込む場合は、そのディレクトリがインバウンド・エンドポイントです。

プロトコル

交換に使用されるトランスポート・プロトコルのタイプ(ファイル、AQ、FTPなど)を表示します。

エンドポイント

メッセージの受信元を表示します。エンドポイントには、URL、フォルダ、パスなどがあります。

ステータス

前回接続が試行されたエンドポイント(プロトコル)のステータス(「稼働中」または「停止中」)を表示します。

アウトバウンド・エンドポイント

配信が試行された時点(配信後ではなく)の配信エンドポイントのステータスが表示されます。たとえば、汎用ファイル転送を使用するEDIトランザクションで、Oracle B2Bがディレクトリに書き込む場合は、そのディレクトリがアウトバウンド・エンドポイントです。

プロトコル

交換に使用されるトランスポート・プロトコルのタイプ(ファイル、AQ、FTPなど)を表示します。

エンドポイント

メッセージの送信先を表示します。エンドポイントには、URL、フォルダ、パスなどがあります。

ステータス

前回配信が試行されたエンドポイント(プロトコル)のステータス(「稼働中」または「停止中」)を表示します。

Oracle Enterprise Manager Fusion Middleware Controlを使用してOracle B2Bインフラストラクチャを監視する手順は、次のとおりです。

1. 「SOA」ノードを開きます。

2. SOAインフラストラクチャ(「soa-infra (soa_server1)」など)を選択します。

3. 「SOAインフラストラクチャ」メニューから、「バインディング」→「B2B」の順に選択します。
表示される情報の詳細は、表33-1を参照してください。

Fusion Middleware Controlに表示される情報は、インバウンドおよびアウトバウンドのエンドポイントを含むDMSメトリックに基づいています。このため、Oracle B2Bランタイム・データへの変更は、Fusion Middleware Controlに反映されない場合やただちに反映されない場合があります。

たとえば、ランタイム・データをパージした場合、またはOracle B2BインタフェースでOracle B2Bの構成を変更した場合、その変更はDMSメトリックには反映されません。現在のランタイム・データを表示するには、Oracle B2Bインタフェースを使用します。Fusion Middleware Controlのデータには、Oracle B2B (SOA)サーバーが起動されてからのOracle B2Bのメッセージ・トラフィックが表示されます。

33.2 「B2Bインフラストラクチャ」ページからOracle B2Bへのアクセス

Oracle B2Bにログインするには、図33-1に示すように、「関連リンク」の下にある「B2Bコンソール」リンクを使用します。

図33-1 Oracle Enterprise Manager Fusion Middleware ControlからOracle B2Bへのアクセス

Oracle B2Bインタフェースの使用方法の詳細は、『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』を参照してください。

33.3 Oracle B2Bバインディング・コンポーネントのメッセージ・フローの表示

Oracle B2Bバインディング・コンポーネントのメッセージ・フローをSOAコンポジット・アプリケーションのインスタンスに表示する手順は、次のとおりです。

1. Oracle B2Bバインディング・コンポーネントが含まれているSOAコンポジット・アプリケーションを選択します。
最新のインスタンスのリストが「ダッシュボード」ページに表示されます。

2. このSOAコンポジット・アプリケーションのすべてのインスタンスを参照するには、「インスタンス」タブをクリックします。

注意:

特定のメッセージの詳細を表示するには、Oracle B2Bインタフェースの「レポート」ページでインスタンスIDを検索します。

3. フォルトおよびフローのトレースを参照するには、「インスタンスID」リストで特定のインスタンスをクリックします。

「フローのトレース」ページに、次の詳細が表示されます。

- 「フォルト」セクションには、SOAコンポジット・アプリケーションを構成するサービス、サービス・コンポーネントおよび参照で発生しているフォルト、および収集されたセンサー情報が表示されます。

- 「トレース」セクションには、SOAコンポジット・アプリケーションを構成するサービス、サービス・コンポーネントおよび参照間での一連のメッセージ・フローが表示されます。

33.4 サービスと参照の表示

コンポジット・アプリケーションの「ダッシュボード」ページには、コンポジットで使用されるサービスと参照がリストされます。

Oracle B2Bをサービス(インバウンド)として使用する場合は、取引パートナからメッセージを受信し、それをSOAコンポジット・アプリケーションに配信します。Oracle B2Bを参照(アウトバウンド)として使用する場合は、SOAコンポジット・アプリケーションからパートナにメッセージを送信します。

図33-2に示されているOracle B2B参照(B2B_Send_ebMS_PO)の詳細は、「参照ホーム」ページに表示されます。

図33-2 Oracle B2B参照(B2B_Send_ebMS_PO)

「インスタンスとフォルト」セクションには、サーバーが起動された後の送信メッセージ件数とフォルト件数が表示されます。「最近のアクティブな取引パートナの上位5つ」セクションの詳細は、表33-1を参照してください。

「最新のフォルト」セクションには、エラー・メッセージ、フォルトの発生時間、関連するコンポジット・インスタンスIDなどの詳細とともに、フォルトが表示されます。フォルトの対象は、サービス・バインディング・コンポーネントによって処理された受信メッセージ、または参照バインディング・コンポーネントによって処理された送信メッセージです。

Oracle B2Bコンソールにはすべてのエラーが表示されますが、Oracle Enterprise Manager Fusion Middleware Controlには一部のフォルトのみが表示されます。このサブセットには、Oracle B2Bでの取引パートナ識別後に発生したエラーを含む、すべてのインバウンド・メッセージが含まれています。

詳細は、第4章「SOAインフラストラクチャの監視」と第37章「サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントの監視」を参照してください。

33.5 Oracle B2Bコンポジットの「フローのトレース」ページからのOracle B2Bレポートへのアクセス

Oracle B2Bコンポジットの「フローのトレース」ページには、Oracle B2Bのフォルトとトレースが表示されます。インスタンスをクリックするとOracle B2Bコンソールが開き、レポートが表示されます。

34 Oracle Healthcareの監視

この章では、healthcare integrationコンポーネントおよびアプリケーションのユーザー・アクティビティの監査証跡を有効化および構成する方法を説明します。Oracle SOA Suite for healthcare integrationは、Oracleの共通監査フレームワークを使用して、healthcare integrationコンポーネントに対するユーザー・アクティビティをログします。

この章では、次の項目について説明します。

- 第34.1項「監査証跡の概要」

- 第34.2項「Healthcare Integration監査証跡の構成」

- 第34.3項「ユーザー監査ログの表示」

34.1 監査証跡の概要

Oracle監査フレームワークは、構成されたコンポーネントに影響を与えるイベントに関する情報を収集して格納し、これらのコンポーネントのアクティビティに関する監査ログを提供して、コンプライアンス要件のサポートを支援します。それぞれのSOA Suiteコンポーネントの監査は、監査ポリシーによって定義されます。監査ポリシーは、監査ログに取得するコンポーネントとアクティビティを定義します。必要な情報のみを取得して他の情報は無視するように監査ポリシーを構成できます。これはOracle Enterprise Managerの「監査ポリシー」ページで行います。詳細は、Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイドの監査ポリシーの管理に関する項を参照してください。

それぞれのアプリケーションとコンポーネントの監査可能なイベントのセットは、監査ポリシーによって定義され、各アプリケーションによって異なります。コンポーネントのイベント・リストを開くと、そのコンポーネントで監査可能なイベントのみがリストに表示されます。さらに、各イベントについて、成功した試行のみをログするか、失敗した試行のみをログするかを指定できます(現在Oracle SOA Suite for healthcare integrationは、成功した試行のみをログします)。

監査を構成する際は、次の監査レベルから選択できます。

- 低: このオプションでは、監査ポリシー・リストの監査可能なすべてのコンポーネントから、Oracle SOA Suite for healthcare integrationイベントのサブセットを含むイベントのサブセットが選択されます。このオプションでは、カスタム・フィルタは作成できません。

- 中: このオプションでは、監査ポリシー・リストの監査可能なすべてのコンポーネントから、すべてのOracle SOA Suite for healthcare integrationイベントを含むイベントのより大きなサブセットが選択されます。このオプションでは、カスタム・フィルタは作成できません。

- カスタム:このオプションを使用すると、監査するコンポーネント、イベントおよび条件のみを選択できます。これはOracle SOA Suite for healthcare integrationで推奨されるレベルです。Oracle Healthcareの監査を有効にするには、Oracle Enterprise Managerコンソールでこのレベルを選択する必要があります。

実行したアクションや使用したコンポーネントに関係なくアクティビティを監査するユーザーのリストも指定できます。これらのユーザーに対しては、定義した監査レベルまたはフィルタに関係なく監査が行われます。

監査ポリシーの詳細は、Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイドの監査の構成と管理に関する項を参照してください。

34.1.1 Oracle SOA Suite for Healthcare Integrationの監査オプション

監査可能なコンポーネントとイベントは、Oracle Enterprise Managerの「監査ポリシー」ページにリストされます(Weblogicドメイン→「セキュリティ」→「監査ポリシー」)。これらのオプションを表示または構成するには、「監査コンポーネント名」リストから「Oracle SOA Suite for healthcare integration」を選択し、「監査レベル」リストから「カスタム」を選択して、イベントの隣のチェック・ボックスをクリックします。

図34-1 「監査ポリシー」ページのHealthcare Integrationコンポーネント

注意:

現在はSUCCESSイベントのみが監査されます。FAILUREイベントは選択しないでください。

Oracle SOA Suite for healthcare integrationでは現在、次のコンポーネントとイベントの監査がサポートされています(リストには他のイベントも表示されますが、それらのログは現在のところ行われません)。

- ユーザー・セッション

- ユーザー・ログイン

- ユーザー・ログアウト

- エンドポイント管理

- エンドポイントの有効化

- エンドポイントの無効化

- ドキュメント管理

- メッセージの再発行

- メッセージのパージ

- ペイロードの読取り

34.1.2 監査でのフィルタ条件の使用

それぞれのイベントについて、成功条件のフィルタを定義できます。フィルタでは、イベントの属性に基づいたルールベースの式を使用します。Oracle SOA Suite for healthcare integrationのほとんどのユーザー・アクセス監査では、次の属性をフィルタ式に使用できます。

- ホストID

- ホスト・ネットワーク・アドレス

- イニシエータ

- クライアントIPアドレス

- リソース

- ドメイン名

式にはANDおよびOR演算子に加え、次と等しい、次で始まる、次を含む、次と等しくない。といった様々な比較関数を含めることができます。

34.2 Healthcare Integration監査証跡の構成

監査ポリシーは、Oracle Enterprise Managerで監査ログに含めるイベントやコンポーネント選択することで構成します。現在、Oracle B2Bコンポーネントおよびイベントは、監査証跡に含まれません。

デフォルトの構成は低および中の監査レベルの2つで、コンポーネントまたはイベントの定義済のサブセットが選択されます。これらはOracle SOA Suite for healthcare integrationではお薦めできません。なぜなら、これらは、Oracle SOA Suite for healthcare integrationのコンポーネントのみでなく、監査可能なすべてのコンポーネントに影響するからです。これらのオプションのいずれかを選択すると、無関係な監査エントリと不必要に大きな監査ログが生成される可能性があります。さらに、これら2つのオプションでは、フィルタをまったく定義できません。

次の手順は、カスタムレベルの監査ポリシー構成に適用されます。

healthcare integrationの監査を構成する手順は次のとおりです。

1. Oracle Enterprise Managerにログインします。

2. 左側のナビゲーション・パネルで、「WebLogicドメイン」を開き、ユーザー監査を有効にするドメインの名前を右クリックします。

3. 表示されたコンテキスト・メニューで、「セキュリティ」をポイントして、「監査ポリシー」を選択します。

図34-2 WebLogicドメインの「セキュリティ」コンテキスト・メニュー

4. 「監査レベル」フィールドで、「カスタム」を選択します。
「監査用に選択」列にチェック・ボックスが表示され、監査対象のhealthcare integrationコンポーネントおよびイベントを選択できます。

5. 「ユーザー・セッション」といったイベント・カテゴリをクリックし、そのカテゴリに関するイベントのリストを下部に表示します。

6. 次のいずれかを実行します。

- Oracle SOA Suite for healthcare integrationのすべてのコンポーネントとイベントの監査を有効にするには、「すべてのイベントを監査」ボタンをクリックします。

- 特定コンポーネントのすべてのイベントの監査を有効にするには、コンポーネント名の隣の「監査用に選択」列のチェック・ボックスをクリックします。
たとえば、エンドポイントに対して行われるすべてのアクションを監査するには、「 エンドポイント管理」のチェック・ボックスを選択します。

図34-3 すべてのイベントが選択された「エンドポイント管理」コンポーネント

- コンポーネントの特定イベントの監査を有効にするには、そのコンポーネントを開き、コンポーネント下のイベント名の隣の「監査の有効化」列のチェック・ボックスを選択します。

7. 成功条件のフィルタを定義するには、成功条件について「監査の有効化」を選択し、その「フィルタの編集」アイコンをクリックします。表示されたダイアログでフィルタを定義して、「OK」をクリックします。
フィルタの詳細は、第34.1.2項「監査でのフィルタ条件の使用」および「フィルタの編集」ダイアログから使用可能なオンライン・ヘルプを参照してください。この時点では、フィルタは成功条件にのみ定義できることに注意してください。

8. コンポーネントの構成に関係なく常にそのアクティビティを監査するユーザーのリストを指定するには、「常に監査するユーザー」セクションにユーザー・アカウントのリストを入力します。アカウント名はカンマで区切ります。

9. 監査の構成が完了したら、「適用」をクリックします。

10. 変更を有効にするためにサーバーを再起動します。

34.3 ユーザー監査ログの表示

イベントが監査ログの入力をトリガーすると、イベント情報が監査ログ・ファイルに書き込まれます。監査ログには次の情報が取得されます。入力をトリガーしたイベント・タイプに応じて、これらのフィールドの一部は空になる場合もあります。

- 日付と時刻

- イベントのイニシエータ

- イベント・タイプ

- イベント・ステータス

- メッセージ・テキスト(何が発生したかを示します)

- ECID

- RID

- コンテキスト・フィールド

- セッションID

- ターゲット・コンポーネント・タイプ

- アプリケーション名

- イベント・カテゴリ

- スレッドID

- 失敗コード

- リモートIPアドレス

- ターゲット

- リソース

- ロール

- 認証方式

- 理由

監査ログ・ファイルは直接表示できます。これは次の場所に書き込まれます。

fmw_home/user_projects/domains/domain_name/servers/managed_server_name/logs/auditlogs/SOA-HCFP/audit.log

第XIII部

ビジネス・イベントの管理

この部では、ビジネス・イベントの管理方法について説明します。

次の章で構成されています。

- 第35章「ビジネス・イベントの管理」

35 ビジネス・イベントの管理

この章では、ビジネス・イベントおよびイベント配信ネットワーク(EDN)の管理方法(ビジネス・イベントのサブスクライブ、サブスクライバの管理およびビジネス・イベントのフォルトのリカバリを含む)について説明します。ビジネス・イベントは、ビジネス環境での発生結果として送信されたメッセージ・データで構成されています。ビジネス・イベントが公開されると、他のサービス・コンポーネントやデータベース・エージェントは、そのイベントをサブスクライブできます。

この章では、次の項目について説明します。

- 第35.1項「イベント配信ネットワークの概要」

- 第35.2項「ビジネス・イベントのサブスクライブ」

- 第35.3項「ビジネス・イベント・サブスクライバの管理」

- 第35.4項「ビジネス・イベントのフォルトのリカバリ」

ビジネス・イベント問題のトラブルシューティングの詳細は、付録B.6「EDNのトラブルシューティング」を参照してください。

ビジネス・イベントの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の「ビジネス・イベントおよびイベント配信ネットワークの使用」を参照してください。

35.1 イベント配信ネットワークの概要

公開済のビジネス・イベントを受け入れ、サブスクライバに配信するOracle SOA Suiteのサブシステムは、EDNと呼ばれます。EDNには2種類の実装があります。

- EDN-DB
EDN-DBは、バックエンド・ストアとしてOracleデータベースを使用し、Oracle固有の機能に依存しています。

- EDN-JMS
EDN-JMSは、バックエンド・ストアとしてJMSキューを使用します。

Oracle Universal Installerによるインストール中に、正しい実装が構成されます。また、インストール後に変更することもできます。アプリケーション開発の観点では、2つの実装は同一であり、動作も同じです。

35.2 ビジネス・イベントのサブスクライブ

ビジネス・イベントは、Oracle Enterprise Manager Fusion Middleware Controlでサブスクライブできます。ビジネス・イベントは、ビジネス環境での発生結果として送信されたメッセージ・データで構成されています。ビジネス・イベントは、Oracle JDeveloperで作成し、SOAコンポジット・アプリケーションに組み込みます。このアプリケーションは、Oracle Enterprise Manager Fusion Middleware Controlにデプロイします。ビジネス・イベントをサブスクライブできるのは、サービス・コンポーネントおよびデータベース・エージェントです。Oracle Enterprise Manager Fusion Middleware Controlからサブスクライブできるのは、データベース・エージェントのみです。サービス・コンポーネントは、Oracle JDeveloperからのみサブスクライブされます。公開されたビジネス・イベントは、そのイベントをサブスクライブしているエンティティが受信します。

ビジネス・イベントをサブスクライブする手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

「ビジネス・イベント」を選択します。

「soa-infra」を右クリックして、「ビジネス・イベント」を選択します。

「イベント」ページに、次の詳細が表示されます。

- 特定のビジネス・イベントを検索するためのユーティリティ。名前の全部または一部を指定して「検索」アイコンをクリックします。詳細は、「ヘルプ」アイコンをクリックしてください。

- ビジネス・イベント。使用したネームスペース、イベント名、各イベントのサブスクリプション数、および失敗したイベント配信数が表示されます。ビジネス・イベントは、それぞれのネームスペース内に格納されています。

2. 「ネームスペースおよびイベント」セクションで、特定のビジネス・イベントを選択します。

3. 「イベント定義の表示」をクリックします。
選択したイベントのイベント定義言語(EDL)ファイルが表示されます。ビジネス・イベントは、EDLを使用して定義されます。EDLは、ビジネス・イベント定義の作成に使用するスキーマです。

この例では、OrderUpdateEvent、OrderInformationCheckEvent、ContinueOrderProcessingEventおよびStopOrderProcessingEventというビジネス・イベントがイベント定義に記載されています。

4. 「OK」をクリックしてダイアログを閉じます。

5. 「サブスクライブ」をクリックし、「ネームスペースおよびイベント」表で選択したイベントをデータベース・エージェントでサブスクライブします。

注意:

EDN-JMS実装の「イベント」ページには、データベース・エージェントが選択されたイベントをサブスクライブするための「サブスクライブ」ボタンが表示されません。

「データベース・サブスクリプションの作成」ダイアログが表示されます。リスニングするエージェントを作成して、イベントの公開時に適切なイベントをサブスクライブします。

6. 次の値を入力します。アスタリスク(*)は必須フィールドを示します。

フィールド

説明

イベント・ネームスペース

イベント・ネームスペースが表示されます。

イベント名

イベント名が表示されます。

データベース・エージェント

データベース・エージェント名を指定するか、「エージェントの作成」をクリックしてエージェントを作成します。このエージェントは、イベントの公開時に適切なイベントをリスニングしてサブスクライブします。

一貫性レベル

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

- 保証付き: イベントは、グローバル・トランザクションなしでサブスクライバに非同期で配信されます。サブスクライバは、独自のローカル・トランザクションを作成して処理できますが、そのトランザクションは、残りのイベント処理とは別にコミットされます。デフォルトでは、保証付きの配信はサブスクライバへのイベントの配信を3回試みます。この3回でイベントを配信できなかった場合、配信は失敗します。また、グローバル・トランザクションがないため、システム障害によって、イベントが複数回配信される可能性があります。サブスクライバが例外をスローすると(または失敗すると)、その例外は記録されますが、イベントは再送信されません。

- 即時: イベントは、パブリッシャと同じトランザクションとスレッドで、サブスクライバに配信されます。すべての即時サブスクライバが処理を完了するまで、パブリッシュ・コールは返されません。いずれかのサブスクライバが例外をスローすると、追加のサブスクライバは起動されず、例外はパブリッシャにスローされます。

XPathフィルタ

イベントをフィルタ処理する場合は、XPath式を指定します。サブスクリプションが配信されて式のロジックが満たされると、イベントが配信されます。ロジックが満たされない場合、イベントは配信されません。

7. 「サブスクライブ」をクリックします。

8. 「テスト」をクリックし、選択したイベントをテストします。このテストによって、サブスクライバが操作できるテスト・イベントを公開できます。
「テスト・イベント」ダイアログが表示されます。

9. テストに使用するXMLペイロードを指定します。

10. 「公開」をクリックします。

注意:

イベント・サブスクリプションに対するポリシーの実行は、このリリースではサポートされていません。ポリシーは、警告なしでビジネス・イベントをサブスクライブするサービス・コンポーネント(Oracle Mediatorなど)に対してアタッチまたはデタッチできます。ポリシーの実行は発生しないため、このアクションによるエラーはありません。

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

- 第1.2.8項「SOAコンポジット・アプリケーションのコンテンツの概要」

- ビジネス・イベントの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のビジネス・イベントおよびイベント配信ネットワークの使用に関する章を参照してください。

35.3 ビジネス・イベント・サブスクライバの管理

既存のデータベース・サブスクリプションを作成、編集および削除することもできます。ビジネス・イベントが公開されると、サービス・コンポーネントおよびデータベース・エージェントは、そのイベントをサブスクライブできます。このページを使用して、ビジネス・イベントのすべてのサブスクリプションを表示します。このページでは、データベース・エージェントによるイベント・サブスクリプションを管理することもできます。サービス・コンポーネント・サブスクリプションは、設計時にOracle JDeveloperで作成されるため、Oracle Enterprise Manager Fusion Middleware Controlでは変更できません。

注意:

- SOAコンポジット・アプリケーションにビジネス・イベント・サブスクリプションが組み込まれている状況で、別のリビジョンのコンポジットをデプロイすると、そのコンポジットの全リビジョンのイベント・サブスクリプションすべてがアクティブとなり、メッセージを受信します。最新リビジョンのコンポジットのみを使用してイベントを受信するには、以前のリビジョンのコンポジットすべてをリタイア状態にすることをお薦めします。

- リタイア状態のSOAコンポジット・アプリケーション内のBPELコンポーネントでは、BPELプロセスの非開始受信アクティビティにイベントが関連付けられていても、ビジネス・イベントを受信できません。

ビジネス・イベント・サブスクリプションを管理する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ビジネス・イベント」を選択します。

1. 「soa-infra」を右クリックします。

2. 「ビジネス・イベント」を選択します。

2. 「サブスクリプション」をクリックします。
「サブスクリプション」ページに、次の詳細が表示されます。

- 特定のサブスクリプションを検索するためのユーティリティ。基準を指定して「検索」をクリックします。詳細は、「ヘルプ」アイコンをクリックしてください。

- データベース・サブスクリプション。イベント名、使用したネームスペース、サブスクリプション・エージェント名、必要に応じて定義したXPathフィルタ、一貫性レベル、および失敗した配信数が表示されます。実行時には、このページのビジネス・イベントに対してデータベース・サブスクリプションを作成します。

- コンポーネント・サブスクリプション。イベント名、使用したネームスペース、イベントをサブスクライブするサービス・コンポーネント、SOAコンポジット・アプリケーション、必要に応じて定義したXPathフィルタおよび一貫性レベルが表示されます。

注意:

EDN - JMSを実装するビジネス・イベントの場合、「データベース・エージェントの作成」アイコン、「データベース・エージェントの編集」アイコン、「データベース・エージェントの削除」アイコンおよび「データベース・エージェントの管理」ボタンは表示されません。

3. 「データベース・サブスクリプション」タイトルの下にある適切なアイコンをクリックし、データベース・サブスクリプションを作成、編集または削除します。

4. 「データベース・エージェントの管理」をクリックし、PL/SQLプロシージャを編集するか、現在イベントをサブスクライブしていないエージェントを削除します。

5. 「サブスクリプション」のコンポーネント」列で、サービス・コンポーネントをクリックし、そのホーム・ページにアクセスします。

6. 「コンポジット」列で、SOAコンポジット・アプリケーションをクリックし、そのホーム・ページにアクセスします。

ビジネス・イベントの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の「ビジネス・イベントおよびイベント配信ネットワークの使用」を参照してください。

35.4 ビジネス・イベントのフォルトのリカバリ

リカバリ可能と識別されているビジネス・イベントのフォルトをリカバリできます。

ビジネス・イベントのフォルトをリカバリする手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ビジネス・イベント」を選択します。

1. 「soa-infra」を右クリックします。

2. 「ビジネス・イベント」を選択します。

2. 「フォルト」をクリックします。
「フォルト」ページに、次の詳細が表示されます。

- 特定のビジネス・イベントのフォルトを検索するためのユーティリティ。基準を指定して「検索」をクリックします。

- ビジネス・イベントで発生しているフォルト。エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、イベント・ネームスペース、イベント名、サブスクライバ、およびサブスクリプション・タイプ(データベースまたはコンポーネント)が表示されます。「リカバリ可能ですか。」列では、リカバリ・アクションを実行できるフォルトが識別されます。

3. 「ビュー」リストから、「列」→「フォルトID」の順に選択し、各エラー・メッセージのフォルトIDを表示します。

4. リカバリ可能として識別された特定のフォルトをクリックし、次のいずれかのオプションを選択します。

アクション

説明

再試行

フォルトが発生したインスタンスを再試行します。

注意: ビジネス・イベントのフォルトがリカバリを待機している場合は、SOAコンポジット・アプリケーション・インスタンス全体がフォルトを伴って終了したと表示されます。

中断

フォルトが発生したインスタンス全体を終了します。

5. 「ログ」列で、特定のログをクリックし、「ログ・メッセージ」ページにアクセスします。このページには、そのインスタンスに固有のメッセージがフィルタされて表示されます。

ビジネス・イベントの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の「ビジネス・イベントおよびイベント配信ネットワークの使用」を参照してください。

第XIV部

バインディング・コンポーネントの管理

この部では、バインディング・コンポーネントの管理方法について説明します。

次の章で構成されています。

- 第36章「サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントの構成」

- 第37章「サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントの監視」

- 第38章「サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントの管理」

36 サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントの構成

この章では、SOAコンポジット・アプリケーションのWebサービス、JCAアダプタ・サービスおよび参照バインディング・コンポーネントのランタイム・プロパティの構成方法、およびOracle Service Registryと統合している場合のエンドポイント参照とサービス・キーの変更方法について説明します。バインディング・コンポーネントは、SOAプラットフォームを外部の世界と接続するネットワーク・プロトコルとサービスです。

この章では、次の項目について説明します。

- 第36.1項「サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントのプロパティの構成」

バインディング・コンポーネントの詳細は、次のドキュメントを参照してください。

- 第1.2.5項「バインディング・コンポーネントの概要」

- 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』

注意:

- リモートRMI呼出しを介してSOAコンポジット・アプリケーションを呼び出す直接バインディング・コンポーネントのメッセージ・ヘッダー・プロパティは構成できません。このため、直接バインディング・コンポーネントの場合、「プロパティ」タブは表示されません。

- HTTPバインディング・コンポーネントの「httpBinding」プロパティは変更できません。

- WebサービスへのMTOMアタッチメントの追加がサポートされています。詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

36.1 サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントのプロパティの構成

デプロイ済SOAコンポジット・アプリケーションに組み込まれているサービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントに対してメッセージ・ヘッダー・プロパティを構成できます。

サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントのプロパティを構成する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

SOAコンポジットのメニューから...

1. 「サービスと参照」を選択します。

2. 特定のサービスまたは参照を選択します。

3. 「プロパティ」タブをクリックします。

1. 「soa-infra」を右クリックします。

2. 「サービスと参照」を選択します。

3. 特定のサービスまたは参照を選択します。

4. 「プロパティ」タブをクリックします。

1. 「サービス/参照プロパティ」を選択します。

2. 特定のサービスまたは参照を選択します。

3. 「プロパティ」タブをクリックします。

Webサービスについて次のバインディング・コンポーネント・プロパティが表示されます。

ファイル・アダプタについて次のバインディング・コンポーネント・プロパティが表示されます。JCAアダプタの選択に従って、異なる構成プロパティが表示されます。

2. バインディング・コンポーネントの選択に基づいてプロパティを変更します。使用可能なプロパティの詳細は、第36.1.1項「Webサービスに対するプロパティの構成」および第36.1.2項「Oracle JCAアダプタに対するプロパティの構成」を参照してください。

注意:

このページでアダプタ・ヘッダー・プロパティとその値を参照するには、「SOAインフラストラクチャの共通プロパティ」ページで、「監査レベル」プロパティの値を「本番」(デフォルト)から「開発」に変更する必要があります。このプロパティが「本番」に設定されている場合、プロパティとその値は表示されません。詳細は、第3.1項「SOAインフラストラクチャ・プロパティの構成」を参照してください。

36.1.1 Webサービスに対するプロパティの構成

表36-1に、Webサービス・バインディング・コンポーネントに使用可能なプロパティを示します。

表36-1 Webサービスのプロパティ

サービス、参照またはエンドポイント

プロパティ名

説明

サービス

RESTの有効化

メッセージをRepresentational State Transfer (REST)形式で受け入れるWebサービス・ポートを有効または無効にします。

サービス

WSDL対応

WebサービスのWSDLを有効または無効にします。

サービス

メタデータ交換の有効化

Webサービスのメタデータ交換を有効または無効にします。

サービス

エンドポイント・テストの有効化

Webサービスのエンドポイント・テストを有効または無効にします。

サービス

ロギング・レベル

Webサービスで実行するロギング・レベルを選択します。

サービス

スキーマ検証

スキーマ検証を有効化または無効化します。

サービス

アトミック・トランザクションのバージョン

WS-AtomicTransaction (WS-AT)がサポートされているバージョン(1.0、1.1、1.2またはデフォルト)を選択します。

サービス

アトミック・トランザクションのフロー・オプション

トランザクションの参加を示す値を選択します。

- 行わない
トランザクション・コンテキストは、インポート(サービスの場合)またはエクスポート(参照の場合)されません。

- サポート
トランザクションが存在する場合は、トランザクション・コンテキストがインポート(サービスの場合)またはエクスポート(参照の場合)されます。この情報はcomposite.xmlファイルに追加されます。

- 必須
トランザクション・コンテキストはインポート(サービスの場合)またはエクスポート(参照の場合)されます。エクスポートの場合、アクティブなトランザクションが存在しない場合はWebサービス例外メッセージがスローされます。インポートの場合、リクエストにトランザクション・コンテキストが存在しない場合はフォルトがクライアントに戻されます。

詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のWS-AtomicTransactionのサポートに関する項を参照してください。

サービス

最大リクエスト・サイズ

Webサービスの最大リクエスト・サイズを入力します。-1の値は、サイズが無制限であることを意味します。

サービス

最大リクエスト・サイズの単位

Webサービスのリクエスト単位(バイト、KB、MBまたはGB)を選択します。

36.1.2 Oracle JCAアダプタに対するプロパティの構成

未登録のJCAバインディング・レベル・プロパティをcomposite.xmlファイルに手動で追加した後、Oracle Enterprise Manager Fusion Middleware Controlでは、そのプロパティや該当するサービスや参照について登録された他のプロパティを編集できなくなります。表36-2はJCAアダプタのプロパティ・タイプを示しています。

表36-2 JCAアダプタのタイプ

プロパティ・タイプ

説明

制限事項

アクティブ化仕様および相互作用仕様

SOAコンポジット・アプリケーション内で、アクティブ化仕様プロパティはサービスとして機能し、相互作用仕様プロパティは参照として機能します。

これらのプロパティは追加したり削除しないでください。値の変更のみが可能です。

これらのプロパティには、リサイクル対象のアダプタ・エンドポイントが必要です。これらのプロパティ・タイプは、他のプロパティにも依存しています。これらのいずれかのプロパティを追加する場合、他にも追加する必要がある従属プロパティを把握する方法はありません。

エンドポイント

これらのエンドポイントは、チューニングに関連するプロパティ(タイムアウト、しきい値、最大間隔などを指定する)で、アクティブ化仕様プロパティまたは相互作用仕様プロパティでは表示されません。

エンドポイント・プロパティの追加、削除または変更には制限がありません。プロパティが追加、削除または変更されるとアダプタに通知が送信されますが、アダプタによる再デプロイメントは不要です。

jca.retry.*エンドポイント・プロパティは、コンポジットを再デプロイしないと追加または削除できません。ただし、これらのプロパティは、Oracle Enterprise Manager Fusion Middleware Controlを使用することで、コンポジットの再デプロイなしに変更できます。

この項の内容は、次のとおりです。

- 第36.1.2.1項「Oracle AQアダプタ」

- 第36.1.2.2項「Oracleデータベース・アダプタ」

- 第36.1.2.3項「Oracleファイル・アダプタ」

- 第36.1.2.4項「Oracle FTPアダプタ」

- 第36.1.2.5項「Oracle JMSアダプタ」

- 第36.1.2.6項「Oracle MQ Seriesアダプタ」

- 第36.1.2.7項「Oracleソケット・アダプタ」

- 第36.1.2.8項「Oracle JCAアダプタのエンドポイント・プロパティ」

36.1.2.1 Oracle AQアダプタ

表36-3に、Oracle AQアダプタに使用可能なプロパティを示します。

表36-3 Oracle AQアダプタのプロパティ

サービス、参照またはエンドポイント

プロパティ名

説明

サービス

DequeueTimeOut

デキュー・タイムアウト間隔を指定します。

サービス

ConnectionRetryDelay

接続再試行間隔を指定します。

サービス

adapter.aq.dequeue.threads

デキュー・スレッド数を指定します。

サービス

jca.retry.count

メッセージの転送再試行回数を指定します。

サービス

jca.retry.interval

メッセージを再試行する時間間隔を指定します。

サービス

QueueName

AQキュー名を指定します。

サービス

DatabaseSchema

キューをホストするデータベース・スキーマ名を指定します。

サービス

SchemaValidation

メッセージ・ペイロードを検証します。

サービス

ObjectFieldName

ペイロードとして使用するADTエントリを指定します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

サービス

PayloadHeaderRequired

ペイロード以外の抽象データ型(ADT)エントリがアクセス可能かどうかを指定します。

サービス

DequeueCondition

メッセージをデキューする式を指定します。

サービス

Consumer

キューのコンシューマを指定します。

サービス

MessageSelectorRule

メッセージをデキューするメッセージ・セレクタを指定します。

サービス

StreamPayload

ペイロードをストリームするかどうかを指定します。

サービス

Correlation

デキュー操作に対して相関基準または検索基準を指定します。エンキュー操作の場合は、この値がAQに送信されるメッセージの相関になります。

参照

Username

セキュアな環境またはプログラム(OracleデータベースやOracle Applicationsシステムなど)へのアクセスをリクエストするユーザー名を識別します。

参照

Responsibility

Oracle E-Business Suite内の関数の集合を指定します。各ユーザーには、適切な関数およびデータへのアクセスを許可する1つ以上の職責が割り当てられます。

参照

QueueName

AQキュー名を示します。

参照

DatabaseSchema

キューをホスト管理するデータベース・スキーマ名を示します。

参照

ObjectFieldName

ペイロードとして使用するADTエントリを指定します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

参照

PayloadHeaderRequired

ペイロード以外のADTエントリがアクセス可能かどうかを指定します。

参照

RecipientList

メッセージの受信者を指定します。

参照

Correlation

デキュー操作に対して相関基準または検索基準を指定します。エンキュー操作の場合は、この値がAQに送信されるメッセージの相関になります。

36.1.2.2 Oracleデータベース・アダプタ

表36-4に、Oracleデータベース・アダプタに使用可能なプロパティを示します。

表36-4 Oracleデータベース・アダプタのプロパティ

サービス、参照またはエンドポイント

プロパティ名

説明

サービス

DescriptorName

ルート・リレーショナル表を示すTopLinkメタデータへのキーを示します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

サービス

QueryName

事前定義のWHERE句およびプロパティが指定されている実行対象の名前付き問合せを示すTopLinkメタデータへのキーを示します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

サービス

MappingsMetaDataURL

MappingsMetaDataURLに関連して、特定の事前定義XMLスキーマへのデータベース・スキーマのマップ方法が記述されているTopLinkメタデータ・ファイルへのパスを示します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

サービス

OXMappingsMetaDataURL

MappingsMetaDataURLに関連して、特定の事前定義XMLスキーマへのデータベース・スキーマのマップ方法が記述されているTopLinkメタデータ・ファイルへのパスを示します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

サービス

PollingInterval

データベースに新しいイベントを問い合せる間隔(秒数)を示します。

サービス

MaxRaiseSize

Oracle BPEL Process Managerまたはアクティブ化リスナーに対して同時に起動できるXMLレコードの最大数を示します。

サービス

PollingStrategy

データベースからイベントを起動する方法を示します。AfterReadStrategyとも呼ばれます。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

サービス

MarkReadColumn

処理された行を示すために、LogicalDeletePollingStrategyで使用されるステータス列を示します。

サービス

MarkUnreadValue

未処理の行のステータスを示します。

サービス

MarkReservedValue

このポーリング・インスタンスによって予約されている行のステータスを示します。

サービス

MarkReadValue

処理済の行のステータスを示します。

サービス

SequencingTableName

例: DB_ADAPTER_SEQUENCING。

サービス

SequencingTableKeyColumn

例: TABLE_NAME。この列には、様々な順序の主キーが格納されます。

サービス

SequencingTableValueColumn

例: LAST_READ_ID。この列には、最後に処理された順序値が格納されます。

サービス

SequencingColumn

これは、ポーリングした表の上で単調に増加する列です。例: SCOTT.EMP.EMP_ID。

サービス

SequencingColumnType

使用する順序カウンタのタイプです。例: java.math.BigDecimal、java.sql.Timestamp。

サービス

SequencingTableKey

例: SCOTT.EMP。これは、順序ヘルパー表への主キーで、通常はポーリングの対象となる表の名前です。

サービス

ShouldCacheSequenceValue

SequencingPollingStrategyの場合、lastReadIdはメモリー内に保持できるため、ポーリング間隔が開始するたびに読み取る必要がないことを示します。

サービス

ShouldWriteSequenceValue

SequencingPollingStrategyの場合、lastReadIdはメモリー内に保持でき、プロセスまたはアプリケーション・サーバー(あるいはその両方)の停止時にのみディスクまたはデータベースに書き出すことができることを示します。

サービス

DeleteDetailRows

削除ポーリング戦略について、XMLレコードの読取り後に、詳細行とマスター行を削除するかどうかを示します。

サービス

SequencingDataSourceName

ExternalSequencingPollingStrategy用のプロパティです。

サービス

SequencingIsXADataSource

ExternalSequencingPollingStrategy用のプロパティです。

サービス

UseBatchDestroy

複数の処理済の行を単一のデータ操作言語(DML)文で削除または更新します。

サービス

DelayCommit

(複数のmaxTransactionSize単位にわたって)取得したすべての行が処理されるまで、コミット/破棄操作を遅延するかどうかを示します。

サービス

PollForChildUpdates

詳細行に対する更新を、処理用に取得しているマスター行とそのすべての詳細に反映するかどうかを示します。

サービス

ShouldOrderRows

SequencingPollingStrategyの場合は、行を順序値で順序付けない場合があります。

サービス

NumberOfThreads

データベース・アダプタが使用するトランザクション・スレッドの数を示します。

サービス

FetchSize

JDBCレベルのカーソル・フェッチ・サイズを示します。

サービス

MaxBatchWritingSize

バッチ文ごとのJDBCレベルの文を示します。

サービス

DeleteFromCursor

結果セットに対する反復の際のJDBC削除レベルを示します。

サービス

UseDirectSQL

特定状況におけるパフォーマンスの最適化を有効にします。

サービス

ReturnSingleResultSet

多数ではなく単一のSQL SELECT文で複数の結合表から読み取り、単一の大きな結果セットを返します。

サービス

MaxTransactionSize

1つのデータベース・トランザクションの一部として起動する行の最大数を示します。

サービス

SequencingFileName

FileSequencingPollingStrategy専用のプロパティです。ファイルには、単一値、最終読取りシーケンス値/更新時刻が格納されます。タイムスタンプはISO形式で表示されます。

サービス

SchemaValidation

XMLの起動前に、XMLスキーマと照合してXMLを検証します。検証は、自動生成されたファイルを手動で編集した(つまり、制限を追加した)場合にのみ実行されます。無効なレコードは拒否されます。

サービス

EnableStreaming

LOBおよび複数レコードのXMLファイルをSimple API for XML (SAX)イベントを介してストリームできるようにし、メモリー内には、ペイロードのわずかな部分のみを同時に保持できるようにします。

参照

DescriptorName

ルート・リレーショナル表を示すTopLinkメタデータへのキーを示します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

参照

OutputCompletedXml

この相互作用実行に、主キーが設定された入力メッセージである出力メッセージが含まれているかどうかを示します。

参照

MappingsMetaDataURL

XMLスキーマへのデータベース・スキーマのマップ方法が記述されているtoplink.xmlファイルへのパスを示します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

参照

OXMappingsMetaDataURL

MappingsMetaDataURLに関連して、特定の事前定義XMLスキーマへのデータベース・スキーマのマップ方法が記述されているTopLinkメタデータ・ファイルへのパスを示します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

参照

GetActiveUnitOfWork

同じJTAトランザクション内の操作では、同じTopLinkセッションと接続が使用され、JTAコミット時には、同時に書込み操作が発生します。

参照

DmlType

DMLの操作タイプ(MERGE、INSERT、UPDATE、DELETEまたはWRITE)を示します。

参照

OutputCompletedXml

この相互作用実行に、主キーが設定された入力メッセージである出力メッセージが含まれているかどうかを示します。INSERTに対して主キーを割り当てる場合に便利です。

参照

OptimizeMerge

いくつかのプロパティを設定して、マージのパフォーマンスを向上させます。たとえば、複数のオブジェクトをマージする場合に、存在をチェックするための読取り問合せと、データベース・バージョンをメモリーにロードする読取り問合せを使用します。比較は、主キーに対してin()句を使用して、単一の問合せで実行されます。

参照

DetectOmissions

入力XMLでNULLと「省略」を区別するかどうかを示します。<director />(省略)と<director xsi:nil=\"true\"/>(NULL)の違いです。

参照

MaxBatchWritingSize

バッチ文ごとのJDBCレベルの文を示します。

参照

UseDirectSQL

特定状況におけるパフォーマンスの最適化を有効にします。

参照

QueryName

事前定義のWHERE句およびプロパティが指定されている実行対象の名前付き問合せを示すTopLinkメタデータへのキーを示します。

参照

IsQueryByExample

問合せは、入力XMLレコード例との照合に基づいて各起動時に動的に生成されます。

参照

ReturnSingleResultSet

これは、関連する複数の表(つまり、マスター/詳細)を問い合せる際に、TopLinkが使用するselect文の合計数に影響を与える拡張機能です。デフォルト(各表に1つ)が最も安全な設定です。trueに設定すると、関連するすべての選択を外部結合して単一の結果セットを作成することによって、1つの合計文にすることが試行されます。

参照

CursorWindowSize

単一の問合せで非常に多数の行数を選択した際に、一度に返すレコード数を示します。

参照

EnableStreaming

LOBおよび複数レコードのXMLをSAXイベントを介してストリームできるようにし、メモリー内には、ペイロードのわずかな部分のみを同時に保持できるようにします。

参照

SqlString

Pure SQL相互作用で実行するSQLを示します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

参照

IsTransactional

実行しているPure SQLが、トランザクション境界内で発生する必要がある書込み文かどうかを示します。

参照

QueryTimeout

JDBCレベルのqueryTimeout設定を示します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

参照

MaxRows

JDBCレベルのmaxRows設定を示します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

参照

SchemaName

実行するストアド・プロシージャのスキーマを示します。

参照

PackageName

実行するストアド・プロシージャのパッケージを示します。

参照

ProcedureName

実行するストアド・プロシージャのプロシージャを示します。

参照

Overload

予定プロパティ数によって、(オーバーロードの場合に)実行するストアド・プロシージャを詳細に識別します。

参照

QueryTimeout

JDBCレベルのqueryTimeout設定を示します。

36.1.2.3 Oracleファイル・アダプタ

表36-5に、Oracleファイル・アダプタに使用可能なプロパティを示します。

表36-5 Oracleファイル・アダプタのプロパティ

サービス、参照またはエンドポイント

プロパティ名

説明

サービス

PhysicalDirectory

ファイル/FTPアダプタの物理ディレクトリを指定します。

サービス

UseHeaders

ファイル/FTPアダプタで、メタデータ(ファイル名、ディレクトリ名、最終更新データ、ファイル・サイズ、ペイロードを除外するかどうかなど)を公開する必要がある場合は、trueに設定します。このプロパティは、通常、インバウンド・アダプタを単に通知機能として使用する大規模なペイロード・シナリオで使用されます。

サービス

Recursive

trueに設定すると、ファイル/FTPアダプタは、サブディレクトリでファイルを再帰的に処理します。

サービス

PhysicalArchiveDirectory

インバウンドのファイル/FTPアダプタが、正常に処理されたファイルをアーカイブするディレクトリを示します。

サービス

PhysicalErrorArchiveDirectory

変換エラーや公開エラーなどで正常に処理されなかったファイルを、インバウンドのファイル/FTPアダプタがアーカイブするディレクトリを示します。

サービス

DeleteFile

trueに設定すると、ファイル/FTPアダプタは、処理したファイルを削除します。

サービス

IncludeFiles

ファイル名を照合するregexパターンを示します。このパターンと一致する特定のファイル名は、ファイル/FTPアダプタによって処理されます。

サービス

ExcludeFiles

ファイル名を照合するregexパターンを示します。このパターンと一致する特定のファイル名は、ファイル/FTPアダプタによって除外され処理の対象外となります。

サービス

PollingFrequency

このプロパティは、ファイル/FTPアダプタが、インバウンド・ディレクトリ内のファイルを検索する頻度を指定します。秒単位で指定します。

サービス

MinimumAge

このプロパティは、処理のためにファイルを取得する時間間隔を指定します。たとえば、このパラメータを使用すると、処理のために大きいファイルを取得する前に、そのファイルをディレクトリに完全にコピーしておくことができます。経過時間は最終更新時のタイムスタンプで決定されます。たとえば、ファイルの書込みに3、4分かかることが判明している場合は、ポーリング可能ファイルの最短経過時間を5分に設定します。入力ディレクトリでファイルが検出されたときに、更新時間が現在の時間から5分経過していない場合、そのファイルは、書込みが実行されている可能性があるため取得されません。

サービス

PublishSize

このプロパティは、ファイルに複数のメッセージがあることを示し、同時に処理する必要があるメッセージ数を指定します。たとえば、あるファイルに11個のレコードがあり、このプロパティが2に設定されている場合、そのファイルは一度に2レコードずつ処理され、最終レコードは6回目に処理されます。

サービス

Lenient

trueに設定すると、ファイル・アダプタはインバウンド・ディレクトリに対する十分な読取り/書込み権限がない場合もそれを通知しません。デフォルトでは、falseに設定されています。

サービス

TriggerFilePhysicalDirectory

ファイル/FTPアダプタがトリガー・ファイルを検索するディレクトリ・パスを示します。

サービス

TriggerFile

インバウンドのファイル/FTPアダプタをアクティブ化するトリガー・ファイルの名前を示します。

サービス

TriggerFileStrategy

このプロパティは、ファイル/FTPアダプタがトリガー・ファイル・ディレクトリ内で指定のトリガー・ファイルを検索する際に使用する戦略を定義します。使用可能な値は、EndpointActivation、EveryTimeまたはOnceOnlyです。

サービス

MaxRaiseSize

このプロパティは、ファイル/FTPアダプタが各ポーリング・サイクルでの処理用に発行するファイルの最大数を指定します。たとえば、インバウンド・ディレクトリに1000のファイルがあるときに、このプロパティが100に設定されていて、ポーリング頻度が1分の場合、ファイル/FTPアダプタは毎分100ファイルを発行します。

サービス

DirectorySeparator

複数のディレクトリを選択した場合、生成されたJCAファイルでは、ディレクトリのセパレータとして「;」が使用されます。必要な場合は、セパレータを変更できます。変更する場合は、生成されたJCAファイルに手動でDirectorySeparator=\"<<新たに選択したセパレータ>>\"を追加します。たとえば、セパレータとしてカンマ(,)を使用する場合は、最初に物理ディレクトリ内でセパレータをカンマ(,)に変更してから、JCAファイルにDirectorySeparator=\",\"を追加します。

サービス

AsAttachment

trueに設定されている場合、インバウンド・ファイルは添付としてパブリッシュされます。

サービス

CharacterSet

このプロパティ値は、添付の文字セットに設定します。このプロパティは、ファイル/FTPアダプタの内部では使用されず、ファイル/FTPアダプタが公開した添付を処理するサード・パーティ・アプリケーションで使用されます。

サービス

Encoding

このプロパティ値は、添付のエンコーディングに設定します。このプロパティは、ファイル/FTPアダプタの内部では使用されず、ファイル/FTPアダプタが公開した添付を処理するサード・パーティ・アプリケーションで使用されます。

サービス

ContentType

このプロパティ値は、添付のMime-Typeに設定します。このプロパティは、ファイル/FTPアダプタの内部では使用されず、ファイル/FTPアダプタが公開した添付を処理するサード・パーティ・アプリケーションで使用されます。

サービス

ListSorter

ファイル/FTPアダプタがインバウンド方向のファイルのソートに使用するソーターを指定します。このプロパティは次のいずれかに設定できます。

- \"oracle.tip.adapter.file.inbound.listing.TimestampSorterAscending\"

- \"oracle.tip.adapter.file.inbound.listing.TimestampSorterDescending\"

また、\"java.util.Comparator\"を実装するクラスを記述することで、独自のソーターをプラグインできます。

サービス

SingleThreadModel

値がtrueの場合、ファイル/FTPアダプタ・ポーラーは、同じスレッドでファイルを処理し、グローバル・メモリー内キューは使用しません。

サービス

ThreadCount

このプロパティが使用可能な場合、アダプタはグローバル・スレッド・プールのプロセッサ・スレッドに依存せずに、独自のプロセッサ・スレッドを作成します(デフォルトでは4個)。このプロパティはメモリー内キューを分割し、それぞれのコンポジット・アプリケーションが独自のメモリー内キューを取得します。ThreadCountを0に設定すると、スレッド動作はシングル・スレッド・モデルと同じになります。ThreadCountを-1に設定すると、グローバル・スレッド・プールを使用してスレッドが開始されます。このプロパティの最大値は40です。

サービス

recoveryInterval

エラー発生時にインバウンド・アダプタがリカバリ間隔を構成するために使用します。たとえば、物理ディレクトリが存在しない場合、アダプタはこの値を使用して定期的なスリープ/ウェイクアップ・アクションを実行し、物理ディレクトリが作成されていてアクセス可能であるかどうかをチェックします。

参照

PhysicalDirectory

ファイル/FTPアダプタの物理ディレクトリを指定します。

参照

NumberMessages

使用するアウトバウンド・ファイル命名規則を指定します。

参照

ElapsedTime

このプロパティは、アウトバウンドのバッチ処理に使用されます。指定された時間が経過すると、送信ファイルが作成されます。プロパティ・タイプはStringで必須ではありません。デフォルト値は1です。

参照

FileSize

不透明(Opaque)スキーマが使用されているかどうかを示します。

参照

FileNamingConvention

このプロパティは、アウトバウンドのWrite操作ファイルの命名規則に使用されます。

参照

FileName

このプロパティを使用して、書込み操作中に静的な単一ファイル名を指定します。

参照

Append

このプロパティを\"true\"に設定すると、ファイル/FTPアダプタはアウトバウンド方向のファイルに追加されます。ファイルが存在しない場合は、新規ファイルが作成されます。

参照

UseStaging

trueの場合、アウトバウンドのファイル/FTPアダプタは、変換済のデータをステージング・ファイルに書き込んだ後、そのステージング・ファイルをターゲット・ファイルにストリームします。falseの場合、アウトバウンドのファイル/FTPアダプタは、中間ステージング・ファイルを使用しません。

参照

ConcurrentThreshold

特定のアウトバウンド・シナリオで同時に実行可能な変換アクティビティの最大数を示します。アウトバウンド操作中の変換ステップは、CPUの負荷が高くなり、他のアプリケーションやスレッドが停止する可能性があるため、ガードする必要があります。最大値は100 (BPELプロセスのdspMaxThreadsの最大値と同じ)です。

参照

SequenceName

アウトバウンドのファイル/FTPアダプタを高可用性に対応して構成している場合に使用するOracleデータベースの順序名を指定します。

参照

oracle.tip.adapter.file.mutex

このプロパティ値は、アウトバウンド書込み操作に使用するmutexを指定するクラス名に設定します。このクラスは、oracle.tip.adapter.file.Mutex抽象化を拡張する必要があります。

参照

serializeTranslation

trueに設定すると、変換ステップはセマフォを使用してシリアライズされます。セマフォ(変換ステップをガード)の許可数は、ConcurrentThresholdプロパティから導出されます。falseの場合、変換ステップはセマフォ外で発生します。

参照

inMemoryTranslation

このプロパティはUseStagingが\"false\"の場合のみ適用されます。trueに設定すると、変換ステップはメモリー内で発生します。つまり、メモリー内バイト配列が作成されます。falseに設定すると、アダプタはターゲット・ファイル(FTP、FTPS、SFTPを含む)への出力ストリームを作成し、トランスレータにそのストリームの変換や直接書込みを許可します。

参照

DeleteFile

trueに設定すると、ファイル/FTPアダプタは、処理したファイルを削除します。

参照

IgnoreZeroByteFile

ファイルが見つからない場合、アウトバウンド読取り操作中にファイル/FTPアダプタで例外をスローしないようにするには、trueに設定します。インバウンド・ファイルのスキーマがopaque以外の場合、このプロパティは無視されます。

参照

IncludeFiles

ファイル名を照合するregexパターンを示します。このパターンと一致する特定のファイル名は、ファイル/FTPアダプタによって処理されます。

参照

ExcludeFiles

ファイル名を照合するregexパターンを示します。このパターンと一致する特定のファイル名は、ファイル/FTPアダプタによって除外され処理の対象外となります。

参照

Recursive

trueに設定すると、ファイル/FTPアダプタは、サブディレクトリでファイルを再帰的に処理します。

参照

MaxRaiseSize

このプロパティは、ファイル/FTPアダプタが各ポーリング・サイクルでの処理用に発行するファイルの最大数を指定します。たとえば、インバウンド・ディレクトリに1000のファイルがあるときに、このプロパティが100に設定されていて、ポーリング頻度が1分の場合、ファイル/FTPアダプタは毎分100ファイルを発行します。

参照

DirectorySeparator

複数のディレクトリを選択した場合、生成されたJCAファイルでは、ディレクトリのセパレータとして「;」が使用されます。必要な場合は、セパレータを変更できます。その場合は、生成されたJCAファイルに手動でDirectorySeparator=\"<<新たに選択したセパレータ>>\"を追加します。たとえば、セパレータとしてカンマ(,)を使用する場合は、最初に物理ディレクトリ内でセパレータをカンマ(,)に変更してから、JCAファイルにDirectorySeparator=\",\"を追加します。

参照

SourceFileName

ファイルI/O操作用のソース・ファイルを示します。

参照

SourcePhysicalDirectory

ファイルI/O操作用のソース・ディレクトリを示します。

参照

SourceType

ソース・ファイルがネイティブの場合はnativeに、XMLの場合はxmlに設定します。

参照

SourceSchema

このプロパティ値は、ソース・ファイルのスキーマに設定します。

参照

SourceSchemaRoot

このプロパティ値は、ソース・ファイルのルート要素名に設定します。

参照

TargetFileName

ファイルI/O操作用のターゲット・ファイルを示します。

参照

TargetPhysicalDirectory

ファイルI/O操作用のターゲット・ディレクトリを示します。

参照

TargetType

ターゲット・ファイルがネイティブの場合はnativeに、XMLの場合はxmlに設定します。

参照

TargetSchema

このプロパティ値は、ターゲット・ファイルのスキーマに設定します。

参照

TargetSchemaRoot

このプロパティ値は、ターゲット・ファイルのルート要素名に設定します。

参照

Xsl

このプロパティ値は、ソースとターゲット間のXSLトランスフォーマに設定します。

参照

Type

COPY、MOVEまたはDELETEに設定します。

参照

BatchSize

このプロパティ値は、バッチ・トランスフォーメーションのバッチ・サイズに設定します。

参照

ChunkSize

アウトバウンド・メッセージ数を指定します。

36.1.2.4 Oracle FTPアダプタ

表36-6に、Oracle FTPアダプタに使用可能なプロパティを示します。

表36-6 Oracle FTPアダプタのプロパティ

サービス、参照またはエンドポイント

プロパティ名

説明

サービス

timestampOffset

このプロパティは、タイムゾーンの問題を処理するためにFTPアダプタによって使用されます。通常は、FTPアダプタが実行されているシステムとFTPサーバーとの時間差をミリ秒に変換するために使用されます。

サービス

PhysicalDirectory

このプロパティは、ファイル/FTPアダプタの物理ディレクトリを指定します。

サービス

UseHeaders

ファイル/FTPアダプタで、メタデータ(ファイル名、ディレクトリ名、最終更新データ、ファイル・サイズ、ペイロードを除外するかどうかなど)を公開する必要がある場合は、\"true\"に設定します。このプロパティは、通常、インバウンド・アダプタを単に通知機能として使用する大規模なペイロード・シナリオで使用されます。

サービス

FileType

このプロパティ値は、要件に従ってasciiまたはbinaryに設定します。

サービス

Recursive

trueに設定すると、ファイル/FTPアダプタは、サブディレクトリでファイルを再帰的に処理します。

サービス

PhysicalArchiveDirectory

インバウンドのファイル/FTPアダプタが、正常に処理されたファイルをアーカイブするディレクトリを示します。

サービス

PhysicalErrorArchiveDirectory

変換エラーや公開時のエラーなどで正常に処理されなかったファイルを、インバウンドのファイル/FTPアダプタがアーカイブするディレクトリを示します。

サービス

UseRemoteArchive

このプロパティを\"true\"に設定すると、アーカイブ・ディレクトリは同じFTPサーバー上にあることがFTPアダプタに通知されます。\"false\"に設定すると、FTPアダプタはアーカイブにローカル・ファイル・システム・フォルダを使用します。

サービス

UseNlst

FTPアダプタでデフォルトの\"LIST\"コマンドのかわりに\"NLST\" FTPコマンドを使用する場合、このプロパティを\"true\"に設定します。

サービス

DeleteFile

trueに設定すると、ファイル/FTPアダプタは、処理したファイルを削除します。

サービス

IncludeFiles

ファイル名を照合するregexパターンを示します。このパターンと一致する特定のファイル名は、ファイル/FTPアダプタによって処理されます。

サービス

ExcludeFiles

ファイル名を照合するregexパターンを示します。このパターンと一致する特定のファイル名は、ファイル/FTPアダプタによって除外され処理の対象外となります。

サービス

PollingFrequency

このプロパティは、ファイル/FTPアダプタが、インバウンド・ディレクトリ内のファイルを確認する頻度を指定します。秒単位で指定します。

サービス

MinimumAge

このプロパティは、処理のためにファイルを取得する時間間隔を指定します。たとえば、このパラメータを使用すると、処理のために大きいファイルを取得する前に、そのファイルをディレクトリに完全にコピーしておくことができます。経過時間は最終更新時のタイムスタンプで決定されます。たとえば、ファイルの書込みに3、4分かかることが判明している場合は、ポーリング可能ファイルの最短経過時間を5分に設定します。入力ディレクトリでファイルが検出されたときに、更新時間が現在の時間から5分経過していない場合、そのファイルは、書込みが実行されている可能性があるため取得されません。

サービス

PublishSize

このプロパティは、ファイルに複数のメッセージがあることを示し、同時に処理する必要があるメッセージ数を指定します。たとえば、あるファイルに11個のレコードがあり、このプロパティが2に設定されている場合、そのファイルは一度に2レコードずつ処理され、最終レコードは6回目に処理されます。

サービス

TriggerFilePhysicalDirectory

ファイル/FTPアダプタがトリガー・ファイルを検索するディレクトリ・パスを示します。

サービス

TriggerFile

インバウンドのファイル/FTPアダプタをアクティブ化するトリガー・ファイルの名前を示します。

サービス

TriggerFileStrategy

このプロパティは、ファイル/FTPアダプタがトリガー・ファイル・ディレクトリ内で指定のトリガー・ファイルを検索する際に使用する戦略を定義します。使用可能な値は、EndpointActivation、EveryTimeまたはOnceOnlyです。

サービス

MaxRaiseSize

このプロパティは、ファイル/FTPアダプタが各ポーリング・サイクルでの処理用に発行するファイルの最大数を指定します。たとえば、インバウンド・ディレクトリに1000のファイルがあるときに、このプロパティが100に設定されていて、ポーリング頻度が1分の場合、ファイル/FTPアダプタは毎分100ファイルを発行します。

サービス

DirectorySeparator

複数のディレクトリを選択した場合、生成されたJCAファイルでは、ディレクトリのセパレータとして「;」が使用されます。必要な場合は、セパレータを変更できます。その場合は、生成されたJCAファイルに手動でDirectorySeparator=\"<<新たに選択したセパレータ>>\"を追加します。たとえば、セパレータとしてカンマ(,)を使用する場合は、最初に物理ディレクトリ内でセパレータをカンマ(,)に変更してから、JCAファイルにDirectorySeparator=\",\"を追加します。

サービス

AsAttachment

trueに設定すると、インバウンド・ファイルは添付として公開されます。

サービス

CharacterSet

このプロパティ値は、添付の文字セットに設定します。このプロパティは、ファイル/FTPアダプタの内部では使用されず、ファイル/FTPアダプタが公開した添付を処理するサード・パーティ・アプリケーションで使用されます。

サービス

Encoding

このプロパティ値は、添付のエンコーディングに設定します。このプロパティは、ファイル/FTPアダプタの内部では使用されず、ファイル/FTPアダプタが公開した添付を処理するサード・パーティ・アプリケーションで使用されます。

サービス

ContentType

このプロパティ値は、添付のMime-Typeに設定します。このプロパティは、ファイル/FTPアダプタの内部では使用されず、ファイル/FTPアダプタが公開した添付を処理するサード・パーティ・アプリケーションで使用されます。

サービス

ListSorter

ファイル/FTPアダプタがインバウンド方向のファイルのソートに使用するソーターを指定します。このプロパティは次のいずれかに設定できます。

- \"oracle.tip.adapter.file.inbound.listing.TimestampSorterAscending\"

- \"oracle.tip.adapter.file.inbound.listing.TimestampSorterDescending\"

また、java.util.Comparatorを実装するクラスを記述することで、独自のソーターをプラグインできます。

サービス

SingleThreadModel

値がtrueの場合、ファイル/FTPアダプタ・ポーラーは、同じスレッドでファイルを処理し、グローバル・メモリー内キューは使用しません。

サービス

ThreadCount

このプロパティが使用可能な場合、アダプタはグローバル・スレッド・プールのプロセッサ・スレッドに依存せずに、独自のプロセッサ・スレッドを作成します(デフォルトでは4個)。つまり、このプロパティはメモリー内キューを分割し、それぞれのコンポジット・アプリケーションが独自のメモリー内キューを取得します。ThreadCountを0に設定すると、スレッド動作はSingleThreadModelと同じになります。ThreadCountを-1に設定すると、グローバル・スレッド・プールを使用してスレッドが開始されます。このプロパティの最大値は40です。

サービス

recoveryInterval

エラー発生時にインバウンド・アダプタがrecoveryIntervalを構成するために使用します。たとえば、PhysicalDirectoryが存在しない場合、アダプタはこの値を使用して定期的なスリープ/ウェイクアップ・アクションを実行し、PhysicalDirectoryが作成されていてアクセス可能であるかどうかをチェックします。

サービス

jca.message.encoding

このプロパティは、インバウンドのファイル/FTPアダプタのNXSDスキーマに指定されているエンコーディングをオーバーライドするために使用します。

サービス

oracle.tip.adapter. file.debatching. rejection.quantum

このプロパティを使用すると、インバウンドのファイル/FTPアダプタのパートナ・リンクに対する拒否メッセージのサイズを制御できます。たとえば、100に設定すると、ファイル/FTPアダプタはファイルの100行を拒否します。これは実際のファイルが大きすぎるためです。

サービス

useFileSystem

このプロパティは、クラスタ環境での読取り専用ポーリング中にインバウンドのファイル/FTPアダプタが使用します。trueに設定すると、アダプタはファイル・システムを使用して処理済のファイルのメタデータを格納します。falseに設定すると、アダプタはデータベース表を使用します。

サービス

oracle.tip.adapter. file.timeout.recover picked.minutes

FILEADAPTER_INをコーディネータとして使用している際にインバウンドの高可用性アダプタが使用します。処理用のファイルがノードによって初めて要求(エンキュー)されると、FILEADAPTER_INのFILE_PROCESSED列は0に設定されます。後で、分離されたプロセッサ・スレッドのいずれかが処理用のファイルを取得すると、FILE_PROCESSED列の値は0から1に更新されます。ファイルの処理が完了すると、FILE_PROCESSED列は1から2に更新されます。ただし、プロセッサ・スレッドはファイルを取得したが、ファイルの処理前にノードがクラッシュした場合、そのファイルは処理されません。このプロパティは、取得操作を\"undo\"するために使用します。アダプタはこの際、取得後にここに指定した時間内に処理されなかったFILEADAPTER_IN表内のエントリを削除します。

サービス

oracle.tip.adapter. file.timeout. recoverunpicked.minutes

FILEADAPTER_INをコーディネータとして使用している際にインバウンドの高可用性アダプタが使用します。処理用のファイルがノードによって初めて要求されると、FILEADAPTER_INのFILE_PROCESSED列は0に設定されます。後で、分離されたプロセッサ・スレッドが処理用のファイルを取得すると、FILE_PROCESSED列の値は0から1に更新されます。ファイルの処理が完了すると、FILE_PROCESSED列は1から2に更新されます。FILE_PROCESSEDが0である間にノードがクラッシュすると、ファイルはノードによってエンキューされます(つまり、他のノードはこのファイルを取得できません)。一方、分離されたプロセッサ・スレッドも、このファイルを処理用に取得していません。このプロパティはclaim(enqueue_操作を\"undo\"するために使用されます。アダプタはこの際、要求後に依然として取得されていないFILEADAPTER_IN表内のエントリ(たとえば、FILE_PROCESSED ==\"0\")を削除します。

サービス

purgeIntervalMillis

読取り専用ポーリング・シナリオで、ポーラー・スレッドが制御ファイルをパージする頻度を定義します。5日にデフォルト設定されます。

サービス

oracle.tip.adapter.file. highavailability. maxRetryInterval

インバウンドのファイル/FTPアダプタが、分散ポーリング・シナリオでデータベース接続の確立を再試行するまでのミリ秒数を示します。

サービス

oracle.tip.adapter.file. highavailability.maxRetry

インバウンドのファイル/FTPアダプタが、分散ポーリング・シナリオでデータベース接続の確立を再試行する回数を示します。

サービス

oracle.tip.adapter. file.rejectOriginalContent

trueに設定すると、ファイル/FTPアダプタは元の実際のコンテンツを拒否します。falseに設定すると、アダプタは、変換ステップによって作成されたXMLデータを拒否します。

サービス

notifyEachBatchFailure

trueに設定すると、ファイル/FTPアダプタは、デバッチ・シナリオでエラーが発生するたびに通知エージェントのonBatchFailureをコールします。falseに設定すると、ファイル/FTPアダプタは、デバッチ・シナリオ内のすべてのメッセージの後に、onBatchFailureを1回のみコールします。

参照

PhysicalDirectory

ファイル/FTPアダプタのディレクトリ・パスを示します。

参照

FileType

このプロパティ値は、要件に従ってasciiまたはbinaryに設定します。

参照

NumberMessages

このプロパティは、アウトバウンドのバッチ処理に使用されます。この送信ファイルは、メッセージ数の条件が満たされると作成されます。プロパティ・タイプはStringで必須ではありません。デフォルト値は1です。

参照

ElapsedTime

このプロパティは、アウトバウンドのバッチ処理に使用されます。指定された時間が経過すると、送信ファイルが作成されます。プロパティ・タイプはStringで必須ではありません。デフォルト値は1です。

参照

FileSize

このプロパティは、アウトバウンドのバッチ処理に使用されます。この送信ファイルは、ファイル・サイズの条件が満たされると作成されます。プロパティ・タイプはStringで必須ではありません。デフォルト値は1000KBです。

参照

FileNamingConvention

このプロパティは、アウトバウンドの書込み操作ファイルの命名規則に使用されます。

参照

FileName

このプロパティを使用して、書込み操作中に静的な単一ファイル名を指定します。

参照

Append

このプロパティを\"true\"に設定すると、ファイル/FTPアダプタはアウトバウンド方向のファイルに追加されます。ファイルが存在しない場合は、新規ファイルが作成されます。

参照

UseStaging

trueの場合、アウトバウンドのファイル/FTPアダプタは、変換済のデータをステージング・ファイルに書き込んだ後、そのステージング・ファイルをターゲット・ファイルにストリームします。falseの場合、アウトバウンドのファイル/FTPアダプタは、中間ステージング・ファイルを使用しません。

参照

ConcurrentThreshold

特定のアウトバウンド・シナリオで同時に実行可能な変換アクティビティの最大数を示します。アウトバウンド操作中の変換ステップは、CPUの負荷が高くなり、他のアプリケーションやスレッドが停止する可能性があるため、ガードする必要があります。最大値は100 (BPELプロセスのdspMaxThreadsの最大値と同じ)です。

参照

SequenceName

アウトバウンドのファイル/FTPアダプタを高可用性に対応して構成している場合に使用するOracleデータベースの順序名を指定します。

参照

oracle.tip.adapter.file.mutex

このプロパティ値は、アウトバウンド書込み操作に使用するmutexを指定するクラス名に設定します。このクラスは、oracle.tip.adapter.file.Mutex抽象化を拡張する必要があります。

参照

serializeTranslation

trueに設定すると、変換ステップはセマフォを使用してシリアライズされます。セマフォ(変換ステップをガード)の許可数は、ConcurrentThresholdプロパティから導出されます。falseの場合、変換ステップはセマフォ外で発生します。

参照

inMemoryTranslation

このプロパティはUseStagingが\"false\"の場合のみ適用されます。trueに設定すると、変換ステップはメモリー内で発生します。つまり、メモリー内バイト配列が作成されます。falseに設定すると、アダプタはターゲット・ファイル(FTP、FTPS、SFTPを含む)への出力ストリームを作成し、トランスレータにそのストリームの変換や直接書込みを許可します。

参照

FileType

このプロパティ値は、要件に従ってasciiまたはbinaryに設定します。

参照

UseRemoteArchive

このプロパティを\"true\"に設定すると、アーカイブ・ディレクトリは同じFTPサーバー上にあることがFTPアダプタに通知されます。\"false\"に設定すると、FTPアダプタはアーカイブにローカル・ファイル・システム・フォルダを使用します。

参照

DeleteFile

trueに設定すると、ファイル/FTPアダプタは、処理したファイルを削除します。

参照

IgnoreZeroByteFile

ファイルが見つからない場合、アウトバウンド読取り操作中にファイル/FTPアダプタで例外をスローしないようにするには、trueに設定します。インバウンド・ファイルのスキーマが\"Opaque\"以外の場合、このプロパティは無視されます。

参照

IncludeFiles

ファイル名を照合するregexパターンを示します。このパターンと一致する特定のファイル名は、ファイル/FTPアダプタによって処理されます。

参照

ExcludeFiles

ファイル名を照合するregexパターンを示します。このパターンと一致する特定のファイル名は、ファイル/FTPアダプタによって除外され処理の対象外となります。

参照

Recursive

trueに設定すると、ファイル/FTPアダプタは、サブディレクトリでファイルを再帰的に処理します。

参照

MaxRaiseSize

このプロパティは、ファイル/FTPアダプタが各ポーリング・サイクルでの処理用に発行するファイルの最大数を指定します。たとえば、インバウンド・ディレクトリに1000のファイルがあるときに、このプロパティが100に設定されていて、ポーリング頻度が1分の場合、ファイル/FTPアダプタは毎分100ファイルを発行します。

参照

DirectorySeparator

複数のディレクトリを選択した場合、生成されたJCAファイルでは、ディレクトリのセパレータとして「;」が使用されます。必要な場合は、セパレータを変更できます。その場合は、生成されたJCAファイルに手動でDirectorySeparator=\"<<新たに選択したセパレータ>>\"を追加します。たとえば、セパレータとしてカンマ(,)を使用する場合は、最初に物理ディレクトリ内でセパレータをカンマ(,)に変更してから、JCAファイルにDirectorySeparator=\",\"を追加します。

参照

UseNlst

FTPアダプタでデフォルトの\"LIST\"コマンドのかわりに\"NLST\" FTPコマンドを使用する場合、このプロパティを\"true\"に設定します。

参照

timestampOffset

このプロパティは、タイムゾーンの問題を処理するためにFTPアダプタによって使用されます。通常は、FTPアダプタが実行されているシステムとFTPサーバーとの時間差をミリ秒に変換するために使用されます。

参照

SourceFileName

ファイルI/O操作用のソース・ファイルを示します。

参照

SourcePhysicalDirectory

ファイルI/O操作用のソース・ディレクトリを示します。

参照

SourceType

ソース・ファイルがネイティブの場合はnativeに、XMLの場合はxmlに設定します。

参照

SourceSchema

このプロパティ値は、ソース・ファイルのスキーマに設定します。

参照

SourceSchemaRoot

このプロパティ値は、ソース・ファイルのルート要素名に設定します。

参照

TargetFileName

ファイルI/O操作用のターゲット・ファイルを示します。

参照

TargetPhysicalDirectory

ファイルI/O操作用のターゲット・ディレクトリを示します。

参照

TargetType

ターゲット・ファイルがネイティブの場合はnativeに、XMLの場合はxmlに設定します。

参照

TargetSchema

このプロパティ値は、ターゲット・ファイルのスキーマに設定します。

参照

TargetSchemaRoot

このプロパティ値は、ターゲット・ファイルのルート要素名に設定します。

参照

Xsl

このプロパティ値は、ソースとターゲット間のXSLトランスフォーマに設定します。

参照

Type

このプロパティ値は、要件に従ってasciiまたはbinaryに設定します。

参照

BatchSize

このプロパティ値は、バッチ・トランスフォーメーションのバッチ・サイズに設定します。

参照

SourceIsRemote

I/O操作のソースがリモートFTPサーバーではなくローカル・ファイル・システムであることをFTPアダプタに通知するには、このプロパティをfalseに設定します。

参照

TargetIsRemote

I/O操作のターゲットがリモートFTPサーバーではなくローカル・ファイル・システムであることをFTPアダプタに通知するには、このプロパティをfalseに設定します。

参照

ChunkSize

このプロパティ値は、チャンク相互作用操作のChunkSizeに設定します。

36.1.2.5 Oracle JMSアダプタ

表36-7に、Oracle JMSアダプタに使用可能なプロパティを示します。

表36-7 Oracle JMSアダプタ

サービス、参照またはエンドポイント

プロパティ名

説明

サービス

adapter.jms.encoding

JMSインバウンド・アダプタで使用するエンコーディングを設定します。

サービス

adapter.jms.receive.timeout

受信タイムアウト間隔を設定します。

サービス

adapter.jms.retry.interval

JMSアダプタが再試行に使用する間隔を設定します。

サービス

adapter.jms.registration. interval

登録の間隔を設定します。

サービス

adapter.jms.receive.threads

受信スレッド数を設定します。

サービス

JMSReplyTo DestinationProperties

返信先を設定します。

サービス

JMSReplyUse MessageIdForCorrelation

相関にメッセージIDが必要かどうかを指定します。有効な値はtrueまたはfalseです。

サービス

JMSReplyUseCorrelation IdForCorrelation

相関に相関IDが必要かどうかを指定します。有効な値はtrueまたはfalseです。

サービス

suppressHeaders

ヘッダーをバイパスするかどうかを指定します。有効な値はtrueまたはfalseです。

サービス

JMSReplyPropagateJMSExpiration

応答メッセージが、リクエスト/リプライ・シナリオのデフォルト値である0以外の存続時間(TTL)値で作成されているかどうかを指定します。有効な値はtrueまたはfalseです。

サービス

minimumDelayBetweenMessages

抑制プロパティ(ミリ秒単位)を示します。このパラメータによって、転送された各インバウンド・メッセージ間に短いスリープ期間が追加されます(したがって、メッセージ・インフローが遅くなります)。

参照

requestReply.useCorrelation

リクエスト/リプライ・シナリオに相関が必要かどうかを指定します。有効な値はtrueまたはfalseです。

参照

requestReply.cacheReceivers

リクエスト/リプライ・シナリオに相関が必要かどうかを指定します。有効な値はtrueまたはfalseです。

参照

DestinationName

物理的なJMS宛先名を示します。

参照

PayloadType

JMSメッセージのタイプを示します。

参照

DeliveryMode

JMS配信モードを設定します。JMS APIがサポートしている配信モードは、PERSISTENTおよびNON_PERSISTENTです。

参照

TimeToLive

メッセージ存続期間をミリ秒で示します。

参照

Priority

JMSメッセージの優先度を示します。

参照

PayloadEntry

ペイロードとして使用するMapMessageエントリを指定します。

参照

AttachmentList

ペイロードとして使用するMapMessageエントリを指定し、添付として公開します。

参照

RequestDestinationName

物理的なJMS宛先名を示します。

参照

ReplyDestinationName

物理的なJMS宛先名を示します。

参照

AllowTemporaryReplyDestination

メッセージ受信用の一時的な宛先の作成を許可します。

参照

DurableSubscriber

クライアント識別子内の永続サブスクリプションに関する一意の名前を示します。

参照

MessageSelector

メッセージを宛先に配信する際のメッセージ選択に使用されるメッセージ・セレクタ式を示します。

参照

ReplyTimeout

応答メッセージを受信する際のTimeoutを示します。

36.1.2.6 Oracle MQ Seriesアダプタ

表36-8に、Oracle MQ Seriesアダプタに使用可能なプロパティを示します。

注意:

MQ Seriesアダプタでは、サービス・バインディング・コンポーネント用のキュー内のメッセージの参照がサポートされません。MQ Seriesアダプタはキュー内のメッセージをポーリングし、キューからメッセージを常に破壊的に取得(読取りおよび削除)します。これは、サービス・バインディング・コンポーネント用のJCAアダプタ・ファイルで、次のようにQueueOpenOptionsプロパティをMQOO_BROWSEに設定できないことを意味します。

<property name="QueueOpenOptions" value="MQOO_BROWSE"/>

QueueOpenOptionsプロパティは、参照バインディング・コンポーネント用にサポートされています。

表36-8 Oracle MQ Seriesアダプタのプロパティ

サービス、参照またはエンドポイント

プロパティ名

説明

サービス

MessageType

アウトバウンド/デキュー・メッセージのメッセージ・タイプを示します。

サービス

QueueName

インバウンド/アウトバウンド・キューの名前を示します。

サービス

UseMessageEncodingForTranslation

変換時に文字セットのfromヘッダーが使用される場合はtrueに設定します。

サービス

InboundThreadCount

インバウンド方向で使用されるスレッド数を示します。

サービス

BackoutQueueName

拒否メッセージの移動先バックアウト・キューの名前を示します。

サービス

BackoutQueueManagerName

拒否メッセージの移動先バックアウト・キュー・マネージャの名前を示します。

サービス

MaximumBackoutCount

バックアウト・キューにメッセージを送信するまでに、アダプタが再試行する回数を示します。

サービス

BackoutInterval

バックアウト・メッセージの再試行間隔を示します。

サービス

jca.message.encoding

このエンコーディング値は、メッセージ・キューイング・メッセージ・ディスクリプタ(MQMD)またはスキーマ・ファイルに指定されているエンコーディングを上書きします。

サービス

UseMessageEncodingForTranslation

MQMDのcharacterSetフィールドがインバウンド方向で変換に使用される場合は、\"true\"に設定します。falseに設定すると、トランスレータではスキーマ・ファイルのエンコーディングが使用されます。MQMDまたはスキーマ・ファイルに指定されているエンコーディングは、jca.message.encodingプロパティを使用して上書きできます。

サービス

FallbackReplyToQueueName

Fallback返信先キュー名を示します。

サービス

FallbackReplyToQueueManagerName

Fallback返信先キュー・マネージャ名を示します。

サービス

Priority

リプライ/アウトバウンド・メッセージの優先度を示します。

サービス

Expiry

リプライ/アウトバウンド・メッセージの有効期限を示します。

サービス

Persistence

リプライ/アウトバウンド・メッセージの永続性を示します。

サービス

Feedback

リプライ/アウトバウンド・メッセージのフィードバック・コードを示します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

サービス

MessageFormat

リプライ/アウトバウンド・メッセージの書式を示します。

サービス

OnDeliveryFailure

リプライ/アウトバウンド・メッセージの配信に失敗した場合のアダプタの動作を示します。

サービス

SegmentIfRequired

メッセージのセグメンテーション・プロパティを示します。

サービス

CopyPersistenceFromInbound

同期リクエスト/レスポンス(インバウンド)シナリオで、インバウンド・メッセージから応答メッセージへのコピーの永続性を示します。

サービス

PropagateExpiryInterval

同期リクエスト/レスポンス(インバウンド)シナリオで、インバウンド・メッセージから応答メッセージへの伝播の有効期限間隔を示します。

サービス

QueueName

インバウンド/アウトバウンド・キューの名前を示します。

サービス

GetMessageOptions

アウトバウンド・デキュー・シナリオのGetメッセージ・オプションを示します。

サービス

FilterByMsgId

フィルタ処理に使用するメッセージIDを示します。

サービス

FilterByCorrelId

フィルタ処理に使用する相関IDを示します。

サービス

FilterByGroupId

フィルタ処理に使用するグループIDを示します。

サービス

FilterByMsgSeqNumber

フィルタ処理に使用するメッセージ順序番号を示します。

サービス

FilterByMsgSeqNumber

フィルタ処理に使用するメッセージ順序番号を示します。

参照

QueueName

インバウンド/アウトバウンド・キューの名前を示します。

参照

DistributionList

メッセージの移動先配信リストを示します。

参照

PartialDeliveryForDL

メッセージをDL内のすべてのキューに送る必要がある場合は、falseに設定します。それ以外の場合は、trueに設定されます。

参照

SecondaryQueueManagerName

セカンダリ・キュー・マネージャの名前を示します。

参照

MessageFormat

リプライ/アウトバウンド・メッセージの書式を示します。

参照

ReplyMessageId

設定するメッセージIDの相関スキームを示します。

参照

ReplyCorrelationId

設定する相関IDの相関スキームを示します。

参照

MessageId

アウトバウンド・メッセージの相関スキームを示します。

参照

CorrelationId

アウトバウンド・メッセージの相関スキームを示します。

参照

ReportCOA

メッセージに設定する着信確認(COA)レポートを示します。

参照

ReportCOD

メッセージに設定する配信確認(COD)レポートを示します。

参照

ReportException

メッセージに設定する例外レポートを示します。

参照

ReportExpiry

メッセージに設定する有効期限レポートを示します。

参照

ReportPAN

PANが必須かどうかを示します。

参照

ReportNAN

NANが必須かどうかを示します。

参照

FallbackReplyToQueueName

Fallback Reply Toキュー名を示します。

参照

FallbackReplyToQueueManagerName

Fallback Reply Toキュー・マネージャ名を示します。

参照

Priority

リプライ/アウトバウンド・メッセージの優先度を示します。

参照

Expiry

リプライ/アウトバウンド・メッセージの有効期限を示します。

参照

Persistence

リプライ/アウトバウンド・メッセージの永続性を示します。

参照

Feedback

リプライ/アウトバウンド・メッセージのフィードバック・コードを示します。

参照

ReplyToQueueName

メッセージに設定するReplyToQueueを示します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

参照

ReplyToQueueManagerName

メッセージに設定するReplyToQueueManagerを示します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

参照

OnDeliveryFailure

リプライ/アウトバウンド・メッセージの配信に失敗した場合のアダプタの動作を示します。

参照

SegmentIfRequired

メッセージのセグメンテーション・プロパティを示します。

参照

PartialDeliveryForDL

配信リストへの一部配信が許可されている場合はtrueに設定します。それ以外の場合は、falseに設定されます。

参照

SyncSolicitReqRes

同期リクエスト/レスポンス(アウトバウンド)シナリオの場合は、trueに設定します。それ以外の場合は、falseに設定されます。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

参照

ResponseOpaqueSchema

非同期リクエスト/レスポンス・シナリオで、リプライ/レポート・メッセージに不透明(Opaque)スキーマがある場合は、trueに設定します。

参照

ResponseWaitInterval

リプライ/レポートの着信待機時間を示します。

参照

ResponseNoMessageAllowed

指定の待機間隔が経過した後、メッセージをリプライ/レポートとして許可しない場合はtrueに設定します。

参照

ResponseGetMessageOptions

リプライ/レポートのGetメッセージ・オプションを示します。

参照

ResponseQueueOpenOptions

リプライ/レポート・キューのオープン・オプションを示します。

参照

PutMessageOptions

Putメッセージ・オプションを示します。

参照

QueueOpenOptions

キューのオープン・オプションを示します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

参照

UseMessageEncodingForTranslation

変換時にヘッダーの文字セットが使用される場合は「true」に設定します。

参照

DynamicQueueName

動的キュー名を示します。

参照

AlternateUserID

代替ユーザーIDを示します。

参照

WaitInterval

アウトバウンド・デキューの待機間隔を示します。

参照

NoMessageAllowed

指定の待機間隔が経過した後、アウトバウンド・デキュー・シナリオでメッセージを許可しない場合はtrueに設定します。

参照

UseMessageEncodingForTranslation

MQMDのcharacterSetフィールドがインバウンド方向で変換に使用される場合は、trueに設定します。falseに設定すると、トランスレータではスキーマ・ファイルのエンコーディングが使用されます。MQMDまたはスキーマ・ファイルに指定されているエンコーディングは、jca.message.encodingプロパティを使用して上書きできます。

36.1.2.7 Oracleソケット・アダプタ

表36-9に、Oracleソケット・アダプタに使用可能なプロパティを示します。

注意:

「プロパティ」タブには、TransModeやXSLTなど、表36-9に記載されていないプロパティも表示されます。ただし、表36-9に記載されていないプロパティは編集できません。編集できないプロパティを変更すると、コンポジットが無効になるためモデル変更が必要になります。

表36-9 Oracleソケット・アダプタのプロパティ

サービス、参照またはエンドポイント

プロパティ名

説明

サービス

Port

インバウンド・ソケット・アダプタがソケット接続の受信をリスニングするポートを示します。

サービス

Encoding

ネイティブ・データのキャラクタ・エンコーディングを示します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

サービス

ByteOrder

ネイティブ・データのバイト順をbigEndianまたはlittleEndianで示します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

参照

Host

アウトバウンド・ソケット・アダプタがソケット接続をオープンする先のホストを示します。

参照

Port

アウトバウンド・ソケット・アダプタが接続を試行するポートを示します。

参照

Encoding

ネイティブ・データのキャラクタ・エンコーディングを示します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

参照

ByteOrder

ネイティブ・データのバイト順をbigEndianまたはlittleEndianで示します。

このプロパティは、Oracle Enterprise Manager Fusion Middleware Controlでは編集できません。

36.1.2.8 Oracle JCAアダプタのエンドポイント・プロパティ

表36-10に、Oracle JCAアダプタに使用可能なエンドポイント・プロパティを示します。

エンドポイント・プロパティは、コンポジットを再デプロイしないと追加または変更できません。ただし、エンドポイント・プロパティは、Oracle Enterprise Manager Fusion Middleware Controlを使用することで、コンポジットの再デプロイなしに変更できます。

表36-10 Oracle JCAアダプタのエンドポイント・プロパティ

方向(インバウンド/アウトバウンド)

プロパティ名

説明

インバウンド

activationInstances

このプロパティを使用すると、インバウンドJCAリソース・アダプタのポーリング(ワーカー)スレッド数を増やすことができます。この目的は、マルチスレッドをネイティブにサポートしていないアダプタの同時実行性(スケーラビリティ)を向上させることです。Oracle Fusion Middlewareに付属しているほとんどのアダプタはマルチスレッドをネイティブにサポートしているため、この設定は、マルチスレッドをネイティブにサポートしていないサード・パーティ(カスタム)JCAアダプタに対して最も有用です。このプロパティは、特定のJCAサービス(エンドポイント)に必要なスレッドの数に対して設定します。

インバウンド

UseWorkManager

デフォルトでは、JCAアダプタは標準的なOracle Fusion Middleware Oracle WebLogic Serverワーク・マネージャを使用して(ワーカー)スレッドのポーリングを開始します。ただし、カスタム(ユーザー定義)・ワーク・マネージャを使用するために特定のJCAサービス(エンドポイント)が必要な場合は、このプロパティを使用して、そのカスタム・ワーク・マネージャの名前を指定できます。このワーク・マネージャは、このプロパティが定義されているJCAサービス(エンドポイント)を開始するためにのみ使用されます。

インバウンド

rejectUncorrelatedMessages

(参照の)コールバック・インタフェースの定義または(BPELプロセスの)中間プロセス受信を使用して、インバウンド非同期メッセージと前のアウトバウンド・メッセージの相関付けにネイティブ相関を使用する場合は、インバウンド・メッセージの相関付けが可能かどうかに関係なく、通常は、JCAフレームワークによってコンポジットへのメッセージのポストが試行されます。このプロパティをtrueに設定すると、JCAフレームワークはメッセージを拒否し、そのメッセージは相関不可になります(ネイティブ相関がアクティブな場合)。

インバウンド

jca.retry.count

拒否までの最大再試行回数を示します。

インバウンド

jca.retry.interval

再試行の時間間隔(秒単位)を示します。

インバウンド

jca.retry.backoff

再試行間隔の増分ファクタ(正の整数)を示します。

インバウンド

jca.retry.maxInterval

再試行の間隔の最大値(つまり、バックオフが1より大きい場合の上限)を示します。

アウトバウンド

jca.retry.count

再試行可能なエラー状態を起動側サービス・エンジンにスローするまでの最大再試行回数を示します。

アウトバウンド

jca.retry.interval

再試行の時間間隔(秒単位)を示します。

アウトバウンド

jca.retry.backoff

再試行間隔の増分ファクタ(正の整数)を示します。

アウトバウンド

jca.retry.maxInterval

再試行の間隔の最大値(つまり、バックオフが1より大きい場合の上限)を示します。

アウトバウンド

jca.retry.maxPeriod

再試行の合計最大期間を示します。このプロパティに指定した値を超えて、再試行が発生することはありません。

次の例は、Oracle JDeveloperのcomposite.xmlファイルにエンドポイント・プロパティを指定する方法を示しています。

- 例36-1: エンドポイント・プロパティの指定 - インバウンド

- 例36-2: エンドポイント・プロパティの指定 - アウトバウンド

例36-1: エンドポイント・プロパティの指定 - インバウンド

<service name="Inbound">
<interface.wsdl interface="http://xmlns...#wsdl.interface(Inbound_PortType)"/>
<binding.jca config="Inbound_db.jca">
<property name="jca.retry.interval">5</property>
<property name="jca.retry.interval">1</property>
<property name="jca.retry.backoff">2</property>
<property name="jca.retry.maxInterval">6</property>
</binding.jca>
</service>

例36-2のインバウンド・プロパティjca.retry.maxPeriodは、(アウトバウンド方向であるため)インバウンド方向ではサポートされません。

例36-2: エンドポイント・プロパティの指定 - アウトバウンド

<reference name="Outbound">
<interface.wsdl interface="http://xmlns...#wsdl.interface(Outbound_PortType)"/>
<binding.jca config="Outbound_jms.jca">
<property name="jca.retry.count">5</property>
<property name="jca.retry.interval">1</property>
<property name="jca.retry.backoff">2</property>
<property name="jca.retry.maxInterval">6</property>
<property name="jca.retry.maxPeriod">30</property>
</binding.jca>
</reference>

36.1.3 Oracle Service Registryと統合している場合のエンドポイント参照およびサービス・キーの変更

SOAコンポジット・アプリケーションの参照バインディング・コンポーネントがOracle Service Registry (OSR)と統合されている場合は、このページの「一般」セクションでエンドポイント参照とサービス・キーを変更できます。

実行時のエンドポイントの解決にUDDIを使用することを選択した場合は、composite.xmlファイルのbinding.ws property="oracle.soa.uddi.serviceKey"の値が「UDDI ServiceKey」フィールドに自動的に表示されます。

SOAコンポジット・アプリケーションがデプロイされた後に、次の目的のために「UDDI ServiceKey」フィールドを編集できます。

- 必要に応じて値を変更するため

- 実行時のエンドポイント解決にUDDIを使用していないコンポジットに追加するため

「エンドポイント・アドレス」フィールドは、composite.xmlファイルのws.binding endpointURIプロパティに定義されているエンドポイントの位置を表します。「エンドポイント・アドレス」フィールドは、SOAコンポジット・アプリケーションをデプロイした後は入力できませんが、具体的なWSDLでエンドポイントの位置をオーバーライドできます。

エンドポイントの位置の優先順位は、次のとおりです。

- 「UDDI ServiceKey」フィールドに、バインディングoracle.soa.uddi.serviceKeyを実行時に動的に設定します。

- 「エンドポイント・アドレス」フィールドに、バインディング・プロパティendpointURIを実行時に動的に設定します。

- composite.xmlファイル(Oracle Enterprise Manager Fusion Middleware Controlで表示および編集可能)のoracle.soa.uddi.serviceKeyのバインディング・プロパティ値を使用します。

- composite.xmlファイル(Oracle Enterprise Manager Fusion Middleware Controlで表示および編集可能)のendpointURIのバインディング・プロパティ値を使用します。

- 具体的なWSDLで指定されている位置を使用します。

図36-1は両方のフィールドを示しています。

図36-1 エンドポイント参照とサービス・キーのプロパティ

OSRと統合されている場合にエンドポイント参照およびサービス・キーを変更する手順は次のとおりです。

1. 「UDDI ServiceKey」フィールドで、実行時に使用するサービス・キーを変更します。

2. 「エンドポイント・アドレス」フィールドに、実行時に使用するエンドポイント・アドレスを入力します。

両方のフィールドを編集できます。設計時に「UDDIデプロイメント・オプション」ダイアログで選択した内容に基づいて、片方のフィールドの値が選択および使用されます。これらのフィールドへの変更は、実行時にはcomposite.xmlファイルで維持されます。

ビジネス・サービスの公開、UDDIレジストリへの接続の作成、レジストリからサービスを起動するためのSOAプロジェクトの構成などの設計時のタスクの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

実行時に照会URLを設定する方法の詳細は、第3.1項「SOAインフラストラクチャ・プロパティの構成」を参照してください。

36.1.3.1 WSDL URLのキャッシュの構成

エンドポイントWSDL URLのキャッシングは、デフォルトで実行時に発生します。エンドポイントWSDL URLがorauddiプロトコルを使用して解決された場合、後続の呼出しはWSDL URLをOSRからではなくキャッシュから取得します。照会時にキャッシュのエンドポイントWSDL URLを使用できる時間を増やすには、「UddiCacheLifetime」プロパティを持つサービス・キーを使用します。このプロパティに指定した時間間隔でキャッシュが無効化されます。デフォルト値は86400秒です。最小値は300秒です。

WSDL URLのエンドポイントのキャッシュを構成する手順は、次のとおりです。

1. 「SOAインフラストラクチャ」メニューから、「管理」→「システムMBeanブラウザ」の順に選択します。

2. 「アプリケーション定義のMBean」→「oracle.as.soainfra.config」→「サーバー: soa_server1」→「SoaInfraConfig」→「soa-infra」→「属性」の順に選択します。

3. ページの右側にある「UddiCacheLifetime」プロパティをクリックします。

4. 値を入力します。

5. 「適用」をクリックします。

37 サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントの監視

この章では、SOAコンポジット・アプリケーションのサービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントの監視方法(インスタンス、フォルトおよび拒否メッセージの監視を含む)について説明します。

この章では、次の項目について説明します。

- 第37.1項「バインディング・コンポーネントのインスタンスとフォルトの監視」

- 第37.2項「バインディング・コンポーネントの拒否メッセージの監視」

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

- バインディング・コンポーネントの概念の詳細は、第1.2.5項「バインディング・コンポーネントの概要」を参照してください。

- Oracle B2Bの詳細は、第XII部「Oracle B2BとOracle Healthcareの管理」を参照してください。

- 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』

37.1 バインディング・コンポーネントのインスタンスとフォルトの監視

SOAコンポジット・アプリケーションに組み込まれているすべてのバインディング・コンポーネントのインスタンスとフォルトを監視できます。

バインディング・コンポーネントのインスタンスとフォルトを監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にあるパーティションを展開します。

2. 特定のSOAコンポジット・アプリケーションを選択します。

2. 「ダッシュボード」をクリックします(選択されていない場合)。

3. 「サービスと参照」セクションで、特定のサービスまたは参照を選択します。

4. JCAアダプタまたはWebサービスのサービスを選択した場合、「ダッシュボード」ページに次の詳細が表示されます。

- サーバーの起動時以降の受信メッセージとフォルトの合計数のグラフィック表示。

- 最新の拒否メッセージ。メッセージ名、フォルトの発生時間、およびフォルトのタイプ(ビジネスまたはシステム)が表示されます。

5. RMI(リモート・メソッド呼出し)呼出し(直接バインディングと呼ばれる)を介してSOAコンポジット・アプリケーションを起動するサービスを選択した場合、「ダッシュボード」ページにステップ5の説明と類似した詳細が表示されます。直接バインディングを使用すると、JVM全体でトランザクションとセキュリティの伝播をサポートするAPIを介して、SOAコンポジット・アプリケーションを起動できます。
単語「ダイレクト」がヘッダーに表示され、直接バインディング・コンポーネントであることが示されます。ただし、直接バインディング・コンポーネントでは、「ポリシー」タブと「プロパティ」タブは使用できません。

6. 参照を選択した場合は、「ダッシュボード」ページに、次の詳細が表示されます。

- サーバーの起動時以降の送信メッセージとフォルトの合計数のグラフィック表示。

- 最新のフォルト。フォルトの発生時間およびフォルトのタイプ(ビジネスまたはシステム)が表示されます。

参照バインディング・コンポーネントは、JCAアダプタとWebサービスでのみ使用可能です。

37.2 バインディング・コンポーネントの拒否メッセージの監視

SOAコンポジット・アプリケーションに組み込まれているすべてのバインディング・コンポーネントの拒否メッセージを監視できます。

バインディング・コンポーネントの拒否メッセージを監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にあるパーティションを展開します。

2. 特定のSOAコンポジット・アプリケーションを選択します。

2. 「サービスと参照」セクションで、特定のサービスまたは参照を選択します。

3. 「フォルト・メッセージと拒否メッセージ」をクリックします。
「フォルト・メッセージと拒否メッセージ」ページに、フォルト・メッセージと拒否メッセージのリストが、エラー・メッセージ、フォルトの発生時間、関連するコンポジット・インスタンスIDなどの詳細とともに表示されます。フォルトは、選択したバインディング・コンポーネントのタイプに従って、サービス・バインディング・コンポーネントで処理された受信メッセージか、参照バインディング・コンポーネントで処理された送信メッセージのいずれかに関連しています。

このページからフォルト・リカバリを実行できます。

4. 「エラー・メッセージ」列で特定のメッセージをクリックして、完全なフォルト詳細(フォルトID、フォルトの発生時間、フォルトの場所、フォルト・タイプ、エラー・メッセージ・テキストなど)を表示します。リカバリ可能なフォルトには、「ここでリカバリ」オプションが表示されます。

5. 「ここでリカバリ」をクリックして、フォルト・リカバリを実行します。

6. 拒否メッセージを削除する場合は、「拒否メッセージの削除」をクリックします。
拒否メッセージを削除するための基準を指定するダイアログが表示されます。

7. 基準を指定して、「削除」をクリックします。

38 サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントの管理

この章では、SOAコンポジット・アプリケーションのWebサービス、JCAアダプタ・サービスおよび参照バインディング・コンポーネントのポリシーの管理方法、ならびにサービス・バインディング・コンポーネントの登録済のUniversal Description, Discovery, and Integration (UDDI)ソースからUDDIレジストリへの公開方法について説明します。

この章では、次の項目について説明します。

- 第38.1項「バインディング・コンポーネントのポリシーの管理」

- 第38.2項「UDDIレジストリへのWebサービスの公開」

注意:

- Oracle SOA Suiteでは、サービス・バインディング・コンポーネントまたは参照バインディング・コンポーネントに対する複数のバインディング(例: composite.xmlファイルにSOAP 1.1とSOAP 1.2の両方を指定する)はサポートされていません。サポートの対象は、サービスまたは参照ごとに1つのWebサービス・バインディングのみです。複数のバインディングを指定する場合は、1つを除いてすべてのバインディングを削除し、SOAコンポジット・アプリケーションを再デプロイします。

- ポリシーをアタッチできるバインディング・コンポーネントのタイプは、Webサービスのみです。JCAアダプタ、ADF-BCサービス、EJBサービスなどの別のタイプのバインディング・コンポーネントの「ポリシー」タブをクリックすると、次のメッセージが表示されます。

Policies can be attached to web service bindings and SOA
components.

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

- バインディング・コンポーネントの概念の詳細は、第1.2.5項「バインディング・コンポーネントの概要」を参照してください。

- 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』

38.1 バインディング・コンポーネントのポリシーの管理

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

注意:

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

バインディング・コンポーネント・ポリシーを管理する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にあるパーティションを展開します。

2. 特定のSOAコンポジット・アプリケーションを選択します。

選択したSOAコンポジット・アプリケーションに対する「ダッシュボード」タブが表示されます。このページの「サービスと参照」セクションに、アプリケーションで使用されているバインディング・コンポーネントが表示されます。

2. 「サービスと参照」セクションで、サービスまたは参照を選択します。

3. 「ポリシー」をクリックします。
「ポリシー」ページでは、グローバルにアタッチされたポリシーおよび直接アタッチされたポリシーを表示でき、サービス・バインディング・コンポーネントまたは参照バインディング・コンポーネントとの間でセキュリティ・ポリシーをアタッチまたはデタッチできます。

- 「グローバルにアタッチされたポリシー」表には、グローバルにアタッチされたポリシーの名前、ポリシー・セット、カテゴリ(「管理」、「信頼できるメッセージング」、「MTOMアタッチメント」、「セキュリティ」または「WSアドレス」)、SOAインフラストラクチャの最後の再起動以降の違反、およびSOAインフラストラクチャの最後の再起動以降の認証、認可、機密性および整合性の失敗が表示されます。
ポリシー・セットを使用すると、ある範囲に含まれる同じタイプのエンドポイントに対して、ポリシーをグローバルにアタッチできます。ポリシー・セットを使用してポリシーをグローバルにアタッチすることによって、開発者、アセンブラまたはデプロイヤがアタッチするポリシーを明示的に指定しなかった状況において、管理者は、すべてのサブジェクトが確実に保護されるようにできます。ポリシー・セットを使用してアタッチされるポリシーは、外部的にアタッチされたと見なされます。ポリシー・セットの作成および管理の詳細は、『Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイド』の「ポリシー・セットの作成および管理」を参照してください。

- 「直接アタッチされたポリシー」表には、直接アタッチされたポリシーの名前、ポリシー参照ステータス(有効または無効)、カテゴリ、SOAインフラストラクチャの最後の再起動以降の違反、およびSOAインフラストラクチャの最後の再起動以降の認証、認可、機密性および整合性の失敗が表示されます。

5. 「直接アタッチされたポリシー」セクションで、「アタッチ/デタッチ」をクリックします。
複数のコンポーネントが使用可能な場合は、アタッチまたはデタッチを実行するサービスまたはコンポーネントを選択するプロンプトが表示されます。

注意:

ポリシーをサービス・バインディング・コンポーネント(クライアント)にアタッチして、「Webサービスのテスト」ページでSOAコンポジット・アプリケーションのインスタンスを起動し、ポリシーのアタッチに失敗した場合、Oracle Web Services Manager (OSWM)ポリシー・エラーは生成されず、Oracle Enterprise Manager Fusion Middleware Controlに表示されません。

同じSOAコンポジット・アプリケーション・インスタンスが外部で起動された場合は、ポリシー・エラーが生成され、Oracle Enterprise Manager Fusion Middleware Controlに表示されます。

サービス・コンポーネント(BPELプロセスなど)または参照バインディング・コンポーネントの場合は、アプリケーション・インスタンスが外部で起動されたか、「Webサービスのテスト」ページを介して内部で起動されたかに関係なく、ポリシー・エラーが常に生成され、表示されます。

6. ポリシーのアタッチ先またはデタッチ先のサービスまたはコンポーネントを選択します。
ポリシーをアタッチまたはデタッチするためのダイアログが起動します。

「アタッチされたポリシー」セクションに、現在アタッチされているポリシーが表示されます。「使用可能なポリシー」セクションには、アタッチ可能な追加のポリシーが表示されます。

7. 使用環境に適した、アタッチ対象のポリシーを選択します。

8. 「アタッチ」をクリックします。

9. ポリシーのアタッチを終了した後は、「検証」をクリックします。

10. エラー・メッセージが表示された場合は、検証エラーがなくなるまで必要な修正を行います。
アタッチしたポリシーがポリシー表に表示されます。

11. 「OK」をクリックします。

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

- 第1.4.3.2項「ポリシーの概要」

- ポリシーのアタッチで表示されるダイアログについては、第7.7項「SOAコンポジット・アプリケーションのポリシーの管理」を参照してください。

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

38.1.1 ポリシー構成プロパティ値のオーバーライド

使用環境には、同じポリシーを持つ複数のサーバーを含めることができます。ただし、各サーバーはそれぞれ固有のポリシー要件を保持できます。実行時要件を満たすために、サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントにアタッチされている管理ポリシーおよびセキュリティ・ポリシーのプロパティ値をオーバーライドできます。

1. サービス・バインディング・コンポーネントまたは参照バインディング・コンポーネントにポリシーをアタッチするには、第38.1項「バインディング・コンポーネントのポリシーの管理」の手順を参照してください。

2. 表内でアタッチされているポリシーを選択します。
「セキュリティ構成の詳細」表がページの下部に表示されます。

3. 「値」フィールドに値を入力して、「元の値」列のデフォルト値をオーバーライドします。

4. 「適用」をクリックします。

ポリシー値のオーバーライドの詳細は、『Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイド』を参照してください。

38.2 UDDIレジストリへのWebサービスの公開

サービス・バインディング・コンポーネントを登録済のUDDIソースからUDDIレジストリに公開できます。

注意:

- 参照バインディング・コンポーネントは、UDDIレジストリには公開できません。

- UDDIレジストリに公開できるのはWebサービスのみです。たとえば、JCAアダプタは公開できません。

Oracle Service Registryの詳細は、次の手順で得ることができます。

1. 次のURLにアクセスします。

http://www.oracle.com/technetwork/middleware/registry/overview/index.html

2. 「製品」タブをクリックします。

3. ガバナンスをクリックします。

Oracle Enterprise Repositoryの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository構成ガイド』および『Oracle Fusion Middleware Oracle Enterprise Repository統合ガイド』を参照してください。

UDDIレジストリへのWebサービスの公開の詳細は、『Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイド』を参照してください。

38.2.1 UDDIにWebサービスを公開するための環境の構成

WebサービスをUDDIレジストリに公開する前に、環境を構成する必要があります。

SOAインフラストラクチャのインストールがファイアウォールで保護されている場合、Oracle Enterprise Manager Fusion Middleware Control管理対象サーバーは、アウトバウンドURL接続用に構成されたプロキシ・サーバーを持つ必要があります。

WebサービスをUDDIに公開するための環境を構成するには、次の手順を実行します。

1. 次のいずれかの方法で、プロキシ・サーバー設定を構成します。
次のファイルを使用します。

1. FMW_Home/user_projects/domains/soainfra/bin/のsetDomainEnv.shファイル(Linuxの場合。Windowsオペレーティング・システムの場合はsetDomainEnv.bat)を開きます。

2. 次の構文を入力し、環境に適したホスト、ポートおよびプロキシ・ホストの詳細情報を指定します。

EXTRA_JAVA_PROPERTIES="${EXTRA_JAVA_PROPERTIES} -DproxySet=true
-Dhttp.proxyHost=www-myproxy.us.mycompany.com -Dhttp.proxyPort=80
-Dhttp.nonProxyHosts=localhost|$HOST_IP_ADDRESS|$HOSTNAME|*.us.mycompany.com"
export EXTRA_JAVA_PROPERTIES

3. setDomainEnv.shまたはsetDomainEnv.batを実行します。

次の環境変数を使用します。

1. Oracle WebLogic Serverの開始前にPROXY_SETTINGS環境変数を設定します。

setenv PROXY_SETTINGS "-DproxySet=true
-Dhttp.proxyHost=www-myproxy.us.mycompany.com -Dhttp.proxyPort=80
-Dhttp.nonProxyHosts=localhost|*.us.mycompany.com
|0:0:0:0:0:0:0:1|fe80:0:0:0:250:56ff:fe31"

公開用に使用するUDDIソースを設定する必要があります。

1. ナビゲータで、「WebLogicドメイン」を開きます。

2. soainfraを右クリックして、「Webサービス」> 「登録済サービス」を選択します。
「登録済ソースおよびサービス」ページが表示されます。

3. 「ソース」セクションで、「Webサービスの登録」をクリックします。
「新規ソースの登録」ダイアログ・ボックスが表示されます。

4. 次の情報を入力します。

フィールド

説明

名前

サービスの記述名を入力します。

説明

WSDLを公開するUDDIソースの記述名を入力します。

タイプ

「UDDI v3レジストリ・インポート」を選択します。

ソースの場所

ソースの場所を入力します。例:

http://myhost.us.mycompany.com:7001/registry/uddi/inquiry

公開

「有効化」チェック・ボックスを選択します。

公開URL

公開URLを入力します。例:

http://myhost.us.mycompany.com:7001/registry/uddi/publishing

セキュリティURL

セキュリティURLを入力します。例:

http://myhost.us.mycompany.com:7001/registry/uddi/security

ユーザーID

adminを入力します。

パスワード

ユーザーIDのパスワードを入力します。

5. 「OK」をクリックします。

38.2.2 UDDIレジストリへのWebサービスの公開

注意:

Oracle Enterprise Manager Fusion Middleware ControlからデフォルトのOracle Service RegistryビジネスにWebサービスを公開できます。デフォルト以外のビジネスに公開するには、Oracle Service Registryの公開オプションを使用します。

ドキュメントを含むOracle Service Registryの詳細は、次のURLを参照してください。

http://www.oracle.com/technetwork/middleware/registry/overview/index.html

UDDIレジストリにWebサービスを公開するには、次の手順を実行します。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービスと参照」を選択します。

1. 「soa-infra」を右クリックします。

2. 「サービスと参照」を選択します。

「サービス」ページには、サービスの名前とタイプ、サービスが使用されているSOAコンポジット・アプリケーション、コンポジットがデプロイされているパーティション、処理されたメッセージの合計数、平均処理時間、およびサービスで発生したフォルトの件数に関する詳細が表示されます。

2. 「サービス」表で、UDDIレジストリに公開するサービスを選択します。

3. 「アクション」リストで、「UDDIに公開」を選択します。

「UDDIへのサービスの公開」ダイアログ・ボックスが表示されます。

4. 次の情報を入力します。

フィールド

説明

サービス名

選択したサービスの名前を表示します。

サービスの説明

選択したサービスに関するオプションの説明を入力します。

システム定義の場所

UDDIレジストリに公開するWSDL URLを表示します。例:

http://myhost.mycompany.com:7001/soa-infra/services/default/HelloWorld/client?WSDL

UDDIソース

サービスの登録元のUDDI公開ソースを選択します。

ビジネス名

サービスを公開するビジネスを選択します。これは、UDDIレジストリ内のデータ構造の名前です。ビジネスがすでにUDDIレジストリに登録されていることが前提とされています。

完了すると、「UDDIへのサービスの公開」ダイアログ・ボックスは次のように表示されます。

5. 「OK」をクリックします。

第XV部

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

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

次の章で構成されています。

- 第39章「Oracle BPMNプロセス・サービス・コンポーネントとエンジンの構成」

- 第40章「BPMNプロセスのサービス・コンポーネントとエンジンの監視」

- 第41章「Oracle BPMNのサービス・コンポーネントとエンジンの管理」

39 Oracle BPMNプロセス・サービス・コンポーネントとエンジンの構成

この章では、管理者を対象に、BPMNプロセス・サービス・エンジンの構成方法(BPMNサービス・コンポーネントの処理中にエンジンによって使用されるプロパティの構成を含む)について説明します。

この章では、次の項目について説明します。

- 第39.1項「BPMNプロセス・サービス・エンジン・プロパティの構成」

- 第39.2項「Oracle BPMとOracle Business Activity Monitoringの統合」

BPMNプロセスのチューニングとパフォーマンス・プロパティの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』を参照してください。

39.1 BPMNプロセス・サービス・エンジン・プロパティの構成

BPMNプロセス・サービス・エンジン・プロパティを構成する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「SOA管理」→「BPMNプロパティ」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「SOA管理」→「BPMNプロパティ」の順に選択します。

「BPMNサービス・エンジン・プロパティ」ページに、監査証跡しきい値と大容量ドキュメントしきい値の設定、ディスパッチャ・スレッド・プロパティの設定、ペイロード・スキーマの検証、および監査証跡レベルの設定を行うためのプロパティが表示されます。

2. 使用環境に適するようにサービス・エンジン・プロパティを変更します。

プロパティ

説明

監査レベル

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

- オフ: ロギングは実行されません。コンポジット・インスタンスのトラッキング情報とペイロード・トラッキング情報は収集されません。測定が有効な場合、このレベルは「最小」にオーバーライドされます。

- 継承(デフォルト): ロギング・レベルは、SOAインフラストラクチャの監査レベルと同じです。これにより、グローバル設定の変更時にBPMN監査レベルが自動的に変更されるようになります。このページで異なる監査レベル・トラッキングを設定すると、SOAインフラストラクチャ・レベルに設定されたトラッキングがオーバーライドされます。

- 最小: インスタンス・トラッキング情報は収集されますが、ペイロード詳細は収集されないため、フローの監査証跡でペイロード詳細は使用できません。

- 本番: インスタンス・トラッキング情報は収集され、ペイロード詳細は、非同期アクティビティの出力データ・アソシエーションについてのみ収集されます。多くの場合、通常の操作およびテストにはこのレベルが最適です。

- 開発: コンポジット・インスタンスのトラッキングとペイロード・トラッキングの両方を許可します。ただし、このことによってパフォーマンスが低下する場合があります。このレベルは通常、デバッグする際に便利です。

注意: 監査エントリが表示されないようにするには、監査レベルとメトリックの両方をオフにする必要があります。メトリックが有効である場合は、監査レベルがオフに設定されている場合でも、監査エントリが表示されます。

監査証跡しきい値(バイト)

監査証跡とは別にチャンクされてデハイドレーション・ストア表に保存される前の、インスタンスの監査証跡の最大サイズをバイト単位で入力します。このしきい値を超えると、ペイロードのかわりに、「XMLの表示」リンクが監査証跡に表示されます。

大容量のドキュメントしきい値(バイト)

デハイドレーション・ストアの別の表に保存される前の、BPMNプロセス・コンポーネント・インスタンス内に生成されるドキュメントの最大サイズを入力します。

ディスパッチャ・システム・スレッド

システム・ディスパッチャ・メッセージの処理に割り当てるスレッドの合計数を指定します。システム・ディスパッチ・メッセージは、通常、サーバーにより迅速に処理される一般的なクリーン・アップ・タスクです(たとえば、ステートフル・メッセージBeanを元のプールに解放)。通常、実行時に生成されたシステム・ディスパッチ・メッセージの数を処理するために必要なスレッド数はごく少数です。

デフォルト値は2スレッドです。1スレッド未満の値は、デフォルト値に変更されます。

ディスパッチャ呼出しスレッド

呼出しディスパッチャ・メッセージの処理に割り当てるスレッド合計数を指定します。呼出しディスパッチャ・メッセージは、受信したペイロードごとに生成され、新規インスタンスをインスタンス化するために使用されます。サービス・エンジンで処理されるリクエストの大多数が(インスタンス・コールバックではなく)インスタンス呼出しである場合は、呼出しスレッド数を増加させることでパフォーマンスが大幅に向上する可能性があります。スレッド数が多くなるほど、コンテキスト切替えコストが高くなるため、CPU使用率が大幅に増加する可能性があります。

デフォルト値は20スレッドです。1スレッド未満の値は、デフォルト値に変更されます。

ディスパッチャ・エンジン・スレッド

サービス・エンジン・ディスパッチャ・メッセージの処理に割り当てるスレッドの合計数を指定します。サービス・エンジン・ディスパッチャ・メッセージは、アクティビティを非同期で処理する必要がある場合に必ず生成されます。デプロイされるプロセスの大多数が永続的で、多数のデハイドレーション・ポイント(midprocess receive、onMessage、onAlarmおよびwaitアクティビティ)がある場合は、サービス・エンジン・スレッド数を増加させることでパフォーマンスが大幅に向上する可能性があります。スレッド数が多くなるほど、コンテキスト切替えコストが高くなるため、CPU使用率が大幅に増加する可能性があります。

デフォルト値は30スレッドです。1スレッド未満の値は、デフォルト値に変更されます。

ペイロードの検証

インバウンド・メッセージとアウトバウンド・メッセージの検証を有効にする場合に選択します。スキーマに準拠しないペイロード・データが捕捉され、フォルトとして表示されます。

注意: この設定は、SOAコンポジット・アプリケーションおよびSOAインフラストラクチャのペイロード検証レベルの設定に依存しません。ペイロード検証がサービス・エンジンとSOAインフラストラクチャの両レベルで有効な場合、データは2回チェックされます。1回目は、データがSOAインフラストラクチャに入るとき、2回目は、データがサービス・エンジンに入るときです。

BPMNモニターおよびセンサーの無効化

デプロイ済のすべてのSOAコンポジット・アプリケーションのすべてのBPMNコンポーネントについて定義されているすべてのBPMNモニターおよびセンサーを無効化するには、このチェック・ボックスを選択します。

3. 「適用」をクリックします。

4. システムMBeanブラウザで拡張BPMNプロパティを構成するには、「詳細BPMN構成プロパティ」をクリックします。表示されるプロパティには次のものがあります。各プロパティには説明が記載されています。

- AuditDetailThreshold: 監査証跡詳細文字列が、監査証跡とは別に格納される前に許可される最大サイズ(バイト単位)。

- AuditLevel: プロセスによってログに記録される監査イベントの数を制御します。現在サポートされているロギング・レベルはoff(ロギングをまったく実行しない)であり、インスタンス処理のパフォーマンスがわずかに向上する場合があります。

- BpelcClasspath: BPMNで生成されたJavaソースをコンパイルするときに追加のクラスパスを含める必要があります。

- ConfigMBean: trueの場合、このMBeanが構成MBeanであることを示します。

- CubeInstanceExpiration: パフォーマンス・データの有効期限(時間単位)。このパラメータはデフォルトで無効化されています。このパラメータは有効化できます。

- CubeTimerMaxErrorCount: キューブ・タイマー処理中にエラーが連続して発生することが許容される最大数。エラー数がCubeTimerMaxErrorCountに達すると、キューブ・タイマーは処理をスキップします。

- CubeTimerMaxSkipOnErrorCount: エラー数がCubeTimerMaxErrorCountに達した場合に、タイマーが処理をスキップする回数を指定します。

注意:

キューブ・タイマーの連続するエラーの回数がCubeTimerMaxErrorCoutの回数を超過すると、キューブ・タイマーはタイムアウト処理をCubeTimerMaxSkipOnErrorCountの回数スキップします。次に、通常のタイムアウト処理を再開します。キューブ・タイマーが処理をスキップする時間は、CubeTimerMaxErrorCount * CubeUpdateFrequencyで計算できます。

ロックアウト時間を減らす必要がある場合は、時間の値を低くするか、またはタイムアウト処理をスキップする回数を変更する必要があります。

- CubeUpdateFrequency: キューブ・アクションがワークロードを計算する頻度(秒単位)。

- CubeWorkloadExpiration: ワークロード・レコードの有効期限。デフォルトで48時間に設定されており、この設定は、ワークロード・レコードの経過時間が48時間を超えると、ワークロード・レコードがパージされることを意味します。

- DisableActions: 無効化された測定アクションのカンマ区切りリスト(例: CubeCommand, BAMCommand)。「PublishMaxTrackBackCount」も参照してください。

- DisableProcessTracking: trueに設定すると、監査はプロセス追跡を無効化します。デフォルト値はfalseです。

- DisableSensors: trueに設定すると、サービス・エンジンはセンサーへのすべての呼出しを無効化します。デフォルト値はfalseです。

- DispatcherEngineThreads: エンジン・ディスパッチャ・メッセージの処理に割り当てられるスレッドの合計数。

- DispatcherInvokeThreads: 呼出しディスパッチャ・メッセージの処理に割り当てられるスレッドの合計数。

- DispatcherMaxRequestDepth: サービス・エンジンが処理する内部メッセージの最大件数。この件数を超えると、新しいメッセージはディスパッチされません。デフォルト値は600です。

- DispatcherSystemThreads: システム・ディスパッチャ・メッセージの処理に割り当てられるスレッドの合計数。

- eventProvider: trueに設定された場合、このMBeanがJSR-77によって定義されているイベント・プロバイダであることを示します。

- eventTypes: このMBeanによって送信されるすべてのイベントのタイプ。

- ExpirationMaxRetry: 失敗した期限切れ呼出し(wait/onAlarm)が失敗するまでに再試行される最大回数。

- ExpirationRetryDelay: 次の期限切れ呼出し再試行までの遅延。デフォルト値は120秒です。

- InstanceKeyBlockSize: 1回のフェッチごとにデハイドレーション・ストアから割り当てられるインスタンスIDのブロック・サイズ。

- LargeDocumentThreshold: 残りのインスタンス・スコープ・データとは別の場所に格納される前に許可されるBPMN変数の最大サイズ(バイト単位)。

- MaximumNumberOfInvokeMessagesInCache: メモリー内キャッシュに保持できる呼出しメッセージ数を指定し、サービス・エンジンがこの制限に達するとディスパッチャのメモリー内キャッシュにメッセージをプッシュしてかわりにデータベースにメッセージを保存し、保存されたこれらのメッセージはリカバリ・ジョブを使用してリカバリできます。このプロパティを無効化するには、値-1を使用します。

- objectName: MBeanの固有のJMX名。

- OneWayDeliveryPolicy: 一方向呼出しメッセージを配信するかどうかを変更します。

- PeopleQueryTimeout: 人の問合せにquartz cron式を指定します。論理ピープル・グループの人の問合せは、このcron式に基づいて再評価されます。

- PublishMaxTrackBackCount: 最新の監査レコードを横断して、有効化された測定およびアクションの有無をチェックし、ある場合は公開されるレコードの最大数。

- QualityOfService: BPMNサービス・エンジンのOracle Coherenceキャッシュを有効化または無効化するフラグ。Oracle Coherenceを有効化するには、CacheEnabledを使用します。

- ReadOnly: trueに設定された場合、このMBeanが読取り専用MBeanであることを示します。

- RestartNeeded: 再起動が必要かどうかを示します。

- StatsLastN: 最近処理されたリクエスト・リストのサイズ。

- SystemMBean: trueに設定された場合、このMBeanがシステムMBeanであることを示します。

- UserInitiateProcessCleanupAction: クリーンアップ・プロシージャに実行するアクション。OFF(デフォルト)、ABORTまたはDELETEを指定できます。OFFを指定すると、スケジュールに従ってプロセスが次にアクティブ化された際、クリーンアップ・プロセスは無効になります。

- UserInitiateProcessCleanupCronExpression: クリーンアップ・プロシージャの実行時期と頻度を示すcronタイプの式。スケジュールの変更は、スケジュールに従ってクリーンアップ・プロセスが次にアクティブ化された際、有効になります。

- UserInitiateProcessCleanupRetentionDays: number of days oldより古い、ユーザーが開始したプロセスのみが処理されます。ゼロは使用できません。1日の一部分は小数で指定できます。

- UserInitiateProcessCleanupTaskStates: クリーンアップ・プロシージャ時に考慮する必要があるタスクの状態。

注意:

UserInitiateProcessCleanupプロパティは、イニシエータ・タスクを使用して作成されたプロパティのクリーンアップをサポートします。

- ValidateXML: trueに設定すると、サービス・エンジンは受信および送信XMLドキュメントに対してスキーマ検証を適用します。デフォルト値はfalseです。

- Version: 構成ファイルのバージョン。

- WFOracleUcmUrl: Oracle WebCenter Contentリポジトリ管理サーバーのURLを指定します。

39.2 Oracle BPMとOracle Business Activity Monitoringの統合

BPMNコンポジット・アプリケーションがデプロイされると、次のOracle BAMデータ・オブジェクトが自動的に生成されます。

- 次のビジネス・インジケータのデータ・オブジェクト
TEMPLATE_BI_Partition_Composite_Process

これをインポートするとき、次の名前に変更する必要があります。

BI_DEFAULT_Compositename_ProcessName

これはターゲット・フォルダに作成されます。データ・オブジェクトがすでに存在する場合、古い列のデータ型が一致することを前提として、新しい列が追加されます。そうでない場合、エラーがスローされます。

- COMPONENT、INTERVAL、COUNTERデータ・オブジェクト(ターゲット・フォルダに存在しない場合)。

ターゲットのOracle BAMサーバーはJNDI名前パラメータによって指定されます。

注意:

データ・オブジェクトはデプロイ時に自動的にのみ作成されます。これらは手動で作成できません。

Oracle BPMをOracle Business Activity Monitoringと一緒に使用するように構成するには、次のタスクを実行します。

- タスク1: Oracle BPMサーバー上でのOracle BAMアダプタの構成

- タスク2: Oracle BPMサーバー上でのOracle BAMの有効化

39.2.1 タスク1: Oracle BPMサーバー上でのOracle BAMアダプタの構成

Oracle BAMとの通信用にSOAPまたはRMIを使用するようOracle BAMアダプタを構成する必要があります。

Oracle BAMアダプタをOracle BPMサーバー上に構成するには、次の手順を実行します。

1. Oracle WebLogic Server管理コンソールの「ドメイン構造」で、「デプロイメント」をクリックします。

2. 「OracleBAMAdapter」→「構成」→「アウトバウンド接続プール」の順にクリックします。

3. oracle.bam.adapter.adc.soap.SOAPConnectionFactoryを展開します。

4. eis/bam/soapまたはeis/bam/rmiをクリックします。
Oracle BAMアダプタを構成するために使用するJNDI名が使用されます。たとえば、SOAPを使用するようにOracle BAMアダプタを構成した場合、デフォルトのJNDI名はeis/bam/soapです。同様に、RMIを使用するようにOracle BAMアダプタを構成した場合、デフォルトのJNDI名はeis/bam/rmiです。

5. Oracle BAMサーバーに一致するようにプロパティを変更します。(テキストを入力した後、[Enter]を押してください)。

6. 「保存」をクリックします。

7. デプロイメント・プランのロケーション(たとえばbam/Plan.xml)を選択し、ダイアログを完了します。

8. 「デプロイメント」に戻ります。

9. 「OracleBAMAdapter」を選択します。

10. 「更新」をクリックし、ダイアログを完了します。

Oracle Business Activity MonitoringとOracle SOA Suiteコンポジット・アプリケーションの統合の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

39.2.2 タスク2: Oracle BPMサーバー上でのOracle BAMの有効化

このタスクを実行するには、Oracle Enterprise Manager Fusion Middleware Controlを使用します。

Oracle BPMサーバー上でOracle BAMを有効にするには、次の手順を実行します。

1. Oracle Fusion Middleware Controlの「WebLogicドメイン」で、ドメインおよびサーバーを選択します。

2. 「システムMBeanブラウザ」に移動します。

3. 「oracle.as.soainfra.config」→「サーバー」→「BPMNConfig」→「bpmn」の順に選択します。

4. 「アクションの無効化」に移動します。ここで「BAMAction」が見つかった場合は、フィールドをクリアします。

5. 「適用」をクリックします。

40 BPMNプロセスのサービス・コンポーネントとエンジンの監視

この章では、BPMNプロセス・サービス・コンポーネントとサービス・エンジンの監視方法(監査証跡とプロセス・フローの表示、インスタンスとフォルトの監視、リクエスト統計とスレッド・パフォーマンス統計の監視、およびデプロイ済BPMNプロセスの監視を含む)について説明します。

この章では、次の項目について説明します。

- 第40.1項「BPMNプロセス・サービス・コンポーネントの監査証跡とプロセス・フローの表示」

- 第40.2項「BPMNプロセス・サービス・コンポーネントのインスタンスとフォルトの監視」

- 第40.3項「BPMNプロセス・サービス・コンポーネントのインスタンスの監視」

- 第40.4項「BPMNプロセス・サービス・エンジンのインスタンスとフォルトの監視」

- 第40.5項「BPMNプロセス・サービス・エンジンのリクエスト統計とスレッド・パフォーマンス統計の監視」

- 第40.6項「BPMNプロセス・サービス・エンジンのインスタンスの監視」

- 第40.7項「サービス・エンジンにデプロイされたBPMNプロセスの監視」

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

- 第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」

- 第1.2.6項「サービス・エンジンの概要」

40.1 BPMNプロセス・サービス・コンポーネントの監査証跡とプロセス・フローの表示

この項では、SOAコンポジット・アプリケーション・インスタンスのBPMNプロセス・サービス・コンポーネントに関する監査証跡とプロセス・フローの表示方法について説明します。

注意:

- この項では、SOAコンポジット・アプリケーション・インスタンスが起動していることを想定しています。起動していない場合、手順については、第8.1項「SOAコンポジット・アプリケーションのテスト・インスタンスの起動」を参照してください。

- 複数のメッセージが短い間隔でスローされた場合、これらのメッセージは送信された順序では処理されません。このことは、プロセス・インスタンスの監査証跡を確認すると明らかになります。

BPMNプロセス・サービス・コンポーネントの監査証跡とプロセス・フローを表示する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションを選択します。

選択したコンポジット・アプリケーションに対する「ダッシュボード」ページが表示されます。

2. 次のいずれかの方法を使用して、アプリケーションのインスタンスを選択します。

- このアプリケーションの最新のインスタンスから選択する場合は、「最新のインスタンス」セクションの「インスタンスID」列で、インスタンスのインスタンス番号をクリックします。

- このアプリケーションのすべてのインスタンスから選択する場合は、「インスタンス」タブをクリックして、次に「インスタンスID」リストの特定のインスタンスをクリックします。

「フローのトレース」ページに、次の詳細が表示されます。

- 「フォルト」セクションには、SOAコンポジット・アプリケーションを構成するサービス、サービス・コンポーネントおよび参照で発生しているフォルトが表示されます。センサーを使用すると、実行時にBPMNプロセスのアクティビティ、変数およびフォルトを監視できます。フォルトを選択すると、「トレース」セクションでは、フォルトが発生した行が強調表示されます。フォルトを閉じると、「トレース」セクションの選択がクリアされます。

- 「センサー」セクションには、SOAコンポジット・アプリケーションのサービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントに組み込まれているコンポジット・センサーの詳細が表示されます。センサーの合計数はセクション・ヘッダーに表示されます。コンポジット・センサーは、設計時にOracle JDeveloperで、サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントに追加できます。サービス・コンポーネントにはコンポジット・センサーを追加できません。このセクションでコンポジット・センサーを選択すると、「トレース」セクションでは、コンポジット・センサー・データが収集されたサービスまたは参照が強調表示されます。センサーを閉じると、「トレース」セクションの選択がクリアされます。

注意:

「フォルト」または「センサー」セクションは1つずつ展開します。フォルトまたはセクション情報は、この方法で表示した場合にのみ表示されます。

- 「トレース」セクションには、SOAコンポジット・アプリケーションを構成するサービス、サービス・コンポーネントおよび参照間での一連のメッセージ・フローが表示されます。

フローのトレースは、実行コンテキストID (ECID)によって識別されるメッセージ・フローのランタイム追跡で、このページの右上隅に表示されます。ECIDを使用すると、様々なコンポジットのインスタンス間のメッセージ・フローを追跡できます。フローのトレースでは、フローに属しているコンポジットのすべてのサービス、参照およびコンポーネントが示されます。

「トレース」セクションにあるフローの例では、フローに関連するサービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントでメッセージが正常に受信されて処理されています。

ECIDに関する次の制限に注意してください。

- コンポジット・アプリケーションの各インスタンスには、別々のECIDが表示され、コンポジット・アプリケーションの全インスタンスの完全なフローを追跡できるコンポジット・レベルのECIDは表示されません。

- 完全なフロー情報を取得するには、ログ・ファイルでコンポジット・レベルのECIDを検索する必要があります。検索した値を使用して、特定のコンポジットとそのコンポジットで実行された全インスタンスに関するすべての情報を取得します。

- ECIDは、ビジネス・イベントを介して伝播されません。このため、収集されるロギング情報の量が制限される場合があります。たとえば、同じコンポジット・アプリケーションでサブスクライブされるイベントを公開した場合は、使用できるロギング情報が制限されます。

3. 「フォルト」セクションで、フォルトを選択します。
選択すると、「トレース」セクションでは、フォルトが発生した行が強調表示されます。

4. フォルトを閉じると、「トレース」セクションの選択がクリアされます。

5. 「センサー」セクションを開いて、コンポジット・センサーを表示します。

6. 「センサー」セクションで、センサーを選択します。
選択すると、「トレース」セクションでは、コンポジット・センサー・データが収集された行が強調表示されます。

7. 「トレース」セクションの「インスタンス」列で、特定のBPMNプロセス・サービス・コンポーネントのインスタンスをクリックします。サービス・コンポーネントのインスタンスはこのセクションからアクセスできます。サービスと参照にはアクセスできません。
図40-1に示すような「インスタンス」ページが表示されます。

図40-1「インスタンス」ページ

これらのページを使用して、BPMNプロセス・サービス・コンポーネント・インスタンスの監査証跡、フローおよびフォルトを表示します。次のリンクを使用すると、インスタンスに関するその他の詳細を表示できます。

- 「フローのトレース」リンク: ページの左上隅にあるブレッドクラムをクリックすると、該当するBPMNコンポーネント・インスタンスが含まれるECID(コンポジット・インスタンス)のフローのトレースにアクセスできます。

- 「情報」アイコン: BPMNコンポーネント名(ページ・タイトル)の右側にある「情報」アイコンをクリックすると、このBPMNインスタンスの履歴情報が表示されます。この情報には、インスタンスID、ECID、インスタンスの起動時間または最終更新日時、インスタンスの状態(実行中など)およびフォルト件数などのインスタンスのサマリーが含まれます。
このアイコンは、BPMNプロセスおよびOracle Mediatorの「監査証跡」ページにのみ表示されます。ヒューマン・タスクおよびビジネス・ルールのページには表示されません。

- 現在の監査レベル: クリックすると、このインスタンスで使用される監査レベルなど、情報の詳細が表示されます。

「インスタンス」ページを開くと、「監査証跡」ページがデフォルトで表示されます。BPMNプロセス内のアクティビティに関する実行の詳細が表示されます。

列

説明

アクティビティ

プロセス内で使用可能なすべてのBPM構成を、実行される順序でリストします。次のものが含まれます。

- イベント: 開始、終了、シグナル、スロー、メッセージの捕捉。

- アクティビティ: ユーザー・タスク、ビジネス・ルール・タスク、サービス・タスク、コール・アクティビティ、サブプロセス。

- ゲートウェイ: 包含、排他、パラレル、イベント・ベースおよび複合。

ループ件数イベント

監査証跡表の行内で参照されているアクティビティがサブプロセスであり、このサブプロセスのループ特性がループまたはマルチインスタンスに設定されている場合、この列にはloopCounter変数の値が表示されます。

イベント

BPMN構成が実行されると、監査はログに2回(そのアクティビティを開始するときに1回、アクティビティを終了して次のアクティビティに移動するときに1回)記録されます。ノードが閉じられている場合は、アクティビティが完了したか、処理中か、またはキャンセルされていることを示します。

日付

項目がポストされたときに表示されるタイム・スタンプ。

コピー

一部のアクティビティが(たとえば、パラレル・ゲートウェイの異なるパスで)同時に実行される場合は、この目的に使用されるスレッド数がコピーによって維持されます。

8. 監査証跡をスクロールしてエラーを確認し、ペイロード・リンクを開いてフローの特定の場所にある内容を表示します。
ペイロード・リンクをクリックすると、「ペイロードXML」ページが表示されます。このページには、プロセスの特定のポイントに対する出力データ・アソシエーションを持っていたデータ・オブジェクトの値が表示されます。

9. 「フロー」タブをクリックします。
BPMNプロセス・アクティビティのフロー・ダイアグラムが表示されます。このフロー・ダイアグラムでは、BPMNプロセス・アクティビティのフォルトが強調表示されます。

10. アクティビティをクリックして、プロセス内のペイロードのフローを表示します。

注意:

Microsoft Internet Explorerを使用する場合は、「詳細をクリップボードにコピー」をクリックすると、アクティビティ詳細をクリップボードにコピーできます。Mozilla Firefoxを使用する場合、このリンクは表示されません。かわりに、手動でテキストを選択してコピーし、ファイルに貼り付ける必要があります。

11. フロー・ダイアグラムをスクロールしてエラーを確認し、強調表示されたアクティビティをクリックしてエラー・メッセージを表示します。

12. このウィンドウを閉じます。

13. 「フォルト」タブをクリックします。
このページには、エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、およびフォルトが発生したアクティビティが表示されます。このページには、BPMNコンポーネント・インスタンスのフォルトが表示されます(サービス・バインディング・コンポーネントまたは参照バインディング・コンポーネントで発生したフォルトは表示されません)。

リカバリ可能と識別されているインスタンスのフォルトをリカバリできます。このページには、すべてのインスタンスのフォルトと、リカバリ可能かどうかが示されます。サービスまたは参照で発生したコンポーネント・インスタンスのフォルトは、ここには表示されません。

このページでは、個々のフォルトをリカバリ対象として指定できます。また、他のページでは使用できないフォルト・リカバリ粒度に関する度合いが表示されます。

ただし、このページでは一括フォルト・リカバリを実行できません。一括フォルト・リカバリを実行するには、次のいずれかのページを使用します。

- 特定のSOAコンポジット・アプリケーションまたはSOAインフラストラクチャの「フォルト・メッセージと拒否メッセージ」ページ。

- BPMNプロセス・サービス・エンジンまたは特定のBPMNプロセス・サービス・コンポーネントの「フォルト」ページ。

14. リカバリ可能として識別されたリカバリ対象のフォルトを次のいずれかの方法を使用して選択します。ページがリフレッシュされ、ページの下部にフォルト・リカバリ・セクションが表示されます。

- 「エラー・メッセージ」列にあるフォルトをクリックすると、ポップアップ・メッセージにフォルトの詳細(フォルトID、フォルトの発生時間、フォルトの場所、フォルト・タイプ、エラー・メッセージの完全なテキストなど)が表示されます。フォルトがリカバリ可能と識別されている場合は、「ここでリカバリ」ボタンが表示され、クリックできます。

- 「リカバリ」列にあるリカバリ可能と識別されたフォルトをクリックします。

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

アクション

説明

再試行

再試行成功時アクションを指定するオプション付きでインスタンスを再試行します。このリカバリ・アクションを使用するシナリオ例は、ネットワーク・エラーのためにサービス・プロバイダにアクセスできないことが原因でフォルトが発生した場合の例です。ネットワーク・エラーは現在解決しています。

中断

インスタンス全体を終了します。

リプレイ

フォルトが発生したスコープ全体を再度リプレイします。

再スロー

現在のフォルトを再スローします。フォルトの処理に、BPMNフォルト・ハンドラ(catchブランチ)が使用されます。デフォルトでは、再スロー・フォルト・ポリシーが明示的に指定されていない場合、すべての例外がフォルト管理フレームワークによって捕捉されます。

続行

フォルトを無視して処理を続行します(フォルト・アクティビティには成功のマークが付けられます)。

選択したアクションによって、追加のフィールドが表示されます。たとえば、「再スロー」を選択すると、次のフィールドが表示されます。

16. 「再試行成功後」リストを使用して、再試行の成功後に起動する定義済アクションを選択します。「変数」リストで変数を選択した場合は、その値を「値」テキスト・ボックスで編集できます。

17. ブラウザの「戻る」ボタンをクリックし、フロー・ダイアグラムを終了します。

40.2 BPMNプロセス・サービス・コンポーネントのインスタンスとフォルトの監視

BPMNプロセス・サービス・コンポーネントの最新のインスタンスとフォルトを監視できます。SOAコンポジット・アプリケーションの各サービス・コンポーネントには、独自のインスタンスIDがあります。このIDは、それぞれのサービス・コンポーネントが属しているSOAコンポジット・アプリケーションの全体のインスタンスIDとは異なります。

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

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションを選択します。

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

3. 「ダッシュボード」をクリックします。

「ダッシュボード」ページの上部には、次の詳細が表示されます。

- BPMNプロセス・サービス・コンポーネントの最新のインスタンス。インスタンスID、インスタンスの状態(正常完了や失敗など)、開始時間、最終更新日時、およびインスタンスが記述されているログが表示されます。

- BPMNプロセス・サービス・コンポーネントの最新のフォルト。エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、BPMNサービス・コンポーネントのインスタンスID、フォルトが発生したBPMNアクティビティ、およびフォルトが記述されているログが表示されます。

- BPMNプロセス・サービス・コンポーネントのアクティビティごとの平均処理時間。

4. 「最新のインスタンス」セクションでは、次のタスクを実行できます。

- サービス・コンポーネントの監査証跡、プロセス・フローおよびフォルトの表示。このタスクを実行するには、「インスタンスID」列でサービス・コンポーネントのインスタンスIDをクリックします。

- そのインスタンスに固有のフィルタ処理済メッセージがある「ログ・メッセージ」ページへのアクセス。このタスクを実行するには、「ログ」列で特定のログをクリックします。

- サービス・コンポーネントの「インスタンス」ページへのアクセス。これを行うには、セクションの下の「詳細を表示」をクリックします。

5. 「最近のインスタンスとフォルト」セクションでは、次のタスクを実行できます。

- フォルトに関するすべての情報の表示。このタスクを実行するには、「エラー・メッセージ」列でエラー・メッセージをクリックします。フォルトがリカバリ可能と識別されている場合は、「ここでリカバリ」リンクをクリックすると、フォルト・リカバリを実行できます。

- コンポーネント・インスタンス・レベルでのフォルト・リカバリの実行。このタスクを実行するには、「リカバリ」列で「リカバリ可能」と識別されているフォルトをクリックします。

- そのインスタンスに固有のフィルタ処理済メッセージがある「ログ・メッセージ」ページへのアクセス。このタスクを実行するには、「ログ」列で特定のログをクリックします。

- サービス・コンポーネントの「フォルト」ページへのアクセス。このタスクを実行するには、セクションの下の「詳細を表示」をクリックします。

「ダッシュボード」ページの下部には、次の詳細が表示されます。

- 特定時間帯におけるBPMNプロセス・サービス・コンポーネントの成功、失敗および受信(保留中)のインスタンス数のグラフィカル表示。

- このBPMNプロセス・サービス・コンポーネントが通信した参照バインディング・コンポーネントによって処理されたフォルトとメッセージの件数。

詳細は、第1.2.3項「SOAコンポジット・アプリケーション・インスタンスの概要」を参照してください。

40.3 BPMNプロセス・サービス・コンポーネントのインスタンスとフォルトの監視

BPMNプロセス・サービス・コンポーネントのインスタンスを監視できます。各サービス・コンポーネントには、独自のインスタンスIDがあります。このIDは、このサービス・コンポーネントが属しているSOAコンポジット・アプリケーションの全体のインスタンスIDとは異なります。

BPMNプロセス・サービス・コンポーネントのインスタンスを監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションを選択します。

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

3. 「インスタンス」タブをクリックします。

「インスタンス」ページに、次の詳細が表示されます。

- 特定のBPMNサービス・コンポーネントのインスタンスを検索するためのユーティリティ。基準を指定して「検索」をクリックします。デフォルトでは、このページに初めてアクセスしたときにはインスタンスは表示されません。インスタンスを表示するには、「検索」をクリックする必要があります。

- BPMNプロセス・サービス・コンポーネントのインスタンス。インスタンスID、インスタンスの状態(完了や失敗など)、インスタンスの開始時間、インスタンスの最終更新日時、およびインスタンスが記述されているログ・ファイルが表示されます。

このページでは、次のタスクを実行できます。

- サービス・コンポーネントの監査証跡、プロセス・フローおよびフォルトの表示。このタスクを実行するには、「インスタンスID」列でサービス・コンポーネントのインスタンスIDをクリックします。

- そのインスタンスに固有のフィルタ処理済メッセージがある「ログ・メッセージ」ページへのアクセス。このタスクを実行するには、「ログ」列で特定のログをクリックします。

詳細は、第1.2.3項「SOAコンポジット・アプリケーション・インスタンスの概要」を参照してください。

40.4 BPMNプロセス・サービス・エンジンのインスタンスとフォルトの監視

BPMNプロセス・サービス・エンジンで実行しているすべてのBPMNプロセス・サービス・コンポーネントのインスタンスとフォルトを監視できます。BPMNプロセス・サービス・コンポーネントは、別々のSOAコンポジット・アプリケーションに属している場合があります。

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

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「BPMN」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「BPMN」の順に選択します。

2. 「ダッシュボード」をクリックします。

「ダッシュボード」ページの上部には、BPMNプロセス・サービス・エンジンで実行しているすべてのBPMNプロセス・サービス・コンポーネントの最新インスタンスが表示されます。これには、サービス・コンポーネントのインスタンスID、サービス・コンポーネント名、サービス・コンポーネントが属しているSOAコンポジット・アプリケーション、インスタンスの状態(正常完了や失敗など)、インスタンスの開始時間、最終更新日時、およびインスタンスが記述されているログが含まれます。

「ダッシュボード」ページの下部には、次の詳細が表示されます。

- サービス・エンジンで実行しているサービス・コンポーネント、サービス・コンポーネントのSOAコンポジット・アプリケーション、アプリケーションの状態(実行中など)、サービス・エンジンにおける合計、実行中および失敗したインスタンスの数。

- サービス・エンジンの最新のフォルト。エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、フォルトが発生したSOAコンポジット・アプリケーション、サービス・コンポーネント、サービス・コンポーネントのインスタンスID、フォルトが発生したアクティビティ、およびフォルトが記述されているログ・ファイルが表示されます。

3. 「最新のインスタンス」セクションでは、次の監視タスクを実行できます。

- サービス・コンポーネントの監査証跡、プロセス・フローおよびフォルトの表示。このタスクを実行するには、「インスタンスID」列でサービス・コンポーネントのインスタンスIDをクリックします。

- サービス・コンポーネントのホーム・ページへのアクセス。このタスクを実行するには、「コンポーネント」列で特定のサービス・コンポーネントをクリックします。

- SOAコンポジット・アプリケーションのホーム・ページへのアクセス。このタスクを実行するには、「コンポジット」列で特定のSOAコンポジット・アプリケーションをクリックします。

- インスタンスに固有のフィルタ処理済メッセージがある「ログ・メッセージ」ページへのアクセス。このタスクを実行するには、「ログ」列で特定のログをクリックします。

- サービス・エンジンの「インスタンス」ページへのアクセス。このタスクを実行するには、セクションの下の「詳細を表示」をクリックします。

4. 「コンポーネント」セクションでは、次のタスクを実行できます。

- 特定のサービス・コンポーネントのホーム・ページへのアクセス。このタスクを実行するには、「名前」列で特定のサービス・コンポーネントをクリックします。

- 特定のSOAコンポジット・アプリケーションのホーム・ページへのアクセス。このタスクを実行するには、「コンポジット」列で特定のSOAコンポジット・アプリケーションをクリックします。

- サービス・エンジンの「デプロイ済コンポーネント」ページへのアクセス。このタスクを実行するには、セクションの下の「詳細を表示」をクリックします。

5. 「最新のフォルト」セクションでは、次のタスクを実行できます。

- フォルトに関するすべての情報の表示。このタスクを実行するには、「エラー・メッセージ」列でエラー・メッセージをクリックします。フォルトがリカバリ可能と識別されている場合は、「ここでリカバリ」リンクをクリックし、フォルト・リカバリを実行します。

- コンポーネント・インスタンス・レベルでのフォルト・リカバリの実行。このタスクを実行するには、「リカバリ」列で「リカバリ可能」と識別されているフォルトをクリックします。

- 特定のSOAコンポジット・アプリケーションのホーム・ページへのアクセス。このタスクを実行するには、「コンポジット」列で特定のSOAコンポジット・アプリケーションをクリックします。

- 特定のサービス・コンポーネントのホーム・ページへのアクセス。このタスクを実行するには、「コンポーネント」列で特定のサービス・コンポーネントをクリックします。

- サービス・コンポーネントの監査証跡、プロセス・フローおよびフォルトの表示。このタスクを実行するには、「コンポーネント・インスタンスID」列でサービス・コンポーネントのインスタンスIDをクリックします。

- フォルトに固有のフィルタ処理済メッセージがある「ログ・メッセージ」ページへのアクセス。このタスクを実行するには、「ログ」列で特定のログをクリックします。

詳細は、第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」を参照してください。

40.5 BPMNプロセス・サービス・エンジンのリクエスト統計とスレッド・パフォーマンス統計の監視

サービス・エンジンで実行しているすべてのBPMNプロセス・サービス・コンポーネントのリクエスト統計とスレッド・パフォーマンス統計を監視できます。

BPMNプロセス・サービス・エンジンのリクエスト統計とスレッド統計を監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「BPMN」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「BPMN」の順に選択します。

2. 「統計」をクリックします。
「統計」ページの上部には、次の詳細が表示されます。追加の詳細は、「ヘルプ」アイコンをクリックしてください。

- サービス・エンジン内の保留中のリクエスト数

- サービス・エンジン内のアクティブ・リクエスト数

- サービス・エンジンのスレッド統計

「統計」ページの下部には、件数、リクエスト処理時間の最大、最小および平均に関する詳細が表示されます。

BPMNプロセスのチューニングとパフォーマンス・プロパティの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』を参照してください。

40.6 BPMNプロセス・サービス・エンジンのインスタンスの監視

サービス・エンジンで実行しているすべてのBPMNプロセス・サービス・コンポーネントのインスタンスを監視できます。BPMNプロセス・サービス・コンポーネントは、別々のSOAコンポジット・アプリケーションに属している場合があります。

BPMNプロセス・サービス・エンジンのインスタンスを監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「BPMN」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「BPMN」の順に選択します。

2. 「インスタンス」をクリックします。

「インスタンス」ページに、次の詳細が表示されます。

- 特定のインスタンスを検索するためのユーティリティ。基準を指定して「検索」をクリックします。デフォルトでは、このページに初めてアクセスしたときにはインスタンスは表示されません。インスタンスを表示するには、「検索」をクリックする必要があります。

- インスタンス。サービス・コンポーネントのインスタンスID、サービス・コンポーネント名、SOAコンポジット・アプリケーション名、インスタンスの状態(正常完了、実行中、失敗など)、インスタンスの開始時間、最終更新日時、およびインスタンスが記述されているログ・ファイルが表示されます。

3. 「インスタンス」セクションでは、次の監視タスクを実行できます。

- サービス・コンポーネントの監査証跡、プロセス・フロー、センサー値およびフォルトの表示。このタスクを実行するには、「インスタンスID」列でサービス・コンポーネントのインスタンスIDをクリックします。

- 特定のサービス・コンポーネントのホーム・ページへのアクセス。このタスクを実行するには、「コンポーネント」列で特定のサービス・コンポーネントをクリックします。

- 特定のSOAコンポジット・アプリケーションのホーム・ページへのアクセス。このタスクを実行するには、「コンポジット」列で特定のSOAコンポジット・アプリケーションをクリックします。

- インスタンスに固有のフィルタ処理済メッセージがある「ログ・メッセージ」ページへのアクセス。このタスクを実行するには、「ログ」列で特定のログをクリックします。

詳細は、第1.2.4項「サービス・コンポーネントおよびサービス・コンポーネント・インスタンスの概要」を参照してください。

40.7 サービス・エンジンにデプロイされたBPMNプロセスの監視

サービス・エンジンで実行しているBPMNプロセス・サービス・コンポーネントで構成されたすべてのデプロイ済SOAコンポジット・アプリケーションを監視できます。

注意:

サブタスクはOracle Enterprise Manager Fusion Middleware Controlにはリストされません。

サービス・エンジンにデプロイされたBPMNプロセスを監視する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「BPMN」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「BPMN」の順に選択します。

2. 「デプロイ済コンポーネント」をクリックします。

「デプロイ済コンポーネント」ページに、次の詳細が表示されます。

- デプロイ済の特定のSOAコンポジット・アプリケーションを検索するためのユーティリティ。基準を指定して「検索」をクリックします。

- サービス・エンジンで実行しているBPMNプロセス・サービス・コンポーネントで構成されたデプロイ済SOAコンポジット・アプリケーションの詳細。サービス・コンポーネント名、SOAコンポジット・アプリケーション、現在のステータス、サービス・エンジンにおける合計、実行中および失敗したインスタンスが表示されます。

特定のサービス・コンポーネントのホーム・ページにアクセスするには、「名前」列で特定のサービス・コンポーネントをクリックします。

特定のSOAコンポジット・アプリケーションのホーム・ページにアクセスするには、「コンポジット」列で特定のSOAコンポジット・アプリケーションをクリックします。

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プロセス・サービス・コンポーネントのフォルトをリカバリする手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションを選択します。

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

3. 「フォルト」をクリックします。

「フォルト」ページに、次の詳細が表示されます。

- 特定のフォルトを検索するためのユーティリティ。基準を指定して「検索」をクリックします。詳細は、「ヘルプ」アイコンをクリックしてください。デフォルトでは、このページに初めてアクセスしたときにはフォルトは表示されません。フォルトを表示するには、「検索」をクリックする必要があります。

- サービス・コンポーネントで発生したフォルト。フォルトID、エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、サービス・コンポーネントのインスタンスID、フォルトが発生したアクティビティ、およびフォルトが記述されているログ・ファイルへのリンクが表示されます。

リカバリが可能として識別されたBPMNプロセス・サービス・コンポーネントのフォルトはリカバリできます。

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

対象

操作

単一フォルト・リカバリ

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

1. リカバリ可能として識別されたフォルトの行をクリックします。行が強調表示された状態で、ステップ5の説明に従って、「リカバリ・アクション」リストから特定のアクションを選択します。

2. 「リカバリ」列で「リカバリ」リンクをクリックし、インスタンス監査証跡の「フォルト」ページにアクセスしてフォルト・リカバリを実行します。

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

一括フォルト・リカバリ

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

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

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

3. ステップ5の説明に従って、「リカバリ・アクション」リストからアクションを選択します。
注意: 選択できるのは、選択したすべてのフォルトに適用可能なアクションのみです。

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

1. 「選択」メニューから、「すべてのリカバリ可能な値を選択」を選択します。

2. ステップ5の説明に従って、「リカバリ・アクション」リストからアクションを選択します。
注意: 選択できるのは、選択したすべてのフォルトに適用可能なアクションのみです。

注意:

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

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

アクション

説明

再試行

インスタンスを直接再試行します。このリカバリ・アクションを使用するシナリオ例は、ネットワーク・エラーのためにサービス・プロバイダにアクセスできないことが原因でフォルトが発生した場合の例です。ネットワーク・エラーは現在解決しています。

中断

インスタンス全体を終了します。

リプレイ

フォルトが発生したスコープ全体を再度リプレイします。

再スロー

現在のフォルトを再スローします。フォルトの処理に、BPMNフォルト・ハンドラ(catchブランチ)が使用されます。デフォルトでは、再スロー・フォルト・ポリシーが明示的に指定されていない場合、すべての例外がフォルト管理フレームワークによって捕捉されます。

続行

フォルトを無視して処理を続行します(フォルト・アクティビティには成功のマークが付けられます)。

6. フォルト表内から次の追加監視タスクを実行します。

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プロセス・サービス・コンポーネント・ポリシーを管理する手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「ホーム」を選択します。

2. 「デプロイ済コンポジット」タブを選択します。

3. 「コンポジット」セクションで、特定のSOAコンポジット・アプリケーションを選択します。

1. 「soa-infra」の下にある、特定のSOAコンポジット・アプリケーションを選択します。

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

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

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

5. ポリシーのアタッチ先またはデタッチ先のサービスまたはコンポーネントを選択します。
ポリシーをアタッチまたはデタッチするためのダイアログが起動します。

「アタッチされたポリシー」セクションに、現在アタッチされているポリシーが表示されます。「使用可能なポリシー」セクションには、アタッチ可能な追加のポリシーが表示されます。

6. 使用環境に適したポリシーを選択してアタッチします。

7. 「アタッチ」をクリックします。

8. ポリシーのアタッチを終了した後は、「検証」をクリックします。

9. エラー・メッセージが表示された場合は、検証エラーがなくなるまで必要な修正を行います。

10. 「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プロセス・サービス・エンジンのフォルトをリカバリする手順は、次のとおりです。

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「BPMN」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「BPMN」の順に選択します。

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

「フォルト」ページに、次の詳細が表示されます。

- 特定のフォルトを検索するためのユーティリティ。基準を指定して「検索」をクリックします。詳細を表示するには、「ヘルプ」アイコンをクリックします。デフォルトでは、このページに初めてアクセスしたときにはフォルトは表示されません。フォルトを表示するには、「検索」をクリックする必要があります。

- サービス・エンジンで発生したフォルト。フォルトID、エラー・メッセージ、フォルトのリカバリが可能かどうか、フォルトの発生時間、フォルトが発生したSOAコンポジット・アプリケーションとサービス・コンポーネント、およびサービス・コンポーネント・インスタンスIDが表示されます。

リカバリが可能として識別されたBPMNプロセス・サービス・エンジンのフォルトはリカバリできます。

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

注意:

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

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

アクション

説明

再試行

再試行成功時アクションを指定するオプション付きでインスタンスを再試行します。このリカバリ・アクションを使用するシナリオ例は、ネットワーク・エラーのためにサービス・プロバイダにアクセスできないことが原因でフォルトが発生した場合の例です。ネットワーク・エラーは現在解決しています。

中断

インスタンス全体を終了します。

リプレイ

フォルトが発生したスコープ全体を再度リプレイします。

再スロー

現在のフォルトを再スローします。フォルトの処理に、BPMNフォルト・ハンドラ(catchブランチ)が使用されます。デフォルトでは、再スロー・フォルト・ポリシーが明示的に指定されていない場合、すべての例外がフォルト管理フレームワークによって捕捉されます。

続行

フォルトを無視して処理を続行します(フォルト・アクティビティには成功のマークが付けられます)。

5. フォルト表内から次の追加監視タスクを実行します。

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が表示された場合、次を実行します。

1. Oracleデータベースを停止します。

2. OPEN_CURSORSの値を1500に増やします。

3. Oracleデータベースを再起動します。

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

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

SOAインフラストラクチャのメニューから...

ナビゲータのSOAフォルダから...

1. 「サービス・エンジン」→「BPMN」の順に選択します。

1. 「soa-infra」を右クリックします。

2. 「サービス・エンジン」→「BPMN」の順に選択します。

2. 「リカバリ」をクリックします。
「リカバリ」ページに、次の詳細が表示されます。

- 特定のメッセージの失敗を検索するためのユーティリティ。基準を指定して「検索」をクリックします。詳細は、「ヘルプ」アイコンをクリックしてください。

- サービス・エンジンでのメッセージの失敗。対話ID、メッセージの失敗のリカバリが可能かどうか、サービス・コンポーネント、失敗が発生したコンポジット・アプリケーション、およびフォルトの発生時間が表示されます。

3. この表でフォルトを選択します。

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

アクション

説明

リカバリ

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

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

取消としてマーク

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

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

第XVI部

付録

次の付録で構成されています。

- 付録A「データベースへのデモ・ユーザー・コミュニティのインストール」

- 付録B「Oracle SOA SuiteとOracle BPM Suiteのトラブルシューティング」

- 付録C「Oracle Enterprise ManagerのOracle SOA Suiteユーザーのロールおよび権限」

A データベースへのデモ・ユーザー・コミュニティのインストール

この付録では、デモ・ユーザー・コミュニティと呼ばれるユーザーおよびグループの組織階層を、データベースにインストールし、使用する方法について説明します。このコミュニティのユーザーとグループを、タスク・ワークフローを進めるための承認など人とのやりとりが必要なタスクに割り当てることができます。

この付録では次の項について説明します。

- 第A.1項「デモ・ユーザー・コミュニティのインストール」

- 第A.2項「デモ・コミュニティのユーザー」

- 第A.3項「デモ・コミュニティのグループ」

- A.4項「soa-infraアプリケーション・ロール」

- A.5項「SOATestDemoAppアプリケーション・ロール」

- A.6項「ユーザーに付与されているロールおよびユーザーが所有しているロール」

- A.7項「WorkflowPermissionクラス」

A.1 デモ・ユーザー・コミュニティのインストール

デモ・ユーザー・コミュニティは、ユーザーとグループの組織階層です。Oracle SOA Suiteをインストールした後は、デモ・ユーザー・コミュニティをデータベースにインストールする必要があります。デモ・ユーザー・コミュニティは、Oracle SOA Suiteサンプル・サイト上のHWリンクから利用可能なworkflow-001-DemoCommunitySeedAppサンプルの一部です。サンプルに含まれるREADME.txtファイルには、デモ・ユーザー・コミュニティをインストールするための基本的な方法と高度な方法の両方が説明されています。デモ・ユーザー・コミュニティをインストールするための基本的な方法は、この項でも説明します。

注意:

リモートではなくドメイン内からユーザー・デモ・コミュニティをローカルに作成するには、このスクリプトを実行する必要があります。

デモ・ユーザー・コミュニティをインストールする手順は、次のとおりです。

1. 次のいずれかがローカルにインストールされていることを確認します。

- Oracle JDeveloper

- Oracle BPMサーバー

- ant 1.7

2. Oracle SOA Suiteサンプルサイトからworkflow-001-DemoCommunitySeedAppサンプルをダウンロードします。

3. 次のコマンドを入力し、ホスト上のJavaのバージョンを確認します。

java -version

デモ・ユーザー・コミュニティをデータベースにインストールするホストには、Java 1.6 update 17以降が含まれていることが必要です。

4. 環境のPATHに、Oracle SOA Suite添付のJavaのバージョンが含まれていることを確認します。

5. データベースへのデモ・ユーザー・コミュニティのインストール方法を選択します。

build.propertiesファイルを使用する方法

指定のパラメータでantスクリプトを実行する方法

1. ダウンロードしたサンプルに含まれるbuild.propertiesファイルを、環境に合わせて編集します。

# Set the admin server location
admin.url=t3://localhost:7001
server.url=http://localhost:8001

# Set the Fusion Middleware home, also
# called the bea home
# Linux style /scratch/oracle/middleware
# Windows style C:\\Oracle\\Middleware
bea.home=/scratch/oracle/middleware/
home_betaupdate

# Set the authentication
admin.name=weblogic
admin.pwd=password

# Use the managed server for the target or
# if single server configuration use the
# admin server
# e.g. target=soa_server1 or
# target=AdminServer
target=AdminServer

2. 次のantコマンドを実行します。

$FMW_HOME\modules\org.apache.ant
_1.7.0\bin\ant seedDemoUsers

$FMW_HOMEには、Oracle JDeveloperまたはSOA ServerのOracle Fusion Middlewareホーム・ディレクトリを指定します(または、ant 1.7の場所へのパスを指定します)。

1. 指定のパラメータでantスクリプトを実行します。bea.homeとFMW_HOMEは同じであることに注意してください。

ant seedDemoUsers -Dbea.home=FMW_HOME
-Doracle.home=ORACLE_HOME
-Ddomain.home=FMW_HOME/user_projects/
domains/Domain_Name
-Dtarget=Managed_Server_Name
-Dadmin.url=t3://HOST:Admin_Server_Port
-Dserver.url=http://HOST:Managed_Server_Port
-Dadmin.name=Admin_Name
-Dadmin.pwd=Admin_Password

FMW_HOMEにはインストール・ホーム・ディレクトリの絶対パスを、ORACLE_HOMEにはインストール時に指定したOracleホームの絶対パスを指定します。

例:

ant seedDemoUsers
-Dbea.home=/scratch/wls/as11wls/lt20
-Doracle.home=/scratch/wls/as11wls/lt20/
AS11gR1SOA
-Ddomain.home=/scratch/wls/as11wls/lt20/
user_projects/domains/domain1
-Dtarget=soa_server1
-Dadmin.url=t3://wlserver.example.com:7001
-Dserver.url=http:///wlserver.example.com:
8001
-Dadmin.name=weblogic
-Dadmin.pwd=password

これによってデモ・ユーザー・コミュニティがインストールされて、デモappRolesに権限が付与されます。

インストールが成功した場合は、次のメッセージが表示されます。

Build Successful

注意:

Build Successfulメッセージは、接続に問題がある場合でも表示されます。これらのメッセージを監視してください。

デモ・ユーザーのシードに成功すると、jcooper、jsteinまたは他のユーザーとして、build.propertiesファイルに指定されたパスワードを使用してログインできます。

インストールに成功しなかった場合は、次のメッセージが表示されます。

Build Failed

インストールの失敗は、構成またはサーバーの可用性の問題が原因となって起こります。これらの問題を修正して再試行してください。

A.2 デモ・コミュニティのユーザー

表A-1に、デモ・コミュニティ内のユーザーをリストします。

表A-1 デモ・コミュニティ内のユーザー

ユーザー

ユーザー名

名

姓

タイトル

マネージャ

電子メール

1

achrist

Agatha

Christie

Loan Consultant

wfaulk

achrist@emailExample.com

5

cdickens

Charles

Dickens

CEO

--

cdickens@emailExample.com

6

cdoyle

Conan

Doyle

Loan Agent 2

rsteven

cdoyle@emailExample.com

3

EHEMING

Ernest

Hemingway

CFO

JVerne

EHEMING@emailExample.com

7

fkafka

Franz

Kafka

Manager 1

ltolstoy

fkafka@emailExample.com

8

istone

Irving

Stone

Loan Agent 2

sfitzger

istone@emailExample.com

9

jausten

Jane

Austen

Loan Consultant

fkafka

jausten@emailExample.com

10

jcooper

James

Cooper

Loan Agent 1

jstein

jcooper@emailExample.com

11

jlondon

Jack

London

Loan Agent 1

sfitzger

jlondon@emailExample.com

12

jstein

John

Steinbeck

Manager 2

wfaulk

jstein@emailExample.com

2

JVerne

Jules

Verne

CIO

cdickens

JVerne@emailExample.com

13

ltolstoy

Leo

Tolstoy

Director

wfaulk

ltolsoy@emailExample.com

14

mmitch

Margaret

Mitchell

Loan Analyst

fkafka

mmitch@emailExample.com

15

mtwain

Mark

Twain

Loan Agent 2

jstein

mtwain@emailExample.com

16

rsteven

Robert

Stevenson

Manager 3

jstein

rsteven@emailExample.com

17

sfitzger

Scott

Fitzgerald

Manager 1

wfaulk

sfitzger@emailExample.com

18

szweig

Stefan

Zweig

Loan Analyst

fkafka

szweig@emailExample.com

4

VHUGO

Victor

Hugo

HR Manager

EHEMING

VHUGO@emailExample.com

19

wfaulk

William

Faulkner

Vice President

cdickens

wfaulk@emailExample.com

20

wshake

William

Shakespeare

Manager 3

rsteven

wshake@emailExample.com

図A-1に、デモ・コミュニティの組織階層を示します。

図A-1 デモ・コミュニティの組織階層

A.3 デモ・コミュニティのグループ

表A-2には、次がリストされています。

- デモ・コミュニティ内のグループ

- 各グループ・ロールを付与されているユーザーとグループ(直接権限受領者とすべての権限受領者)

- 各グループに付与されているグループ・ロールとアプリケーション・ロール(直接権限付与ロールとすべての権限付与ロール)

ユーザーでソートされた、ユーザーに付与されているロールについては、表A-6を参照してください。

表A-2 デモ・コミュニティ内のグループ: 権限付与の関係

グループ

直接権限受領者

すべての権限受領者

直接権限付与ロール

すべての権限付与ロール

RegionalOffices

CentralRegion、WesternRegion、EasternRegion

szweig、wshake、jcooper、WesternRegion、mmitch、EasternRegion、jlondon、CentralRegion、istone、cdoyle、mtwain、California、fkafka

-

-

EasternRegion

szweig、wshake、mmitch、fkafka

szweig、wshake、mmitch、fkafka

RegionalOffices

RegionalOffices

CentralRegion

jlondon、mtwain

jlondon、mtwain

RegionalOffices

RegionalOffices

WesternRegion

cdoyle、California

jcooper、istone、cdoyle、California

RegionalOffices

RegionalOffices

California

jcooper、istone

jcooper、istone

WesternRegion

RegionalOffices、WesternRegion

LoanAgentGroup

jlondon、wshake、LoanAnalyticGroup、jcooper、istone、cdoyle、mtwain

szweig、jlondon、wshake、LoanAnalyticGroup、jcooper、istone、cdoyle、mtwain、mmitch、fkafka

-

-

LoanAnalyticGroup

szweig、mmitch、fkafka

szweig、mmitch、fkafka

BPMWorkflowCustomize、LoanAgentGroup

BPMWorkflowCustomize、LoanAgentGroup

Supervisor

jcooper、mtwain、rsteven

jcooper、mtwain、rsteven

-

-

Executives

cdickens、JVerne、EHEMING、VHUGO

cdickens、JVerne、EHEMING、VHUGO

-

-

表A-3は、表A-2にリストした複数のグループに関する情報を示します。ここには次がリストされています。

- 各グループを所有するユーザーとグループ(直接所有者とすべての所有者)

- 各グループが所有するグループ・ロール(直接所有ロールとすべての所有ロール)

ユーザーでソートされた、ユーザーが所有しているロールについては、表A-6を参照してください。

表A-3 デモ・コミュニティ内のグループ: 所有の関係

グループ

直接所有者

すべての所有者

直接所有ロール

すべての所有ロール

EasternRegion

jstein

jstein

-

-

WesternRegion

jstein

jstein

-

-

California

fkafka

fkafka

-

-

LoanAgentGroup

jcooper、fkafka

jcooper、fkafka

-

-

LoanAnalyticGroup

jstein

jstein

-

-

Supervisor

jstein

jstein

-

-

A.4 soa-infraアプリケーション・ロール

表A-4には次がリストされています。

- soa-infraアプリケーション・ロール

- 各アプリケーション・ロールを付与されたユーザー、グループおよびロール(直接権限受領者とすべての権限受領者)

- 各アプリケーション・ロールに付与されているロール(直接権限付与ロールとすべての権限付与ロール)

ユーザーでソートされた、ユーザーに付与されているアプリケーション・ロールについては、表A-6を参照してください。

表A-4 soa-infra内のアプリケーション・ロール

アプリケーション・ロール

直接権限受領者

すべての権限受領者

直接権限付与ロール

すべての権限付与ロール

SOAAdmin

Administrators

Administrators

BPMWorkflowAdmin

BPMWorkflowCustomize BPMWorkflowAdmin

BPMWorkflowAdmin

SOAAdmin、demoadmin

SOAAdmin、demoadmin、Administrators

BPMWorkflowCustomize

BPMWorkflowCustomize

BPMWorkflowCustomize

LoanAnalyticGroup、BPMWorkflowAdmin

szweig、LoanAnalyticGroup、SOAAdmin、BPMWorkflowAdmin、mmitch、fkafka、Administrators、demoadmin

-

-

アプリケーション・ロールの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

A.5 SOATestDemoAppアプリケーション・ロール

表A-5に、SOATestDemoAppアプリケーション内のロールをリストします。

表A-5 SOATestDemoAppロール

アプリケーション・ロール

直接権限受領者

すべての権限受領者

直接権限付与ロール

すべての権限付与ロール

DevTeam

rsteven

rsteven、mmitch、fkafka、jcooper、istone

QATeam

jlondon、Supervisor

jlondon、jcooper、mtwain、rsteven、mmitch、fkafka、istone

ProductionTeam

mmitch、fkafka、California

mmitch、fkafka、jcooper、istone

DevTeam、QATeam

DevTeam、QATeam

A.6 ユーザーに付与されているロールおよびユーザーが所有しているロール

表A-6には、次がリストされています。

- 各ユーザーに付与されているロール(直接権限付与ロールとすべての権限付与ロール)

- 各ユーザーが所有するロール(直接所有ロールとすべての所有ロール)

表A-6 各ユーザーのロール

ユーザー名

直接権限付与ロール

すべての権限付与ロール

直接所有ロール

すべての所有ロール

achrist

Executives

-

-

-

cdickens

-

-

Executives

-

cdoyle

WesternRegion、LoanAgentGroup

RegionalOffices、WesternRegion、LoanAgentGroup

-

-

EHEMING

Executives

fkafka

LoanAnalyticGroup、EasternRegion、ProductionTeam

BPMWorkflowCustomize、RegionalOffices、LoanAnalyticGroup、LoanAgentGroup、EasternRegion、ProductionTeam、DevTeam、QATeam

LoanAgentGroup、California

LoanAgentGroup、California

istone

LoanAgentGroup、California

RegionalOffices、WesternRegion、LoanAgentGroup、California、DevTeam、QATeam、ProductionTeam

-

-

jausten

-

-

-

-

jcooper

Supervisor、LoanAgentGroup、California

RegionalOffices、WesternRegion、Supervisor、LoanAgentGroup、California、DevTeam、QATeam、ProductionTeam

LoanAgentGroup

LoanAgentGroup

jlondon

CentralRegion、LoanAgentGroup、QATeam

CentralRegion、RegionalOffices、LoanAgentGroup、QATeam

-

-

jstein

-

-

LoanAnalyticGroup WesternRegion、Supervisor、EasternRegion

LoanAnalyticGroup WesternRegion、Supervisor、EasternRegion

JVerne

Executives

ltolstoy

-

-

-

-

mmitch

LoanAnalyticGroup、EasternRegion、ProductionTeam

BPMWorkflowCustomize、RegionalOffices、LoanAnalyticGroup、LoanAgentGroup、EasternRegion、DevTeam、QATeam、ProductionTeam

-

-

mtwain

CentralRegion、Supervisor、LoanAgentGroup

CentralRegion、RegionalOffices、Supervisor、LoanAgentGroup、QATeam

-

-

rsteven

Supervisor、DevTeam

Supervisor、DevTeam

-

-

sfitzger

-

-

-

-

szweig

LoanAnalyticGroup、EasternRegion

BPMWorkflowCustomizeDemoApp/FlexFieldRole、RegionalOffices、LoanAnalyticGroup、LoanAgentGroup、EasternRegion

vhugo

Executives

wfaulk

-

-

-

-

wshake

LoanAgentGroup、EasternRegion

RegionalOffices、LoanAgentGroup、EasternRegion

-

-

A.7 WorkflowPermissionクラス

表A-7に、WorkflowPermissionクラスで定義されている権限および各権限に関連付けられているアプリケーション・ロールをリストします。

表A-7 WorkflowPermissionクラス

権限

権限のあるアプリケーション・ロール

workflow.mapping.publicFlexField

BPMWorkflowAdmin、BPMWorkflowCustomize

workflow.mapping.protectedFlexField

BPMWorkflowAdmin

workflow.admin

BPMWorkflowAdmin

workflow.admin.evidenceStore

BPMWorkflowAdmin

B Oracle SOA SuiteとOracle BPM Suiteのトラブルシューティング

この付録では、ロギング・レベルの設定、パラレル・パージと表のパーティション化の問題、接続およびトランザクション・タイムアウトの問題、ランタイム診断の問題、ヒューマン・ワークフローの問題、イベント配信ネットワーク(EDN)の問題、パフォーマンスの問題、サーバー起動のベスト・プラクティス、ブラウザの問題など、Oracle SOA SuiteとOracle BPM Suiteの使用時に発生する可能性がある問題をトラブルシューティングする方法について説明します。その他のトラブルシューティング情報の参照先も示されています。

この付録では次の項について説明します。

- B.1項「トラブルシューティングのためのロギング・レベルの設定」

- 第B.2項「パラレル・パージと表のパーティション化の問題」

- B.3項「接続およびトランザクション・タイムアウトのトラブルシューティング」

- 第B.4項「ランタイム診断のトラブルシューティング」

- B.5項「ヒューマン・ワークフローのトラブルシューティング」

- 第B.6項「EDNのトラブルシューティング」

- B.7項「パフォーマンスのトラブルシューティング」

- B.8項「サーバーのトラブルシューティング」

- B.9項「ブラウザのトラブルシューティング」

- B.10項「その他のトラブルシューティングのドキュメント」

B.1 トラブルシューティングのためのロギング・レベルの設定

トラブルシューティングを容易にするために、Oracle Enterprise Manager Fusion Middleware Controlで、ロギング・レベルを「TRACE:32 FINEST」レベルに設定することをお薦めします。この項では、このレベルに設定するロガーについて説明します。

トラブルシューティングのためにロギング・レベルを設定する手順は、次のとおりです。

1. 「ログ構成」ページにアクセスする手順については、第3.4項「ログ・ファイルの構成」を参照してください。

2. 「Oracle Diagnostic Loggingレベル(Javaレベル)」リストから、次の親ロガーを「TRACE:32 FINEST」レベルに設定します。

- oracle.soa

- oracle.fabric

- oracle.integration

- oracle.wsm (このロガーは、「ERROR」レベルの設定でも必要なエラー・メッセージが記録されるため、この設定でも問題ありません)

3. さらに詳細なロギング管理を行う場合は、親ロガーを展開して、次の任意のロガーを設定します。

コンポーネント

ロガー

ヒューマン・ワークフロー、承認管理の拡張(AMX)、ルール

- oracle.soa.services.common

- oracle.soa.services.identity

- oracle.soa.services.notification

- oracle.soa.services.rules

- oracle.soa.services.rules.obrtrace

- oracle.soa.services.workflow

- oracle.soa.services.workflow.common

- oracle.soa.services.workflow.evidence

- oracle.soa.services.workflow.metadata

- oracle.soa.services.workflow.persistency

- oracle.soa.services.workflow.query

- oracle.soa.services.workflow.report

- oracle.soa.services.workflow.runtimeconfig

- oracle.soa.services.workflow.soa

- oracle.soa.services.workflow.task

- oracle.soa.services.workflow.task.dispatch

- oracle.soa.services.workflow.task.routing

- oracle.soa.services.workflow.user

- oracle.soa.services.workflow.verification

- oracle.soa.services.workflow.performance - ワークフロー・パフォーマンスAPI

- oracle.soa.services.workflow.worklist - Oracle BPM Worklist

SOAインフラストラクチャ

- oracle.fabric.common.wsdl - WSDLおよびスキーマの管理

- oracle.integration.platform.blocks.deploy - デプロイメント

- oracle.integration.platform.blocks.soap - WSバインディング、Webサービスのコール

- oracle.integration.platform.blocks.local - ローカル・バインディング

- oracle.integration.platform.kernel - 起動の問題

- oracle.integration.plaform.blocks.mesh - メッセージのルーティング

- oracle.integration.platform.common - メタデータ、MDS

- oracle.integration.platform.instance - インスタンス

- oracle.integration.platform.instance.activity - インスタンス

- oracle.integration.platform.instance.store - インスタンス

EDN

- oracle.integration.platform.blocks.event

- oracle.integration.platform.blocks.event.saq

- oracle.integration.platform.blocks.event.jms

デプロイメント

oracle.integration

Oracle Mediator

- oracle.soa.mediator.common - Oracle Mediatorの監査メッセージの永続性に関連する処理イベントが記録されます。

- oracle.soa.mediator.common.cache - メタデータ・キャッシュ(RuntimeMetadataCache)およびランタイム関連のキャッシュ(RuntimeCache)。

- oracle.soa.mediator.common.error - エラーのエンキューと処理に関連する情報が記録されます。

- oracle.soa.mediator.common.error.recovery - エラーのリカバリ処理のみが記録されます。すべてのフォルト・ポリシー・ハンドラは、このロガーに含まれます。

- oracle.soa.mediator.common.listener - Oracle Mediatorのパラレル・ルーティング・ルールおよびリシーケンサ用の共通インフラストラクチャに関連する処理。

- oracle.soa.mediator.common.message - Oracle Mediatorメッセージの作成と変更に関連する情報が記録されます。(Oracle Mediatorでは、正規化メッセージをOracle Mediatorメッセージにラップします。)

- oracle.soa.mediator.common.persistence - Oracle Mediatorにおけるデータベースへの遅延メッセージの永続性に関連する情報が記録されます。

- oracle.soa.mediator.dispatch - Oracle Mediator内のメッセージ・ルーティング関連のすべてが記録されます。これには、順次ルーティング、パラレル・ルーティングおよび動的ルーティングが含まれます。

- oracle.soa.mediator.dispatch.db - 遅延メッセージおよびコンテナIDのインフラストラクチャに関連する情報が記録されます。

- oracle.soa.mediator.dispatch.resequencer.toplink - リシーケンサのデータベース通信に関連する情報が記録されます。これには、3つのすべてのリシーケンサ戦略の実行が含まれます。

- oracle.soa.mediator.monitor - Oracle Mediatorのインスタンス・トラッキングに関連するすべてのイベントが記録されます。

- oracle.soa.mediator.resequencer - Oracle Mediatorのリシーケンサ処理に関連するすべて(ロッカーとワーカーのインフラストラクチャ、グループおよびシーケンサIDの式の評価など)を記録します。

- oracle.soa.mediator.resequencer.besteffort - ベスト・エフォート戦略のリシーケンサ用(特に、ステージング処理のロック)。

- oracle.soa.mediator.resequencer.fifo - FIFO戦略のリシーケンサ用。

- oracle.soa.mediator.resequencer.standard - 標準戦略のリシーケンサ用。

- oracle.soa.mediator.service - Oracle Mediatorの様々なメッセージ交換パターン(一方向、双方向、同期、非同期など)の処理に関連するイベントが記録されます。

- oracle.soa.mediator.service.common.functions - Oracle MediatorのXPath拡張関数に関連するログ

- oracle.soa.mediator.service.filter - ルーティング・ルールのフィルタ基準の評価。

- oracle.soa.mediator.service.transformation - 変換に関連するイベントが記録されます(変換前および変換後のペイロードなど)。

- oracle.soa.mediator.serviceEngine - Oracle Mediatorサービス・エンジンのライフサイクル・イベントが記録されます。また、Oracle Mediatorのメッセージの入出力も記録されます。

Oracle BPEL Process Manager

- oracle.soa.bpel

- oracle.soa.bpel.console

- oracle.soa.bpel.engine

- oracle.soa.bpel.engine.activation

- oracle.soa.bpel.engine.agents

- oracle.soa.bpel.engine.bpel

- oracle.soa.bpel.engine.compiler

- oracle.soa.bpel.engine.data

- oracle.soa.bpel.engine.delivery

- oracle.soa.bpel.engine.deployment

- oracle.soa.bpel.engine.dispatch

- oracle.soa.bpel.engine.sensor

- oracle.soa.bpel.engine.translation

- oracle.soa.bpel.engine.ws

- oracle.soa.bpel.engine.xml

- oracle.soa.bpel.entity

- oracle.soa.bpel.jpa

- oracle.soa.bpel.system

Oracle BPM Suite

oracle.bpm.bpmn.engine

Oracle B2B

- oracle.soa.b2b.apptransport - ランタイム・ロガー

- oracle.soa.b2b.engine - ランタイム・ロガー

- oracle.soa.b2b.transport - ランタイム・ロガー

- oracle.soa.b2b.ui - ユーザー・インタフェース・ロガー

- oracle.soa.b2b.repository - リポジトリ・アクセスの詳細なロガー

Oracleアダプタ

oracle.soa.adapter

Oracle Web Services Manager (OWSM)

oracle.wsm - デフォルトでは、「ERROR」レベルに設定されており、すべてのWSM-0xxxxエラーが記録されます。「TRACE:32」に設定すると、かなり詳細なログが記録されます。

4. 「Oracle Diagnostic Loggingレベル(Javaレベル)」リストから、ロガーレベルを次のいずれかの設定に変更します。

- TRACE:1 (FINE)

- TRACE:16 (FINER)

- TRACE:32 (FINEST) - 最も詳細なレベル(トラブルシューティングのために推奨)

変更が有効になるまで数分かかります。

Oracle Business Activity Monitoring (BAM)ログの監視の詳細は、第25.6項「Oracle BAMのログの監視」を参照してください。Oracle User Messaging Service (UMS)ログの監視の詳細は、第28.2項「ログ・ファイルの表示」を参照してください。

B.1.1 すべての管理対象サーバーからのログ・ファイルおよびスレッド・ダンプ

表B-1に、確認するログ・ファイルと取得するスレッド・ダンプを示します。

表B-1 ログ・ファイルとスレッド・ダンプ

出力

説明

サーバー診断ログ

次のファイルを確認します。

$DOMAIN_HOME/servers/server_name/logs/server_name-diagnostic.log

たとえば、server_nameがsoa_server1の場合は、soa_server1-diagnostic.logです。

これは、ログ出力を入手できる場所です。デフォルトでは、最新分100 MBの診断ログのみが保持されます。

サーバー・ログ

server_name.log (たとえば、server_nameがsoa_server1の場合は、soa_server1.logです)

サーバー・コンソールの出力

<stdout>も役に立ちます(特に、デプロイおよびパッチの問題の場合)。

サーバーのスレッド・ダンプ

オペレーティング・システムのコマンド・プロンプトで、次のように入力します。

kill -3 managed_server_process_ID

また、Oracle WebLogic Server管理コンソールを使用することもできます。

1. Oracle WebLogic Server管理コンソールのナビゲーション・ツリーで、「環境」→「サーバー」の順に選択します。

2. 表の中から、サーバーを選択します。

3. 「監視」タブを選択します。

4. 「スレッド」タブを選択します。

5. 「スレッド・スタックのダンプ」をクリックします。

出力がコンソール・ログに表示されます。

OWSMメッセージ・ログ

次のログに、ネットワーク上のすべてのSOAPメッセージがキャプチャされます。

$DOMAIN_HOME/servers/server_name/logs/owsm/msglogging/diagnostic.log

このログは、デフォルトでは無効になっています。このログを有効にするには、次の手順を実行します。

1. 「Fusion Middleware Control」→「WebLogicドメイン」→「Webサービス」→「ポリシー」の順に移動します。

2. ログを有効にするセキュリティ・レベルを選択します。

3. ポリシーを編集して、ログのアサーションを有効にします。

B.2 パラレル・パージと表のパーティション化の問題

この項では、パラレル・パージと表のパーティション化の問題をトラブルシューティングする方法について説明します。監査レベルの推奨事項も示します。

詳細は、第10章「データベース増分の管理」を参照してください。

B.2.1 パラレル・パージ・スクリプトの実行

この項では、Oracle SOA Suiteデータベースが管理されておらず、領域を再利用する必要がある状況について説明します。また、この項では、日々の通常の実行に適切なパラメータ設定の識別方法についても説明します。

領域の再利用を試行する際は、パージ・スクリプトを頻繁に実行して、作成されているより大幅に多くのSOAコンポジット・アプリケーションを削除する必要があります。これは、長い待機キューを回避するために監視する必要があるホストおよびデータベース・リソースに影響を与えます。

削除するSOAコンポジット・アプリケーションの目標数は、明確に定めておくことが必要です。そうしないと、パージ・スクリプトが過度に強力に構成される可能性があります。次の内容について説明します。

- 並列度値の指定

- 削除するSOAコンポジット・アプリケーションの解析

- パラレル問合せスレーブの使用

- パージ操作のデバッグとトレース

B.2.1.1 並列度値の指定

適切な並列度(DOP)値を指定する際は、ハードウェア・リソースを考慮する必要があります。DOPは、データベースによってスケジュールされるジョブの数と、ホスト上で同時に実行されるプロセスの数を識別します。

パラレル・パージ・ジョブはI/O集中型です。これは、CPUのみに負荷がかかるのではないことを意味します。ただし、次の式は出発点で、この後で、なんらかの増分を識別するためのテストと監視が必要とされます。

DOP <= PARALLEL_THREADS_PER_CPU x CPU_COUNT

パージ・ジョブは同時に実行されますが、実際にはリソースの競合を回避するために、30秒ずつ遅延させて実行されます。パージ・ジョブが同じSOAコンポジット・アプリケーションをめぐって競合することはないので、この遅延は小さな競合を回避するためではありません。この遅延は、パージ・ジョブの経過時間と関係します。たとえば、DOPが10の場合は、10番目のパージ・ジョブが270秒間スリープしてから開始することを意味します(つまり、(DOP - 1) * 30 sec)。

大きなDOP数を指定した場合は、max_runtimeパラメータを適切に設定する必要があります。

B.2.1.2 削除するSOAコンポジット・アプリケーションの解析

領域を再利用する際は、当然のことながら、パージ・スクリプトの各実行でできるだけ多くのSOAコンポジット・アプリケーションを削除したいと考えます。しかし、スクリプトは適切なSOAコンポジット・アプリケーションのデータを解析する必要があり、これはパージの経過時間を独占する可能性があります。

そのため、日付およびmax_countパラメータを適度に設定して頻繁にパージ・スクリプトを実行することで、このデータを削減する必要があります。これを削減するには、パラレル・パージを頻繁に、おそらく1時間に2回程度スケジュールすることが必要です。

解析するSOAコンポジット・アプリケーションのセットは、次のパラメータによって識別されます。

- min_creation_date

- max_creation_date

- retention_date

- max_count

解析の経過時間を短縮するには、適度なmax_countパラメータ設定が最も効果的な方法です。出発点としてmax_countパラメータを小さく(50,000程度に)設定し、少しずつ増加して最適な値を見つけてください。表のサイズを縮小すると、max_countパラメータと日付の範囲を増加させることができます。

注意:

この削減方法は常に有効ではありません。より大量のデータを解析するために、パラレル問合せを使用することが必要な場合もあります。

B.2.1.3 パラレル問合せスレーブの使用

削減候補のSOAコンポジット・アプリケーションの解析は、主として複数のINSERT ... SELECT文によって実行されます。解析するSOAコンポジット・アプリケーションのセットが大きくなるほど、データベースのコストベースのオプティマイザは全表スキャンの実行を支持するようになります。表の大きな部分を通過する必要がある場合は、マルチブロックI/Oコールを実行する全表スキャンを実行するほうが索引アクセスよりも高速になる可能性があります。

パラレル問合せは、複数スレーブ・プロセスにわたって作業を調整および分散させることで、全表スキャンのパフォーマンスを大幅に改善できます。さらに、INSERTの部分のPARALLELヒントが、APPENDモードで実行されます。これはダイレクト・パス挿入によってパフォーマンスをさらに向上させます。

スケジュールされたパージ・ジョブと同様に、パラレル問合せスレーブはI/O集中型で、CPUのみに負荷がかかるわけではありません。ただし、PARALLELヒントのDOPを選択する際は、次の式を出発点とすると役立ちます。

DOP <= PARALLEL_THREADS_PER_CPU x CPU_COUNT

注意:

パラレル・パージ・ジョブの数を識別するためのDOP設定と、パラレル問合せスレーブの数を識別するためのDOP設定があります。これらのDOP設定は両方とも、ホスト上で実行されるプロセスの量を左右しますが、同時にではありません。INSERT ... SELECT文が最初に実行されてデータの解析が行われ、その後でパラレル・パージ・ジョブのスケジューリングが実行されます。

INSERT... SELECT文では、PARALLELヒントを、INSERTキーワードまたはSELECTの後、あるいは両方の後に指定できます。したがって、INSERT操作とSELECT操作の並列処理は互いに独立しています。文全体の適切なDOPは、次の優先順位ルールを使用して識別されます。

- 文のINSERT部分のPARALLELヒント。

- セッションの設定。

- INSERT表のDOP。

- 文内の任意の表の最大DOP設定。

パラレルDMLを実行するには、スクリプト内で次の文を実行する必要があります。

ALTER SESSION FORCE PARALLEL DML STATEMENT

たとえば、この文のDOPは、INSERTでは2、SELECTでは4となっています。しかし、優先順位ルールに従うと、文全体のDOPは2になります。

INSERT /*+ PARALLEL(TBL_INS,2) */ INTO TBL_INS
SELECT /*+ PARALLEL(TBL_SEL,4) */ * FROM TBL_SEL;

注意:

必要な場合は、パージ・スクリプト内でDELETEおよびSUBSELECTコマンドにパラレル問合せを適用することもできます。

B.2.1.4 パージ操作のデバッグとトレース

この項では、デバッグとトレースの問題について説明します。

B.2.1.4.1 パージ操作のデバッグ

パージ・スクリプトには、各操作に関する詳細なタイムスタンプ付きの情報を提供するDEBUGフラグが装備されています。この情報を評価して、削除が困難なためにパージ・スクリプトの外部で表パーティション化によって管理したほうが適している表を識別できます。DEBUGフラグを設定する手順は次のとおりです。

1. デバッグ・ログを書き込むオペレーティング・システム・ディレクトリを作成します。

mkdir -p /,,/debuglogs

2. SYSDBAアカウントを使用してデータベースに接続して、データベース・ディレクトリを作成します。

SQL> CREATE OR REPLACE DIRECTORY SOA_PURGE_DIR AS '/../DEBUGLOGS';

3. Oracle SOA Suiteスキーマ所有者に権限を付与します。

SQL> GRANT READ, WRITE ON DIRECTORY SOA_PURGE_DIR TO DEV_SOAINFRA;

4. Oracle SOA Suiteスキーマ所有者として接続して、DEBUGフラグを設定します。

cd MW_HOME/SOA_ORACLE_HOME/rcu/integration/soainfra/sql/soa_purge/
SQL> @DEBUG_ON.SQL;

5. パージ・スクリプトを実行します。

SQL> SET SEVEROUT ON
SQL> EXECUTE_PURGE

注意:

または、SQL*Plus SPOOLコマンドを使用して、デバッグ情報をキャプチャします。

パージの期間に関する自動ワークロード・リポジトリ(AWR)レポートも、経過時間と実行時間が最もかかるSQLの識別に役立ちます。

B.2.1.4.2 パージ操作のトレース

パラレル・パージ・スクリプトのパフォーマンスを診断するためにSQLトレースが必要とされる場合は、次が必要となります。

1. プロシージャsoa.delete_instances_in_parallelとsoa.delete_insts_in_parallel_jobを編集して、SQLトレース(10046)を追加します。

SQL> EXECUTE IMMEDIATE 'ALTER SESSION SET EVENTS ''10046 TRACE NAME CONTEXT
FOREVER,LEVEL 12''';

注意:

すべての引用符は一重引用符です。

これによってパージ・セッションとスケジュールされたパージ・ジョブ(J000)のSQLトレースが、データベースのユーザー・ダンプの宛先に作成されます。

SQL> SHOW PARAMETER DUMP

2. トレース・ファイルで文字列dbms_scheduler.create_jobまたはdelete_instances_in_parallelを検索することで、メイン・データベース・セッションのトレースを識別します。

grep -i dbms_scheduler.create_job *

例:

TESTORA2_ora_3893.trc

スケジュールされたジョブの数はDOPによって異なります。たとえば、DOPが4の場合は、次のようになります。

- TESTORA2_j000_9585.trc

- TESTORA2_j001_9587.trc

- TESTORA2_j002_9604.trc

- TESTORA2_j003_9606.trc

パラレル問合せスレーブをパージ・スクリプトにカスタマイズすると、それぞれにトレース・ファイル(P000)が作成されます。パラレル問合せトレース・ファイルの重要度は低くなります。なぜなら、他方のトレース・ファイルの問合せ計画がそれらの実行の説明を行うからです。例:

PSOAORA2_p000_4284.trc

3. トレース・ファイルでTKPROFを実行し、経過時間でソートして最もコストの大きなSQLを識別します。

TKPROF TESTORA2_ORA_3893.TRC ../OUT/ TESTORA2_ORA_3893.OUT WAITS=YES
SYS=YES AGGREGATE=YES SORT=EXEELA

TKPROFの詳細は、『Oracle Databaseパフォーマンス・チューニング・ガイド』を参照してください。

B.2.2 Oracle SOA Suiteの表のパーティション化

Oracleの表のパーティション化では、大きな表をパーティションと呼ばれるより小さく扱いやすいセグメントに分解することで、大きな表のメンテナンスに関する多くの問題に対処します。SOAスキーマには、Oracleデータベースのレンジ・パーティション化を利用するためのパーティション・キーが装備されています。

パーティション化の詳細は、第10.4項「コンポーネント表のパーティション化」を参照してください。

B.2.2.1 参照整合性および同一レベル・パーティション化

パフォーマンス上の理由から、Oracle SOA Suiteサービス・コンポーネント(Oracle B2Bを除く)には、参照整合性を規制するための外部キー制約はありません。この制約がない場合、マスター表と詳細表の関係は、詳細表の不確定な参照を回避するように保護する必要があります。

同一レベル・パーティション化は、マスター表と詳細表をその外部キー制約に基づいてパーティション化するデータベース・パーティション化機能です。この機能は、関連するマスター行と詳細行を同じ日付範囲にグループ化する表パーティションを作成します。このグループ化によって、パーティションが削除された場合に不確定な参照が作成されることがなくなります。

この機能を模倣するために、Oracle SOA SuiteにはSOAコンポジット・アプリケーション・インスタンスの作成日をコンポーネントのマスター表(Oracle BPEL Process Manager、Oracle Mediatorおよびヒューマン・ワークフロー)にプッシュ・ダウンする機能が装備されています。SOAインフラストラクチャは、他のすべてのコンポーネントが依存する最上位のコンポーネントであるため、この方法ではすべての依存行が日付範囲によってグループ化されます。

たとえば、COMPOSITE_INSTANCE表のCREATED_TIME列のタイムスタンプは、次の表にプッシュ・ダウンされます。

- Oracle BPEL Process Managerマスター表CUBE_INSTANCEの列CPST_INST_CREATED_TIME、その後これはCUBE_SCOPE.CI_PARTITON_DATEといった依存表にプッシュ・ダウンされます。

- Oracle Mediatorマスター表MEDIATOR_INSTANCEの列COMPOSITE_CREATION_DATE、その後これはMEDIATOR_CASE_INSTANCE.MI_PARTITION_DATEといった依存表にプッシュ・ダウンされます。

注意:

- 依存表はそのマスターを使用してパーティション化する必要があり、どの場合も、最上位のSOAインフラストラクチャであるCOMPOSITE_INSTANCE表はパーティション化する必要があります。

- 同一レベル・パーティション化を完了するには、すべての表パーティションは同じ名前と日付範囲を使用する必要があります。

要約すると、同一レベル・パーティション化とは、関連付けられた依存表の行が、それらのマスター表の行と同じパーティション・キー範囲を持つ1つのパーティションに存在することを意味します。したがって、同一レベル・パーティションのそれぞれの詳細行の状態は、その行に関連するマスター表の行から推測できます。

B.2.2.2 SOAコンポジット・アプリケーションのレンジ - ハッシュ・パーティション

レンジ・パーティションではその行をサブパーティションにハッシュして、SOAコンポジット・アプリケーションのレンジ - ハッシュ・パーティション化を実装できます。ハッシュ・サブパーティションはI/Oの分散において効果がある可能性がありますが、Oracle SOA Suiteの表をパーティション化する際は現在推奨されていません。

キーのハッシュは等価性の述語(=、IN)と一緒に使用すると効果のある方法で、Oracle BPEL Process Manager CIKEY表など、候補として適したキー付きの表がいくつか存在します。ただし、レンジ - ハッシュ・パーティションだけでは、ハッシュ・キーの一意性を提供しません。コストベースのオプティマイザが一意性を識別するには、問合せで表の全パーティションを検索する必要があります(全表スキャン)。パーティション・プルーニングは検索するパーティションの範囲を絞り込むことで役立ちますが、Oracle SOA Suiteではこの機能は使用されません。(第B.2.2.5項「パーティション・プルーニング」を参照。)したがって、コストベースのオプティマイザが一意性を識別する際に全表スキャンを回避するために、索引が検索されてハッシュ・サブパーティションがバイパスされます。

B.2.2.3 時間隔パーティション化

時間隔パーティション化はレンジ・パーティション化の拡張で、必要に応じてパーティションを自動的に作成するようにデータベースに指示します。

検証スクリプトは現在、グループのすべての表でパーティション名が同じであることを要求します。時間隔パーティション化システムは、パーティションごとに異なるパーティション名を生成します。したがって、これはサポートされません。

B.2.2.4 グローバル・ハッシュ索引

グローバル・ハッシュ索引の使用は、Oracle SOA Suiteの表のパーティション化とは独立しています。

Oracle SOA Suiteは絶え間なく行を挿入し、索引キーの多くは単調増加します。BTREE構造の索引はこれらのキーを挿入し、Oracle Real Application Clusters (Oracle RAC)の設定全体で非常にホットになる可能性がある数個のデータベース・ブロックのみをターゲットにします。これは通常AWRレポート内で、過剰なバッファ・ビジー待機として示されます。多数のデータベース・ブロックにわたって索引キーをランダムに分散させるために、グローバル・ハッシュ索引を使用します。

B.2.2.5 パーティション・プルーニング

レンジ・パーティション・キーが述語として使用されている場合は、オプティマイザは検索するパーティションの数をプルーニングできます。Oracle SOA Suiteおよび特にOracle Enterprise Manager Fusion Middleware Controlは、現在SQL問合せでパーティション・キーを使用しないので、このパフォーマンス機能を利用しません。

同一レベル・パーティション化の要件によって、パーティション・キーは、コンポーネントの作成日ではなくSOAコンポジット・アプリケーションの作成日を使用して移入されます。コンポーネント(Oracle BPEL Process Manager、Oracle Mediatorおよびヒューマン・ワークフロー)には自らの作成日があり、これはコンソールの問合せで使用されます。

Oracle BPEL Process Managerの例としては、次のようなものがあげられます。

- パーティション・キー: 表CUBE_INSTANCE 列CPST_INST_CREATED_TIME

- 作成日: 表CUBE_INSTANCE 列CREATION_DATE

B.2.2.6 パーティションのパージ

特に行移行スクリプトを使用したときは、パーティション化された表をパージすることが必要になる場合があります。これは、メンテナンスのために表のパーティション化を行うという目的にそぐわないことで、ALTER TABLE ... DROP PARTITIONコマンドによってデータが一括して削除される可能性があります。

パーティション化された表をパージしようとすると、多くの場合、解析パフォーマンスの問題が発生します。パーティションをパージする必要がある場合は、パーティションの縮小も行ってください。詳細は、第9.5項「領域管理の理解」を参照してください。

B.2.3 監査レベルの低減

この項では、Oracle SOA Suiteスキーマに書き込まれるデータとSOAコンポジット・アプリケーションの監査レベルを下げる方法についてのチューニング情報を提供します。

B.2.3.1 本番環境の監査レベルの設定

Oracle Enterprise Manager Fusion Middleware Controlの「SOAインフラストラクチャの共通プロパティ」ページで、すべての本番環境の「監査レベル」を「本番」に設定します。 これは、本番でのすべてのOracle SOA Suiteドメインの標準設定です。それぞれのコンポーネントは、SOAコンポジット・アプリケーションのレベルとは独立して設定できます。ただし、「本番」が最小設定になります。「監査レベル」を「開発」から「本番」に変更すると、(個々のコンポーネントの監査設定をチューニングしないで)パフォーマンスを改善できます。

監査を無効にすると(ビジネス環境でそれが可能な場合)、パフォーマンスが大幅に向上します。「本番」を「オフ」に変更すると、(個々のコンポーネントの監査設定をチューニングしないで)パフォーマンスを改善できます。ただし、監査を無効にできない場合は、次の手順に従って監査レベルを下げることをお薦めします。

監査証跡が不要な同期BPELコンポーネントの場合は、次の設定を使用します。

- inMemoryOptimization = true

- completionPersistPolicy = faulted

このように設定すると、同期プロセスはインスタンス・フォルトが発生した場合のみ監査証跡に表示されます。

inMemoryOptimizationおよびcompletionPersistPolicyの設定の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の「デプロイメント・ディスクリプタのプロパティ」に関する章を参照してください。

「監査レベル」の設定の詳細は、第3.1項「SOAインフラストラクチャ・プロパティの構成」を参照してください。

注意:

これらの設定は同期BPELプロセスに使用し、どのタイプであっても非同期BPELプロセスには使用しないでください。

B.2.3.2 インスタンス状態のトラッキングの無効化

インスタンス状態のトラッキングを無効にすることで、監査レベルを下げることができます。「SOAインフラストラクチャの共通プロパティ」ページで「コンポジット・インスタンスの状態をキャプチャ」チェック・ボックスを選択解除します。これには、次の利点があります。

- データベースに状態がキャプチャされないことによるパフォーマンスの向上。

- データベース内のパージするデータの減少。

これによって、Oracle Enterprise Manager Fusion Middleware Controlには依然としてSOAコンポジット・アプリケーション・インスタンスが表示されても、インスタンスの状態は疑問符(?)で示されるようになります。したがって、SOAコンポジット・アプリケーションが完了したかどうかをOracle Enterprise Manager Fusion Middleware Controlから識別することはできません。状態列には、SOAコンポジット・アプリケーション内の個々のコンポーネント(Oracle Business Process Management、Oracle BPEL Process Manager、ヒューマン・ワークフローのユーザー・タスク、Oracle Mediatorなど)の状態は反映されません。個々のコンポーネントの状態は、各コンポーネントのページ(たとえば、Oracle Enterprise Manager Fusion Middleware Controlの「soa-infra」→「サービス・エンジン」→「BPEL」)で追跡できます。

監査レベルの初期設定はグローバル監査設定を継承する「継承」であるため、各コンポーネントには固有の監査レベルも設定できます。これらの設定は、Oracle Enterprise Manager Fusion Middleware Controlで、「soa-infra」→「SOA管理」→「BPMNプロパティ」、「BPELプロパティ」または「メディエータ・プロパティ」を選択することで設定できます。

SOAコンポジット・アプリケーションの監査レベルを設定することで、監査をさらに調整できます。これはデフォルトでは「継承」に設定されており、それぞれのコンポーネントの監査レベルを継承します。たとえば、次のプロパティを次のように設定します。

- 「SOAインフラストラクチャの共通プロパティ」ページで「監査レベル」を「本番」に設定します。

- 「コンポジット・インスタンスの状態をキャプチャ」チェック・ボックスを選択解除します。

- 「BPELサービス・エンジン・プロパティ」ページで「監査レベル」を「最小」に設定します。

- SOAコンポジット・アプリケーションの「監査レベル」を「継承」に設定します。

- inMemoryOptimizationとcompletionPersistPolicyをそれぞれtrueとfaultedに設定します(同期プロセスのみ)。

これらの設定によってSOAコンポジット・アプリケーションのデータ・トラフィックが減少し、パージ時間が改善されます。

「SOAインフラストラクチャの共通プロパティ」ページの「監査レベル」の設定と「コンポジット・インスタンスの状態をキャプチャ」チェック・ボックスの選択解除の詳細は、第3.1項「SOAインフラストラクチャ・プロパティの構成」を参照してください。

inMemoryOptimizationおよびcompletionPersistPolicyの設定の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の「デプロイメント・ディスクリプタのプロパティ」に関する章を参照してください。

B.3 接続およびトランザクション・タイムアウトのトラブルシューティング

この項では、接続およびトランザクション・タイムアウトの問題をトラブルシューティングする方法について説明します。

B.3.1 接続タイムアウトの解決

次のような状況では、接続タイムアウト・エラーが発生する可能性があります。

- 処理に30秒以上かかる大きなペイロードのSOAコンポジット・アプリケーションを実行する場合。

- Oracle Enterprise Manager Fusion Middleware Controlの「Webサービスのテスト」ページから、大きいペイロードを使用してストレス・テストを起動している場合。

- ファイル・アダプタ・サービスを使用して、コンポジットに大量のメッセージ・ファイル(100万)を渡している場合。

- Oracle Enterprise Manager Fusion Middleware Controlでインスタンス数とフォルト数のメトリックを取得している場合。

トランザクション・タイムアウト・プロパティを増加して、タイムアウト・エラーの発生を回避する手順は、次のとおりです。

1. Oracle WebLogic管理コンソールにログインします。

2. 「JTA」をクリックします。

3. 「タイムアウト」の値を変更します(デフォルトは30です)。

4. 「保存」をクリックします。

5. Oracle WebLogic Serverを再起動します。

B.3.2 データベース接続値を増やす

データベースへの接続が遅いと、例B-1のエラー・メッセージが表示される場合があります。

例B-1 低速なデータベース接続によるエラー

Exception [TOPLINK-4002] (Oracle TopLink - 11g Release 1 (11.1.1.1.0) (Build
090304)): oracle.toplink.exceptions.DatabaseException
Internal Exception: java.sql.SQLException: Internal error: Cannot obtain
XAConnection weblogic.common.resourcepool.ResourceDeadException: Pool
SOADataSource has been disabled because of hanging connection tests, cannot
allocate resources to applications.

このことが発生した場合は、次の手順を実行します。

1. DOMAIN_HOME\bin\setSOADomainEnv.cmdファイルを開きます。

2. 太字で表示されている行を非コメント化します。

# 8331492: Value of weblogic.resourcepool.max_test_wait_secs is 10
# seconds. It can be increased by uncommenting line below if your database
# connections are slow. See SOA documentation for more details.
EXTRA_JAVA_PROPERTIES="${EXTRA_JAVA_PROPERTIES}
-Dweblogic.resourcepool.max_test_wait_secs=30"
export EXTRA_JAVA_PROPERTIES

3. 変更を保存して、管理対象のOracle WebLogic Serverを再起動します。

B.3.3 SOAインフラストラクチャの障害後にデプロイメント・アーカイブのEJBトランザクション・タイムアウト値を更新する

Oracle WebLogic Server管理コンソールの「デプロイメント」→展開されたSOAインフラストラクチャ・アプリケーション→「FacadeFinderBean」→「構成」タブで、「FacadeFinderBean」プロパティのトランザクション・タイムアウト値を更新すると、SOAインフラストラクチャの再起動後に例B-2のエラーが発生することがあります。

例B-2 EJBトランザクション・タイムアウト・エラー

java.lang.IllegalArgumentException: Cannot convert value of type [$Proxy223
implementing
oracle.bpel.services.workflow.verification.IVerificationService,org.springframe
work.aop.SpringProxy,org.springframework.aop.framework.Advised]
to required type
[oracle.bpel.services.workflow.verification.IVerificationService] for
property 'verificationService': no matching editors or conversion strategy found
Message icon - Warning Errors were encountered while performing this operation.

また、SOAインフラストラクチャのステータスも失敗として表示されます。

このエラーはFacadeFinderBeanに固有のものではありません。SOAインフラストラクチャ・アプリケーションの一部であるすべてのEJBにも当てはまります。

このエラーを解決するには、デプロイメント・アーカイブのトランザクション・タイムアウト設定を手動で変更する必要があります。

トランザクション・タイムアウト設定を更新する手順は、次のとおりです。

1. デプロイメント・アーカイブでfabric-ejb.jarファイルを開きます。

2. META-INF/weblogic-ejb-jar.xmlファイル内のトランザクション・タイムアウト値を大きくします。

3. JARファイルを作成しなおします。

4. 第3.2項「管理対象サーバーとSOAインフラストラクチャの停止と起動」の説明に従って、SOAインフラストラクチャが含まれている管理対象サーバーを再起動します。

注意:

この問題は、SOAインフラストラクチャの一部としてデプロイされたEJBを更新するときにも発生することがあります。この問題が発生した場合は、それらのEJBに含まれている対応するJARファイルを同様の方法で更新する必要があります。

B.3.4 リモートWebサービスへの長時間実行される同期コールによるエラーの発生または非同期トランザクションの長時間後のエラー・リターン

リモートWebサービスに対して長時間実行した同期コールが、JTAトランザクション・ロールバック・エラーで終了する場合があります。(SOAサーバーに対するコールなど)非同期コールを行うトランザクションを実行すると、アプリケーションがエラーを返す場合もあります。サーバー・ログには、この動作の原因となる可能性があるJTAトランザクション・タイムアウトが示されます。

Oracle WebLogic Server管理コンソールで、JTAトランザクションのタイムアウトをチェックする手順は次のとおりです。

1. Oracle WebLogic Server管理コンソールにログインします。

2. 「ドメイン構造」で、「サービス」→「JTA」の順に選択して、タイムアウト値をチェックします。
トランザクションが30秒を超えると常にタイムアウトする場合に、それがカスタム・コンポジット同期クライアント呼出しの場合は、設計アプローチを再検討する必要があります。場合によっては、非同期トランザクションとして外部Webサービスを呼び出す方法が最善となります。

長時間実行される同期トランザクションをサポートするためにJTAを増加させることは、単なる暫定的なメカニズムです。JTAトランザクション・タイムアウト設定の変更の詳細は、第B.3.1項「 接続タイムアウトの解決」を参照してください。

3. 同期クライアントの呼出しに長時間がかかる場合は、システムにパフォーマンスの問題がないかどうかをチェックして、それらの解決を試みます。

4. JTAタイムアウト設定との関連でsyncMaxWaitTimeプロパティとBPELのEJBトランザクション・タイムアウト設定の適切な値をチェックした後でのみ、必要に応じてJTAタイムアウトの値を増加します。
syncMaxWaitTimeプロパティの表示および変更の詳細は、第13.1項「BPELプロセス・サービス・エンジン・プロパティの構成」を参照してください。

5. BPEL EJBトランザクション・タイムアウト設定を表示および変更するには、次の手順を実行します。

1. Oracle WebLogic Server管理コンソールにログインします。

2. 「ドメイン構造」で、「デプロイメント」をクリックします。

3. 「soa-infra」→「EJB」を開きます。

4. 次のEJBを更新します。
- BPELActivityManagerBean

- BPELDeliveryBean

- BPELDispatcherBean

- BPELEngineBean

- BPELFinderBean

- BPELInstanceManagerBean

- BPELProcessManagerBean

- BPELSensorValuesBean

- BPELServerManagerBean

5. 「保存」をクリックします。

6. Oracle WebLogic Serverを再起動します。

6. 非同期トランザクションについては、BPEL EJBトランザクション・タイムアウトとJTAトランザクション・タイムアウトの両方の値をチェックして、必要に応じて調整します。

B.4 ランタイム診断のトラブルシューティング

この項では、ランタイムの問題をトラブルシューティングする方法について説明します。

B.4.1 「WSDLを読み取れません」というOracle SOA Suite実行時エラー

エンドポイントを参照できない場合、または不適切なデプロイメント・プラン・ファイルを使用してコンポジットがデプロイされている場合は、次のエラーが表示されます。

oracle.fabric.common.FabricException: Cannot read WSDL

この問題を診断する手順は次のとおりです。

1. 参照用のエンドポイントが稼働していることを確認します。
WSDLまたはエンドポイントがエラーに示されます。そこで、Oracle Enterprise Manager Fusion Middleware Controlからサービスを参照して、それがアクティブかどうかをチェックできます。サービスがアクティブでエンドポイントが到達可能であったら、SOAインスタンスを検索して、Oracle Enterprise Manager Fusion Middleware ControlのBPELプロセス・サービス・エンジンの「リカバリ」タブでそれを再試行します。

2. 拡張やカスタマイズの場合は、デプロイメント構成プランで適切なURLが更新されていることを確認します。
sca_extractPlanを使用してプランを抽出する例を含むデプロイメント・プランの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のデプロイメント前のターゲット環境向けのアプリケーションのカスタマイズに関する項を参照してください。

B.4.2 BPELインスタンスの自動リカバリで特定インスタンスがリカバリされない

BPELプロセスには、未解決の起動メッセージやコールバック・メッセージ、指定のしきい値の時間に完了していないアクティビティなど、リカバリ可能なアクティビティを自動的にリカバリしようとする自動リカバリ機能が装備されています。ただし、自動リカバリ機能は、数個のインスタンスのリカバリのみを試行し、固定された回数だけ再試行します。一部のインスタンスが自動的にリカバリされない場合は、自動リカバリ・パラメータの構成によってそれらのインスタンスはピックアップされないと考えられます。

この問題を解決する手順:

- 自動的にリカバリするメッセージの最大数を設定します。
デフォルトでは、Oracle BPEL Process Managerの自動リカバリ機能は、それぞれのリカバリ試行ごとに送信する50件のメッセージを処理します。これはmaxMessageRaiseSizeプロパティによって制御されます。

1. ナビゲーション・ペインで、「soa-infra」(SOA_cluster_name)を右クリックします。

2. 「SOA管理」→「BPELプロパティ」→「詳細BPEL構成プロパティ」→「RecoveryConfig」の順に選択します。

3. 「RecurringScheduleConfig」→「maxMessageRaiseSize」と「StartupScheduleConfig」→「maxMessageRaiseSize」の両方を開きます。
それぞれのデフォルト値は50です。負の値に設定すると、データベースから選択されたすべてのメッセージがリカバリのために送信されます。0(ゼロ)の値を指定すると、メッセージはデータベースから選択されません(事実上のリカバリの無効化)。50を超えるメッセージをリカバリするには、その値にプロパティ値を設定します。サーバーに対するリカバリの影響を制限するには、このプロパティを使用します。

- 1つのメッセージに対して自動リカバリを試行する最大回数を設定します。
また、同じリカバリ可能インスタンスで実行する自動リカバリ試行の回数も構成できます。入力した値によって、起動メッセージおよびコールバック・メッセージがリカバリされる最大回数が指定されます。値が0(デフォルト値)の場合、すべてのメッセージがリカバリされます。1つのメッセージに対するリカバリ試行の数が、指定された値を超過すると、そのメッセージにはリカバリ不能のマークが付けられます。

Oracle Enterprise Manager Fusion Middleware Controlで起動メッセージとコールバック・メッセージの自動リカバリ試行を構成する手順は次のとおりです。

1. ナビゲーション・ペインで、「soa-infra」(SOA_cluster_name)を右クリックします。

2. 「SOA管理」→「BPELプロパティ」→「詳細BPEL構成プロパティ」の順に選択します。

3. 「MaxRecoverAttempt」を選択し、「値」フィールドに値を入力します。

4. 「適用」をクリックします。
自動リカバリは、使用しないほうがよい場合もあります。サービスが多重呼出し不変でない場合は、破損が発生する可能性があります。さらに、自動リカバリ機能はコンポジットを、最後に保存された状態にリストアしますが、これは非同期の呼出しや待機などの直後の可能性があります。したがって、大量のリカバリを実行する前に、プロセスの動作とそれが次に何をするかを理解しておくことが重要です。大量の自動リカバリは、コンポジット・エラーの根本原因が修正された後(たとえば、利用できなかったサービスが利用可能になった後や領域不足のデータベースが修正された後など)でのみ試行してください。また、自動リカバリによって、エラー・シナリオで予期しないロードがトリガーされる可能性もあります。これにより、リモート・サーバー上でブロックするスレッド数が増加して、結果としてSOAサーバーで次々とハングが発生する可能性があります。

詳細は、第13.2項「Oracle BPEL Process Managerの自動リカバリの構成」を参照してください。

B.4.3 障害発生時に一部コンポジットは複数回再試行される

BPELプロセス・フローでエラーが発生すると、それが呼び出したすべてのアクティビティとともに再試行されます。これは望ましくない場合もあります。

プロパティGlobalTxMaxRetry(デフォルト値は3)は、再試行可能なものとしてエラーが識別されたときに実行する再試行回数を指定します。たとえば、Webサービスを数回呼び出した後で、データ・ソース・エラーによってデハイドレーションが失敗した場合は、これは再試行可能なエラーとして識別され、前のデハイドレーション状態のすべてのアクティビティが再試行されます。再試行されているアクティビティが多重呼出し不変でない場合(つまり、それらの状態が再試行ごとに変化する可能性があり、同じ動作の提供が保証されない場合)は、複数回の再試行によって問題が生じる可能性があります。

この状況を修正するには、composite.xmlファイルのパートナ・リンク設定セクションでidempotentsetをfalseに設定して多重呼出し不変でないアクティビティを明確にマークすることでコンポジットをカスタマイズして、再試行を防止します。

<property name="bpel.partnerLink.partner_link_name.idempotent">false</property>

idempotentプロパティはOracle Enterprise Manager Fusion Middleware Controlでは設定できません。

また、システムMBeanブラウザでGlobalTxMaxRetryを0に設定することもできます。

GlobalTxMaxRetryを設定する手順は次のとおりです。

1. 「soa-infra」(SOA_cluster_name)を右クリックします。

2. 「SOA管理」→「共通プロパティ」の順に選択します。

3. 「詳細SOAインフラ拡張構成プロパティ」をクリックします。

4. 「GlobalTxMaxRetry」をクリックします。

5. 「値」フィールドに、適切な値を入力します。

6. 「適用」をクリックします。

idempotentプロパティの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』のコンポジット内のBPELプロパティ・セットに関する項と『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のパートナ・リンク操作レベルでの多重呼出し不変性の管理に関する項を参照してください。

B.4.4 アプリケーション・トランザクションが完了せず、基になるコンポジットが実行状態でスタックしている

アプリケーション・トランザクションが完了しません。たとえば、注文書のステータスが処理中のままになっている、といった場合です。コンポジット・インスタンスをチェックすると、コンポジットが実行状態でスタックしていることがわかります。この場合は、コンポーネントはおそらく動作していません。多分失敗しており、リカバリが必要な場合があります。

フォルトは次のような様々な理由で発生する可能性があります。

- BPELアクティビティがエラー(たとえば、ビジネス・エラー、セキュリティ認証エラー、他のエラーなど)によって失敗した場合。

- BPELアクティビティが、利用できない外部Webサービスを呼び出した場合。

- 管理者がOracle Enterprise Manager Fusion Middleware Controlを使用してBPELアクティビティをすでに終了している場合。

- BPELアクティビティが非同期ADFサービスを呼び出して、メッセージがAQ/JMSキューでスタックした場合。

- BPELアクティビティが非同期ADFサービスを呼び出したが、Oracle SOA Suiteが利用できないために、コールバック・メッセージが到着しなかった場合。

- BPELアクティビティが同期ADFサービスを呼び出し、これに長時間かかっている場合(またはハングしている場合)。

- ネットワーク・エラーが発生した場合。

この問題を診断する手順は次のとおりです。

1. Oracle Enterprise Manager Fusion Middleware Controlにログインします。

2. ナビゲータ・ペインで、「domain_name」→「SOA」に移動します。

3. 「soa-infra」(SOA_cluster_name)をクリックします。

4. 「インスタンス」タブをクリックします。

5. コンポジット・インスタンスを検索して、インスタンスIDをクリックします。
「フローのトレース」ページが表示されます。

インスタンスが表示されない場合(および「SOAインフラストラクチャの共通プロパティ」ページで「監査レベル」が「オフ」に設定されていない場合)は、メッセージがOracle SOA Suiteの外部でスタックしていることを意味します。

メッセージがOracle Mediatorに到達したものの、BPELフローをインスタンス化していない場合は、エラーが原因でBPELインスタンスが最初からロールバックされている可能性があります。

BPELフローが存在する場合は、通常は「フローのトレース」ページの「フォルト」セクションに、根本原因をトレースできる失敗したサービスが表示されます。

6. 「トレース」セクションで、BPELプロセスをクリックします。

7. BPEL監査証跡を開いて、サービスが失敗した正確なポイントを表示します。
この情報は、BPELフロー・トレースの「フォルト」タブでも確認できます。これはまた、フォルトをリカバリできるかどうかも示します。

8. 「raw XMLの表示」リンクをクリックします。
このリンクから同じ情報を確認して、エラーを表示できます。例:

...
<message>Faulted while invoking operation "modifyUserRoles" on provider
"UserService". </message><details>
...
<tns:message>JBO-27023: Failed to validate all rows in a
transaction.</tns:message>
<tns:severity>SEVERITY_ERROR</tns:severity>
...
<message>The transaction was rolled back. The work performed for bpel instance
"451042" was rolled back to the previous dehydration point, but the audit
trail has been saved.
You can recover the instance from the recovery console by resubmitting the
callback message or activity for execution.</message

インスタンスは前のデハイドレーション・ポイントにロールバックされているため、ステータスは「実行中」のままになります。

9. 「監査証跡」タブと「フォルト」タブで、次をメモします。

- コンポジット名(例: POComposite)

- コンポーネント(例: UpdateGuid BPELプロセス)

- BPELインスタンスID(例: bpel:451042)

これはすべて、リカバリ可能なインスタンスのリカバリで使用されます。「監査証跡」ウィンドウでは、リカバリ不可能なビジネス・フォルトとしてエラーがマークされている場合がありますが、メッセージのリカバリ可能性はBPELプロセス・サービス・エンジンの「リカバリ」タブで確認できます。

10. インスタンスのリカバリを試行するには、「soa-infra」(SOA_cluster_name)を右クリックして、「サービス・エンジン」→「BPEL」を選択します。

11. 「リカバリ」タブをクリックします。

12. 「タイプ」リストから「アクティビティ」を選択します。

13. 手順9でメモしたコンポジットとコンポーネントの名前を指定して、「検索」をクリックします。

14. 固有のBPELインスタンスIDを見つけます。「リカバリ可能」とマークされているフォルトをリカバリできます。

15. 「タイプ」リストで他のリカバリ・オプションがある場合はそれをチェックします(例: 「起動」および「コールバック」)。

注意:

SOAインフラストラクチャの「フォルトと拒否メッセージ」 タブで、リカバリ可能なメッセージを検索することもできます。これは、メッセージをクリックして「リカバリ・アクション」リストから適切なアクションを選択することによって行います。

16. インスタンスがリカバリ可能とマークされていない場合は、サービスを再度呼び出すことはできません(おそらく多重呼出し不変ではないため)。場合によっては、リカバリ不可能な多重呼出し不変でないトランザクションの問題を解決するために、Oracleサポート・サービスに診断情報を提供することが必要になります。

17. BPELアクティビティが非同期ADFサービスを呼び出した場合に、メッセージがAQ JMSキューでスタックしているときは、server.logファイルとserver-diagnostic.logファイルを表示して、JRF Webサービス・インフラストラクチャがログしたメッセージ・メタデータのロギングを確認できます。
さらに、ADF診断ログは、必要に応じてデバッグにも使用できます。

1. 「ECID」フィールドを使用して、対応するADFサービス・ロギングをこれを呼び出したSOAコンポジット・アプリケーションと相関付けて追跡します。

2. Oracle Enterprise Manager Fusion Middleware Controlでログを表示する際に、「広範囲のターゲット・スコープ」ドロップダウン・リストをクリックして、「farm_name」/「domain_name」(Oracle WebLogicドメイン)を選択し、ドメイン全体のメッセージを表示します。

3. Oracle WebLogic Serverドメインの「ログ・メッセージ」ページの「選択したターゲット」セクションで、手順aで取得した値を持つ「ECID」フィールドが検索に含まれていることを確認します。

4. 実行コンテンツID (ECID)のログ・レコードを検索および表示して、問題をメモします。
1つのECIDについて、いくつかのルート・インスタンス(最上位クライアント)があります。適切なインスタンスにドリルダウンして、具体的なフォルトを探す必要があります。

5. コンポーネントが正常に完了したか、またはエラーが発生して終了したかどうかを観察します。『Oracle Fusion Middleware管理者ガイド』のログ・ファイルの表示と検索に関する項を参照してください。

トランザクションとメッセージをリカバリする様々な方法については、次の章を参照してください。

- Oracle Enterprise Manager Fusion Middleware ControlのSOAコンポジット・アプリケーション・ページからリカバリするには、第8章「SOAコンポジット・アプリケーション・インスタンスの管理」を参照します。

- BPELプロセス・サービス・コンポーネントとBPELプロセス・サービス・エンジンのメッセージ・リカバリ・ページからリカバリするには、第15章「BPELプロセスのサービス・コンポーネントとエンジンの管理」を参照します。

B.5 ヒューマン・ワークフローのトラブルシューティング

この項では、ヒューマン・ワークフローの問題をトラブルシューティングする方法について説明します。

B.5.1 タスクの割当て、ルーティングおよびエスカレーションの問題

表B-2に、タスクの割当て、ルーティングおよびエスカレーションの問題に関する症状と考えられる原因、考えられる解決策を示します。

表B-2 タスクの割当て、ルーティングおよびエスカレーションの問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

割当てが行われずにタスクが完了します。

最も多い問題は、タスクの割当て先の指定にXPath式を使用していて、その式で該当するノードが算出されないことです。その他には、参加者のスキップ条件が正しくないなどの問題が考えられます。

1. XPath式に関するすべての問題を修正します。

2. 指定されたデータのXPath式で結果が取得できることを確認します。

3. ヒューマン・タスク・エディタで、タスクの参加者の「スキップ・ルールの指定」チェック・ボックスで指定されているスキップ条件を確認します。

ビジネス・ルールでリスト・ビルダーが返されていません。

タスクの参加者の指定にビジネス・ルールを使用する場合は、ビジネス・ルールによって最低1つのリスト・ビルダーが返されることを想定しています。ビジネス・ルールで参加者が不要であることを決定する場合は、ignoreParticipant(...)関数を使用する必要があります。正しいモデルに修正しても、このエラーが表示される場合は、ルールが起動されていない可能性があります。この表の「複数のルールを定義している場合にヒューマン・ワークフロー・タスクで正しくないユーザーが選択されたり、次のメッセージのエラーが発生します」のタイトルの症状を参照してください。

1. ignoreParticipant(..)関数を使用して、ルールのモデルを作成します。

2. 最低1つのルールが起動されるように、ルールのモデルが正しく作成されていることを確認します。

ビジネス・ルールで別のタイプのリスト・ビルダーが返されています。

タスクの参加者の指定にビジネス・ルールを使用する場合は、ビジネス・ルールによって同じタイプのリスト・ビルダーが返されることを想定しています。

ルールを修正します。

複数のルールを定義している場合にヒューマン・ワークフロー・タスクで正しくないユーザーが選択されたり、次のメッセージのエラーが発生します。

Ruleset returned lists with
different list builder

ヒューマン・ワークフロー・タスクでは、実行時にユーザーのリストのフェッチを試行したときに、次のエラーが発生することがあります。

Ruleset returned lists with different list builder

このエラーは、タスク詳細コメント・フィールドに表示されます。また、タスクにより正しくないまたは想定されていないユーザーや承認者が選択されている可能性があります。これは主に、重複するルールの設定が原因で発生します。タスクの参加者の指定にビジネス・ルールを使用する場合は、ビジネス・ルールによって同じタイプのリスト・ビルダーが返されることを想定しています。

また、ルールセット内のルールは、トランザクションに対して1つのみが該当する必要があります。複数のルールが該当する場合は、最も高い優先度のルールに関連付けられているアクションが実行されます。該当する複数のルールの優先度が同じ場合は、リスト内の最初のルールが選択され、そのアクションが実行されます。

重複するルールを記述しないようにします。各リスト・ビルダーからの制約は、異なるものとし、混在させることはできません。異なるリスト・ビルダーによって複数のルールがトリガーされると、このエラーが発生します。また、1つの制約セットのみが適用されます。

ルールセット内のすべてのルールで、同じトランザクションに対して同じ優先度の複数のルールが該当しないように、優先度が定義されていることを確認してください。

詳細は、『Oracle Fusion Middleware Oracle Business Process Managementモデリングおよび実装ガイド』を参照してください。

パラレル完了基準が満たされていても、パラレル割当て先がタスクの承認または拒否を行う必要があります。

パラレル参加者のための「参加者タイプの追加」ダイアログでは、すべてのパラレル参加者が完了するまで待機するか、または基準が満たされたら完了するように、実行時のヒューマン・タスクを構成できます。

「参加者タイプの追加」ダイアログで、完了について正しい選択を行います。

グループまたはロール内の各ユーザーに個別に割り当てられるものと想定していたタスクが、グループまたはロールに割り当てられます。

タスクの割当て先にグループまたはロールが使用された場合、すぐにタスクがそのグループまたはロールに割り当てられます。タスクの実行時に、個別に割り当てられるわけではありません。グループまたはロール内のいずれかのユーザーが、そのタスクを申告して処理する必要があります。パラレル参加者またはシリアル参加者とあわせて使用した場合に、このユーザーの解決は自動的に行われるものと考えられることが多いようですが、実際はそうではありません。

グループまたはロールのメンバーに個別に割り当てるには、XPath関数のids:getUsersInGroupおよびids:getUsersInAppRoleを使用します。

タスクでルーティング・ルールまたはルールベースの参加者を評価するデシジョン・サービスを呼び出したときに、エラーが発生します。

SOAインフラストラクチャ・インスタンスで、ペイロードの検証が有効になっています。

インスタンスの「ペイロードの検証」チェック・ボックスの選択を解除します。詳細は、第3.1項「SOAインフラストラクチャ・プロパティの構成」を参照してください。

B.5.2 タスク・アクションの問題

表B-3に、タスク・アクションの問題に関する症状と考えられる原因、考えられる解決策を示します。

表B-3 タスク・アクションの問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

ユーザーがタスクのアクションを実行できません。

最も多い問題は、その時点でそのタスクのそのアクションを実行する権限をユーザーが持っていないことです。

ユーザーがタスクの割当て先、所有者または作成者のいずれかであるか、または管理者であるかどうかを確認します。ユーザーがアクションの実行を許可されている場合は、サーバー・ログ・ファイルで、タスクの状態やタスクの割当て先、タスクを取得していたユーザー、許可されていたアクション、指定のタスクでそのユーザーが担当していた役割などの情報を含む、詳細なログ・メッセージを確認します。

タスクがロックされており、Oracle BPM Worklistで更新できません。ORA-30279エラーが表示されます(基礎となるORA SQL例外のORA-20001も表示されます)。

2人のユーザーが同じタスクを同時に更新しようとしています。

他のユーザーが終了するまで待機します。

B.5.3 通知の問題

表B-4に、通知の問題に関する症状と考えられる原因、考えられる解決策を示します。

表B-4 通知の問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

タスクの電子メール通知が送信されません。

Oracle Enterprise Manager Fusion Middleware Controlの「ワークフロー通知プロパティ」ページで、「通知モード」が「なし」に設定されています。

この設定を「電子メール」または「すべて」に変更します。詳細は、第21.1項「ヒューマン・ワークフロー通知プロパティの構成」を参照してください。

電子メール通知が送信されません。

電子メール・ドライバの構成で使用されている送信サーバーの設定が正しくありません。

簡易メール転送プロトコル(SMTP)ポート、SMTPホスト、ユーザー名、パスワード、電子メールの値をチェックします。

ヒント: 値を検証するには、任意の電子メール・クライアントでこれらの値を使用してSMTPサーバーに接続します。

次の手順を実行して、Oracle Enterprise Manager Fusion Middleware Controlの設定を確認します。

1. ナビゲータで、「ユーザー・メッセージング・サービス」を右クリックします。

2. 「usermessagingdriver-email」→「電子メール・ドライバ・プロパティ」の順に選択します。

3. 設定を確認します。

通知は送信されますが、アクション可能ではありません。

アクション可能なアドレス・フィールドが構成されていません。

Oracle Enterprise Manager Fusion Middleware Controlで、アクション可能なアドレス・フィールドに有効な電子メール・アドレスを構成します。詳細は、第21.1項「ヒューマン・ワークフロー通知プロパティの構成」を参照してください。

Oracle User Messaging Serverの電子メール・ドライバで受信サーバー設定を構成したときと同じ電子メール・アドレスが使用されていることを確認します。詳細は、第21.1項「ヒューマン・ワークフロー通知プロパティの構成」を参照してください。

通知は送信されますが、アクション可能ではありません。

ヒューマン・ワークフロー・タスクがアクション可能な通知を送信するように設定されていません。

ヒューマン・タスク・エディタで(このエディタは、Oracle JDeveloperの.taskファイルをダブルクリックして起動できます)、「通知」セクションを展開し、「詳細」タブをクリックして、「通知をアクション可能にする」チェック・ボックスを選択します。

アクション可能な通知が送信されますが、応答してもアクションは実行されません。

アクション可能なアドレス・フィールドが正しくありません。

IMAPおよびPOP3のサーバーとポートの値を確認します。電子メール・ドライバの構成で、アクション可能なアドレス・フィールドが使用されていることを確認します。

ヒント: 値を検証するには、任意の電子メール・クライアントでこれらの値を使用して、IMAPサーバーまたはPOP3サーバーに接続します。

アクション可能な通知が送信されますが、応答してもアクションは実行されません。

デフォルト以外の電子メール・クライアントが通知受信用に構成されています。

ユーザーが承認リンクをクリックすると、デフォルトのメール・クライアント・ページが開き、このページで別の電子メール・サーバーに電子メールを送信できます。デフォルトの電子メール・クライアントを、アクション可能な通知を受信するように構成します。

「ワークフロー・タスク・サービス・プロパティ」ページの「アクション可能な電子メール・アカウント」フィールドに、アクション可能な受信電子メール・アカウントとして使用する正しい値を入力します。デフォルトのアカウント名は、「Default」です。

詳細は、第21.3項「ヒューマン・ワークフロー・タスク・サービス・プロパティの構成」を参照してください。

アクション可能な通知が送信されますが、応答してもアクションは実行されません。

電子メール・クライアントに、電子メール・ドライバで使用されるアカウントと同じアカウントが構成されています。

ヒューマン・ワークフローの通知サービスがメールをダウンロードして処理する前に、電子メール・クライアントによってメールがダウンロードされて既読にマークされたり、削除されている可能性があります。電子メール・クライアントから、そのアカウントを削除します。

電子メール通知でOracle BPM Worklistリンクが表示されます。

これがデフォルトの動作です。デフォルトでは、電子メール通知にはOracle BPM Worklistが表示されます。

次の手順を実行してください。

1. ヒューマン・タスク・エディタの「通知」セクションで、「詳細」タブをクリックします。

2. 「ワークリストURLを通知に表示」チェック・ボックスの選択を解除します。

グループ通知のパフォーマンスが遅いです。

グループ通知のパフォーマンスは、グループ内のメンバーの数(グループのサイズ)によって決まります。

1. LDAPでグループ用の電子メールIDを設定します。この場合、ヒューマン・ワークフローは、各グループ・メンバーに対して個別の電子メールを送信するのではなく、グループの電子メールIDに1通の電子メールを送信します。

2. ヒューマン・タスク・エディタの「通知」セクションで、「詳細」タブをクリックします。

3. すべてのグループ・メンバーに対して1通の電子メールを送信する場合は、「グループ通知構成」 リストから「すべてのユーザー・アドレスを含む電子メールを送信」を選択します。このアクションによって、すべてのメンバーが宛先リストを確認できるようになり、すべてのメンバーに同じ内容が送信されます(ロケールなどは考慮されません)。

4. 個別に電子メールを送信するが、内容を複数のメンバーで再利用する場合は、「グループ通知構成」リストから「電子メールを個別に送信」(デフォルトの選択)を選択し、「ロケールに基づいて個別のタスク・フォームを使用」の選択を解除します。このアクションによって、グループ・メンバーは、各自のロケールで個別のメールを受信できます。通知内容を作成するために生成されるタスク・フォームは、同じロケールのメンバーで再利用されます。

次のエラー・メッセージが表示される場合があります。

[2012-07-05T09:13:05.246-04:
00] [soa_server1] [ERROR] []
[oracle.soa.services.workflow
.common] [tid:
[ACTIVE].ExecuteThread: '6'
for queue:
'weblogic.kernel.Default
(self-tuning)'] [userId:
<anonymous>] [ecid:
dc2ff0568380b04f:23824bc7:13
8570a4e67:-8000-000000000000
1716,0] [APP: soa-infra] <.>
[[ORABPEL-0
at
oracle.bpel.services.workflo
w.task.notification.TaskNoti
fications.notifyForTask(Task
Notifications.java:481)
. . .
. . .

電子メール通知メッセージの本文にアポストロフィがあるかどうかをチェックします。

<%string('À titre de responsable fonctionnel, une demande d'approbation
. . .

文字列にダブル・アポストロフィを追加することで、それぞれのアポストロフィをエスケープします。たとえば、メッセージに'dが含まれている場合は、次のようにこれをエスケープします。

<%string('d'd')%>

これを次のように変更します。

<%string('d''d')%>

B.5.4 タスク・ビューの問題

表B-5に、タスク・ビューの問題に関する症状と考えられる原因、考えられる解決策を示します。

表B-5 タスク・ビューの問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

カスタム(マップ済属性)列のビューへの表示

属性マッピングは、特定のタスク・タイプに対して作成されます。マップ済属性を使用するには、ビューを1つ以上のタスク・タイプに関連付ける必要があります。

Oracle BPM Worklist (表示、作成または編集UI)の「定義」タブで、ビューに対してタスク・タイプを指定します。そのタスク・タイプのマッピングで使用されている属性ラベルが、ビューで使用可能な列として「表示」タブで使用できるようになります。

1つのビューは複数のタスク・タイプと関連付けることができます。「タスク・タイプ」ブラウザから、複数のタスク・タイプを選択できます。複数のタスク・タイプを選択した場合は、それらのすべてのタスク・タイプの属性ラベルが、そのビューで使用できるようになります。

ビューの権限受領者が、ビューの所有者に属するタスクを表示したり編集できます。

ビューがデータとして共有されています。この共有タイプでは、権限受領者が、まるでビューの所有者であるかのようにビューを使用できるため、ビューの所有者のタスクを表示して操作できます。

Oracle BPM Worklist (表示または編集UI)の「定義」タブで、「ビューの共有」が「定義のみ」に設定され、権限受領者がビューを自分のタスクに対して使用できるようになっていることを確認します。「ビューの共有」を「データ」に設定すると、権限受領者は、ビューをそのビューの所有者のデータに対して使用できるようになります。

新規標準ビューの作成

標準ビューは、管理権限を持つユーザーのみが作成できます。

1. ログインしているユーザーが管理権限を持っていることを確認します。

2. 通常どおり、Oracle BPM Worklist (作成または編集UI)を使用して、ビューを定義します。

3. 「標準ビューに追加」チェック・ボックスを選択します。
ビューが、標準ビューとして作成されます。

標準ビュー名の国際化

標準ビューの名前フィールドに指定した値をリソース・キーとして使用して、WorkflowLabelsリソース・バンドルから表示名を参照できます。

WorkflowLabelsリソース・バンドルに新規リソース・キーを追加します。このキーは、STD_VIEW.の接頭辞が付く、ビューに使用した名前です。(接頭辞の末尾にはピリオドが必要です。)

リソース・バンドルの詳細は、Oracle SOA Suiteサンプルで入手可能なワークフロー・サンプルworkflow-110-workflowCustomizationsを参照してください。

あるインスタンスで作成したビューと標準ビューの別のSOAサーバーへの移行

テストから本番への移行ユーティリティを使用する必要があります。

テストから本番への移行ユーティリティを使用すると、ユーザー・ビューと標準ビューをXMLファイルにエクスポートして、そのXMLファイルのビューを別のインスタンスにインポートできます。このユーティリティの詳細は、第23.6項「ヒューマン・ワークフロー・データのテスト環境から本番環境への移動」を参照してください。

B.5.5 タスクの属性マッピングの問題

表B-6に、タスクの属性マッピングの問題に関する症状と考えられる原因、考えられる解決策を示します。

表B-6 タスクの属性マッピングの問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

Oracle BPM Worklistで、パブリック属性へのマッピングにペイロード属性を使用できません。

Oracle BPM Worklistは、単純なペイロード属性へのマッピングの作成のみをサポートしています。Oracle BPM Worklistでのマッピングの作成では、タスク・ペイロードの単純な属性のみが表示されます。

- ペイロードに単純な属性を追加します。

- デザインタイムで保護付きのマッピングを作成します。Oracle JDeveloperのデザインタイムで、保護付きの属性マッピングにXPath式を使用することで、複雑なペイロード属性へのマッピングを作成できます。

- RuntimeConfigServiceのAPIを使用して、XPath式を使用したパブリック・マッピングを作成します。

Oracle BPM Worklistで、保護付きの属性ラベルへのマッピングを作成できません。

保護付きのマッピングは、デザインタイムのタスク定義の中でのみ作成できます。実行時にOracle BPM WorklistやRuntimeConfigServiceのAPIを使用して、保護付きのマッピングを作成したり更新することはできません。

- マッピングにパブリック属性ラベルを使用します。

- デザインタイムのタスク定義で、保護付きの属性ラベルへのマッピングを作成します。

Oracle JDeveloperで、マッピングの作成に使用する属性ラベルが表示されません。

デザインタイムのマッピングは、保護付きの属性ラベルに対してのみ作成できます。接続先のSOAインスタンスに保護付きの属性ラベルが作成されていることを確認してください。

1. Oracle BPM Worklistに管理者としてログインします。

2. 「管理」→「保護フレックス・フィールド」の順に移動します。

3. その保護付きの属性ラベルが存在することを確認します。

4. 必要に応じて、保護付きの属性ラベルを作成します。

属性ラベルの名前の国際化

属性ラベル名をリソース・キーとして使用して、WorkflowLabelsリソース・バンドルから表示名を参照できます。

WorkflowLabelsリソース・バンドルに新規リソース・キーを追加します。このキーは、FLEX_LABEL.の接頭辞が付く、ラベルに使用した名前です(接頭辞の末尾のピリオドに注意してください)。

リソース・バンドルの詳細は、Oracle SOA Suiteサンプルで入手可能なワークフロー・サンプルworkflow-110-workflowCustomizationsを参照してください。

あるサーバーから別のサーバーへの属性ラベルとマッピングの移行

テストから本番への移行ユーティリティを使用します。

テストから本番への移行ユーティリティを使用すると、パブリック属性ラベル、パブリック属性マッピング、および保護付きの属性ラベルをXMLファイルにエクスポートして、そのXMLファイルのラベルとマッピングを別のインスタンスにインポートできます。

詳細は、第23.6項「ヒューマン・ワークフロー・データのテスト環境から本番環境への移動」を参照してください。

B.5.6 タスク・レポートの問題

表B-7に、タスク・レポートの問題に関する症状と考えられる原因、考えられる解決策を示します。

表B-7 タスク・レポートの問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

次のエラー・メッセージが表示される場合です。

Null Pointer Exception when
running Task Productivity
Report

これは、ワークリストのクライアントのロケールとサーバーのデフォルト・ロケールが異なる場合に、日付の処理に関する問題が原因で発生します。

回避策としては、ワークリストのクライアントのロケールをサーバーと同じロケールに変更するか、日付を指定しないでレポートを実行します。

B.5.7 タスク履歴の問題

表B-8に、タスク履歴の問題に関する症状と考えられる原因、考えられる解決策を示します。

表B-8 タスク履歴の問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

「参加者の追加」ボタンが無効になっています。

履歴表で、現在または過去の参加者が選択されています。

これは、設計されているとおりの動作です。現在または過去の参加者に対して、非定型参加者を追加することはできません。現在の参加者とは、その時点でタスクが割り当てられている参加者を意味します。

ページをリフレッシュすると、追加したすべての非定型参加者が消えてしまいます。

履歴表への変更が保存されていない可能性があります。

変更を保存してください。そうしない場合、すべての変更は失われます。変更を保存したはずであるのに失われている場合は、バグとして報告してください。

履歴表に予定承認者が表示されません。

予定承認者チェック・ボックスが選択されていない可能性があります。

Oracle BPM Worklist (タスク順序の表の構成)で、予定承認者チェック・ボックスを選択します。

履歴表に相関IDが渡されていないことを示すメッセージ、または相関IDに関連する例外が表示されます。

タスクが開始されていない場合、相関IDが渡されていない可能性があります。

開始されていないタスクに相関IDを渡していることを確認してください。

編集ツールバーが無効になっているか、または表示されません。

ユーザーが参加者を編集する権限を持っていない可能性があります。

1. ヒューマン・タスク・エディタの「割当て」タブで、右上隅にある「タスクは開始参加者から最終参加者へ移行します」アイコンをクリックします。
「割当ての構成」ダイアログが表示されます。

2. 「参加者による新規参加者の編集を許可」チェック・ボックスと「起案者による参加者の追加を許可」チェック・ボックスを選択します。

次のエラー・メッセージが表示される場合です。

<Warning>
<oracle.adf.controller.intern
al.metadata.MetadataService>
<BEA-000000><ADFc:
/META-INF/adfc-config.xml: >
<Warning>
<oracle.adf.controller.intern
al.metadata.MetadataService><
ADFC-52024> <ADFc: Duplicate
managed bean definition for
'aleCompBindings' detected.>

共有ライブラリoracle.soa.worklist.webappがweblogic.xmlで参照され、JARファイルのadflibWorklistComponents.jarとadflibTasklistTaskflow.jarがWebアプリケーション内にパッケージ化されています。

原則的には、これらのJARはWebアプリケーション内にパッケージ化すべきではありません。これらは、共有ライブラリとして参照のみ行います。これらのJARをWebアプリケーション内にパッケージ化しないでください。

次のエラー・メッセージが表示される場合です。

<Error> <Deployer>
<BEA-149265> <Failure
occurred in the execution of
deployment request with ID
'1297964056778' for task
'3'. Error is:
'weblogic.management.Deployme
ntException:
[J2EE:160149]Error while
processing library
references. Unresolved
application library
references, defined in
weblogic-application.xml:
[Extension-Name:
oracle.soa.workflow.wc,
exact-match: false].'
weblogic.management.Deploymen
tException:
[J2EE:160149]Error while
processing library
references. Unresolved
application library
references, defined in
weblogic-application.xml:
[Extension-Name:
oracle.soa.workflow.wc,
exact-match: false].

共有ライブラリoracle.soa.workflow.wcがweblogic.xmlで参照されていますが、サーバー上でこの共有ライブラリを使用できません。

アプリケーションをデプロイしようとしているサーバーに、この共有ライブラリがデプロイされていることを確認します。共有ライブラリがデプロイされていても、ターゲットがそのサーバーでない可能性があります。

次のエラー・メッセージが表示される場合です。

java.lang.IllegalStateExcepti
on: Attempt to validate an
already invalid RegionSite:

これは、サーバー・ログ(たとえば、AdminServer.log)に時々表示される汎用的な例外です。

診断ログ(たとえば、AdminServer-diagnostic.log)で実際の例外を確認して、その例外とバグの内容を報告してください。

次のエラー・メッセージが表示される場合です。

[AdminServer] [NOTIFICATION]
[J2EE JSP-00008]
[oracle.j2ee.jsp] [tid:
[ACTIVE].ExecuteThread: '15'
for queue:
'weblogic.kernel.Default
(self-tuning)'] [userId:
weblogic] [ecid:
17011f2a001d6b0e:7e22d6ce:12e
3444eb1b:-8000-0000000000002f
0a,0] [APP: FederatedApp_
application1] unable to
dispatch JSP page: The
following exception
occurred:.[[
java.lang.RuntimeException:
Cannot find FacesContext
at
javax.faces.webapp.UIComponen
tClassicTagBase.getFacesConte
xt(UIComponentClassicTagBase.
java:2122)

これは、よくある間違いですが、使用しているコンポーネントとは関係ありません。URLへのfacesの入力を忘れています。例:

http://server:port/FederatedApp
/test.jspx

次のように、URLにfacesを入力します。

http://server:port/FederatedApp/fac
es/test.jspx

B.5.8 タスク・フォームおよびタスク・アクションの問題

表B-9に、タスク・フォームおよびタスク・アクションの問題に関する症状と考えられる原因、考えられる解決策を示します。

表B-9 タスク・フォームおよびタスク・アクションの問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

タスク・フォーム・アプリケーションに空のJSPXページがありません。

N/A

現在は、タスク・フォームはADFタスク・フローを使用して呼び出され、タスク・フローが完了すると、タスク・フォームのタスク・フローを開始したモジュールに制御が戻されるようになっています。そのため、空のJSPXは必要ありません。

タスク・フォームがMicrosoft Internet Explorerにロードされません。

Microsoft Internet Explorerでは、URLの長さに制限があります。

タスク・フォームのURLが長すぎます。

デプロイがclass not found例外で失敗します。

共有ライブラリのエントリがweblogic.xmlに存在しません。

次のエラーが表示される場合があります。

Caused By:
java.lang.ClassNotFoundException:
oracle.bpel.services.datacontrol.ty
pes.Number

タスク・フォームのデプロイ時に、共有ライブラリがweblogic.xmlに存在しないことが原因である可能性があります。weblogic.xmlに次の要素を追加します。

<library-ref>
<library-name>oracle.soa.worklist.w
ebapp</library-name>
<specification-version>11.1.1</spec
ification-version>
</library-ref>

ホスト名を使用した場合に、タスク・フォームのデプロイおよびアクセスが失敗します。

DNSエントリが存在しません。

DHCPを設定したサーバーを使用している場合は、そのホストのDNSエントリが存在しない可能性があります。そのため、IPアドレスを使用したデプロイやアクセスは成功しても、ホスト名を使用したデプロイやアクセスは失敗することがあります。手動でホストとIPアドレスを追加して、クライアント・コンピュータを更新します。

- Windowsオペレーティング・システムの場合、通常、これは%windir%\drivers\etc\lmhostsにあります。

- LinuxまたはUNIXの場合、通常、これは/etc/hostsにあります。

タスク・フォームのURLプロトコル(HTTPまたはHTTPS)

HTTPSまたはHTTP経由でタスク・フォームにアクセスできません。

- DefaultToDoTaskForm: ワークリストは、ランタイム構成サービスからgetServerInfoのAPIによって返されたポートとプロトコルを使用して、デフォルトのTo-Doタスク・フォームにアクセスします。このAPIは、クラスタ・サーバーまたは管理対象サーバーのフロントエンド・ホスト設定を使用します。HTTPSプロトコルが有効になっている場合は、このプロトコルが優先されます。これは動的な設定で、他のカスタム・タスク・フォームと同様に、Oracle Enterprise Manager Fusion Middleware Controlを使用して、デフォルトのTo-Doタスクの設定を変更できます。

- CustomTaskForm: カスタム・タスク・フォームは、その設定からHTTPおよびHTTPSの情報を取得します。情報の取得には、JRFのAPIを使用します。これは、クラスタからフロントエンド・ホスト情報を取得し、さらにクラスタのフロントエンド・ホストが設定されていない場合は、管理対象サーバーから情報を取得します。管理対象サーバーのフロントエンド・ホストが設定されていない場合は、通常のポートを使用します。デプロイ時にユーザーがHTTPSポートを有効にした場合は、タスク・フォームによって、この情報がデータベースに保存されます。この発生以降に、ユーザーがOracle WebLogic Server管理コンソールを使用してHTTPSポートを無効にした場合、ユーザーはOracle Enterprise Manager Fusion Middleware Controlを使用して、タスク・フォームのHTTPSポートを削除する必要があります。

注意:

複数タスク・フォームのデプロイ時にjava.lang.OutOfMemoryError: PermGen spaceエラーが表示された場合は、PermGenメモリーを増やすことが必要な場合があります。詳細は、第7.1.1項「複数のADFタスク・フォーム・デプロイメントのPermGenメモリー要件」を参照してください。

B.5.9 タスク・コメントと添付ファイルの問題

表B-10に、タスク・コメントと添付ファイルの問題に関する症状と考えられる原因、考えられる解決策を示します。

表B-10 タスク・コメントと添付ファイルの問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

ファイルがアップロードされません。

ファイルが大きすぎます

デフォルトでは、ADFには、各リクエストにつき、2000 KBのサイズ制限があります。次のパラメータをweb.xmlに追加して、アップロードするファイルのファイル・サイズと一時記憶域を調整します。

<context-param>
<!-- Maximum memory per request
(in bytes) -->
<param-name>oracle.adf.view.faces.U
PLOAD_MAX_MEMORY</param-name>
<!-- Use 500K -->
<param-value>512000</param-value>
</context-param>
<context-param>
<!-- Maximum disk space per
request (in bytes) -->
<param-name>oracle.adf.view.faces.U
PLOAD_MAX_DISK_SPACE</param-name>
<!-- Use 5,000K -->
<param-value>5120000</param-value>
</context-param>
<context-param>
<!-- directory to store temporary
files -->
<param-name>oracle.adf.view.faces.U
PLOAD_TEMP_DIR</param-name>
<!-- Use an ADFUploads
subdirectory of /tmp -->
<param-value>/tmp/ADFUploads/</para
m-value>
</context-param>

タスク詳細アプリケーションにアップロードしたファイルが、同じタスク・フローに表示されません。

ファイルのアップロード後は、タスク・フォームに生成されている添付ファイルのリンクは無効になります。このリンクをクリックすると、空のストリームが返されます。

ファイルをアップロードする際には、表に添付ファイルのリンクが表示されます。ただし、このリンクは機能しません。タスク詳細をリロードして、ファイルを表示する必要があります。

ファイルの添付を追加すると新規タスク・バージョンが作成されますが、URLの添付を追加しても新規バージョンが作成されません。

URLの添付とファイルの添付では、動作が一致しません。

ファイルがアップロードされた場合、ファイルは永続的な記憶域にアップロードされるため、タスクが保存されます。これにより、新規タスク・バージョンが作成されます。URLの添付では、ユーザー・インタフェース・アプリケーションのローカル・タスク・オブジェクトのみが更新されます。そのため、タスク・バージョンは作成されません。

B.5.10 実行時のデザインタイムの問題

表B-11に、実行時のデザインタイムの問題に関する症状と考えられる原因、考えられる解決策を示します。次の2つの実行時のデザインタイム・ツールを使用できます。

- Oracle SOA Composer

- Oracle BPM Worklistの「タスク構成」タブ

表B-11 実行時のデザインタイムUIの問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

実行時のデザインタイム・ツールでタスクに行った変更が、そのタスクに表示されません。

実行時のデザインタイム・ツールを使用して、実際にタスクを編集したときよりも前に、そのタスクはインスタンス化されています。

実行時のデザインタイムの更新は、変更後に作成されたインスタンスにのみ反映され、変更前にすでに作成されていたインスタンスには反映されません。

そのため、実行時のデザインタイム・ツールを使用してタスクを編集した場合は、新しいタスクをインスタンス化して、行った変更を新しいタスク・インスタンスに反映します。

実行時のデザインタイム・ツールでタスクに行った変更が、そのタスクに表示されません。

行った変更が、MDSリポジトリにコミットされていない可能性があります。

「保存」ボタンでは、実行時のデザインタイム・ツールで行った変更がサンドボックスにのみ保存されます。これらの変更を操作中に表示するには、「コミット」をクリックして、変更内容をMDSリポジトリに送信します。

B.5.11 ヒューマン・ワークフローAPI (SOAPおよびEJBを含む)の使用の問題

表B-12に、ヒューマン・ワークフローAPI (SOAPおよびEJBを含む)の使用の問題に関する症状と考えられる原因、考えられる解決策を示します。

表B-12 ヒューマン・ワークフローAPIの使用の問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

ヒューマン・ワークフローAPIのJavaDocの場所

N/A

ドキュメント・ライブラリで入手可能なOracle Fusion Middleware Oracle SOA Suiteワークフロー・サービスJava APIリファレンスを参照してください。

APIの使用方法の理解

N/A

1. APIのドキュメントを参照してください。

2. Oracle SOA Suiteサンプルで入手可能なサンプルworkflow-118-JavaSamplesを参照してください。

.netを使用したAPIへのアクセス

N/A

SOAP WebサービスのAPIにアクセスする.netクライアントを記述できます。Oracle SOA Suiteサンプルで入手可能なサンプルworkflow-119-DotNetSampleを参照してください。

Java APIクライアントを使用しようとすると、Class not foundのエラーが表示されます。

クライアント・クラスパスに、すべての必要なJARファイルが存在しません。

Oracle SOA Suiteサンプルで入手可能である、build.xml antファイルのclient.classpathのworkflow-118-JavaSamples定義を参照してください。サンプルには、すべての必要なJARファイルが含まれています。

単純な承認タスクとあわせて使用したり、タスクの開始時にタスクを動的にルーティングするための、単純なパターン用のルーティング・スリップの作成

N/A

oracle.bpel.services.workflow.task.impl.SimpleApprovalTaskUtilを参照してください。

B.5.12 Oracle JDeveloperのデータ・コントロールとフォームの生成の問題

表B-13に、Oracle JDeveloperのデータ・コントロールとフォームの生成の問題に関する症状と考えられる原因、考えられる解決策を示します。

表B-13 Oracle JDeveloperのデータ・コントロールとフォームの生成の問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

タスク・フォームの作成時に、Empty1.jspxが生成されません。

XSD要素に基づいてイニシエータ・タスクを作成し、タスク・フォームを自動生成しようとしました。

このファイルは、BPMのイニシエータ・タスク以外では必要ありません。この問題が発生した場合は、adfc-config.xmlで参照しているディレクトリと同じディレクトリにEmpty1.jspxファイルを作成し、このファイルに次の内容を入力します。

<?xml version='1.0'
encoding='UTF-8'?><jsp:root
xmlns:jsp="http://java.sun.com/JSP/
Page" version="2.1"xmlns:f="http://java.sun.com/jsf/core"
xmlns:h="http://java.sun.com/jsf/html"
xmlns:af="http://xmlns.oracle.com/a
df/faces/rich">  <jsp:directive.page
contentType="text/html;charset=UTF-8"/>
<f:view>
<af:document id="d1">
<af:form id="f1"></af:form>
</af:document>
</f:view>
</jsp:root>

B.5.13 ヒューマン・ワークフロー・サービスとシステムMBeanブラウザの問題

表B-14に、ヒューマン・ワークフロー・サービスとシステムMBeanブラウザの問題に関する症状と考えられる原因、考えられる解決策を示します。

表B-14 ヒューマン・ワークフロー・サービスとシステムMBeanブラウザの問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

よく使用するヒューマン・ワークフロー構成パラメータの設定

N/A

Oracle Enterprise Manager Fusion Middleware Controlの「ワークフロー・タスク・サービス」ページおよびワークフロー通知ページを使用します。

1. ナビゲータで「soa-infra」を右クリックします。

2. 「SOA管理」→「ワークフロー構成」→「メーラー」タブの順に選択して、通知プロパティにアクセスします。

3. 「SOA管理」→「ワークフロー構成」→「タスク」タブの順に選択して、タスク・サービス・プロパティにアクセスします。

詳細は、第21.1項「ヒューマン・ワークフロー通知プロパティの構成」と第21.3項「ヒューマン・ワークフロー・タスク・サービス・プロパティの構成」を参照してください。

Oracle Enterprise Manager Fusion Middleware Controlのプロパティ・ページで使用できないヒューマン・ワークフロー構成パラメータの設定

N/A

Oracle Enterprise Manager Fusion Middleware ControlのシステムMBeanブラウザを使用します。

1. ナビゲータで「soa-infra」を右クリックします。

2. 「SOAインフラストラクチャ」→「管理」→「システムMBeanブラウザ」の順に選択します。

3. 「アプリケーション定義のMBean」→「oracle.as.soainfra.config」→「サーバー」→「WorkflowConfig」→「human-workflow」の順に選択します。

4. 単純なパラメータを設定するには、「属性」タブで適切なフィールドを編集して、「適用」をクリックします。

5. 複雑なパラメータを変更するには(たとえば、新しいロケールの追加など)、「操作」タブに切り替えて、適切な操作を選択し、必須フィールドを入力して、「呼出し」をクリックします。

ヒューマン・ワークフロー構成MBeansを編集した後に、システムMBeanブラウザに変更が反映されません。

システムMBeanブラウザには、前にキャッシュされたバージョンのBeanが表示されています。

システムMBeanブラウザの「キャッシュされたツリー・データのリフレッシュ」ボタンをクリックします。

ワークフローのカスタマイズのクラスパスURLにあるリソース・バンドルまたはクラスが、ヒューマン・ワークフロー・サービスで見つかりません。

URLでプロトコルが指定されていないか、URLに末尾のスラッシュ(/)がありません。

構成されているURLが正しい形式で指定され、プロトコルを指定していることを確認します。クラスパスで(JARファイルでなく)ディレクトリを指定する場合は、URLの末尾にスラッシュ文字が必要です。例:

file:///home/wstallar/wfcustomizati
ons/

特定のタスク・コンポーネントのタスク詳細の表示に使用するURLの手動設定

N/A

そのヒューマン・タスク・サービス・コンポーネントに対して、Oracle Enterprise Manager Fusion Middleware Controlの「管理」ページを使用します。

手順については、第23.3項「ヒューマン・タスク・サービス・コンポーネントのタスク詳細アプリケーションのURI管理」を参照してください。

既存のタスク表示URLエントリを編集または削除したり、新規エントリを追加できます。Oracle BPM Worklistから使用するタスク表示URLの場合は、アプリケーション名を「worklist」に設定する必要があります。

B.5.14 AMX拡張の問題

表B-15に、AMX拡張の問題に関する症状と考えられる原因、考えられる解決策を示します。

表B-15 AMX拡張の問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

動的承認グループ・クラスが見つかりません。

Oracle SOA Suiteのクラスパスで、このクラス・ファイルにアクセスできません。

動的承認グループ・クラスへのアクセスを可能にするには、次のディレクトリにクラス・ファイルを配置する必要があります。

$FMW_HOME/SOA_HOME/soa/modules/ora
cle.soa.ext_11.1.1/classes

このディレクトリは、SOAクラスパスの一部です。

Oracle WebLogic Serverを再起動する必要があります。

実行時のデザインタイム中に、承認グループ・リスト・ビルダーに基づいてルールを定義しているときに、グループが存在しないことを示すメッセージが継続して表示されます。

承認グループの名前が引用符(" ")で囲まれていません。

名前を引用符で囲みます(たとえば、"Sample Approval Group Name")。

ルールセット内で、定義されている複数のルールがトランザクションに該当します。正しい制約が適用されていないように思われます。その結果、生成された承認者リストが正しくありません。

ルールセット内のルールは、トランザクションに対して1つのみが該当する必要があります。

複数のルールが該当する場合は、最も高い優先度のルールに関連付けられているアクションが実行されます。

該当する複数のルールの優先度が同じ場合は、リスト内の最初のルールが選択され、そのアクションが実行されます。

ルールセット内のすべてのルールで、同じトランザクションに対して同じ優先度の複数のルールが該当しないように、優先度が定義されていることを確認してください。

B.5.15 Oracle BPM Worklistとタスク領域の問題

表B-16に、Oracle BPM Worklistとタスク領域の問題に関する症状と考えられる原因、考えられる解決策を示します。

表B-16 Oracle BPM Worklistとタスク領域の問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

次の例外メッセージがログに表示されます。

<Warning>
<oracle.adf.controller.internal.
metadata.MetadataService>
<BEA-000000><ADFc:
/META-INF/adfc-config.xml: >
<Warning>
<oracle.adf.controller.internal.
metadata.MetadataService><ADFC-5
2024> <ADFc: Duplicate managed
bean definition for
'aleCompBindings' detected.>

共有ライブラリoracle.soa.worklist.webappがweblogic.xmlファイルで参照されるとともに、JARファイルのadflibWorklistComponents.jarとadflibTasklistTaskflow.jarがWebアプリケーション内にパッケージ化されています。

これらのJARはWebアプリケーション内にパッケージ化しないでください。これらは、共有ライブラリとして参照のみ行います。これらのJARをWebアプリケーション内にパッケージ化しないでください。

次の例外メッセージがログに表示されます。

Duplicate default server in
client configuration.
Configuration needs to have only
one default server in client
configuration.
Specify one default server in
client configuration.

クライアント構成ファイル、またはタスク・フローに渡されたJAXBオブジェクトで、2つのデフォルト・サーバーが指定されています。

クライアント構成ファイルまたは渡されるJAXBオブジェクトで、1つのサーバーのみをデフォルトとしてマークします。

次の例外メッセージがログに表示されます。

The default server is not
specified

クライアント構成ファイル、またはタスク・フローに渡されたJAXBオブジェクトで、デフォルト・サーバーが指定されていません。

クライアント構成ファイルまたはJAXBオブジェクトで、デフォルト・サーバーがマークされていることを確認します。

次の例外メッセージがログに表示されます。

Invalid display column.
The display column COLUMN NAME
is not a valid Task column.
Specify a valid column name.

タスク・フロー・パラメータdisplayColumnsListに渡された列名が正しくありません。

タスク・フロー・パラメータに正しい列名を渡していることを確認します。

次の例外メッセージがログに表示されます。

java.lang.IllegalStateException:
Attempt to validate an already
invalid RegionSite:

これは、サーバー・ログ(たとえば、AdminServer.log)に時々表示される汎用的な例外です。

診断ログ(たとえば、AdminServer-diagnostic.log)の実際の例外を確認して、その例外とバグの内容を報告してください。

次の例外メッセージがログに表示されます。

Caused by:
oracle.adf.controller.Controller
Exception: ADFC-02001: The ADF
Controller cannot find
'/WEB-INF/taskList-task-flow-def
inition.xml'

Oracle BPM WorklistのJARは、共有ライブラリoracle.soa.worklist.webappを参照するか、これらをWebアプリケーション内にパッケージ化することによりクラスパスで指定しますが、いずれの方法でも指定されていません。

JARが、共有ライブラリによって参照されているか、アプリケーション内にパッケージ化されていることを確認します。

タスク・リストをリフレッシュすると、タスク・リストのフィルタが削除されます。

受信ボックスは永続的なビューではないため、受信ボックスに設定されているフィルタは、ページの再レンダリング時やタスク・リストのリフレッシュ時に削除されます。

タスク・リストにフィルタを設定するかわりに、必要なフィルタ・セットを設定したユーザー・ビューを作成し、そのビューのviewIdをパラメータViewFilterの値として渡します。これにより、そのビューがタスク・リストのデフォルト・ビューになります。

taskTypesFilterListパラメータを設定しましたが、割り当てたタスクではなく、すべてのタスクが表示されます。

taskTypesFilterListパラメータを指定している場合は、attributesFilterListパラメータの指定を忘れています。

両方のパラメータとAND演算子を使用する必要があります。例:

<parameter
id="taskTypesFilterList"
value="http://xmlns.oracle.com/H
elpDeskRequestSOAApp/HelpDeskReq
uestComposite/HelpDeskRequestHum
anTask,[
http://xmlns.oracle.com/Vacation
RequestApp/VacationRequest/Vacat
ionRequestTask]"/>

<parameter id=
"attributesFilterOperator"
value="and"/>
<parameter id= "attributesFilterList"
value="state=ASSIGNED"/>

次の例外メッセージがログに表示されます。

[AdminServer] [NOTIFICATION]
[J2EE JSP-00008]
[oracle.j2ee.jsp] [tid:
[ACTIVE].ExecuteThread: '15'
for queue:
'weblogic.kernel.Default
(self-tuning)'] [userId:
weblogic] [ecid:
17011f2a001d6b0e:7e22d6ce:12e344
4eb1b:-8000-0000000000002f0a,0]
[APP: FederatedApp_
application1] unable to dispatch
JSP page: The following
exception occurred:.[[
java.lang.RuntimeException:
Cannot find FacesContext
at
javax.faces.webapp.UIComponentCl
assicTagBase.getFacesContext(UIC
omponentClassicTagBase.java:2122)

これは、その性質から一般的によくある間違いですが、使用しているコンポーネントとは関係ありません。URLへのfacesの入力を忘れています。例:

http://server:port/FederatedApp/test.jspx

次のように、URLにfacesを入力します。

http://server:port/FederatedApp/
faces/test.jspx

次の例外メッセージがログに表示されます。

[AdminServer] [TRACE] [] []
[tid: [ACTIVE].ExecuteThread:
'5' for queue:
'weblogic.kernel.Default
(self-tuning)'] [userId:
weblogic] [ecid:
17011f2a001d6b0e:7e22d6ce:12e344
4eb1b:-8000-0000000000001d39,0]
[SRC_CLASS:
oracle.bpel.services.workflow.cl
ient.config.ClientConfigurationU
til] [APP: FederatedApp_
application1] [SRC_METHOD:
getClientConfiguration]
WorkflowServiceClientContext:
Cannot find client
configuration file: wf_client_
config.xml

この問題には、次の3つの原因が考えられます。

1. クライアント構成ファイルがクラスパスに指定されていません。

2. JAXBオブジェクトがタスク・フローに渡されていません。

3. 前述のいずれかを指定している場合は、リモート・クライアントまたはSOAPクライアントのポート番号が正しくありません。

クラスパスでクライアント構成ファイルwf_client_config.xmlが指定されているか、またはJAXBオブジェクトがタスク・フローに渡されていることを確認します。すでに行っている場合は、ポート番号でSOAサーバーが指定されていることを確認します。

次の例外メッセージがログに表示されます。

<Error> <Deployer> <BEA-149265>
<Failure occurred in the
execution of deployment request
with ID '1297964056778' for
task '3'. Error is:
'weblogic.management.DeploymentE
xception: [J2EE:160149]Error
while processing library
references. Unresolved
application library references,
defined in
weblogic-application.xml:
[Extension-Name:
oracle.soa.workflow.wc,
exact-match: false].'
weblogic.management.DeploymentEx
ception: [J2EE:160149]Error
while processing library
references. Unresolved
application library references,
defined in
weblogic-application.xml:
[Extension-Name:
oracle.soa.workflow.wc,
exact-match: false].

共有ライブラリoracle.soa.workflow.wcがweblogic.xmlで参照されていますが、サーバー上でこの共有ライブラリを使用できません。

アプリケーションをデプロイしようとしているサーバーに、この共有ライブラリがデプロイされていることを確認します。共有ライブラリがデプロイされていても、ターゲットがそのサーバーでない可能性があります。

列にマップされているマップ済属性が表示されません。

注意: リリース11g R1 (11.1.1.4)から、Oracle BPM Worklistフレックス・フィールドはマップ済属性と呼ばれるようになりました。

正しいパラメータのセットが、タスク・リストのタスク・フローに渡されていません。

正しいパラメータのセットを渡す方法は、次のとおりです。

<parameter id= "displayColumnsList"
value="assignees,creator,
assignedDate,state,
textAttribute1,textAttribute2"/>

textAttribute1,textAttribute2は、列名に値を渡すための正しい方法です。これらの値に関連付けられている'label name'(マッピングの名前)を指定しても、機能しません。

パラメータtaskTypesFilterListには、完全修飾の値を具体的に渡す必要があります。そうしない場合、列の作成は機能しません。

例:

<parameter
id="taskTypesFilterList"
value="http://xmlns.oracle.com/Hel
pDeskRequestSOAApp/HelpDeskRequest
Composite/HelpDeskRequestHumanTask
"/>

B.5.16 テストから本番への移行の問題

表B-17から表B-20に、テストから本番への移行の問題に関する症状と考えられる原因、考えられる解決策を示します。

表B-17 テストから本番への移行の問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

SOAサーバーのデフォルトのレルム名の検索

N/A

defaultRealmNameは、アイデンティティ構成サービスから取得できます。これは、SOAPサービスのテスト・ページから取得できます。

1. ブラウザから、次のURLにアクセスします。

http:host:port/integration/servic
es/IdentityService/configuration

2. 「操作」ドロップダウン・メニューから、「getDefaultRealmName」を選択します。

3. 「起動」ボタンをクリックします。

これにより、デフォルトのレルム名が取得されます。次に、起動に対するサンプルの応答を示します。

<env:Envelope
xmlns:env="http://schemas.xmlsoap.org/soap
/envelope/">
<env:Header/>
<env:Body>
<realmName
xmlns="http://xmlns.oracle.com/bpel/servi
ces/IdentityService">jazn.com</realmName>
</env:Body>
</env:Envelope>

表B-18 テストから本番への移行の問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

次のユーザー認証エラー(次の例では、ユーザーはFMW_USERID、アイデンティティ・コンテキストはjazn.com)が表示されます。

[java] Error in workflow service Web
service operation invocation. The
error is ORA-30501:Error in
authenticating user.
[java] Error in authenticating and
creating a workflow context for
user jazn.com/FMW_USERID. [java]
Verify that the user credentials
and identity service configurations
are correct.

これは、指定されたユーザーがシードされておらず、LDAPプロバイダで使用できない場合に発生します。

ユーザーが適切にシードされているかどうかを識別するには、ブラウザからそのユーザーでOracle BPM Worklistにログインしてみます。そのユーザーでOracle BPM Worklistにログインできれば、ユーザーはシードされています。

Oracle Internet Directoryやその他のLDAPプロバイダを使用している場合は、LDAPプロバイダの構成が正しく完了していることを確認します。そうでない場合、このエラーは解決できません。

ターゲットSOAサーバーにタスク・ペイロード・マップ済属性マッピング(以前のフレックス・フィールド)をインポートしているときに、次のエラーがコンソール・ログに表示されることがあります。

[java] Caused by:
java.sql.SQLIntegrityConstrain
tViolationException: ORA-02291:
integrity constraint (UAT_
SOAINFRA.SYS_C0018364) violated -
parent key not found* *

ターゲットSOAサーバーへのタスク・ペイロード・マップ済属性マッピングのインポートは、2つのステップの処理で構成されます。

ターゲットSOAサーバーへのタスク・ペイロード・マップ済属性マッピングのインポート操作を行う前に、実行が必要な前提条件のステップがあります。これは、ターゲットSOAサーバーへの属性ラベルのインポート操作です。

正常に完了するためには、ヒューマン・ワークフローのテストから本番への移行ツールを使用して、(正しい順序で)次の操作を実行します。

1. ターゲットSOAサーバーに属性ラベルをインポートします。

2. ターゲットSOAサーバーにペイロード・マッピングをインポートします。

詳細は、第23.6項「ヒューマン・ワークフロー・データのテスト環境から本番環境への移動」を参照してください。

表B-19 テストから本番への移行の問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

ルールの移行時に、次のエラーが発生したと仮定します。

[java]  Error encountered during
migration. [java] Exception in thread
"main"[java]
UserConfigDataMigrationException:[java]
faultString:Invalid parameters for RULE.
[java] Invalid user and group: both
parameters can not have null
values.[java] To migrate User Rules,
provide the 'user' parameter only.
[java]  To migrate Group Rules, provide
the 'group' parameter only.[java]
oracle.bpel.services.workflow.util.
tools.wfUserConfigDataMigrator.
UserConfigDataMigrationE xception [java]
at oracle.bpel.services.workflow.
util.tools.wfUserConfigDataMigrator.
implhwfMigrator.parseParametersNode

migration.propertiesファイル内に、このエラーに関連する2つのプロパティがあります。

- user

- group

ルールの移行(エクスポートまたはインポート)操作時には、これらのいずれか(userまたはgroup)に値を設定する必要があります。つまり、userとgroupの両方に、nullまたは空の値を設定することはできません。

これらのいずれかに値を設定します。ユーザー・ルールの移行を実行するには、userパラメータのみを設定します。グループ・ルールの移行を実行するには、groupパラメータのみを設定します。

ルールの移行時に、次のエラーが発生したと仮定します。

[java]  Error encountered during
migration.[java] Exception in
thread "main"[java]
UserConfigDataMigrationExcepti
on: [java]  faultString:
Invalid parameters for RULE.
[java]  Invalid user and group: both
parameters can not have values.
[java]  To migrate User Rules,
provide the 'user'parameter only.
[java]  To migrate Group Rules,
provide the 'group' parameter only.
[java]  oracle.bpel.services. workflow.util.tools.wfUserConfigData
Migrator.UserConfigDataMigrationE
xception

これはこの表の前述の説明と似ています。

ルールの移行(エクスポートまたはインポート)操作時に、userとgroupの両方のパラメータに値を設定することはできません。

これらのいずれかに値を指定します。

表B-20 テストから本番への移行の問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

インストール後のサーバーのヘルスのテスト

N/A

テストから本番への移行を実行する前に、サーバーのヘルスをテストすることは有用です。

ブラウザから、いくつかのSOAPサービスをテストできます。次に、ヒューマン・ワークフロー・サービスのサブセットとOracle BPM Worklistを示します。

http://host:port/integration/worklistapp/

http://host:port/integration/services
/TaskQueryService/TaskQueryService

http://host:port/integration/services/IdentityService/configuration

http://host:port/integration/services/IdentityService/identity

http://host:port/integration/services/RuntimeConfigService/RuntimeConfigService

これらのサービスで任意の操作をテストして、その操作によって発生する結果を確認できます。同様に、Oracle BPM Worklistにユーザーとしてログインして、問題がないかどうかを確認できます。

テストから本番への移行の問題の詳細は、第23.6項「ヒューマン・ワークフロー・データのテスト環境から本番環境への移動」を参照してください。

B.5.17 アイデンティティ・サービスの問題

表B-21と表B-22に、アイデンティティ・サービスの問題に関する症状と考えられる原因、考えられる解決策を示します。

表B-21 アイデンティティ・サービスの問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

クラスタ環境で、Oracle BPM Worklistの承認タスクを操作しようとすると、次のエラーが表示される場合があります。

Token Decryption Failed

LDAPベースのリポジトリではなく、ファイルベースのリポジトリを使用しています。これにより、アプリケーション・ロールがノード全体で同期されなくなっています。

クラスタ環境のリポジトリ構成については、『Oracle Fusion Middleware Oracle SOA Suiteエンタープライズ・デプロイメント・ガイド』の「エンタープライズ・デプロイメントとOracle Identity Managementの統合」に関する章の指示に従ってください。

LDAPの一部のユーザーのみ、Oracle BPM Worklistにログインできます。

ユーザー・ベースDNが正しく構成されていません。

すべてのシード済グループにユーザー・ベースを指定します。これは、次の2つの方法で行うことができます。

すべての必要なシード済グループにベースDNを追加します。たとえば、次のようにユーザーがシードされている場合、

UserDN 1 : cn=users1,dc=us,dc=oracle,dc=com
UserDN 2 : cn=users2,dc=us,dc=oracle,dc=com
UserDN 3 : cn=users3,dc=us,dc=oracle,dc=com

グループ・ベースDNを次のように指定します。

dc=us,dc=oracle,dc=com

これは、共通のDNです。一部のユーザーDNのみが必要な場合は(たとえば、UserDN1とUserDN2)、$DOMAIN_HOME/config/fmwconfig/jps-config.xmlファイル内の名前がidstore.ldapのserviceInstanceに、次のプロパティを追加する必要があります。

<serviceInstance name="idstore.ldap"
provider="idstore.ldap.provider">
<property name="idstore.config.provider"
value="oracle.security.jps.wls.internal.idstore.WlsLd
apIdStoreConfigProvider"/>
<property name="CONNECTION_POOL_CLASS"
value="oracle.security.idm.providers.stdldap.JNDIPool"/>
<extendedProperty>
<name>user.search.bases</name>
<values>
<value>cn=users1,dc=us,dc=oracle,dc=com</value>
<value>cn=users2,dc=us,dc=oracle,dc=com</value>
</values>
</extendedProperty>
</serviceInstance>

最初のオーセンティケータにシードされているユーザーとグループのみは表示されますが、他のオーセンティケータからは表示されません。

デフォルトでは、最初のオーセンティケータからのユーザーとグループが認可されます。

11.1.1.4以降では、複数のオーセンティケータからのユーザーとグループを認可できます。$DOMAIN_HOME/config/fmwconfig/jps-config.xmlファイル内のidstoreインスタンスに、次のプロパティを追加します。

<serviceInstance name="idstore.ldap"
provider="idstore.ldap.provider">
............................
<property name="virtualize" value="true"/>
..............................
</serviceInstance>

表B-22 アイデンティティ・サービスの問題のトラブルシューティング

症状

考えられる原因

考えられる解決策

アイデンティティ・サービスのAPIに、アイデンティティ・コンテキストへのパラメータとしてmyrealm (Oracle WebLogic Server管理コンソールの構成のデフォルト・レルム)を渡すと、次の例外が表示されます。

Exception seen :
Service"
Unknown macro: {0}
"in configuration"
Unknown macro: {1}
" could not be
initialized. Error
in initializing
service
"Authentication"
in configuration
"myrealm".

ヒューマン・ワークフローのアイデンティティ・サービスでは、Oracle WebLogic Serverの構成ではなく、WorkflowIdentityConfigファイルに設定されているアイデンティティ・コンテキスト(デフォルトでは、jazn.com)が使用されます。したがって、カスタム・コード内で、jazn.comがアイデンティティ・コンテキストとして渡されている場合は、認証APIは問題なく機能します。

レルム名を変更するために、Oracle Enterprise Manager Fusion Middleware ControlのシステムMBeanブラウザで、WorkflowIdentityConfigファイルを編集できます。

1. ナビゲータで「soa-infra」を右クリックします。

2. 「SOAインフラストラクチャ」→「管理」→「システムMBeanブラウザ」の順に選択します。

3. 「アプリケーション定義のMBean」→「oracle.as.soainfra.config」→「サーバー」→「WorkflowIdentityConfig」→「human-workflow」→「WorkflowIdentityConfig.ConfigurationType」の順に選択します。

4. setRealmNameの操作を呼び出して、構成を選択し、名前を変更します。この変更では、サーバーの再起動が必要です。

Oracle WebLogic ServerでLDAPを構成すると、Oracle WebLogic Server管理コンソールにユーザーは表示されますが、次のエラーがスローされます。

No Role found
matching the
criteria

グループのベースDNが正しく構成されていません。参照されているグループが、LDAPに存在しないか、LDAPの構成時に設定されたグループ・ベースDNの外部にシードされている可能性があります。

すべてのシード済グループにグループ・ベースを指定します。これは、次の2つの方法で行うことができます。

すべての必要なシード済グループにベースDNを追加します。たとえば、次のようにグループがシードされている場合、

GroupDN 1 : cn=groups1,dc=us,dc=oracle,dc=com
GroupDN 2 : cn=groups2,dc=us,dc=oracle,dc=com
GroupDN 3 : cn=groups3,dc=us,dc=oracle,dc=com

グループ・ベースDNを次のように指定します。

dc=us,dc=oracle,dc=com

これは、共通のDNです。一部のグループDNのみが必要な場合は(たとえば、GroupDN1とGroupDN2)、$DOMAIN_HOME/config/fmwconfig/jps-config.xmlファイル内の名前がidstore.ldapのserviceInstanceに、次のプロパティを追加する必要があります。

<serviceInstance name="idstore.ldap"
provider="idstore.ldap.provider">
<property name="idstore.config.provider"
value="oracle.security.jps.wls.internal.idstore.WlsL
dapIdStoreConfigProvider"/>
<property name="CONNECTION_POOL_CLASS"
value="oracle.security.idm.providers.stdldap.JNDIPool"/>
extendedProperty>
<name>group.search.bases</name>
<values>
<value>cn=groups1,dc=us,dc=oracle,dc=com</value>
<value>cn=groups2,dc=us,dc=oracle,dc=com</value>
</values>
</extendedProperty>
</serviceInstance>

B.6 EDNのトラブルシューティング

この項では、EDNの問題をトラブルシューティングする方法について説明します。

B.6.1 EDNイベント・バスと配信のチューニング

システムMBeanブラウザで次のEDNプロパティをカスタマイズできます。

1. 「soa-infra」を右クリックします。

2. 「SOAインフラストラクチャ」→「管理」→「システムMBeanブラウザ」の順に選択します。

3. 「アプリケーション定義のMBean」→「oracle.as.soainfra.config」→「Server: soa_server-x」→「EDNConfig」→「edn」の順に開きます。

4. 属性をダブルクリックします。

プロパティ

タイプ

詳細

NumberOfThreads

int

デフォルトは、EDN-DB実装の場合は3、EDN-JMS実装の場合は2になります。このプロパティを0に設定するのは、EDN-DBの2またはEDN-JMSの1と事実上同じです。

EDN-DBおよびEDN-JMSの詳細は、第35.1項「イベント配信ネットワークの概要」を参照してください。

Paused

boolean

値はtrueまたはfalseです。trueの場合は、EDNリスナー・スレッドは0に減少し、イベントの配信は事実上停止します。これはEDN-DBとEDN-JMSに適用されます。

NumberOfRetrys

int

イベントをエラー・ホスピタルに移動するまでのEDNによる配信と再配信の最大数。このパラメータはone-and-only-one配信にのみ有効で、保証付き配信には機能しません。許可される最大値は5です。5より小さな値に設定すると、事実上5と同じになります。

NumberOfRetrysを様々な値に設定した場合の動作は、次のようになります。

- >= 2の場合は、EDNはイベントを一度配信し、XAが失敗した場合は最大(NumberOfRetrys -1)の回数だけ再配信を試行します。

- = 1の場合は、EDNはイベントを一度だけ配信します。XAが失敗した場合も、再試行は行われません。

- = 0の場合は、= 1と同じになります(つまり、EDNはイベントを一度だけ配信します)。XAが失敗した場合も、再試行は行われません。

- > 5の場合、これは事実上NumberOfRetrys = 5と同じになります。

5. 値を入力して、「適用」をクリックします。

B.6.2 ロールバックされたOne-and-Only-Oneイベント配信メッセージがログ・ファイルに表示される

Javaデバッグ・レベルを「TRACE:16 (FINER)」以下の値に設定している場合は、次のようなログ・メッセージが表示される場合があります。

Began XA for OAOO
Rolled back XA for OAOO

これらは、配信待機中のイベントがない場合のOAOO (one-and-only-one)イベント配信の通常メッセージです。これらはエラー状態ではありません。Javaロギング・レベルを「TRACE:1 (FINE)」以上の値に設定することによって、これらのメッセージが表示されないようにできます。

B.6.3 イベントが同じコンポジットの複数リビジョンによって使用される

設計によって、異なるコンポジットで同じイベントをサブスクライブできます。ただし、同じコンポジットの複数のリビジョンで同じイベントをサブスクライブする場合はエラーです。これが発生するのは、コンポジットのアクティブ・バージョンが複数ある場合で、これはパッチ失敗の結果の可能性があります。

次の手順を実行して、同じコンポジットの複数のアクティブ・リビジョンが存在するかどうかを判別し、アクティブである必要のないコンポジット・リビジョンをリタイアさせます。

1. Oracle Enterprise Manager Fusion Middleware Controlに移動します。

2. 「SOA」→「soa-infra」の順にクリックします。
「ダッシュボード」タブの「デプロイ済コンポジット」セクションに、デプロイ済コンポジットの名前、リビジョンおよびモード(例: アクティブ)のリストが表示されます。

3. 同じ名前でアクティブ・モードであるが、リビジョンが異なるコンポジットを識別します。

4. アクティブである必要のないコンポジット・リビジョンをクリックします。

5. 「リタイア」ボタンをクリックします。

B.6.4 ビジネス・イベントがSOAサーバーによって2回(以上)取得される

ビジネス・イベントがJ2EEアプリケーションから発生し、複数回取得される場合があります。予期される動作は、それらが1回のみ取得されることです。

パッチが失敗すると、特定のコンポジットの2つのバージョンがアクティブになる可能性があります(つまり、古い方のバージョンがリタイアされていません)。コンポジットの複数のバージョンがアクティブである場合、これらはすべてサブスクライバになり、イベントが複数回取得されます。これは通常のシナリオでは発生しないようにする必要があります。パッチを再適用し、デプロイ済コンポジットのアクティブ・バージョンが1つのみであることを確認します。

B.6.5 EDNとコンポジットまたはクラスタ全体のコンポジット間でメッセージが一部失われる

メッセージは主に、次の理由で失われます。

1. EDNメッセージが配信されなかった。

2. ターゲットの非同期サービスが応答しなかった。

3. メッセージがロールバックされた(メッセージは失われなかったが、引き続きOracle Enterprise Manager Fusion Middleware Controlに表示される)。

この問題では通常、メッセージの宛先を識別し、パスを診断する必要があります。

- Oracle WSM Policy Managerセキュリティ構成を使用して、クライアントがSOAコンポジットを起動できるかどうかを調べます。

- トランザクションが一時(非永続)でないことを確認します。
Oracle BPEL Process Managerは、非同期コールバックの待機中、デハイドレーション・ストア・データベースを使用して、長期間にわたる非同期プロセスとその現在の状態の情報をデータベースに保持します。データベースにプロセスを格納することにより、プロセスを維持し、システムの停止やネットワークの問題が発生した場合の状態や信頼性の低下を防ぎます。Oracle BPEL Process Managerには、2つのタイプのプロセスがあります。これらのプロセスは、デハイドレーション・ストア・データベースに様々な方法で影響を与えます。

- 一時プロセス: このプロセス・タイプでは、プロセス実行時に中間デハイドレーション・ポイントは発生しません。未処理のフォルトがある場合、またはプロセス実行時にシステム停止時間がある場合、一時プロセスのインスタンスはトレースをシステムに残しません。一時プロセスのインスタンスは、(正常終了または異常終了に関係なく)処理中に保存できません。一時プロセスは通常、短期間のリクエスト/レスポンス形式のプロセスです。Oracle JDeveloperで設計する同期プロセスは、一時プロセスの例です。

- 永続プロセス: このプロセス・タイプでは、次のアクティビティのために、実行時にデータベースで1つ以上のデハイドレーション・ポイントが発生します。

- receiveアクティビティ

- pickアクティビティのOnMessageブランチ

- pickアクティビティのOnAlarmブランチ

- waitアクティビティ

永続プロセスのインスタンスは、(正常終了または異常終了に関係なく)処理中に保存できます。これらのプロセスは通常長期間存続し、一方向呼出しを介して開始されます。メモリー不足およびシステム停止時間の問題があるため、永続プロセスはメモリーについて最適化できません。

- コンポジット・インスタンスがOracle Enterprise Manager Fusion Middleware Controlに表示されず、SOAインフラストラクチャが実行中の場合は、「SOAインフラストラクチャの共通プロパティ」ページで、「監査レベル」が「オフ」に設定されていないことを確認します。これは、Oracle Enterprise Manager Fusion Middleware Controlで確認できます。

1. 「soa-infra」(SOA_cluster_name)を右クリックします。

2. 「SOA管理」→「共通プロパティ」の順に選択します。

- コンポジット・インスタンスが使用可能な場合は、oneWayDeliveryPolicy BPELプロパティの値を確認します。値をOracle Enterprise Manager Fusion Middleware Controlで確認できます。

1. ナビゲーション・ペインで、「soa-infra」(SOA_cluster_name)を展開します。

2. パーティションを展開し、コンポジットを選択します。
コンポジットに対する「ダッシュボード」ページが表示されます。

3. 右上隅にある「XML定義の表示」アイコンをクリックします。
そのコンポジットに対するcomposite.xmlの内容が表示されます。

これがasync.cacheに設定されている場合は、メッセージが失われる可能性があります。信頼性の高いメッセージのためには、async.persistに設定します。これは通常、composite.xmlファイルのBPELプロセス・サービス・コンポーネントのセクションで指定します。したがって、これはカスタム・コンポジットに設定できます。値がcomposite.xmlに設定されていない場合は、Oracle Enterprise Manager Fusion Middleware ControlのシステムMBeanブラウザのoneWayDeliveryPolicyの値が使用されます。次の値を指定できます。

- async.persist: メッセージは、データベース・ハッシュ・マップに保持されます。

- async.cache: メッセージはメモリーに格納されます。

- sync: 同じスレッドで直接起動が発生します。

これらの設定の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の「デプロイメント・ディスクリプタのプロパティ」の付録および「BPELプロセスでのトランザクションおよびフォルト伝播のセマンティクス」の章を参照してください。

システムMBeanブラウザにおけるoneWayDeliveryPolicyプロパティの設定の詳細は、第13.1項「BPELプロセス・サービス・エンジン・プロパティの構成」を参照してください。

トランザクションによって、応答が返されないターゲット非同期サービスが起動されている可能性もあります。この場合、コンポジット・インスタンス・フローには、ターゲット非同期サービスへのコールが表示されます。

- インスタンスがロールバックされ、メッセージがリカバリ中であることを確認します。

1. Oracle Enterprise Manager Fusion Middleware Controlにログインします。

2. 「soa-infra」(SOA_cluster_name)を右クリックし、「サービス・エンジン」→「BPEL」の順に選択します。

3. 「リカバリ」タブをクリックします。

これは、メッセージを受信する外部参照にアクセスできない場合に発生する可能性があります(たとえば、外部Webサービス、Siebelなどのエンタープライズ・アプリケーションなど)。

B.6.6 EDNの全体的なイベント配信を低速化する不良なコンポジットがSOAドメインに存在するかどうかのチェック

EDNはすべてのビジネス・イベントに対して、2つのアドバンスト・キューイング(AQ)キューをシリアル処理方式で内部的に使用します。特定タイプのイベントを使用できない不良なSOAコンポジット・アプリケーションが1つ以上存在すると、他のすべてのイベント・タイプのEDN配信が低速化して、AQキューでイベント・バックログが発生する可能性があります。

1. EDNロギングを有効にしたSOAサーバー・ログで、不良なSOAコンポジット・アプリケーションから繰返しエラーが発生しているかどうかをチェックします。たとえ対象のイベント・タイプとは無関係のまったく別個のSOAコンポジット・アプリケーションにエラーが存在する場合であっても、ターゲットSOAコンポジット・アプリケーションへの対象イベントの全般的な配信遅延の原因となる可能性があります。

2. 手順4の説明に従ってイベント・バックログの数をチェックします(イベントはアドバンスト・キューでスタックしています)。次のSQL問合せを実行して、この数を取得します(SOAINFRA-SCHEMA-USERをスキーマの所有者で置き換えます)。

SELECT COUNT(*) FROM SOAINFRA-SCHEMA-USER.EDN_OAOO_DELIVERY_TABLE;
SELECT COUNT(*) FROM SOAINFRA-SCHEMA-USER.EDN_EVENT_QUEUE_TABLE;

手順1で不良なコンポジットが見つかり、手順2でバックログされたイベントが大量に発生していた場合は、3に進みます。

3. 手順1で識別された不良なコンポジットを停止します。これはOracle Enterprise Manager Fusion Middleware ControlまたはWLSTコマンドライン・ユーティリティから行うことができます。

4. EDNスレッドの数を一時的に増やして(たとえば、3から5または7へ)、バックログされたイベントをより速やかにクリアします。

Oracle Enterprise Manager Fusion Middleware ControlのEDNConfig MBeanの構成を使用してEDNスレッドの数を変更する手順は次のとおりです。

1. ナビゲーション・ペインに移動します。

2. 「soa-infra」を右クリックします。

3. 「SOAインフラストラクチャ」→「管理」→「システムMBeanブラウザ」の順に選択します。

4. 「アプリケーション定義のMBean」→「oracle.as.soainfra.config」→「Server: soa_server-x」→「EDNConfig」→「edn」の順に開きます。

5. NumberOfThreads属性の値を変更して、「適用」をクリックします。
バックログ・イベント処理を重視しない場合は、バックアップされたイベントをAQで直接パージできます。パージ・スクリプトは次のとおりです。

DECLARE
purge_options dbms_aqadm.aq$_purge_options_t;
BEGIN
purge_options.block := FALSE;
DBMS_AQADM.PURGE_QUEUE_TABLE(
queue_table     => '&edn_user..edn_event_queue_table',
purge_condition => NULL,
purge_options   => purge_options);
DBMS_AQADM.PURGE_QUEUE_TABLE(
queue_table     => '&edn_user..edn_oaoo_delivery_table',
purge_condition => NULL,
purge_options   => purge_options);
END;
/
commit;

5. EDNバックログ数を定期的に監視して(手順2を参照)、その数が減少していることを確認します。クリアするスピードが非常に低速な場合は、EDNスレッド数をさらに増やすことができます(手順4を参照)。

6. 一定期間にわたり継続してEDNバックログ数を監視します。また、Oracle Enterprise Manager Fusion Middleware Controlで最近のインスタンスとフォルトを監視して、コンポジット・インスタンスが作成されているのか、または新しいフォルトが全体(つまりSOAインフラストラクチャ・レベルで)および対象のコンポジットの両方で出現しているのかをチェックします。

7. バックログがクリアされたら、EDNスレッドの数を前の設定または適切な数に戻します。

8. 対象のビジネス・イベントを公開して、予想されるインスタンスの作成によってターゲット・コンポジットがトリガーされることを確認します。

B.7 パフォーマンスのトラブルシューティング

この項では、パフォーマンスの問題をトラブルシューティングする方法について説明します。

B.7.1 インスタンスおよびフォルトのメトリックのあるページのロードの最適化

本番システムには、多数のコンポジット・インスタンスおよびフォルトが含まれることがあり、情報の取得が比較的遅くなると、Oracle Enterprise Manager Fusion Middleware Controlの各ページでタイムアウトが発生する可能性があります。SOAインフラストラクチャ、SOAコンポジット・アプリケーション、サービス・コンポーネントおよびサービス・エンジンの「ダッシュボード」ページ、SOAインフラストラクチャおよびサービス・エンジンの「デプロイ済コンポジット」ページ、およびパーティションのホーム・ページのロード・パフォーマンスを最適化するために、「SOAインフラストラクチャの共通プロパティ」ページで、次の処理を実行する2つのプロパティ設定を有効にできます。

- ページをロードする際にすべてのメトリック情報のロードを無効にします。インスタンスとフォルトのメトリックは、サーバーから必要に応じて取得できます。

注意:

この設定によって、フォルト、インスタンスおよび数のメトリックが無効になり、DMSメトリックは無効になりません。

- インスタンス、フォルトおよび数の取得を指定した期間(デフォルトの選択)に制限します。

インスタンスおよびフォルトのメトリックのあるページのロードを最適化する手順は、次のとおりです。

1. ナビゲータで「soa-infra」をクリックします。

2. 値が表示されるのは、「最新のコンポジット・インスタンス」セクションの「実行中」フィールドと「合計」フィールド、および「デプロイ済コンポジット」セクションの「インスタンス」列と「失敗したインスタンス」列です。これらの値が大きいと、このページや類似した情報を持つ他のページをロードするときに、時間がかかる場合があります。

3. 「SOAインフラストラクチャ」メニューから、「SOA管理」→「共通プロパティ」の順に選択します。

4. 「データ表示オプション」セクションで、インスタンス数とフォルト数のメトリックのフェッチの無効化チェック・ボックスを選択します。

5. 「適用」をクリックします。

6. 「SOAインフラストラクチャ」の「ダッシュボード」ページに戻ります。

7. 以前に表示されていた値がリンクに置き換えられています。

8. 「デプロイ済コンポジット」セクションで、特定のSOAコンポジット・アプリケーションのリンクをクリックして、インスタンス数に関する詳細を表示します。選択したリンクの値が計算されます。

9. 「OK」をクリックします。

10. 「インスタンス数」をクリックします。

メッセージに、SOAインフラストラクチャの実行中インスタンスおよび合計インスタンスの数が表示されます。

11. 「OK」をクリックします。

12. 「SOAインフラストラクチャの共通プロパティ」ページに戻ります。

13. 「データ表示オプション」セクションで、「インスタンスとフォルトの表示を次に制限: 過去time_period」チェック・ボックスが選択されていない場合は選択します。デフォルトで、このチェック・ボックスは選択済で、期間は24時間(1日)に設定されています。

14. 最新のインスタンス、フォルトおよび数のメトリックを表示用に取得する期間を指定します(例: 10分)。

15. 「適用」をクリックします。

16. 「SOAインフラストラクチャ」の「ダッシュボード」ページに戻ります。

17. ページの右上のセクションに次のメッセージが表示されることに注意してください。

Recent Instances and Faults for the last 10 minutes

18. 「インスタンス数」をクリックします。
期間に指定した値は、メッセージ・タイトルに表示されます。その期間の実行中メッセージおよび合計メッセージの数も表示されます。

19. 「OK」をクリックします。

20. 「デプロイ済コンポジット」セクションで、リンクをクリックします。

期間に指定した値は、メッセージ・タイトルに表示されます。選択したSOAコンポジット・アプリケーションに対するその期間の実行中メッセージおよび合計メッセージの数も表示されます。

これらのプロパティの設定方法については、第3.1項「SOAインフラストラクチャ・プロパティの構成」を参照してください。

注意:

- インスタンス数とフォルト数のメトリックを取得するリンクをクリックするとOracle Enterprise Manager Fusion Middleware Controlがタイムアウトする場合は、トランザクション・タイムアウト・プロパティの値を増やします。詳細は、B.3.1項「接続タイムアウトの解決」を参照してください。

- 「再計算」をクリックすると、再計算がすぐに実行されますが、進行状況インジケータは表示されません。ただし、データに対する更新は画面に反映されます。

B.7.2 開いているファイルが多すぎることが原因で発生したメッセージの失敗の解決

使用中のJARファイル数、またはJDK 6/JREによるファイル記述子の使用(あるいはその両方)によっては、実行時またはコンパイル時に、次のエラーが発生する可能性があります。

Message send failed: Too many open files

このエラーを解決するには、ファイル記述子の数を少なくとも4096に増やします。

1. descriptorsの値を識別するには、limitコマンド(C shellの場合)またはulimitコマンド(Bash shellの場合)を使用します。通常、1024の値は低すぎます(特にJDK 6の場合)。

% limit

cputime      unlimited
filesize     unlimited
datasize     unlimited
stacksize    10240 kbytes
coredumpsize unlimited
memoryuse    unlimited
vmemoryuse   unlimited
descriptors  1024
memorylocked 500000 kbytes
maxproc      46720

2. rootユーザーでオペレーティング・システムにログインします。

3. /etc/security/limits.confファイルを編集してdescriptorsの値を大きくします。
この例の場合、すべてのユーザーについて制限を4096に増やすと、limits.confファイルは、次のようになります。

#<domain>      <type>  <item>         <value>
#

#*               soft    core            0
#*               hard    rss             10000
#@student        hard    nproc           20
#@faculty        soft    nproc           20
#@faculty        hard    nproc           50
#ftp             hard    nproc           0
#@student        -       maxlogins       4

# End of file
@svrgroup    soft    memlock         500000
@svrgroup    hard    memlock         500000
*           soft    nofile          4096
*           hard    nofile          4096

4. 端末を閉じてから再度開き、変更内容を有効にします。システムの再起動は不要です。

B.7.3 ペイロードが大きいことによって発生するMaxMessageSizeExceededExceptionエラーの解決

デプロイ済のSOAコンポジット・アプリケーションに大きなペイロード(たとえば、12 MB)を指定し、そのペイロードを表示するために、監査証跡で「XML文書の表示」をクリックすると、MaxMessageSizeExceededExceptionエラーが発生することがあります。このエラーは、次のJVMパラメータを設定することによって解決できます。

1. 次のファイルを開きます。

- UNIXオペレーティング・システムでは、$MIDDLEWARE_HOME/user_projects/domains/domain_name/bin/setDomainEnv.shを開きます。

- Windowsオペレーティング・システムでは、MIDDLEWARE_HOME\user_projects\domains\domain_name\bin\setDomainEnv.batを開きます。

2. 次の値を指定してweblogic.MaxMessageSizeプロパティを追加します。

EXTRA_JAVA_PROPERTIES="${EXTRA_JAVA_PROPERTIES}
-Dweblogic.MaxMessageSize=20000000"
export EXTRA_JAVA_PROPERTIES

3. サーバーを再起動します。

B.7.4 表領域の拡張による実行時の問題の回避

データベース表領域が拡張されていない場合は、実行時処理に影響を与える可能性があります。メッセージが処理または保持されず、例B-3のような例外エラーがログ・ファイルに表示される可能性があります。これは、Oracle BPEL Process Managerではインスタンス・データの格納をデータベースに依存しているためです。データベースが使用可能でない場合は、実行時処理に影響を与えます。

例B-3 例外エラー

INFO: MediatorServiceEngine returning after processing the request for
operation = processResponse

[EL Warning]: 2009.01.14 11:46:16.783--UnitOfWork(32372128)--Exception
[EclipseLink-4002] (Eclipse Persistence Services - 1.1 (Build
SNAPSHOT-20081007)): org.eclipse.persistence.exceptions.DatabaseException
Internal Exception: java.sql.BatchUpdateException: ORA-01691: unable to
extend lob segment SH_SOAINFRA.SYS_LOB0000145067C00007$$ by 1024 in
tablespace SH_SOAINFRA

Error Code: 1691
Query: InsertObjectQuery(com.collaxa.cube.persistence.dto.AuditTrail@199b33d)
[EL Warning]: 2009.01.14 11:46:16.782--UnitOfWork(32372128)--Exception
[EclipseLink-4002] (Eclipse Persistence Services - 1.1 (Build
SNAPSHOT-20081007)): org.eclipse.persistence.exceptions.DatabaseException
Internal Exception: java.sql.BatchUpdateException: ORA-01691: unable to
extend lob segment SH_SOAINFRA.SYS_LOB0000145067C00007$$ by 1024 in
tablespace SH_SOAINFRA
. . .
. . .

表領域は、サイズ制限に達したときに、それ自体が指定のサイズだけ拡張するように設定してください。自動拡張を有効にしない場合は、表領域がクリティカルまたは警告のしきい値サイズに達したことを示すアラートが生成されたときに、必ず対応してください。サイズ・アラートには、表領域サイズを手動で大きくすることで対応できます。

B.7.5 大量のトランザクションによるデータベース増大の問題の解決

Oracle SOA Suiteトランザクションが失敗して、データベースの領域不足がログに示されている場合は、大量のトランザクションによってデハイドレーション・ストアまたはMDSストアの領域が不足している可能性があります。後者の場合は、次のようなエラーが表示されます。

java.sql.SQLException: ORA-01653: unable to extend table SH_MDS.CUBE_INSTANCE by
16 in tablespace FUSION_TS_TOOLS

これは、表領域が満杯で、データベースがこれを拡張できないことを示します。

次のタスクを実行します。

1. 適切なレコード保存ポリシーを考慮して、アプリケーションがランタイム・データに依存していないことを確認しながら、デハイドレーション・ストア表を定期的にパージします。
パージの後で、領域を結合するコマンドを実行する必要があります。パージ戦略を機能させるためには、どれくらいの期間データをデータベースに保持する必要があるかを理解することが重要です。保存ポリシーは、次のような要因から決定されます。

- 法律的な要件

- ライン・オブ・ビジネスの要件

- データの保存に関する全般的な会社のポリシー

保存ポリシーが長くなるほど、格納する必要があるデータの量が増加し、それに応じて必要なディスク容量も多くなります。

パージ戦略の作成の詳細は、第9章「Developing a Database Growth Management Strategy」および第10章「データベース増分の管理」を参照してください。

2. パーティション化するために表を構成する前に、Oracleデータベースのパーティション化の需要に対処するための十分なリソースがデータベース・ハードウェアにあることを確認します。
デハイドレーション・ストアに対しては、レンジ・パーティション化とハッシュ・パーティション化を使用するデータベース・パーティション化が最適なソリューションです。パーティション化は、複数の表にデータを格納することで大きなデータ・セットをより小さく管理しやすいデータ・セットにすることと定義されます。パーティション化戦略は、メンテナンス・オーバーヘッド(パーティションの削除とプルーニング)を軽減してパフォーマンスを改善するうえで大きな役割を担います。パーティション化は、少なくとも、アクティビティが活発な表について行う必要があります。これは、ディスクI/Oを分散させてホット・ディスクを防止するうえで大きな役割を果たします。パーティション化のために表を構成する前に対応することが必要な重要な要件は、Oracleデータベースのパーティション化の需要に対処するための十分なリソースがデータベース・ハードウェアにあることを確認することです。本番前のテストでインストールが大規模であると示された場合は、パーティション化機能を利用するために環境(CPU、メモリーおよびディスク領域)を正しくサイズ調整していることが期待されます。

3. 最大限のパフォーマンスが得られるように、メモリー、表領域およびパーティションに対してデータベース・パラメータを調整します。詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』の、「データベース・パラメータのチューニング」に関する項を参照してください。

4. 領域不足の他の表領域について、次の問合せを使用して空き表領域をチェックします。

SELECT TOTAL.TABLESPACE_NAME "TABLESPACE NAME", FREE_SPACE, (TOTAL_SPACE-FREE_
SPACE) USED_SPACE, TOTAL_SPACE, ROUND((FREE_SPACE*100/TOTAL_SPACE),2) "FREE %"
FROM (SELECT TABLESPACE_NAME, SUM(BYTES/1024/1024) FREE_SPACE FROM SYS.DBA_
FREE_SPACE GROUP BY TABLESPACE_NAME) FREE,
(SELECT TABLESPACE_NAME, SUM(BYTES/1024/1024) TOTAL_SPACE FROM SYS.DBA_DATA_
FILES GROUP BY TABLESPACE_NAME) TOTAL
WHERE FREE.TABLESPACE_NAME = TOTAL.TABLESPACE_NAME AND TOTAL.TABLESPACE_NAME =
'<TABLESPACENAME>'
ORDER BY 5;

5. 表領域設定を増やすには、管理者アカウントを使用します。例:

ALTER TABLESPACE TABLESPACE_NAME ADD DATAFILE 'DATAFILE_NAME' SIZE 500M
AUTOEXTEND ON;

詳細は、第B.7.2項「開いているファイルが多すぎることが原因で発生したメッセージの失敗の解決」を参照してください。

B.7.6 ページ表示やトランザクション終了に長時間かかるといったアプリケーションの低速パフォーマンスの観察

ときによって、低速なアプリケーション・パフォーマンスやメモリー・トラッシュが観察される場合があります。たとえば、ページのロードと表示やコンポジット・トランザクションの完了に時間がかかる場合があります。レスポンスが通常より遅く感じられる場合があります。

低速パフォーマンスは様々な原因で発生します。たとえば、多数のサーバーが同じホスト上で実行されている状況や、多数のレコード、セッションまたはロックがデータベースに存在する状況が、原因として考えられます。スレッド競合もパフォーマンス不良の原因になる可能性があります。

注意:

この問題が発生すると、Oracle Enterprise Manager Fusion Middleware Controlでの構成の変更は一切できなくなる可能性があります。

この問題を診断する手順は次のとおりです。

1. CPU使用率をチェックして、CPU容量に対して負荷やプロセスが過大または過多なためにCPUが飽和していないかどうかを調べます。
通常の負荷でCPU使用率が100%の場合(目標は70-80%)、ピーク負荷を処理する容量はなく、ハードウェア・リソースは不十分です。追加の負荷を処理できるようにスケールアウト・サーバーを追加してください。

2. パフォーマンスについてレポートするOracle Enterprise Manager Fusion Middleware Controlを使用してアプリケーションをチェックします。BPELプロセスの監査証跡で、サービス、起動時間およびレスポンス時間のパフォーマンスをチェックします。

3. パフォーマンスを最大化するために、ロギング・レベルをデフォルトの「INFO」レベルより高く設定しないことをお薦めします。
デバッグを行う場合は、ロギング・レベルをFINESTレベルに設定する必要があります。ただし、問題が解決されたら、最善のパフォーマンスを得るために、ロギング・レベルをデフォルト・レベルにリセットしてください。また、「SOAインフラストラクチャの共通プロパティ」ページで「監査レベル」を「本番」に設定することもお薦めします。これはOracle Enterprise Manager Fusion Middleware Controlで次のように設定できます。

1. 「soa-infra」(SOA_cluster_name)を右クリックします。

2. 「SOA管理」→「共通プロパティ」の順に選択します。

3. 「監査レベル」を「本番」に設定します。

4. サービス・レベル合意(SLA)を維持するために、保存要件に基づいて定期的にパージします。
データの増加によってパフォーマンスの問題が発生する可能性がある表を識別するには、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』のインスタンス・データ増加の影響を受ける表の識別に関する項を参照してください。

パージ・スクリプトの使用の詳細は、第10章「データベース増分の管理」を参照してください。

5. TopやGlanceなどのモニタリング・ツールを使用して、メモリー、IO、ページング、スワッピング、CPU使用率の負荷の統計をチェックします。

6. フル・ガベージ・コレクションまたはメモリー不足エラーを避けるために、JVMを最適化します。
頻繁なガベージ・コレクションは、高いメモリー使用率またはメモリー・リークのいずれかが原因で発生する可能性があります。

1. オペレーティング・システム・レベルのページング・アクティビティを回避するために、システムで実行されている全JVMの最大ヒープ・サイズの合計が、使用可能な物理RAMの量を超えないようにします。

2. JRockit Mission Controlメモリー・プロファイリング・ツールを使用して、スレッド・ ダンプとメモリー・スナップショットを取得します。これはOracleサポート・サービスがコードの問題をデバッグする一助となります。スレッド・ ダンプの詳細は、第12章「SOAコンポジット・アプリケーションに関する問題の診断」を参照してください。

7. 競合を回避するためにスレッドを最適化します。調査のためのスレッド・ダンプを取得して、Oracleサポート・サービスにこれを送信します。

8. JVMとスレッド・ ダンプでデータベースの起動方法をチェックして、データベースのパフォーマンスがボトルネックになっているかどうかを識別します。

9. データベースAWRスナップショットを実行して、データベース・パフォーマンスの問題の原因を識別します。

10. データベースの統計が定期的に更新されていることと、メモリー、表領域およびパーティションのチューニング可能な他のパラメータが最大限のパフォーマンスが得られるように効果的に使用されていることを確認します。
チューニング上の一般的な推奨事項を次に示します。詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』のデータベース・パラメータのチューニングに関する項を参照してください。

- 可能であれば、物理的に別個のディスク領域に索引と表を配置します。

- ロールバック・セグメントは、データ・セグメントや索引セグメントと一緒に配置しないでください。

- 非常にアクティブな表や索引は、各自の表領域に分離します。

- ディスクI/Oを分散させてホット・ディスクを防止するために、非常にアクティブな表や索引をパーティション化します。

- データベース表の統計を定期的に生成するためのプロセスを配備します。

11. 大きなオブジェクトの高水位標(HWM)競合を抑制するために、データベース表をチューニングします。HWM競合を抑制し、AQのメッセージを生成および使用する際に一貫したパフォーマンスを確保できるように、データベース・アドバンスト・キュー(AQ)をチューニングします。
知っておく必要があるEDN AQ名は、EDN_EVENT_QUEUE_TABLEとEDN_OAOO_DELIVERY_TABLEです。

12. 最適な設定を確保できるように、BPELプロセスおよびEDNスレッド数をチューニングします(たとえば、Oracle Enterprise Manager Fusion Middleware Controlの「BPELサービス・エンジン・プロパティ」ページの「ディスパッチャ呼出しスレッド」および「ディスパッチャ・エンジン・スレッド」プロパティ)。スレッド構成が大きすぎると、サーバーはメモリー不足になります。小さすぎると、メッセージのバックアップが開始されます。

13. オーバーヘッドを削減するようにBPELプロセス・プロパティをチューニングします(たとえば、不要な場合は、Oracle Enterprise Manager Fusion Middleware Controlの「BPELサービス・エンジン・プロパティ」ページの「ValidateXML」および「StatsLastN」(バッチ・サイズを収集する統計)プロパティを無効にします)。

14. パッケージ化されたアプリケーション(Siebelなど)と統合している場合は、レガシー・アプリケーションに問題がないかどうかをチェックします。

様々なコンポーネントのパフォーマンスのチューニングの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』の「トップ・パフォーマンス領域」に関する章とSOA Suiteコンポーネントに関する項を参照してください。

「BPELサービス・エンジン・プロパティ」ページでのプロパティの設定の詳細は、第13章「BPELプロセスのサービス・コンポーネントとエンジンの構成」を参照してください。

B.7.7 送信メッセージ速度を超える受信メッセージ速度の観察

メッセージの受信速度がメッセージの処理速度(送信速度)を超えると、例B-4のような警告メッセージが表示されます。

例B-4 受信メッセージ速度が処理メッセージ速度を超えた場合の警告メッセージ

[2012-04-09T16:49:40.342-04:00] [Soa_server1] [WARNING] []
[oracle.soa.bpel.engine.dispatch] [tid:
weblogic.work.j2ee.J2EEWorkManager$WorkWithListener@e3d0e3d
] [userId: <anonymous>] [ecid: 0000JSnNKVTBh4Z5ln1FiZ1Fdnmd001gWL,0] [APP:
soa-infra] BPEL service engine is overloaded, the inflow is higher than the
outflow, there are "100000" invoke messages pending in the dispatcher in-memory
cache, the configured threshold is "102",the new incoming invoke messages will not
be dispatched or processed immediately, they are going to be persisted in the
dehydration store and can be recovered later using recovery.

この問題を解決するには、処理速度を上げるか、受信速度を下げます(受信を絞ります)。受信速度より処理速度が低速な状態は、次の1つまたは全部の問題が原因となって発生する可能性があります。

- 呼出しスレッドが不足している

- JVM容量が不足している

- BPELプロセスがコールしている外部パートナが拡張できないため、BPELプロセスでメッセージのバックアップが実行されている

正確な原因を識別してそれらを解決するには、次の手順を実行します。

1. composite.xmlファイルのoneWayDeliveryPolicyプロパティ値をチェックします。これはasync.persist、async.cacheまたはsyncに設定されていますか。このプロパティの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の「デプロイメント・ディスクリプタのプロパティ」に関する付録を参照してください。

2. BPELプロセスから外部サービスへの送信呼出しが、外部サービスのスケーラビリティが低いためにバックアップされていないことを確認します。外部サービスにボトルネックがある場合は、Oracle SOA Suiteで実行するチューニング(つまり、手順3と4)はまったく効果がありません。最初にこのボトルネックを解決することが必要です。

3. JVMガベージ・コレクション(GC)を監視します。GCが頻繁に通常以上になってJVMがほぼ容量満杯になっている場合は、JVMヒープ・サイズを大きくします。JVMに十分な容量がない場合、手順4で実行するチューニングによって事態は悪化します。

4. 受信メッセージ処理用のサーバーのスレッドを増やすために、「BPELサービス・エンジン・プロパティ」ページでディスパッチャ呼出しスレッドとディスパッチャ・エンジン・スレッドの値を大きくします。詳細は、第13.1項「BPELプロセス・サービス・エンジン・プロパティの構成」を参照してください。

B.8 サーバーのトラブルシューティング

この項では、サーバーの問題をトラブルシューティングする方法について説明します。

サーバー起動の問題の詳細は、第3.2項「管理対象サーバーとSOAインフラストラクチャの停止と起動」を参照してください。

B.8.1 管理対象サーバーの起動および停止のベスト・プラクティス

次の(両方ではなく)いずれかの方法で管理対象サーバーを起動および停止することをベスト・プラクティスとしてお薦めします。管理対象サーバーをコマンドラインから起動して、Oracle Enterprise Manager Fusion Middleware Controlから停止する(または、その逆)など、これらの方法を組み合せないでください。

- Oracle Enterprise Manager Fusion Middleware Control
この方法を使用する場合は、ノード・マネージャが起動され実行中である必要があります。Oracle Enterprise Manager Fusion Middleware Controlから実行される管理対象サーバーのすべての起動および停止は、ノード・マネージャによって追跡されます。この方法では、サーバーの状態は問題にはなりません。

- コマンドライン
この方法を使用する場合、サーバーの状態はノード・マネージャによって追跡されません。このため、サーバーをコマンドラインから起動し、Oracle Enterprise Manager Fusion Middleware Controlから停止すると、Oracle WebLogic管理サーバーはステータスを判断するためにノード・マネージャにアクセスしますが、「不明」という状態が返されます。

Oracle Enterprise Manager Fusion Middleware Controlからサーバーを停止および起動する手順は、次のとおりです。

1. 「WebLogicドメイン」を展開します。

2. 管理対象サーバー(例: soa_server1という名前のサーバー)を選択します。

3. 「制御」→「停止」の順に選択します。

4. 「制御」→「起動」の順に選択します。

コマンドラインからの管理対象サーバーの起動および停止の詳細は、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suiteインストレーション・ガイド』を参照してください。

B.8.2 SOAサーバー起動の問題の診断

SOAサーバー(soa_infra)が起動しない場合、サーバー起動の問題には様々な原因が考えられます。検出によるアプローチを使用して根本原因を見つける必要があります。問題を診断する最初の試みとして、サーバーと診断ログをチェックします。さらに、次をチェックしてください。

サーバー起動の問題を診断する手順は次のとおりです。

1. データベースが使用できないかどうか、または使用可能な接続が不足しているかどうかをチェックします。Oracle SOA Suite実行時の一部の障害は、データベースの停止や接続の問題によって発生します。次の手順を実行してください。

1. Oracle WebLogic Server管理コンソールにログインします。

2. 「ドメイン構造」で、「サービス」→「データ・ソース」→「SOADatasource」→「監視」→「テスト」の順に選択してデータ・ソースをテストして、ステータスを表示します。これはSQLプロンプトからもチェックできます。

2. ポートの競合がないかどうか、使用されているポートのリストをチェックします。

3. MDSリポジトリが共有ドキュメントをロードできないかどうかをチェックします(不正なMDS構成またはMDSスキーマを保持するデータベースが到達不可能)。

4. Oracle SOA Suiteクラスタを使用している場合は(ユニキャストまたはマルチキャストの使用)、Oracle Coherenceの構成をチェックします。
この問題はプロビジョニングの完了後のみ適用されます。ポートの競合がある場合(Oracle Coherenceによって使用されている場合)、SOAサーバーのクラスタリングは失敗する場合があります。たとえば、一方のSOAサーバーがデプロイメントを取得できても、もう一方のサーバーが取得できない可能性があります。ときによって、これは次のエラーのみを示す場合があります。

[soa_server1] [ERROR] [] [Coherence] [tid: Logger@352821903 3.6.0.4]
[ecid: 46f620208907e045:63f295ec:12dd091ec2e:-8000-0000000000000003,1:27187]
[APP: soa-infra] 2011-01-28 23:06:19.463/414.816 Oracle Coherence GE 3.6.0.4
<Error> (thread=[ACTIVE] ExecuteThread: '0' for queue: 'weblogic.kernel.Default
(self-tuning)', member=n/a):
Error while starting cluster: com.tangosol.net.RequestTimeoutException: Timeout
during service start: ServiceInfo(Id=0, Name=Cluster, Type=Cluster[[...

この例では、Oracle Coherenceタイムアウトが重要な役割を果たしています。ただし、次のように無関係のエラーを示す場合もあります。

Error creating bean with name 'SensorManager' defined in ServletContext
resource

この根本原因も、主としてOracle Coherenceの構成に関係しています。

5. 管理サーバーと管理対象サーバーの両方のポートがオープンでアクセス可能であるかどうかをチェックします。

6. 管理サーバーに到達できないために管理対象サーバーの起動が失敗したかどうかをチェックします。

7. ネットワークの問題をチェックします(たとえば、問題の原因となっている可能性があるIPルーティングのフィルタやルール)。

8. Oracle WebLogic Server LDAPセキュリティの破損をチェックします。
管理対象サーバーは、アプリケーションのシステムMBeanブラウザのポリシーがすでに存在しているかどうかをレポートする場合があります。

詳細は、『Oracle Fusion Middleware Oracle SOA Suiteエンタープライズ・デプロイメント・ガイド』の管理コンソール用フロントエンドURLの設定とリダイレクト・プリファレンスの設定に関する項とフロントエンドHTTPホストおよびポートの設定に関する項を参照してください。

B.8.3 プロキシ・サーバーの指定

システム・プロパティを使用してプロキシ・サーバーを指定するには、クライアント・アプリケーションを通常の方法で記述し、クライアント・アプリケーションを実行するとき、Javaシステム・プロパティを指定します。例B-5に詳細を示します。

例B-5 プロキシ・サーバーの指定

setenv PROXY_SETTINGS "-DproxySet=true
-Dhttp.proxyHost=www-myproxy.us.mycompany.com -Dhttp.proxyPort=80
-Dhttp.nonProxyHosts=localhost|*.us.mycompany.com
|0:0:0:0:0:0:0:1|fe80:0:0:0:250:56ff:fe31"

注意:

http.proxyHostおよびhttp.proxyPortなどのプロキシ・プロパティの値を指定する場合は、http.nonProxyHostsプロパティも指定します。

B.8.4 一部のローエンドのホストで、フロー・ダイアグラムが初回に表示されない

Oracle Enterprise Manager Fusion Middleware Controlで、一部のローエンドのホストにおいて、デプロイ済のSOAコンポジット・アプリケーションのインスタンスIDのフロー・ダイアグラムが、初回に表示されない場合があります。かわりに、リソースのロードに失敗しましたというメッセージを受信します。

このことを回避するには、フローのトレース・ページを閉じ、インスタンスIDをクリックして、フローのトレース・ページに戻ります。

B.8.5 IPv4とIPv6をサポートするデュアル・スタック・ホスト上のOracle Enterprise Manager Fusion Middleware Controlへのアクセス

IPv4とIPv6の両方がサポートされているデュアル・スタック・ホスト上でOracle SOA Suiteを実行する場合は、Oracle Enterprise Manager Fusion Middleware ControlのIPv6のURLにIPv4クライアントがアクセスするには、表B-23に示されているようにetc/hostsファイルを更新する必要があります。

表B-23 etc/hostsファイルのIPv4とIPv6の設定

クライアント

etc/hostsファイルを次のように編集します

IPv4クライアント上で:

xx.xxx.xxx.xxx myhost10-ipv6

ここで、xx.xxx.xxx.xxxはIPv6のIPアドレスです。

IPv6クライアント上で:

2001:0db8:db0a::0:1  myhost10-ipv6 myhost10-ipv6.us.example.com

注意: 2001:0db8:db0a::0:1は、使用するホスト環境に適した値に置き換えます。

B.9 ブラウザのトラブルシューティング

この項では、ブラウザの問題をトラブルシューティングする方法について説明します。

B.9.1 Safariブラウザを使用してWSDLファイルの内容を表示する場合の制限

Safariブラウザを使用する場合は、Oracle Enterprise Manager Fusion Middleware ControlでのWSDLファイルの内容の表示に関する、次の制限と回避策に留意してください。Mozilla Firefoxは正常に動作するため、この回避策は必要ありません。

1. SOAコンポジット・アプリケーションのホーム・ページに移動します。

2. ページの上部にある「WSDLおよびエンドポイントURIの表示」リンクをクリックします。

3. 表示されている「WSDL」リンクをクリックします。
選択したWSDLの内容が表示されていない空白ページが開きます。

回避策として、次の追加の手順を実行します。

4. このページの右上隅にある現在のページのメニューを表示するアイコンをクリックします。

5. 表示されたメニューから「ソースの表示」を選択します。
これにより、選択したWSDLの内容が別のページに表示されます。

B.10 その他のトラブルシューティングのドキュメント

表B-24に、その他のトラブルシューティングの問題について参照するドキュメントを示します。

表B-24 その他のトラブルシューティングのドキュメント

参照内容

参照先

SOAインフラストラクチャの起動とシャットダウンの問題

第3.2項「管理対象サーバーとSOAインフラストラクチャの停止と起動」

WebLogic診断フレームワーク(WLDF)および診断フレームワーク(DFW)を使用した、Oracle SOA Suiteの問題の診断

第12章「SOAコンポジット・アプリケーションに関する問題の診断」

大規模ドキュメントとメタデータの管理、および多数のインスタンスを含む環境の管理

『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の「大規模ドキュメントおよび多数のインスタンスの管理」の章

デプロイメント・エラーとコンパイル・エラー

『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のテストおよびトラブルシューティングに関する項

Oracle WSM Policy Managerエラー

『Oracle Fusion Middleware Webサービスのためのセキュリティおよび管理者ガイド』の「問題の診断」の章

Oracle Business Activity Monitoring (BAM)

『Oracle Fusion Middleware Oracle Business Activity Monitoringユーザーズ・ガイド』の「トラブルシューティング」に関する付録

Oracle Business Rules

『Oracle Fusion Middleware Oracle Business Rulesユーザーズ・ガイド』の「Oracle Business Rulesのトラブルシューティング」に関する付録

Oracle User Messaging Service

第27.7項「Oracle User Messaging Serviceのトラブルシューティング」

C Oracle Enterprise ManagerのOracle SOA Suiteユーザーのロールおよび権限

この付録では、ロール・ベースのアクセス、およびOracle Enterprise Manager Fusion Middleware ControlのOracle SOA Suiteページにアクセスする場合に、管理者、オペレータおよびモニターの各ロールのユーザーに認可されている権限について説明します。

この付録には次の項が含まれます:

- C.1項「ロールおよび権限」

ロールの作成方法、グループへのユーザーの追加方法、ロールとポリシーを使用してリソースを保護する方法の詳細は、Oracle Fusion Middleware Oracle WebLogic Serverでのロールとポリシーを使用したリソースの保護とOracle Fusion Middleware Oracle WebLogic Server管理コンソールのオンライン・ヘルプを参照してください。コンソール・ヘルプの「目次」リンクをクリックして、前述のタスクを実行する手順にアクセスします。

C.1 ロールおよび権限

Oracle Enterprise Manager Fusion Middleware Controlは、ロール・ベースのアクセスの概念をサポートしています。ユーザーは異なるロールにマップされ、各ロールは異なる一連の権限に対応しています。このメカニズムを使用すると、特定のユーザーに単一の監視権限(表示専用アクセスなど)をプロビジョニングできます。一方、管理者には、完全アクセス(構成の更新、サーバーの再起動などを実行できる権限)を付与できます。

Oracle Enterprise Manager Fusion Middleware ControlのOracle WebLogic Serverには、次のロールが定義されています。

- 管理者
このロールは、完全な管理機能および監視機能を提供します。

- オペレータ
このロールは、制限された管理機能を提供します。

- モニター
このロールは、読取り専用の機能を提供します。

Oracle Enterprise Manager Fusion Middleware Controlで実行可能なアクションは、Oracle WebLogic Serverエンタープライズ・ロール(モニター、オペレータおよび管理者)を使用して保護されます。Oracle Enterprise Manager Fusion Middleware Controlが適切に動作するためには、Oracle SOA Suiteアプリケーション・ロールにユーザー・ロールかエンタープライズ・ロールのいずれかを正しくマップする必要があります。

通常、次のマッピングが有効です。

- SOAMonitorアプリケーション・ロールに対するOracle WebLogic Serverモニター・エンタープライズ・ロール

- SOAOperatorアプリケーション・ロールに対するOracle WebLogic Serverオペレータ・エンタープライズ・ロール

- SOAAdminアプリケーション・ロールに対するOracle WebLogic Server管理者エンタープライズ・ロール

Oracle SOA Suiteアプリケーション・ロールにOracle WebLogic Serverエンタープライズ・ロールをマップした場合は、Oracle WebLogic Serverエンタープライズ・ロールのすべてのユーザーに対するアクセス権が等しく付与されますが、SOAアプリケーション・ロールにユーザーをマップした場合は、アクセスが特定のユーザーのみに制限されます。

注意:

- Oracle WebLogic Serverグループまたはユーザーに対するSOAMonitorおよびSOAOperatorロールのデフォルトのマッピングはありません。これらのロールは、手動でOracle Enterprise Manager Fusion Middleware Controlにマップする必要があります。詳細は、第5.2項「Oracle WebLogic ServerグループまたはユーザーへのSOAOperatorおよびSOAMonitorロールのマッピング」を参照してください。

- Oracle Enterprise Manager Fusion Middleware Controlを使用するには、Oracle WebLogic Serverエンタープライズ・ロール(Oracle WebLogic Serverモニターなど)およびOracle SOA Suiteアプリケーション・ロール(SOAMonitorなど)の両方が必要です。これらのロールの一方のみを保持していても、Oracle Enterprise Manager Fusion Middleware Controlは正しく動作しません。

- Oracle WebLogic ServerグループまたはユーザーにOracle SOA Suiteアプリケーション・ロールをマップする際は注意が必要です。たとえば、Oracle WebLogic Serverモニター・ロールを持つユーザーがSOAOperatorロールにマップされた場合、そのユーザーはOracle SOA Suiteのバックエンドでのデプロイメント権限を保持しますが、Oracle Enterprise Manager Fusion Middleware Controlにコンポジットをデプロイすることはできません。これは、Oracle Enterprise Manager Fusion Middleware Controlによって、ユーザーがOracle WebLogic Serverモニター・ロールを保持している(つまり、デプロイメント・オプションが無効になっている)と識別されるためです。

C.1.1 全体的なロール機能のマトリックス

表C-1に、適切なロール・マッピングを持つユーザーが実行できるアクションを示します。

表C-1 ロール機能のマトリックス

アクション

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

監視メトリックの表示

はい

はい

はい

構成の表示

はい

はい

はい

構成の更新

いいえ

いいえ

はい

フォルト処理アクション

いいえ

はい

はい

「Webサービスのテスト」ページでのインスタンスの作成

はい

注意: OWSMポリシーによってコンポジット・テスト・インスタンスの作成を制限できます。

はい

はい

コンポジットの起動、停止、リタイア、アクティブ化

いいえ

はい

はい

ユニット・テストの実行

いいえ

はい

はい

ポリシーのアタッチおよびデタッチ

いいえ

いいえ

はい

インスタンス、フローのトレースおよび監査証跡の表示

はい

はい

はい

監査証跡ペイロードの表示

はい

はい

はい

インスタンスの削除

いいえ

いいえ

はい

SOAインフラストラクチャの起動および停止

いいえ

はい

はい

デプロイメント・オプション(デプロイ、アンデプロイおよび再デプロイ)の実行

いいえ

はい

はい

コンポジット・プロパティ(ペイロードと監査レベルの有効化)の変更

いいえ

はい

はい

パーティションの作成

いいえ

いいえ

はい

パーティションの削除

いいえ

いいえ

はい

コンポジットのライフサイクルの一括管理(すべて起動、すべて停止、すべてリタイア、およびすべてアクティブ化)

いいえ

はい

はい

注意:

ナビゲータで「WebLogicドメイン」フォルダを選択すると、ページ最上部に「WebLogicドメイン」メニューが表示されます。管理者ロールを持つユーザーは、このメニューの「アプリケーション・デプロイメント」オプションを使用して、Java EEアプリケーションをデプロイできます。オペレータ・ロールを持つユーザーは、Java EEアプリケーションをデプロイすることはできません。

C.1.2 「SOAインフラストラクチャ」ページへのアクセス

表C-2に、ユーザーがこのページにアクセスするために最低限必要なロールと、適切なロール・マッピングを持つユーザーがこのページに対して保持している権限を示します。

表C-2 「SOAインフラストラクチャ」ページ

ページの要素

アクセスするための最低限のロール

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

「ダッシュボード」タブの表示

モニター

はい

はい

はい

「デプロイ済コンポジット」タブの表示

- 起動/停止(SOAインフラストラクチャ)

- アクティブ化/リタイア

- デプロイ・オプション

- デフォルトとして設定

モニター

オペレータ

オペレータ

オペレータ

オペレータ

はい

いいえ

いいえ

いいえ

いいえ

はい

はい

はい

はい

はい

はい

はい

はい

はい

はい

「インスタンス」タブの表示

- 「削除」オプション(すべて)

- 中断

モニター

管理者

管理者

はい

いいえ

いいえ

はい

いいえ

いいえ

はい

はい

はい

「フォルト・メッセージと拒否メッセージ」タブの表示

- リカバリ・アクション

- 拒否メッセージの削除

モニター

オペレータ

管理者

はい

いいえ

いいえ

はい

はい

いいえ

はい

はい

はい

C.1.3 「SOAインフラストラクチャ」メニューへのアクセス

表C-3に、ユーザーがこのメニューのオプションにアクセスするために最低限必要なロールと、このメニュー・オプションに対して各ロール・マッピングが保持している権限を示します。

表C-3 「SOAインフラストラクチャ」メニュー

メニュー項目

アクセスするための最低限のロール

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

コントロール

オペレータ

いいえ

はい

はい

SOAデプロイ

オペレータ

いいえ

はい

はい

「ログ」→「ログ構成」

管理者

いいえ

いいえ

はい

その他のメニュー項目

モニター

はい

はい

はい

C.1.4 「SOAコンポジット」メニューへのアクセス

表C-4に、ユーザーがこのメニューのオプションにアクセスするために最低限必要なロールと、このメニュー・オプションに対して各ロール・マッピングが保持している権限を示します。

表C-4 「SOAコンポジット」メニュー

メニュー項目

アクセスするための最低限のロール

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

SOAデプロイ

オペレータ

いいえ

はい

はい

サービスのテスト

モニター

はい

はい

はい

その他のメニュー項目

モニター

はい

はい

はい

C.1.5 コンポジットのホーム・ページへのアクセス

表C-5に、ユーザーがこのページにアクセスするために最低限必要なロールと、このページに対して各ロール・マッピングが保持している権限を示します。

表C-5 コンポジットのホーム・ページ

ページの要素

アクセスするための最低限のロール

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

「ダッシュボード」タブの表示

- コンポジット・サービスのテスト・アクション

- アクティブ化/リタイア・アクション

- 起動/停止アクション

- プロパティの変更(設定)

モニター

オペレータ

オペレータ

オペレータ

オペレータ

はい

はい

いいえ

いいえ

いいえ

はい

はい

はい

はい

はい

はい

はい

はい

はい

はい

「インスタンス」タブの表示

- 削除/中断アクション

モニター

管理者

はい

いいえ

はい

いいえ

はい

はい

「フォルト」タブの表示

- フォルト・リカバリ・アクション

- 拒否メッセージの削除

モニター

オペレータ

管理者

はい

いいえ

いいえ

はい

はい

いいえ

はい

はい

はい

「ユニット・テスト」タブの表示

- テストの実行アクション

モニター

オペレータ

はい

いいえ

はい

はい

はい

はい

「ポリシー」タブの表示

- アタッチ/デタッチ・アクション

モニター

管理者

はい

いいえ

はい

いいえ

はい

はい

C.1.6 BPELプロセス・サービス・エンジンへのアクセス

表C-6に、ユーザーがこのページにアクセスするために最低限必要なロールと、このページに対して各ロール・マッピングが保持している権限を示します。

表C-6 BPELプロセス・サービス・エンジン

メニュー項目

アクセスするための最低限のロール

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

「ダッシュボード」タブの表示

モニター

はい

はい

はい

「統計」タブの表示

モニター

はい

はい

はい

「インスタンス」タブの表示

モニター

はい

はい

はい

「フォルト」タブの表示

- フォルト・リカバリ・アクション(中断、再試行など)

モニター

オペレータ

はい

いいえ

はい

はい

はい

はい

「デプロイ済コンポーネント」タブの表示

モニター

はい

はい

はい

メッセージ・リカバリ・タブ

- BPELメッセージ・リカバリ・アクション

モニター

オペレータ

はい

いいえ

はい

はい

はい

はい

構成の表示(「プロパティ」ページ)

- 「適用」ボタン

- 「追加」ボタン

モニター

管理者

管理者

はい

いいえ

いいえ

はい

いいえ

いいえ

はい

はい

はい

C.1.7 Oracle Mediatorサービス・エンジンへのアクセス

表C-7に、ユーザーがこのページにアクセスするために最低限必要なロールと、このページに対して各ロール・マッピングが保持している権限を示します。

表C-7 メディエータ・サービス・エンジン

ページの要素

アクセスするための最低限のロール

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

「ダッシュボード」タブの表示

モニター

はい

はい

はい

「統計」タブの表示

モニター

はい

はい

はい

「インスタンス」タブの表示

モニター

はい

はい

はい

「フォルト」タブの表示

- フォルト・リカバリ・アクション(中断、再試行など)

モニター

オペレータ

はい

いいえ

はい

はい

はい

はい

「デプロイ済コンポーネント」タブの表示

モニター

はい

はい

はい

構成の表示(「プロパティ」ページ)

モニター

はい

はい

はい

「適用」ボタン

管理者

いいえ

いいえ

はい

C.1.8 ヒューマン・ワークフロー・サービス・エンジンへのアクセス

表C-8に、ユーザーがこのページにアクセスするために最低限必要なロールと、このページに対して各ロール・マッピングが保持している権限を示します。

表C-8 ヒューマン・ワークフロー・サービス・エンジン

ページの要素

アクセスするための最低限のロール

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

「ダッシュボード」タブの表示

モニター

はい

はい

はい

「統計」タブの表示

モニター

はい

はい

はい

「インスタンス」タブの表示

モニター

はい

はい

はい

「フォルト」タブの表示

- フォルト・リカバリ・アクション

モニター

オペレータ

はい

いいえ

はい

はい

はい

はい

「デプロイ済コンポーネント」タブの表示

モニター

はい

はい

はい

「通知管理」タブの表示

- 通知の送信

モニター

管理者

はい

いいえ

はい

いいえ

はい

はい

構成(「プロパティ」ページ)

- 「適用」ボタン

モニター

管理者

はい

いいえ

はい

いいえ

はい

はい

C.1.9 ビジネス・ルール・サービス・エンジンへのアクセス

表C-9に、ユーザーがこのページにアクセスするために最低限必要なロールと、このページに対して各ロール・マッピングが保持している権限を示します。

表C-9 ビジネス・ルール・サービス・エンジン

ページの要素

アクセスするための最低限のロール

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

「ダッシュボード」タブの表示

モニター

はい

はい

はい

「インスタンス」タブの表示

モニター

はい

はい

はい

「フォルト」タブの表示

モニター

はい

はい

はい

「デプロイ済コンポーネント」タブの表示

モニター

はい

はい

はい

C.1.10 BPELプロセス・サービス・コンポーネントのホーム・ページへのアクセス

表C-10に、ユーザーがこのページにアクセスするために最低限必要なロールと、このページに対して各ロール・マッピングが保持している権限を示します。

表C-10 BPELプロセス・サービス・コンポーネントのホーム・ページ

ページの要素

アクセスするための最低限のロール

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

「ダッシュボード」タブの表示

モニター

はい

はい

はい

「インスタンス」タブの表示

モニター

はい

はい

はい

「フォルト」タブの表示

- フォルト・リカバリ・アクション

モニター

オペレータ

はい

いいえ

はい

はい

はい

はい

「ポリシー」タブの表示

- アタッチ/デタッチ・アクション

モニター

管理者

はい

いいえ

はい

いいえ

はい

はい

C.1.11 Oracle Mediatorサービス・コンポーネントのホーム・ページへのアクセス

表C-11に、ユーザーがこのページにアクセスするために最低限必要なロールと、このページに対して各ロール・マッピングが保持している権限を示します。

表C-11 メディエータ・サービス・コンポーネントのホーム・ページ

ページの要素

アクセスするための最低限のロール

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

「ダッシュボード」タブの表示

モニター

はい

はい

はい

「インスタンス」タブの表示

モニター

はい

はい

はい

「フォルト」タブの表示

- フォルト・リカバリ・アクション

モニター

オペレータ

はい

いいえ

はい

はい

はい

はい

「ポリシー」タブの表示

- アタッチ/デタッチ・アクション

モニター

管理者

はい

いいえ

はい

いいえ

はい

はい

C.1.12 ヒューマン・タスク・サービス・コンポーネントのホーム・ページへのアクセス

表C-12に、ユーザーがこのページにアクセスするために最低限必要なロールと、このページに対して各ロール・マッピングが保持している権限を示します。

表C-12 ヒューマン・タスク・サービス・コンポーネントのホーム・ページ

ページの要素

アクセスするための最低限のロール

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

「ダッシュボード」タブの表示

モニター

はい

はい

はい

「インスタンス」タブの表示

モニター

はい

はい

はい

「フォルト」タブの表示

- フォルト・リカバリ・アクション

モニター

オペレータ

はい

いいえ

はい

はい

はい

はい

「ポリシー」タブの表示

- アタッチ/デタッチ・アクション

モニター

管理者

はい

いいえ

はい

いいえ

はい

はい

「管理」タブの表示

- 変更の適用

モニター

管理者

はい

いいえ

はい

いいえ

はい

はい

C.1.13 デシジョン・サービス・コンポーネントのホーム・ページへのアクセス

表C-13に、ユーザーがこのページにアクセスするために最低限必要なロールと、このページに対して各ロール・マッピングが保持している権限を示します。

表C-13 デシジョン・サービス・コンポーネントのホーム・ページ

ページの要素

アクセスするための最低限のロール

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

「ダッシュボード」タブの表示

モニター

はい

はい

はい

「インスタンス」タブの表示

モニター

はい

はい

はい

「フォルト」タブの表示

- フォルト・リカバリ・アクション

モニター

オペレータ

はい

いいえ

はい

はい

はい

はい

「ポリシー」タブの表示

- アタッチ/デタッチ・アクション

モニター

管理者

はい

いいえ

はい

いいえ

はい

はい

C.1.14 「フローのトレース」ページへのアクセス

表C-14に、ユーザーがこのページにアクセスするために最低限必要なロールと、このページに対して各ロール・マッピングが保持している権限を示します。

表C-14 「フローのトレース」ページ

ページの要素

アクセスするための最低限のロール

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

フローのトレースの表示

モニター

はい

はい

はい

C.1.15 監査証跡へのアクセス

表C-15に、ユーザーがこのページにアクセスするために最低限必要なロールと、このページに対して各ロール・マッピングが保持している権限を示します。

表C-15 「監査証跡」ページ

ページの要素

アクセスするための最低限のロール

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

「監査証跡」タブの表示

- 監査証跡ペイロード

モニター

モニター

はい

はい

はい

はい

はい

はい

フロー・デバッグ・タブの表示

モニター

はい

はい

はい

「センサー」タブの表示

モニター

はい

はい

はい

「フォルト・リカバリ」タブの表示

- リカバリ・アクション

モニター

オペレータ

はい

いいえ

はい

はい

はい

はい

C.1.16 「サービス・ホーム」ページへのアクセス

表C-16に、ユーザーがこのページにアクセスするために最低限必要なロールと、このページに対して各ロール・マッピングが保持している権限を示します。

表C-16 「サービス・ホーム」ページ

ページの要素

アクセスするための最低限のロール

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

「ダッシュボード」タブの表示

モニター

はい

はい

はい

「ポリシー」タブの表示

- アタッチ/デタッチ・アクション

モニター

管理者

はい

いいえ

はい

いいえ

はい

はい

「フォルト」タブの表示

- 拒否メッセージの削除

モニター

管理者

はい

いいえ

はい

いいえ

いいえ

はい

プロパティの表示

- 変更の適用

- プロパティの追加

モニター

管理者

管理者

はい

いいえ

いいえ

はい

いいえ

いいえ

はい

はい

はい

C.1.17 「参照ホーム」ページへのアクセス

表C-17に、ユーザーがこのページにアクセスするために最低限必要なロールと、このページに対して各ロール・マッピングが保持している権限を示します。

表C-17 「参照ホーム」ページ

ページの要素

アクセスするための最低限のロール

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

「ダッシュボード」タブの表示

モニター

はい

はい

はい

「ポリシー」タブの表示

- アタッチ/デタッチ・アクション

モニター

管理者

はい

いいえ

はい

いいえ

はい

はい

「フォルト」タブの表示

- 拒否メッセージの削除

モニター

管理者

はい

いいえ

はい

いいえ

はい

はい

プロパティの表示

- 変更の適用

- プロパティの追加

モニター

管理者

管理者

はい

いいえ

いいえ

はい

いいえ

いいえ

はい

はい

はい

C.1.18 Oracle B2Bのページへのアクセス

表C-18に、ユーザーがこれらのページにアクセスするために最低限必要なロールと、これらのページに対して各ロール・マッピングが保持している権限を示します。

表C-18 B2Bのページ

ページの要素

アクセスするための最低限のロール

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

「B2B構成」ページの表示

- 変更の適用

モニター

管理者

はい

いいえ

はい

いいえ

はい

はい

B2Bバインディング・ページの表示

モニター

はい

はい

はい

C.1.19 「ビジネス・イベント」ページへのアクセス

表C-19に、ユーザーがこのページにアクセスするために最低限必要なロールと、このページに対して各ロール・マッピングが保持している権限を示します。

表C-19 「ビジネス・イベント」ページ

ページの要素

アクセスするための最低限のロール

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

「イベント」タブの表示

- サブスクライブ/テスト

- イベント定義の表示

モニター

管理者

モニター

はい

いいえ

はい

はい

いいえ

はい

はい

はい

はい

「サブスクリプション」タブの表示

- サブスクリプションの追加/編集/削除

- データベース・エージェントの管理

モニター

管理者

管理者

はい

いいえ

いいえ

はい

いいえ

いいえ

はい

はい

はい

「フォルト」タブの表示

- 再試行/中断

モニター

オペレータ

はい

いいえ

はい

はい

はい

はい

C.1.20 システムMBeanブラウザへのアクセス

表C-20に、ユーザーがこのブラウザにアクセスするために最低限必要なロールと、このページに対して各ロール・マッピングが保持している権限を示します。

表C-20 システムMBeanブラウザ

ページの要素

アクセスするための最低限のロール

モニターからSOAMonitorへのマッピング・セット

オペレータからSOAOperatorへのマッピング・セット

管理者からSOAAdminへのマッピング・セット

構成の表示

- 変更の追加/適用

モニター

管理者

はい

いいえ

はい

いいえ

はい

はい

索引
A B C D E F G H I J L M N O P Q R S T U V W X

A

中断

メッセージ・リカバリ・アクション, 15.4

リカバリ・アクション, 8.4, 8.5, 14.1, 15.1, 15.3, 18.1, 18.3

アクション可能な電子メール・アカウント, 21.3

構成, 21.1

アクティブ化

コンポジット・リビション, 7.5.1, 7.5.2

アクティブ化仕様

定義, 36.1.2

アクティブ・データ・キャッシュ

監視, 25.2.1

アクティビティ

自動リカバリの構成, 13.2

BPEL 2.0におけるプロセス・フローと監査証跡, 14.1.3

アクティビティ・メッセージのタイプ

「メッセージの状態」リストが適用されない, 15.4

アダプタ

「Oracle Adapters」を参照

アドレス

複数の送信アドレスの構成, 21.9

管理タスク

アプリケーション管理者による場合, 1.5

管理者

ロール, C.1

ant

パーティションの作成, 7.9.1

デプロイメント, 7.1.3

インスタンス移行, 8.8.3

インスタンス移行の要件, 8.8.3

アプリケーション管理者

管理タスク, 1.5

アプリケーション・ポリシー

作成, 2.2.1

アプリケーション・ロール

作成, 2.2.1

デモ・ユーザー・コミュニティ, A.4

Oracle Enterprise Managerでの管理, 21.12.4

Oracle Business Activity Monitoring (BAM), 26.3.4

WLSTスクリプトを使用したシード, 21.12.3

アサーション

定義, 1.4.3.4, 7.6

「AsynchAuditBatchSize」プロパティ

複数の監査証跡メッセージを単一トランザクションに格納, 13.1

監査レベル

BPELプロセス・サービス・エンジン, 13.1

BPMNプロセス・サービス・エンジン, 39.1

アダプタ・ヘッダー・プロパティを表示するように構成, 36.1

孤立したサービス・コンポーネント・インスタンスの生成, 8.2

複数のコンポジット・インスタンスにまたがる監査トラッキングの無効化による影響, 7.5.2

実行の優先順位, 1.4.1.1, 7.5.2

SOAインフラストラクチャ・レベルで定義されている監査レベルをオーバーライド, 7.5.2

COMPOSITE_INSTANCE表のパーティション化に関連, 10.4.4.1

BPELプロセス・サービス・コンポーネント・レベルでの設定, 13.6

SOAコンポジット・アプリケーション・レベルに設定, 7.5.2

SOAコンポジット・アプリケーション, 7.5.2

SOAインフラストラクチャ, 3.1

監査レベル, 34.1 監査ログ, 34.3 監査トラッキング

実行の優先順位, 1.4.1.1

監査証跡

単一トランザクションへの格納の構成, 15.5.4

BPEL2.0プロジェクト, 14.1.3

BPELプロセスのサービス・コンポーネントの監視, 14.1

コンポジット監査レベルがオフの場合に生成されない, 1.4.1.1

Springサービス・コンポーネントについてサポートされない, 1.2.4.1, 1.2.4.1

ロールバックされたトランザクション・エラー・メッセージ, 14.1

センサー, 14.1, 40.1

しきい値の設定, 13.1

BPMNプロセス・サービス・コンポーネントの表示, 40.1

監査証跡しきい値, 39.1 「AuditConfig」プロパティ, 3.1

bpelRecoveryStatus, 4.3, 14.1

excludeBpelMaxCreationTime key, 3.1, 4.3, 8.2, 8.3

監査

概要, 34.1

構成, 34.2

フィルタ条件, 34.1.2

healthcare UIアクティビティ, 34.1.1

ユーザー・アクセスの監査

概要, 34.1

認証プロバイダ

追加, 21.11.1

複数のオーセンティケータからのユーザーとグループを認可, B.5.17

自動リカバリ

構成, 13.2

クラスタ化環境, 13.2

特定のBPELインスタンスがリカバリされない, B.4.2

オート・リリース・タイマー

Oracle BPM Worklistに対するグローバルな無効化, 21.7

自動化

SOAコンポジット・アプリケーションのテスト, 7.6

B

B2B, 「Oracle B2B」を参照

バックアップ, 1.4.3

BAM

「Oracle Business Activity Monitoring」を参照

バインディング・コンポーネント

UDDIレジストリにのみWebサービスを公開できる, 38.2

構成, 36, 36.1

アダプタの構成, 36.1.2

UDDIへのWebサービスの公開の構成, 38.2.1

Webサービスの構成, 36.1.1

定義, 1.2.5

直接バインディング, 37.1

エンドポイント・プロパティ, 36.1.2.8

フォルト, 37.1

コンポジットが停止した場合の影響, 7.5.1, 7.5.2

インスタンス, 37.1

サービス・バインディング・コンポーネントのポリシー・アタッチメント・エラーに関する制限, 38.1

ポリシー・アタッチメントに関する制限, 38

UDDIレジストリへの参照の公開に関する制限, 38.2

管理, 38

監視, 4.5, 37

インスタンスとフォルトの監視, 37.1

拒否メッセージの監視, 37.2

Oracle AQアダプタのプロパティ, 36.1.2.1

Oracle AQソケットのプロパティ, 36.1.2.7

Oracleデータベース・アダプタのプロパティ, 36.1.2.2

Oracleファイル・アダプタのプロパティ, 36.1.2.3

Oracle FTPアダプタのプロパティ, 36.1.2.4

Oracle JMSアダプタのプロパティ, 36.1.2.5

Oracle MQ Seriesアダプタのプロパティ, 36.1.2.6

ポリシー, 38.1

プロパティ, 36.1

UDDIレジストリへの公開, 38.2

参照, 1.2.5

拒否メッセージ, 37.2

複数のバインディングの指定に関する制限事項, 38

サービス, 1.2.5

BPEL 2.0

監査証跡, 14.1.3

compensateおよびcompensateScopeアクティビティ内でのアクティビティ・センサーの動作, 14.4.1

プロセス・フロー, 14.1.3

BPELプロセス・サービス・コンポーネント

監査証跡とプロセス・フロー, 14.1

構成, 13

フォルト・ポリシーの定義, 1.4.3.1

定義, 1.2.4

フォルト・リカバリ, 15.1

フォルト, 14.2, 15.1

コンポジット・インスタンスの状態が失効になってもインスタンス状態は完了として存続, 7.3

インスタンス, 14.2, 14.3

再デプロイ時にインスタンスを継続するオプションの選択に関する制限, 7.3

管理, 15

監視, 14, 14.3

ポリシー, 15.2

「フローのトレース」ページに表示されるリカバリ・メッセージ情報, 14.1

センサー・データ, 14.4

BPELプロセス・サービス・エンジン

監査レベル, 13.1

構成, 13

デプロイされたプロセス, 14.8, 17.3.4

フォルト・リカバリ, 15.3

フォルト, 14.5, 15.3

インスタンス, 14.5, 14.7

管理, 15

メッセージの失敗とリカバリ, 15.4

監視, 14

フォルトの監視, 14.5

インスタンスの監視, 14.5

ペイロードの検証, 13.1, 39.1

リクエスト統計とスレッド統計, 14.6

エンジンでのリクエストの所要時間に関する統計, 14.9

「リクエストのブレークダウン」表の下位レベルの詳細の表示, 14.6.1

BPELプロセス

自動リカバリ構成, 13.2

クラスタ環境における自動リカバリ, 13.2

設計時におけるインスタンス名の設定, 7.5.4

BPEL処理途中でSOAインフラストラクチャがデプロイされる管理対象サーバーの起動および停止, 7.5.3

BPELセンサー

サービス・エンジン・レベルでの無効化, 13.1

SOAコンポジット・アプリケーション・レベルでの無効化, 7.5.2

設定の優先順位, 7.5.2

BPMNプロセス・サービス・コンポーネント

監査証跡とプロセス・フロー, 40.1

再デプロイ後のインスタンスの動作, 7.3

フォルト・リカバリ, 41.1

フォルト, 40.2, 41.1

インスタンス, 40.2, 40.3

監視, 40

ポリシー, 41.2

再デプロイ時にインスタンスを継続するオプションの選択, 7.3

BPMNプロセス・サービス・エンジン

監査レベル, 39.1

デプロイされたプロセス, 40.7

フォルト・リカバリ, 41.3

フォルト, 40.4, 41.3

インスタンス, 40.4, 40.6

メッセージの失敗とリカバリ, 41.4

監視, 40

リクエスト統計とスレッド統計, 40.5

ブラウザ

「詳細をクリップボードにコピー」リンクがMozilla Firefoxで表示されない, 14.1

Safariブラウザを使用してWSDLファイルの内容を表示する場合の制限, B.9.1

サポート対象, 2.1

一括リカバリ

フロー・トレースの「フォルト」タブで一括フォルト・リカバリを実行できない, 14.1

フォルト, 8.4, 8.5

ビジネス・イベント・メッセージ

リカバリできない, 8.4, 8.5

ビジネス・イベント

リタイア状態のコンポジット内のBPELコンポーネントでビジネス・イベントを受信できない, 35.3

EDNの全体的なイベント配信を低速化する不良なコンポジットがSOAドメインに存在するかどうかのチェック, B.6.6

整合性レベル, 35.2

データベース・エージェントのサブスクリプション, 35.2

定義, 35

イベントが同じコンポジットの複数リビジョンによって使用される, B.6.3

フォルト・リカバリ, 35.4

フォルト, 35.4

管理, 35

EDNとコンポジットまたはクラスタ全体のコンポジット間でメッセージが失われる, B.6.5

イベントの配信の停止, B.6.1

SOAサーバーによって2回以上取得される, B.6.4

イベント・サブスクリプションに関するポリシーは非サポート, 35.2

複数のリビジョンがあるコンポジットでのイベントの受信, 35.3

ロールバックされたOAOOイベント・メッセージがログ・ファイルに表示される, B.6.2

サービス・コンポーネント・サブスクリプション, 35.2

再試行回数の設定, B.6.1

サブスクライバ, 35.3

サブスクライブ, 35.2

トラブルシューティング, B.6

イベント配信のチューニング, B.6.1

ビジネス・フォルト, 1.4.3.1 ビジネス監視

BPELモニター, 7.10

BPELセンサー, 7.10

BPMN測定, 7.10

有効化と無効化, 7.10

すべてのセンサーのステータス・レベルの設定, 7.10

ビジネス・ルール実行トレース, 20.7

監査レベル, 20.7

開発レベル, 20.7.1

本番レベル, 20.7.2

ビジネス・ルール・メッセージ

リカバリできない, 8.4, 8.5

ビジネス・ルール

エンジンのキャッシュ統計と操作統計, 20.2

監視, 20

ビジネス・ルール・サービス・エンジン

デプロイ済コンポーネント, 20.5

フォルト, 20.4

インスタンス, 20.3

C

コールバック・メッセージ

自動リカバリ試行の構成, 13.4

未解決のメッセージに対する自動リカバリの構成, 13.2

コールバックの受信時間の順番でのコールバックの処理, 13.1

手動メッセージ・リカバリの実行, 15.4

コールバックの順序の保持, 13.1, 13.5

解決と未配信の状態でのリカバリ, 15.4

残されている, 15.4

コールバック・サーバーURL

プロパティ, 3.1

プロパティを変更する場合は再起動が必要, 3.1

中断せずに取消

メッセージ・リカバリ・アクション, 15.4

コンポジット・インスタンスの状態をキャプチャ

制約を定義していても作成されたインスタンスをただちに表示, 7.5.2

無効の場合、「最新のインスタンス」セクションにフォルト・リカバリが必要なインスタンスが「実行中」と表示されない, 6.2

このプロパティを無効にした場合の新規インスタンスの作成の影響, 3.1

?アイコンの意味, 8.2

プロパティ, 3.1

大文字/小文字を区別しないグループ名

ヒューマン・タスクでの有効化, 21.13

チャンク

SOAP over HTTP配信でのデータのチャンク化の有効化, 3.1

チャンク・サイズの指定, 3.1

「clusterDbTimeRefresh」プロパティ

定義, 13.3

クラスタ

BPELプロセスの自動リカバリ, 13.2

マスター・ノード・リカバリの構成, 13.3

コンポーネント表

パーティション化, 10.4

コンポジット・センサー

監査証跡, 14.1, 40.1

検索基準の指定時に必要な大カッコ, 8.2, 8.3

指定する書式の表記規則, 8.3

SOAインフラストラクチャ・レベルでの表記規則の検索, 8.3

SOAインフラストラクチャ・レベルでの検索, 8.3

SOAコンポジット・アプリケーションでの検索, 8.2

SOAコンポジット・アプリケーションのすべてのインスタンスにわたるセンサーの検索, 8.3

コンポジットのURL

編集, 8.1

構成プラン

「SOAコンポジットのデプロイ」ウィザードでの選択, 7.1

整合性レベル

ビジネス・イベント, 35.2

続行

リカバリ・アクション, 8.4, 8.5, 14.1, 15.1, 15.3, 18.1, 18.3

対話ID

「Webサービスのテスト」ページで作成する, 1.2.3

定義, 1.2.3

生成, 1.2.3

「Webサービスのテスト」ページで作成しない, 1.2.3

「詳細をクリップボードにコピー」リンク

Mozilla Firefoxで表示されない, 14.1

相互参照

Oracle Mediator, 19

カスタム・ドライバ

ドライバ名の変更, 3.5

D

データ・ファイル

概要, 9.5.1

データソース

Oracle WebLogic Server管理コンソールでのアダプタの作成と管理, 2.2.5

定義, 3.1

Oracle WebLogic Server管理コンソールでのSOAインフラストラクチャのデータソースの管理, 2.2.5

プロパティ, 3.1

トポロジ・ビューアでの表示, 4.1

データベース接続

接続の遅さを解決, B.3.2

データベース増分

本番監査レベル設定の構成, 9.4.2.2

テスト環境の作成, 9.4.2.3

データファイルの概念, 9.5.1

大量のデータをパージする前に削除し、後で索引を追加して戻す, 10.3.2

データベースのプロファイルまたはサイズの決定, 9.2

コンポーネントの増加傾向の判定, 9.3.1.1

表と索引の増加傾向の判定, 9.3.1.4

Oracle SOA Suiteスキーマの増加傾向の判定, 9.3.1.2

最大セグメントの判別, 9.3.1.3

最小保存コンポジット数の判定, 9.2.2.2

最小保存ディスク領域の決定, 9.2.2.1

データベース増分管理戦略の策定, 9.4

パージおよびパーティション化の方法の開発, 10.2

保存ポリシーの策定, 9.2.2

索引サイズの見積り, 9.3.1.6

表サイズの見積り, 9.3.1.5

パラレルまたはシングル・スレッド・スクリプトの実行および領域の再利用, 9.4.2.4

パージ・スクリプトの実行, 10.3.6

長期間実行されるコンポジットおよび表のパーティション化の確認, 9.2.4

データのインフローの確認, 9.2.1

データのアウトフローの確認, 9.2.3

Microsoft SQL Server, 10.7

インスタンス状態のパージ, 10.3.3

パラレル・スクリプトでのループしたパージ, 10.3.2

ループしたパージ・スクリプト, 10.3.1

管理, 10

パージ・スクリプトによる管理, 10.3

データベース・パフォーマンスの監視, 9.3

ハードウェア・リソースの監視, 9.3

領域の使用量の監視, 9.3, 9.3.1

ハードウェア・リソースおよびデータベースの監視, 9.3.2

未使用索引の監視, 9.3.1.7

別のパーティションへの長時間実行されているインスタンスの移動, 10.4.7

コンポーネントの部分的なパーティション化, 10.4.8

ボトルネックを発生する表のパーティション化, 9.4.2.6

様々なOracle SOA Suiteリリースでサポートされているパージ・スクリプト, 10.3

アップグレード時に実行するパージ・スクリプト, 10.3

オープンおよびクローズされたすべてのインスタンスのパージ, 10.3.1.1

特定のSOAコンポジット・アプリケーションのインスタンスのパージ, 10.3.5

品質保証テスト, 9.4.2

セグメントおよびデータファイル領域の再利用, 9.5.2

推奨される増分管理戦略, 9.4.3

オープン・コンポジット・インスタンスでの表の再作成およびデータベース領域の再利用, 10.6

参照整合性および同一レベル・パーティション化, 10.4.1.1

表削除なしでの実行時表からのレコードの削除, 10.5

パージ・テストと確認の反復およびパーティション化された表の除外, 9.4.2.7

Oracle Mediatorのリシーケンスされたメッセージのパージの状態, 10.3.4

大量のトランザクションによる問題の解決, B.7.5

テスト結果の確認, 9.4.2.5

スキーマのパーティション・キーの選択, 10.4.1.2

領域管理, 9.5

トラブルシューティング, B.2

データベース・スキーマ

コンポーネント, 10.4.1

サイズの縮小, 10.2

データベース表

パーティション化, 10.4.1

オープン・コンポジット・インスタンスでの表の再作成およびデータベース領域の再利用, 10.6

表削除なしでの実行時表からのレコードの削除, 10.5

デシジョン・サービス・コンポーネント

定義, 1.2.4

デプロイ済コンポーネント, 20.5

フォルト, 20.4

インスタンス, 20.6

ログ・ファイル, 20.8

監視, 20

統計, 20.2

デシジョン・トレース

「ビジネス・ルール実行トレース」を参照

デフォルトのコンポジット・リビジョン

デフォルトのリビジョンと他のリビジョンの区別, 1.4.3.3, 7.5.1, 7.5.1

リタイアの影響, 7.5.1, 7.5.1

アンデプロイの影響, 7.5.1, 7.5.1

使用可能なアクティブなリビジョンが他にない場合のアンデプロイの影響, 7.4, 7.5.1

パーティション・レベルですべてのコンポジットをリタイアするときに警告メッセージが表示されない, 7.9.2

リタイア, 7.5.1

設定, 7.5.1

アンデプロイ, 7.4

アンデプロイすると次に使用可能なアクティブなリビジョンがデフォルトになる, 7.4

「拒否メッセージの削除」オプション

使用するタイミング, 8.6, 8.7

デモ・ユーザー・コミュニティ, A.1

定義, A, A.1

ダウンロード, A.1

グループ, A.3

データベースのインストール, A.1

ドメイン内でローカルにインストール・スクリプトを実行する必要がある, A.1

組織階層, A.2

WorkflowPermissionクラスで定義されている権限, A.7

ユーザーに付与されているロールおよびユーザーが所有しているロール, A.6

soa-infraアプリケーション・ロール, A.4

SOATestDemoAppアプリケーション・ロール, A.5

ユーザー, A.2

デプロイメント

タスク・フローを使用したコンポジットの, 7.1.2

デプロイ済のSOAコンポジット・アプリケーションのエクスポート, 7.8

SSO対応Oracle Enterprise Manager Fusion Middleware Controlからの, 7

ガイドライン, 7.1

ヒューマン・ワークフローを持つ同じコンポジットの複数のパーティションへのデプロイに関する問題, 7.1

ライフサイクルの状態, 7.5

デプロイされたコンポジットの状態の管理, 7.5.1, 7.5.2

グローバル・トークン変数を使用したコンポジット, 7.1

SOAコンポジット・アプリケーション, 7.5.1

複数のADFタスク・フォーム・デプロイメントのPermGenメモリー要件, 7.1.1, B.5.8

コンポジット間の相互参照に関する制限事項, 7.1

異なるコンポジットのリビジョン, 7.1

パーティションの選択, 7.1

SOAコンポジット・アプリケーション, 7.1

antの使用, 7.1.3

「SOAコンポジットの再デプロイ」ウィザードを使用して既存のインスタンスを再デプロイ, 7.1

WLSTの使用, 7.1.3

診断フレームワーク

定義, 12.1.2

診断

フレームワーク, 12.1

ダンプの説明の取得, 12.2

インシデント処理ルール, 12.1.3

サポートされるダンプのリストの表示, 12.2

手動によるダンプの実行, 12.6

通知の作成, 12.5

通知, 12.1.1.1

システムMBeanブラウザを使用したディスパッチャの静的構成の診断ダンプの取得, 12.2.8.2

問題およびインシデントの問合せ, 12.8

WLSTの起動, 12.2

サポートされるアダプタ接続プール診断のダンプ, 12.2.16

サポートされるアダプタ診断のダンプ, 12.2.15

サポートされるアダプタ統計診断のダンプ, 12.2.17

サポートされる非同期プロセス統計診断のダンプ, 12.2.12

サポートされる平均インスタンス処理時間診断のダンプ, 12.2.9

サポートされるデータベース診断のダンプ, 12.2.3

サポートされるデプロイ済コンポジット・メタデータ診断のダンプ, 12.2.4

サポートされるデプロイ済コンポジットWSDL/スキーマ・キャッシュ診断のダンプ, 12.2.7

サポートされる診断フレームワーク・スレッド診断のダンプ, 12.3

サポートされる診断シナリオおよびMBean, 12.1.1.2

サポートされるディスパッチャの静的構成診断のダンプ, 12.2.8, 12.2.10

サポートされるイベント診断のダンプ, 12.2.6

サポートされるインスタンス監査証跡診断のダンプ, 12.2.5

サポートされるリクエスト統計診断のダンプ, 12.2.13

サポートされるリシーケンサ・グループ処理遅延診断のダンプ, 12.2.14

サポートされるランタイム環境診断のダンプ, 12.2.1

サポートされるランタイム・プラットフォーム構成診断のダンプ, 12.2.2

サポートされるSOAのダンプ, 12.2

サポートされる同期プロセス統計診断のダンプ, 12.2.11

診断フレームワークの使用, 12.1.2

WLDFの使用, 12.1.1

インシデント・パッケージの表示, 12.7

監視の作成, 12.5, 12.5.3, 12.5.4

監視, 12.1.1.1

直接バインディング

構成できないプロパティ, 36

定義, 37.1

監視, 37.1

ポリシーおよびプロパティのタブが使用できない, 37.1

直接バインディング起動API

コンポジットのインバウンド呼出しおよびOracle Service Bus (OSB)のアウトバウンド呼出し, 11.1

直接Java呼出し

使用, 3.7

「アラートの無効化」リンク

定義, 4.3, 6.2

ディスパッチャ・エンジン・スレッド, 13.1, 39.1 ディスパッチャ呼出しスレッド, 13.1, 39.1 ディスパッチャ・システム・スレッド, 13.1, 39.1 分散キャッシュ

インスタンスとコールバック・メッセージ・データの格納, 15.5

配信リスト

Oracle Business Activity Monitoring (BAM), 24.6

DMSメトリック

ナウン, 12.4

サポート対象, 12.4

ダウンロード

デプロイ可能なJARファイル, 7.8

ドライバ

構成, 27.4

Oracle User Messaging Serviceのデプロイ, 29.1

Oracle Enterprise Manager Fusion Middleware Controlを使用したデプロイ, 29.1.2

Oracle Fusion Middleware構成ウィザードを使用したデプロイ, 29.1.3

WLSTを使用したデプロイ, 29.1.1

wsadminを使用したデプロイ, 29.1.4

電子メール・ドライバ, 27.4.1.4

メッセージング拡張ドライバ, 27.4.1.3

プロパティ, 27.4.1.1

プロキシ・ドライバ, 27.4.1.9

パスワードを使用したドライバ・プロパティの保護, 27.4.1.2

SMPPドライバ, 27.4.1.5

アンデプロイ, 29.2

登録解除, 29.2

VoiceXMLドライバ, 27.4.1.7.1

ワークリスト・ドライバ, 27.4.1.8

XMPPドライバ, 27.4.1.6

ダンプ

説明の取得, 12.2

サポートされるダンプのリストの表示, 12.2

手動による実行, 12.6

システムMBeanブラウザを使用したディスパッチャの静的構成の診断ダンプの取得, 12.2.8.2

サポートされるアダプタ接続プール診断のダンプ, 12.2.16

サポートされるアダプタ診断のダンプ, 12.2.15

サポートされるアダプタ統計診断のダンプ, 12.2.17

サポートされる非同期プロセス統計診断のダンプ, 12.2.12

サポートされる平均インスタンス処理時間診断のダンプ, 12.2.9

サポートされるデータベース診断のダンプ, 12.2.3

サポートされるデプロイ済コンポジット・メタデータ診断のダンプ, 12.2.4

サポートされるデプロイ済コンポジットWSDL/スキーマ・キャッシュ診断のダンプ, 12.2.7

サポートされる診断フレームワーク・スレッド診断のダンプ, 12.3

サポートされるディスパッチャの静的構成診断のダンプ, 12.2.8, 12.2.10

サポートされるイベント診断のダンプ, 12.2.6

サポートされるインスタンス監査証跡診断のダンプ, 12.2.5

サポートされるリクエスト統計診断のダンプ, 12.2.13

サポートされるリシーケンサ・グループ処理遅延診断のダンプ, 12.2.14

サポートされるランタイム環境診断のダンプ, 12.2.1

サポートされるランタイム・プラットフォーム構成診断のダンプ, 12.2.2

サポートされる同期プロセス統計診断のダンプ, 12.2.11

Oracle SOA Suiteでサポートされる, 12.2

永続的なBPELプロセス

定義, 7.3

インスタンス移行の制限, 8.8.3

再デプロイ時にインスタンスを継続するオプションの選択に関する制限, 7.3

永続的なプロセス

定義, B.6.5

動的割当て, 21.3

機能, 21.3

E

ECID

特定のECIDのメッセージを検索する際のSQLパフォーマンスを向上させるためにDLV_MESSAGE.ECID列に索引を追加, 15.4

「フローのトレース」ページでの「警告」ダイアログからのコピー, 14.1

定義, 8.2, 14.1, 15.4, 40.1

制限, 14.1, 40.1

検索, 8.2, 8.3

メッセージ・リカバリの検索基準作成時の指定, 15.4

EDN 「イベント配信ネットワーク」を参照 EJBトランザクション・タイムアウト

更新, B.3.3

電子メール・アドレス

送信電子メール・アドレスの構成, 21.1

送信先アドレスの構成, 21.1

修正, 23.5

電子メール・ドライバ

クライアントAPI, 27.4.1.4.4

共通プロパティ, 27.4.1.4.2

構成, 27.4.1.4

カスタム・プロパティ, 27.4.1.4.3

相互運用性, 27.4.1.4.1

電子メール通知メッセージ

数の構成, 21.8

電子メール・サーバー

/etc/hostsファイルへのホスト名およびIPアドレスの追加, 21.1

IMAP, 21.1

SMTP, 21.1

エミュレーション, 1.4.3.4 エンドポイント・アドレス

すべての外部サービスのアドレスの表示, 7.5.2

エンドポイント・プロパティ

定義, 36.1.2

インバウンド・アダプタ, 30.1

アウトバウンド・アダプタ, 30.2

エンドポイント参照

Oracle Service Registryのための変更, 36.1.3

エンドポイントURL

編集, 8.1

インスタンス作成時の指定, 8.1

エンジンのキャッシュ統計と操作統計

ビジネス・ルール用, 20.2

エンタープライズ・メッセージ・ソース, 25.2.4 同一レベル・パーティション化

定義, 10.4.1.1

イベント定義言語

定義, 35.2

イベント配信ネットワーク

定義, 35.1

EDN-DB, 35.1

EDN-JMS, 35.1

トラブルシューティング, B.6

イベント・エンジン

監視, 25.2.2

excludeBpelMaxCreationTimeキー

リカバリが必要なメッセージを除外する期間の設定, 3.1

消耗済メッセージ

未配信状態にリセット, 15.4

消耗済状態

定義, 15.4

メッセージのリカバリ, 15.4

エクスポート

デプロイ済のSOAコンポジット・アプリケーション, 7.8

個々のコンポジット・レベルでのみ可能, 7.8

共有データがエクスポートされない, 7.8

F

Facade API

例, 11.3

コンポジット・インスタンスおよびコンポーネント・インスタンスの検索, 11.3.2

インスタンス移行, 8.8.2

oracle.soa.management.facade.Locatorインタフェース, 11.1

インタフェースの概要, 11.2

SOAコンポジット・アプリケーションのプログラムによる管理, 11.1

コンポジットの状態の取得, 11.3

最上位レベルのエントリ・ポイント, 11.1

「ファーム」ホームページ

Oracle SOA Suiteページへの移動, 2.2.6

フォルト・ポリシー, 8.4

作成, 1.4.3.1, 8.4.1, 8.4.2, 8.4.3, 8.5

定義, 8.4

ora-retryアクションを使用したポリシーの定義とフォルトの発生, 15.4

定義, 1.4.3.1

BPELプロセスのフォルト・リカバリに必要, 1.4.3.1

「フォルト時間の開始」フィールド, 3.1 フォルト

自動リカバリ構成, 13.2

起動メッセージおよびコールバック・メッセージの自動リカバリ構成, 13.4

クラスタ環境における自動リカバリ, 13.2

バインディング・コンポーネント, 37.1

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

BPELプロセス・サービス・エンジンのフォルト・リカバリ, 15.3

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

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

一括リカバリ, 8.4, 8.4, 8.5

SOAインフラストラクチャ・レベルの一括リカバリではコンポジットの状態チェックを実行できない, 8.4

ビジネス・イベント, 35.4

ビジネス・イベントのフォルト・リカバリ, 35.4

ビジネス・フォルトの定義, 1.4.3.1

ビジネス・ルール・サービス・エンジン, 20.4

BPELプロセスに対する一括フォルト・リカバリの例, 8.4.1.2

BPMNプロセスに対する一括フォルト・リカバリの例, 8.4.2.2

Oracle Mediatorに対する一括フォルト・リカバリの例, 8.4.3.2

BPELプロセスに対する単一フォルト・リカバリの例, 8.4.1.1

BPMNプロセスに対する単一フォルト・リカバリの例, 8.4.2.1

Oracle Mediatorに対する単一フォルト・リカバリの例, 8.4.3.1

BPELプロセスに対するフォルト・リカバリの例, 8.4.1

BPMNプロセスに対するフォルト・リカバリの例, 8.4.2

リカバリ不可のフォルトの例, 1.4.3.1

Oracle Mediatorに対するフォルト・リカバリの例, 8.4.3

リカバリ可能なフォルトの例, 1.4.3.1

ヒューマン・ワークフローのフォルト・リカバリ, 23.2, 23.4

ヒューマン・ワークフロー・サービス・コンポーネント, 22.1, 23.4, 23.4

ヒューマン・ワークフロー・サービス・エンジン, 22.4, 23.2

監査証跡, 14.1, 40.1

インバウンド・アダプタ, 31.1

単一フォルト・リカバリのオプション, 8.4

Oracle Mediator, 18.1, 18.3

Oracle Web Service Managerフォルトの定義, 1.4.3.1

アウトバウンド・アダプタ, 31.5, 31.6, 31.7

リカバリ, 1.4.3.1, 8.4

リカバリ・アクション, 8.4, 8.5

SOAコンポジット・アプリケーションのフォルトのリカバリ, 4.3, 6.2

SOAコンポジット・アプリケーションのフォルト・リカバリ, 8.5

SOAインフラストラクチャ, 8.4

SOAインフラストラクチャのフォルト・リカバリ, 8.4

システム・フォルトの定義, 1.4.3.1

タイプ, 1.4.3.1

ファイル・アダプタ・ログ, 31.9 フィルタ条件, 34.1.2 フローのトレース

取り消されたonMessageブランチが表示されない, 14.1

複数サーバーでのコンポジット間呼出し, 14.1.2

インスタンス・トラッキングが無効な場合の影響, 7.5.2

ローエンドのホストにおける表示問題, B.8.4

フォルトの表示, 14.1

センサーの表示, 14.1

関数

1つの関数への複数のプロパティの追加に関する制限事項, 21.3

G

グローバル・トークン変数

作成, 3.8

デプロイメント時, 7.1

「BPELリカバリ・コンソールに移動」リンク

定義, 4.3, 6.2

ガバナンス

定義, 1.4.3.3

Gridlink

定義, 1.4.3

グループ名

ヒューマン・タスクでの大文字/小文字を区別しないグループ名の有効化, 21.13

グループ

デモ・ユーザー・コミュニティ, A.3

パーティション化, 10.4.4.2

LDAPツールを使用したシード, 21.12

GUID属性

マッピング要件, 21.11.3

H

「heartBeatInterval」プロパティ

定義, 13.3

HTTPバインディング

「httpBinding」プロパティは変更不可, 36

ヒューマン・ワークフロー

Oracle HTTP Serverでのタスク・フォームの添付の構成, 21.4

タスク・フローを使用したコンポジットのデプロイ, 7.1.2

デハイドレーション・ストアに保持されないフォルト, 8.4, 8.5

データのテスト環境から本番環境への移動, 23.6

通知プロパティ, 21.1

通知, 23.5

通知プロパティを構成するための前提条件, 21.1

タスク・サービス・プロパティ, 21.3

タスクのステータス, 22.2

トラブルシューティング, B.5

AMX拡張の問題のトラブルシューティング, B.5.14

実行時のデザインタイムの問題のトラブルシューティング, B.5.10

ヒューマン・ワークフローAPIの使用の問題のトラブルシューティング, B.5.11

アイデンティティ・サービスの問題のトラブルシューティング, B.5.17

通知の問題のトラブルシューティング, B.5.3

Oracle BPM Worklist/タスク・リージョンの問題のトラブルシューティング, B.5.15

Oracle JDeveloperのデータ・コントロール/フォーム生成の問題のトラブルシューティング, B.5.12

サービス/システムMBeanブラウザの問題のトラブルシューティング, B.5.13

タスク・アクションの問題のトラブルシューティング, B.5.2

タスク割当て、ルーティングおよびエスカレーションの問題のトラブルシューティング, B.5.1

タスク・コメント/添付の問題のトラブルシューティング, B.5.9

タスク・フォーム/アクションの問題のトラブルシューティング, B.5.8

タスク履歴の問題のトラブルシューティング, B.5.7

タスクの属性マッピングの問題のトラブルシューティング, B.5.5

タスク・レポートの問題のトラブルシューティング, B.5.6

タスク・ビューの問題のトラブルシューティング, B.5.4

テストから本番への移行の問題のトラブルシューティング, B.5.16

WSDLファイルのセキュリティ, 5.9

ヒューマン・ワークフロー・サービス・コンポーネント

構成, 21

定義, 1.2.4

フォルト・リカバリ, 23.4

フォルト, 22.1, 23.4

インスタンス, 22.1, 22.3

管理, 23

監視, 22

Oracle BPM Worklistからのフォルト・リカバリの実行, 1.4.3.1, 8.4

ポリシー, 23.1

本番環境でのoracle/wss10_saml_token_service_policyの不使用の推奨, 23.1

タスク詳細アプリケーションのURI, 23.3

ヒューマン・ワークフロー・サービス・エンジン

構成, 21

デプロイされたワークフロー, 22.7

フォルト・リカバリ, 23.2

フォルト, 22.4, 23.2, 23.4

インスタンス, 22.4, 22.6

管理, 23

監視, 22

リクエストと操作統計, 22.4, 22.5

I

IBM WebSphere

このガイドを使用するための手順, 1.4

アイデンティティ・サービス

プロバイダのカスタマイズ, 21.11.4

GUID属性のマッピング要件, 21.11.3

サード・パーティ・プロバイダ, 21.11

IMAP電子メール・サーバー

構成, 21.1

IMAPサーバー

構成後のSOAサーバーの再起動, 21.1

インシデント・パッケージ

作成, 12.1.2

表示, 12.7

インシデント処理ルール

ルール・ファイルを動的にロード, 12.1.3.3

サーバーの再起動をしないでロード, 12.1.3.1

コピーの取得, 12.1.3.1

インデックス

大量のデータをパージする前に削除し、後で索引を追加して戻すことを推奨, 10.3.2

インデックス付け

LDAP属性, 21.11.2.2

インスタンスとコールバック・メッセージ・データ

Oracle Coherenceの分散キャッシュへの格納, 15.5

インスタンスおよびフォルトのメトリックのあるページ

システムMBeanブラウザでの無効化, 3.1.1

インスタンス数とフォルト数のメトリックの取得の無効化, 3.1, 3.1, 3.1, B.7.1

ロードの最適化, 3.1, 3.1, 3.1, B.7.1

最近のインスタンスおよびフォルトを最近の期間内のみでフェッチするデフォルト検索条件を設定する, 3.1

インスタンスID

作成, 1.2.3, 8.2

SOAコンポジット・アプリケーションの「インスタンス」ページでの表示, 1.2.4

BPELプロセスのサービス・コンポーネントの場合, 14.3

サービス・コンポーネントの場合, 1.2.4

SOAコンポジット・アプリケーションの場合, 1.2.3

インスタンス名

設計時の設定, 7.5.4

インスタンスの状態, 3.1

定義, 3.1

実行状態によるフィルタリング, 8.2, 8.3

フォルト状態によるフィルタリング, 8.2, 8.3

リカバリ状態によるフィルタリング, 8.2, 8.3

一方のBPELプロセスが完了してもう一方のBPELプロセスが失敗したコンポジットの場合, 8.2.2

?アイコンの意味, 8.2

コンポジット・インスタンスの状態が失効になっても完了として存続するBPELプロセス・サービス・コンポーネント, 7.3

サービス・コンポーネントとSOAコンポジット・アプリケーション, 8.2.2

インスタンスの状態が評価されない場合, 8.2

インスタンス・トラッキング

複数のコンポジット・インスタンスにまたがる監査トラッキングの無効化による影響, 7.5.2

トラッキングが無効な場合のフロー・トレースへの影響, 7.5.2

インスタンス

互換性がないサービス・コンポーネントとのインスタンスの移行の試行, 8.8.6

再デプロイ後のサービス・コンポーネント・インスタンスの動作, 7.3

バインディング・コンポーネント, 37.1

ビジネス・ルール・サービス・エンジン, 20.3

コンポジット・インスタンスの状態のキャプチャ, 3.1

「リフレッシュ」アイコンをクリックして実際の合計インスタンス数を表示, 7.5.2

デシジョン・サービス・コンポーネント, 20.6

SOAインフラストラクチャ・レベルでの削除, 8.3, 8.3

コンポジット・アプリケーションのホーム・ページからの削除, 8.2, 8.2

大量削除, 10.3

実行中のロールバックされたインスタンスの削除, 8.2, 8.3

パラレル・スクリプトでのループしたパージによる削除, 10.3.2

ループしたパージ・スクリプトによる削除, 10.3.1

制約を定義しているときに作成されたインスタンスをただちに表示, 7.5.2

ユニット・テスト・インスタンスと他のインスタンスの区別, 1.2.3, 7.6

パージ・スクリプトの実行, 10.3.6

コンポジット・インスタンスおよびコンポーネント・インスタンスのプログラムによる検索, 11.3.2

ヒューマン・ワークフロー・サービス・コンポーネント, 22.1, 22.3

ヒューマン・ワークフロー・サービス・エンジン, 22.4, 22.6

インバウンド・アダプタ, 31.1

テスト・インスタンスの起動, 7.5.2, 8.1

インスタンス移行の互換性, 8.8.1

複数インスタンスの起動, 8.1

再デプロイ後も現在のBPMコンポジット・インスタンスの実行を継続, 7.3

再デプロイ時にインスタンスを継続するオプションの選択に関する制限, 7.3

すべてのサービス・コンポーネントとともにインスタンスを移行, 8.8.5

複数のコンポジット・リビジョン間のインスタンスの移行, 8.8

Oracle BPMのインスタンスの移行, 8.8.4

Facade APIによるインスタンスの移行, 8.8.2

コンポジット・インスタンスとサービス・コンポーネント・インスタンスの不一致, 8.2.1

BPELプロセス・サービス・コンポーネント・インスタンスの監視, 14.3

別のパーティションへの長時間実行されているインスタンスの移動, 10.4.7

孤立したサービス・コンポーネント・インスタンス, 8.2

アウトバウンド・アダプタ, 31.5

テスト時のメッセージを使用したセキュリティ・プロパティの引渡し, 8.1

再デプロイメントの失敗の考えられる理由, 7.3, 7.3

特定のSOAコンポジット・アプリケーションのインスタンスのパージ, 10.3.5

「テスト」ボタンが無効になる場合, 8.1

サービス・コンポーネント, 1.2.4

設計時におけるインスタンス名の設定, 7.5.4

SOAコンポジット・アプリケーション, 1.2.3

特定のBPELインスタンスがリカバリされない, B.4.2

テスト時のXMLペイロード・データの指定, 8.1

状態, 3.1

パージ対象の状態, 10.3.3

統計

Oracle Mediator, 17.2.2

終了, 8.2 コンポジットが停止またはリタイアしているときは「テスト」ボタンが無効, 7.5.2 スループットの詳細, 14.2 インスタンス、フォルトおよび拒否メッセージの失効状態への更新, 7.2 リビジョン番号を含まないWSDL URLはデフォルトのコンポジットによって処理される, 8.1 インスタント・メッセージ

アクション可能ではないメッセージ, 21.1

相互作用仕様

定義, 36.1.2

呼出し

直接バインディング, 3.7

起動メッセージ

自動リカバリ試行の構成, 13.4

未解決のメッセージに対する自動リカバリの構成, 13.2

手動メッセージ・リカバリの実行, 15.4

「最終更新日時」列が空のままになる状況, 15.4

呼び出されたデシジョン関数, 20.7.1, 20.7.1 IPv4のサポート, B.8.5 IPv6のサポート, B.8.5

J

JARファイル

デプロイ可能なJARファイルのダウンロード, 7.8

Java EEアプリケーション

移動, 2.2.4

JCAアダプタ

「Oracle Adapters」を参照

JMSセンサー

値が表示されない, 14.4

L

大容量のドキュメントしきい値, 39.1

設定, 13.1

LDAP属性

索引作成の推奨事項, 21.11.2.2

LDAPツール

ユーザー、グループおよびアプリケーション・ロールのシード, 21.12

LDAPユーザー・プロファイル

Oracle User Messaging Service (UMS)の構成, 27.5

ライフサイクル

SOAコンポジット・アプリケーション, 1.4.3.3, 7.5

パーティションの一括ライフサイクル管理タスクの実行, 7.9.2

ローカルの最適化

コンポジットに到達不能の場合のコール, 3.7.4

使用するための条件チェック, 3.7

構成, 3.7, 7.7.2

使用の強制, 3.7.2

ロギング, 3.7.3

オーバーライド, 3.7.2

ポリシーのローカル最適化設定の表示, 7.7.2

Locator

Facade APIクライアントのエントリ・ポイント, 11.1, 11.2

locatorオブジェクト

セキュリティ資格証明の要件, 11.1.1

ログ・ファイル

アクセス, 2.2.1

構成, 3.4

パフォーマンスの問題を診断するロギングの構成, 3.4.2

デシジョン・サービス・コンポーネント, 20.8

エンコーディング・プロパティ, 3.4.1

すべての管理対象サーバーから, B.1.1

ローカルの最適化, 3.7.3

Oracle Business Activity Monitoring (BAM), 25.6

Oracle User Messaging Service (UMS), 28.2, 28.2

ログ・レベル

トラブルシューティングのための設定, B.1

ログ・トレース, B.1 ロガー

デプロイメント, B.1

イベント配信ネットワーク(EDN), B.1

ヒューマン・ワークフロー/承認管理の拡張(AMX)/ルール, B.1

Oracleアダプタ, B.1

Oracle B2B, B.1

Oracle BPEL Process Manager, B.1

Oracle BPM Suite, B.1

Oracle Business Activity Monitoring (BAM), 24.4

Oracle Mediator, B.1

Oracle User Messaging Service (UMS), 28.2.1

Oracle Web Services Manager (OWSM), B.1

SOAインフラストラクチャ, B.1

ログイン

Oracle Enterprise Manager Fusion Middleware Controlへの, 2.1

ログアウト

Oracle Enterprise Manager Fusion Middleware Controlからの, 2.4

パラレル・スクリプトでのループしたパージ

インスタンスの削除, 10.3.2

ループしたパージ・スクリプト

インスタンスの削除, 10.3.1

オープンおよびクローズされたすべてのインスタンスのパージ, 10.3.1.1

M

管理対象サーバー

起動と停止, B.8.1

データベース増分の管理, 10 「masteAliveThreshold」プロパティ

定義, 13.3

マスター・ノード

リカバリ, 13.3

「maxMessageRaiseSize」プロパティ

定義, 13.2, 13.2

MDS接続

管理, 2.2.1

メディエータ

「Oracle Mediator」を参照

メッセージ・リカバリ

中断アクション, 15.4

特定のECIDメッセージに対するメッセージ検索でSQLパフォーマンスを向上させるためにDLV_MESSAGE.ECID列に索引を追加, 15.4

「中断せずに取消」アクション, 15.4

消耗済状態, 15.4

リカバリ可能かどうかでインスタンスの表示をフィルタリング, 8.2, 8.3

BPELプロセス・サービス・エンジン, 15.4

BPMNプロセス・サービス・エンジン, 41.4

失敗した自動リカバリの試行の管理, 15.4

retryCountパラメータを超過した後にメッセージが実行中の状態で続行可能, 15.4

「メッセージの状態」リストがアクティビティ・メッセージのタイプに適用されない, 15.4

メッセージ・リカバリのためのECID値の取得, 14.1, 15.4

回復アクション, 15.4

解決と未配信の状態でのコールバック・メッセージのリカバリ, 15.4

「フローのトレース」ページに表示されるリカバリ・メッセージ情報, 14.1

SOAインフラストラクチャのホーム・ページに表示されるリカバリ・メッセージ情報, 4.3

SOAコンポジット・アプリケーションのホーム・ページに表示されるリカバリ・メッセージ情報, 1.2.1, 6.2

リカバリ・オプション, 15.4

リセット・アクション, 15.4

消失したインメモリー・クォーツ・スケジュール済ジョブの再同期化, 15.4

「最終更新日時」列が空のままになる状況, 15.4

残されているコールバック・メッセージ, 15.4

メッセージ・ソース, 25.2.4 メッセージング拡張ドライバ

クライアントAPI, 27.4.1.3.5

共通プロパティ, 27.4.1.3.2

構成, 27.4.1.3

カスタム・プロパティ, 27.4.1.3.3

ドライバ・アプリケーション・アーカイブ(EAR), 27.4.1.3.1

拡張ドライバのセキュリティ, 27.4.1.3.4

使用, 27.4.1.3.6

Microsoft SQL Server

機能, 10.7.1

パージ・スクリプトの相違点, 10.7.2

パージ・スクリプトの制限, 10.7.3

パージ・スクリプトの場所, 10.7.3

インスタンスのパージ, 10.7

パージ・スクリプトの実行, 10.7.3

移行

互換性がないサービス・コンポーネントとのインスタンスの移行の試行, 8.8.6

インスタンス移行の互換性, 8.8.1

すべてのサービス・コンポーネントとともにインスタンスを移行, 8.8.5

複数のコンポジット・リビジョン間のインスタンスの移行, 8.8

Oracle BPMのインスタンスの移行, 8.8.4

ヒューマン・ワークフロー・データのテスト環境から本番環境への移行, 23.6

antを使用したインスタンスの, 8.8.3

Facade APIによるインスタンスの, 8.8.2

antを使用したインスタンスの要件, 8.8.3

移行が失敗したコンポーネントのリストの取得, 8.8.2.6.1

サポートされるOracle Mediatorメッセージのパターン, 8.8.1

モニター

ロール, C.1

Mozilla Firefox

「詳細をクリップボードにコピー」リンクが表示されない, 14.1

MTOMアタッチメント

アウトバウンドWebサービスへのアタッチ, 36

複数インスタンス

起動, 8.1

複数の送信アドレス

構成, 21.9

N

「nodeReapInterval」プロパティ

定義, 13.3

「nodeReapThreshold」プロパティ

定義, 13.3

ノード

リカバリ, 13.3

非永続的BPELプロセス

インスタンス移行, 8.8.1

致命的でない接続

再試行回数の指定, 3.1

通知サービス

プラガブル, 21.6

通知

アクション可能なアドレス, 21.1

構成モード, 21.1

電子メール通知メッセージの数の構成, 21.8

送信電子メール・アドレスの構成, 21.1

送信先アドレスの構成, 21.1

作成, 12.5

ヒューマン・ワークフロー

受信電子メール, 23.5

送信, 23.5

プロパティ, 21.1

構成するための前提条件, 21.1 IMAPおよびSMTP電子メール・サーバーの構成後のサーバーの再起動, 21.1 送信者アドレスおよびデフォルトの送信者アドレスが「ワークフロー通知プロパティ」ページの値と一致する必要がある, 21.1 Noun

DMS, 12.4

NTLM認証

Webサービスの起動, 5.7

O

演算子

ロール, C.1

optSoapShortcut

11gではSOAPの最適化が自動的に構成される, 3.1

Oracle Adapters

構成, 30

バインディング・コンポーネントの構成, 36.1.2

デプロイされたリソース・アダプタ, 2.2.4

エンドポイント・プロパティ, 36.1.2.8

インバウンド・アダプタ, 30.1

アウトバウンド・アダプタ, 30.2

フォルト

インバウンド・アダプタ, 31.1

アウトバウンド・アダプタ, 31.5, 31.6, 31.7

ファイル・アダプタ・ログ, 31.9 インバウンド・アダプタを含むSOAコンポジット・アプリケーションのリビジョンが複数ある場合は「実行中」と表示される, 8.2 インスタンス

インバウンド・アダプタ, 31.1

アウトバウンド・アダプタ, 31.5

監視, 31 Oracle AQアダプタのプロパティ, 36.1.2.1 Oracleデータベース・アダプタのプロパティ, 36.1.2.2 Oracleファイル・アダプタのプロパティ, 36.1.2.3 Oracle FTPアダプタのプロパティ, 36.1.2.4 Oracle JMSアダプタのプロパティ, 36.1.2.5 Oracle MQ Seriesアダプタのプロパティ, 36.1.2.6 Oracleソケット・アダプタのプロパティ, 36.1.2.7 プロパティ

インバウンド・アダプタ, 31.4

アウトバウンド・アダプタ, 31.8

拒否メッセージ

インバウンド・アダプタ, 31.2, 31.3

Oracle AQアダプタ

プロパティ, 36.1.2.1

Oracle B2B

Oracle Enterprise Manager Fusion Middleware Controlからのアクセス, 33.2

バインディング, 33

構成, 32

データベースの表がOracle SOA Suiteパージ・スクリプトにより削除されない, 10.3

パーティションを削除する前に外部キー制約を無効化する必要がある, 10.4.6

インフラストラクチャの監視, 33.1

メトリック, 32.1

監視, 33, 33

サーバー・プロパティ, 32

Oracle BAMアダプタ

構成, 24.7

HTTPSの構成, 24.7.2.1

メッセージの送信を再試行するための構成, 24.7.1.1

Oracle BPM Worklist

Oracle HTTP Serverを使用した構成, 5.3

オート・リリース・タイマーのグローバルな無効化, 21.7

フォルト・リカバリの実行, 1.4.3.1

ヒューマン・ワークフロー・サービス・コンポーネントのフォルト・リカバリの実行, 8.4

Oracle Business Activity Monitoring (BAM)

アプリケーション・ロールへのメンバーの追加, 26.3.3

Oracle BAMアドミニストレータでのユーザーの追加, 26.3.6

アプリケーション・ロール, 26.3.4

可用性の管理, 26.2

Webサービスのコール, 24.9.6

構成プロパティ・ファイル, 24.10

構成プロパティの参照, 24.11

構成, 24

拡張プロパティの構成, 24.10

資格証明マッピングの構成, 24.7.4, 24.9.1

ディストリビューション・リストの構成, 24.6

Oracle BAMアダプタの構成, 24.7

Oracle BAMのバッチ処理プロパティの構成, 24.8

Oracle BAMコネクション・ファクトリの構成, 24.7.2

Oracle Data Integratorの統合プロパティの構成, 24.3.6

Oracle User Messaging Service (UMS)の構成, 24.5

サーバー基本プロパティの構成, 24.3

SSLの構成, 24.9.3

アプリケーションURLの構成, 24.2.2, 24.3.3

データソースJNDIの構成, 24.3.2

組込みLDAPサーバーの構成, 26.3.5

ロガーの構成, 24.4

電子メール・アカウントのアウトバウンドの構成, 24.3.7

レポート・キャッシュ永続性マネージャの構成, 24.3.5

レポート・ロード・インジケータの構成, 24.2.3

サーバー名の構成, 24.2.4

信頼できるドメインの構成, 24.7.3

ユーザー権限の構成, 24.9.2

ビューセットの共有の構成, 24.3.4

Webアプリケーションのプロパティの構成, 24.2.1

Web基本プロパティの構成, 24.2

ユーザーとグループの定義, 26.3.1

管理, 26

オブジェクト所有権の管理, 26.3.7

監視, 25

ログの監視, 25.6

オープン接続の監視, 25.3.2

Oracle BAMアクティブ・データ・キャッシュの監視, 25.2.1

パフォーマンスの監視, 25.5

進行中のクライアント・リクエストの監視, 25.2.5

エンタープライズ・メッセージ・ソースの監視, 25.2.4

イベント・エンジン・コンポーネントの監視, 25.2.2

レポート・キャッシュ・コンポーネントの監視, 25.2.3

レポート・サーバーの監視, 25.3.1

Webアプリケーションの監視, 25.3

Webサービスの監視, 25.4

Oracle BAMアドミニストレータからの無効なユーザーの削除, 26.3.8

保護, 24.9

JMSリソースの保護, 24.9.5

ユーザー管理, 26.3

Oracle Internet Directoryの使用, 24.9.4

以前にシードされたグループ・メンバーの使用, 26.3.2

Oracle Business Process Management Suite

管理, 1.4

構成, 1.4.1

定義, 1.3

管理, 1.4.3

監視, 1.4.2

サービス・コンポーネント, 1.2.4

Oracle Coherence

定義, 15.5

Oracle Coherenceの分散キャッシュ

アーキテクチャ, 15.5.1

使用するにはOracle Exalogicの使用が必要, 15.5

システムMBeanブラウザでの構成, 15.5.3

呼出しメッセージの構成, 15.5.6

複数の監査証跡メッセージの単一トランザクションへの格納の構成, 15.5.4

監査証跡の格納の構成, 15.5.5

サーバーのクラッシュ時に実行中の呼出しメッセージが損失または複製される可能性がある, 15.5.6

パフォーマンスに関する推奨事項, 15.5.2

サーバーがキャッシュする場合一部の監査証跡メッセージが永続化されない, 15.5.5

データ・グリッド・ノードの起動, 15.5.7

インスタンスとコールバック・メッセージ・データの格納, 15.5

Oracle Data Integrator

Oracle Business Activity Monitoring (BAM)を使用した構成, 24.3.6

Oracleデータベース・アダプタ

プロパティ, 36.1.2.2

Oracle Enterprise Manager 11g Grid Control

定義, 1.6

Oracle Enterprise Manager Fusion Middleware Control

Oracle B2Bへのアクセス, 33.2

ドライバのデプロイ, 29.1.2

ログイン, 2.1

ログアウト, 2.4

Oracle Exalogic

定義, 15.5

Oracle Exalogicプラットフォーム

「AsynchAuditBatchSize」プロパティの設定, 13.1

インスタンスとコールバック・メッセージ・データのOracle Coherence分散キャッシュへの格納, 15.5

Oracleファイル・アダプタ

プロパティ, 36.1.2.3, 36.1.2.4

Oracle Fusion Middleware, 1.1 Oracle Fusion Middleware構成ウィザード

ドライバのデプロイ, 29.1.3

Oracle HTTP Server

Oracle SOA SuiteおよびOracle HTTP ServerのSSL通信の構成, 5.8.6

Oracle BPM Worklistを使用した構成, 5.3

Oracle Internet Directory

Oracle Business Activity Monitoring (BAM)との併用, 24.9.4, 24.9.4

Oracle JMSアダプタ

プロパティ, 36.1.2.5

Oracle Mediatorサービス・コンポーネント

構成, 16, 16

定義, 1.2.4

フォルト・リカバリ, 1.4.3.1

フォルト・リカバリの例, 8.4.3

管理, 18

監視, 17

リシーケンスされたメッセージのパージの状態, 10.3.4

設計時におけるインスタンス名の設定, 7.5.4

Oracle Mediatorサービス・エンジン

管理, 18

監視, 17

Oracle MQ Seriesアダプタ

プロパティ, 36.1.2.6

Oracle Service Bus (OSB)

起動, 11.1

Oracle Service Registry

エンドポイント参照およびサービス・キーの変更, 36.1.3

WSDL URLのキャッシュの構成, 36.1.3.1

UDDIへのWebサービスの公開の構成, 38.2.1

照会URL, 3.1

プロパティ, 3.1

デフォルト以外のビジネスへの公開, 38.2.2

UDDIレジストリへのWebサービスの公開, 38.2

Oracleシングル・サインオン(OSSO)

構成, 5.1

Oracle SOA Composer

非管理者へのアクセス権の提供, 21.12.4

Oracle SOA Management Pack

定義, 1.6

Oracle SOA Suite

管理, 1.4, 2

構成, 1.4.1

定義, 1.2

管理, 1.4.3

監視, 1.4.2

Oracleソケット・アダプタ

プロパティ, 36.1.2.7

Oracle SSL暗号, 3.1 Oracle User Messaging Service (UMS)

構成ページへのアクセス, 27.3

ユーザー・メッセージング・プリファレンスのビジネス条件の追加または削除, 27.3.2

アーキテクチャ, 27.1.2

クライアント別名, 27.6.5

コンポーネント, 27.1.1

構成, 27

電子メール・ドライバの構成, 27.4.1.4

メッセージング拡張ドライバの構成, 27.4.1.3

プロキシ・ドライバの構成, 27.4.1.9

SMPPドライバの構成, 27.4.1.5

VoiceXMLドライバの構成, 27.4.1.7

ワークリスト・ドライバの構成, 27.4.1.8

XMPPドライバの構成, 27.4.1.6

通知を送受信するための構成, 21.1

LDAPユーザー・プロファイルへの構成, 27.5

定義, 27.1

メッセージング・クライアント・アプリケーションの登録解除, 28.1.2

ドライバの構成, 27.4

ドライバのプロパティ, 27.4.1.1

クライアント・セキュリティの有効化, 27.6.3

セキュリティの有効化, 27.6.2

キーストア構成, 27.6.4

ロギングの構成, 28.2.1

管理, 29, 29

メッセージ・ステータス, 28.1.1

メトリックおよび統計, 28.3

監視, 28

「すべて」タブを使用したドライバの監視, 28.1.3

保護, 27.6

JMSリソースの保護, 27.6.6

パスワードの保護, 27.4.1.2

送信者アドレスおよびデフォルトの送信者アドレスが「ワークフロー通知プロパティ」ページの値と一致する必要がある, 21.1

保管方法の設定, 27.3.1

トラブルシューティング, 27.7

UMSクライアント・アプリケーション, 27.1.1

UMSドライバ, 27.1.1

UMSサーバー, 27.1.1

ログ・ファイルの表示, 28.2

通知に関するWebサービス・セキュリティ, 27.6.1

Oracle Virtual Assembly Builder

説明, 1.4.3

Oracle SOA Suiteのサポート, 1.4.3

Oracle Walletパスワード, 3.1 Oracle Web Service Managerフォルト, 1.4.3.1 Oracle WebLogic Server

BPEL処理途中でSOAインフラストラクチャがデプロイされる管理対象サーバーの起動および停止, 7.5.3

Oracle WebLogic Server管理コンソール

アクセス, 2.2.5

ヒューマン・ワークフロー・ユーザーのセキュリティの管理, 2.2.5

コンポジット参照に対するアダプタ接続の構成, 2.2.5

アダプタのデータソースの作成と管理, 2.2.5

アダプタのJMSリソースの作成と管理, 2.2.5

ヒューマン・タスク・ユーザー・インタフェースのデプロイ, 2.2.5

SOAインフラストラクチャのデータソースの管理, 2.2.5

JTA設定の管理, 2.2.5

Oracle SOA Suite管理タスクの実行, 2.2.5

oracle.soa.local.optimization.forceプロパティ

使用, 3.7.2

OracleSystemUser, 26.3

削除しない, 7.1

oracle.webservices.local.optimizationプロパティ

使用, 3.7.2

ora-human-interventionアクション

フォルト・ポリシーの定義, 8.4, 8.5, 8.5

孤立したメッセージ

リカバリの保留, 8.2

孤立したサービス・コンポーネント・インスタンス

削除, 8.2

SOAコンポジット・アプリケーション・インスタンスが作成されていない場合, 8.2.1

生成, 8.2

OVAB

「Oracle Virtual Assembly Builder」を参照

OWSM

「Oracle Web Services Manager」を参照

P

部分的なパーティション化

パーティション化を増加率が高い表に制限, 10.4.4.1

パーティション化

サービス・コンポーネントおよびサービス・エンジンのすべての表, 10.4.4.1

COMPOSITE_INSTANCE表を常にパーティション化, 10.4.4.1

コンポーネント表, 10.4, 10.4.1, 10.4.4, 10.4.4.2

パーティションの構成, 10.4.2

制約, 10.4.4.1

方法の開発, 10.2

検証スクリプトの実行, 10.4.5

グループ, 10.4.4.2

制限, 1.4.3.5

別のパーティションへの長時間実行されているインスタンスの移動, 10.4.7

サービス・コンポーネントおよびサービス・エンジンの表をパーティション化しない, 10.4.4.1

パーティションを削除する前にOracle B2B外部キー制約を無効化する必要がある, 10.4.6

コンポーネントの部分的なパーティション化, 10.4.8

レンジ・パーティション・キー, 10.4.4.2

パーティション化を増加率が高い表に制限, 10.4.4.1

パーティション化を実行する前にパージ・スクリプトを実行, 10.4

スキーマのパーティション・キーの選択, 10.4.1.2

ボトルネックを発生する表, 9.4.2.6

検証スクリプト, 10.4.3

パーティションの検証と削除, 10.4.6

パーティション

「SOAコンポジットのアンデプロイ」ウィザードへのアクセス, 7.4

パーティション内のすべてのコンポジットのアクティブ化, 7.9.2

API管理, 11.1, 11.2

一括ライフサイクル管理タスク, 1.4.3.5, 7.9, 7.9.2

既存のパーティションの名前の変更は不可, 7.9.1

ログイン・アクセスを制限できない, 7.9

起動、停止、アクティブ化またはリタイアできない, 7.9

デプロイしたコンポジットを別のパーティションに転送できない, 7.9.1

異なるパーティションにデプロイされている同じインバウンド・リソースを使用したコンポジット, 7.9

作成, 7.9.1

antおよびWLSTを使用して作成, 7.9.1

デフォルト・パーティション, 1.4.3.5, 7.1, 7.9

定義, 1.2.1, 1.4.3, 1.4.3.5, 7.9

削除, 7.9, 7.9.1

パーティション内のすべてのコンポジットの削除とアンデプロイ, 2.2.3, 7.4

コンポジットのパーティションへのデプロイ, 7.9.2

無効な名前, 7.9.1

ヒューマン・ワークフローを持つ同じコンポジットの複数のパーティションへのデプロイに関する問題, 7.1

ソケット・アダプタを使用する場合の制限, 7.9

管理, 7.9

デプロイメントに必要な最小パーティション, 7.1, 7.9.1

命名規則, 7.9.1

状態との関連性がないことについて, 1.4.3.5, 7.9

デプロイ済コンポジットの別のパーティションでの再作成, 7.9.1

パーティション内のすべてのコンポジットのリタイア, 7.9.2

デプロイメント時の選択, 7.1

パーティション内のすべてのコンポジットのシャットダウン, 7.9.2

パーティション内のすべてのコンポジットの起動, 7.9.2

パーティション管理APIに対する最上位レベルのエントリ・ポイント, 11.1, 11.2

パーティション内のすべてのコンポジットのアンデプロイ, 7.4, 7.5.1, 7.9.2

有効な名前, 7.9.1

パスワード

組込みLDAPサーバーのデフォルト・パスワードの変更, 21.12.1

ペイロードの検証

BPELプロセス・サービス・エンジン, 13.1, 39.1

無効なペイロードに対するフォルト生成, 7.5.2

同期サービス, 7.5.2

SOAコンポジット・アプリケーション, 7.5.2

SOAインフラストラクチャ, 3.1

ペイロード

大きなペイロードのエラーの解決, B.7.3

保存, 8.1

パフォーマンス

パフォーマンスの問題を診断するロギングの構成, 3.4.2

SOAコンポジット・アプリケーションのパフォーマンス・サマリー・メトリックの監視, 6.1

SOAインフラストラクチャのパフォーマンス・サマリー・メトリックの監視, 4.2

トポロジ・ビューアでの監視, 4.1

プラガブル通知サービス, 21.6

登録, 21.6.2

ポリシー

バインディング・コンポーネント, 38.1

BPELプロセス・サービス・コンポーネント, 15.2

BPMNプロセス・サービス・コンポーネント, 41.2

ヒューマン・ワークフローWebサービスのセキュリティ・ポリシーの構成, 21.14

定義, 1.4.3.2

使用するポリシーの詳細, 7.7

実行, 1.4.3.2.1

フォルト, 1.4.3.1

グローバルにアタッチされたポリシー, 38.1

ヒューマン・ワークフロー・サービス・コンポーネント, 23.1

SOAコンポジット・アプリケーション, 7.7

サービス・バインディング・コンポーネントのポリシー・アタッチメント・エラーに関する制限, 38.1

バインディング・コンポーネントのポリシー・アタッチメントに関する制限, 38

ローカルのアタッチメント, 7.7.2

サービスと参照におけるエラーの場所, 38.1

同じポリシーを持つ複数のサーバー, 38.1.1

イベント・サブスクリプションに関するポリシーは非サポート, 35.2

Oracle Mediator, 18.2

ポリシー構成プロパティ値のオーバーライド, 38.1.1

ポリシー・セット, 38.1

ヒューマン・タスクを使用している本番環境でのoracle/wss10_saml_token_service_policyの不使用の推奨, 23.1

サポート対象カテゴリ, 1.4.3.2

ポリシー・セット

定義, 21.14, 38.1

ポップされたルールセット, 20.7.1 ポート

SOAインフラストラクチャのサーバーURLポートの変更, 3.3

権限

特定のタスクの実行に必要, 1.4, C.1

プロセス・フロー

BPEL2.0プロジェクト, 14.1.3

BPELプロセスのサービス・コンポーネントの監視, 14.1

SOAコンポジット・アプリケーションのプログラムによる管理, 11.1 プロパティ

アクション可能なアドレス, 21.1

アクション可能な電子メール・アカウント

構成, 21.3

BPELプロセス・サービス・エンジンの監査レベル, 13.1 BPMNプロセス・サービス・エンジンの監査レベル, 39.1 SOAコンポジット・アプリケーションの監査レベル, 7.5.2 SOAインフラストラクチャの監査レベル, 3.1 監査証跡しきい値, 13.1, 39.1 バインディング・コンポーネント, 36.1 コールバック・サーバーURL, 3.1 SOAインフラストラクチャのコンポジット・インスタンスの状態のキャプチャ, 3.1 緑と赤の矢印アイコンが表示された特定のプロパティを変更する場合は再起動が必要, 3.1 チャンク, 3.1 clusterDbTimeRefresh, 13.3 データソース, 3.1 ディスパッチャ・エンジン・スレッド, 13.1, 39.1 ディスパッチャ呼出しスレッド, 13.1, 39.1 ディスパッチャ・システム・スレッド, 13.1, 39.1 動的割当てとタスク・エスカレーション関数, 21.3 ローカルの最適化, 7.7.2 heartBeatInterval, 13.3 インバウンド・アダプタ, 31.4 大容量のドキュメントしきい値, 13.1, 39.1 masteAliveThreshold, 13.3 maxMessageRaiseSize, 13.2, 13.2 nodeReapInterval, 13.3 nodeReapThreshold, 13.3 通知プロパティ, 21.1 Oracle Service Registry, 3.1 Oracle SSL暗号, 3.1 Oracle Walletパスワード, 3.1 優先順位, 3.1 実行の優先順位, 1.4.1, 7.5.2 アウトバウンド・アダプタ, 31.8 SOAコンポジット・アプリケーションでのペイロードの検証, 7.5.2 SOAインフラストラクチャでのペイロードの検証, 3.1 BPELプロセス・サービス・エンジンでのペイロードの検証, 13.1, 39.1 QualityOfService, 15.5.2 サーバーURL, 3.1 SOAインフラストラクチャ, 3.1 startupRecoveryDuration, 13.2 startWindowTime, 13.2 stopWindowTime, 13.2 subsequentTriggerDelay, 13.2, 13.2 threshHoldTimeInMinutes, 13.2 UDDIレジストリ, 3.1 Webサービス・バインディング, 3.1 プロキシ・ドライバ

クライアントAPI, 27.4.1.9.3

共通プロパティ, 27.4.1.9.1

構成, 27.4.1.9

カスタム・プロパティ, 27.4.1.9.2

プロキシ・サーバー

プロキシ・プロパティを設定するためのベスト・プラクティス, B.8.3

指定, B.8.3

パージ

オープンおよびクローズされたすべてのインスタンス, 10.3.1.1

大量のデータをパージする前に索引を削除し、後で索引を追加して戻す, 10.3.2

パラレル・スクリプトでのループしたパージによるインスタンスの削除, 10.3.2

ループしたパージ・スクリプトによるインスタンスの削除, 10.3.1

パージ・スクリプトを使用した大量のインスタンスの削除, 10.3

孤立したインスタンスの削除, 8.2

方法の開発, 10.2

パージ・スクリプトの実行, 10.3.6

パージ対象のインスタンス状態, 10.3.3

インスタンス, 10.3

Microsoft SQL Serverのインスタンス, 10.7

パージ・スクリプトの場所, 10.3.6

パージ・スクリプトの機能, 10.3

様々なOracle SOA Suiteリリースでサポートされているパージ・スクリプト, 10.3

アップグレード時に実行するパージ・スクリプト, 10.3

Oracle Mediatorのリシーケンスされたメッセージのパージの状態, 10.3.4

特定のSOAコンポジット・アプリケーションのインスタンス, 10.3.5

「オプションを指定して削除」ダイアログまたはパージ・スクリプトを使用するタイミング, 8.2, 8.3

プッシュされたルールセット, 20.7.1

Q

「QualityOfService」プロパティ

Oracle Coherenceキャッシュの有効化または無効化, 13.1

QueueOpenOptionsプロパティ

サービス・バインディング・コンポーネントで非サポート, 36.1.2.6

R

リカバリ

メッセージ・リカバリ・アクション, 15.4

リカバリ可能アクティビティ

定義, 15.4

リカバリ

マスター・ノード, 13.3

リカバリ・アクション

中断, 8.4, 8.5, 14.1, 15.1, 15.3, 18.1, 18.3

続行, 8.4, 8.5, 14.1, 15.1, 15.3, 18.1, 18.3

リプレイ, 8.4, 8.5, 14.1, 15.1, 15.3, 18.1, 18.3

再スロー, 8.4, 8.5, 14.1, 15.1, 15.3, 18.1, 18.3

再試行, 8.4, 8.5, 14.1, 15.1, 15.3, 18.1, 18.3

再デプロイメント

再デプロイ後のBPMNインスタンスの動作, 7.3

再デプロイ後のサービス・コンポーネント・インスタンスの動作, 7.3

SSO対応Oracle Enterprise Manager Fusion Middleware Controlからの, 7

ガイドライン, 7.3

再デプロイ後も現在のBPMコンポジット・インスタンスの実行を継続, 7.3

再デプロイ時にインスタンスを継続するオプションの選択に関する制限, 7.3

失敗の考えられる理由, 7.3, 7.3

複数のコンポジットを一度に再デプロイする機能はサポートされない, 7.3

SOAコンポジット・アプリケーション, 7.3

インスタンス、フォルトおよび拒否メッセージの失効状態への更新, 7.2

参照

定義, 1.2.5, 4.5

エンドポイント・アドレスの表示, 7.5.2

WSDLファイルの表示, 7.5.2

ポリシー・エラーの場所, 38.1

監視, 4.5

「アラーム表のリフレッシュ」ボタン

消失したジョブの再同期化, 15.4

リフレッシュ・アイコン

場所、7.5.1

拒否メッセージ

バインディング・コンポーネント, 37.2

定義, 1.4.3.1

SOAインフラストラクチャ・レベルでの削除, 8.6

アプリケーションのホーム・ページからの削除, 8.7

インバウンド・アダプタ, 31.2, 31.3

「拒否メッセージの削除」オプションを使用するタイミング, 8.6, 8.7

リプレイ

リカバリ・アクション, 8.4, 8.5, 14.1, 15.1, 15.3, 18.1, 18.3

replayアクティビティ

フォルトが発生していないのに失敗したと表示される, 14.1.1

レポート・エンジン

監視, 25.3.1

リクエストのブレークダウン

Oracle Mediatorの統計, 17.3.3

リクエストのブレークダウン表の詳細

表示, 14.6.1

リクエスト

BPELプロセス・サービス・エンジンでのリクエストの所要時間, 14.9

ヒューマン・ワークフロー・サービス・エンジンのリクエストと操作統計, 22.4, 22.5 リシーケンサ表

パージ, 10.3.4

reset

メッセージ・リカバリ・アクション, 15.4

RESTful Webサービス

「Webサービスのテスト」ページのセキュリティ・オプション, 8.1

「Webサービスのテスト」ページでのテスト, 8.1

再スロー

リカバリ・アクション, 8.4, 8.5, 14.1, 15.1, 15.3, 18.1, 18.3

リタイア

デフォルトのSOAコンポジット・アプリケーションのリビジョン, 7.5.1

SOAコンポジット・アプリケーションのリビジョン, 7.5.1, 7.5.2

デフォルトのSOAコンポジット・アプリケーションのリビジョンのリタイアによる影響, 7.5.1, 7.5.1

デフォルトのSOAコンポジット・アプリケーションのリビジョンのアンデプロイによる影響, 7.5.1, 7.5.1

再試行

リカバリ・アクション, 8.4, 8.5, 14.1, 15.1, 15.3, 18.1, 18.3

リビジョン

定義, 1.4.3.3

デフォルトのリビジョンと他のリビジョンの区別, 1.4.3.3

複数のコンポジット・リビジョン間のインスタンスの移行, 8.8

デフォルトのコンポジット・リビジョンのアンデプロイメント, 7.4

使用可能なアクティブなリビジョンが他にない場合のデフォルトのコンポジット・リビションのアンデプロイメント, 7.4

アプリケーション名に付加されるバージョン, 1.4.3.3

ロール

管理者, C.1

監査証跡へのアクセス, C.1.15

BPELプロセス・サービス・コンポーネントのホーム・ページへのアクセス, C.1.10

BPELプロセス・サービス・エンジンへのアクセス, C.1.6

「ビジネス・イベント」ページへのアクセス, C.1.19

ビジネス・ルール・サービス・エンジンへのアクセス, C.1.9

コンポジットのホーム・ページへのアクセス, C.1.5

作成, C

デシジョン・サービス・コンポーネントのホーム・ページへのアクセス, C.1.13

「フローのトレース」ページへのアクセス, C.1.14

ヒューマン・タスク・サービス・コンポーネントのホーム・ページへのアクセス, C.1.12

ヒューマン・ワークフロー・サービス・エンジンへのアクセス, C.1.8

Oracle WebLogic Server MonitorsグループまたはユーザーへのSOAMonitorロールのマッピング, 5.2

Oracle WebLogic Server OperatorsグループまたはユーザーへのSOAOperatorロールのマッピング, 5.2

ロール機能のマトリックス, C.1.1

モニター, C.1

オペレータ, C.1

Oracle B2Bのページへのアクセス, C.1.18

Oracle Mediatorサービス・コンポーネントのホーム・ページへのアクセス, C.1.11

Oracle Mediatorサービス・エンジンへのアクセス, C.1.7

「参照ホーム」ページへのアクセス, C.1.17

特定のタスクの実行に必要, 1.4, C.1

「サービス・ホーム」ページへのアクセス, C.1.16

「SOAコンポジット」メニューへのアクセス, C.1.4

「SOAインフラストラクチャ」メニューへのアクセス, C.1.3

「SOAインフラストラクチャ」ページへのアクセス, C.1.2

システムMBeanブラウザへのアクセス, C.1.20

Oracle Mediatorのルーティング統計, 17.2.4 RPC/リテラルスタイルのWSDLファイル

指定, 8.1.1

ルール実行トレース

「ビジネス・ルール実行トレース」を参照

ルール

「ビジネス・ルール」を参照

S

SAMLメッセージ保護付きポリシー構成

SOAインフラストラクチャの設定, 5.4

検索基準

最近のインスタンスおよびフォルトを最近の期間内のみでフェッチするデフォルト検索条件を設定する, 3.1

Secure Socket Layer

「SSL」を参照

保護

Oracle Business Activity Monitoring (BAM), 24.9

Oracle User Messaging Service (UMS), 27.6

セキュリティ

アプリケーション・ポリシー, 2.2.1

アプリケーション・ロール, 2.2.1

SAML SSO環境でのOracle BPM Worklistユーザーの自動認証, 5.5.1

Windowsのネイティブ認証環境でのOracle BPM Worklistユーザーの自動認証, 5.5.4

Windowsのネイティブ認証環境でのOracle Business Process Composerユーザーの自動認証, 5.5.5

使用可能なドキュメント, 5.1

ヒューマン・ワークフローWSDLファイルの構成, 5.9

双方向SSL通信の構成, 5.8.4

Oracle BPM Worklist用のOracle HTTP Serverの構成, 5.3

Oracle Single Sign-On (OSSO)の構成, 5.1

Oracle SOA SuiteおよびOracle HTTP ServerのSSL通信の構成, 5.8.6

SOAコンポジット・アプリケーション・インスタンスとOracle WebCache間のSSLの構成, 5.8.7

locatorオブジェクト作成時に必要な資格証明, 11.1.1

Oracle WebLogic Serverで使用する新規セキュリティ・プロバイダの開発, 5.1

SSL対応の管理対象サーバーにデプロイ済の非同期プロセスの有効化による、HTTPを介した別の非同期プロセスの呼出し, 5.8.9

NTLM認証をリクエストするWebサービスの起動, 5.7

Oracle JDeveloperの一方向SSL環境での参照の呼出し, 5.8.5

Oracle Internet Directoryを最初の認証プロバイダとして表示, 5.6.1

テスト時のメッセージを使用したセキュリティ・プロパティの引渡し, 8.1

SOAコンポジット・アプリケーションのポリシー, 7.7

Oracle SOA Suiteに固有の手順, 5.1

Oracle WebLogic Serverのセキュリティ・プログラミング, 5.1

SSLで管理対象サーバーを全部構成する、または構成しないための推奨事項, 5.8.2

Oracle WebLogic Serverの本番環境の保護, 5.1

Webサービスの保護および管理, 5.1

Oracle WebLogic Serverの保護, 5.1

Oracle WebLogic ServerのWebサービスの保護, 5.1

SOAインフラストラクチャのSAMLメッセージ保護付きポリシー構成の設定, 5.4

Oracle BPM Worklistでの非SSLからSSL構成への切替え, 5.8.3

Oracle WebLogic Serverのセキュリティの理解, 5.1

設計時の一方向SSLでのカスタム・トラスト・ストアの使用, 5.8.8

HTTPSポートで構成されたSOA/BPMサーバーでのSSL証明書の使用, 5.8.1

シード

デモ・ユーザー・コミュニティのデータベースへの, A

LDAPツールを使用したユーザー、グループおよびアプリケーション・ロールのシード, 21.12

センサー, 14.1, 40.1

BPEL 2.0 compensateおよびcompensateScopeアクティビティ内でのアクティビティ・センサーの動作, 14.4.1

ビジネス監視, 7.10

サービス・エンジン・レベルでのBPELセンサーの無効化, 13.1

SOAコンポジット・アプリケーション・レベルでのBPELセンサーの無効化, 7.5.2

現在の状態の表示, 7.5.2

JMSセンサーの値が表示されない, 14.4

監視, 14.4

サーバーURL

プロパティ, 3.1

プロパティを変更する場合は再起動が必要, 3.1

ServerManager

パーティション管理APIに対する最上位レベルのエントリ・ポイント, 11.1, 11.2

サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネント

「バインディング・コンポーネント」を参照

サービス・コンポーネント

BPELプロセス, 14, 15

BPMNプロセス, 40

定義, 1.2.4

ヒューマン・ワークフロー, 21, 22, 23

インスタンスID, 1.2.4

インスタンス, 1.2.4

Oracle Mediator, 16

孤立したインスタンス, 8.2

サービス・エンジン

BPELプロセス, 14, 15

BPMNプロセス, 40

定義, 1.2.6

ヒューマン・ワークフロー, 21, 22, 23

SOAインフラストラクチャ・レベルでの監視, 4.3

平均リクエスト処理時間の監視, 4.4

Springサービス・コンポーネントの管理ページがない, 1.2.4.1, 1.2.4.1

Oracle Mediator, 16

サービス・インフラストラクチャ

定義, 1.2.7

平均リクエスト処理時間の監視, 4.4

サービス・キー

Oracle Service Registryのための変更, 36.1.3

サービス

定義, 1.2.5, 4.5

ポリシー・エラーの場所, 38.1

監視, 4.5, 38.2.2

「時間しきい値の設定」リンク

定義, 4.3, 6.2

共有データ

コンポジット・エクスポートの一部としてエクスポートされない, 7.8

「詳細の表示」リンク

定義, 4.3, 6.2

停止

コンポジット・リビション, 7.5.1, 7.5.2

SMPPドライバ

クライアントAPI, 27.4.1.5.4

共通プロパティ, 27.4.1.5.2

構成, 27.4.1.5

カスタム・プロパティ, 27.4.1.5.3

相互運用性, 27.4.1.5.1

SMTPサーバー

構成, 21.1

構成後のSOAサーバーの再起動, 21.1

SOAコンポジット・アプリケーション

リビジョンのアクティブ化, 7.5.1, 7.5.2

SOAインフラストラクチャ停止後のアプリケーションの状態, 3.2.2

監査レベル, 7.5.2

双方向SSL通信の構成, 5.8.4

Oracle SOA SuiteおよびOracle HTTP ServerのSSL通信の構成, 5.8.6

コンテンツ, 1.2.8

グローバル・トークン変数の作成, 3.8

定義, 1.2.2

インスタンスの削除, 8.2, 8.3

デプロイ済の状態, 7.5

デプロイ, 7

リビジョンのデプロイ, 7.5.1

フォルト・リカバリ, 8.5

フォルト, 8.5

インスタンスの状態によるフィルタリング, 8.2, 8.3

コンポジットおよびコンポーネントのプログラムによる検索, 11.3.2

デフォルトのリビジョンのリタイアによる影響, 7.5.1, 7.5.1

デフォルトのリビジョンのアンデプロイによる影響, 7.5.1, 7.5.1

一方のBPELプロセスが完了してもう一方のBPELプロセスが失敗した場合, 8.2.2

インスタンス, 1.2.3

ライフサイクル, 1.4.3.3

管理, 8

SOAインフラストラクチャ・レベルでのアプリケーションの状態管理, 7.5.1

SOAコンポジット・アプリケーションのホーム・ページでのアプリケーションの状態管理,, 7.5.2

ホーム・ページに表示されるメッセージ・リカバリ情報, 1.2.1, 6.2

監視, 6

フォルトの監視, 6.2

インスタンスの監視, 6.2

パッケージ化, 7

ペイロードの検証, 7.5.2

ポリシー, 7.7

プログラムによる管理, 11.1

インスタンスのパージ, 10.3.5

再デプロイ, 7.3

リビジョンの再デプロイ, 7.5.1

デフォルトのリビジョンのリタイア, 7.5.1

リビジョンのリタイア, 7.5.1, 7.5.2

コンポジットの状態のプログラムによる取得, 11.3

保護, 5

デフォルトのリビジョンの設定, 7.5.1

設計時におけるインスタンス名の設定, 7.5.4

コンポジットXML定義の表示, 7.5.2

WSDLおよびエンドポイントURIの表示, 7.5.2

リビジョンの停止, 7.5.1, 7.5.2

リビジョンの起動, 7.5.1, 7.5.2

コンポジットが停止またはリタイアしているときは「テスト」ボタンが無効, 7.5.2

テスト・インスタンス, 8.1

テスト, 1.4.3.4, 7.5.2, 7.6

アンデプロイ, 7.4

リビジョンのアンデプロイ, 7.5.1

デフォルトのコンポジット・リビジョンのアンデプロイ, 7.4

「SOAコンポジット」メニュー

オプションの説明, 2.2.2

移動, 2.2.2

SOAガバナンス

定義, 1.4.3.3

SOAインフラストラクチャ

監査レベル, 3.1

Oracle WebLogic Server管理コンソールからインフラストラクチャのポートを変更できない, 3.3

ポートの変更, 3.3

構成, 3

起動時に受信リクエストを管理するために完全には初期化されない可能性, 4.3, 7.9

フォルト・リカバリ, 8.4

フォルト, 8.4

アプリケーションの状態管理, 7.5.1

すべてのデプロイ済コンポジットがロードされるまで受信リクエストを管理するために完全には初期化できない, 3.2.1

ホーム・ページに表示されるメッセージ・リカバリ情報, 4.3

監視, 4

ペイロードの検証, 3.1

リクエスト処理, 4.4

プロパティ, 3.1

最新のインスタンスとフォルト, 4.3

リタイアされたコンポジットがアクティブ化されているときは、SOAインフラストラクチャを再起動しても、エンドポイントがアクティブ化されない, 3.2.3

起動と停止, 3.2

cwallet.ssoにSOAマップが含まれている場合の起動の失敗, 3.2.4

SOAインフラストラクチャの停止後のコンポジットの状態, 3.2.2

起動初期化の完了の待機, 3.2.1, 7.5.2

SOAインフラストラクチャ・アプリケーション

定義, 1.2.1

「SOAインフラストラクチャ」メニュー

オプションの説明, 2.2.1

移動, 2.2.1

「SOAパーティション」メニュー

移動, 2.2.3

SOAMonitorロール

Oracle WebLogic Server Monitorsグループまたはユーザーへのマッピング, 5.2

SOAOperatorロール

Oracle WebLogic Server Operatorsグループまたはユーザーへのマッピング, 5.2

ソース

メッセージ, 25.2.4

Springサービス・コンポーネント

定義, 1.2.4

Springサービス・エンジン管理ページがないことについて, 1.2.6

実行中および終了したインスタンスの状態をサポートしない, 1.2.4.1

Oracle Enterprise Managerでのサポート範囲, 1.2.4.1, 1.2.4.1

SSL

双方向SSL通信の構成, 5.8.4

Oracle SOA SuiteおよびOracle HTTP ServerのSSL通信の構成, 5.8.6

SOAコンポジット・アプリケーションの双方向SSL通信の構成, 5.8.4

SOAコンポジット・アプリケーション・インスタンスとOracle WebCache間のSSLの構成, 5.8.7

Oracle Business Activity Monitoring (BAM)を使用した構成, 24.9.3

SSL対応の管理対象サーバーにデプロイ済の非同期プロセスの有効化による、HTTPを介した別の非同期プロセスの呼出し, 5.8.9

Oracle JDeveloperの一方向SSL環境での参照の呼出し, 5.8.5

キーの別名, 5.8.4

SSLで管理対象サーバーを全部構成する、または構成しないための推奨事項, 5.8.2

Oracle BPM Worklistでの非SSLからSSL構成への切替え, 5.8.3

設計時の一方向SSLでのカスタム・トラスト・ストアの使用, 5.8.8

HTTPSポートで構成されたSOA/BPMサーバーでのSSL証明書の使用, 5.8.1

失効のインスタンス

インスタンス、フォルトおよび拒否メッセージの失効状態への更新, 7.2

「開始時間: 自」フィールド

最近のインスタンスおよびフォルトを最近の期間内のみでフェッチするデフォルト検索条件を設定する, 3.1

開始

BPEL処理途中でSOAインフラストラクチャがデプロイされる管理対象のOracle WebLogic Server, 7.5.3

起動

コンポジット・リビション, 7.5.1, 7.5.2

「startupRecoveryDuration」プロパティ

定義, 13.2

「startWindowTime」プロパティ

定義, 13.2

「StatsLastN」プロパティ

システムMBeanブラウザ, 14.6.1

停止

BPEL処理途中でSOAインフラストラクチャがデプロイされる管理対象のOracle WebLogic Server, 7.5.3

「stopWindowTime」プロパティ

定義, 13.2

ストレス・テスト

複数インスタンスの起動, 8.1

「subsequentTriggerDelay」プロパティ

定義, 13.2, 13.2

同期サービス

ペイロードの検証, 7.5.2

システム・ディスパッチャ・メッセージ

定義, 13.1

システム・フォルト, 1.4.3.1 システムMBeanブラウザ

コンポーネントのプロパティ・ページからのアクセス, 2.3.2

メインのブラウザ・ページからのアクセス, 2.3.1

「ASNSDriverIMAddress」プロパティ, 21.1

「ASNSDrivers」プロパティ, 21.9

AsynchAuditBatchSize, 13.1, 15.5.4

「AsyncProcessStats」プロパティ, 14.6.1, 14.9, 14.9, 14.9

「AuditConfig」プロパティ, 3.1, 3.1, 4.3, 4.3, 6.2, 6.2, 8.2, 8.3, 14.1, 14.1

「AuditStorePolicy」プロパティ, 15.5.5

「BpelcClasspath」プロパティ, 13.1

「bpel.config.auditlevel」プロパティ, 13.6

「CreateWSCallTrackingMBean」プロパティ, 3.1

「CustomNSDriverPropertyNames」プロパティ, 21.1, 21.6.2

DisableAsserts, 13.1

DisableSensors, 13.1

インスタンス数とフォルト数のメトリックの取得の無効化, 3.1.1

DispatcherNonBlockInvokeThreads, 13.1

ExecuteCallbacksInOrder, 13.1

「ExpirationMaxRetry」プロパティ, 13.1

「ExpirationRetryDelay」プロパティ, 13.1

「FaxCoverPageCount」プロパティ, 21.1

「GlobalTxMaxRetry」プロパティ, 3.1

「GlobalTxRetryInterval」プロパティ, 3.1

「HttpProxyAuthRealm」プロパティ, 3.1

「HttpProxyAuthType」プロパティ, 3.1

「HttpProxyHost」プロパティ, 3.1

「HttpProxyPassword」プロパティ, 3.1

「HttpProxyPort」プロパティ, 3.1

「HttpProxyUsername」プロパティ, 3.1

「HttpServerURL」プロパティ, 3.1

「HttpsServerURL」プロパティ, 3.1

「InstanceKeyBlockSize」プロパティ, 13.1

使用方法, 2.2.1

WLSTを使用したカスタムMBeanの起動, 2.2.1

「KeystoreLocation」プロパティ, 3.1, 5.8.4

「MaximumNumberOfInvokeMessagesInCache」プロパティ, 13.1

「MaxRecoveryAttempt」プロパティ, 13.1

MinBPELWait, 13.1

移動, 2.3

ナビゲーション・パス, 3.1

「OneWayDeliveryPolicy」プロパティ, 13.1

「oneWayDeliveryPolicy」プロパティ, 15.5.6

「QualityOfService」プロパティ, 13.1, 15.5.3, 15.5.5, 15.5.6

「QualityOfService.AuditStorePolicy.UseDistributedCache」プロパティ, 15.5.5

「QualityOfService.OneWayDeliveryPolicy.UseDistributedCache」プロパティ, 15.5.6

RecoveryConfig, 13.1

「RequestStats」プロパティ, 14.6.1, 14.9, 14.9

「RetryNotificationMessageThrottle」プロパティ, 21.1

「ServerURL」プロパティ, 3.3

SOAインフラストラクチャ拡張構成プロパティ, 3.1

「StatsLastN」プロパティ, 12.2.11, 13.1

「SyncMaxWaitTime」プロパティ, 13.1

「SyncProcessStats」プロパティ, 14.6.1, 14.9, 14.9

「UddiCacheLifetime」プロパティ, 3.1, 36.1.3.1

T

表領域

拡張による実行時の問題の回避, B.7.4

タスク・オート・リリース

構成, 21.3

ポータル・レルム・マッピング構成, 21.3

割当て先のプッシュバック, 21.3

タスク・オート・リリース構成, 21.3

ワークリスト・アプリケーションURL構成, 21.3

タスク・エスカレーション, 21.3 タスク・フロー

デプロイメント, 7.1.2

タスク・フォーム

Oracle HTTP Serverでのタスク・フォームの添付の構成, 21.4

タスク・サービス

ワークフロー・カスタム・クラスパスURLの構成, 21.3

ワークフロー・サービス・セッション・タイムアウトの構成, 21.3

タスク・サービス・プロパティ

ヒューマン・ワークフロー, 21.3

テスト・ケース

内容, 7.6

定義, 1.4.3.4

テスト実行

定義, 7.6

テスト・スイート

アサーション, 1.4.3.4

定義, 1.4.3.4

エミュレーション, 1.4.3.4

テスト

SOAコンポジット・アプリケーションのテストの自動化, 7.6

テスト・インスタンスの起動, 8.1

メッセージを使用したセキュリティ・プロパティの引渡し, 8.1

「Webサービスのテスト」ページでのペイロード・データの表示に関する制限事項, 8.1

「Webサービスのテスト」ページのストレス・ツールに関する制限事項, 8.1

「テスト」ボタンが無効になる場合, 7.5.2, 8.1

XMLペイロード・データの指定, 8.1

コンポジットが停止またはリタイアしているときは「テスト」ボタンが無効, 7.5.2

リビジョン番号を含まないWSDL URLはデフォルトのコンポジットによって処理される, 8.1

サード・パーティ・アプリケーション・サーバー

このガイドを使用するための手順, 1.4

すべての管理対象サーバーからのスレッド・ダンプ, B.1.1 「threshHoldTimeInMinutes」プロパティ

定義, 13.2

スループット

インスタンスの詳細, 14.2

タイムアウト

解決, B.3.1

設定, 13.1

トークン

複数のSOAコンポジット・アプリケーションのグローバル・トークン変数の作成, 3.8

TopLinkセッション

キャッシュの管理, 2.2.1

トポロジ

Oracle SOA Suiteルーティング関係の検出, 4.1

トポロジ・ビューア

パフォーマンスの監視, 4.1

トランザクション・タイムアウト

設定, 13.1

トラブルシューティング, B.3

一時プロセス

定義, B.6.5

トラブルシューティング

その他のドキュメント, B.10

AMX拡張の問題, B.5.14

アプリケーション・トランザクションが完了せず、基になるコンポジットが実行状態でスタックしている, B.4.4

非同期トランザクションの長時間後のエラー・リターン, B.3.4

BPELインスタンスの自動リカバリで特定インスタンスがリカバリされない, B.4.2

管理対象サーバーの起動および停止のベスト・プラクティス, B.8.1

ビジネス・イベント, B.6

データベース増分, B.2

実行時のデザインタイムの問題, B.5.10

イベント配信ネットワーク, B.6

表領域の拡張, B.7.4

ローエンドのホストにおけるフロー・ダイアグラムの表示問題, B.8.4

ヒューマン・ワークフローAPIの使用の問題, B.5.11

ヒューマン・ワークフローの問題, B.5

アイデンティティ・サービスの問題, B.5.17

データベース接続値の増加, B.3.2

Safariブラウザ使用における制限, B.9.1

リモートWebサービスへの長時間実行される同期コールによるエラーの発生, B.3.4

通知の問題, B.5.3

Oracle BPM Worklist/タスク・リージョンの問題, B.5.15

Oracle JDeveloperのデータ・コントロール/フォーム生成の問題, B.5.12

Oracle User Messaging Service (UMS), 27.7

接続タイムアウトの解決, B.3.1

大量のトランザクションによるデータベース増大の解決, B.7.5

ペイロードが大きいことによって発生する例外エラーの解決, B.7.3

開いているファイルが多すぎることが原因で発生したメッセージの失敗の解決, B.7.2

ランタイム診断, B.4

「WSDLを読み取れません」という実行時エラー, B.4.1

サービス/システムMBeanブラウザの問題, B.5.13

ログ・レベルの設定, B.1

低速なアプリケーション・パフォーマンス, B.7.6

SOAサーバー起動の問題, B.8.2

障害発生時に一部コンポジットは複数回再試行される, B.4.3

タスク・アクションの問題, B.5.2

タスク割当て、ルーティングおよびエスカレーションの問題, B.5.1

タスクの属性マッピングの問題, B.5.5

タスク・コメント/添付の問題, B.5.9

タスク・フォーム/アクションの問題, B.5.8

タスク履歴の問題, B.5.7

タスク・レポートの問題, B.5.6

タスク・ビューの問題, B.5.4

テストから本番への移行の問題, B.5.16

EJBトランザクション・タイムアウトの更新, B.3.3

TRSスクリプト

使用に関する考慮事項, 10.6.1

作成, 10.6.4

機能, 10.6.2

ロギングとデバッグ, 10.6.6

Oracle以外のデータベースでサポートされない, 10.6.1

オープン・コンポジット・インスタンスでの表の再作成およびデータベース領域の再利用, 10.6

実行, 10.6.5

切捨てスクリプト

表削除なしでの実行時表からのレコードの削除, 10.5

U

UDDIレジストリ

Webサービスの公開の構成, 38.2.1

照会URL, 3.1

プロパティ, 3.1

公開, 38.2

Webサービスの公開, 38.2.2

UMS

「Oracle User Messaging Service」を参照

アンデプロイメント

パーティションとそのすべてのコンポジットの削除, 7.4

SSO対応Oracle Enterprise Manager Fusion Middleware Controlからの, 7

ガイドライン, 7.4

コンポジット・リビション, 7.5.1

パーティション内のすべてのコンポジット, 7.4

アプリケーション・インスタンスをアンデプロイしてもインスタンスが完了しない, 14.7, 17.3.2

デフォルトのコンポジット・リビジョン, 7.4

使用可能なアクティブなリビジョンが他にない場合のデフォルトのコンポジット・リビション, 7.4, 7.5.1

SOAコンポジット・アプリケーション, 7.4

インスタンス、フォルトおよび拒否メッセージの失効状態への更新, 7.2

ユニット・テスト

アサーション, 1.4.3.4

ユニット・テスト・インスタンスと他のインスタンスの区別, 1.2.3, 7.6

エミュレーション, 1.4.3.4

SOAコンポジット・アプリケーション, 1.4.3.4

実行, 7.6

テスト・ケース, 1.4.3.4

テスト・スイート, 1.4.3.4

ユーザー・アクセスの監査, 34.1.2

監査ログ, 34.3

構成, 34.2

healthcare UIアクティビティ, 34.1.1

ユーザー

デモ・ユーザー・コミュニティ, A.1, A.2

LDAPツールを使用したシード, 21.12

V

検証スクリプト

実行, 10.4.5

パーティション化, 10.4.3

ビジネス・ルール用に提供されていない, 10.4.5

VoiceXMLドライバ

クライアントAPI, 27.4.1.7.4

共通プロパティ, 27.4.1.7.2

構成, 27.4.1.7

カスタム・プロパティ, 27.4.1.7.3

相互運用性, 27.4.1.7.1

W

監視

作成, 12.5

処理遅延が指定の制限時間を超えているかどうかを識別するために作成, 12.5.4

Webサービス・バインディング・コールの経過時間を識別するために作成, 12.5.3

事前構成済ルールおよび監視の有効化, 12.5.1

Webブラウザ

「詳細をクリップボードにコピー」リンクがMozilla Firefoxで表示されない, 14.1

Safariブラウザを使用してWSDLファイルの内容を表示する場合の制限, B.9.1

サポート対象, 2.1

Webサービス・バインディング・プロパティ, 3.1 Webサービス

構成, 36.1.1

WebLogic診断フレームワーク

「WLDF」を参照

WLDF

定義, 12.1.1

WLST

パーティションの作成, 7.9.1

ドライバのデプロイ, 29.1.1

デプロイメント, 7.1.3

診断フレームワークのコマンド, 12.1.2

事前構成済ルールおよび監視の有効化, 12.5.1

カスタムMBeanの起動, 2.2.1

起動, 12.2

ワークフロー・カスタム・クラスパスURL

構成, 21.3

ワークフロー・サービス・セッション・タイムアウト

構成, 21.3

ワークリスト・ドライバ

クライアントAPI, 27.4.1.8.5

共通プロパティ, 27.4.1.8.3

構成, 27.4.1.8

カスタム・プロパティ, 27.4.1.8.4

インストール, 27.4.1.8.1

IBM WebSphereプラットフォームでのインストール, 27.4.1.8.2

wsadmin

ドライバのデプロイ, 29.1.4

WSDLファイル

すべての外部サービスのWSDLファイルの表示, 7.5.2

ヒューマン・ワークフロー, 5.9

インスタンス作成時の指定, 8.1

RPC/リテラル・スタイルのWSDLファイルの指定, 8.1.1

デフォルトのリビジョンの指定, 8.1

リビジョン番号を含まないWSDL URLはデフォルトのコンポジットによって処理される, 8.1

WS信頼できるメッセージング

制限, 7.7.1

X

XML定義

SOAコンポジット・アプリケーション, 7.5.2

XMLペイロード・データ

インスタンス作成時の指定, 8.1

XML_DOCUMENT表

再構築の前提条件, 10.6.3

XMPPドライバ

アプリケーション・アーカイブ(EAR), 27.4.1.6.4

クライアントAPI, 27.4.1.6.7

共通プロパティ, 27.4.1.6.5

構成, 27.4.1.6

カスタム・プロパティ, 27.4.1.6.6

定義, 27.4.1.6.1

相互運用性, 27.4.1.6.2, 27.4.1.6.3

オラクル社の法律上の注意点について

コピーライトについて

Copyright © 1994-2014, Oracle and/or its affiliates.All rights reserved.

商標と登録商標について

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

制限付権利

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション（人的傷害を発生させる可能性があるアプリケーションを含む）への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。