[SOA/BPM] Application Adapter Troubleshooting 101 – 11.1.1.4 (PS3)

概要

SOA Suite 11g Application AdapterはPeopleSoft、SAP社製ERP、Siebel、JD Edwards OneWorldと連携できますが、一つのインストーラに上記アプリケーションと連携するためのAdapterが含まれています。しかし、このインストーラにはアプリケーションと接続する上で必要な「アプリケーション固有」の必須のバイナリが含まれていません。こうしたバイナリはアプリケーションベンダー（例えばSAP AGなど）から提供されるため、Application Adapter設定においては、最後に人手による作業が必要ですが、そこでよく設定ミスが見受けられます。このエントリでは、Application Adapterインストール時のハイレベルの手順をまとめておきます。詳細の手順はドキュメントを参照して下さい。

ORACLE ADAPTERS
http://download.oracle.com/docs/cd/E17904_01/soa.htm#adapters
  1. 必要なパッチをインストール
    1. http://download.oracle.com/docs/cd/E17904_01/doc.1111/e17054/toc.htm
  2. SOA 11gインストール環境にApplication Adapterをインストール
  3. 企業情報システム（EIS、アプリケーションのこと）のバイナリを、Adapter Application Explorerとデプロイ対象のAdapterにとって適切な場所にコピーする。
  4. Adapter Application Explorerを使い、JCAの設定を作成する。
  5. 新しいJCA設定のためにデータベースリポジトリをセットアップする（ベストプラクティスであり、本番環境におけるサポートされた構成でのみ）。
  6. JCAの設定やデータベースリポジトリの情報を反映するよう、デプロイ対象のAdapterを更新する
  7. AdapterとAdapterテスト用WebアプリケーションをWebLogic Serverにデプロイする。
ご覧のように、3〜6でヒューマンエラーが発生しやすく、多くの場合、それゆえにAdapter Application ExplorerやデプロイしたAdapterが正しく動作しません。正常に動作していない場合には、さらに調査を進める前に、以下の点を確認すべきでしょう。
  1. アプリケーションにとって正しいバイナリをコピーして、Adapter Application ExplorerとデプロイするAdapterが期待している場所に配置したか。
    Adapter Application Explorerの場合：<Adapter Home>/lib
    デプロイするAdapterの場合：<Adapter Home>/iwafjca.rar および <Domain Home>/lib
  2. Adapter Application Explorerはデータベースリポジトリを見るように構成しているか。
  3. デプロイ対象のAdapterのra.xmlには、Adapter Application Explorerの構成を反映した正しい情報を含んでいるか。
これらの3点をチェックして、正しく設定がなされていることを確認したならば、自身を持って他のより複雑な問題に遭遇したと確信してよいでしょう。このインストールの検証プロセスを人手で実施することもできますが、機械的にチェックできるユーティリティで検証することもできます。

名前

adapterutilPS3.jar

使い方
java -jar adapterutilPS3.jar [-h] -s SOA_HOME -d DOMAIN_HOME -c command
[-n configuration name] [-t EIS type]
詳細

アダプタ設定ユーティリティは非常に簡単です：あなたのインストール環境の情報（例えば、SOA_HOME、Domain_Home、アダプタ構成名、EISタイプ）を指定すると、ユーティリティが入力した情報を使ってファイル、場所、構成設定などをチェックするというものです。食い違いを検出した場合には、コマンド/ターミナルウィンドウに表示します。

必須の入力として3件、SOA_HOME、DOMAIN_HOME、そしてコマンドがあります。SOA_HOMEとDOMAIN_HOMEは利用可能なコマンドの一つのためだけに入力が必要なのですが、将来変更する予定にしています。

ユーティリティはadapterutilPS3.jar（adapterutil.propertiesには構造に関するコメントを含む）にパッケージされ埋め込まれたプロパティファイル、adapterutil.propertiesを使いますが、独自のプロパティファイルを作成し、コマンドライン上で -Dproperties.filename=[カスタムプロパティファイル]を指定すると、デフォルトのadapterutil.propertiesをオーバーライドすることが可能です。 EISの新しいバージョンが認定されていてもまだadapterutil.propertiesにまだ表現されていない場合に便利な機能です。

コマンドラインオプションの詳細は以下の通りです。
  • -h, --help
    ヘルプ表示
  • -s, --soahome
    SOA11gのインストール先の完全パス
  • -d, --domainhome
    アダプタをデプロイしたWebLogic Serverドメインの完全パス
  • -c, --command
    ユーティリティでサポートしている3個のコマンドのうち一つを指定
    • configs
      このコマンドは、既知のEISの構成と、11.1.1.4（PS3）で正式にサポートされているEISのバージョンをリスト表示します。このコマンドが表示した構成の一つを、-tオプションの値として使います。
    • list
      このコマンドは、既知のEISの構成に関連するファイル、もしくは-tオプションで指定された一つのEISの構成に関連するファイルを表示します。
    • validate
      このコマンドは、一つのEIS構成の検証を実施し（-tオプションと同時に使う必要があります）、検出した不整合とともに構成情報の詳細を表示します。不整合には、ファイルの欠損（見つからないファイルの横に？が付いています）と、ra.xmlとjcatransport.properties間の不一致を含みます。
  • -n, --configuration
    このオプションは、Application Adapter Explorerで作成したAdapter構成名を指定する場合に使用します
  • -t, --type
    このオプションは、configsコマンドで表示するリストから既知のEISの構成の一つを指定する場合に使用します。
