Oracle ESB レッスン07: OEMS: DB PL/SQL用のJMS（AQ）

Transcription

1 Oracle ESB レッスン 07: OEMS: DB PL/SQL 用の JMS(AQ) Oracle Integration Product Management ESB Lesson07 Page 1

2 OEMS (Oracle Enterprise Messaging Services) JMS 1.1 に準拠したメッセージング プロバイダ 3 つの永続性オプション ESB Lesson07 Page 2

3 要件 このレッスンでは Oracle Database 10g (EE XE ) が必要です (Oracle Olite では不十分 ) ESB Lesson07 Page 3

4 目標 1. AQに対してJMSアダプタ ( インバウンド ) を構成する方法のデモ 2. PL/SQLのストアド プロシージャを呼び出す Databaseアダプタの構成方法のデモ 3. プロジェクトの開発から本稼働までのプロモーションの検討 ( および関連するリソース プロバイダの考慮事項 ) ESB Lesson07 Page 4

5 シナリオの概要 ESB サービスが JMS トピック (OEMS データベースの永続性 ) において 新しい従業員の通知をリスニングしている このようなメッセージを受信した場合 会社のデータベースへ新しい従業員を挿入するストアド プロシージャを呼び出す ESB Lesson07 Page 5

6 構成の手順 ステップ DB アカウントの準備 ストアド プロシージャの作成 AQ で宛先の作成 新しい ESB プロジェクトの作成 インバウンド JMS アダプタの作成 アウトバウンド DB アダプタの作成 ルーティング サービスの構成 サーバー リソース プロバイダの構成 サービスの登録 実行 ESB Lesson07 Page 6

7 手順 1 チュートリアル ファイルの解凍 解凍していない場合は ESBSamples.zip を C: ESBSamples またはその他の場所に解凍する ESBSamples AQJMStoDB があることを確認する 次のようなツリー構造であることを確認する ESB Lesson07 Page 7

8 手順 2 データベース アカウントの準備 DOS プロンプトをオープンし このチュートリアルのディレクトリへ移動する cd ESBSamples AQJMStoDB sql ORACLE_HOME に実際のデータベース インストレーションを設定する例 : set ORACLE_HOME=D: D: ORACLE oraclexe app oracle product server アカウントの作成スクリプトを実行する sqlplus sys as ( プロンプトが表示された場合は sys パスワードを入力する ) ESB Lesson07 Page 8

9 手順 3 ストアド プロシージャの作成 sql のディレクトリへ移動する cd ESBSamples AQJMStoDB sql 提供されたストアド プロシージャの作成スクリプトを実行する sqlplus ESB Lesson07 Page 9

10 手順 4 AQ で宛先の作成 ( 注 : A JMS Topic は AQ 内で istopic が true に設定されているマルチコンシューマ キューの表 ) Cd ESBSamples AQJMStoDB sql 提供された SQL スクリプトを使用して JMSDEMO_TOPIC という名前の JMS トピックに必要なインフラストラクチャをデータベースに作成する sqlplus ESB Lesson07 Page 10

11 手順 5 新しい ESB プロジェクトの作成 JDev をオープンする デモ アプリケーション ( 左側のペイン ) を右クリックして New Project を選択する プロジェクト ギャラリーから プロジェクトのタイプとして ESB Project を選択する プロジェクトに AQJMStoDB という名前を付ける ESB Lesson07 Page 11

12 手順 5a インバウンド JMS アダプタ サービスの作成 コンポーネント パレット ( 画面の右側 ) をクリックする JMS Adapter をプロジェクトにドラッグ アンド ドロップする ESB Lesson07 Page 12

13 手順 5b インバウンド JMS アダプタ サービスの作成 1. サービスの名前として ListenForNewEmployees と入力する 2. 新しい System/Group として DefaultSystem.AQJMStoDB を作成する 1. 懐中電灯のアイコンをクリックする 2. プラス記号 (+) をクリックする 3. ServiceGroup を選択し 名前を AQJMStoDB と入力する ESB Lesson07 Page 13

14 手順 5c インバウンド JMS アダプタ サービスの作成 1. JMS アダプタ サービスの作成のメイン画面に戻り Adapter Service WSDL の Configure Adapter アイコンをクリックする 2. サービスの Name を ListenForNewEmployees のままにして次へ進む 3. JMS プロバイダとして Oracle Enterprise Messaging Service(OEMS) を選択する 4. 永続性のドロップダウン メニューから Database を選択して Next> を選択する ESB Lesson07 Page 14

15 手順 5d インバウンド JMS アダプタ サービスの作成 1. Connection の右側の New をクリックして 新しい接続を作成する 2. Connection Name として OEMS と入力し Connection Type として Oracle(JDBC) を選択する 3. 認証の接続情報を次のように入力する Username: jmsuser Password: jmsuser deploy password を選択する Next> をクリックする ESB Lesson07 Page 15

16 手順 5e インバウンド JMS アダプタ サービスの作成 1. Connection Details 画面で Driver が thin に Host Name が localhost に JDBC Port が 1521 に SID が XE に設定されていることを確認する Next> をクリックする 2. Test Connection をクリックし Finish をクリックする ESB Lesson07 Page 16

