C トラブルシューティング

この付録では、Oracle Enterprise Managerのコンポーネントで検出されている問題の解決方法について説明します。

C.1 Oracle Enterprise Managerの「プロセス」タブにおけるBPELプロセスの表示

BPEL（Business Process Execution Language）は、XMLベースの言語であり、一連のWebサービスを組み合せて使用する複数のエンタープライズに渡ってタスク共有を可能にします。BPELは、XMLスキーマ、SOAP（シンプル・オブジェクト・アクセス・プロトコル）およびWSDL（Web services description language）に基づいています。エンタープライズはBPELにより、ビジネス・プロセスの編集および実行のための業界標準が得られます。BPELを使用すると、個々のサービスを統合して包括的なプロセス・フローを構築するビジネス・プロセスを設計できます。この統合により、プロセスのコストと複雑性を低減できます。BPEL言語を使用すると、次の作業の方法を定義できます。

リモート・サービスに対するXMLメッセージの送信、リモート・サービスからのXMLメッセージの非同期受信
XMLデータ構造の操作
インベントリおよび例外の管理
プロセス実行のパラレル・フローの設計
例外発生時における一部のプロセスの取消し

エンタープライズでは、Oracle BPEL Process Managerを使用すると、BPELプロセスのモデリング、デプロイおよび管理を実行できます。Oracle BPEL Process Managerには、BPELビジネス・プロセス・モデラー、スケーラブルなBPELランタイム・エンジン、拡張可能なWSDLバインディング・フレームワークおよび監視用コンソールが含まれています。

BPELターゲットは、Oracle Enterprise Managerで検出できます。BPELターゲットが検出された場合、Enterprise ManagerのBPEL Process Managerの「プロセス」タブにBPELプロセスが表示されないことがあります。これには、2つの原因があります。BPELプロセスを「プロセス」タブに確実に表示させる方法は、2つあります。これらのシナリオを、後続の項で詳しく説明します。

C.1.1 シナリオ1: Oracle Enterprise Manager Grid Controlによる資格証明の指定

BPELターゲットの監視に必要な資格証明が、Enterprise Manager Grid Controlで提供されていません。これを解決するには、次の手順に従ってEnterprise Manager Grid Controlを使用し、資格証明を指定します。

BPEL Process Managerのホームページで、「監視構成」のリンクをクリックします。

「監視構成」ページで、次の4つのフィールドをチェックします。

BPEL管理ユーザー名: BPEL管理者のユーザーIDを指定します。
BPEL管理パスワード: BPEL管理ユーザーのパスワードを指定します。

資格証明を追加する際は、次の2つの基準を満たす必要があります。
- BPEL管理者ユーザーの名前とパスワードが、BPEL Adminのロールを備えていること
- 同じ資格証明で、BPELコンソールのログイン操作に成功すること
初期コンテキスト・ファクトリ: このフィールドが空の場合は、文字列値'com.evermind.server.rmi.RMIInitialContextFactory'をコピーしてください。

コンテキスト・プロバイダURL: このフィールドが空の場合は、次の文字列をコピーしてください。

opmn:ormi://<host>:<opmn_port>:home/orabpel

注意:
<host>と<opmn port>は、正しいホスト・アドレスとopmnポート番号に置き換えてください。（<opmn port>を取得する方法は、「OPMNポートの取得」を参照してください。）

「OK」をクリックして、設定を保存します。

C.1.2 シナリオ2: エージェントのCLASSPATHに対する必要なBPEL jarファイルの追加

必要なBPEL jarファイル（記憶域コンテナ）が、エージェントのCLASSPATHに追加されていません。jarファイルを追加するには、次の手順に従います。

SOAがインストールされているホスト・マシンにログインします。
同じホストにインストールされているEMエージェントのORACLE_HOMEに移動します。
ファイル'$AGENT_ORACLE_HOME/sysman/config/emd.properties'を開きます。

このファイル内のCLASSPATHプロパティに次のjarファイルが追加済か否かをチェックします。BPELに固有なjarファイル名を指定してこのプロパティを手動で更新し、プロセスのリストを取得します。

$BPEL_SERVER_ORACLE_HOME/opmn/lib/optic.jar
$BPEL_SERVER_ORACLE_HOME/bpel/lib/orabpel.jar
$BPEL_SERVER_ORACLE_HOME/bpel/lib/orabpel-common.jar
$BPEL_SERVER_ORACLE_HOME/bpel/lib/orabpel-thirdparty.jar
$BPEL_SERVER_ORACLE_HOME/j2ee/home/oc4jclient.jar

$BPEL_SERVER_ORACLE_HOME/j2ee/home/j2ee_1.3.01.jar

注意:
$BPEL_SERVER_ORACLE_HOMEは、SOAがインストールされているアプリケーション・サーバーのORACLE_HOMEパスの絶対パスに置き換える必要があります。

一連のjarファイル名をCLASSPATHプロパティに追加します。jarファイルをCLASSPATHに追加する際は、BPELホームのoptic.jarプロパティがCLASSPATHの先頭値であることを確認してください。
EMエージェントを再起動します。

C.1.3 OPMNポートの取得

SOA Applications ServerのOPMN PORTの詳細情報を取得するには、次の手順を実行します。

SOAアプリケーション・サーバーのホームの場所に対応する構成ファイル
$SOA_ORACLE_HOME/opmn/conf/opmn.xml. $SOA_ORACLE_HOMEを開きます。
その構成ファイルの中のリクエスト・ポート属性の値を確認します。