サンプル
C:\Users\Oracle\bin>java -jar adapterutilPS3.jar -s C:\Oracle\soa\PS3\Oracle_SOA1 -d C:\Oracle\soa\PS3\user_projects\domains\SOADevDomain -c configs
Known Configurations:
sap2
sap3
Siebel-6.3.x
Siebel-7.0.3
Siebel-7.5.2
Siebel-7.7-8.0
jde_XE
jde_ERP-8.0
jde_EnterpriseOne-8.9
jde_EnterpriseOne-8.10
jde_EnterpriseOne-8.11
jde_EnterpriseOne-8.12
jde_EnterpriseOne-9.0
PeopleSoft-8.1x
PeopleSoft-8.4x
PeopleSoft-8.5x
C:\Users\Oracle\bin>java -jar adapterutilPS3.jar -s C:\Oracle\soa\PS3\Oracle_SOA1 -d C:\Oracle\soa\PS3\user_projects\domains\SOADevDomain -t sap3 -c list
Known configurations and associated files

Configuration Type: sap3

Application Explorer:
  C:/Oracle/soa/PS3/Oracle_SOA1/soa/thirdparty/ApplicationAdapters/lib/iwmysap30.jar
  C:/Oracle/soa/PS3/Oracle_SOA1/soa/thirdparty/ApplicationAdapters/lib/sapjco3.jar
  C:/Oracle/soa/PS3/Oracle_SOA1/soa/thirdparty/ApplicationAdapters/lib/sapjco3.dll
Adapter:
  C:/Oracle/soa/PS3/Oracle_SOA1/soa/thirdparty/ApplicationAdapters/iwafjca.rar/iwmysap30.jar
  C:/Oracle/soa/PS3/user_projects/domains/SOADevDomain/lib/sapjco3.jar
  C:/Oracle/soa/PS3/user_projects/domains/SOADevDomain/lib/sapjco3.dll
C:\Users\Oracle\bin>java -jar adapterutilPS3.jar -s C:\Oracle\soa\PS3\Oracle_SOA1 -d C:\Oracle\soa\PS3\user_projects\domains\SOADevDomain -n JCA_SampleConfig -t sap3 -c validate
Validating sap3 ...
   C:/Oracle/soa/PS3/Oracle_SOA1/soa/thirdparty/ApplicationAdapters/lib/iwmysap30.jar
   C:/Oracle/soa/PS3/Oracle_SOA1/soa/thirdparty/ApplicationAdapters/lib/sapjco3.jar
   C:/Oracle/soa/PS3/Oracle_SOA1/soa/thirdparty/ApplicationAdapters/lib/sapjco3.dll
   C:/Oracle/soa/PS3/Oracle_SOA1/soa/thirdparty/ApplicationAdapters/iwafjca.rar/iwmysap30.jar
 ? C:/Oracle/soa/PS3/user_projects/domains/SOADevDomain/lib/sapjco3.jar
 ? C:/Oracle/soa/PS3/user_projects/domains/SOADevDomain/lib/sapjco3.dll

*** Configuration files need review


ra.xml ...
IWayHome:         C:/Oracle/soa/PS3/Oracle_SOA1/soa/thirdparty/ApplicationAdapters
IWayConfig:       JCA_SampleConfig
IWayRepoDriver:
IWayRepoURL:      jdbc:oracle:thin:@localhost:1521:orcl
IWayRepoUser:     ps3_adapters
IWayRepoPassword: welcome1
LogLevel:         DEBUG


Application Explorer Configuration ...
Is File Repository:      false
Is DB Repository:        true
Contains repository.xml: false
iwafjca.repo.url:        jdbc:oracle:thin:@localhost:1521:xe
iwafjca.repo.user:       ps3_adapters
iwafjca.repo.password:   welcome1


Application Explorer Configuration compared to ra.xml ...

ra.xml:
*** IWayRepoURL mismatch
    Current:   jdbc:oracle:thin:@localhost:1521:orcl
    Should be: jdbc:oracle:thin:@localhost:1521:xe

Application Explorer Configuration:
No issues found.

原文はこちら。
http://blogs.oracle.com/ateamsoab2b/entry/application_adapter_troubleshooting_101_11
-
カテゴリ ,

0 件のコメント:

コメントを投稿

登録: コメントの投稿 (Atom)