17 手順 5f インバウンド JMS アダプタ サービスの作成 JMS アダプタのウィザードに戻る 1. Operation Type として Consume Message を選択して Next> をクリックする 2. Resource Provider に OEMS と入力する 3. Destination Name の右の Browse... をクリックする 4. Destinations フィールドの All Types および JMSUSER の下位にある JMSDEMO_TOPIC(topic) を選択して OK をクリックする 5. Durable Subscriber ID に NewProvisioningESB と入力する ESB Lesson07 Page 17

18 手順 5g インバウンド JMS アダプタ サービスの作成 1. Next> をクリックする 2. Message Schema で Schema Location の右側の Browse... をクリックする 3. Import Schema File のアイコン ( 右上 ) をクリックする 4. 懐中電灯のアイコンをクリックし このチュートリアルを配置したディレクトリへナビゲートする ADDEMPLOYEES.xsdスキーマを選択して OK をクリックし Add to Project チェックボックスが選択されていることを確認して OK をクリックする 5. Imported Schemas の ADDEMPLOYEES.xsd を展開して InputParameters を選択し OK をクリックする 6. 次へ進む 7. 終了する 8. ESBは JMSアダプタのルーティング サービス ダウンストリームも作成している ESB Lesson07 Page 18

19 手順 5h アウトバウンド RDBMS アダプタの作成 1. コンポーネント パレット ( 画面の右側 ) をクリックする 2. Database Adapter を NewEmployee.esb プロジェクトにドラッグ アンド ドロップする 3. Next> Database Adapter Next> の順にクリックし サービスの Name に CreateEmployee と入力する System/Group が DefaultSystem.AQJMStoDB に設定されていることを確認する 4. Adapter Service WSDL で Configure Adapter Service WSDL アイコンをクリックすると アダプタの構成ウィザードが開始される ESB Lesson07 Page 19

20 手順 5i アウトバウンド RDBMS アダプタの作成 1. サービスの Name を CreateEmployee のままにして Next> をクリックする 2. Connection の右側の New をクリックし 次のパラメータで新しい接続を作成する 1. Connection Name: "EmployeeDB" 2. Connection Type: "Oracle (JDBC)" 3. Username: "dbapp" 4. Password: "dbapp" 5. deploy password を選択 6. Driver: "thin" 7. Host Name: "localhost" 8. JDBC Port: "1521" 9. SID: "XE" 3. 接続テストが成功したことを確認し Finish をクリックする ( 詳細な手順は JMS アダプタの構成で構成する接続を参照 ) ESB Lesson07 Page 20

21 手順 5j アウトバウンド RDBMS アダプタの作成 1. アダプタの構成ウィザードに戻って Next をクリックする 2. Operation Type で Call a Stored Procedure or Function を選択する 3. スキーマ画面で DBAPP を選択して Browse... をクリックし Stored Procedures で ADDEMPLOYEES を選択して OK をクリックする 4. Next> および Finish をクリックする 5. Create Database Adapter Service 画面に戻って Adapter Service WSDLの情報が挿入されたことを確認して OK をクリックする ESB Lesson07 Page 21

22 手順 5k ListenForNewEmployees ルーティング サービスの構成 1. ListenForNewEmployees ルーティング サービスをダブルクリックする 2. Routing Rules タブを選択する 3. プラス記号 (+) のアイコンをクリックしてルールを追加する 4. ESB で Services in project DefaultSystem AQJMStoDB CreateEmployee CreateEmployee サービスを選択して OK をクリックする 5. 変換のアイコンをダブルクリックする 6. Create New Mapper File を選択し デフォルトの名前を承認する 7. マッパーの左側で EMPS を選択し それを右側の EMPS へドラッグする Auto Map Preferences のデフォルトを承認する 8. 保存して マッパーのタブをクローズする 9. 保存して ルーティング サービスのタブをクローズする ESB Lesson07 Page 22

23 手順 6 設計の完了 設計フェーズを完了後 プロジェクトをテストする ESB Lesson07 Page 23

24 開発から本稼働へ プロジェクトのプロモート プロジェクトをサーバーへ登録する前に JDev で参照したリソースがサーバーでも使用できることを確認する 例 : データソース その他 : サーバーでは実際に 設計中に使用したリソースとは別のリソースを使用する場合もある 管理者は 同じ論理名 ( ただし実際の本番用リソースを指しているもの ) を使用して ESBサーバー上でマッチするデータソースを作成すること ESB Lesson07 Page 24

25 非管理接続と管理接続 非管理モード WSDL で指定される接続情報 デフォルトですぐに使用できる ( これがランタイム接続とみなされ ウィザードは設計時の接続情報を取得する ) 管理モード (Toplink) JNDIエントリを介したoc4j-ra.xmlで指定される接続情報 WSDLで参照される上記のJNDIエントリ 管理モード (OC4J)[ 推奨 ] data-sources.xmlで指定される接続情報 oc4j-ra.xmlのjndiエントリで参照される上記のデータソース WSDLで参照される上記のJNDIエントリ ESB Lesson07 Page 25

26 非管理モードの注意事項 事前に構成されたリソース プロバイダ (OC4J-JMS 用など ) を使用していない場合 app サーバーの構成ファイルで更新が必要である 例 : データベース プロバイダに対する JMS アダプタ 管理モードでは 次を編集する 1. oc4j-ra.xml 2. (data-sources.xml) 3. application.xml 非管理モードでは 次を編集する 1. application.xml ESB Lesson07 Page 26

27 サーバーの構成 1. SOA Suite をシャットダウンする 2. application.xml および oc4j-ra.xml を JMS アダプタに対して構成する 3. application.xml および oc4j-ra.xml を Database Adapter に対して構成する 4. SOA Suite を再起動する 5. ESB プロジェクトを登録する 6. テスト ESB Lesson07 Page 27

28 手順 7a 管理モードにおける JMS アダプタの構成プロジェクトで必要な値 リソース プロバイダ名 (A) application.xml と oc4j-ra.xml で使用 JNDI 名 (B) oc4j-ra.xml で使用 ESB Lesson07 Page 28

29 手順 7b JMS アダプタ : データベース リソース プロバイダの構成 (application.xml) ESBサーバーをインストールする %ESB_HOME% j2ee home configへナビゲートする例 : cd D: ORACLE OracleESB_beta j2ee home config application.xmlをオープンして次のエントリを追加する実際のプロジェクト (A) のRP 名に一致 ESB Lesson07 Page 29

30 手順 7c JMS アダプタ : JMS コネクション ファクトリの構成 (oc4j-ra.xml) ESB サーバーのインストールで JMS アダプタをデプロイする例 : D: ORACLE OracleESB_beta j2ee home applicationdeployments default JmsAdapter oc4j-ra.xml をオープンして次のエントリを追加する プロジェクトで指定した JNDI 名 (B) 任意の名前 プロジェクトおよび application.xml で指定したリソース プロバイダ名 (A) ESB Lesson07 Page 30

31 手順 7d 管理モードにおける Database Adapter の構成プロジェクトで必要な値 JNDI 名 (A) oc4j-ra.xml で使用 ESB Lesson07 Page 31

32 手順 7e Database Adapter(oc4jra.xml) ESB サーバーのインストールで Database Adapter をデプロイする例 : D: ORACLE OracleESB_beta j2ee home applicationdeployments default DBAdapter oc4j-ra.xml をオープンして次のエントリを追加する プロジェクトで指定した JNDI 名 (A) ESB Lesson07 Page 32

33 手順 7f Database Adapter(data-sources.xml) ESB サーバーをインストールする %ESB_HOME% j2ee home config へナビゲートする例 : cd D: ORACLE OracleESB_beta j2ee home config data-sources.xml をオープンして次のエントリを追加する Oc4j-ra.xml で指定したデータソース名 ESB Lesson07 Page 33

34 手順 7g サーバーの再起動 opmnctl stopall opmnctl startall デバッグ 次のログ ファイルを見る %ESB_HOME% j2ee home log home_default_group_1 oc4j log.xml %ESB_HOME% opmn logs default_group~home~default_group~1.log 必要に応じ ASControl のロガー レベルを FINE に設定する ESB Lesson07 Page 34

35 手順 8 登録 これは設計時 ( 新しい従業員のプロビジョニング サービスをテストするとき ) に実行する すべて保存する AQJMStoDBプロジェクトを右クリックし Register with ESB LocalIntegrationServer を選択する 確認のダイアログが表示される ESB Lesson07 Page 35

36 手順 9 ESB コントロールのチェック ESB コンソールをオープンする ( 次のようなサービスが表示される ESB Lesson07 Page 36

37 手順 10 JMS メッセージを送信して新しいサービスをトリガする DOS プロンプトをオープンして tools の下のチュートリアル ディレクトリへ移動する例 : cd C: ESBSamples AQJMStoDB tools setenv.bat を編集して 実際の環境を反映させる ( クラスパス ) oems.properties を編集して サーバーの設定を反映させる ( 場所 ポート sid など ) 次のようにメッセージを送信する ESB Lesson07 Page 37

38 手順 11 ESB コントロールの実行のチェック ESB コンソールをオープンする ( 右上の Instances をクリックする Search の右の緑の矢印をクリックする 1 つのインスタンスが次のように表示される ESB Lesson07 Page 38

39 手順 12 sqlplus の実行のチェック employee_table に新しい従業員が追加されたことを確認する 1. DOS プロンプトをオープンする 2. 次のコマンドを発行する ESB Lesson07 Page 39

40 付録 A create_procedure.sql ESB Lesson07 Page 40

41 付録 B topic_create.sql exec dbms_aqadm.create_queue_table(queue_table=>'jmsdemo_queue_table', queue_payload_type=>'sys.aq$_jms_text_message',multiple_consumers=>true); exec dbms_aqadm.create_queue(queue_name=>'jmsdemo_topic', queue_table=>'jmsdemo_queue_table'); exec dbms_aqadm.start_queue(queue_name=>'jmsdemo_topic'); commit; ESB Lesson07 Page 41